@littlebigbrain/client 0.5.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/schema.d.ts CHANGED
@@ -150,7 +150,8 @@ export interface paths {
150
150
  put?: never;
151
151
  /** Fork the scoped branch from an existing branch in the same graph */
152
152
  post: operations["post_v1_graph_branch"];
153
- delete?: never;
153
+ /** Delete the scoped branch; refuses to delete a graph's final live branch */
154
+ delete: operations["delete_v1_graph_branch"];
154
155
  options?: never;
155
156
  head?: never;
156
157
  patch?: never;
@@ -267,7 +268,7 @@ export interface paths {
267
268
  };
268
269
  get?: never;
269
270
  put?: never;
270
- /** Delete every object under the scoped graph/branch (a reset); branch-scoped and destructive */
271
+ /** Delete every branch and deregister the scoped graph; destructive and idempotent */
271
272
  post: operations["post_v1_graph_delete"];
272
273
  delete?: never;
273
274
  options?: never;
@@ -346,6 +347,23 @@ export interface paths {
346
347
  patch?: never;
347
348
  trace?: never;
348
349
  };
350
+ "/v1/graph/embedding/models": {
351
+ parameters: {
352
+ query?: never;
353
+ header?: never;
354
+ path?: never;
355
+ cookie?: never;
356
+ };
357
+ /** List the embedding models available on this deployment */
358
+ get: operations["get_v1_graph_embedding_models"];
359
+ put?: never;
360
+ post?: never;
361
+ delete?: never;
362
+ options?: never;
363
+ head?: never;
364
+ patch?: never;
365
+ trace?: never;
366
+ };
349
367
  "/v1/graph/embedding/promote": {
350
368
  parameters: {
351
369
  query?: never;
@@ -773,6 +791,25 @@ export interface paths {
773
791
  patch?: never;
774
792
  trace?: never;
775
793
  };
794
+ "/v1/index/gc-jobs": {
795
+ parameters: {
796
+ query?: never;
797
+ header?: never;
798
+ path?: never;
799
+ cookie?: never;
800
+ };
801
+ /** Poll a graph-scoped index garbage-collection job */
802
+ get: operations["get_v1_index_gc_jobs"];
803
+ put?: never;
804
+ /** Idempotently enqueue durable index garbage collection with byte/object progress */
805
+ post: operations["post_v1_index_gc_jobs"];
806
+ /** Cancel a graph-scoped index garbage-collection job */
807
+ delete: operations["delete_v1_index_gc_jobs"];
808
+ options?: never;
809
+ head?: never;
810
+ patch?: never;
811
+ trace?: never;
812
+ };
776
813
  "/v1/index/jobs": {
777
814
  parameters: {
778
815
  query?: never;
@@ -785,7 +822,8 @@ export interface paths {
785
822
  put?: never;
786
823
  /** Idempotently enqueue a durable full-index job with typed per-family terminal status */
787
824
  post: operations["post_v1_index_jobs"];
788
- delete?: never;
825
+ /** Cancel a graph-scoped durable full-index job */
826
+ delete: operations["delete_v1_index_jobs"];
789
827
  options?: never;
790
828
  head?: never;
791
829
  patch?: never;
@@ -2213,7 +2251,18 @@ export interface components {
2213
2251
  };
2214
2252
  /** @enum {string} */
2215
2253
  AskPlanExecutionModeV2: "entity_search" | "path_search" | "hybrid";
2254
+ AskPlanFailure: {
2255
+ code: components["schemas"]["AskPlanFailureCode"];
2256
+ /** @description True when retrying after the planner recovers can produce a plan. */
2257
+ retryable: boolean;
2258
+ stage: components["schemas"]["AskPlanFailureStage"];
2259
+ };
2260
+ /** @enum {string} */
2261
+ AskPlanFailureCode: "planner_disabled" | "planner_unavailable" | "no_class_candidates" | "generation_failed" | "validation_failed";
2262
+ /** @enum {string} */
2263
+ AskPlanFailureStage: "configuration" | "target_type" | "relation" | "anchor";
2216
2264
  AskQuery: {
2265
+ plan_failure?: null | components["schemas"]["AskPlanFailure"];
2217
2266
  /** @description The retrieval query text that was executed. */
2218
2267
  query: string;
2219
2268
  structured?: null | components["schemas"]["AskStructuredQuery"];
@@ -2494,6 +2543,13 @@ export interface components {
2494
2543
  CommitResponse: {
2495
2544
  commit_seq: components["schemas"]["CommitSeq"];
2496
2545
  conformance?: null | components["schemas"]["ConformanceReport"];
2546
+ /**
2547
+ * Format: float
2548
+ * @description R27d(1) advisory pacing telemetry: the WAL drain pressure at ack time as a
2549
+ * `0.0`–`1.0` tail-fill ratio. Present only once the tail is over half full.
2550
+ * Clients SHOULD reduce write concurrency as this rises; advisory only.
2551
+ */
2552
+ drain_pressure?: number | null;
2497
2553
  edge_event_ids: components["schemas"]["EdgeEventId"][];
2498
2554
  entity_ids: components["schemas"]["EntityId"][];
2499
2555
  idempotent_replay: boolean;
@@ -2502,6 +2558,15 @@ export interface components {
2502
2558
  observation_ids: components["schemas"]["ObservationId"][];
2503
2559
  schema_validation?: null | components["schemas"]["SchemaAuditReport"];
2504
2560
  skipped_edges?: components["schemas"]["SkippedEdge"][];
2561
+ /**
2562
+ * Format: int32
2563
+ * @description R27d(1) advisory pacing telemetry: the pacing latency this write ack
2564
+ * absorbed — head-lane serialization plus admission wait — in whole
2565
+ * milliseconds. Present only past a noise floor (a fast commit omits it) and
2566
+ * mirrored to the `X-LBB-Throttle-Ms` response header. Clients SHOULD reduce
2567
+ * write concurrency as this rises; it is never load-bearing for correctness.
2568
+ */
2569
+ throttle_ms?: number | null;
2505
2570
  visibility_token: string;
2506
2571
  /**
2507
2572
  * @description Property fields actually written by this commit, per entity (canonical
@@ -2828,9 +2893,24 @@ export interface components {
2828
2893
  reranked_candidates?: number;
2829
2894
  source: components["schemas"]["EmbeddingIndexSource"];
2830
2895
  spaces_searched: number;
2896
+ temporal_coverage?: null | components["schemas"]["SearchTemporalCoverage"];
2831
2897
  unindexed_tail_commits: number;
2832
2898
  };
2833
2899
  EmbeddingSearchRequest: {
2900
+ /**
2901
+ * Format: int64
2902
+ * @description Snapshot pin (transaction-time ceiling): results hide every event
2903
+ * committed after this sequence, reproducing that past snapshot. The ANN
2904
+ * run is selected as the newest run at or below the pin and the pin bounds
2905
+ * the forward overlay; candidate generation is never the correctness layer.
2906
+ * Omitted means the current head.
2907
+ */
2908
+ as_of_commit_seq?: number | null;
2909
+ /**
2910
+ * @description Valid-time cursor (RFC 3339): results reflect facts true at this
2911
+ * instant. Omitted means the latest valid time.
2912
+ */
2913
+ as_of_valid_time?: string | null;
2834
2914
  consistency?: null | components["schemas"]["SearchConsistency"];
2835
2915
  /** Format: int32 */
2836
2916
  dim?: number | null;
@@ -3297,10 +3377,25 @@ export interface components {
3297
3377
  overlay_candidates: number;
3298
3378
  ranged?: null | components["schemas"]["RangedReadStats"];
3299
3379
  source: components["schemas"]["FullTextIndexSource"];
3380
+ temporal_coverage?: null | components["schemas"]["SearchTemporalCoverage"];
3300
3381
  term_count: number;
3301
3382
  unindexed_tail_commits: number;
3302
3383
  };
3303
3384
  FullTextSearchRequest: {
3385
+ /**
3386
+ * Format: int64
3387
+ * @description Snapshot pin (transaction-time ceiling): results hide every event
3388
+ * committed after this sequence, reproducing that past snapshot. The BM25
3389
+ * run is selected as the newest run at or below the pin and the pin bounds
3390
+ * the forward overlay; candidate generation is never the correctness layer.
3391
+ * Omitted means the current head.
3392
+ */
3393
+ as_of_commit_seq?: number | null;
3394
+ /**
3395
+ * @description Valid-time cursor (RFC 3339): results reflect facts true at this
3396
+ * instant. Omitted means the latest valid time.
3397
+ */
3398
+ as_of_valid_time?: string | null;
3304
3399
  consistency?: null | components["schemas"]["SearchConsistency"];
3305
3400
  explain: boolean;
3306
3401
  facets?: components["schemas"]["FacetRequest"][] | null;
@@ -3444,6 +3539,14 @@ export interface components {
3444
3539
  parent: components["schemas"]["BranchParentView"];
3445
3540
  snapshot: components["schemas"]["SnapshotView"];
3446
3541
  };
3542
+ GraphBranchDeleteResponse: {
3543
+ branch_id: string;
3544
+ /** Format: int64 */
3545
+ deleted_bytes: number;
3546
+ deleted_objects: number;
3547
+ graph_id: string;
3548
+ ok: boolean;
3549
+ };
3447
3550
  /**
3448
3551
  * @description `POST /v1/graph/branch/merge` — replay a child branch's commits onto its
3449
3552
  * fork parent (the branch named by the request URL) as one new commit batch.
@@ -3590,6 +3693,12 @@ export interface components {
3590
3693
  GraphCommitResponse: {
3591
3694
  commit: components["schemas"]["CommitResponse"];
3592
3695
  commit_seq: components["schemas"]["CommitSeq"];
3696
+ /**
3697
+ * Format: float
3698
+ * @description R27d(1) advisory WAL drain pressure (0.0–1.0), mirrored from
3699
+ * `commit.drain_pressure`. Present only once the tail is over half full.
3700
+ */
3701
+ drain_pressure?: number | null;
3593
3702
  edges_written: number;
3594
3703
  entities_written: number;
3595
3704
  graph_created: boolean;
@@ -3601,6 +3710,14 @@ export interface components {
3601
3710
  * envelope before deciding whether anything new was written.
3602
3711
  */
3603
3712
  replayed: boolean;
3713
+ /**
3714
+ * Format: int32
3715
+ * @description R27d(1) advisory pacing telemetry, mirrored from `commit.throttle_ms` to
3716
+ * the envelope top level (like `replayed`) and to the `X-LBB-Throttle-Ms`
3717
+ * response header. Present only past a noise floor; clients SHOULD reduce
3718
+ * write concurrency as it rises.
3719
+ */
3720
+ throttle_ms?: number | null;
3604
3721
  visibility_token: string;
3605
3722
  /**
3606
3723
  * @description Top-level echo of property fields actually written by this request.
@@ -3608,6 +3725,15 @@ export interface components {
3608
3725
  */
3609
3726
  written_properties?: components["schemas"]["EntityFieldsWritten"][];
3610
3727
  };
3728
+ GraphDeleteResponse: {
3729
+ deleted_branches: number;
3730
+ /** Format: int64 */
3731
+ deleted_bytes: number;
3732
+ deleted_feedback_objects: number;
3733
+ deleted_objects: number;
3734
+ graph_id: string;
3735
+ ok: boolean;
3736
+ };
3611
3737
  GraphEdgeRow: {
3612
3738
  /** Format: float */
3613
3739
  confidence: number;
@@ -3721,10 +3847,7 @@ export interface components {
3721
3847
  graph_id: components["schemas"]["GraphId"];
3722
3848
  tenant_id: components["schemas"]["TenantId"];
3723
3849
  };
3724
- /**
3725
- * @description The graphs that exist under a tenant (one stack's tenant in SaaS mode),
3726
- * enumerated by a bounded child-prefix listing of the object store.
3727
- */
3850
+ /** @description The live, head-backed graphs under a tenant (one stack in SaaS mode). */
3728
3851
  GraphListResponse: {
3729
3852
  data: components["schemas"]["GraphSummary"][];
3730
3853
  has_more: boolean;
@@ -4061,6 +4184,38 @@ export interface components {
4061
4184
  snapshot: components["schemas"]["SnapshotView"];
4062
4185
  to_commit_seq: components["schemas"]["CommitSeq"];
4063
4186
  };
4187
+ IndexGcJobProgress: {
4188
+ /** Format: int64 */
4189
+ deleted_bytes: number;
4190
+ deleted_objects: number;
4191
+ /** Format: int64 */
4192
+ heartbeat_micros?: number;
4193
+ /** Format: int64 */
4194
+ reclaimable_bytes: number;
4195
+ reclaimable_objects: number;
4196
+ reclaimable_runs: number;
4197
+ /** Format: int64 */
4198
+ scanned_bytes: number;
4199
+ scanned_objects: number;
4200
+ scanned_runs: number;
4201
+ stage: string;
4202
+ worker?: string | null;
4203
+ };
4204
+ IndexGcJobStatusResponse: {
4205
+ /** Format: int32 */
4206
+ attempts: number;
4207
+ /** Format: int64 */
4208
+ enqueued_at_micros: number;
4209
+ graph: components["schemas"]["GraphKey"];
4210
+ job_id: string;
4211
+ progress?: null | components["schemas"]["IndexGcJobProgress"];
4212
+ request: components["schemas"]["IndexGcRequest"];
4213
+ result?: null | components["schemas"]["IndexGcResponse"];
4214
+ status: string;
4215
+ terminal_error?: string | null;
4216
+ /** Format: int64 */
4217
+ updated_at_micros: number;
4218
+ };
4064
4219
  IndexGcRequest: {
4065
4220
  /** @description Report what would be deleted without deleting anything. */
4066
4221
  dry_run?: boolean;
@@ -4096,6 +4251,9 @@ export interface components {
4096
4251
  dry_run: boolean;
4097
4252
  kept_runs: number;
4098
4253
  runs: components["schemas"]["IndexRunView"][];
4254
+ /** Format: int64 */
4255
+ scanned_bytes: number;
4256
+ scanned_objects: number;
4099
4257
  /**
4100
4258
  * @description Set when deletion was skipped because other branches may share this
4101
4259
  * branch's index runs and `include_branch_shared` was false.
@@ -4282,6 +4440,7 @@ export interface components {
4282
4440
  metric: components["schemas"]["VectorMetric"];
4283
4441
  model_id: string;
4284
4442
  run_id?: string | null;
4443
+ service: components["schemas"]["ManagedEmbeddingService"];
4285
4444
  source: components["schemas"]["ManagedEmbeddingSource"];
4286
4445
  /** Format: int64 */
4287
4446
  version: number;
@@ -4290,17 +4449,39 @@ export interface components {
4290
4449
  ManagedEmbeddingConfigRequest: {
4291
4450
  auto_embed_query?: boolean | null;
4292
4451
  base_model?: string | null;
4293
- /** Format: int32 */
4294
- dim: number;
4452
+ /**
4453
+ * Format: int32
4454
+ * @description Vector width. Required for `modal`; optional for `open_router`, where a
4455
+ * one-text validation call discovers the model's native width.
4456
+ */
4457
+ dim?: number | null;
4295
4458
  metric?: null | components["schemas"]["VectorMetric"];
4296
4459
  model_id: string;
4297
4460
  run_id?: string | null;
4461
+ service?: null | components["schemas"]["ManagedEmbeddingService"];
4298
4462
  source?: null | components["schemas"]["ManagedEmbeddingSource"];
4299
4463
  };
4300
4464
  /** @description Read/set response. Legacy hash-derived graphs return `configured=false` and no config. */
4301
4465
  ManagedEmbeddingConfigResponse: {
4302
4466
  config?: null | components["schemas"]["ManagedEmbeddingConfig"];
4303
4467
  configured: boolean;
4468
+ reconciliation?: null | components["schemas"]["ManagedEmbeddingBackfillJobStatusResponse"];
4469
+ };
4470
+ /** @description One model returned by the live managed-embedding service catalog. */
4471
+ ManagedEmbeddingModel: {
4472
+ /** Format: int64 */
4473
+ context_length?: number | null;
4474
+ id: string;
4475
+ input_modalities?: string[];
4476
+ name: string;
4477
+ /** @description Provider prompt price as a decimal USD/token string when advertised. */
4478
+ prompt_price?: string | null;
4479
+ };
4480
+ /** @description Live embedding models available on this deployment. */
4481
+ ManagedEmbeddingModelsResponse: {
4482
+ configured: boolean;
4483
+ models?: components["schemas"]["ManagedEmbeddingModel"][];
4484
+ service: components["schemas"]["ManagedEmbeddingService"];
4304
4485
  };
4305
4486
  /** @description Response after promoting a finished training run to the graph default. */
4306
4487
  ManagedEmbeddingPromoteResponse: {
@@ -4319,6 +4500,11 @@ export interface components {
4319
4500
  /** Format: double */
4320
4501
  trained_ndcg: number;
4321
4502
  };
4503
+ /**
4504
+ * @description Service used to generate managed corpus and query embeddings.
4505
+ * @enum {string}
4506
+ */
4507
+ ManagedEmbeddingService: "modal" | "open_router";
4322
4508
  /**
4323
4509
  * @description Where a managed embedding model came from.
4324
4510
  * @enum {string}
@@ -5620,6 +5806,12 @@ export interface components {
5620
5806
  terms: components["schemas"]["ResolutionResult"][];
5621
5807
  };
5622
5808
  ResolvedTerm: {
5809
+ /**
5810
+ * @description Ontology description/definition when the resolved schema term carries
5811
+ * one. Candidate-free class resolution preserves tenant-authored class
5812
+ * documentation instead of returning only a bare label.
5813
+ */
5814
+ description?: string | null;
5623
5815
  kind: components["schemas"]["SuggestKind"];
5624
5816
  provenance?: null | components["schemas"]["VocabularyProvenance"];
5625
5817
  /**
@@ -5628,6 +5820,7 @@ export interface components {
5628
5820
  */
5629
5821
  score: number;
5630
5822
  text: string;
5823
+ type_signature?: null | components["schemas"]["VocabularyTypeSignature"];
5631
5824
  };
5632
5825
  /** @description One edge to retract, identified the same way it was asserted. */
5633
5826
  RetractEdgeInput: {
@@ -6323,7 +6516,7 @@ export interface components {
6323
6516
  job_id: string;
6324
6517
  result?: null | components["schemas"]["SearchIndexRunResponse"];
6325
6518
  stage?: string | null;
6326
- /** @description `pending` | `running` | `succeeded` | `failed`. */
6519
+ /** @description `pending` | `running` | `succeeded` | `failed` | `cancelled`. */
6327
6520
  status: string;
6328
6521
  terminal_error?: string | null;
6329
6522
  /** Format: int64 */
@@ -6554,6 +6747,25 @@ export interface components {
6554
6747
  signature_forced?: boolean;
6555
6748
  text: string;
6556
6749
  };
6750
+ /**
6751
+ * @description How a temporally-pinned (or head) search resolved run selection: the
6752
+ * effective `as_of` ceiling, the base snapshot of the selected persisted
6753
+ * run(s), and the highest commit each leg's run+segments actually covered
6754
+ * (the forward WAL overlay covers `(covered_through, ceiling]`). Distinct from
6755
+ * the ontology-inspect `TemporalCoverage` type. Per-leg fields are `None` when
6756
+ * that leg served from an ephemeral rebuild (no persisted run at the ceiling).
6757
+ */
6758
+ SearchTemporalCoverage: {
6759
+ bm25_covered_through?: null | components["schemas"]["CommitSeq"];
6760
+ bm25_run_snapshot_commit_seq?: null | components["schemas"]["CommitSeq"];
6761
+ /**
6762
+ * @description Resolved transaction-time ceiling: the `as_of_commit_seq` pin, or the
6763
+ * head commit_seq when the query was unpinned.
6764
+ */
6765
+ ceiling_commit_seq: components["schemas"]["CommitSeq"];
6766
+ vector_covered_through?: null | components["schemas"]["CommitSeq"];
6767
+ vector_run_snapshot_commit_seq?: null | components["schemas"]["CommitSeq"];
6768
+ };
6557
6769
  SemanticGraphSearchRequest: {
6558
6770
  /**
6559
6771
  * Format: int64
@@ -6673,6 +6885,7 @@ export interface components {
6673
6885
  * candidate generation.
6674
6886
  */
6675
6887
  target_prep_ms?: number;
6888
+ temporal_coverage?: null | components["schemas"]["SearchTemporalCoverage"];
6676
6889
  /** Format: int64 */
6677
6890
  total_ms?: number;
6678
6891
  /**
@@ -6728,6 +6941,13 @@ export interface components {
6728
6941
  as_of_valid_time?: string | null;
6729
6942
  direction: components["schemas"]["ExpansionDirection"];
6730
6943
  explain: boolean;
6944
+ /**
6945
+ * @description Entity properties to project for every returned seed and path node.
6946
+ * Projections are reduced from the same snapshot used for authorization
6947
+ * and traversal. Requesting fields routes the operation through the exact
6948
+ * snapshot path rather than ranged adjacency.
6949
+ */
6950
+ fields?: string[];
6731
6951
  /**
6732
6952
  * Format: int64
6733
6953
  * @description Decoded adjacency-block working-set byte budget for persisted-vector
@@ -6753,6 +6973,15 @@ export interface components {
6753
6973
  SemanticTraverseResponse: {
6754
6974
  explain?: null | components["schemas"]["SemanticTraverseExplain"];
6755
6975
  paths: components["schemas"]["PathResult"][];
6976
+ /**
6977
+ * @description Requested properties keyed by entity id for every returned seed and
6978
+ * path node. Empty when `fields` was omitted.
6979
+ */
6980
+ projected_nodes?: {
6981
+ [key: string]: {
6982
+ [key: string]: unknown;
6983
+ };
6984
+ };
6756
6985
  ranged?: null | components["schemas"]["RangedTraverseStats"];
6757
6986
  seeds: components["schemas"]["ScoredEntityView"][];
6758
6987
  snapshot: components["schemas"]["SnapshotView"];
@@ -7098,6 +7327,13 @@ export interface components {
7098
7327
  ShadowEvalResponse: {
7099
7328
  challenger: components["schemas"]["ShadowArmResult"];
7100
7329
  champion: components["schemas"]["ShadowArmResult"];
7330
+ /**
7331
+ * @description Fail-closed promotion verdict over the same labeled queries and pinned
7332
+ * snapshot. Requires quality non-regression plus p50/p95/p99 latency
7333
+ * ratios within the configured ceiling; this endpoint still never
7334
+ * performs the promotion itself.
7335
+ */
7336
+ gate: components["schemas"]["TrainGateReport"];
7101
7337
  /** @description Labeled queries (those with `expected`) the hit rates are over. */
7102
7338
  labeled: number;
7103
7339
  /** Format: float */
@@ -7814,7 +8050,8 @@ export interface components {
7814
8050
  TrainGateReport: {
7815
8051
  /**
7816
8052
  * Format: float
7817
- * @description Challenger − champion hit-rate on the held-out eval slice.
8053
+ * @description Challenger − champion primary quality metric on the held-out eval
8054
+ * slice (nDCG for fusion and retrieval-profile comparisons).
7818
8055
  */
7819
8056
  effect: number;
7820
8057
  /** Format: float */
@@ -7823,7 +8060,18 @@ export interface components {
7823
8060
  labeled: number;
7824
8061
  /**
7825
8062
  * Format: double
7826
- * @description Challenger / champion mean-latency ratio on the eval slice.
8063
+ * @description Challenger / champion latency ratios at each reported percentile.
8064
+ */
8065
+ latency_p50_ratio?: number | null;
8066
+ /** Format: double */
8067
+ latency_p95_ratio?: number | null;
8068
+ /** Format: double */
8069
+ latency_p99_ratio?: number | null;
8070
+ /**
8071
+ * Format: double
8072
+ * @description Legacy decision latency ratio. For configuration shadow evaluation this
8073
+ * is the worst of p50/p95/p99; older trainer kinds may use their primary
8074
+ * latency statistic.
7827
8075
  */
7828
8076
  latency_ratio: number;
7829
8077
  /**
@@ -7856,7 +8104,8 @@ export interface components {
7856
8104
  reason: string;
7857
8105
  /**
7858
8106
  * Format: float
7859
- * @description Fusion-only paired held-out deltas. All must be non-negative.
8107
+ * @description Paired held-out retrieval deltas. When present, all must be
8108
+ * non-negative.
7860
8109
  */
7861
8110
  recall_delta?: number | null;
7862
8111
  };
@@ -8161,6 +8410,11 @@ export interface components {
8161
8410
  };
8162
8411
  /** @enum {string} */
8163
8412
  VocabularyOrigin: "builtin" | "tenant" | "imported";
8413
+ VocabularyPropertySignature: {
8414
+ name: string;
8415
+ required: boolean;
8416
+ value_type: string;
8417
+ };
8164
8418
  VocabularyProvenance: {
8165
8419
  candidate_id: string;
8166
8420
  namespace: string;
@@ -8169,6 +8423,15 @@ export interface components {
8169
8423
  origin: components["schemas"]["VocabularyOrigin"];
8170
8424
  source_reference: string;
8171
8425
  };
8426
+ VocabularyTypeSignature: {
8427
+ properties?: components["schemas"]["VocabularyPropertySignature"][];
8428
+ source_types?: string[];
8429
+ /** @description Frozen normalized schema identity. */
8430
+ stable_id: string;
8431
+ super_types?: string[];
8432
+ target_types?: string[];
8433
+ value_type?: string | null;
8434
+ };
8172
8435
  WalCompactRequest: {
8173
8436
  /**
8174
8437
  * @description When appending the new segment would leave the manifest with more
@@ -9533,13 +9796,15 @@ export interface operations {
9533
9796
  };
9534
9797
  };
9535
9798
  };
9536
- post_v1_graph_branch_merge: {
9799
+ delete_v1_graph_branch: {
9537
9800
  parameters: {
9538
9801
  query?: {
9539
9802
  /** @description Graph name (default `main`) */
9540
9803
  graph?: string;
9541
9804
  /** @description Branch name (default `main`) */
9542
9805
  branch?: string;
9806
+ /** @description Must equal the target branch id */
9807
+ confirm?: string;
9543
9808
  };
9544
9809
  header?: {
9545
9810
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -9550,11 +9815,7 @@ export interface operations {
9550
9815
  path?: never;
9551
9816
  cookie?: never;
9552
9817
  };
9553
- requestBody: {
9554
- content: {
9555
- "application/json": components["schemas"]["GraphBranchMergeRequest"];
9556
- };
9557
- };
9818
+ requestBody?: never;
9558
9819
  responses: {
9559
9820
  /** @description OK */
9560
9821
  200: {
@@ -9566,7 +9827,7 @@ export interface operations {
9566
9827
  [name: string]: unknown;
9567
9828
  };
9568
9829
  content: {
9569
- "application/json": components["schemas"]["GraphBranchMergeResponse"];
9830
+ "application/json": components["schemas"]["GraphBranchDeleteResponse"];
9570
9831
  };
9571
9832
  };
9572
9833
  /** @description Bad request */
@@ -9675,7 +9936,7 @@ export interface operations {
9675
9936
  };
9676
9937
  };
9677
9938
  };
9678
- get_v1_graph_card: {
9939
+ post_v1_graph_branch_merge: {
9679
9940
  parameters: {
9680
9941
  query?: {
9681
9942
  /** @description Graph name (default `main`) */
@@ -9686,11 +9947,17 @@ export interface operations {
9686
9947
  header?: {
9687
9948
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
9688
9949
  "Lbb-Version"?: string;
9950
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
9951
+ "Idempotency-Key"?: string;
9689
9952
  };
9690
9953
  path?: never;
9691
9954
  cookie?: never;
9692
9955
  };
9693
- requestBody?: never;
9956
+ requestBody: {
9957
+ content: {
9958
+ "application/json": components["schemas"]["GraphBranchMergeRequest"];
9959
+ };
9960
+ };
9694
9961
  responses: {
9695
9962
  /** @description OK */
9696
9963
  200: {
@@ -9702,7 +9969,7 @@ export interface operations {
9702
9969
  [name: string]: unknown;
9703
9970
  };
9704
9971
  content: {
9705
- "application/json": components["schemas"]["GraphCard"];
9972
+ "application/json": components["schemas"]["GraphBranchMergeResponse"];
9706
9973
  };
9707
9974
  };
9708
9975
  /** @description Bad request */
@@ -9811,17 +10078,13 @@ export interface operations {
9811
10078
  };
9812
10079
  };
9813
10080
  };
9814
- get_v1_graph_changes: {
10081
+ get_v1_graph_card: {
9815
10082
  parameters: {
9816
10083
  query?: {
9817
10084
  /** @description Graph name (default `main`) */
9818
10085
  graph?: string;
9819
10086
  /** @description Branch name (default `main`) */
9820
10087
  branch?: string;
9821
- /** @description Exclusive lower bound commit_seq (default 0) */
9822
- since?: string;
9823
- /** @description Max records per page (default 500, max 5000) */
9824
- limit?: string;
9825
10088
  };
9826
10089
  header?: {
9827
10090
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -9842,7 +10105,7 @@ export interface operations {
9842
10105
  [name: string]: unknown;
9843
10106
  };
9844
10107
  content: {
9845
- "application/json": components["schemas"]["GraphChangesResponse"];
10108
+ "application/json": components["schemas"]["GraphCard"];
9846
10109
  };
9847
10110
  };
9848
10111
  /** @description Bad request */
@@ -9951,30 +10214,26 @@ export interface operations {
9951
10214
  };
9952
10215
  };
9953
10216
  };
9954
- post_v1_graph_commit: {
10217
+ get_v1_graph_changes: {
9955
10218
  parameters: {
9956
10219
  query?: {
9957
10220
  /** @description Graph name (default `main`) */
9958
10221
  graph?: string;
9959
10222
  /** @description Branch name (default `main`) */
9960
10223
  branch?: string;
9961
- /** @description Validate only and return a GraphCommitDryRunResponse without writing (no Idempotency-Key required) */
9962
- dry_run?: string;
10224
+ /** @description Exclusive lower bound commit_seq (default 0) */
10225
+ since?: string;
10226
+ /** @description Max records per page (default 500, max 5000) */
10227
+ limit?: string;
9963
10228
  };
9964
- header: {
10229
+ header?: {
9965
10230
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
9966
10231
  "Lbb-Version"?: string;
9967
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
9968
- "Idempotency-Key": string;
9969
10232
  };
9970
10233
  path?: never;
9971
10234
  cookie?: never;
9972
10235
  };
9973
- requestBody: {
9974
- content: {
9975
- "application/json": components["schemas"]["TripletCommitFile"];
9976
- };
9977
- };
10236
+ requestBody?: never;
9978
10237
  responses: {
9979
10238
  /** @description OK */
9980
10239
  200: {
@@ -9986,7 +10245,7 @@ export interface operations {
9986
10245
  [name: string]: unknown;
9987
10246
  };
9988
10247
  content: {
9989
- "application/json": components["schemas"]["GraphCommitResponse"];
10248
+ "application/json": components["schemas"]["GraphChangesResponse"];
9990
10249
  };
9991
10250
  };
9992
10251
  /** @description Bad request */
@@ -10095,28 +10354,30 @@ export interface operations {
10095
10354
  };
10096
10355
  };
10097
10356
  };
10098
- post_v1_graph_compact: {
10357
+ post_v1_graph_commit: {
10099
10358
  parameters: {
10100
10359
  query?: {
10101
10360
  /** @description Graph name (default `main`) */
10102
10361
  graph?: string;
10103
10362
  /** @description Branch name (default `main`) */
10104
10363
  branch?: string;
10105
- /** @description Minimum tail commits before compaction */
10106
- min_tail_commits?: string;
10107
- /** @description Merge into at most this many segments */
10108
- max_segments?: string;
10364
+ /** @description Validate only and return a GraphCommitDryRunResponse without writing (no Idempotency-Key required) */
10365
+ dry_run?: string;
10109
10366
  };
10110
- header?: {
10367
+ header: {
10111
10368
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
10112
10369
  "Lbb-Version"?: string;
10113
10370
  /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
10114
- "Idempotency-Key"?: string;
10371
+ "Idempotency-Key": string;
10115
10372
  };
10116
10373
  path?: never;
10117
10374
  cookie?: never;
10118
10375
  };
10119
- requestBody?: never;
10376
+ requestBody: {
10377
+ content: {
10378
+ "application/json": components["schemas"]["TripletCommitFile"];
10379
+ };
10380
+ };
10120
10381
  responses: {
10121
10382
  /** @description OK */
10122
10383
  200: {
@@ -10128,7 +10389,7 @@ export interface operations {
10128
10389
  [name: string]: unknown;
10129
10390
  };
10130
10391
  content: {
10131
- "application/json": components["schemas"]["WalCompactResponse"];
10392
+ "application/json": components["schemas"]["GraphCommitResponse"];
10132
10393
  };
10133
10394
  };
10134
10395
  /** @description Bad request */
@@ -10237,13 +10498,17 @@ export interface operations {
10237
10498
  };
10238
10499
  };
10239
10500
  };
10240
- post_v1_graph_create: {
10501
+ post_v1_graph_compact: {
10241
10502
  parameters: {
10242
10503
  query?: {
10243
10504
  /** @description Graph name (default `main`) */
10244
10505
  graph?: string;
10245
10506
  /** @description Branch name (default `main`) */
10246
10507
  branch?: string;
10508
+ /** @description Minimum tail commits before compaction */
10509
+ min_tail_commits?: string;
10510
+ /** @description Merge into at most this many segments */
10511
+ max_segments?: string;
10247
10512
  };
10248
10513
  header?: {
10249
10514
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -10266,7 +10531,7 @@ export interface operations {
10266
10531
  [name: string]: unknown;
10267
10532
  };
10268
10533
  content: {
10269
- "application/json": components["schemas"]["CreateGraphResponse"];
10534
+ "application/json": components["schemas"]["WalCompactResponse"];
10270
10535
  };
10271
10536
  };
10272
10537
  /** @description Bad request */
@@ -10375,15 +10640,13 @@ export interface operations {
10375
10640
  };
10376
10641
  };
10377
10642
  };
10378
- post_v1_graph_delete: {
10643
+ post_v1_graph_create: {
10379
10644
  parameters: {
10380
10645
  query?: {
10381
10646
  /** @description Graph name (default `main`) */
10382
10647
  graph?: string;
10383
10648
  /** @description Branch name (default `main`) */
10384
10649
  branch?: string;
10385
- /** @description Must equal the target graph id to authorize deletion */
10386
- confirm?: string;
10387
10650
  };
10388
10651
  header?: {
10389
10652
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -10406,7 +10669,7 @@ export interface operations {
10406
10669
  [name: string]: unknown;
10407
10670
  };
10408
10671
  content: {
10409
- "application/json": Record<string, never>;
10672
+ "application/json": components["schemas"]["CreateGraphResponse"];
10410
10673
  };
10411
10674
  };
10412
10675
  /** @description Bad request */
@@ -10515,25 +10778,21 @@ export interface operations {
10515
10778
  };
10516
10779
  };
10517
10780
  };
10518
- get_v1_graph_edges: {
10781
+ post_v1_graph_delete: {
10519
10782
  parameters: {
10520
10783
  query?: {
10521
10784
  /** @description Graph name (default `main`) */
10522
10785
  graph?: string;
10523
10786
  /** @description Branch name (default `main`) */
10524
10787
  branch?: string;
10525
- /** @description Search text */
10526
- q?: string;
10527
- /** @description Relation filter */
10528
- relation?: string;
10529
- /** @description Max rows */
10530
- limit?: string;
10531
- /** @description Opaque cursor from the previous page (legacy `offset` also accepted) */
10532
- cursor?: string;
10788
+ /** @description Must equal the target graph id to authorize deletion */
10789
+ confirm?: string;
10533
10790
  };
10534
10791
  header?: {
10535
10792
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
10536
10793
  "Lbb-Version"?: string;
10794
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
10795
+ "Idempotency-Key"?: string;
10537
10796
  };
10538
10797
  path?: never;
10539
10798
  cookie?: never;
@@ -10550,7 +10809,7 @@ export interface operations {
10550
10809
  [name: string]: unknown;
10551
10810
  };
10552
10811
  content: {
10553
- "application/json": Record<string, never>;
10812
+ "application/json": components["schemas"]["GraphDeleteResponse"];
10554
10813
  };
10555
10814
  };
10556
10815
  /** @description Bad request */
@@ -10659,13 +10918,21 @@ export interface operations {
10659
10918
  };
10660
10919
  };
10661
10920
  };
10662
- get_v1_graph_embedding: {
10921
+ get_v1_graph_edges: {
10663
10922
  parameters: {
10664
10923
  query?: {
10665
10924
  /** @description Graph name (default `main`) */
10666
10925
  graph?: string;
10667
10926
  /** @description Branch name (default `main`) */
10668
10927
  branch?: string;
10928
+ /** @description Search text */
10929
+ q?: string;
10930
+ /** @description Relation filter */
10931
+ relation?: string;
10932
+ /** @description Max rows */
10933
+ limit?: string;
10934
+ /** @description Opaque cursor from the previous page (legacy `offset` also accepted) */
10935
+ cursor?: string;
10669
10936
  };
10670
10937
  header?: {
10671
10938
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -10686,7 +10953,7 @@ export interface operations {
10686
10953
  [name: string]: unknown;
10687
10954
  };
10688
10955
  content: {
10689
- "application/json": components["schemas"]["ManagedEmbeddingConfigResponse"];
10956
+ "application/json": Record<string, never>;
10690
10957
  };
10691
10958
  };
10692
10959
  /** @description Bad request */
@@ -10795,7 +11062,7 @@ export interface operations {
10795
11062
  };
10796
11063
  };
10797
11064
  };
10798
- post_v1_graph_embedding: {
11065
+ get_v1_graph_embedding: {
10799
11066
  parameters: {
10800
11067
  query?: {
10801
11068
  /** @description Graph name (default `main`) */
@@ -10806,17 +11073,11 @@ export interface operations {
10806
11073
  header?: {
10807
11074
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
10808
11075
  "Lbb-Version"?: string;
10809
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
10810
- "Idempotency-Key"?: string;
10811
11076
  };
10812
11077
  path?: never;
10813
11078
  cookie?: never;
10814
11079
  };
10815
- requestBody: {
10816
- content: {
10817
- "application/json": components["schemas"]["ManagedEmbeddingConfigRequest"];
10818
- };
10819
- };
11080
+ requestBody?: never;
10820
11081
  responses: {
10821
11082
  /** @description OK */
10822
11083
  200: {
@@ -10937,19 +11198,13 @@ export interface operations {
10937
11198
  };
10938
11199
  };
10939
11200
  };
10940
- post_v1_graph_embedding_backfill: {
11201
+ post_v1_graph_embedding: {
10941
11202
  parameters: {
10942
11203
  query?: {
10943
11204
  /** @description Graph name (default `main`) */
10944
11205
  graph?: string;
10945
11206
  /** @description Branch name (default `main`) */
10946
11207
  branch?: string;
10947
- /** @description Embedding batch size (default 128, max 512) */
10948
- batch_size?: string;
10949
- /** @description Maximum entities to consider (default 100000) */
10950
- limit?: string;
10951
- /** @description Re-embed all entities instead of only new entities */
10952
- full?: string;
10953
11208
  };
10954
11209
  header?: {
10955
11210
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -10962,7 +11217,7 @@ export interface operations {
10962
11217
  };
10963
11218
  requestBody: {
10964
11219
  content: {
10965
- "application/json": components["schemas"]["ManagedEmbeddingBackfillJobRequest"];
11220
+ "application/json": components["schemas"]["ManagedEmbeddingConfigRequest"];
10966
11221
  };
10967
11222
  };
10968
11223
  responses: {
@@ -10976,7 +11231,7 @@ export interface operations {
10976
11231
  [name: string]: unknown;
10977
11232
  };
10978
11233
  content: {
10979
- "application/json": components["schemas"]["ManagedEmbeddingBackfillJobStatusResponse"];
11234
+ "application/json": components["schemas"]["ManagedEmbeddingConfigResponse"];
10980
11235
  };
10981
11236
  };
10982
11237
  /** @description Bad request */
@@ -11085,24 +11340,34 @@ export interface operations {
11085
11340
  };
11086
11341
  };
11087
11342
  };
11088
- get_v1_graph_embedding_backfill_jobs: {
11343
+ post_v1_graph_embedding_backfill: {
11089
11344
  parameters: {
11090
11345
  query?: {
11091
11346
  /** @description Graph name (default `main`) */
11092
11347
  graph?: string;
11093
11348
  /** @description Branch name (default `main`) */
11094
11349
  branch?: string;
11095
- /** @description Stable backfill job id */
11096
- job_id?: string;
11350
+ /** @description Embedding batch size (default 128, max 512) */
11351
+ batch_size?: string;
11352
+ /** @description Maximum entities to consider (default 100000) */
11353
+ limit?: string;
11354
+ /** @description Re-embed all entities instead of only new entities */
11355
+ full?: string;
11097
11356
  };
11098
11357
  header?: {
11099
11358
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
11100
11359
  "Lbb-Version"?: string;
11360
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
11361
+ "Idempotency-Key"?: string;
11101
11362
  };
11102
11363
  path?: never;
11103
11364
  cookie?: never;
11104
11365
  };
11105
- requestBody?: never;
11366
+ requestBody: {
11367
+ content: {
11368
+ "application/json": components["schemas"]["ManagedEmbeddingBackfillJobRequest"];
11369
+ };
11370
+ };
11106
11371
  responses: {
11107
11372
  /** @description OK */
11108
11373
  200: {
@@ -11223,28 +11488,24 @@ export interface operations {
11223
11488
  };
11224
11489
  };
11225
11490
  };
11226
- post_v1_graph_embedding_backfill_jobs: {
11491
+ get_v1_graph_embedding_backfill_jobs: {
11227
11492
  parameters: {
11228
11493
  query?: {
11229
11494
  /** @description Graph name (default `main`) */
11230
11495
  graph?: string;
11231
11496
  /** @description Branch name (default `main`) */
11232
11497
  branch?: string;
11498
+ /** @description Stable backfill job id */
11499
+ job_id?: string;
11233
11500
  };
11234
11501
  header?: {
11235
11502
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
11236
11503
  "Lbb-Version"?: string;
11237
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
11238
- "Idempotency-Key"?: string;
11239
11504
  };
11240
11505
  path?: never;
11241
11506
  cookie?: never;
11242
11507
  };
11243
- requestBody: {
11244
- content: {
11245
- "application/json": components["schemas"]["ManagedEmbeddingBackfillJobRequest"];
11246
- };
11247
- };
11508
+ requestBody?: never;
11248
11509
  responses: {
11249
11510
  /** @description OK */
11250
11511
  200: {
@@ -11365,15 +11626,13 @@ export interface operations {
11365
11626
  };
11366
11627
  };
11367
11628
  };
11368
- delete_v1_graph_embedding_backfill_jobs: {
11629
+ post_v1_graph_embedding_backfill_jobs: {
11369
11630
  parameters: {
11370
11631
  query?: {
11371
11632
  /** @description Graph name (default `main`) */
11372
11633
  graph?: string;
11373
11634
  /** @description Branch name (default `main`) */
11374
11635
  branch?: string;
11375
- /** @description Stable backfill job id */
11376
- job_id?: string;
11377
11636
  };
11378
11637
  header?: {
11379
11638
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -11384,7 +11643,11 @@ export interface operations {
11384
11643
  path?: never;
11385
11644
  cookie?: never;
11386
11645
  };
11387
- requestBody?: never;
11646
+ requestBody: {
11647
+ content: {
11648
+ "application/json": components["schemas"]["ManagedEmbeddingBackfillJobRequest"];
11649
+ };
11650
+ };
11388
11651
  responses: {
11389
11652
  /** @description OK */
11390
11653
  200: {
@@ -11505,17 +11768,15 @@ export interface operations {
11505
11768
  };
11506
11769
  };
11507
11770
  };
11508
- post_v1_graph_embedding_promote: {
11771
+ delete_v1_graph_embedding_backfill_jobs: {
11509
11772
  parameters: {
11510
11773
  query?: {
11511
11774
  /** @description Graph name (default `main`) */
11512
11775
  graph?: string;
11513
11776
  /** @description Branch name (default `main`) */
11514
11777
  branch?: string;
11515
- /** @description Finished training run identifier */
11516
- run_id?: string;
11517
- /** @description Allow promotion when evaluation quality regressed */
11518
- allow_regression?: string;
11778
+ /** @description Stable backfill job id */
11779
+ job_id?: string;
11519
11780
  };
11520
11781
  header?: {
11521
11782
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -11538,7 +11799,7 @@ export interface operations {
11538
11799
  [name: string]: unknown;
11539
11800
  };
11540
11801
  content: {
11541
- "application/json": components["schemas"]["ManagedEmbeddingPromoteResponse"];
11802
+ "application/json": components["schemas"]["ManagedEmbeddingBackfillJobStatusResponse"];
11542
11803
  };
11543
11804
  };
11544
11805
  /** @description Bad request */
@@ -11647,25 +11908,13 @@ export interface operations {
11647
11908
  };
11648
11909
  };
11649
11910
  };
11650
- get_v1_graph_entities: {
11911
+ get_v1_graph_embedding_models: {
11651
11912
  parameters: {
11652
11913
  query?: {
11653
11914
  /** @description Graph name (default `main`) */
11654
11915
  graph?: string;
11655
11916
  /** @description Branch name (default `main`) */
11656
11917
  branch?: string;
11657
- /** @description Search text */
11658
- q?: string;
11659
- /** @description Entity type filter */
11660
- type?: string;
11661
- /** @description Max rows */
11662
- limit?: string;
11663
- /** @description Opaque cursor from the previous page */
11664
- cursor?: string;
11665
- /** @description Comma-separated property names to inline on each row (typed, native JSON); `*` for all. Omit for the lean default row. */
11666
- fields?: string;
11667
- /** @description Comma-separated entity ids to fetch in one call (bulk lookup); bypasses the q/type browse filters. */
11668
- ids?: string;
11669
11918
  };
11670
11919
  header?: {
11671
11920
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -11686,7 +11935,7 @@ export interface operations {
11686
11935
  [name: string]: unknown;
11687
11936
  };
11688
11937
  content: {
11689
- "application/json": Record<string, never>;
11938
+ "application/json": components["schemas"]["ManagedEmbeddingModelsResponse"];
11690
11939
  };
11691
11940
  };
11692
11941
  /** @description Bad request */
@@ -11795,13 +12044,17 @@ export interface operations {
11795
12044
  };
11796
12045
  };
11797
12046
  };
11798
- post_v1_graph_entities_filter: {
12047
+ post_v1_graph_embedding_promote: {
11799
12048
  parameters: {
11800
12049
  query?: {
11801
12050
  /** @description Graph name (default `main`) */
11802
12051
  graph?: string;
11803
12052
  /** @description Branch name (default `main`) */
11804
12053
  branch?: string;
12054
+ /** @description Finished training run identifier */
12055
+ run_id?: string;
12056
+ /** @description Allow promotion when evaluation quality regressed */
12057
+ allow_regression?: string;
11805
12058
  };
11806
12059
  header?: {
11807
12060
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -11812,11 +12065,7 @@ export interface operations {
11812
12065
  path?: never;
11813
12066
  cookie?: never;
11814
12067
  };
11815
- requestBody: {
11816
- content: {
11817
- "application/json": components["schemas"]["EntityFilterRequest"];
11818
- };
11819
- };
12068
+ requestBody?: never;
11820
12069
  responses: {
11821
12070
  /** @description OK */
11822
12071
  200: {
@@ -11828,7 +12077,7 @@ export interface operations {
11828
12077
  [name: string]: unknown;
11829
12078
  };
11830
12079
  content: {
11831
- "application/json": components["schemas"]["EntityFilterResponse"];
12080
+ "application/json": components["schemas"]["ManagedEmbeddingPromoteResponse"];
11832
12081
  };
11833
12082
  };
11834
12083
  /** @description Bad request */
@@ -11937,19 +12186,25 @@ export interface operations {
11937
12186
  };
11938
12187
  };
11939
12188
  };
11940
- get_v1_graph_entity: {
12189
+ get_v1_graph_entities: {
11941
12190
  parameters: {
11942
12191
  query?: {
11943
12192
  /** @description Graph name (default `main`) */
11944
12193
  graph?: string;
11945
12194
  /** @description Branch name (default `main`) */
11946
12195
  branch?: string;
11947
- /** @description Entity id */
11948
- id?: string;
11949
- /** @description Entity type for name-addressed lookup */
12196
+ /** @description Search text */
12197
+ q?: string;
12198
+ /** @description Entity type filter */
11950
12199
  type?: string;
11951
- /** @description Entity canonical name for name-addressed lookup */
11952
- name?: string;
12200
+ /** @description Max rows */
12201
+ limit?: string;
12202
+ /** @description Opaque cursor from the previous page */
12203
+ cursor?: string;
12204
+ /** @description Comma-separated property names to inline on each row (typed, native JSON); `*` for all. Omit for the lean default row. */
12205
+ fields?: string;
12206
+ /** @description Comma-separated entity ids to fetch in one call (bulk lookup); bypasses the q/type browse filters. */
12207
+ ids?: string;
11953
12208
  };
11954
12209
  header?: {
11955
12210
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -11970,7 +12225,7 @@ export interface operations {
11970
12225
  [name: string]: unknown;
11971
12226
  };
11972
12227
  content: {
11973
- "application/json": components["schemas"]["EntityDetailResponse"];
12228
+ "application/json": Record<string, never>;
11974
12229
  };
11975
12230
  };
11976
12231
  /** @description Bad request */
@@ -12079,30 +12334,28 @@ export interface operations {
12079
12334
  };
12080
12335
  };
12081
12336
  };
12082
- get_v1_graph_entity_metadata: {
12337
+ post_v1_graph_entities_filter: {
12083
12338
  parameters: {
12084
12339
  query?: {
12085
12340
  /** @description Graph name (default `main`) */
12086
12341
  graph?: string;
12087
12342
  /** @description Branch name (default `main`) */
12088
12343
  branch?: string;
12089
- /** @description Entity id */
12090
- id?: string;
12091
- /** @description Entity type for name-addressed lookup */
12092
- type?: string;
12093
- /** @description Entity canonical name for name-addressed lookup */
12094
- name?: string;
12095
- /** @description RFC3339 as-of timestamp */
12096
- as_of?: string;
12097
12344
  };
12098
12345
  header?: {
12099
12346
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
12100
12347
  "Lbb-Version"?: string;
12348
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
12349
+ "Idempotency-Key"?: string;
12101
12350
  };
12102
12351
  path?: never;
12103
12352
  cookie?: never;
12104
12353
  };
12105
- requestBody?: never;
12354
+ requestBody: {
12355
+ content: {
12356
+ "application/json": components["schemas"]["EntityFilterRequest"];
12357
+ };
12358
+ };
12106
12359
  responses: {
12107
12360
  /** @description OK */
12108
12361
  200: {
@@ -12114,7 +12367,7 @@ export interface operations {
12114
12367
  [name: string]: unknown;
12115
12368
  };
12116
12369
  content: {
12117
- "application/json": components["schemas"]["EntityMetadataResponse"];
12370
+ "application/json": components["schemas"]["EntityFilterResponse"];
12118
12371
  };
12119
12372
  };
12120
12373
  /** @description Bad request */
@@ -12223,7 +12476,7 @@ export interface operations {
12223
12476
  };
12224
12477
  };
12225
12478
  };
12226
- get_v1_graph_entity_neighborhood: {
12479
+ get_v1_graph_entity: {
12227
12480
  parameters: {
12228
12481
  query?: {
12229
12482
  /** @description Graph name (default `main`) */
@@ -12236,10 +12489,6 @@ export interface operations {
12236
12489
  type?: string;
12237
12490
  /** @description Entity canonical name for name-addressed lookup */
12238
12491
  name?: string;
12239
- /** @description Comma-separated relation filter */
12240
- relations?: string;
12241
- /** @description RFC3339 as-of timestamp */
12242
- as_of?: string;
12243
12492
  };
12244
12493
  header?: {
12245
12494
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -12260,7 +12509,7 @@ export interface operations {
12260
12509
  [name: string]: unknown;
12261
12510
  };
12262
12511
  content: {
12263
- "application/json": components["schemas"]["EntityNeighborhoodResponse"];
12512
+ "application/json": components["schemas"]["EntityDetailResponse"];
12264
12513
  };
12265
12514
  };
12266
12515
  /** @description Bad request */
@@ -12369,19 +12618,21 @@ export interface operations {
12369
12618
  };
12370
12619
  };
12371
12620
  };
12372
- get_v1_graph_export: {
12621
+ get_v1_graph_entity_metadata: {
12373
12622
  parameters: {
12374
12623
  query?: {
12375
12624
  /** @description Graph name (default `main`) */
12376
12625
  graph?: string;
12377
12626
  /** @description Branch name (default `main`) */
12378
12627
  branch?: string;
12379
- /** @description Records (entity+edge lines) per page (default 1000, clamped 1-50000) */
12380
- limit?: string;
12381
- /** @description Opaque page cursor from a prior page's meta.next_cursor; pins the snapshot across pages */
12382
- cursor?: string;
12383
- /** @description Pin the export to a past snapshot commit_seq (first page only) */
12384
- as_of_commit_seq?: string;
12628
+ /** @description Entity id */
12629
+ id?: string;
12630
+ /** @description Entity type for name-addressed lookup */
12631
+ type?: string;
12632
+ /** @description Entity canonical name for name-addressed lookup */
12633
+ name?: string;
12634
+ /** @description RFC3339 as-of timestamp */
12635
+ as_of?: string;
12385
12636
  };
12386
12637
  header?: {
12387
12638
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -12402,7 +12653,7 @@ export interface operations {
12402
12653
  [name: string]: unknown;
12403
12654
  };
12404
12655
  content: {
12405
- "application/json": Record<string, never>;
12656
+ "application/json": components["schemas"]["EntityMetadataResponse"];
12406
12657
  };
12407
12658
  };
12408
12659
  /** @description Bad request */
@@ -12511,15 +12762,23 @@ export interface operations {
12511
12762
  };
12512
12763
  };
12513
12764
  };
12514
- get_v1_graph_export_job: {
12765
+ get_v1_graph_entity_neighborhood: {
12515
12766
  parameters: {
12516
12767
  query?: {
12517
12768
  /** @description Graph name (default `main`) */
12518
12769
  graph?: string;
12519
12770
  /** @description Branch name (default `main`) */
12520
12771
  branch?: string;
12521
- /** @description The export job id returned by the enqueue call */
12522
- job_id?: string;
12772
+ /** @description Entity id */
12773
+ id?: string;
12774
+ /** @description Entity type for name-addressed lookup */
12775
+ type?: string;
12776
+ /** @description Entity canonical name for name-addressed lookup */
12777
+ name?: string;
12778
+ /** @description Comma-separated relation filter */
12779
+ relations?: string;
12780
+ /** @description RFC3339 as-of timestamp */
12781
+ as_of?: string;
12523
12782
  };
12524
12783
  header?: {
12525
12784
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -12540,7 +12799,7 @@ export interface operations {
12540
12799
  [name: string]: unknown;
12541
12800
  };
12542
12801
  content: {
12543
- "application/json": Record<string, never>;
12802
+ "application/json": components["schemas"]["EntityNeighborhoodResponse"];
12544
12803
  };
12545
12804
  };
12546
12805
  /** @description Bad request */
@@ -12649,21 +12908,23 @@ export interface operations {
12649
12908
  };
12650
12909
  };
12651
12910
  };
12652
- post_v1_graph_export_job: {
12911
+ get_v1_graph_export: {
12653
12912
  parameters: {
12654
12913
  query?: {
12655
12914
  /** @description Graph name (default `main`) */
12656
12915
  graph?: string;
12657
12916
  /** @description Branch name (default `main`) */
12658
12917
  branch?: string;
12659
- /** @description Pin the export to a past snapshot commit_seq */
12918
+ /** @description Records (entity+edge lines) per page (default 1000, clamped 1-50000) */
12919
+ limit?: string;
12920
+ /** @description Opaque page cursor from a prior page's meta.next_cursor; pins the snapshot across pages */
12921
+ cursor?: string;
12922
+ /** @description Pin the export to a past snapshot commit_seq (first page only) */
12660
12923
  as_of_commit_seq?: string;
12661
12924
  };
12662
12925
  header?: {
12663
12926
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
12664
12927
  "Lbb-Version"?: string;
12665
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
12666
- "Idempotency-Key"?: string;
12667
12928
  };
12668
12929
  path?: never;
12669
12930
  cookie?: never;
@@ -12789,27 +13050,883 @@ export interface operations {
12789
13050
  };
12790
13051
  };
12791
13052
  };
12792
- get_v1_graph_export_rdf: {
13053
+ get_v1_graph_export_job: {
13054
+ parameters: {
13055
+ query?: {
13056
+ /** @description Graph name (default `main`) */
13057
+ graph?: string;
13058
+ /** @description Branch name (default `main`) */
13059
+ branch?: string;
13060
+ /** @description The export job id returned by the enqueue call */
13061
+ job_id?: string;
13062
+ };
13063
+ header?: {
13064
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13065
+ "Lbb-Version"?: string;
13066
+ };
13067
+ path?: never;
13068
+ cookie?: never;
13069
+ };
13070
+ requestBody?: never;
13071
+ responses: {
13072
+ /** @description OK */
13073
+ 200: {
13074
+ headers: {
13075
+ /** @description API contract version used for the response */
13076
+ "Lbb-Version"?: string;
13077
+ /** @description Request correlation id */
13078
+ "X-Request-Id"?: string;
13079
+ [name: string]: unknown;
13080
+ };
13081
+ content: {
13082
+ "application/json": Record<string, never>;
13083
+ };
13084
+ };
13085
+ /** @description Bad request */
13086
+ 400: {
13087
+ headers: {
13088
+ /** @description API contract version used for the response */
13089
+ "Lbb-Version"?: string;
13090
+ /** @description Request correlation id */
13091
+ "X-Request-Id"?: string;
13092
+ [name: string]: unknown;
13093
+ };
13094
+ content: {
13095
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13096
+ };
13097
+ };
13098
+ /** @description Unauthorized */
13099
+ 401: {
13100
+ headers: {
13101
+ /** @description API contract version used for the response */
13102
+ "Lbb-Version"?: string;
13103
+ /** @description Request correlation id */
13104
+ "X-Request-Id"?: string;
13105
+ [name: string]: unknown;
13106
+ };
13107
+ content: {
13108
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13109
+ };
13110
+ };
13111
+ /** @description Forbidden */
13112
+ 403: {
13113
+ headers: {
13114
+ /** @description API contract version used for the response */
13115
+ "Lbb-Version"?: string;
13116
+ /** @description Request correlation id */
13117
+ "X-Request-Id"?: string;
13118
+ [name: string]: unknown;
13119
+ };
13120
+ content: {
13121
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13122
+ };
13123
+ };
13124
+ /** @description Not found */
13125
+ 404: {
13126
+ headers: {
13127
+ /** @description API contract version used for the response */
13128
+ "Lbb-Version"?: string;
13129
+ /** @description Request correlation id */
13130
+ "X-Request-Id"?: string;
13131
+ [name: string]: unknown;
13132
+ };
13133
+ content: {
13134
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13135
+ };
13136
+ };
13137
+ /** @description Conflict */
13138
+ 409: {
13139
+ headers: {
13140
+ /** @description API contract version used for the response */
13141
+ "Lbb-Version"?: string;
13142
+ /** @description Request correlation id */
13143
+ "X-Request-Id"?: string;
13144
+ [name: string]: unknown;
13145
+ };
13146
+ content: {
13147
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13148
+ };
13149
+ };
13150
+ /** @description Rate limit exceeded */
13151
+ 429: {
13152
+ headers: {
13153
+ /** @description API contract version used for the response */
13154
+ "Lbb-Version"?: string;
13155
+ /** @description Request correlation id */
13156
+ "X-Request-Id"?: string;
13157
+ [name: string]: unknown;
13158
+ };
13159
+ content: {
13160
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13161
+ };
13162
+ };
13163
+ /** @description Internal server error */
13164
+ 500: {
13165
+ headers: {
13166
+ /** @description API contract version used for the response */
13167
+ "Lbb-Version"?: string;
13168
+ /** @description Request correlation id */
13169
+ "X-Request-Id"?: string;
13170
+ [name: string]: unknown;
13171
+ };
13172
+ content: {
13173
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13174
+ };
13175
+ };
13176
+ /** @description Service unavailable */
13177
+ 503: {
13178
+ headers: {
13179
+ /** @description API contract version used for the response */
13180
+ "Lbb-Version"?: string;
13181
+ /** @description Request correlation id */
13182
+ "X-Request-Id"?: string;
13183
+ [name: string]: unknown;
13184
+ };
13185
+ content: {
13186
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13187
+ };
13188
+ };
13189
+ };
13190
+ };
13191
+ post_v1_graph_export_job: {
13192
+ parameters: {
13193
+ query?: {
13194
+ /** @description Graph name (default `main`) */
13195
+ graph?: string;
13196
+ /** @description Branch name (default `main`) */
13197
+ branch?: string;
13198
+ /** @description Pin the export to a past snapshot commit_seq */
13199
+ as_of_commit_seq?: string;
13200
+ };
13201
+ header?: {
13202
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13203
+ "Lbb-Version"?: string;
13204
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
13205
+ "Idempotency-Key"?: string;
13206
+ };
13207
+ path?: never;
13208
+ cookie?: never;
13209
+ };
13210
+ requestBody?: never;
13211
+ responses: {
13212
+ /** @description OK */
13213
+ 200: {
13214
+ headers: {
13215
+ /** @description API contract version used for the response */
13216
+ "Lbb-Version"?: string;
13217
+ /** @description Request correlation id */
13218
+ "X-Request-Id"?: string;
13219
+ [name: string]: unknown;
13220
+ };
13221
+ content: {
13222
+ "application/json": Record<string, never>;
13223
+ };
13224
+ };
13225
+ /** @description Bad request */
13226
+ 400: {
13227
+ headers: {
13228
+ /** @description API contract version used for the response */
13229
+ "Lbb-Version"?: string;
13230
+ /** @description Request correlation id */
13231
+ "X-Request-Id"?: string;
13232
+ [name: string]: unknown;
13233
+ };
13234
+ content: {
13235
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13236
+ };
13237
+ };
13238
+ /** @description Unauthorized */
13239
+ 401: {
13240
+ headers: {
13241
+ /** @description API contract version used for the response */
13242
+ "Lbb-Version"?: string;
13243
+ /** @description Request correlation id */
13244
+ "X-Request-Id"?: string;
13245
+ [name: string]: unknown;
13246
+ };
13247
+ content: {
13248
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13249
+ };
13250
+ };
13251
+ /** @description Forbidden */
13252
+ 403: {
13253
+ headers: {
13254
+ /** @description API contract version used for the response */
13255
+ "Lbb-Version"?: string;
13256
+ /** @description Request correlation id */
13257
+ "X-Request-Id"?: string;
13258
+ [name: string]: unknown;
13259
+ };
13260
+ content: {
13261
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13262
+ };
13263
+ };
13264
+ /** @description Not found */
13265
+ 404: {
13266
+ headers: {
13267
+ /** @description API contract version used for the response */
13268
+ "Lbb-Version"?: string;
13269
+ /** @description Request correlation id */
13270
+ "X-Request-Id"?: string;
13271
+ [name: string]: unknown;
13272
+ };
13273
+ content: {
13274
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13275
+ };
13276
+ };
13277
+ /** @description Conflict */
13278
+ 409: {
13279
+ headers: {
13280
+ /** @description API contract version used for the response */
13281
+ "Lbb-Version"?: string;
13282
+ /** @description Request correlation id */
13283
+ "X-Request-Id"?: string;
13284
+ [name: string]: unknown;
13285
+ };
13286
+ content: {
13287
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13288
+ };
13289
+ };
13290
+ /** @description Rate limit exceeded */
13291
+ 429: {
13292
+ headers: {
13293
+ /** @description API contract version used for the response */
13294
+ "Lbb-Version"?: string;
13295
+ /** @description Request correlation id */
13296
+ "X-Request-Id"?: string;
13297
+ [name: string]: unknown;
13298
+ };
13299
+ content: {
13300
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13301
+ };
13302
+ };
13303
+ /** @description Internal server error */
13304
+ 500: {
13305
+ headers: {
13306
+ /** @description API contract version used for the response */
13307
+ "Lbb-Version"?: string;
13308
+ /** @description Request correlation id */
13309
+ "X-Request-Id"?: string;
13310
+ [name: string]: unknown;
13311
+ };
13312
+ content: {
13313
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13314
+ };
13315
+ };
13316
+ /** @description Service unavailable */
13317
+ 503: {
13318
+ headers: {
13319
+ /** @description API contract version used for the response */
13320
+ "Lbb-Version"?: string;
13321
+ /** @description Request correlation id */
13322
+ "X-Request-Id"?: string;
13323
+ [name: string]: unknown;
13324
+ };
13325
+ content: {
13326
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13327
+ };
13328
+ };
13329
+ };
13330
+ };
13331
+ get_v1_graph_export_rdf: {
13332
+ parameters: {
13333
+ query?: {
13334
+ /** @description Graph name (default `main`) */
13335
+ graph?: string;
13336
+ /** @description Branch name (default `main`) */
13337
+ branch?: string;
13338
+ /** @description RDF format: turtle (default), nt/ntriples, trig, or nq/nquads */
13339
+ format?: string;
13340
+ /** @description Output ceiling; rejects the full export, or bounds the JSON preview when truncate=true */
13341
+ max_triples?: string;
13342
+ /** @description Return a deterministic bounded JSON preview instead of rejecting when the graph is larger than max_triples */
13343
+ truncate?: string;
13344
+ /** @description RFC3339 valid-time snapshot pin */
13345
+ as_of_valid_time?: string;
13346
+ /** @description Commit-sequence snapshot pin */
13347
+ as_of_commit_seq?: string;
13348
+ /** @description subclass (default) or none */
13349
+ entailment?: string;
13350
+ /** @description Include stored rule-derived facts when true */
13351
+ reason?: string;
13352
+ };
13353
+ header?: {
13354
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13355
+ "Lbb-Version"?: string;
13356
+ };
13357
+ path?: never;
13358
+ cookie?: never;
13359
+ };
13360
+ requestBody?: never;
13361
+ responses: {
13362
+ /** @description RDF graph */
13363
+ 200: {
13364
+ headers: {
13365
+ /** @description API contract version used for the response */
13366
+ "Lbb-Version"?: string;
13367
+ /** @description Request correlation id */
13368
+ "X-Request-Id"?: string;
13369
+ [name: string]: unknown;
13370
+ };
13371
+ content: {
13372
+ "application/json": components["schemas"]["RdfExportPreviewResponse"];
13373
+ "application/n-quads": string;
13374
+ "application/n-triples": string;
13375
+ "application/trig": string;
13376
+ "text/turtle": string;
13377
+ };
13378
+ };
13379
+ /** @description Bad request */
13380
+ 400: {
13381
+ headers: {
13382
+ /** @description API contract version used for the response */
13383
+ "Lbb-Version"?: string;
13384
+ /** @description Request correlation id */
13385
+ "X-Request-Id"?: string;
13386
+ [name: string]: unknown;
13387
+ };
13388
+ content: {
13389
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13390
+ };
13391
+ };
13392
+ /** @description Unauthorized */
13393
+ 401: {
13394
+ headers: {
13395
+ /** @description API contract version used for the response */
13396
+ "Lbb-Version"?: string;
13397
+ /** @description Request correlation id */
13398
+ "X-Request-Id"?: string;
13399
+ [name: string]: unknown;
13400
+ };
13401
+ content: {
13402
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13403
+ };
13404
+ };
13405
+ /** @description Forbidden */
13406
+ 403: {
13407
+ headers: {
13408
+ /** @description API contract version used for the response */
13409
+ "Lbb-Version"?: string;
13410
+ /** @description Request correlation id */
13411
+ "X-Request-Id"?: string;
13412
+ [name: string]: unknown;
13413
+ };
13414
+ content: {
13415
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13416
+ };
13417
+ };
13418
+ /** @description Not found */
13419
+ 404: {
13420
+ headers: {
13421
+ /** @description API contract version used for the response */
13422
+ "Lbb-Version"?: string;
13423
+ /** @description Request correlation id */
13424
+ "X-Request-Id"?: string;
13425
+ [name: string]: unknown;
13426
+ };
13427
+ content: {
13428
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13429
+ };
13430
+ };
13431
+ /** @description Conflict */
13432
+ 409: {
13433
+ headers: {
13434
+ /** @description API contract version used for the response */
13435
+ "Lbb-Version"?: string;
13436
+ /** @description Request correlation id */
13437
+ "X-Request-Id"?: string;
13438
+ [name: string]: unknown;
13439
+ };
13440
+ content: {
13441
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13442
+ };
13443
+ };
13444
+ /** @description Rate limit exceeded */
13445
+ 429: {
13446
+ headers: {
13447
+ /** @description API contract version used for the response */
13448
+ "Lbb-Version"?: string;
13449
+ /** @description Request correlation id */
13450
+ "X-Request-Id"?: string;
13451
+ [name: string]: unknown;
13452
+ };
13453
+ content: {
13454
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13455
+ };
13456
+ };
13457
+ /** @description Internal server error */
13458
+ 500: {
13459
+ headers: {
13460
+ /** @description API contract version used for the response */
13461
+ "Lbb-Version"?: string;
13462
+ /** @description Request correlation id */
13463
+ "X-Request-Id"?: string;
13464
+ [name: string]: unknown;
13465
+ };
13466
+ content: {
13467
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13468
+ };
13469
+ };
13470
+ /** @description Service unavailable */
13471
+ 503: {
13472
+ headers: {
13473
+ /** @description API contract version used for the response */
13474
+ "Lbb-Version"?: string;
13475
+ /** @description Request correlation id */
13476
+ "X-Request-Id"?: string;
13477
+ [name: string]: unknown;
13478
+ };
13479
+ content: {
13480
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13481
+ };
13482
+ };
13483
+ };
13484
+ };
13485
+ get_v1_graph_groundability: {
13486
+ parameters: {
13487
+ query?: {
13488
+ /** @description Graph name (default `main`) */
13489
+ graph?: string;
13490
+ /** @description Branch name (default `main`) */
13491
+ branch?: string;
13492
+ /** @description Entities to sample for name/recall probes (default 50, max 200) */
13493
+ sample?: string;
13494
+ };
13495
+ header?: {
13496
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13497
+ "Lbb-Version"?: string;
13498
+ };
13499
+ path?: never;
13500
+ cookie?: never;
13501
+ };
13502
+ requestBody?: never;
13503
+ responses: {
13504
+ /** @description OK */
13505
+ 200: {
13506
+ headers: {
13507
+ /** @description API contract version used for the response */
13508
+ "Lbb-Version"?: string;
13509
+ /** @description Request correlation id */
13510
+ "X-Request-Id"?: string;
13511
+ [name: string]: unknown;
13512
+ };
13513
+ content: {
13514
+ "application/json": components["schemas"]["GroundabilityReport"];
13515
+ };
13516
+ };
13517
+ /** @description Bad request */
13518
+ 400: {
13519
+ headers: {
13520
+ /** @description API contract version used for the response */
13521
+ "Lbb-Version"?: string;
13522
+ /** @description Request correlation id */
13523
+ "X-Request-Id"?: string;
13524
+ [name: string]: unknown;
13525
+ };
13526
+ content: {
13527
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13528
+ };
13529
+ };
13530
+ /** @description Unauthorized */
13531
+ 401: {
13532
+ headers: {
13533
+ /** @description API contract version used for the response */
13534
+ "Lbb-Version"?: string;
13535
+ /** @description Request correlation id */
13536
+ "X-Request-Id"?: string;
13537
+ [name: string]: unknown;
13538
+ };
13539
+ content: {
13540
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13541
+ };
13542
+ };
13543
+ /** @description Forbidden */
13544
+ 403: {
13545
+ headers: {
13546
+ /** @description API contract version used for the response */
13547
+ "Lbb-Version"?: string;
13548
+ /** @description Request correlation id */
13549
+ "X-Request-Id"?: string;
13550
+ [name: string]: unknown;
13551
+ };
13552
+ content: {
13553
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13554
+ };
13555
+ };
13556
+ /** @description Not found */
13557
+ 404: {
13558
+ headers: {
13559
+ /** @description API contract version used for the response */
13560
+ "Lbb-Version"?: string;
13561
+ /** @description Request correlation id */
13562
+ "X-Request-Id"?: string;
13563
+ [name: string]: unknown;
13564
+ };
13565
+ content: {
13566
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13567
+ };
13568
+ };
13569
+ /** @description Conflict */
13570
+ 409: {
13571
+ headers: {
13572
+ /** @description API contract version used for the response */
13573
+ "Lbb-Version"?: string;
13574
+ /** @description Request correlation id */
13575
+ "X-Request-Id"?: string;
13576
+ [name: string]: unknown;
13577
+ };
13578
+ content: {
13579
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13580
+ };
13581
+ };
13582
+ /** @description Rate limit exceeded */
13583
+ 429: {
13584
+ headers: {
13585
+ /** @description API contract version used for the response */
13586
+ "Lbb-Version"?: string;
13587
+ /** @description Request correlation id */
13588
+ "X-Request-Id"?: string;
13589
+ [name: string]: unknown;
13590
+ };
13591
+ content: {
13592
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13593
+ };
13594
+ };
13595
+ /** @description Internal server error */
13596
+ 500: {
13597
+ headers: {
13598
+ /** @description API contract version used for the response */
13599
+ "Lbb-Version"?: string;
13600
+ /** @description Request correlation id */
13601
+ "X-Request-Id"?: string;
13602
+ [name: string]: unknown;
13603
+ };
13604
+ content: {
13605
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13606
+ };
13607
+ };
13608
+ /** @description Service unavailable */
13609
+ 503: {
13610
+ headers: {
13611
+ /** @description API contract version used for the response */
13612
+ "Lbb-Version"?: string;
13613
+ /** @description Request correlation id */
13614
+ "X-Request-Id"?: string;
13615
+ [name: string]: unknown;
13616
+ };
13617
+ content: {
13618
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13619
+ };
13620
+ };
13621
+ };
13622
+ };
13623
+ post_v1_graph_import: {
13624
+ parameters: {
13625
+ query?: {
13626
+ /** @description Graph name (default `main`) */
13627
+ graph?: string;
13628
+ /** @description Branch name (default `main`) */
13629
+ branch?: string;
13630
+ /** @description Records per internal commit (default 1000, clamped 1-10000) */
13631
+ batch?: string;
13632
+ /** @description Abort on the first malformed line instead of skipping it */
13633
+ strict?: string;
13634
+ /** @description RFC3339 backfill instant stamped on every batch */
13635
+ observed_at?: string;
13636
+ };
13637
+ header?: {
13638
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13639
+ "Lbb-Version"?: string;
13640
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
13641
+ "Idempotency-Key"?: string;
13642
+ };
13643
+ path?: never;
13644
+ cookie?: never;
13645
+ };
13646
+ requestBody?: never;
13647
+ responses: {
13648
+ /** @description OK */
13649
+ 200: {
13650
+ headers: {
13651
+ /** @description API contract version used for the response */
13652
+ "Lbb-Version"?: string;
13653
+ /** @description Request correlation id */
13654
+ "X-Request-Id"?: string;
13655
+ [name: string]: unknown;
13656
+ };
13657
+ content: {
13658
+ "application/json": components["schemas"]["GraphImportResponse"];
13659
+ };
13660
+ };
13661
+ /** @description Bad request */
13662
+ 400: {
13663
+ headers: {
13664
+ /** @description API contract version used for the response */
13665
+ "Lbb-Version"?: string;
13666
+ /** @description Request correlation id */
13667
+ "X-Request-Id"?: string;
13668
+ [name: string]: unknown;
13669
+ };
13670
+ content: {
13671
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13672
+ };
13673
+ };
13674
+ /** @description Unauthorized */
13675
+ 401: {
13676
+ headers: {
13677
+ /** @description API contract version used for the response */
13678
+ "Lbb-Version"?: string;
13679
+ /** @description Request correlation id */
13680
+ "X-Request-Id"?: string;
13681
+ [name: string]: unknown;
13682
+ };
13683
+ content: {
13684
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13685
+ };
13686
+ };
13687
+ /** @description Forbidden */
13688
+ 403: {
13689
+ headers: {
13690
+ /** @description API contract version used for the response */
13691
+ "Lbb-Version"?: string;
13692
+ /** @description Request correlation id */
13693
+ "X-Request-Id"?: string;
13694
+ [name: string]: unknown;
13695
+ };
13696
+ content: {
13697
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13698
+ };
13699
+ };
13700
+ /** @description Not found */
13701
+ 404: {
13702
+ headers: {
13703
+ /** @description API contract version used for the response */
13704
+ "Lbb-Version"?: string;
13705
+ /** @description Request correlation id */
13706
+ "X-Request-Id"?: string;
13707
+ [name: string]: unknown;
13708
+ };
13709
+ content: {
13710
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13711
+ };
13712
+ };
13713
+ /** @description Conflict */
13714
+ 409: {
13715
+ headers: {
13716
+ /** @description API contract version used for the response */
13717
+ "Lbb-Version"?: string;
13718
+ /** @description Request correlation id */
13719
+ "X-Request-Id"?: string;
13720
+ [name: string]: unknown;
13721
+ };
13722
+ content: {
13723
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13724
+ };
13725
+ };
13726
+ /** @description Rate limit exceeded */
13727
+ 429: {
13728
+ headers: {
13729
+ /** @description API contract version used for the response */
13730
+ "Lbb-Version"?: string;
13731
+ /** @description Request correlation id */
13732
+ "X-Request-Id"?: string;
13733
+ [name: string]: unknown;
13734
+ };
13735
+ content: {
13736
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13737
+ };
13738
+ };
13739
+ /** @description Internal server error */
13740
+ 500: {
13741
+ headers: {
13742
+ /** @description API contract version used for the response */
13743
+ "Lbb-Version"?: string;
13744
+ /** @description Request correlation id */
13745
+ "X-Request-Id"?: string;
13746
+ [name: string]: unknown;
13747
+ };
13748
+ content: {
13749
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13750
+ };
13751
+ };
13752
+ /** @description Service unavailable */
13753
+ 503: {
13754
+ headers: {
13755
+ /** @description API contract version used for the response */
13756
+ "Lbb-Version"?: string;
13757
+ /** @description Request correlation id */
13758
+ "X-Request-Id"?: string;
13759
+ [name: string]: unknown;
13760
+ };
13761
+ content: {
13762
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13763
+ };
13764
+ };
13765
+ };
13766
+ };
13767
+ post_v1_graph_import_rdf: {
13768
+ parameters: {
13769
+ query?: {
13770
+ /** @description Graph name (default `main`) */
13771
+ graph?: string;
13772
+ /** @description Branch name (default `main`) */
13773
+ branch?: string;
13774
+ /** @description RDF statements per internal commit (default 1000, clamped 1-1000000) */
13775
+ batch?: string;
13776
+ /** @description Abort on the first malformed RDF parse error instead of reporting it */
13777
+ strict?: string;
13778
+ /** @description RFC3339 backfill instant stamped on every batch */
13779
+ observed_at?: string;
13780
+ /** @description Edge duplicate handling: skip_unchanged (default) or append for fresh high-throughput loads */
13781
+ edge_idempotency?: string;
13782
+ /** @description RDF format: ntriples (default), turtle, nquads, or trig */
13783
+ format?: string;
13784
+ /** @description Optional base IRI for resolving relative IRIs in Turtle or TriG */
13785
+ base_iri?: string;
13786
+ /** @description Optional named-graph IRI for N-Triples or Turtle input */
13787
+ graph_uri?: string;
13788
+ /** @description Optional stable document scope for blank-node labels across chunks; omit to preserve labels exactly across retries and chunk boundaries */
13789
+ blank_node_scope?: string;
13790
+ /** @description Entity type name for imported RDF resources (default Resource) */
13791
+ resource_type?: string;
13792
+ };
13793
+ header?: {
13794
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13795
+ "Lbb-Version"?: string;
13796
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
13797
+ "Idempotency-Key"?: string;
13798
+ };
13799
+ path?: never;
13800
+ cookie?: never;
13801
+ };
13802
+ requestBody?: never;
13803
+ responses: {
13804
+ /** @description OK */
13805
+ 200: {
13806
+ headers: {
13807
+ /** @description API contract version used for the response */
13808
+ "Lbb-Version"?: string;
13809
+ /** @description Request correlation id */
13810
+ "X-Request-Id"?: string;
13811
+ [name: string]: unknown;
13812
+ };
13813
+ content: {
13814
+ "application/json": components["schemas"]["GraphRdfImportResponse"];
13815
+ };
13816
+ };
13817
+ /** @description Bad request */
13818
+ 400: {
13819
+ headers: {
13820
+ /** @description API contract version used for the response */
13821
+ "Lbb-Version"?: string;
13822
+ /** @description Request correlation id */
13823
+ "X-Request-Id"?: string;
13824
+ [name: string]: unknown;
13825
+ };
13826
+ content: {
13827
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13828
+ };
13829
+ };
13830
+ /** @description Unauthorized */
13831
+ 401: {
13832
+ headers: {
13833
+ /** @description API contract version used for the response */
13834
+ "Lbb-Version"?: string;
13835
+ /** @description Request correlation id */
13836
+ "X-Request-Id"?: string;
13837
+ [name: string]: unknown;
13838
+ };
13839
+ content: {
13840
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13841
+ };
13842
+ };
13843
+ /** @description Forbidden */
13844
+ 403: {
13845
+ headers: {
13846
+ /** @description API contract version used for the response */
13847
+ "Lbb-Version"?: string;
13848
+ /** @description Request correlation id */
13849
+ "X-Request-Id"?: string;
13850
+ [name: string]: unknown;
13851
+ };
13852
+ content: {
13853
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13854
+ };
13855
+ };
13856
+ /** @description Not found */
13857
+ 404: {
13858
+ headers: {
13859
+ /** @description API contract version used for the response */
13860
+ "Lbb-Version"?: string;
13861
+ /** @description Request correlation id */
13862
+ "X-Request-Id"?: string;
13863
+ [name: string]: unknown;
13864
+ };
13865
+ content: {
13866
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13867
+ };
13868
+ };
13869
+ /** @description Conflict */
13870
+ 409: {
13871
+ headers: {
13872
+ /** @description API contract version used for the response */
13873
+ "Lbb-Version"?: string;
13874
+ /** @description Request correlation id */
13875
+ "X-Request-Id"?: string;
13876
+ [name: string]: unknown;
13877
+ };
13878
+ content: {
13879
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13880
+ };
13881
+ };
13882
+ /** @description Rate limit exceeded */
13883
+ 429: {
13884
+ headers: {
13885
+ /** @description API contract version used for the response */
13886
+ "Lbb-Version"?: string;
13887
+ /** @description Request correlation id */
13888
+ "X-Request-Id"?: string;
13889
+ [name: string]: unknown;
13890
+ };
13891
+ content: {
13892
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13893
+ };
13894
+ };
13895
+ /** @description Internal server error */
13896
+ 500: {
13897
+ headers: {
13898
+ /** @description API contract version used for the response */
13899
+ "Lbb-Version"?: string;
13900
+ /** @description Request correlation id */
13901
+ "X-Request-Id"?: string;
13902
+ [name: string]: unknown;
13903
+ };
13904
+ content: {
13905
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13906
+ };
13907
+ };
13908
+ /** @description Service unavailable */
13909
+ 503: {
13910
+ headers: {
13911
+ /** @description API contract version used for the response */
13912
+ "Lbb-Version"?: string;
13913
+ /** @description Request correlation id */
13914
+ "X-Request-Id"?: string;
13915
+ [name: string]: unknown;
13916
+ };
13917
+ content: {
13918
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
13919
+ };
13920
+ };
13921
+ };
13922
+ };
13923
+ get_v1_graph_metadata: {
12793
13924
  parameters: {
12794
13925
  query?: {
12795
13926
  /** @description Graph name (default `main`) */
12796
13927
  graph?: string;
12797
13928
  /** @description Branch name (default `main`) */
12798
13929
  branch?: string;
12799
- /** @description RDF format: turtle (default), nt/ntriples, trig, or nq/nquads */
12800
- format?: string;
12801
- /** @description Output ceiling; rejects the full export, or bounds the JSON preview when truncate=true */
12802
- max_triples?: string;
12803
- /** @description Return a deterministic bounded JSON preview instead of rejecting when the graph is larger than max_triples */
12804
- truncate?: string;
12805
- /** @description RFC3339 valid-time snapshot pin */
12806
- as_of_valid_time?: string;
12807
- /** @description Commit-sequence snapshot pin */
12808
- as_of_commit_seq?: string;
12809
- /** @description subclass (default) or none */
12810
- entailment?: string;
12811
- /** @description Include stored rule-derived facts when true */
12812
- reason?: string;
12813
13930
  };
12814
13931
  header?: {
12815
13932
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -12820,7 +13937,7 @@ export interface operations {
12820
13937
  };
12821
13938
  requestBody?: never;
12822
13939
  responses: {
12823
- /** @description RDF graph */
13940
+ /** @description OK */
12824
13941
  200: {
12825
13942
  headers: {
12826
13943
  /** @description API contract version used for the response */
@@ -12830,11 +13947,7 @@ export interface operations {
12830
13947
  [name: string]: unknown;
12831
13948
  };
12832
13949
  content: {
12833
- "application/json": components["schemas"]["RdfExportPreviewResponse"];
12834
- "application/n-quads": string;
12835
- "application/n-triples": string;
12836
- "application/trig": string;
12837
- "text/turtle": string;
13950
+ "application/json": components["schemas"]["GraphMetadataResponse"];
12838
13951
  };
12839
13952
  };
12840
13953
  /** @description Bad request */
@@ -12943,15 +14056,19 @@ export interface operations {
12943
14056
  };
12944
14057
  };
12945
14058
  };
12946
- get_v1_graph_groundability: {
14059
+ get_v1_graph_observations: {
12947
14060
  parameters: {
12948
14061
  query?: {
12949
14062
  /** @description Graph name (default `main`) */
12950
14063
  graph?: string;
12951
14064
  /** @description Branch name (default `main`) */
12952
14065
  branch?: string;
12953
- /** @description Entities to sample for name/recall probes (default 50, max 200) */
12954
- sample?: string;
14066
+ /** @description Search text */
14067
+ q?: string;
14068
+ /** @description Max rows */
14069
+ limit?: string;
14070
+ /** @description Opaque cursor from the previous page */
14071
+ cursor?: string;
12955
14072
  };
12956
14073
  header?: {
12957
14074
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -12972,7 +14089,7 @@ export interface operations {
12972
14089
  [name: string]: unknown;
12973
14090
  };
12974
14091
  content: {
12975
- "application/json": components["schemas"]["GroundabilityReport"];
14092
+ "application/json": Record<string, never>;
12976
14093
  };
12977
14094
  };
12978
14095
  /** @description Bad request */
@@ -13081,19 +14198,13 @@ export interface operations {
13081
14198
  };
13082
14199
  };
13083
14200
  };
13084
- post_v1_graph_import: {
14201
+ post_v1_graph_query: {
13085
14202
  parameters: {
13086
14203
  query?: {
13087
14204
  /** @description Graph name (default `main`) */
13088
14205
  graph?: string;
13089
14206
  /** @description Branch name (default `main`) */
13090
14207
  branch?: string;
13091
- /** @description Records per internal commit (default 1000, clamped 1-10000) */
13092
- batch?: string;
13093
- /** @description Abort on the first malformed line instead of skipping it */
13094
- strict?: string;
13095
- /** @description RFC3339 backfill instant stamped on every batch */
13096
- observed_at?: string;
13097
14208
  };
13098
14209
  header?: {
13099
14210
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -13104,7 +14215,11 @@ export interface operations {
13104
14215
  path?: never;
13105
14216
  cookie?: never;
13106
14217
  };
13107
- requestBody?: never;
14218
+ requestBody: {
14219
+ content: {
14220
+ "application/json": components["schemas"]["SparqlTextRequest"];
14221
+ };
14222
+ };
13108
14223
  responses: {
13109
14224
  /** @description OK */
13110
14225
  200: {
@@ -13116,7 +14231,7 @@ export interface operations {
13116
14231
  [name: string]: unknown;
13117
14232
  };
13118
14233
  content: {
13119
- "application/json": components["schemas"]["GraphImportResponse"];
14234
+ "application/json": components["schemas"]["SparqlTextResponse"];
13120
14235
  };
13121
14236
  };
13122
14237
  /** @description Bad request */
@@ -13225,31 +14340,13 @@ export interface operations {
13225
14340
  };
13226
14341
  };
13227
14342
  };
13228
- post_v1_graph_import_rdf: {
14343
+ post_v1_graph_retract: {
13229
14344
  parameters: {
13230
14345
  query?: {
13231
14346
  /** @description Graph name (default `main`) */
13232
14347
  graph?: string;
13233
14348
  /** @description Branch name (default `main`) */
13234
14349
  branch?: string;
13235
- /** @description RDF statements per internal commit (default 1000, clamped 1-1000000) */
13236
- batch?: string;
13237
- /** @description Abort on the first malformed RDF parse error instead of reporting it */
13238
- strict?: string;
13239
- /** @description RFC3339 backfill instant stamped on every batch */
13240
- observed_at?: string;
13241
- /** @description Edge duplicate handling: skip_unchanged (default) or append for fresh high-throughput loads */
13242
- edge_idempotency?: string;
13243
- /** @description RDF format: ntriples (default), turtle, nquads, or trig */
13244
- format?: string;
13245
- /** @description Optional base IRI for resolving relative IRIs in Turtle or TriG */
13246
- base_iri?: string;
13247
- /** @description Optional named-graph IRI for N-Triples or Turtle input */
13248
- graph_uri?: string;
13249
- /** @description Optional stable document scope for blank-node labels across chunks; omit to preserve labels exactly across retries and chunk boundaries */
13250
- blank_node_scope?: string;
13251
- /** @description Entity type name for imported RDF resources (default Resource) */
13252
- resource_type?: string;
13253
14350
  };
13254
14351
  header?: {
13255
14352
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -13260,7 +14357,11 @@ export interface operations {
13260
14357
  path?: never;
13261
14358
  cookie?: never;
13262
14359
  };
13263
- requestBody?: never;
14360
+ requestBody: {
14361
+ content: {
14362
+ "application/json": components["schemas"]["GraphRetractRequest"];
14363
+ };
14364
+ };
13264
14365
  responses: {
13265
14366
  /** @description OK */
13266
14367
  200: {
@@ -13272,7 +14373,7 @@ export interface operations {
13272
14373
  [name: string]: unknown;
13273
14374
  };
13274
14375
  content: {
13275
- "application/json": components["schemas"]["GraphRdfImportResponse"];
14376
+ "application/json": components["schemas"]["GraphRetractResponse"];
13276
14377
  };
13277
14378
  };
13278
14379
  /** @description Bad request */
@@ -13381,7 +14482,7 @@ export interface operations {
13381
14482
  };
13382
14483
  };
13383
14484
  };
13384
- get_v1_graph_metadata: {
14485
+ post_v1_graph_search: {
13385
14486
  parameters: {
13386
14487
  query?: {
13387
14488
  /** @description Graph name (default `main`) */
@@ -13392,11 +14493,17 @@ export interface operations {
13392
14493
  header?: {
13393
14494
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13394
14495
  "Lbb-Version"?: string;
14496
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
14497
+ "Idempotency-Key"?: string;
13395
14498
  };
13396
14499
  path?: never;
13397
14500
  cookie?: never;
13398
14501
  };
13399
- requestBody?: never;
14502
+ requestBody: {
14503
+ content: {
14504
+ "application/json": components["schemas"]["SemanticGraphSearchRequest"];
14505
+ };
14506
+ };
13400
14507
  responses: {
13401
14508
  /** @description OK */
13402
14509
  200: {
@@ -13408,7 +14515,7 @@ export interface operations {
13408
14515
  [name: string]: unknown;
13409
14516
  };
13410
14517
  content: {
13411
- "application/json": components["schemas"]["GraphMetadataResponse"];
14518
+ "application/json": components["schemas"]["SemanticGraphSearchResponse"];
13412
14519
  };
13413
14520
  };
13414
14521
  /** @description Bad request */
@@ -13517,28 +14624,28 @@ export interface operations {
13517
14624
  };
13518
14625
  };
13519
14626
  };
13520
- get_v1_graph_observations: {
14627
+ post_v1_graph_semantic_traverse: {
13521
14628
  parameters: {
13522
14629
  query?: {
13523
14630
  /** @description Graph name (default `main`) */
13524
14631
  graph?: string;
13525
14632
  /** @description Branch name (default `main`) */
13526
14633
  branch?: string;
13527
- /** @description Search text */
13528
- q?: string;
13529
- /** @description Max rows */
13530
- limit?: string;
13531
- /** @description Opaque cursor from the previous page */
13532
- cursor?: string;
13533
14634
  };
13534
14635
  header?: {
13535
14636
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13536
14637
  "Lbb-Version"?: string;
14638
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
14639
+ "Idempotency-Key"?: string;
13537
14640
  };
13538
14641
  path?: never;
13539
14642
  cookie?: never;
13540
14643
  };
13541
- requestBody?: never;
14644
+ requestBody: {
14645
+ content: {
14646
+ "application/json": components["schemas"]["SemanticTraverseRequest"];
14647
+ };
14648
+ };
13542
14649
  responses: {
13543
14650
  /** @description OK */
13544
14651
  200: {
@@ -13550,7 +14657,7 @@ export interface operations {
13550
14657
  [name: string]: unknown;
13551
14658
  };
13552
14659
  content: {
13553
- "application/json": Record<string, never>;
14660
+ "application/json": components["schemas"]["SemanticTraverseResponse"];
13554
14661
  };
13555
14662
  };
13556
14663
  /** @description Bad request */
@@ -13659,7 +14766,7 @@ export interface operations {
13659
14766
  };
13660
14767
  };
13661
14768
  };
13662
- post_v1_graph_query: {
14769
+ get_v1_graph_summary: {
13663
14770
  parameters: {
13664
14771
  query?: {
13665
14772
  /** @description Graph name (default `main`) */
@@ -13670,17 +14777,11 @@ export interface operations {
13670
14777
  header?: {
13671
14778
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13672
14779
  "Lbb-Version"?: string;
13673
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
13674
- "Idempotency-Key"?: string;
13675
14780
  };
13676
14781
  path?: never;
13677
14782
  cookie?: never;
13678
14783
  };
13679
- requestBody: {
13680
- content: {
13681
- "application/json": components["schemas"]["SparqlTextRequest"];
13682
- };
13683
- };
14784
+ requestBody?: never;
13684
14785
  responses: {
13685
14786
  /** @description OK */
13686
14787
  200: {
@@ -13692,7 +14793,7 @@ export interface operations {
13692
14793
  [name: string]: unknown;
13693
14794
  };
13694
14795
  content: {
13695
- "application/json": components["schemas"]["SparqlTextResponse"];
14796
+ "application/json": components["schemas"]["GraphSummaryResponse"];
13696
14797
  };
13697
14798
  };
13698
14799
  /** @description Bad request */
@@ -13801,28 +14902,28 @@ export interface operations {
13801
14902
  };
13802
14903
  };
13803
14904
  };
13804
- post_v1_graph_retract: {
14905
+ get_v1_graph_traverse: {
13805
14906
  parameters: {
13806
14907
  query?: {
13807
14908
  /** @description Graph name (default `main`) */
13808
14909
  graph?: string;
13809
14910
  /** @description Branch name (default `main`) */
13810
14911
  branch?: string;
14912
+ /** @description Start entity id */
14913
+ id?: string;
14914
+ /** @description out, in, or both */
14915
+ direction?: string;
14916
+ /** @description Hop budget */
14917
+ max_hops?: string;
13811
14918
  };
13812
14919
  header?: {
13813
14920
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
13814
14921
  "Lbb-Version"?: string;
13815
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
13816
- "Idempotency-Key"?: string;
13817
14922
  };
13818
14923
  path?: never;
13819
14924
  cookie?: never;
13820
14925
  };
13821
- requestBody: {
13822
- content: {
13823
- "application/json": components["schemas"]["GraphRetractRequest"];
13824
- };
13825
- };
14926
+ requestBody?: never;
13826
14927
  responses: {
13827
14928
  /** @description OK */
13828
14929
  200: {
@@ -13834,7 +14935,7 @@ export interface operations {
13834
14935
  [name: string]: unknown;
13835
14936
  };
13836
14937
  content: {
13837
- "application/json": components["schemas"]["GraphRetractResponse"];
14938
+ "application/json": components["schemas"]["TraverseResponse"];
13838
14939
  };
13839
14940
  };
13840
14941
  /** @description Bad request */
@@ -13943,7 +15044,7 @@ export interface operations {
13943
15044
  };
13944
15045
  };
13945
15046
  };
13946
- post_v1_graph_search: {
15047
+ post_v1_graph_traverse: {
13947
15048
  parameters: {
13948
15049
  query?: {
13949
15050
  /** @description Graph name (default `main`) */
@@ -13962,7 +15063,7 @@ export interface operations {
13962
15063
  };
13963
15064
  requestBody: {
13964
15065
  content: {
13965
- "application/json": components["schemas"]["SemanticGraphSearchRequest"];
15066
+ "application/json": components["schemas"]["TraverseRequest"];
13966
15067
  };
13967
15068
  };
13968
15069
  responses: {
@@ -13976,7 +15077,7 @@ export interface operations {
13976
15077
  [name: string]: unknown;
13977
15078
  };
13978
15079
  content: {
13979
- "application/json": components["schemas"]["SemanticGraphSearchResponse"];
15080
+ "application/json": components["schemas"]["TraverseResponse"];
13980
15081
  };
13981
15082
  };
13982
15083
  /** @description Bad request */
@@ -14085,28 +15186,26 @@ export interface operations {
14085
15186
  };
14086
15187
  };
14087
15188
  };
14088
- post_v1_graph_semantic_traverse: {
15189
+ get_v1_graphs: {
14089
15190
  parameters: {
14090
15191
  query?: {
14091
15192
  /** @description Graph name (default `main`) */
14092
15193
  graph?: string;
14093
15194
  /** @description Branch name (default `main`) */
14094
15195
  branch?: string;
15196
+ /** @description Max rows */
15197
+ limit?: string;
15198
+ /** @description Opaque cursor from the previous page */
15199
+ cursor?: string;
14095
15200
  };
14096
15201
  header?: {
14097
15202
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
14098
15203
  "Lbb-Version"?: string;
14099
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
14100
- "Idempotency-Key"?: string;
14101
15204
  };
14102
15205
  path?: never;
14103
15206
  cookie?: never;
14104
15207
  };
14105
- requestBody: {
14106
- content: {
14107
- "application/json": components["schemas"]["SemanticTraverseRequest"];
14108
- };
14109
- };
15208
+ requestBody?: never;
14110
15209
  responses: {
14111
15210
  /** @description OK */
14112
15211
  200: {
@@ -14118,7 +15217,7 @@ export interface operations {
14118
15217
  [name: string]: unknown;
14119
15218
  };
14120
15219
  content: {
14121
- "application/json": components["schemas"]["SemanticTraverseResponse"];
15220
+ "application/json": components["schemas"]["GraphListResponse"];
14122
15221
  };
14123
15222
  };
14124
15223
  /** @description Bad request */
@@ -14227,13 +15326,15 @@ export interface operations {
14227
15326
  };
14228
15327
  };
14229
15328
  };
14230
- get_v1_graph_summary: {
15329
+ get_v1_index: {
14231
15330
  parameters: {
14232
15331
  query?: {
14233
15332
  /** @description Graph name (default `main`) */
14234
15333
  graph?: string;
14235
15334
  /** @description Branch name (default `main`) */
14236
15335
  branch?: string;
15336
+ /** @description Index source: persisted or ephemeral */
15337
+ source?: string;
14237
15338
  };
14238
15339
  header?: {
14239
15340
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -14254,7 +15355,7 @@ export interface operations {
14254
15355
  [name: string]: unknown;
14255
15356
  };
14256
15357
  content: {
14257
- "application/json": components["schemas"]["GraphSummaryResponse"];
15358
+ "application/json": components["schemas"]["EmbeddingIndexInspectResponse"];
14258
15359
  };
14259
15360
  };
14260
15361
  /** @description Bad request */
@@ -14363,28 +15464,30 @@ export interface operations {
14363
15464
  };
14364
15465
  };
14365
15466
  };
14366
- get_v1_graph_traverse: {
15467
+ post_v1_index_build: {
14367
15468
  parameters: {
14368
15469
  query?: {
14369
15470
  /** @description Graph name (default `main`) */
14370
15471
  graph?: string;
14371
15472
  /** @description Branch name (default `main`) */
14372
15473
  branch?: string;
14373
- /** @description Start entity id */
14374
- id?: string;
14375
- /** @description out, in, or both */
14376
- direction?: string;
14377
- /** @description Hop budget */
14378
- max_hops?: string;
15474
+ /** @description Run the build detached and return immediately; poll /v1/graph/metadata for completion */
15475
+ background?: string;
14379
15476
  };
14380
15477
  header?: {
14381
15478
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
14382
15479
  "Lbb-Version"?: string;
15480
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
15481
+ "Idempotency-Key"?: string;
14383
15482
  };
14384
15483
  path?: never;
14385
15484
  cookie?: never;
14386
15485
  };
14387
- requestBody?: never;
15486
+ requestBody: {
15487
+ content: {
15488
+ "application/json": components["schemas"]["IndexBuildOptions"];
15489
+ };
15490
+ };
14388
15491
  responses: {
14389
15492
  /** @description OK */
14390
15493
  200: {
@@ -14396,7 +15499,7 @@ export interface operations {
14396
15499
  [name: string]: unknown;
14397
15500
  };
14398
15501
  content: {
14399
- "application/json": components["schemas"]["TraverseResponse"];
15502
+ "application/json": Record<string, never>;
14400
15503
  };
14401
15504
  };
14402
15505
  /** @description Bad request */
@@ -14505,7 +15608,7 @@ export interface operations {
14505
15608
  };
14506
15609
  };
14507
15610
  };
14508
- post_v1_graph_traverse: {
15611
+ post_v1_index_delta: {
14509
15612
  parameters: {
14510
15613
  query?: {
14511
15614
  /** @description Graph name (default `main`) */
@@ -14522,11 +15625,7 @@ export interface operations {
14522
15625
  path?: never;
14523
15626
  cookie?: never;
14524
15627
  };
14525
- requestBody: {
14526
- content: {
14527
- "application/json": components["schemas"]["TraverseRequest"];
14528
- };
14529
- };
15628
+ requestBody?: never;
14530
15629
  responses: {
14531
15630
  /** @description OK */
14532
15631
  200: {
@@ -14538,7 +15637,7 @@ export interface operations {
14538
15637
  [name: string]: unknown;
14539
15638
  };
14540
15639
  content: {
14541
- "application/json": components["schemas"]["TraverseResponse"];
15640
+ "application/json": components["schemas"]["IndexDeltaResponse"];
14542
15641
  };
14543
15642
  };
14544
15643
  /** @description Bad request */
@@ -14647,21 +15746,25 @@ export interface operations {
14647
15746
  };
14648
15747
  };
14649
15748
  };
14650
- get_v1_graphs: {
15749
+ post_v1_index_gc: {
14651
15750
  parameters: {
14652
15751
  query?: {
14653
15752
  /** @description Graph name (default `main`) */
14654
15753
  graph?: string;
14655
15754
  /** @description Branch name (default `main`) */
14656
15755
  branch?: string;
14657
- /** @description Max rows */
14658
- limit?: string;
14659
- /** @description Opaque cursor from the previous page */
14660
- cursor?: string;
15756
+ /** @description Number of newest runs to keep */
15757
+ keep_runs?: string;
15758
+ /** @description Retain runs within this many commits of head so in-flight searches are not collected mid-read */
15759
+ reader_grace_commits?: string;
15760
+ /** @description Report without deleting */
15761
+ dry_run?: string;
14661
15762
  };
14662
15763
  header?: {
14663
15764
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
14664
15765
  "Lbb-Version"?: string;
15766
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
15767
+ "Idempotency-Key"?: string;
14665
15768
  };
14666
15769
  path?: never;
14667
15770
  cookie?: never;
@@ -14678,7 +15781,7 @@ export interface operations {
14678
15781
  [name: string]: unknown;
14679
15782
  };
14680
15783
  content: {
14681
- "application/json": components["schemas"]["GraphListResponse"];
15784
+ "application/json": components["schemas"]["IndexGcResponse"];
14682
15785
  };
14683
15786
  };
14684
15787
  /** @description Bad request */
@@ -14787,15 +15890,15 @@ export interface operations {
14787
15890
  };
14788
15891
  };
14789
15892
  };
14790
- get_v1_index: {
15893
+ get_v1_index_gc_jobs: {
14791
15894
  parameters: {
14792
15895
  query?: {
14793
15896
  /** @description Graph name (default `main`) */
14794
15897
  graph?: string;
14795
15898
  /** @description Branch name (default `main`) */
14796
15899
  branch?: string;
14797
- /** @description Index source: persisted or ephemeral */
14798
- source?: string;
15900
+ /** @description Stable id returned by the submit call */
15901
+ job_id?: string;
14799
15902
  };
14800
15903
  header?: {
14801
15904
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -14816,7 +15919,7 @@ export interface operations {
14816
15919
  [name: string]: unknown;
14817
15920
  };
14818
15921
  content: {
14819
- "application/json": components["schemas"]["EmbeddingIndexInspectResponse"];
15922
+ "application/json": components["schemas"]["IndexGcJobStatusResponse"];
14820
15923
  };
14821
15924
  };
14822
15925
  /** @description Bad request */
@@ -14925,15 +16028,13 @@ export interface operations {
14925
16028
  };
14926
16029
  };
14927
16030
  };
14928
- post_v1_index_build: {
16031
+ post_v1_index_gc_jobs: {
14929
16032
  parameters: {
14930
16033
  query?: {
14931
16034
  /** @description Graph name (default `main`) */
14932
16035
  graph?: string;
14933
16036
  /** @description Branch name (default `main`) */
14934
16037
  branch?: string;
14935
- /** @description Run the build detached and return immediately; poll /v1/graph/metadata for completion */
14936
- background?: string;
14937
16038
  };
14938
16039
  header?: {
14939
16040
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -14946,7 +16047,7 @@ export interface operations {
14946
16047
  };
14947
16048
  requestBody: {
14948
16049
  content: {
14949
- "application/json": components["schemas"]["IndexBuildOptions"];
16050
+ "application/json": components["schemas"]["IndexGcRequest"];
14950
16051
  };
14951
16052
  };
14952
16053
  responses: {
@@ -14960,7 +16061,7 @@ export interface operations {
14960
16061
  [name: string]: unknown;
14961
16062
  };
14962
16063
  content: {
14963
- "application/json": Record<string, never>;
16064
+ "application/json": components["schemas"]["IndexGcJobStatusResponse"];
14964
16065
  };
14965
16066
  };
14966
16067
  /** @description Bad request */
@@ -15069,13 +16170,15 @@ export interface operations {
15069
16170
  };
15070
16171
  };
15071
16172
  };
15072
- post_v1_index_delta: {
16173
+ delete_v1_index_gc_jobs: {
15073
16174
  parameters: {
15074
16175
  query?: {
15075
16176
  /** @description Graph name (default `main`) */
15076
16177
  graph?: string;
15077
16178
  /** @description Branch name (default `main`) */
15078
16179
  branch?: string;
16180
+ /** @description Stable id returned by the submit call */
16181
+ job_id?: string;
15079
16182
  };
15080
16183
  header?: {
15081
16184
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -15098,7 +16201,7 @@ export interface operations {
15098
16201
  [name: string]: unknown;
15099
16202
  };
15100
16203
  content: {
15101
- "application/json": components["schemas"]["IndexDeltaResponse"];
16204
+ "application/json": components["schemas"]["IndexGcJobStatusResponse"];
15102
16205
  };
15103
16206
  };
15104
16207
  /** @description Bad request */
@@ -15207,25 +16310,19 @@ export interface operations {
15207
16310
  };
15208
16311
  };
15209
16312
  };
15210
- post_v1_index_gc: {
16313
+ get_v1_index_jobs: {
15211
16314
  parameters: {
15212
16315
  query?: {
15213
16316
  /** @description Graph name (default `main`) */
15214
16317
  graph?: string;
15215
16318
  /** @description Branch name (default `main`) */
15216
16319
  branch?: string;
15217
- /** @description Number of newest runs to keep */
15218
- keep_runs?: string;
15219
- /** @description Retain runs within this many commits of head so in-flight searches are not collected mid-read */
15220
- reader_grace_commits?: string;
15221
- /** @description Report without deleting */
15222
- dry_run?: string;
16320
+ /** @description Stable id returned by the submit call */
16321
+ job_id?: string;
15223
16322
  };
15224
16323
  header?: {
15225
16324
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
15226
16325
  "Lbb-Version"?: string;
15227
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
15228
- "Idempotency-Key"?: string;
15229
16326
  };
15230
16327
  path?: never;
15231
16328
  cookie?: never;
@@ -15242,7 +16339,7 @@ export interface operations {
15242
16339
  [name: string]: unknown;
15243
16340
  };
15244
16341
  content: {
15245
- "application/json": components["schemas"]["IndexGcResponse"];
16342
+ "application/json": components["schemas"]["SearchIndexJobStatusResponse"];
15246
16343
  };
15247
16344
  };
15248
16345
  /** @description Bad request */
@@ -15351,24 +16448,28 @@ export interface operations {
15351
16448
  };
15352
16449
  };
15353
16450
  };
15354
- get_v1_index_jobs: {
16451
+ post_v1_index_jobs: {
15355
16452
  parameters: {
15356
16453
  query?: {
15357
16454
  /** @description Graph name (default `main`) */
15358
16455
  graph?: string;
15359
16456
  /** @description Branch name (default `main`) */
15360
16457
  branch?: string;
15361
- /** @description Stable id returned by the submit call */
15362
- job_id?: string;
15363
16458
  };
15364
16459
  header?: {
15365
16460
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
15366
16461
  "Lbb-Version"?: string;
16462
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
16463
+ "Idempotency-Key"?: string;
15367
16464
  };
15368
16465
  path?: never;
15369
16466
  cookie?: never;
15370
16467
  };
15371
- requestBody?: never;
16468
+ requestBody: {
16469
+ content: {
16470
+ "application/json": components["schemas"]["IndexBuildOptions"];
16471
+ };
16472
+ };
15372
16473
  responses: {
15373
16474
  /** @description OK */
15374
16475
  200: {
@@ -15489,13 +16590,15 @@ export interface operations {
15489
16590
  };
15490
16591
  };
15491
16592
  };
15492
- post_v1_index_jobs: {
16593
+ delete_v1_index_jobs: {
15493
16594
  parameters: {
15494
16595
  query?: {
15495
16596
  /** @description Graph name (default `main`) */
15496
16597
  graph?: string;
15497
16598
  /** @description Branch name (default `main`) */
15498
16599
  branch?: string;
16600
+ /** @description Stable id returned by the submit call */
16601
+ job_id?: string;
15499
16602
  };
15500
16603
  header?: {
15501
16604
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -15506,11 +16609,7 @@ export interface operations {
15506
16609
  path?: never;
15507
16610
  cookie?: never;
15508
16611
  };
15509
- requestBody: {
15510
- content: {
15511
- "application/json": components["schemas"]["IndexBuildOptions"];
15512
- };
15513
- };
16612
+ requestBody?: never;
15514
16613
  responses: {
15515
16614
  /** @description OK */
15516
16615
  200: {