@littlebigbrain/client 0.4.2 → 0.5.0

package/dist/schema.d.ts

@@ -319,7 +319,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Embed the graph corpus with the managed model and rebuild the Stored ANN index */
+        /** Submit a durable managed-embedding backfill job (legacy path alias) */
         post: operations["post_v1_graph_embedding_backfill"];
         delete?: never;
         options?: never;
@@ -327,6 +327,25 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/graph/embedding/backfill-jobs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read one managed-embedding backfill job */
+        get: operations["get_v1_graph_embedding_backfill_jobs"];
+        put?: never;
+        /** Submit a durable managed-embedding backfill job */
+        post: operations["post_v1_graph_embedding_backfill_jobs"];
+        /** Request cancellation of a managed-embedding backfill job */
+        delete: operations["delete_v1_graph_embedding_backfill_jobs"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/graph/embedding/promote": {
         parameters: {
             query?: never;
@@ -2121,7 +2140,7 @@ export interface components {
         AskFeedbackRequest: {
             /** @description The `ask_id` the ask response carried. */
             ask_id: string;
-            corrected_plan?: null | components["schemas"]["AskStructuredQuery"];
+            corrected_plan?: null | components["schemas"]["AskStructuredPlanV2"];
             /** @description Optional free-text note (bounded server-side). */
             note?: string | null;
             verdict: components["schemas"]["AskFeedbackVerdict"];
@@ -2133,6 +2152,15 @@ export interface components {
              *     clients never break when the flag flips.
              */
             accepted: boolean;
+            accepted_count: number;
+            event_id: string;
+            excluded_count: number;
+            exclusions?: {
+                [key: string]: number;
+            };
+            receipt_id: string;
+            replayed: boolean;
+            trainable_count: number;
         };
         /**
          * @description A user verdict on one ask (`POST /v1/ask/feedback`) — the planner's
@@ -2141,6 +2169,14 @@ export interface components {
          * @enum {string}
          */
         AskFeedbackVerdict: "accepted" | "rejected" | "corrected";
+        /** @enum {string} */
+        AskFilterOperatorV2: "eq" | "ne" | "in" | "contains" | "gt" | "gte" | "lt" | "lte";
+        /** @enum {string} */
+        AskGraphAnchorBehaviorV2: "filter" | "boost";
+        AskGraphAnchorV2: {
+            behavior: components["schemas"]["AskGraphAnchorBehaviorV2"];
+            entity: string;
+        };
         AskGrounding: {
             /**
              * @description Real vocabulary the question snapped to (classes/relations/properties/
@@ -2175,12 +2211,21 @@ export interface components {
              */
             vocab_candidates: number;
         };
+        /** @enum {string} */
+        AskPlanExecutionModeV2: "entity_search" | "path_search" | "hybrid";
         AskQuery: {
             /** @description The retrieval query text that was executed. */
             query: string;
             structured?: null | components["schemas"]["AskStructuredQuery"];
+            structured_v2?: null | components["schemas"]["AskStructuredPlanV2"];
             top_k: number;
         };
+        /** @enum {string} */
+        AskRelationDirectionV2: "outgoing" | "incoming" | "either";
+        AskRelationStepV2: {
+            direction: components["schemas"]["AskRelationDirectionV2"];
+            relation: string;
+        };
         AskRequest: {
             /**
              * Format: int64
@@ -2199,8 +2244,17 @@ export interface components {
              *     grounding is computed — the caller drives its own retrieval/model.
              */
             execute?: boolean | null;
+            /** @description Entity attributes retained as evidence on the internal execution trace. */
+            fields?: string[];
+            filters?: null | components["schemas"]["SearchFilterExpr"];
             /** @description The natural-language question. */
             question: string;
+            /**
+             * @description Opaque alternative to `as_of_commit_seq`. Exactly one pin spelling may
+             *     be supplied; grounding, validation, execution, trace, and citations all
+             *     use the resolved commit.
+             */
+            snapshot_token?: string | null;
             /** @description Max citations to return (default 8, clamped to 25). */
             top_k?: number | null;
         };
@@ -2237,6 +2291,23 @@ export interface components {
             query?: null | components["schemas"]["AskQuery"];
             snapshot: components["schemas"]["SnapshotView"];
         };
+        AskStructuredPlanV2: {
+            execution_mode: components["schemas"]["AskPlanExecutionModeV2"];
+            filters?: components["schemas"]["AskTypedFilterV2"][];
+            frontier_limit: number;
+            graph_anchor?: null | components["schemas"]["AskGraphAnchorV2"];
+            /** Format: int32 */
+            hop_limit: number;
+            path_limit: number;
+            relation_steps: components["schemas"]["AskRelationStepV2"][];
+            result_limit: number;
+            target_types: string[];
+            /**
+             * Format: int32
+             * @description Contract version; must be exactly 2.
+             */
+            v: number;
+        };
         /**
          * @description The constrained structured plan: the entity type the answer set is
          *     restricted to (the QALD-class-task shape), plus — when the question admits
@@ -2292,6 +2363,11 @@ export interface components {
              */
             total_ms: number;
         };
+        AskTypedFilterV2: {
+            field: string;
+            operator: components["schemas"]["AskFilterOperatorV2"];
+            value: unknown;
+        };
         AssertionSearchResult: {
             /** Format: float */
             confidence: number;
@@ -2917,9 +2993,11 @@ export interface components {
         };
         EntityId: string;
         EntityMetadataResponse: {
+            adjacency_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
             ann_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
             bm25_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
             entity: components["schemas"]["EntityView"];
+            index_lineage?: null | components["schemas"]["IndexLineage"];
             last_commit?: null | components["schemas"]["CommitSeq"];
             object_hash?: string | null;
             object_key?: string | null;
@@ -3080,6 +3158,33 @@ export interface components {
             text?: string | null;
             vector: number[];
         };
+        ExternalPlannerTraceV1: {
+            ask_id: string;
+            citations?: unknown[];
+            /** Format: double */
+            cost?: number | null;
+            entities?: unknown[];
+            execution_error?: string | null;
+            execution_outcome: string;
+            failure_reason?: string | null;
+            final_user_outcome?: string | null;
+            /** Format: double */
+            latency_ms: number;
+            original_question: string;
+            paths?: unknown[];
+            planner_model: string;
+            planner_provider: string;
+            prompt_hash: string;
+            prompt_version: string;
+            raw_output: unknown;
+            snapshot_token: string;
+            /** Format: int64 */
+            tokens?: number | null;
+            /** Format: int32 */
+            v: number;
+            validated_plan?: null | components["schemas"]["AskStructuredPlanV2"];
+            validation_result: string;
+        };
         /**
          * @description `GET /v1/models/extractor-dataset` — the extractor fine-tune's training
          *     feed: stored `EPISODE` transcripts joined (via evidence observations) to
@@ -3585,9 +3690,21 @@ export interface components {
             error_count: number;
             errors?: components["schemas"]["GraphImportLineError"][];
             graph_created: boolean;
+            /** @description The caller key, or the server-minted key when the caller omitted one. */
+            idempotency_key: string;
+            /**
+             * @description True when every internal mutation batch was the already-committed
+             *     receipt for this idempotency key.
+             */
+            idempotent_replay: boolean;
             index?: null | components["schemas"]["GraphImportIndexOutcome"];
             indexed: boolean;
             lines_read: number;
+            /**
+             * @description Stable identity for the whole multi-batch mutation. Replays return this
+             *     exact receipt and the original terminal commit sequence.
+             */
+            mutation_receipt_id: string;
             properties: number;
             triplets: number;
         };
@@ -3616,6 +3733,7 @@ export interface components {
             targets: components["schemas"]["AnnTargetKind"][];
         };
         GraphMetadataResponse: {
+            adjacency_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
             ann_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
             bm25_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
             graph: components["schemas"]["GraphKey"];
@@ -3632,6 +3750,7 @@ export interface components {
              *     the persisted fast path being current, not queryability.
              */
             index_caught_up?: boolean | null;
+            index_lineage?: null | components["schemas"]["IndexLineage"];
             /** Format: int64 */
             object_bytes: number;
             object_count: number;
@@ -3976,6 +4095,21 @@ export interface components {
             skipped_branch_shared: boolean;
             snapshot: components["schemas"]["SnapshotView"];
         };
+        /** @description Typed convergence view over the persisted serving families. */
+        IndexLineage: {
+            adjacency_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
+            ann_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
+            bm25_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
+            caught_up: boolean;
+            head_commit_seq: components["schemas"]["CommitSeq"];
+            /**
+             * @description Content identity of the head generation plus the exact three manifest
+             *     views observed while constructing this response.
+             */
+            manifest_view_token: string;
+            /** Format: int64 */
+            observed_at_micros: number;
+        };
         IndexRunView: {
             /** Format: int64 */
             bytes: number;
@@ -4070,15 +4204,61 @@ export interface components {
         LbbErrorEnvelope: {
             error: components["schemas"]["LbbErrorBody"];
         };
+        ManagedEmbeddingBackfillJobProgress: {
+            continuation?: string | null;
+            embedded: number;
+            failed: number;
+            final_index_job_id?: string | null;
+            /** Format: int64 */
+            heartbeat_micros: number;
+            index_lineage?: null | components["schemas"]["IndexLineage"];
+            missing: number;
+            processed: number;
+            skipped: number;
+            /** Format: int64 */
+            source_commit_seq: number;
+            source_snapshot_token: string;
+            total: number;
+            worker?: string | null;
+        };
+        ManagedEmbeddingBackfillJobRequest: {
+            batch_size?: number | null;
+            full?: boolean;
+            limit?: number | null;
+        };
+        ManagedEmbeddingBackfillJobStatusResponse: {
+            /** Format: int32 */
+            attempts: number;
+            /** Format: int64 */
+            enqueued_at_micros: number;
+            graph: components["schemas"]["GraphKey"];
+            idempotency_key: string;
+            job_id: string;
+            progress?: null | components["schemas"]["ManagedEmbeddingBackfillJobProgress"];
+            result?: null | components["schemas"]["ManagedEmbeddingBackfillResponse"];
+            status: string;
+            terminal_error?: string | null;
+            /** Format: int64 */
+            updated_at_micros: number;
+        };
         /** @description Outcome of embedding the corpus and rebuilding its Stored ANN index. */
         ManagedEmbeddingBackfillResponse: {
             batches: number;
+            continuation?: string | null;
             embedded: number;
             entities_total: number;
+            failed: number;
+            final_index_job_id?: string | null;
+            index_lineage?: null | components["schemas"]["IndexLineage"];
             /** Format: int64 */
             indexed_commit_seq: number;
+            missing: number;
             model_id: string;
+            processed: number;
             skipped: number;
+            /** Format: int64 */
+            source_commit_seq: number;
+            source_snapshot_token: string;
             truncated: boolean;
         };
         /** @description The resolved, versioned managed embedding configuration. */
@@ -4661,6 +4841,7 @@ export interface components {
              */
             allow_data_conflicts?: boolean;
             ops: components["schemas"]["OntologyEvolveOp"][];
+            preconditions?: null | components["schemas"]["WritePreconditions"];
         };
         OntologyEvolveResponse: {
             /**
@@ -4993,7 +5174,10 @@ export interface components {
          *     exact serving prompt.
          */
         PlannerExample: {
+            ask_id?: string | null;
+            example_id: string;
             plan: components["schemas"]["AskStructuredQuery"];
+            plan_v2: components["schemas"]["AskStructuredPlanV2"];
             question: string;
             /**
              * @description The `ask_trace` shortlists (`{classes, relations, anchors}`) for
@@ -5041,9 +5225,18 @@ export interface components {
          *     corrupt one slot of an execution-verified gold plan.
          */
         PlannerPreferencePair: {
+            ask_id?: string | null;
             chosen: components["schemas"]["AskStructuredQuery"];
+            chosen_v2: components["schemas"]["AskStructuredPlanV2"];
+            /**
+             * @description True when the corrected ask produced no original structured plan. Such
+             *     a row is retained as an explicit absent-original preference pair.
+             */
+            original_absent: boolean;
+            pair_id: string;
             question: string;
-            rejected: components["schemas"]["AskStructuredQuery"];
+            rejected?: null | components["schemas"]["AskStructuredQuery"];
+            rejected_v2?: null | components["schemas"]["AskStructuredPlanV2"];
             /** @description The `ask_trace` shortlists for feedback pairs; `None` for synthetic. */
             shortlists?: unknown;
             /** @description `corrected` | `rejected_paired` | `synthetic`. */
@@ -5348,6 +5541,8 @@ export interface components {
          *     by construction — the resolver never fabricates a term.
          */
         ResolveTermRequest: {
+            /** Format: int64 */
+            as_of_commit_seq?: number | null;
             /**
              * @description Restrict resolution to this explicit candidate set (the narrowed
              *     shortlist — e.g. relations WS10 admitted for a type pair). Each candidate
@@ -5360,10 +5555,12 @@ export interface components {
              *     `candidates` is supplied (the candidate list is the search space).
              */
             kinds?: components["schemas"]["SuggestKind"][];
+            snapshot_token?: string | null;
             /** @description The free text to snap to real vocabulary (1..=256 chars). */
             text: string;
             /** @description Max matches to return (default 3, clamped to 25). */
             top_k?: number | null;
+            vocabulary_filter?: null | components["schemas"]["VocabularyFilter"];
         };
         ResolveTermResponse: {
             matches: components["schemas"]["ResolvedTerm"][];
@@ -5374,6 +5571,7 @@ export interface components {
              */
             method: components["schemas"]["ResolveMethod"];
             snapshot: components["schemas"]["SnapshotView"];
+            snapshot_token: string;
         };
         /** @enum {string} */
         ResolvedKind: "concept" | "entity" | "relation" | "candidate_concept" | "candidate_relation" | "rejected";
@@ -5387,6 +5585,7 @@ export interface components {
         };
         ResolvedTerm: {
             kind: components["schemas"]["SuggestKind"];
+            provenance?: null | components["schemas"]["VocabularyProvenance"];
             /**
              * Format: float
              * @description Similarity to the input in [0, 1]; higher is closer.
@@ -5692,6 +5891,7 @@ export interface components {
             attributes?: {
                 [key: string]: unknown;
             } | null;
+            contributions?: null | components["schemas"]["SearchHitContributions"];
             entity: components["schemas"]["EntityView"];
             matched_concepts: string[];
             /** Format: float */
@@ -5704,6 +5904,14 @@ export interface components {
             source_id: string;
             text?: string | null;
         };
+        SearchChannelContribution: {
+            /** Format: float */
+            raw_score: number;
+            /** Format: float */
+            weight: number;
+            /** Format: float */
+            weighted_score: number;
+        };
         /** @enum {string} */
         SearchConsistency: "strong" | "eventual";
         SearchEngineOptions: {
@@ -5904,6 +6112,10 @@ export interface components {
              *     idempotent replays do not advance it and retractions do.
              */
             latest_label_sequence: number;
+            /**
+             * @description Label objects fetched for this request. Zero on a materialized-cache hit;
+             *     a rebuild reports the bounded source objects it read.
+             */
             objects_scanned: number;
             promoted_models: components["schemas"]["SearchFeedbackPromotedModel"][];
             raw_events: number;
@@ -6033,6 +6245,30 @@ export interface components {
             op: "not";
         };
         SearchFilterValue: null | boolean | number | string;
+        SearchHitContributions: {
+            adjacency_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
+            bm25: components["schemas"]["SearchChannelContribution"];
+            bm25_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
+            bm25_manifest_key?: string | null;
+            filter_pruned: boolean;
+            /** Format: float */
+            final_score: number;
+            graph: components["schemas"]["SearchChannelContribution"];
+            lexical: components["schemas"]["SearchChannelContribution"];
+            ontology: components["schemas"]["SearchChannelContribution"];
+            /**
+             * Format: float
+             * @description Type boosts, score floors/clamps, graph-anchor boosts, observation-owner
+             *     promotion, and class-intent promotion are accounted for here.
+             */
+            post_fusion_adjustment: number;
+            snapshot_commit_seq: components["schemas"]["CommitSeq"];
+            /** Format: int64 */
+            trained_fusion_run?: number | null;
+            vector: components["schemas"]["SearchChannelContribution"];
+            vector_indexed_commit_seq?: null | components["schemas"]["CommitSeq"];
+            vector_manifest_key?: string | null;
+        };
         SearchIndexFamilyRun: {
             family: string;
             indexed_commit_seq_after: components["schemas"]["CommitSeq"];
@@ -6085,6 +6321,12 @@ export interface components {
             adjacency?: null | components["schemas"]["SearchIndexFamilyRun"];
             embeddings?: null | components["schemas"]["SearchIndexFamilyRun"];
             full_text?: null | components["schemas"]["SearchIndexFamilyRun"];
+            /**
+             * @description One coherent observation of every serving index family after this run.
+             *     Unlike the per-family build outcomes, this also includes families the
+             *     request did not rebuild and is therefore the convergence contract.
+             */
+            index_lineage: components["schemas"]["IndexLineage"];
             permutation?: null | components["schemas"]["SearchIndexFamilyRun"];
             snapshot: components["schemas"]["SnapshotView"];
         };
@@ -6216,6 +6458,12 @@ export interface components {
          *     completions are strings that provably exist in the graph at this snapshot.
          */
         SearchSuggestRequest: {
+            /**
+             * Format: int64
+             * @description Transaction-time vocabulary pin. Mutually exclusive with
+             *     `snapshot_token`.
+             */
+            as_of_commit_seq?: number | null;
             context?: null | components["schemas"]["SuggestContext"];
             /** @description Restrict `attribute_value` suggestions to one attribute field. */
             field?: string | null;
@@ -6225,9 +6473,21 @@ export interface components {
             limit?: number | null;
             prefix: string;
             ranker?: null | components["schemas"]["SuggestRankerWeights"];
+            /**
+             * @description Opaque graph snapshot identity previously returned by LBB. Mutually
+             *     exclusive with `as_of_commit_seq`.
+             */
+            snapshot_token?: string | null;
+            vocabulary_filter?: null | components["schemas"]["VocabularyFilter"];
         };
         SearchSuggestResponse: {
             snapshot: components["schemas"]["SnapshotView"];
+            /**
+             * @description Opaque vocabulary token binding graph epoch, commit, and ontology
+             *     version. Feed it to a subsequent suggest/resolve request to fail closed
+             *     on vocabulary drift.
+             */
+            snapshot_token: string;
             suggestions: components["schemas"]["SearchSuggestion"][];
             /**
              * Format: int64
@@ -6245,6 +6505,7 @@ export interface components {
             /** @description The attribute field, for `attribute_value` suggestions. */
             field?: string | null;
             kind: components["schemas"]["SuggestKind"];
+            provenance?: null | components["schemas"]["VocabularyProvenance"];
             /** Format: float */
             score: number;
             /**
@@ -6757,7 +7018,28 @@ export interface components {
              */
             hit_rate_at_k: number;
             /** Format: double */
+            latency_p50_ms?: number;
+            /** Format: double */
+            latency_p95_ms?: number;
+            /** Format: double */
+            latency_p99_ms?: number;
+            /** Format: double */
             mean_latency_ms: number;
+            /**
+             * Format: float
+             * @description Mean reciprocal rank of the first expected target in top-k.
+             */
+            mrr_at_k?: number;
+            /**
+             * Format: float
+             * @description Mean binary-relevance nDCG over top-k.
+             */
+            ndcg_at_k?: number;
+            /**
+             * Format: float
+             * @description Mean fraction of each query's expected targets recovered in top-k.
+             */
+            recall_at_k?: number;
         };
         /**
          * @description `POST /v1/models/shadow-eval` — champion vs challenger retrieval over the
@@ -6830,8 +7112,17 @@ export interface components {
         SignalIngestResponse: {
             /** @description Number of signals written (0 when the feature flag is off). */
             accepted: number;
+            accepted_count: number;
+            event_id: string;
+            excluded_count: number;
+            exclusions?: {
+                [key: string]: number;
+            };
             /** @description The object the batch was flushed to, absent when nothing was written. */
             object_key?: string | null;
+            receipt_id: string;
+            replayed: boolean;
+            trainable_count: number;
         };
         /**
          * @description One signal as a client sends it. The server stamps `v`, `ts`, and (when the
@@ -6854,7 +7145,7 @@ export interface components {
          *     material the planner fine-tune trains on.
          * @enum {string}
          */
-        SignalKind: "suggestion_shown" | "suggestion_adopted" | "zero_result" | "atom_cited" | "branch_merge_accepted" | "branch_merge_rejected" | "tool_error" | "speculation_summary" | "ask_trace" | "ask_feedback";
+        SignalKind: "suggestion_shown" | "suggestion_adopted" | "zero_result" | "atom_cited" | "branch_merge_accepted" | "branch_merge_rejected" | "tool_error" | "speculation_summary" | "ask_trace" | "ask_feedback" | "external_planner_trace";
         /**
          * @description `GET /v1/signals?from=&to=&limit=` — the consumer side of the signal bus:
          *     signals whose flush seq lies in `[from, to]`, oldest first. Trainers split
@@ -7382,6 +7673,24 @@ export interface components {
             query: string;
             reason: components["schemas"]["SuggestReason"];
         };
+        SuggestionAdoptedV1: {
+            candidate_id: string;
+            prefix: string;
+            rank: number;
+            suggestion_id: string;
+            text: string;
+            /** Format: int32 */
+            v: number;
+        };
+        SuggestionShownV1: {
+            candidate_id: string;
+            prefix: string;
+            rank: number;
+            suggestion_id: string;
+            text: string;
+            /** Format: int32 */
+            v: number;
+        };
         /**
          * @description `GET /v1/models/synthetic-eval` — execution-verified QA pairs generated
          *     FROM the graph: each question is templated from a current edge and its
@@ -7472,6 +7781,8 @@ export interface components {
              * @description Challenger − champion hit-rate on the held-out eval slice.
              */
             effect: number;
+            /** Format: float */
+            hit_rate_delta?: number | null;
             /** @description Labeled eval probes the decision is over. */
             labeled: number;
             /**
@@ -7492,9 +7803,55 @@ export interface components {
             min_effect: number;
             /** @description Minimum labeled probes for any promotion. */
             min_labeled: number;
+            /** Format: float */
+            mrr_delta?: number | null;
+            /**
+             * Format: float
+             * @description Deterministic paired-bootstrap 95% interval for challenger − champion
+             *     nDCG@10. Promotion requires the lower bound to be at least zero.
+             */
+            ndcg_ci95_lower?: number | null;
+            /** Format: float */
+            ndcg_ci95_upper?: number | null;
+            /** Format: float */
+            non_inferiority_boundary?: number | null;
             passed: boolean;
             /** @description Human-readable one-liner for the console status surface. */
             reason: string;
+            /**
+             * Format: float
+             * @description Fusion-only paired held-out deltas. All must be non-negative.
+             */
+            recall_delta?: number | null;
+        };
+        /** @description Bounded in-flight work counters for a durable trainer job. */
+        TrainModelJobProgress: {
+            candidates_completed: number;
+            candidates_total: number;
+            /**
+             * Format: int64
+             * @description Linear estimate from work completed so far. Absent before the first
+             *     measured probe or for trainers without fine-grained progress.
+             */
+            estimated_duration_ms?: number | null;
+            /**
+             * Format: int64
+             * @description Worker heartbeat attached to this progress snapshot.
+             */
+            heartbeat_micros: number;
+            /**
+             * Format: float
+             * @description Monotonic completion percentage in `[0, 100]`.
+             */
+            percentage: number;
+            /** @description `preparing` | `candidate_search` | `held_out_gate` | kind-specific stage. */
+            phase: string;
+            /** @description Expensive search executions or cached-score evaluations completed. */
+            replay_evaluations_completed: number;
+            replay_evaluations_total: number;
+            /** @description Distinct input probes prepared at the pinned source snapshot. */
+            source_probes_completed: number;
+            source_probes_total: number;
         };
         /**
          * @description Durable background trainer status. The terminal `result` carries the full
@@ -7508,6 +7865,7 @@ export interface components {
             graph: components["schemas"]["GraphKey"];
             job_id: string;
             kind: string;
+            progress?: null | components["schemas"]["TrainModelJobProgress"];
             result?: null | components["schemas"]["TrainModelResponse"];
             stage?: string | null;
             /** @description `pending` | `running` | `succeeded` | `failed`. */
@@ -7608,6 +7966,12 @@ export interface components {
             as_of_commit_seq?: number | null;
             as_of_valid_time?: string | null;
             direction: components["schemas"]["ExpansionDirection"];
+            /**
+             * @description Entity fields projected for every seed/intermediate/terminal node in
+             *     `TraverseResponse.projected_nodes`.
+             */
+            fields?: string[];
+            filter?: null | components["schemas"]["SearchFilterExpr"];
             /**
              * Format: int64
              * @description Decoded adjacency-block working-set byte budget for the ranged path.
@@ -7631,6 +7995,16 @@ export interface components {
         };
         TraverseResponse: {
             paths: components["schemas"]["PathResult"][];
+            /**
+             * @description Same-snapshot field evidence for every node appearing in `paths`, keyed
+             *     by stable entity-id hex. Present as an empty map when no fields were
+             *     requested.
+             */
+            projected_nodes?: {
+                [key: string]: {
+                    [key: string]: unknown;
+                };
+            };
             ranged?: null | components["schemas"]["RangedTraverseStats"];
             snapshot: components["schemas"]["SnapshotView"];
         };
@@ -7661,6 +8035,7 @@ export interface components {
              *     `as_of` returns empty. Omit it for normal live writes (stamped now).
              */
             observed_at?: string | null;
+            preconditions?: null | components["schemas"]["WritePreconditions"];
             property_merge?: null | components["schemas"]["PropertyMergeMode"];
             /**
              * @description The edges to commit. Defaults to empty so a properties-only or
@@ -7689,6 +8064,16 @@ export interface components {
             target: components["schemas"]["EntityView"];
             valid_time: components["schemas"]["ValidTime"];
         };
+        TypedAskFeedbackV1: {
+            ask_id: string;
+            note?: string | null;
+            original_absent: boolean;
+            original_plan?: null | components["schemas"]["AskStructuredPlanV2"];
+            preferred_plan?: null | components["schemas"]["AskStructuredPlanV2"];
+            /** Format: int32 */
+            v: number;
+            verdict: string;
+        };
         ValidTime: {
             /** Format: int64 */
             end_micros?: number | null;
@@ -7732,6 +8117,22 @@ export interface components {
             /** @description True when any section hit its cap (silent truncation is never OK). */
             truncated: boolean;
         };
+        VocabularyFilter: {
+            include_builtin?: boolean | null;
+            namespace_allow?: string[];
+            namespace_deny?: string[];
+            origins?: components["schemas"]["VocabularyOrigin"][];
+        };
+        /** @enum {string} */
+        VocabularyOrigin: "builtin" | "tenant" | "imported";
+        VocabularyProvenance: {
+            candidate_id: string;
+            namespace: string;
+            /** Format: int64 */
+            ontology_version: number;
+            origin: components["schemas"]["VocabularyOrigin"];
+            source_reference: string;
+        };
         WalCompactRequest: {
             /**
              * @description When appending the new segment would leave the manifest with more
@@ -7816,16 +8217,449 @@ export interface components {
             /** @description Relation to widen, by name (case-insensitive). */
             relation: string;
         };
+        WritePreconditions: {
+            /** Format: int64 */
+            expected_head_commit_seq?: number | null;
+            /** Format: int64 */
+            expected_ontology_version?: number | null;
+            expected_snapshot_token?: string | null;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    post_v1_ask: {
+        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-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: {
+            content: {
+                "application/json": components["schemas"]["AskRequest"];
+            };
+        };
+        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"]["AskResponse"];
+                };
+            };
+            /** @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_ask_feedback: {
+        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-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: {
+            content: {
+                "application/json": components["schemas"]["AskFeedbackRequest"];
+            };
+        };
+        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"]["AskFeedbackResponse"];
+                };
+            };
+            /** @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_decode: {
+        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-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: {
+            content: {
+                "application/json": components["schemas"]["DecodeRequest"];
+            };
+        };
+        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"]["DecodeResponse"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
     };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-export type $defs = Record<string, never>;
-export interface operations {
-    post_v1_ask: {
+    get_v1_demo_datasets: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -7836,17 +8670,11 @@ export interface operations {
             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. Required for fact commits. */
-                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["AskRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -7858,7 +8686,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AskResponse"];
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Bad request */
@@ -7967,28 +8795,26 @@ export interface operations {
             };
         };
     };
-    post_v1_ask_feedback: {
+    post_v1_demo_download_public_datasets: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Public dataset id */
+                dataset?: 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. Required for fact commits. */
+                /** @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"]["AskFeedbackRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -8000,7 +8826,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AskFeedbackResponse"];
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Bad request */
@@ -8109,28 +8935,28 @@ export interface operations {
             };
         };
     };
-    post_v1_decode: {
+    post_v1_demo_load: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Dataset id */
+                dataset?: string;
+                /** @description Build indexes after loading */
+                build?: 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. Required for fact commits. */
+                /** @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"]["DecodeRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -8142,7 +8968,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["DecodeResponse"];
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Bad request */
@@ -8251,7 +9077,7 @@ export interface operations {
             };
         };
     };
-    get_v1_demo_datasets: {
+    get_v1_demo_public_datasets: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -8387,20 +9213,22 @@ export interface operations {
             };
         };
     };
-    post_v1_demo_download_public_datasets: {
+    post_v1_demo_run: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Public dataset id */
+                /** @description Dataset id */
                 dataset?: string;
+                /** @description Index source: persisted or ephemeral */
+                source?: 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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -8527,28 +9355,28 @@ export interface operations {
             };
         };
     };
-    post_v1_demo_load: {
+    post_v1_graph_branch: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Dataset id */
-                dataset?: string;
-                /** @description Build indexes after loading */
-                build?: 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. Required for fact commits. */
+                /** @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"]["GraphBranchCreateRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -8560,7 +9388,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": components["schemas"]["GraphBranchCreateResponse"];
                 };
             };
             /** @description Bad request */
@@ -8669,7 +9497,7 @@ export interface operations {
             };
         };
     };
-    get_v1_demo_public_datasets: {
+    post_v1_graph_branch_merge: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -8680,11 +9508,17 @@ export interface operations {
             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;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GraphBranchMergeRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -8696,7 +9530,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": components["schemas"]["GraphBranchMergeResponse"];
                 };
             };
             /** @description Bad request */
@@ -8805,23 +9639,17 @@ export interface operations {
             };
         };
     };
-    post_v1_demo_run: {
+    get_v1_graph_card: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Dataset id */
-                dataset?: string;
-                /** @description Index source: persisted or ephemeral */
-                source?: 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. Required for fact commits. */
-                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
@@ -8838,7 +9666,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": components["schemas"]["GraphCard"];
                 };
             };
             /** @description Bad request */
@@ -8947,28 +9775,26 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_branch: {
+    get_v1_graph_changes: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Exclusive lower bound commit_seq (default 0) */
+                since?: string;
+                /** @description Max records per page (default 500, max 5000) */
+                limit?: 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. Required for fact commits. */
-                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["GraphBranchCreateRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -8980,7 +9806,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphBranchCreateResponse"];
+                    "application/json": components["schemas"]["GraphChangesResponse"];
                 };
             };
             /** @description Bad request */
@@ -9089,26 +9915,28 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_branch_merge: {
+    post_v1_graph_commit: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Validate only and return a GraphCommitDryRunResponse without writing (no Idempotency-Key required) */
+                dry_run?: string;
             };
-            header?: {
+            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. Required for fact commits. */
-                "Idempotency-Key"?: 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"]["GraphBranchMergeRequest"];
+                "application/json": components["schemas"]["TripletCommitFile"];
             };
         };
         responses: {
@@ -9122,7 +9950,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphBranchMergeResponse"];
+                    "application/json": components["schemas"]["GraphCommitResponse"];
                 };
             };
             /** @description Bad request */
@@ -9231,17 +10059,23 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_card: {
+    post_v1_graph_compact: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Minimum tail commits before compaction */
+                min_tail_commits?: string;
+                /** @description Merge into at most this many segments */
+                max_segments?: 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;
@@ -9258,7 +10092,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphCard"];
+                    "application/json": components["schemas"]["WalCompactResponse"];
                 };
             };
             /** @description Bad request */
@@ -9367,21 +10201,19 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_changes: {
+    post_v1_graph_create: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Exclusive lower bound commit_seq (default 0) */
-                since?: string;
-                /** @description Max records per page (default 500, max 5000) */
-                limit?: 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;
@@ -9398,7 +10230,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphChangesResponse"];
+                    "application/json": components["schemas"]["CreateGraphResponse"];
                 };
             };
             /** @description Bad request */
@@ -9507,30 +10339,26 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_commit: {
+    post_v1_graph_delete: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Validate only and return a GraphCommitDryRunResponse without writing (no Idempotency-Key required) */
-                dry_run?: string;
+                /** @description Must equal the target graph id to authorize deletion */
+                confirm?: string;
             };
-            header: {
+            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. Required for fact commits. */
-                "Idempotency-Key": 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"]["TripletCommitFile"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -9542,7 +10370,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GraphCommitResponse"];
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Bad request */
@@ -9651,23 +10479,25 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_compact: {
+    get_v1_graph_edges: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Minimum tail commits before compaction */
-                min_tail_commits?: string;
-                /** @description Merge into at most this many segments */
-                max_segments?: string;
+                /** @description Search text */
+                q?: string;
+                /** @description Relation filter */
+                relation?: string;
+                /** @description Max rows */
+                limit?: string;
+                /** @description Opaque cursor from the previous page (legacy `offset` also accepted) */
+                cursor?: 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. Required for fact commits. */
-                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
@@ -9684,7 +10514,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["WalCompactResponse"];
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Bad request */
@@ -9793,7 +10623,7 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_create: {
+    get_v1_graph_embedding: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -9804,8 +10634,6 @@ export interface operations {
             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. Required for fact commits. */
-                "Idempotency-Key"?: string;
             };
             path?: never;
             cookie?: never;
@@ -9822,7 +10650,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CreateGraphResponse"];
+                    "application/json": components["schemas"]["ManagedEmbeddingConfigResponse"];
                 };
             };
             /** @description Bad request */
@@ -9931,26 +10759,28 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_delete: {
+    post_v1_graph_embedding: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Must equal the target graph id to authorize deletion */
-                confirm?: 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. Required for fact commits. */
+                /** @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"]["ManagedEmbeddingConfigRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -9962,7 +10792,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": components["schemas"]["ManagedEmbeddingConfigResponse"];
                 };
             };
             /** @description Bad request */
@@ -10071,30 +10901,34 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_edges: {
+    post_v1_graph_embedding_backfill: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Search text */
-                q?: string;
-                /** @description Relation filter */
-                relation?: string;
-                /** @description Max rows */
+                /** @description Embedding batch size (default 128, max 512) */
+                batch_size?: string;
+                /** @description Maximum entities to consider (default 100000) */
                 limit?: string;
-                /** @description Opaque cursor from the previous page (legacy `offset` also accepted) */
-                cursor?: string;
+                /** @description Re-embed all entities instead of only new entities */
+                full?: 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;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ManagedEmbeddingBackfillJobRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -10106,7 +10940,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": components["schemas"]["ManagedEmbeddingBackfillJobStatusResponse"];
                 };
             };
             /** @description Bad request */
@@ -10215,13 +11049,15 @@ export interface operations {
             };
         };
     };
