sync: lbb 89a121c4b7fc

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to the `littlebigbrain` Python SDK are documented here.
 
+## 0.9.0
+
+Durable, asynchronous NDJSON imports.
+
+- Sync and async clients add `submit_import_ndjson`, `get_import_job`,
+  `cancel_import_job`, and `wait_for_import_job`.
+- Submissions consume iterable/async-iterable input as a streaming HTTP body,
+  require an explicit idempotency key, and never fall back to the synchronous
+  import route.
+- Durable methods fail clearly unless the server advertises
+  `durable_import_jobs_v1`.
+
 ## 0.8.1
 
 Adjacency-backed Explorer reads now report the coherent adjacency coverage

README.md

@@ -82,6 +82,21 @@ lbb.graph("main").facts.import_ndjson(
 )
 ```
 
+For large or long-running loads, submit a streamed durable job:
+
+```python
+accepted = lbb.submit_import_ndjson(
+    records(),
+    idempotency_key="hubspot:portal-42:run-2026-07-29",
+)
+completed = lbb.wait_for_import_job(accepted.job_id)
+print(completed.state, completed.committed_commit_seq)
+```
+
+The async client accepts an async iterable as well. Success means all grouped
+commits are durable and final publication was enqueued; it does not mean
+published indexes have already reached `committed_commit_seq`.
+
 **Time-travel read.** Pin a SPARQL query to a past instant — results reflect the graph as it was then:
 
 ```python