@littlebigbrain/client 0.6.1 → 0.8.0

package/dist/schema.d.ts

@@ -415,6 +415,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/graph/entities/sample": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Bounded class sample from the ranged adjacency index */
+        get: operations["get_v1_graph_entities_sample"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/graph/entity": {
         parameters: {
             query?: never;
@@ -518,6 +535,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/graph/fork": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Fork a graph: copy-based clone of the source graph's current head into a new graph in the same tenant — no data replay, no re-embedding; runs as a durable job (poll the destination's metadata) */
+        post: operations["post_v1_graph_fork"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/graph/groundability": {
         parameters: {
             query?: never;
@@ -620,6 +654,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/graph/reload": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Declarative full-state replace: body is bulk-import NDJSON of the desired state; entities absent from the payload leave current state (history kept for as_of), payload entities are upserted, and the cutover is one atomic visibility boundary. dry_run=true previews the full delta without changing anything */
+        post: operations["post_v1_graph_reload"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/graph/retract": {
         parameters: {
             query?: never;
@@ -2918,6 +2969,7 @@ export interface components {
             facets?: components["schemas"]["FacetRequest"][] | null;
             filters?: null | components["schemas"]["SearchFilterExpr"];
             max_clusters?: number | null;
+            min_indexed_seq?: null | components["schemas"]["CommitSeq"];
             probe_count?: number | null;
             provider?: null | components["schemas"]["EmbeddingProviderConfig"];
             query: string;
@@ -3195,6 +3247,29 @@ export interface components {
             snapshot: components["schemas"]["SnapshotView"];
             transitions: components["schemas"]["TransitionEntry"][];
         };
+        /**
+         * @description Exact class cardinality plus a bounded deterministic sample served from the
+         *     ranged adjacency meta. `indexed_commit_seq` makes index lag explicit while
+         *     `snapshot.commit_seq` reports the current graph head.
+         */
+        EntityTypeSampleResponse: {
+            entities: components["schemas"]["EntityTypeSampleRow"][];
+            entity_type: string;
+            indexed_commit_seq: components["schemas"]["CommitSeq"];
+            snapshot: components["schemas"]["SnapshotView"];
+            total_count: number;
+        };
+        /**
+         * @description One bounded, index-backed class member for interactive graph exploration.
+         *     Unlike [`EntityExplorerRow`], this deliberately carries only fields the
+         *     adjacency build already knows; exhaustive attributes and observation counts
+         *     remain on the full entity/browse reads.
+         */
+        EntityTypeSampleRow: {
+            entity: components["schemas"]["EntityView"];
+            in_degree: number;
+            out_degree: number;
+        };
         EntityView: {
             id: components["schemas"]["EntityId"];
             name: string;
@@ -3400,6 +3475,7 @@ export interface components {
             explain: boolean;
             facets?: components["schemas"]["FacetRequest"][] | null;
             filters?: null | components["schemas"]["SearchFilterExpr"];
+            min_indexed_seq?: null | components["schemas"]["CommitSeq"];
             /**
              * @description Number of leading results to skip after ordering, for stateless paging:
              *     `offset = page * top_k` walks pages deterministically. Defaults to 0.
@@ -3775,6 +3851,23 @@ export interface components {
              */
             snapshot_token: string;
         };
+        /**
+         * @description Response to `POST /v1/graph/fork`: the fork runs as a durable background job
+         *     (a create-only copy of the source graph into a new graph id in the same
+         *     tenant), so this acknowledges the enqueue and points at the poll surface.
+         */
+        GraphForkResponse: {
+            dst_graph_id: string;
+            job_id: string;
+            ok: boolean;
+            /**
+             * @description Poll the destination graph's metadata to observe the fork completing
+             *     (the destination becomes readable once its head is published).
+             */
+            poll: string;
+            queued: boolean;
+            src_graph_id: string;
+        };
         GraphId: string;
         /**
          * @description Outcome of the optional one-shot index build a bulk import runs at the end
@@ -3900,6 +3993,12 @@ export interface components {
              *     every as-of returns the same picture.
              */
             temporal_coverage?: components["schemas"]["TemporalCoverage"];
+            /**
+             * @description Whether `temporal_coverage` was computed from the full snapshot. The
+             *     bounded HTTP metadata path is head-only by default; callers that need
+             *     exact event-time coverage opt in explicitly.
+             */
+            temporal_coverage_computed?: boolean;
             unindexed_tail_commits: number;
             /** Format: int64 */
             wal_tail_bytes: number;
@@ -3974,6 +4073,96 @@ export interface components {
             recall_at_k: number;
             snapshot: components["schemas"]["SnapshotView"];
         };
+        /**
+         * @description Outcome of `POST /v1/graph/reload` — the declarative "make the graph match
+         *     this full dataset" verb. One atomic cutover replaces the whole current state:
+         *     records present in the payload are upserted, and entities present at the
+         *     pre-reload head but absent from the payload are removed from current state
+         *     (retraction semantics — history stays queryable via `?as_of_commit_seq=`).
+         *     The delta report is the "prove I don't have wrong data" aid.
+         *
+         *     The whole reconciliation lands as a single graph-head advance, so a reader
+         *     never observes a mixed old/new state: a snapshot pinned at `prior_commit_seq`
+         *     sees only the old state, and `new_commit_seq` sees only the new state, with
+         *     nothing in between.
+         */
+        GraphReloadResponse: {
+            /**
+             * @description True when this was a `?dry_run=true` preview: nothing durable changed and
+             *     the counts + `new_commit_seq`/`new_snapshot_token` are the *proposed*
+             *     effect of a real reload against the same pre-reload head.
+             */
+            dry_run: boolean;
+            /** @description Payload edges not currently present, within the reconciled scopes. */
+            edges_added: number;
+            /** @description Payload edges already present (re-asserted), within the reconciled scopes. */
+            edges_changed: number;
+            /** @description Current edges retracted because an endpoint left current state. */
+            edges_removed: number;
+            /** @description Entities present in the payload but not at the pre-reload head. */
+            entities_added: number;
+            /**
+             * @description Entities present in both the payload and the pre-reload head (re-asserted;
+             *     this is a presence intersection, not a deep property diff).
+             */
+            entities_changed: number;
+            /**
+             * @description Entities present at the pre-reload head but absent from the payload — the
+             *     ones leaving current state.
+             */
+            entities_removed: number;
+            /**
+             * @description Parse errors for malformed payload lines (bounded; `error_count` is the
+             *     true total). Mirrors bulk import.
+             */
+            error_count: number;
+            errors?: components["schemas"]["GraphImportLineError"][];
+            /**
+             * @description True when the target graph did not exist and this reload bootstrapped it
+             *     (the pre-reload baseline was empty).
+             */
+            graph_created?: boolean;
+            /**
+             * @description The idempotency key that scopes this reload's single commit (the caller
+             *     key, or a server-minted one).
+             */
+            idempotency_key: string;
+            /**
+             * @description True when this request id was already applied (idempotent replay): the
+             *     diff counts are reported as zero because nothing new was written.
+             */
+            idempotent_replay?: boolean;
+            lines_read: number;
+            /**
+             * @description Commit sequence after cutover (real), or the proposed next sequence (dry
+             *     run).
+             */
+            new_commit_seq: components["schemas"]["CommitSeq"];
+            /** @description Snapshot token after cutover (real), or the proposed token (dry run). */
+            new_snapshot_token: string;
+            /**
+             * @description True when the desired state already matched the current state and no
+             *     commit was written (real mode only).
+             */
+            no_op?: boolean;
+            /**
+             * @description Commit sequence of the pre-reload head — the diff baseline and the
+             *     rollback anchor.
+             */
+            prior_commit_seq: components["schemas"]["CommitSeq"];
+            /**
+             * @description Snapshot token of the pre-reload head. Read it back with
+             *     `?as_of_commit_seq=<prior_commit_seq>` to see the old state — the rollback
+             *     hint.
+             */
+            prior_snapshot_token: string;
+            /**
+             * @description A bounded sample of the entities leaving current state, as `type/name`
+             *     display identities (external keys are one-way-hashed and unrecoverable) —
+             *     a sanity aid for confirming the reload drops what you expect.
+             */
+            removed_sample?: string[];
+        };
         /**
          * @description Retract specific edges and/or every edge touching given entities. Graph facts
          *     are append-only; a retraction does not erase events but appends a retracting
@@ -4041,6 +4230,7 @@ export interface components {
             observation_count: number;
             /** Format: int64 */
             ontology_version: number;
+            relation_adjacency?: components["schemas"]["RelationAdjacencyCount"][];
             relations: components["schemas"]["NamedCount"][];
             snapshot: components["schemas"]["SnapshotView"];
         };
@@ -4504,7 +4694,7 @@ export interface components {
          * @description Service used to generate managed corpus and query embeddings.
          * @enum {string}
          */
-        ManagedEmbeddingService: "modal" | "open_router";
+        ManagedEmbeddingService: "open_router" | "modal";
         /**
          * @description Where a managed embedding model came from.
          * @enum {string}
@@ -5652,6 +5842,18 @@ export interface components {
             /** Format: double */
             y1: number;
         };
+        /**
+         * @description Exact current-edge count for one observed source-type / relation /
+         *     target-type combination. The graph summary already scans the reduced edge
+         *     set, so exposing this rollup lets schema visualizations avoid one additional
+         *     whole-snapshot query per populated relation.
+         */
+        RelationAdjacencyCount: {
+            count: number;
+            relation: string;
+            source_type: string;
+            target_type: string;
+        };
         RelationSearchResult: {
             name: string;
             relation_id: components["schemas"]["RelationTypeId"];
@@ -5961,6 +6163,12 @@ export interface components {
             messages?: string[];
             result_count: number;
             results?: components["schemas"]["SchemaAuditResult"][];
+            /**
+             * @description True when `result_count` is exact but `results` contains only the
+             *     caller-requested leading window. Whole-graph audits can produce one row
+             *     per offending focus node, so HTTP responses are bounded by default.
+             */
+            truncated?: boolean;
         };
         SchemaAuditResult: {
             component: string;
@@ -6141,7 +6349,19 @@ export interface components {
             /** Format: float */
             weighted_score: number;
         };
-        /** @enum {string} */
+        /**
+         * @description Read consistency for a query surface (search, graph summary, SPARQL).
+         *
+         *     A5 (2026-07-21 product decision): `Eventual` is the **default**. It serves the
+         *     last published index/dataset state at its watermark with no in-memory fold of
+         *     the un-indexed tail — the lowest-latency mode and the availability floor
+         *     during any indexing backlog. The served watermark rides back on
+         *     `SnapshotView::served_at_seq`. `Strong` (fold the un-indexed tail up to the
+         *     query head) is now explicit opt-in; the precise read-your-writes contract
+         *     (`min_indexed_seq`) replaces most former uses of strong. See
+         *     `docs/architecture/segment-native-indexing.md` §6.
+         * @enum {string}
+         */
         SearchConsistency: "strong" | "eventual";
         SearchEngineOptions: {
             bm25?: boolean;
@@ -6154,6 +6374,7 @@ export interface components {
             graph_anchor?: null | components["schemas"]["GraphAnchor"];
             lexical?: boolean;
             max_clusters?: number | null;
+            min_indexed_seq?: null | components["schemas"]["CommitSeq"];
             probe_count?: number | null;
             profile?: null | components["schemas"]["RetrievalProfileId"];
             provider?: null | components["schemas"]["EmbeddingProviderConfig"];
@@ -6899,6 +7120,14 @@ export interface components {
             trained_fusion_run?: number | null;
             unindexed_tail_commits: number;
             vector_candidates: number;
+            /**
+             * @description True when latest-head hybrid search requested the persisted vector/ANN
+             *     channel but no matching run existed, so the optional vector channel was
+             *     skipped instead of silently rebuilding an O(corpus) ephemeral ANN on the
+             *     request path. Explicit ephemeral and historical pinned searches retain
+             *     their existing behavior.
+             */
+            vector_channel_skipped?: boolean;
             /** @description As `bm25_degraded_to_ephemeral`, for the persisted vector/ANN index. */
             vector_degraded_to_ephemeral?: boolean;
             vector_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
@@ -7474,6 +7703,7 @@ export interface components {
              *     `GET /v1/graph/metadata` and on the entity read's metadata.
              */
             compacted_seq: components["schemas"]["CommitSeq"];
+            served_at_seq?: null | components["schemas"]["CommitSeq"];
             /**
              * @description F2 (roadmap 18.3): true when this snapshot was served from the in-memory
              *     cache while storage was degraded and the latest head could not be
@@ -7483,8 +7713,9 @@ export interface components {
              */
             stale?: boolean;
             /**
-             * @description The reason a read is `stale` (F2). `"storage_degraded"` today; omitted
-             *     when not stale.
+             * @description The reason a read is `stale`. `"storage_degraded"` (F2) or
+             *     `"eventual_consistency"` (A3: served from the last published index/dataset
+             *     state at [`Self::served_at_seq`], not head); omitted when not stale.
              */
             stale_reason?: string | null;
         };
@@ -7661,6 +7892,7 @@ export interface components {
              *     Projection, DISTINCT, and limit/offset are ignored.
              */
             ask?: boolean;
+            consistency?: null | components["schemas"]["SearchConsistency"];
             /** @description `SELECT DISTINCT`: drop duplicate projected rows. */
             distinct?: boolean;
             /**
@@ -7705,6 +7937,7 @@ export interface components {
              *     (see `AnalyticQueryRequest::max_solutions`).
              */
             max_solutions?: number | null;
+            min_indexed_seq?: null | components["schemas"]["CommitSeq"];
             /** @description Skip this many rows before `limit`. */
             offset?: number | null;
             /**
@@ -7821,6 +8054,7 @@ export interface components {
             /** @description SPARQL 1.1 Query Results JSON, serialized. */
             results: string;
             row_page: components["schemas"]["RowPage"];
+            snapshot?: null | components["schemas"]["SnapshotView"];
         };
         /**
          * @description A literal constant operand in a FILTER. Scalars compare by typed value;
@@ -12476,19 +12710,17 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_entity: {
+    get_v1_graph_entities_sample: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Entity id */
-                id?: string;
-                /** @description Entity type for name-addressed lookup */
+                /** @description Exact entity type */
                 type?: string;
-                /** @description Entity canonical name for name-addressed lookup */
-                name?: string;
+                /** @description Max sampled rows (up to 128) */
+                limit?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -12509,7 +12741,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EntityDetailResponse"];
+                    "application/json": components["schemas"]["EntityTypeSampleResponse"];
                 };
             };
             /** @description Bad request */
@@ -12618,7 +12850,7 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_entity_metadata: {
+    get_v1_graph_entity: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -12631,8 +12863,6 @@ export interface operations {
                 type?: string;
                 /** @description Entity canonical name for name-addressed lookup */
                 name?: string;
-                /** @description RFC3339 as-of timestamp */
-                as_of?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -12653,7 +12883,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EntityMetadataResponse"];
+                    "application/json": components["schemas"]["EntityDetailResponse"];
                 };
             };
             /** @description Bad request */
@@ -12762,7 +12992,7 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_entity_neighborhood: {
+    get_v1_graph_entity_metadata: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -12775,8 +13005,6 @@ export interface operations {
                 type?: string;
                 /** @description Entity canonical name for name-addressed lookup */
                 name?: string;
-                /** @description Comma-separated relation filter */
-                relations?: string;
                 /** @description RFC3339 as-of timestamp */
                 as_of?: string;
             };
@@ -12799,7 +13027,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EntityNeighborhoodResponse"];
+                    "application/json": components["schemas"]["EntityMetadataResponse"];
                 };
             };
             /** @description Bad request */
@@ -12908,19 +13136,25 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_export: {
+    get_v1_graph_entity_neighborhood: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Records (entity+edge lines) per page (default 1000, clamped 1-50000) */
-                limit?: string;
-                /** @description Opaque page cursor from a prior page's meta.next_cursor; pins the snapshot across pages */
-                cursor?: string;
-                /** @description Pin the export to a past snapshot commit_seq (first page only) */
-                as_of_commit_seq?: string;
+                /** @description Entity id */
+                id?: string;
+                /** @description Entity type for name-addressed lookup */
+                type?: string;
+                /** @description Entity canonical name for name-addressed lookup */
+                name?: string;
+                /** @description Comma-separated relation filter */
+                relations?: string;
+                /** @description RFC3339 as-of timestamp */
+                as_of?: string;
+                /** @description When true, require ranged adjacency and never fall back to a whole-snapshot scan */
+                indexed?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -12941,7 +13175,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": components["schemas"]["EntityNeighborhoodResponse"];
                 };
             };
             /** @description Bad request */
@@ -13050,15 +13284,19 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_export_job: {
+    get_v1_graph_export: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description The export job id returned by the enqueue call */
-                job_id?: string;
+                /** @description Records (entity+edge lines) per page (default 1000, clamped 1-50000) */
+                limit?: string;
+                /** @description Opaque page cursor from a prior page's meta.next_cursor; pins the snapshot across pages */
+                cursor?: string;
+                /** @description Pin the export to a past snapshot commit_seq (first page only) */
+                as_of_commit_seq?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -13188,21 +13426,19 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_export_job: {
+    get_v1_graph_export_job: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Pin the export to a past snapshot commit_seq */
-                as_of_commit_seq?: string;
+                /** @description The export job id returned by the enqueue call */
+                job_id?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` 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;
@@ -13328,38 +13564,28 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_export_rdf: {
+    post_v1_graph_export_job: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description RDF format: turtle (default), nt/ntriples, trig, or nq/nquads */
-                format?: string;
-                /** @description Output ceiling; rejects the full export, or bounds the JSON preview when truncate=true */
-                max_triples?: string;
-                /** @description Return a deterministic bounded JSON preview instead of rejecting when the graph is larger than max_triples */
-                truncate?: string;
-                /** @description RFC3339 valid-time snapshot pin */
-                as_of_valid_time?: string;
-                /** @description Commit-sequence snapshot pin */
+                /** @description Pin the export to a past snapshot commit_seq */
                 as_of_commit_seq?: string;
-                /** @description subclass (default) or none */
-                entailment?: string;
-                /** @description Include stored rule-derived facts when true */
-                reason?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` 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;
         responses: {
-            /** @description RDF graph */
+            /** @description OK */
             200: {
                 headers: {
                     /** @description API contract version used for the response */
@@ -13369,11 +13595,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RdfExportPreviewResponse"];
-                    "application/n-quads": string;
-                    "application/n-triples": string;
-                    "application/trig": string;
-                    "text/turtle": string;
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Bad request */
@@ -13482,15 +13704,27 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_groundability: {
+    get_v1_graph_export_rdf: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Entities to sample for name/recall probes (default 50, max 200) */
-                sample?: string;
+                /** @description RDF format: turtle (default), nt/ntriples, trig, or nq/nquads */
+                format?: string;
+                /** @description Output ceiling; rejects the full export, or bounds the JSON preview when truncate=true */
+                max_triples?: string;
+                /** @description Return a deterministic bounded JSON preview instead of rejecting when the graph is larger than max_triples */
+                truncate?: string;
+                /** @description RFC3339 valid-time snapshot pin */
+                as_of_valid_time?: string;
+                /** @description Commit-sequence snapshot pin */
+                as_of_commit_seq?: string;
+                /** @description subclass (default) or none */
+                entailment?: string;
+                /** @description Include stored rule-derived facts when true */
+                reason?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -13501,7 +13735,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description OK */
+            /** @description RDF graph */
             200: {
                 headers: {
                     /** @description API contract version used for the response */
@@ -13511,7 +13745,11 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GroundabilityReport"];
+                    "application/json": components["schemas"]["RdfExportPreviewResponse"];
+                    "application/n-quads": string;
+                    "application/n-triples": string;
+                    "application/trig": string;
+                    "text/turtle": string;
                 };
             };
             /** @description Bad request */
@@ -13620,19 +13858,19 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_import: {
+    post_v1_graph_fork: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Records per internal commit (default 1000, clamped 1-10000) */
-                batch?: string;
-                /** @description Abort on the first malformed line instead of skipping it */
-                strict?: string;
-                /** @description RFC3339 backfill instant stamped on every batch */
-                observed_at?: string;
+                /** @description Source graph id to fork from */
+                src?: string;
+                /** @description Destination graph id to create (must not exist) */
+                dst?: string;
+                /** @description Must equal the destination graph id to authorize the fork */
+                confirm?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -13655,7 +13893,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphImportResponse"];
+                    "application/json": components["schemas"]["GraphForkResponse"];
                 };
             };
             /** @description Bad request */
@@ -13764,32 +14002,314 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_import_rdf: {
+    get_v1_graph_groundability: {
         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 Entities to sample for name/recall probes (default 50, max 200) */
+                sample?: string;
+            };
+            header?: {
+                /** @description API contract version to pin. Use `2026-06-22` 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"]["GroundabilityReport"];
+                };
+            };
+            /** @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_import: {
+        parameters: {
+            query?: {
+                /** @description Graph name (default `main`) */
+                graph?: string;
+                /** @description Branch name (default `main`) */
+                branch?: string;
+                /** @description Records per internal commit (default 1000, clamped 1-10000) */
+                batch?: string;
+                /** @description Abort on the first malformed line instead of skipping it */
+                strict?: string;
+                /** @description RFC3339 backfill instant stamped on every batch */
+                observed_at?: string;
+            };
+            header?: {
+                /** @description API contract version to pin. Use `2026-06-22` 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;
+        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"]["GraphImportResponse"];
+                };
+            };
+            /** @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_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;
+            };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
                 "Lbb-Version"?: string;
@@ -14340,6 +14860,152 @@ export interface operations {
             };
         };
     };
+    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-06-22` 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;
+        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"]["GraphReloadResponse"];
+                };
+            };
+            /** @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_retract: {
         parameters: {
             query?: {