-    get_v1_graph_embedding: {
+    get_v1_graph_embedding_backfill_jobs: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Stable backfill job id */
+                job_id?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -10242,7 +11078,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ManagedEmbeddingConfigResponse"];
+                    "application/json": components["schemas"]["ManagedEmbeddingBackfillJobStatusResponse"];
                 };
             };
             /** @description Bad request */
@@ -10351,7 +11187,7 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_embedding: {
+    post_v1_graph_embedding_backfill_jobs: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
@@ -10362,7 +11198,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -10370,7 +11206,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ManagedEmbeddingConfigRequest"];
+                "application/json": components["schemas"]["ManagedEmbeddingBackfillJobRequest"];
             };
         };
         responses: {
@@ -10384,7 +11220,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ManagedEmbeddingConfigResponse"];
+                    "application/json": components["schemas"]["ManagedEmbeddingBackfillJobStatusResponse"];
                 };
             };
             /** @description Bad request */
@@ -10493,24 +11329,20 @@ export interface operations {
             };
         };
     };
-    post_v1_graph_embedding_backfill: {
+    delete_v1_graph_embedding_backfill_jobs: {
         parameters: {
             query?: {
                 /** @description Graph name (default `main`) */
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
-                /** @description Embedding batch size (default 128, max 512) */
-                batch_size?: string;
-                /** @description Maximum entities to consider (default 100000) */
-                limit?: string;
-                /** @description Re-embed all entities instead of only new entities */
-                full?: string;
+                /** @description Stable backfill job id */
+                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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -10528,7 +11360,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ManagedEmbeddingBackfillResponse"];
+                    "application/json": components["schemas"]["ManagedEmbeddingBackfillJobStatusResponse"];
                 };
             };
             /** @description Bad request */
@@ -10652,7 +11484,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -10938,7 +11770,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -11794,7 +12626,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -12230,7 +13062,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -12386,7 +13218,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -12802,7 +13634,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -12944,7 +13776,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -13086,7 +13918,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -13228,7 +14060,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -13648,7 +14480,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -14070,7 +14902,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -14212,7 +15044,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -14356,7 +15188,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -14632,7 +15464,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -14776,7 +15608,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -14918,7 +15750,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -15196,7 +16028,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -15338,7 +16170,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -15480,7 +16312,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -16184,7 +17016,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -16326,7 +17158,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -16468,7 +17300,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -16606,7 +17438,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -16890,7 +17722,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -17028,7 +17860,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -17726,7 +18558,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -17868,7 +18700,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -18146,7 +18978,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -18560,7 +19392,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -18840,7 +19672,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -18984,7 +19816,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key": string;
             };
             path?: never;
@@ -19126,7 +19958,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -19266,7 +20098,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -19406,7 +20238,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -19548,7 +20380,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -19690,7 +20522,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -19832,7 +20664,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -19974,7 +20806,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -20116,7 +20948,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -20258,7 +21090,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -20400,7 +21232,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -20542,7 +21374,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -20684,7 +21516,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -20826,7 +21658,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -20968,7 +21800,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -21110,7 +21942,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -21392,7 +22224,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -21532,7 +22364,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -21674,7 +22506,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -21960,7 +22792,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -22102,7 +22934,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -22244,7 +23076,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -22658,7 +23490,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -22800,7 +23632,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -22942,7 +23774,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -23084,7 +23916,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -23226,7 +24058,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -23364,7 +24196,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -23506,7 +24338,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -23648,7 +24480,7 @@ export interface operations {
             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. Required for fact commits. */
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
                 "Idempotency-Key"?: string;
             };
             path?: never;
@@ -24069,11 +24901,11 @@ export interface operations {
                 /** @description Branch name (default `main`) */
                 branch?: string;
             };
-            header?: {
+            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. Required for fact commits. */
-                "Idempotency-Key"?: string;
+                /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
+                "Idempotency-Key": string;
             };
             path?: never;
             cookie?: never;