@littlebigbrain/client 0.8.1 → 0.9.1

package/dist/schema.d.ts

@@ -467,6 +467,25 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/graph/import-jobs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read durable import state, grouped-commit progress, terminal failure, and publication receipt */
+        get: operations["get_v1_graph_import_jobs"];
+        put?: never;
+        /** Stream an NDJSON dataset into immutable storage and enqueue a durable grouped import; requires an Idempotency-Key */
+        post: operations["post_v1_graph_import_jobs"];
+        /** Request cooperative cancellation of a durable import */
+        delete: operations["delete_v1_graph_import_jobs"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/graph/import/rdf": {
         parameters: {
             query?: never;
@@ -1628,6 +1647,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/version": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read build identity, wire capabilities, and persisted-format fingerprint */
+        get: operations["get_version"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -3184,6 +3220,101 @@ export interface components {
             src_graph_id: string;
         };
         GraphId: string;
+        /** @description Stable response returned when a durable import is accepted or replayed. */
+        GraphImportJobAccepted: {
+            /**
+             * @description True when this request resolved to an existing job with the same
+             *     idempotency key and exact content hash.
+             */
+            idempotent_replay: boolean;
+            job_id: string;
+            state: components["schemas"]["GraphImportJobState"];
+            /** Format: int64 */
+            upload_bytes: number;
+        };
+        /** @description Response to `DELETE /v1/graph/import-jobs`. */
+        GraphImportJobCancelResponse: {
+            job_id: string;
+            state: components["schemas"]["GraphImportJobState"];
+        };
+        /**
+         * @description Terminal failure details for a durable import. The message is safe to expose
+         *     to the submitting client; internal object keys and worker identities stay in
+         *     structured server logs.
+         */
+        GraphImportJobFailure: {
+            /**
+             * Format: int32
+             * @description Delivery attempts consumed when the job became terminal.
+             */
+            attempts: number;
+            code: string;
+            /**
+             * @description Stable opaque correlation id for server-side logs. It is intentionally
+             *     not an object key, worker id, or graph identity.
+             */
+            diagnostic_id: string;
+            message: string;
+            retryable: boolean;
+            /** @description Last durable low-cardinality stage reached by the worker. */
+            stage: components["schemas"]["GraphImportJobStage"];
+        };
+        /** @description Bounded progress persisted by an import worker after every grouped commit. */
+        GraphImportJobProgress: {
+            /** Format: int64 */
+            active_group_bytes?: number;
+            /** Format: int64 */
+            active_group_index?: number | null;
+            /** Format: int64 */
+            active_group_records?: number;
+            /** Format: int64 */
+            bytes_processed: number;
+            committed_commit_seq?: null | components["schemas"]["CommitSeq"];
+            /** Format: int64 */
+            error_count: number;
+            errors?: components["schemas"]["GraphImportLineError"][];
+            /** Format: int64 */
+            groups_committed: number;
+            /** Format: int64 */
+            lines_read: number;
+            /** Format: int64 */
+            observations: number;
+            /** Format: int64 */
+            properties: number;
+            stage?: components["schemas"]["GraphImportJobStage"];
+            /** Format: int64 */
+            triplets: number;
+            /** Format: int64 */
+            upload_bytes: number;
+        };
+        /**
+         * @description Low-cardinality execution stage exposed while a durable import is active.
+         * @enum {string}
+         */
+        GraphImportJobStage: "queued" | "reading_payload" | "committing_group" | "persisting_checkpoint" | "enqueueing_publication" | "completed";
+        /**
+         * @description Lifecycle of a durable NDJSON import submitted through
+         *     `POST /v1/graph/import-jobs`.
+         *
+         *     A succeeded import has durably committed its records and enqueued the final
+         *     publication job. It does **not** mean the published read generation has
+         *     already caught up to [`GraphImportJobStatus::committed_commit_seq`].
+         * @enum {string}
+         */
+        GraphImportJobState: "queued" | "running" | "cancellation_requested" | "cancelled" | "succeeded" | "failed";
+        /** @description Queryable status for a durable import job. */
+        GraphImportJobStatus: {
+            committed_commit_seq?: null | components["schemas"]["CommitSeq"];
+            /** Format: int64 */
+            enqueued_at_micros: number;
+            failure?: null | components["schemas"]["GraphImportJobFailure"];
+            job_id: string;
+            progress: components["schemas"]["GraphImportJobProgress"];
+            publication_job?: null | components["schemas"]["GraphImportPublishedGenerationOutcome"];
+            state: components["schemas"]["GraphImportJobState"];
+            /** Format: int64 */
+            updated_at_micros: number;
+        };
         /**
          * @description One line of an NDJSON bulk-import stream (`POST /v1/graph/import`). Each line
          *     is a single JSON object that is either a triplet (carries `relation`) or an
@@ -3808,15 +3939,16 @@ export interface components {
              */
             output_modalities?: string[];
             /**
-             * @description True when the model is eligible under the account's data policy — for the
-             *     hosted OpenRouter path, that it has a Zero-Data-Retention route. The
-             *     catalog only returns eligible models, so this is `true` for every entry
-             *     today; the console can trust it to gate selection if ineligible models are
-             *     ever surfaced alongside them.
+             * @description True when the model is present in the operator account's policy-filtered
+             *     catalog. Kept for generated-client compatibility; use `selectable` and
+             *     `unavailable_reason` for selection UI.
              */
             policy_eligible?: boolean;
             /** @description Provider prompt price as a decimal USD/token string when advertised. */
             prompt_price?: string | null;
+            /** @description Whether this deployment can currently select the model. */
+            selectable: boolean;
+            unavailable_reason?: null | components["schemas"]["ManagedEmbeddingUnavailableReason"];
         };
         /** @description Live embedding models available on this deployment. */
         ManagedEmbeddingModelsResponse: {
@@ -3851,6 +3983,11 @@ export interface components {
          * @enum {string}
          */
         ManagedEmbeddingSource: "stock" | "fine_tuned";
+        /**
+         * @description Why a managed embedding catalog entry cannot currently be selected.
+         * @enum {string}
+         */
+        ManagedEmbeddingUnavailableReason: "account_policy" | "zdr_required" | "price_ceiling";
         ModelArtifact: {
             blake3: string;
             /** Format: int64 */
@@ -4092,7 +4229,7 @@ export interface components {
          * @description Remove entity types from a relation's domain and/or range (a subtractive
          *     change). Conflicts when current edges of the relation already use a
          *     removed source/target type — those edges stay (append-only) but begin to
-         *     warn. Blocked unless `allow_data_conflicts` is set on the request.
+         *     warn. Blocked until those edges are migrated or retracted.
          */
         NarrowRelationOp: {
             /**
@@ -4250,10 +4387,13 @@ export interface components {
             affected: number;
             /**
              * @description `entities_of_removed_type` | `edges_of_removed_relation` |
-             *     `edges_outside_narrowed_domain` | `edges_outside_narrowed_range`.
+             *     `edges_outside_narrowed_domain` | `edges_outside_narrowed_range` |
+             *     `property_values_outside_constraint` | `relation_cardinality`.
              */
             kind: string;
             message: string;
+            /** @description Bounded deterministic examples. `affected` remains the exact count. */
+            samples?: string[];
             /** @description `class:<stable_id>` or `relation:<stable_id>` the conflict is about. */
             subject: string;
         };
@@ -4370,11 +4510,9 @@ export interface components {
          */
         OntologyEvolveRequest: {
             /**
-             * @description Allow subtractive ops (narrow/remove) to apply even when current data
-             *     conflicts. The affected records are never rewritten or dropped — they stay
-             *     readable and simply begin to warn. With this false (the default), a
-             *     conflicting subtractive request is rejected without writing and the
-             *     conflicts are reported instead.
+             * @description Deprecated compatibility field. Conflicting subtractive changes are
+             *     always rejected with structured conflicts until affected data is
+             *     migrated or retracted; setting this field no longer bypasses that gate.
              */
             allow_data_conflicts?: boolean;
             ops: components["schemas"]["OntologyEvolveOp"][];
@@ -4413,8 +4551,8 @@ export interface components {
              */
             ontology_version: number;
             /**
-             * @description Whether the exact request can be published. False for a data-conflicting
-             *     subtractive preview unless `allow_data_conflicts` was explicitly set.
+             * @description Whether the exact request can be published. False for every
+             *     data-conflicting subtractive preview.
              */
             publishable: boolean;
         };
@@ -5067,8 +5205,8 @@ export interface components {
         /**
          * @description Tombstone an entity type: existing records of the type stay readable
          *     (the def is retained, so they still resolve), but it is rejected for new
-         *     commits. Conflicts when current entities of the type exist; blocked unless
-         *     `allow_data_conflicts` is set.
+         *     commits. Conflicts when current entities of the type exist; blocked until
+         *     those entities are migrated or retracted.
          */
         RemoveEntityTypeOp: {
             name: string;
@@ -5080,8 +5218,8 @@ export interface components {
         };
         /**
          * @description Tombstone a relation: existing edges stay readable but it is rejected for
-         *     new commits. Conflicts when current edges use it; blocked unless
-         *     `allow_data_conflicts` is set.
+         *     new commits. Conflicts when current edges use it; blocked until those
+         *     edges are migrated or retracted.
          */
         RemoveRelationOp: {
             name: string;
@@ -6183,9 +6321,9 @@ export interface components {
         };
         /**
          * @description Change a relation's cardinality (`one_to_one` | `one_to_many` |
-         *     `many_to_one` | `many_to_many`). Advisory metadata (it informs ranking and
-         *     query shaping, and is not enforced against stored edges), so it never
-         *     conflicts with existing data.
+         *     `many_to_one` | `many_to_many`). A narrowing transition is checked
+         *     against the exact current reduced edge projection before publication.
+         *     Once accepted, the declared cardinality is enforced on future commits.
          */
         SetRelationCardinalityOp: {
             cardinality: string;
@@ -7468,6 +7606,19 @@ export interface components {
         };
         /** @enum {string} */
         VectorMetric: "cosine" | "dot" | "l2";
+        /** @description Unauthenticated build, wire-capability, and persisted-format identity. */
+        VersionResponse: {
+            /** @description UTC build timestamp baked into the running binary. */
+            built_at: string;
+            /** @description Fine-grained additive features safe for SDK capability gates. */
+            capabilities: string[];
+            /** @description Source revision baked into the running binary. */
+            git_commit: string;
+            /** @description Deterministic fingerprint of all persisted format versions. */
+            persisted_format: string;
+            /** @description Backward-compatibility date sent in `Lbb-Version`. */
+            version: string;
+        };
         /**
          * @description `GET /v1/search/vocab` — the graph's grounding vocabulary as sorted,
          *     deduped string sections: the canonical input for a decoder-side automaton
@@ -12129,39 +12280,19 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_import_rdf: {
+    get_v1_graph_import_jobs: {
         parameters: {
-            query?: {
+            query: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description RDF statements per internal commit (default 1000, clamped 1-1000000) */
-                batch?: string;
-                /** @description Abort on the first malformed RDF parse error instead of reporting it */
-                strict?: string;
-                /** @description RFC3339 backfill instant stamped on every batch */
-                observed_at?: string;
-                /** @description Edge duplicate handling: skip_unchanged (default) or append for fresh high-throughput loads */
-                edge_idempotency?: string;
-                /** @description RDF format: ntriples (default), turtle, nquads, or trig */
-                format?: string;
-                /** @description Optional base IRI for resolving relative IRIs in Turtle or TriG */
-                base_iri?: string;
-                /** @description Optional named-graph IRI for N-Triples or Turtle input */
-                graph_uri?: string;
-                /** @description Optional stable document scope for blank-node labels across chunks; omit to preserve labels exactly across retries and chunk boundaries */
-                blank_node_scope?: string;
-                /** @description Entity type name for imported RDF resources (default Resource) */
-                resource_type?: string;
-                /** @description Durably enqueue one atomic published-generation build after the final batch */
-                publish?: string;
+                /** @description Stable job id returned by the submit call */
+                job_id: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
                 "Lbb-Version"?: string;
-                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
-                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
@@ -12178,7 +12309,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphRdfImportResponse"];
+                    "application/json": components["schemas"]["GraphImportJobStatus"];
                 };
             };
             /** @description Bad request */
@@ -12287,22 +12418,35 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_metadata: {
+    post_v1_graph_import_jobs: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Records per grouped commit (default and maximum 10000; minimum 1) */
+                batch?: string;
+                /** @description Fail the durable job on the first malformed line instead of recording and skipping it */
+                strict?: string;
+                /** @description RFC3339 backfill instant stamped on every grouped commit */
+                observed_at?: string;
             };
-            header?: {
+            header: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
                 "Lbb-Version"?: string;
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
+                "Idempotency-Key": string;
             };
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        /** @description Newline-delimited JSON records streamed without assembling the complete import in client or server memory. */
+        requestBody: {
+            content: {
+                "application/x-ndjson": string;
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -12314,7 +12458,20 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphMetadataResponse"];
+                    "application/json": components["schemas"]["GraphImportJobAccepted"];
+                };
+            };
+            /** @description OK */
+            202: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GraphImportJobAccepted"];
                 };
             };
             /** @description Bad request */
@@ -12423,13 +12580,15 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_query: {
+    delete_v1_graph_import_jobs: {
         parameters: {
-            query?: {
+            query: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Stable job id returned by the submit call */
+                job_id: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
@@ -12440,11 +12599,7 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["SparqlTextRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -12456,7 +12611,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SparqlTextResponse"];
+                    "application/json": components["schemas"]["GraphImportJobCancelResponse"];
                 };
             };
             /** @description Bad request */
@@ -12565,17 +12720,39 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_read_snapshot: {
+    post_v1_graph_import_rdf: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description RDF statements per internal commit (default 1000, clamped 1-1000000) */
+                batch?: string;
+                /** @description Abort on the first malformed RDF parse error instead of reporting it */
+                strict?: string;
+                /** @description RFC3339 backfill instant stamped on every batch */
+                observed_at?: string;
+                /** @description Edge duplicate handling: skip_unchanged (default) or append for fresh high-throughput loads */
+                edge_idempotency?: string;
+                /** @description RDF format: ntriples (default), turtle, nquads, or trig */
+                format?: string;
+                /** @description Optional base IRI for resolving relative IRIs in Turtle or TriG */
+                base_iri?: string;
+                /** @description Optional named-graph IRI for N-Triples or Turtle input */
+                graph_uri?: string;
+                /** @description Optional stable document scope for blank-node labels across chunks; omit to preserve labels exactly across retries and chunk boundaries */
+                blank_node_scope?: string;
+                /** @description Entity type name for imported RDF resources (default Resource) */
+                resource_type?: string;
+                /** @description Durably enqueue one atomic published-generation build after the final batch */
+                publish?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
                 "Lbb-Version"?: string;
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
+                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
@@ -12592,7 +12769,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PublishedReadStatusResponse"];
+                    "application/json": components["schemas"]["GraphRdfImportResponse"];
                 };
             };
             /** @description Bad request */
@@ -12701,27 +12878,17 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_reload: {
+    get_v1_graph_metadata: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Must equal the target graph id (reload is semi-destructive) */
-                confirm?: string;
-                /** @description true = preview the delta; nothing durable changes */
-                dry_run?: string;
-                /** @description true = malformed payload lines fail the reload instead of being skipped and reported */
-                strict?: string;
-                /** @description Optional RFC3339 observation timestamp applied to the reload's writes */
-                observed_at?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
                 "Lbb-Version"?: string;
-                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
-                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
@@ -12738,7 +12905,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphReloadResponse"];
+                    "application/json": components["schemas"]["GraphMetadataResponse"];
                 };
             };
             /** @description Bad request */
@@ -12847,7 +13014,7 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_retract: {
+    post_v1_graph_query: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -12866,7 +13033,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["GraphRetractRequest"];
+                "application/json": components["schemas"]["SparqlTextRequest"];
             };
         };
         responses: {
@@ -12880,7 +13047,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphRetractResponse"];
+                    "application/json": components["schemas"]["SparqlTextResponse"];
                 };
             };
             /** @description Bad request */
@@ -12989,7 +13156,7 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_search: {
+    get_v1_graph_read_snapshot: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -13000,17 +13167,11 @@ export interface operations {
             header?: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
                 "Lbb-Version"?: string;
-                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
-                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["SemanticGraphSearchRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -13022,7 +13183,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SemanticGraphSearchResponse"];
+                    "application/json": components["schemas"]["PublishedReadStatusResponse"];
                 };
             };
             /** @description Bad request */
@@ -13131,13 +13292,21 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_semantic_traverse: {
+    post_v1_graph_reload: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Must equal the target graph id (reload is semi-destructive) */
+                confirm?: string;
+                /** @description true = preview the delta; nothing durable changes */
+                dry_run?: string;
+                /** @description true = malformed payload lines fail the reload instead of being skipped and reported */
+                strict?: string;
+                /** @description Optional RFC3339 observation timestamp applied to the reload's writes */
+                observed_at?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
@@ -13148,11 +13317,7 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["SemanticTraverseRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -13164,7 +13329,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SemanticTraverseResponse"];
+                    "application/json": components["schemas"]["GraphReloadResponse"];
                 };
             };
             /** @description Bad request */
@@ -13273,7 +13438,7 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_summary: {
+    post_v1_graph_retract: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -13284,11 +13449,17 @@ export interface operations {
             header?: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
                 "Lbb-Version"?: string;
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
+                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GraphRetractRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -13300,7 +13471,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphSummaryResponse"];
+                    "application/json": components["schemas"]["GraphRetractResponse"];
                 };
             };
             /** @description Bad request */
@@ -13409,28 +13580,28 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_traverse: {
+    post_v1_graph_search: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Start entity id */
-                id?: string;
-                /** @description out, in, or both */
-                direction?: string;
-                /** @description Hop budget */
-                max_hops?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
                 "Lbb-Version"?: string;
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
+                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SemanticGraphSearchRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -13442,7 +13613,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TraverseResponse"];
+                    "application/json": components["schemas"]["SemanticGraphSearchResponse"];
                 };
             };
             /** @description Bad request */
@@ -13551,7 +13722,7 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_traverse: {
+    post_v1_graph_semantic_traverse: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -13570,7 +13741,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["TraverseRequest"];
+                "application/json": components["schemas"]["SemanticTraverseRequest"];
             };
         };
         responses: {
@@ -13584,7 +13755,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TraverseResponse"];
+                    "application/json": components["schemas"]["SemanticTraverseResponse"];
                 };
             };
             /** @description Bad request */
@@ -13693,7 +13864,427 @@ export interface operations {
             };
         };
     };
