@littlebigbrain/client 0.5.2 → 0.6.1

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;
@@ -2505,6 +2543,13 @@ export interface components {
2505
2543
  CommitResponse: {
2506
2544
  commit_seq: components["schemas"]["CommitSeq"];
2507
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;
2508
2553
  edge_event_ids: components["schemas"]["EdgeEventId"][];
2509
2554
  entity_ids: components["schemas"]["EntityId"][];
2510
2555
  idempotent_replay: boolean;
@@ -2513,6 +2558,15 @@ export interface components {
2513
2558
  observation_ids: components["schemas"]["ObservationId"][];
2514
2559
  schema_validation?: null | components["schemas"]["SchemaAuditReport"];
2515
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;
2516
2570
  visibility_token: string;
2517
2571
  /**
2518
2572
  * @description Property fields actually written by this commit, per entity (canonical
@@ -3485,6 +3539,14 @@ export interface components {
3485
3539
  parent: components["schemas"]["BranchParentView"];
3486
3540
  snapshot: components["schemas"]["SnapshotView"];
3487
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
+ };
3488
3550
  /**
3489
3551
  * @description `POST /v1/graph/branch/merge` — replay a child branch's commits onto its
3490
3552
  * fork parent (the branch named by the request URL) as one new commit batch.
@@ -3631,6 +3693,12 @@ export interface components {
3631
3693
  GraphCommitResponse: {
3632
3694
  commit: components["schemas"]["CommitResponse"];
3633
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;
3634
3702
  edges_written: number;
3635
3703
  entities_written: number;
3636
3704
  graph_created: boolean;
@@ -3642,6 +3710,14 @@ export interface components {
3642
3710
  * envelope before deciding whether anything new was written.
3643
3711
  */
3644
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;
3645
3721
  visibility_token: string;
3646
3722
  /**
3647
3723
  * @description Top-level echo of property fields actually written by this request.
@@ -3649,6 +3725,15 @@ export interface components {
3649
3725
  */
3650
3726
  written_properties?: components["schemas"]["EntityFieldsWritten"][];
3651
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
+ };
3652
3737
  GraphEdgeRow: {
3653
3738
  /** Format: float */
3654
3739
  confidence: number;
@@ -3762,10 +3847,7 @@ export interface components {
3762
3847
  graph_id: components["schemas"]["GraphId"];
3763
3848
  tenant_id: components["schemas"]["TenantId"];
3764
3849
  };
3765
- /**
3766
- * @description The graphs that exist under a tenant (one stack's tenant in SaaS mode),
3767
- * enumerated by a bounded child-prefix listing of the object store.
3768
- */
3850
+ /** @description The live, head-backed graphs under a tenant (one stack in SaaS mode). */
3769
3851
  GraphListResponse: {
3770
3852
  data: components["schemas"]["GraphSummary"][];
3771
3853
  has_more: boolean;
@@ -4102,6 +4184,38 @@ export interface components {
4102
4184
  snapshot: components["schemas"]["SnapshotView"];
4103
4185
  to_commit_seq: components["schemas"]["CommitSeq"];
4104
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
+ };
4105
4219
  IndexGcRequest: {
4106
4220
  /** @description Report what would be deleted without deleting anything. */
4107
4221
  dry_run?: boolean;
@@ -4137,6 +4251,9 @@ export interface components {
4137
4251
  dry_run: boolean;
4138
4252
  kept_runs: number;
4139
4253
  runs: components["schemas"]["IndexRunView"][];
4254
+ /** Format: int64 */
4255
+ scanned_bytes: number;
4256
+ scanned_objects: number;
4140
4257
  /**
4141
4258
  * @description Set when deletion was skipped because other branches may share this
4142
4259
  * branch's index runs and `include_branch_shared` was false.
@@ -4323,6 +4440,7 @@ export interface components {
4323
4440
  metric: components["schemas"]["VectorMetric"];
4324
4441
  model_id: string;
4325
4442
  run_id?: string | null;
4443
+ service: components["schemas"]["ManagedEmbeddingService"];
4326
4444
  source: components["schemas"]["ManagedEmbeddingSource"];
4327
4445
  /** Format: int64 */
4328
4446
  version: number;
@@ -4331,17 +4449,39 @@ export interface components {
4331
4449
  ManagedEmbeddingConfigRequest: {
4332
4450
  auto_embed_query?: boolean | null;
4333
4451
  base_model?: string | null;
4334
- /** Format: int32 */
4335
- 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;
4336
4458
  metric?: null | components["schemas"]["VectorMetric"];
4337
4459
  model_id: string;
4338
4460
  run_id?: string | null;
4461
+ service?: null | components["schemas"]["ManagedEmbeddingService"];
4339
4462
  source?: null | components["schemas"]["ManagedEmbeddingSource"];
4340
4463
  };
4341
4464
  /** @description Read/set response. Legacy hash-derived graphs return `configured=false` and no config. */
4342
4465
  ManagedEmbeddingConfigResponse: {
4343
4466
  config?: null | components["schemas"]["ManagedEmbeddingConfig"];
4344
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"];
4345
4485
  };
4346
4486
  /** @description Response after promoting a finished training run to the graph default. */
4347
4487
  ManagedEmbeddingPromoteResponse: {
@@ -4360,6 +4500,11 @@ export interface components {
4360
4500
  /** Format: double */
4361
4501
  trained_ndcg: number;
4362
4502
  };
4503
+ /**
4504
+ * @description Service used to generate managed corpus and query embeddings.
4505
+ * @enum {string}
4506
+ */
4507
+ ManagedEmbeddingService: "modal" | "open_router";
4363
4508
  /**
4364
4509
  * @description Where a managed embedding model came from.
4365
4510
  * @enum {string}
@@ -6371,7 +6516,7 @@ export interface components {
6371
6516
  job_id: string;
6372
6517
  result?: null | components["schemas"]["SearchIndexRunResponse"];
6373
6518
  stage?: string | null;
6374
- /** @description `pending` | `running` | `succeeded` | `failed`. */
6519
+ /** @description `pending` | `running` | `succeeded` | `failed` | `cancelled`. */
6375
6520
  status: string;
6376
6521
  terminal_error?: string | null;
6377
6522
  /** Format: int64 */
@@ -9651,6 +9796,146 @@ export interface operations {
9651
9796
  };
9652
9797
  };
9653
9798
  };
9799
+ delete_v1_graph_branch: {
9800
+ parameters: {
9801
+ query?: {
9802
+ /** @description Graph name (default `main`) */
9803
+ graph?: string;
9804
+ /** @description Branch name (default `main`) */
9805
+ branch?: string;
9806
+ /** @description Must equal the target branch id */
9807
+ confirm?: string;
9808
+ };
9809
+ header?: {
9810
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
9811
+ "Lbb-Version"?: string;
9812
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
9813
+ "Idempotency-Key"?: string;
9814
+ };
9815
+ path?: never;
9816
+ cookie?: never;
9817
+ };
9818
+ requestBody?: never;
9819
+ responses: {
9820
+ /** @description OK */
9821
+ 200: {
9822
+ headers: {
9823
+ /** @description API contract version used for the response */
9824
+ "Lbb-Version"?: string;
9825
+ /** @description Request correlation id */
9826
+ "X-Request-Id"?: string;
9827
+ [name: string]: unknown;
9828
+ };
9829
+ content: {
9830
+ "application/json": components["schemas"]["GraphBranchDeleteResponse"];
9831
+ };
9832
+ };
9833
+ /** @description Bad request */
9834
+ 400: {
9835
+ headers: {
9836
+ /** @description API contract version used for the response */
9837
+ "Lbb-Version"?: string;
9838
+ /** @description Request correlation id */
9839
+ "X-Request-Id"?: string;
9840
+ [name: string]: unknown;
9841
+ };
9842
+ content: {
9843
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
9844
+ };
9845
+ };
9846
+ /** @description Unauthorized */
9847
+ 401: {
9848
+ headers: {
9849
+ /** @description API contract version used for the response */
9850
+ "Lbb-Version"?: string;
9851
+ /** @description Request correlation id */
9852
+ "X-Request-Id"?: string;
9853
+ [name: string]: unknown;
9854
+ };
9855
+ content: {
9856
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
9857
+ };
9858
+ };
9859
+ /** @description Forbidden */
9860
+ 403: {
9861
+ headers: {
9862
+ /** @description API contract version used for the response */
9863
+ "Lbb-Version"?: string;
9864
+ /** @description Request correlation id */
9865
+ "X-Request-Id"?: string;
9866
+ [name: string]: unknown;
9867
+ };
9868
+ content: {
9869
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
9870
+ };
9871
+ };
9872
+ /** @description Not found */
9873
+ 404: {
9874
+ headers: {
9875
+ /** @description API contract version used for the response */
9876
+ "Lbb-Version"?: string;
9877
+ /** @description Request correlation id */
9878
+ "X-Request-Id"?: string;
9879
+ [name: string]: unknown;
9880
+ };
9881
+ content: {
9882
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
9883
+ };
9884
+ };
9885
+ /** @description Conflict */
9886
+ 409: {
9887
+ headers: {
9888
+ /** @description API contract version used for the response */
9889
+ "Lbb-Version"?: string;
9890
+ /** @description Request correlation id */
9891
+ "X-Request-Id"?: string;
9892
+ [name: string]: unknown;
9893
+ };
9894
+ content: {
9895
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
9896
+ };
9897
+ };
9898
+ /** @description Rate limit exceeded */
9899
+ 429: {
9900
+ headers: {
9901
+ /** @description API contract version used for the response */
9902
+ "Lbb-Version"?: string;
9903
+ /** @description Request correlation id */
9904
+ "X-Request-Id"?: string;
9905
+ [name: string]: unknown;
9906
+ };
9907
+ content: {
9908
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
9909
+ };
9910
+ };
9911
+ /** @description Internal server error */
9912
+ 500: {
9913
+ headers: {
9914
+ /** @description API contract version used for the response */
9915
+ "Lbb-Version"?: string;
9916
+ /** @description Request correlation id */
9917
+ "X-Request-Id"?: string;
9918
+ [name: string]: unknown;
9919
+ };
9920
+ content: {
9921
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
9922
+ };
9923
+ };
9924
+ /** @description Service unavailable */
9925
+ 503: {
9926
+ headers: {
9927
+ /** @description API contract version used for the response */
9928
+ "Lbb-Version"?: string;
9929
+ /** @description Request correlation id */
9930
+ "X-Request-Id"?: string;
9931
+ [name: string]: unknown;
9932
+ };
9933
+ content: {
9934
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
9935
+ };
9936
+ };
9937
+ };
9938
+ };
9654
9939
  post_v1_graph_branch_merge: {
9655
9940
  parameters: {
9656
9941
  query?: {
@@ -10524,7 +10809,7 @@ export interface operations {
10524
10809
  [name: string]: unknown;
10525
10810
  };
10526
10811
  content: {
10527
- "application/json": Record<string, never>;
10812
+ "application/json": components["schemas"]["GraphDeleteResponse"];
10528
10813
  };
10529
10814
  };
10530
10815
  /** @description Bad request */
@@ -11623,23 +11908,17 @@ export interface operations {
11623
11908
  };
11624
11909
  };
11625
11910
  };
11626
- post_v1_graph_embedding_promote: {
11911
+ get_v1_graph_embedding_models: {
11627
11912
  parameters: {
11628
11913
  query?: {
11629
11914
  /** @description Graph name (default `main`) */
11630
11915
  graph?: string;
11631
11916
  /** @description Branch name (default `main`) */
11632
11917
  branch?: string;
11633
- /** @description Finished training run identifier */
11634
- run_id?: string;
11635
- /** @description Allow promotion when evaluation quality regressed */
11636
- allow_regression?: string;
11637
11918
  };
11638
11919
  header?: {
11639
11920
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
11640
11921
  "Lbb-Version"?: string;
11641
- /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
11642
- "Idempotency-Key"?: string;
11643
11922
  };
11644
11923
  path?: never;
11645
11924
  cookie?: never;
@@ -11656,7 +11935,7 @@ export interface operations {
11656
11935
  [name: string]: unknown;
11657
11936
  };
11658
11937
  content: {
11659
- "application/json": components["schemas"]["ManagedEmbeddingPromoteResponse"];
11938
+ "application/json": components["schemas"]["ManagedEmbeddingModelsResponse"];
11660
11939
  };
11661
11940
  };
11662
11941
  /** @description Bad request */
@@ -11765,29 +12044,23 @@ export interface operations {
11765
12044
  };
11766
12045
  };
11767
12046
  };
11768
- get_v1_graph_entities: {
12047
+ post_v1_graph_embedding_promote: {
11769
12048
  parameters: {
11770
12049
  query?: {
11771
12050
  /** @description Graph name (default `main`) */
11772
12051
  graph?: string;
11773
12052
  /** @description Branch name (default `main`) */
11774
12053
  branch?: string;
11775
- /** @description Search text */
11776
- q?: string;
11777
- /** @description Entity type filter */
11778
- type?: string;
11779
- /** @description Max rows */
11780
- limit?: string;
11781
- /** @description Opaque cursor from the previous page */
11782
- cursor?: string;
11783
- /** @description Comma-separated property names to inline on each row (typed, native JSON); `*` for all. Omit for the lean default row. */
11784
- fields?: string;
11785
- /** @description Comma-separated entity ids to fetch in one call (bulk lookup); bypasses the q/type browse filters. */
11786
- ids?: string;
12054
+ /** @description Finished training run identifier */
12055
+ run_id?: string;
12056
+ /** @description Allow promotion when evaluation quality regressed */
12057
+ allow_regression?: string;
11787
12058
  };
11788
12059
  header?: {
11789
12060
  /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
11790
12061
  "Lbb-Version"?: string;
12062
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
12063
+ "Idempotency-Key"?: string;
11791
12064
  };
11792
12065
  path?: never;
11793
12066
  cookie?: never;
@@ -11804,7 +12077,155 @@ export interface operations {
11804
12077
  [name: string]: unknown;
11805
12078
  };
11806
12079
  content: {
11807
- "application/json": Record<string, never>;
12080
+ "application/json": components["schemas"]["ManagedEmbeddingPromoteResponse"];
12081
+ };
12082
+ };
12083
+ /** @description Bad request */
12084
+ 400: {
12085
+ headers: {
12086
+ /** @description API contract version used for the response */
12087
+ "Lbb-Version"?: string;
12088
+ /** @description Request correlation id */
12089
+ "X-Request-Id"?: string;
12090
+ [name: string]: unknown;
12091
+ };
12092
+ content: {
12093
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
12094
+ };
12095
+ };
12096
+ /** @description Unauthorized */
12097
+ 401: {
12098
+ headers: {
12099
+ /** @description API contract version used for the response */
12100
+ "Lbb-Version"?: string;
12101
+ /** @description Request correlation id */
12102
+ "X-Request-Id"?: string;
12103
+ [name: string]: unknown;
12104
+ };
12105
+ content: {
12106
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
12107
+ };
12108
+ };
12109
+ /** @description Forbidden */
12110
+ 403: {
12111
+ headers: {
12112
+ /** @description API contract version used for the response */
12113
+ "Lbb-Version"?: string;
12114
+ /** @description Request correlation id */
12115
+ "X-Request-Id"?: string;
12116
+ [name: string]: unknown;
12117
+ };
12118
+ content: {
12119
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
12120
+ };
12121
+ };
12122
+ /** @description Not found */
12123
+ 404: {
12124
+ headers: {
12125
+ /** @description API contract version used for the response */
12126
+ "Lbb-Version"?: string;
12127
+ /** @description Request correlation id */
12128
+ "X-Request-Id"?: string;
12129
+ [name: string]: unknown;
12130
+ };
12131
+ content: {
12132
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
12133
+ };
12134
+ };
12135
+ /** @description Conflict */
12136
+ 409: {
12137
+ headers: {
12138
+ /** @description API contract version used for the response */
12139
+ "Lbb-Version"?: string;
12140
+ /** @description Request correlation id */
12141
+ "X-Request-Id"?: string;
12142
+ [name: string]: unknown;
12143
+ };
12144
+ content: {
12145
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
12146
+ };
12147
+ };
12148
+ /** @description Rate limit exceeded */
12149
+ 429: {
12150
+ headers: {
12151
+ /** @description API contract version used for the response */
12152
+ "Lbb-Version"?: string;
12153
+ /** @description Request correlation id */
12154
+ "X-Request-Id"?: string;
12155
+ [name: string]: unknown;
12156
+ };
12157
+ content: {
12158
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
12159
+ };
12160
+ };
12161
+ /** @description Internal server error */
12162
+ 500: {
12163
+ headers: {
12164
+ /** @description API contract version used for the response */
12165
+ "Lbb-Version"?: string;
12166
+ /** @description Request correlation id */
12167
+ "X-Request-Id"?: string;
12168
+ [name: string]: unknown;
12169
+ };
12170
+ content: {
12171
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
12172
+ };
12173
+ };
12174
+ /** @description Service unavailable */
12175
+ 503: {
12176
+ headers: {
12177
+ /** @description API contract version used for the response */
12178
+ "Lbb-Version"?: string;
12179
+ /** @description Request correlation id */
12180
+ "X-Request-Id"?: string;
12181
+ [name: string]: unknown;
12182
+ };
12183
+ content: {
12184
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
12185
+ };
12186
+ };
12187
+ };
12188
+ };
12189
+ get_v1_graph_entities: {
12190
+ parameters: {
12191
+ query?: {
12192
+ /** @description Graph name (default `main`) */
12193
+ graph?: string;
12194
+ /** @description Branch name (default `main`) */
12195
+ branch?: string;
12196
+ /** @description Search text */
12197
+ q?: string;
12198
+ /** @description Entity type filter */
12199
+ type?: 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;
12208
+ };
12209
+ header?: {
12210
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
12211
+ "Lbb-Version"?: string;
12212
+ };
12213
+ path?: never;
12214
+ cookie?: never;
12215
+ };
12216
+ requestBody?: never;
12217
+ responses: {
12218
+ /** @description OK */
12219
+ 200: {
12220
+ headers: {
12221
+ /** @description API contract version used for the response */
12222
+ "Lbb-Version"?: string;
12223
+ /** @description Request correlation id */
12224
+ "X-Request-Id"?: string;
12225
+ [name: string]: unknown;
12226
+ };
12227
+ content: {
12228
+ "application/json": Record<string, never>;
11808
12229
  };
11809
12230
  };
11810
12231
  /** @description Bad request */
@@ -15469,7 +15890,7 @@ export interface operations {
15469
15890
  };
15470
15891
  };
15471
15892
  };
15472
- get_v1_index_jobs: {
15893
+ get_v1_index_gc_jobs: {
15473
15894
  parameters: {
15474
15895
  query?: {
15475
15896
  /** @description Graph name (default `main`) */
@@ -15498,7 +15919,7 @@ export interface operations {
15498
15919
  [name: string]: unknown;
15499
15920
  };
15500
15921
  content: {
15501
- "application/json": components["schemas"]["SearchIndexJobStatusResponse"];
15922
+ "application/json": components["schemas"]["IndexGcJobStatusResponse"];
15502
15923
  };
15503
15924
  };
15504
15925
  /** @description Bad request */
@@ -15607,7 +16028,7 @@ export interface operations {
15607
16028
  };
15608
16029
  };
15609
16030
  };
15610
- post_v1_index_jobs: {
16031
+ post_v1_index_gc_jobs: {
15611
16032
  parameters: {
15612
16033
  query?: {
15613
16034
  /** @description Graph name (default `main`) */
@@ -15626,9 +16047,569 @@ export interface operations {
15626
16047
  };
15627
16048
  requestBody: {
15628
16049
  content: {
15629
- "application/json": components["schemas"]["IndexBuildOptions"];
16050
+ "application/json": components["schemas"]["IndexGcRequest"];
15630
16051
  };
15631
16052
  };
16053
+ responses: {
16054
+ /** @description OK */
16055
+ 200: {
16056
+ headers: {
16057
+ /** @description API contract version used for the response */
16058
+ "Lbb-Version"?: string;
16059
+ /** @description Request correlation id */
16060
+ "X-Request-Id"?: string;
16061
+ [name: string]: unknown;
16062
+ };
16063
+ content: {
16064
+ "application/json": components["schemas"]["IndexGcJobStatusResponse"];
16065
+ };
16066
+ };
16067
+ /** @description Bad request */
16068
+ 400: {
16069
+ headers: {
16070
+ /** @description API contract version used for the response */
16071
+ "Lbb-Version"?: string;
16072
+ /** @description Request correlation id */
16073
+ "X-Request-Id"?: string;
16074
+ [name: string]: unknown;
16075
+ };
16076
+ content: {
16077
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16078
+ };
16079
+ };
16080
+ /** @description Unauthorized */
16081
+ 401: {
16082
+ headers: {
16083
+ /** @description API contract version used for the response */
16084
+ "Lbb-Version"?: string;
16085
+ /** @description Request correlation id */
16086
+ "X-Request-Id"?: string;
16087
+ [name: string]: unknown;
16088
+ };
16089
+ content: {
16090
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16091
+ };
16092
+ };
16093
+ /** @description Forbidden */
16094
+ 403: {
16095
+ headers: {
16096
+ /** @description API contract version used for the response */
16097
+ "Lbb-Version"?: string;
16098
+ /** @description Request correlation id */
16099
+ "X-Request-Id"?: string;
16100
+ [name: string]: unknown;
16101
+ };
16102
+ content: {
16103
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16104
+ };
16105
+ };
16106
+ /** @description Not found */
16107
+ 404: {
16108
+ headers: {
16109
+ /** @description API contract version used for the response */
16110
+ "Lbb-Version"?: string;
16111
+ /** @description Request correlation id */
16112
+ "X-Request-Id"?: string;
16113
+ [name: string]: unknown;
16114
+ };
16115
+ content: {
16116
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16117
+ };
16118
+ };
16119
+ /** @description Conflict */
16120
+ 409: {
16121
+ headers: {
16122
+ /** @description API contract version used for the response */
16123
+ "Lbb-Version"?: string;
16124
+ /** @description Request correlation id */
16125
+ "X-Request-Id"?: string;
16126
+ [name: string]: unknown;
16127
+ };
16128
+ content: {
16129
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16130
+ };
16131
+ };
16132
+ /** @description Rate limit exceeded */
16133
+ 429: {
16134
+ headers: {
16135
+ /** @description API contract version used for the response */
16136
+ "Lbb-Version"?: string;
16137
+ /** @description Request correlation id */
16138
+ "X-Request-Id"?: string;
16139
+ [name: string]: unknown;
16140
+ };
16141
+ content: {
16142
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16143
+ };
16144
+ };
16145
+ /** @description Internal server error */
16146
+ 500: {
16147
+ headers: {
16148
+ /** @description API contract version used for the response */
16149
+ "Lbb-Version"?: string;
16150
+ /** @description Request correlation id */
16151
+ "X-Request-Id"?: string;
16152
+ [name: string]: unknown;
16153
+ };
16154
+ content: {
16155
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16156
+ };
16157
+ };
16158
+ /** @description Service unavailable */
16159
+ 503: {
16160
+ headers: {
16161
+ /** @description API contract version used for the response */
16162
+ "Lbb-Version"?: string;
16163
+ /** @description Request correlation id */
16164
+ "X-Request-Id"?: string;
16165
+ [name: string]: unknown;
16166
+ };
16167
+ content: {
16168
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16169
+ };
16170
+ };
16171
+ };
16172
+ };
16173
+ delete_v1_index_gc_jobs: {
16174
+ parameters: {
16175
+ query?: {
16176
+ /** @description Graph name (default `main`) */
16177
+ graph?: string;
16178
+ /** @description Branch name (default `main`) */
16179
+ branch?: string;
16180
+ /** @description Stable id returned by the submit call */
16181
+ job_id?: string;
16182
+ };
16183
+ header?: {
16184
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
16185
+ "Lbb-Version"?: string;
16186
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
16187
+ "Idempotency-Key"?: string;
16188
+ };
16189
+ path?: never;
16190
+ cookie?: never;
16191
+ };
16192
+ requestBody?: never;
16193
+ responses: {
16194
+ /** @description OK */
16195
+ 200: {
16196
+ headers: {
16197
+ /** @description API contract version used for the response */
16198
+ "Lbb-Version"?: string;
16199
+ /** @description Request correlation id */
16200
+ "X-Request-Id"?: string;
16201
+ [name: string]: unknown;
16202
+ };
16203
+ content: {
16204
+ "application/json": components["schemas"]["IndexGcJobStatusResponse"];
16205
+ };
16206
+ };
16207
+ /** @description Bad request */
16208
+ 400: {
16209
+ headers: {
16210
+ /** @description API contract version used for the response */
16211
+ "Lbb-Version"?: string;
16212
+ /** @description Request correlation id */
16213
+ "X-Request-Id"?: string;
16214
+ [name: string]: unknown;
16215
+ };
16216
+ content: {
16217
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16218
+ };
16219
+ };
16220
+ /** @description Unauthorized */
16221
+ 401: {
16222
+ headers: {
16223
+ /** @description API contract version used for the response */
16224
+ "Lbb-Version"?: string;
16225
+ /** @description Request correlation id */
16226
+ "X-Request-Id"?: string;
16227
+ [name: string]: unknown;
16228
+ };
16229
+ content: {
16230
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16231
+ };
16232
+ };
16233
+ /** @description Forbidden */
16234
+ 403: {
16235
+ headers: {
16236
+ /** @description API contract version used for the response */
16237
+ "Lbb-Version"?: string;
16238
+ /** @description Request correlation id */
16239
+ "X-Request-Id"?: string;
16240
+ [name: string]: unknown;
16241
+ };
16242
+ content: {
16243
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16244
+ };
16245
+ };
16246
+ /** @description Not found */
16247
+ 404: {
16248
+ headers: {
16249
+ /** @description API contract version used for the response */
16250
+ "Lbb-Version"?: string;
16251
+ /** @description Request correlation id */
16252
+ "X-Request-Id"?: string;
16253
+ [name: string]: unknown;
16254
+ };
16255
+ content: {
16256
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16257
+ };
16258
+ };
16259
+ /** @description Conflict */
16260
+ 409: {
16261
+ headers: {
16262
+ /** @description API contract version used for the response */
16263
+ "Lbb-Version"?: string;
16264
+ /** @description Request correlation id */
16265
+ "X-Request-Id"?: string;
16266
+ [name: string]: unknown;
16267
+ };
16268
+ content: {
16269
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16270
+ };
16271
+ };
16272
+ /** @description Rate limit exceeded */
16273
+ 429: {
16274
+ headers: {
16275
+ /** @description API contract version used for the response */
16276
+ "Lbb-Version"?: string;
16277
+ /** @description Request correlation id */
16278
+ "X-Request-Id"?: string;
16279
+ [name: string]: unknown;
16280
+ };
16281
+ content: {
16282
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16283
+ };
16284
+ };
16285
+ /** @description Internal server error */
16286
+ 500: {
16287
+ headers: {
16288
+ /** @description API contract version used for the response */
16289
+ "Lbb-Version"?: string;
16290
+ /** @description Request correlation id */
16291
+ "X-Request-Id"?: string;
16292
+ [name: string]: unknown;
16293
+ };
16294
+ content: {
16295
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16296
+ };
16297
+ };
16298
+ /** @description Service unavailable */
16299
+ 503: {
16300
+ headers: {
16301
+ /** @description API contract version used for the response */
16302
+ "Lbb-Version"?: string;
16303
+ /** @description Request correlation id */
16304
+ "X-Request-Id"?: string;
16305
+ [name: string]: unknown;
16306
+ };
16307
+ content: {
16308
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16309
+ };
16310
+ };
16311
+ };
16312
+ };
16313
+ get_v1_index_jobs: {
16314
+ parameters: {
16315
+ query?: {
16316
+ /** @description Graph name (default `main`) */
16317
+ graph?: string;
16318
+ /** @description Branch name (default `main`) */
16319
+ branch?: string;
16320
+ /** @description Stable id returned by the submit call */
16321
+ job_id?: string;
16322
+ };
16323
+ header?: {
16324
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
16325
+ "Lbb-Version"?: string;
16326
+ };
16327
+ path?: never;
16328
+ cookie?: never;
16329
+ };
16330
+ requestBody?: never;
16331
+ responses: {
16332
+ /** @description OK */
16333
+ 200: {
16334
+ headers: {
16335
+ /** @description API contract version used for the response */
16336
+ "Lbb-Version"?: string;
16337
+ /** @description Request correlation id */
16338
+ "X-Request-Id"?: string;
16339
+ [name: string]: unknown;
16340
+ };
16341
+ content: {
16342
+ "application/json": components["schemas"]["SearchIndexJobStatusResponse"];
16343
+ };
16344
+ };
16345
+ /** @description Bad request */
16346
+ 400: {
16347
+ headers: {
16348
+ /** @description API contract version used for the response */
16349
+ "Lbb-Version"?: string;
16350
+ /** @description Request correlation id */
16351
+ "X-Request-Id"?: string;
16352
+ [name: string]: unknown;
16353
+ };
16354
+ content: {
16355
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16356
+ };
16357
+ };
16358
+ /** @description Unauthorized */
16359
+ 401: {
16360
+ headers: {
16361
+ /** @description API contract version used for the response */
16362
+ "Lbb-Version"?: string;
16363
+ /** @description Request correlation id */
16364
+ "X-Request-Id"?: string;
16365
+ [name: string]: unknown;
16366
+ };
16367
+ content: {
16368
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16369
+ };
16370
+ };
16371
+ /** @description Forbidden */
16372
+ 403: {
16373
+ headers: {
16374
+ /** @description API contract version used for the response */
16375
+ "Lbb-Version"?: string;
16376
+ /** @description Request correlation id */
16377
+ "X-Request-Id"?: string;
16378
+ [name: string]: unknown;
16379
+ };
16380
+ content: {
16381
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16382
+ };
16383
+ };
16384
+ /** @description Not found */
16385
+ 404: {
16386
+ headers: {
16387
+ /** @description API contract version used for the response */
16388
+ "Lbb-Version"?: string;
16389
+ /** @description Request correlation id */
16390
+ "X-Request-Id"?: string;
16391
+ [name: string]: unknown;
16392
+ };
16393
+ content: {
16394
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16395
+ };
16396
+ };
16397
+ /** @description Conflict */
16398
+ 409: {
16399
+ headers: {
16400
+ /** @description API contract version used for the response */
16401
+ "Lbb-Version"?: string;
16402
+ /** @description Request correlation id */
16403
+ "X-Request-Id"?: string;
16404
+ [name: string]: unknown;
16405
+ };
16406
+ content: {
16407
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16408
+ };
16409
+ };
16410
+ /** @description Rate limit exceeded */
16411
+ 429: {
16412
+ headers: {
16413
+ /** @description API contract version used for the response */
16414
+ "Lbb-Version"?: string;
16415
+ /** @description Request correlation id */
16416
+ "X-Request-Id"?: string;
16417
+ [name: string]: unknown;
16418
+ };
16419
+ content: {
16420
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16421
+ };
16422
+ };
16423
+ /** @description Internal server error */
16424
+ 500: {
16425
+ headers: {
16426
+ /** @description API contract version used for the response */
16427
+ "Lbb-Version"?: string;
16428
+ /** @description Request correlation id */
16429
+ "X-Request-Id"?: string;
16430
+ [name: string]: unknown;
16431
+ };
16432
+ content: {
16433
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16434
+ };
16435
+ };
16436
+ /** @description Service unavailable */
16437
+ 503: {
16438
+ headers: {
16439
+ /** @description API contract version used for the response */
16440
+ "Lbb-Version"?: string;
16441
+ /** @description Request correlation id */
16442
+ "X-Request-Id"?: string;
16443
+ [name: string]: unknown;
16444
+ };
16445
+ content: {
16446
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16447
+ };
16448
+ };
16449
+ };
16450
+ };
16451
+ post_v1_index_jobs: {
16452
+ parameters: {
16453
+ query?: {
16454
+ /** @description Graph name (default `main`) */
16455
+ graph?: string;
16456
+ /** @description Branch name (default `main`) */
16457
+ branch?: string;
16458
+ };
16459
+ header?: {
16460
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
16461
+ "Lbb-Version"?: string;
16462
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
16463
+ "Idempotency-Key"?: string;
16464
+ };
16465
+ path?: never;
16466
+ cookie?: never;
16467
+ };
16468
+ requestBody: {
16469
+ content: {
16470
+ "application/json": components["schemas"]["IndexBuildOptions"];
16471
+ };
16472
+ };
16473
+ responses: {
16474
+ /** @description OK */
16475
+ 200: {
16476
+ headers: {
16477
+ /** @description API contract version used for the response */
16478
+ "Lbb-Version"?: string;
16479
+ /** @description Request correlation id */
16480
+ "X-Request-Id"?: string;
16481
+ [name: string]: unknown;
16482
+ };
16483
+ content: {
16484
+ "application/json": components["schemas"]["SearchIndexJobStatusResponse"];
16485
+ };
16486
+ };
16487
+ /** @description Bad request */
16488
+ 400: {
16489
+ headers: {
16490
+ /** @description API contract version used for the response */
16491
+ "Lbb-Version"?: string;
16492
+ /** @description Request correlation id */
16493
+ "X-Request-Id"?: string;
16494
+ [name: string]: unknown;
16495
+ };
16496
+ content: {
16497
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16498
+ };
16499
+ };
16500
+ /** @description Unauthorized */
16501
+ 401: {
16502
+ headers: {
16503
+ /** @description API contract version used for the response */
16504
+ "Lbb-Version"?: string;
16505
+ /** @description Request correlation id */
16506
+ "X-Request-Id"?: string;
16507
+ [name: string]: unknown;
16508
+ };
16509
+ content: {
16510
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16511
+ };
16512
+ };
16513
+ /** @description Forbidden */
16514
+ 403: {
16515
+ headers: {
16516
+ /** @description API contract version used for the response */
16517
+ "Lbb-Version"?: string;
16518
+ /** @description Request correlation id */
16519
+ "X-Request-Id"?: string;
16520
+ [name: string]: unknown;
16521
+ };
16522
+ content: {
16523
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16524
+ };
16525
+ };
16526
+ /** @description Not found */
16527
+ 404: {
16528
+ headers: {
16529
+ /** @description API contract version used for the response */
16530
+ "Lbb-Version"?: string;
16531
+ /** @description Request correlation id */
16532
+ "X-Request-Id"?: string;
16533
+ [name: string]: unknown;
16534
+ };
16535
+ content: {
16536
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16537
+ };
16538
+ };
16539
+ /** @description Conflict */
16540
+ 409: {
16541
+ headers: {
16542
+ /** @description API contract version used for the response */
16543
+ "Lbb-Version"?: string;
16544
+ /** @description Request correlation id */
16545
+ "X-Request-Id"?: string;
16546
+ [name: string]: unknown;
16547
+ };
16548
+ content: {
16549
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16550
+ };
16551
+ };
16552
+ /** @description Rate limit exceeded */
16553
+ 429: {
16554
+ headers: {
16555
+ /** @description API contract version used for the response */
16556
+ "Lbb-Version"?: string;
16557
+ /** @description Request correlation id */
16558
+ "X-Request-Id"?: string;
16559
+ [name: string]: unknown;
16560
+ };
16561
+ content: {
16562
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16563
+ };
16564
+ };
16565
+ /** @description Internal server error */
16566
+ 500: {
16567
+ headers: {
16568
+ /** @description API contract version used for the response */
16569
+ "Lbb-Version"?: string;
16570
+ /** @description Request correlation id */
16571
+ "X-Request-Id"?: string;
16572
+ [name: string]: unknown;
16573
+ };
16574
+ content: {
16575
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16576
+ };
16577
+ };
16578
+ /** @description Service unavailable */
16579
+ 503: {
16580
+ headers: {
16581
+ /** @description API contract version used for the response */
16582
+ "Lbb-Version"?: string;
16583
+ /** @description Request correlation id */
16584
+ "X-Request-Id"?: string;
16585
+ [name: string]: unknown;
16586
+ };
16587
+ content: {
16588
+ "application/json": components["schemas"]["LbbErrorEnvelope"];
16589
+ };
16590
+ };
16591
+ };
16592
+ };
16593
+ delete_v1_index_jobs: {
16594
+ parameters: {
16595
+ query?: {
16596
+ /** @description Graph name (default `main`) */
16597
+ graph?: string;
16598
+ /** @description Branch name (default `main`) */
16599
+ branch?: string;
16600
+ /** @description Stable id returned by the submit call */
16601
+ job_id?: string;
16602
+ };
16603
+ header?: {
16604
+ /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
16605
+ "Lbb-Version"?: string;
16606
+ /** @description Stable client-generated key for safely retrying mutations and supervision writes. */
16607
+ "Idempotency-Key"?: string;
16608
+ };
16609
+ path?: never;
16610
+ cookie?: never;
16611
+ };
16612
+ requestBody?: never;
15632
16613
  responses: {
15633
16614
  /** @description OK */
15634
16615
  200: {