-    get_v1_graphs: {
+    get_v1_graph_summary: {
+        parameters: {
+            query?: {
+                /** @description Graph name (default `main`) */
+                graph?: string;
+                /** @description Branch name (default `main`) */
+                branch?: string;
+            };
+            header?: {
+                /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
+                "Lbb-Version"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GraphSummaryResponse"];
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Service unavailable */
+            503: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+        };
+    };
+    get_v1_graph_traverse: {
+        parameters: {
+            query?: {
+                /** @description Graph name (default `main`) */
+                graph?: string;
+                /** @description Branch name (default `main`) */
+                branch?: string;
+                /** @description Start entity id */
+                id?: string;
+                /** @description out, in, or both */
+                direction?: string;
+                /** @description Hop budget */
+                max_hops?: string;
+            };
+            header?: {
+                /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
+                "Lbb-Version"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TraverseResponse"];
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Service unavailable */
+            503: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+        };
+    };
+    post_v1_graph_traverse: {
+        parameters: {
+            query?: {
+                /** @description Graph name (default `main`) */
+                graph?: string;
+                /** @description Branch name (default `main`) */
+                branch?: string;
+            };
+            header?: {
+                /** @description API contract version to pin. Use `2026-07-23` for this beta-breaking shape. */
+                "Lbb-Version"?: string;
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
+                "Idempotency-Key"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TraverseRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TraverseResponse"];
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Service unavailable */
+            503: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+        };
+    };
+    get_v1_graphs: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -22419,4 +23010,132 @@ export interface operations {
             };
         };
     };
+    get_version: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VersionResponse"];
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Service unavailable */
+            503: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+        };
+    };
 }