@madewithremy/admin 0.1.30 → 0.1.32

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/index.d.ts CHANGED
@@ -1177,12 +1177,11 @@ interface DataLiftFromLiveResult {
1177
1177
 
1178
1178
  interface LiftFromDevParams {
1179
1179
  /**
1180
- * Which dev session to lift from, by dev release id. An app has a dev session per workspace — one
1181
- * per person's box, one per person's CLI — so this is required once more than one is open. The
1182
- * server refuses rather than picking: promoting the wrong workspace's data over live is not
1183
- * recoverable, and nothing in the request would show it had happened.
1184
- *
1185
- * The ids are on the dashboard's `devSessions`, and the `ambiguous_dev_session` error lists them.
1180
+ * Which of YOUR dev sessions to lift from, by dev release id. An app has a dev session per
1181
+ * workspace (one per person's box, one per person's CLI), and a lift only ever touches the
1182
+ * caller's own: without this it takes your newest, and a colleague's id is refused
1183
+ * (`not_your_dev_session`). Name it when you have more than one open. The ids are on the
1184
+ * dashboard's `devSessions`.
1186
1185
  */
1187
1186
  releaseId?: string;
1188
1187
  }
@@ -1197,12 +1196,11 @@ interface LiftFromDevParams {
1197
1196
  *
1198
1197
  * @throws AdminApiError `no_dev_session` (404) — no dev release exists (start a dev session first);
1199
1198
  * `no_live_release` (404) — app has never been published (publish first, then lift);
1200
- * `ambiguous_dev_session` (400) — the app has several dev sessions open, so `releaseId` is
1201
- * required; the error message lists the open ones.
1199
+ * `not_your_dev_session` (403) — `releaseId` names someone else's dev session.
1202
1200
  * @example
1203
1201
  * const result = await admin.data.liftFromDev();
1204
1202
  * console.log(`Lifted ${result.databasesAffected.length} databases to live`);
1205
- * // With more than one dev session open, name the one you mean:
1203
+ * // With more than one of your dev sessions open, name the one you mean:
1206
1204
  * await admin.data.liftFromDev({ releaseId: '8f2c1e04-...' });
1207
1205
  */
1208
1206
  declare function liftFromDev(ctx: AdminContext, params?: LiftFromDevParams): Promise<DataLiftFromDevResult>;
@@ -1213,8 +1211,8 @@ interface LiftFromLiveParams {
1213
1211
  */
1214
1212
  truncate?: boolean;
1215
1213
  /**
1216
- * Which dev session to overwrite, by dev release id. Required once the app has more than one
1217
- * open — see `LiftFromDevParams.releaseId`.
1214
+ * Which of your dev sessions to overwrite, by dev release id; your newest when absent. See
1215
+ * `LiftFromDevParams.releaseId`.
1218
1216
  */
1219
1217
  releaseId?: string;
1220
1218
  }
@@ -1230,7 +1228,7 @@ interface LiftFromLiveParams {
1230
1228
  *
1231
1229
  * @throws AdminApiError `no_dev_session` (404) — no dev release exists (start a dev session first);
1232
1230
  * `no_live_release` (404) — no live release (copy mode only; not thrown when `truncate` is true);
1233
- * `ambiguous_dev_session` (400) — several dev sessions are open, so `releaseId` is required.
1231
+ * `not_your_dev_session` (403) — `releaseId` names someone else's dev session.
1234
1232
  * @example
1235
1233
  * // Pull live data into dev for debugging:
1236
1234
  * await admin.data.liftFromLive();
@@ -1295,7 +1293,8 @@ interface OperationProgress {
1295
1293
  * bucket the source is connected to (`datasources sync`); `remap` runs the
1296
1294
  * live mapper over the source's own raw copies (`datasources remap`); `replay`
1297
1295
  * runs an earlier job's quarantined objects through the current mapper
1298
- * (`datasources jobs replay`).
1296
+ * (`datasources jobs replay`); `reread` reads the source's built documents
1297
+ * again with its live reader (`datasources reread`).
1299
1298
  */
1300
1299
  type DataSourceJobSource = {
1301
1300
  type: 'store';
@@ -1321,6 +1320,12 @@ type DataSourceJobSource = {
1321
1320
  type: 'replay';
1322
1321
  fromJobId: string;
1323
1322
  kind: 'skip' | 'error' | null;
1323
+ } | {
1324
+ type: 'reread';
1325
+ /** Only the documents the reader has not read. */
1326
+ unread: boolean;
1327
+ /** Only documents matching this metadata filter. */
1328
+ filter: Record<string, unknown> | null;
1324
1329
  };
1325
1330
  /**
1326
1331
  * planning → planned → running ⇄ paused → done | failed | cancelled.
@@ -1357,6 +1362,28 @@ interface DataSourceJobPlan {
1357
1362
  errorShare: number;
1358
1363
  deleteShare: number;
1359
1364
  secondsPerObject: number;
1365
+ /** What the mapper's own model and step calls billed per sampled object. */
1366
+ creditsPerObject?: number;
1367
+ /** What the sample's mapper calls billed, spent before the run began. */
1368
+ sampleCredits?: number;
1369
+ } | null;
1370
+ /**
1371
+ * Sources with a live reader: what reading costs. `history` prices it from
1372
+ * what the live reader has done (a hundred documents or more); `slice`
1373
+ * from a reread's first slice, read for real before the plan (its reads
1374
+ * are done, and the run leaves them out); null when unmeasured, and the
1375
+ * budget alone bounds the reader. The failure share is the baseline the
1376
+ * run's reader gate pauses against.
1377
+ */
1378
+ reading?: {
1379
+ measured: 'history' | 'slice' | null;
1380
+ creditsPerDocument: number | null;
1381
+ sampleCredits?: number;
1382
+ sampleDocuments?: number;
1383
+ sampleRead?: number;
1384
+ /** How much the live database grew per document the slice read. */
1385
+ bytesPerDocument?: number | null;
1386
+ baselineFailureShare?: number;
1360
1387
  } | null;
1361
1388
  projected: {
1362
1389
  documents: number;
@@ -1368,8 +1395,14 @@ interface DataSourceJobPlan {
1368
1395
  embedding: number;
1369
1396
  extraction: number;
1370
1397
  contextual: number;
1398
+ /** Mapped sources: the mapper's own calls over every object, the sample's included. */
1399
+ mapping?: number;
1400
+ /** Reader sources: the reader's own calls over every document, a slice's included. */
1401
+ reading?: number;
1371
1402
  total: number;
1372
1403
  };
1404
+ /** A reread: the live database's size once every document is read. */
1405
+ databaseBytes?: number | null;
1373
1406
  };
1374
1407
  capacity: {
1375
1408
  placement: 'shared' | 'dedicated';
@@ -1416,13 +1449,14 @@ interface DataSourceJob {
1416
1449
  pipelineId: string;
1417
1450
  source: DataSourceJobSource;
1418
1451
  /**
1419
- * Objects the mapper skipped or failed on. Counted on `jobs status`; on the
1420
- * list and on unmapped sources' jobs both are zero.
1452
+ * Objects the mapper skipped or failed on, and documents the reader failed
1453
+ * on. Counted on `jobs status`; null on the list.
1421
1454
  */
1422
1455
  quarantine: {
1423
1456
  skipped: number;
1424
1457
  errors: number;
1425
- };
1458
+ readErrors: number;
1459
+ } | null;
1426
1460
  state: DataSourceJobState;
1427
1461
  autoApprove: boolean;
1428
1462
  plan: DataSourceJobPlan | null;
@@ -1446,9 +1480,24 @@ interface DataSourceJob {
1446
1480
  embedTokens: number;
1447
1481
  extractionPages: number;
1448
1482
  };
1449
- /** Model spend so far at catalog rates — an estimate, not the ledger. */
1483
+ /**
1484
+ * Spend so far: embedding, extraction and contextual at catalog rates, plus
1485
+ * what the mapper's own calls billed. An estimate, not the ledger. The
1486
+ * budget pauses the job on it.
1487
+ */
1450
1488
  estimatedCredits: number;
1451
1489
  estimatedDollars: number;
1490
+ /**
1491
+ * What frames billed for their own calls: the mapper's and the reader's,
1492
+ * the plan's sample included.
1493
+ */
1494
+ mapperCredits?: number;
1495
+ mapperDollars?: number;
1496
+ /** A running job's read stage on a reader source: documents read of those cut. */
1497
+ reading?: {
1498
+ documentsRead: number;
1499
+ documentsTotal: number;
1500
+ } | null;
1452
1501
  /** Recent per-document failures, newest first, at most twenty. */
1453
1502
  samples: {
1454
1503
  ref: string;
@@ -1458,9 +1507,10 @@ interface DataSourceJob {
1458
1507
  error: string | null;
1459
1508
  /**
1460
1509
  * Why a running job stopped: the owner, the budget, repeated batch
1461
- * failures, or (mapped sources) a skip share far above the plan's.
1510
+ * failures, (mapped sources) a skip share far above the plan's, or (reader
1511
+ * sources) a reader failing on far more documents than it did at first.
1462
1512
  */
1463
- pauseReason: 'user' | 'budget' | 'errors' | 'skips' | null;
1513
+ pauseReason: 'user' | 'budget' | 'errors' | 'skips' | 'reader' | null;
1464
1514
  stalled: boolean;
1465
1515
  /** Times a pause for errors resumed itself on its own schedule. */
1466
1516
  autoResumes: number;
@@ -1936,12 +1986,16 @@ interface DataSourceRemapResult {
1936
1986
  slug: string;
1937
1987
  };
1938
1988
  }
1939
- /** One object a job's mapper did not turn into documents. */
1989
+ /**
1990
+ * One object a job's mapper did not turn into documents (`stage: 'map'`), or
1991
+ * one document its reader failed on (`stage: 'read'`).
1992
+ */
1940
1993
  interface DataSourceQuarantinedObject {
1941
1994
  id: string;
1942
- /** The key or URL the object was known by. */
1995
+ /** The key or URL the object was known by; a document id for a read. */
1943
1996
  ref: string;
1944
1997
  kind: 'skip' | 'error';
1998
+ stage: 'map' | 'read';
1945
1999
  reason: string;
1946
2000
  /** False when the object's raw copy never landed — a replay cannot reach it. */
1947
2001
  replayable: boolean;
@@ -1960,10 +2014,12 @@ interface DataSourceQuarantineResult {
1960
2014
  counts: {
1961
2015
  skipped: number;
1962
2016
  errors: number;
2017
+ readErrors: number;
1963
2018
  };
1964
2019
  /** Reasons by frequency, most common first. */
1965
2020
  reasons: {
1966
2021
  kind: 'skip' | 'error';
2022
+ stage: 'map' | 'read';
1967
2023
  reason: string;
1968
2024
  count: number;
1969
2025
  }[];
@@ -1971,6 +2027,104 @@ interface DataSourceQuarantineResult {
1971
2027
  nextCursor: string | null;
1972
2028
  }
1973
2029
 
2030
+ /**
2031
+ * Response types for data-source readers.
2032
+ *
2033
+ * Transcribed from youai-api:
2034
+ * src/roles/http/routes/Apps/manage/dataSources/readers.ts
2035
+ * src/customerApps/AppDataSources/reading.ts (liveReaderView)
2036
+ * src/customerApps/AppDataSources/dao/DeliveriesDao.ts (summary)
2037
+ */
2038
+
2039
+ /** The reader the live release declares for a source. */
2040
+ interface DataSourceReader {
2041
+ /** The reader file, from mindstudio.json. */
2042
+ path: string;
2043
+ export: string;
2044
+ /** Per delivery. */
2045
+ timeoutMs: number;
2046
+ /** Frames in flight for the source at once, across every carrier. */
2047
+ concurrency: number;
2048
+ releaseId: string;
2049
+ branch: string | null;
2050
+ commitSha: string;
2051
+ }
2052
+ /**
2053
+ * Where a source's standalone deliveries stand: what `add()`, `remove()`
2054
+ * and source deletion queued outside any job. Retrying ones back off 1, 5,
2055
+ * 15, 60 and 240 minutes; after that they park until `reader retry`.
2056
+ */
2057
+ interface DataSourceReaderDeliveries {
2058
+ pending: number;
2059
+ inFlight: number;
2060
+ retrying: number;
2061
+ parked: number;
2062
+ /** The newest failures, the document null for a `cleared`. */
2063
+ recentErrors: {
2064
+ documentId: string | null;
2065
+ error: string;
2066
+ at: string;
2067
+ }[];
2068
+ }
2069
+ /** POST /datasources/reader/status */
2070
+ interface DataSourceReaderStatusResult {
2071
+ /** Null when the live release declares no reader for the source. */
2072
+ reader: DataSourceReader | null;
2073
+ deliveries: DataSourceReaderDeliveries;
2074
+ /** Live documents the reader has not read (`reread --unread` reads them). */
2075
+ documents: {
2076
+ unread: number;
2077
+ };
2078
+ /**
2079
+ * What the live reader has done, since its bundle last changed: what a
2080
+ * plan prices reading from once it has read a hundred documents.
2081
+ */
2082
+ measured: {
2083
+ documents: number;
2084
+ failures: number;
2085
+ credits: number;
2086
+ creditsPerDocument: number | null;
2087
+ since: string;
2088
+ } | null;
2089
+ /** The live release's databases, in bytes; null when unknown. */
2090
+ database: {
2091
+ bytes: number | null;
2092
+ };
2093
+ }
2094
+ /** POST /datasources/reader/retry */
2095
+ interface DataSourceReaderRetryResult {
2096
+ /** Deliveries queued again. */
2097
+ retried: number;
2098
+ }
2099
+ /** One document's outcome in a reader test. */
2100
+ interface DataSourceReaderTestDocument {
2101
+ documentId: string;
2102
+ /**
2103
+ * `delivered`: the reader ran (a read, or a removal for a document removed
2104
+ * meanwhile); `failed`: it threw or timed out; `skipped`: nothing to read
2105
+ * (not built on the active version); `busy`: no slot on the source came
2106
+ * free in time.
2107
+ */
2108
+ status: 'delivered' | 'failed' | 'skipped' | 'busy';
2109
+ kind?: 'read' | 'removed';
2110
+ error?: string;
2111
+ }
2112
+ /** POST /datasources/reader/test */
2113
+ interface DataSourceReaderTestResult {
2114
+ dev: true;
2115
+ documents: DataSourceReaderTestDocument[];
2116
+ failed: number;
2117
+ durationMs: number;
2118
+ }
2119
+ /** POST /datasources/reread */
2120
+ interface DataSourceRereadResult {
2121
+ job: DataSourceJob;
2122
+ dataSource: {
2123
+ id: string;
2124
+ slug: string;
2125
+ };
2126
+ }
2127
+
1974
2128
  /**
1975
2129
  * Response types for the data-sources management API.
1976
2130
  *
@@ -2112,6 +2266,8 @@ interface DataSourcesDocument {
2112
2266
  sourceKey: string;
2113
2267
  /** App-supplied scalar metadata set at add time; filterable at search time. */
2114
2268
  metadata: Record<string, string | number | boolean> | null;
2269
+ /** Entities the document asserts, sorted; null when never set. */
2270
+ entities: string[] | null;
2115
2271
  createdAt: string;
2116
2272
  updatedAt: string;
2117
2273
  }
@@ -2129,6 +2285,7 @@ interface DataSourcesDocumentStatus {
2129
2285
  chunkCount: number | null;
2130
2286
  pageCount: number | null;
2131
2287
  metadata: Record<string, string | number | boolean> | null;
2288
+ entities: string[] | null;
2132
2289
  ingestedAt: string | null;
2133
2290
  }
2134
2291
  /**
@@ -2231,6 +2388,69 @@ interface DataSourcesMigration {
2231
2388
  /** The copy in the one progress shape, with the platform's measured rate and ETA. */
2232
2389
  progress: OperationProgress;
2233
2390
  }
2391
+ /** A source's committed dictionary: what a push reports, and what the source reads back. */
2392
+ interface DataSourcesDictionaryReport {
2393
+ version: number;
2394
+ /** The matching rule its names were keyed under, carried from push to push. */
2395
+ linkerVersion: number;
2396
+ entries: number;
2397
+ names: number;
2398
+ /** Names more than one id claims: each tags every claimant. */
2399
+ ambiguousNames: number;
2400
+ /**
2401
+ * The names the most ids claim: `name` as you pushed it (one of them, when
2402
+ * several fold alike), `key` as the linker matches it (folded, separators
2403
+ * dropped), and how many ids claim it.
2404
+ */
2405
+ mostClaimed: {
2406
+ key: string;
2407
+ name?: string;
2408
+ ids: number;
2409
+ }[];
2410
+ /** Names that can't match their own text as written, with a few of them. */
2411
+ unmatchable: {
2412
+ count: number;
2413
+ examples: string[];
2414
+ };
2415
+ committedAt: string;
2416
+ }
2417
+ /** POST /datasources/dictionary/commit. */
2418
+ interface DataSourcesDictionaryPushResult extends DataSourcesDictionaryReport {
2419
+ /** The push equalled the committed dictionary: no new version, no relink. */
2420
+ unchanged: boolean;
2421
+ }
2422
+ /**
2423
+ * A relink in flight: a version's passages re-tagged against the source's
2424
+ * newer dictionary, a lap at a time. A commit mid-lap marks the lap to run
2425
+ * once more, which writes little.
2426
+ */
2427
+ interface DataSourcesRelink {
2428
+ version: number;
2429
+ lap: number;
2430
+ walked: number;
2431
+ total: number;
2432
+ rewritten: number;
2433
+ startedAt: string;
2434
+ /** Why the lap is holding (the source's dedicated capacity is off). */
2435
+ waiting: string | null;
2436
+ error: string | null;
2437
+ progress: OperationProgress;
2438
+ }
2439
+ /** POST /datasources/dictionary. */
2440
+ interface DataSourcesDictionaryStatus {
2441
+ dictionary: DataSourcesDictionaryReport | null;
2442
+ relink: DataSourcesRelink | null;
2443
+ candidateRelink: DataSourcesRelink | null;
2444
+ }
2445
+ /** POST /datasources/link. */
2446
+ interface DataSourcesLinkResult {
2447
+ /** The dictionary version that linked, or null when the source has none. */
2448
+ version: number | null;
2449
+ mentions: {
2450
+ ids: string[];
2451
+ text: string;
2452
+ }[];
2453
+ }
2234
2454
  /** One data source in the GET /datasources listing. */
2235
2455
  interface DataSourcesListEntry {
2236
2456
  id: string;
@@ -2262,6 +2482,10 @@ interface DataSourcesListEntry {
2262
2482
  connector: DataSourceConnector | null;
2263
2483
  /** An index reload in flight after an eviction, or its last failure. */
2264
2484
  hydration: DataSourcesHydration | null;
2485
+ /** The source's current dictionary, or null when none was pushed. */
2486
+ dictionary: DataSourcesDictionaryReport | null;
2487
+ /** A relink of the active version onto the dictionary, while one runs. */
2488
+ relink: DataSourcesRelink | null;
2265
2489
  /**
2266
2490
  * Dedicated capacity only; null on the shared pool. `building` while the
2267
2491
  * optimizer is behind the writes, `ready` otherwise. Search answers
@@ -2272,6 +2496,10 @@ interface DataSourcesListEntry {
2272
2496
  sampleOf: string | null;
2273
2497
  /** The mapper the live release declares for this source, or null. */
2274
2498
  mapper: DataSourceMapper | null;
2499
+ /** The reader the live release declares for this source, or null. */
2500
+ reader: (DataSourceReader & {
2501
+ deliveries: DataSourceReaderDeliveries;
2502
+ }) | null;
2275
2503
  createdAt: string;
2276
2504
  }
2277
2505
  /** GET /datasources — all data sources for the app. */
@@ -2299,6 +2527,8 @@ interface DataSourcesSearchCitation {
2299
2527
  interface DataSourcesSearchResultItem {
2300
2528
  score: number;
2301
2529
  text: string;
2530
+ /** The entities this passage carries (its document's asserted ids). */
2531
+ entities: string[];
2302
2532
  citation: DataSourcesSearchCitation;
2303
2533
  /** Rank and score from retrieval, before reranking. */
2304
2534
  retrievalRank?: number;
@@ -2329,6 +2559,33 @@ interface DataSourcesCountResult {
2329
2559
  pipelineVersion: number;
2330
2560
  latencyMs: number;
2331
2561
  }
2562
+ /**
2563
+ * POST /datasources/entities. The entities the passages matching a filter are
2564
+ * about, most first. `chunks` is passages carrying each id, not documents, and
2565
+ * approximate.
2566
+ */
2567
+ interface DataSourcesEntitiesResult {
2568
+ entities: {
2569
+ id: string;
2570
+ chunks: number;
2571
+ }[];
2572
+ pipelineVersion: number;
2573
+ latencyMs: number;
2574
+ }
2575
+ /** One passage of a listing: a search hit without the ranking. */
2576
+ interface DataSourcesPassage {
2577
+ text: string;
2578
+ entities: string[];
2579
+ citation: DataSourcesSearchCitation;
2580
+ }
2581
+ /** POST /datasources/passages — a page of every passage matching a filter. */
2582
+ interface DataSourcesPassagesResult {
2583
+ passages: DataSourcesPassage[];
2584
+ /** Pass back as `cursor` for the next page; null after the last. */
2585
+ nextCursor: string | null;
2586
+ pipelineVersion: number;
2587
+ latencyMs: number;
2588
+ }
2332
2589
  /**
2333
2590
  * POST /datasources/search.
2334
2591
  *
@@ -2508,6 +2765,11 @@ interface AddDocumentParams {
2508
2765
  * `string | number | boolean` values).
2509
2766
  */
2510
2767
  metadata?: Record<string, string | number | boolean>;
2768
+ /**
2769
+ * What the document is about, as the app's own ids (≤ 256, printable ASCII,
2770
+ * no whitespace or commas). Every passage carries them; `[]` clears them.
2771
+ */
2772
+ entities?: string[];
2511
2773
  /**
2512
2774
  * Receives the exact progress strings the CLI prints today:
2513
2775
  * - `${filename}: unchanged, skipped`
@@ -2724,6 +2986,53 @@ interface CountParams {
2724
2986
  * const { chunks } = await admin.dataSources.count({ slug: 'policies', filter: { contains: 'notice period' } });
2725
2987
  */
2726
2988
  declare function count(ctx: AdminContext, params: CountParams): Promise<DataSourcesCountResult>;
2989
+ interface EntitiesParams {
2990
+ /** Data source slug. */
2991
+ slug: string;
2992
+ /** Same grammar as search's filter; absent covers the whole corpus. */
2993
+ filter?: Record<string, unknown>;
2994
+ /** Entities to return, most first (default 20, at most 1,000). */
2995
+ limit?: number;
2996
+ /** Read the candidate version instead of the live one. */
2997
+ candidate?: boolean;
2998
+ }
2999
+ /**
3000
+ * Which entities the passages matching a filter are about, most first.
3001
+ *
3002
+ * Filtered on one entity, it answers what appears beside it: a co-mention
3003
+ * graph. `chunks` counts passages carrying each id, not documents, and is
3004
+ * approximate.
3005
+ *
3006
+ * @throws AdminApiError `invalid_filter` (400); `no_candidate_pipeline` (404)
3007
+ * with `candidate: true` and no revectorization in flight; `index_warming` /
3008
+ * `index_building` (503) while the corpus is loading or building.
3009
+ * @example
3010
+ * const { entities } = await admin.dataSources.entities({ slug: 'manuals', filter: { entities: ['P-101A'] } });
3011
+ */
3012
+ declare function entities(ctx: AdminContext, params: EntitiesParams): Promise<DataSourcesEntitiesResult>;
3013
+ interface PassagesParams {
3014
+ /** Data source slug. */
3015
+ slug: string;
3016
+ /** Same grammar as search's filter; absent lists the whole corpus. */
3017
+ filter?: Record<string, unknown>;
3018
+ /** The previous page's `nextCursor`. */
3019
+ cursor?: string;
3020
+ /** Passages per page (default 50, at most 200). */
3021
+ limit?: number;
3022
+ /** Read the candidate version instead of the live one. */
3023
+ candidate?: boolean;
3024
+ }
3025
+ /**
3026
+ * One page of every passage matching a filter, unranked: all the pages that
3027
+ * mention an entity, rather than search's best few. Passages come document by
3028
+ * document, each document's in order.
3029
+ *
3030
+ * @throws AdminApiError `invalid_filter` (400); `invalid_cursor` (400);
3031
+ * `no_candidate_pipeline` (404); `index_warming` / `index_building` (503).
3032
+ * @example
3033
+ * const { passages, nextCursor } = await admin.dataSources.passages({ slug: 'manuals', filter: { entities: ['P-1004A'] } });
3034
+ */
3035
+ declare function passages(ctx: AdminContext, params: PassagesParams): Promise<DataSourcesPassagesResult>;
2727
3036
  /**
2728
3037
  * Read the full pipeline configuration for one data source.
2729
3038
  *
@@ -3002,6 +3311,48 @@ declare function rmWhereAll(ctx: AdminContext, params: RmWhereParams & {
3002
3311
  * const { documents, versions } = await admin.dataSources.deleteSource('policies');
3003
3312
  */
3004
3313
  declare function deleteSource(ctx: AdminContext, slug: string): Promise<DataSourcesDeleteResult>;
3314
+ /** One dictionary entry: the app's id for a thing and the names it goes by. */
3315
+ interface DictionaryEntryInput {
3316
+ id: string;
3317
+ names: string[];
3318
+ }
3319
+ /**
3320
+ * Push a source's dictionary, replacing the one it had: a stage, its pages
3321
+ * (each retried alone), and the commit. A new version re-tags the source's
3322
+ * passages in the background; an unchanged one commits nothing.
3323
+ *
3324
+ * @throws AdminApiError `invalid_dictionary` / `dictionary_name_too_short` (400)
3325
+ * on a page, naming the entry; `dictionary_too_large` (400) at the commit.
3326
+ * @example
3327
+ * await admin.dataSources.pushDictionary({ slug: 'manuals', entries: [{ id: 'P-101A', names: ['P-101A', 'Main Feed Pump'] }] });
3328
+ */
3329
+ declare function pushDictionary(ctx: AdminContext, params: {
3330
+ slug: string;
3331
+ entries: DictionaryEntryInput[];
3332
+ linkerVersion?: number;
3333
+ onProgress?: (sent: number, total: number) => void;
3334
+ }): Promise<DataSourcesDictionaryPushResult>;
3335
+ /**
3336
+ * A source's current dictionary, and the relinks re-tagging its versions
3337
+ * while they run.
3338
+ *
3339
+ * @throws AdminApiError `data_source_not_found` (404).
3340
+ */
3341
+ declare function dictionary(ctx: AdminContext, params: {
3342
+ slug: string;
3343
+ }): Promise<DataSourcesDictionaryStatus>;
3344
+ /**
3345
+ * What the source's current dictionary finds in a piece of text: each
3346
+ * mention, in order, with the ids it tags.
3347
+ *
3348
+ * @throws AdminApiError `data_source_not_found` (404).
3349
+ * @example
3350
+ * const { mentions } = await admin.dataSources.link({ slug: 'manuals', text: 'Replaced the seal on P101A.' });
3351
+ */
3352
+ declare function link(ctx: AdminContext, params: {
3353
+ slug: string;
3354
+ text: string;
3355
+ }): Promise<DataSourcesLinkResult>;
3005
3356
 
3006
3357
  type dataSources_AddDocumentParams = AddDocumentParams;
3007
3358
  type dataSources_AddDocumentResult = AddDocumentResult;
@@ -3009,10 +3360,13 @@ type dataSources_ConfigSetParams = ConfigSetParams;
3009
3360
  type dataSources_CountParams = CountParams;
3010
3361
  type dataSources_CreateParams = CreateParams;
3011
3362
  declare const dataSources_DOCUMENTS_IDS_MAX: typeof DOCUMENTS_IDS_MAX;
3363
+ type dataSources_DictionaryEntryInput = DictionaryEntryInput;
3012
3364
  type dataSources_DocumentsParams = DocumentsParams;
3013
3365
  type dataSources_DropParams = DropParams;
3366
+ type dataSources_EntitiesParams = EntitiesParams;
3014
3367
  declare const dataSources_FAILURES_PAGE: typeof FAILURES_PAGE;
3015
3368
  type dataSources_MoveParams = MoveParams;
3369
+ type dataSources_PassagesParams = PassagesParams;
3016
3370
  type dataSources_PromoteParams = PromoteParams;
3017
3371
  type dataSources_RevectorizeParams = RevectorizeParams;
3018
3372
  type dataSources_RmParams = RmParams;
@@ -3031,10 +3385,15 @@ declare const dataSources_configGet: typeof configGet;
3031
3385
  declare const dataSources_configSet: typeof configSet;
3032
3386
  declare const dataSources_count: typeof count;
3033
3387
  declare const dataSources_deleteSource: typeof deleteSource;
3388
+ declare const dataSources_dictionary: typeof dictionary;
3034
3389
  declare const dataSources_documents: typeof documents;
3035
3390
  declare const dataSources_drop: typeof drop;
3391
+ declare const dataSources_entities: typeof entities;
3392
+ declare const dataSources_link: typeof link;
3036
3393
  declare const dataSources_move: typeof move;
3394
+ declare const dataSources_passages: typeof passages;
3037
3395
  declare const dataSources_promote: typeof promote;
3396
+ declare const dataSources_pushDictionary: typeof pushDictionary;
3038
3397
  declare const dataSources_revectorize: typeof revectorize;
3039
3398
  declare const dataSources_rm: typeof rm;
3040
3399
  declare const dataSources_rmWhere: typeof rmWhere;
@@ -3046,7 +3405,7 @@ declare const dataSources_waitForCandidate: typeof waitForCandidate;
3046
3405
  declare const dataSources_waitForIngest: typeof waitForIngest;
3047
3406
  declare const dataSources_waitForMove: typeof waitForMove;
3048
3407
  declare namespace dataSources {
3049
- export { type dataSources_AddDocumentParams as AddDocumentParams, type dataSources_AddDocumentResult as AddDocumentResult, type dataSources_ConfigSetParams as ConfigSetParams, type dataSources_CountParams as CountParams, type dataSources_CreateParams as CreateParams, DEFAULT_WAIT_TIMEOUT_MS$3 as DEFAULT_WAIT_TIMEOUT_MS, dataSources_DOCUMENTS_IDS_MAX as DOCUMENTS_IDS_MAX, type dataSources_DocumentsParams as DocumentsParams, type dataSources_DropParams as DropParams, dataSources_FAILURES_PAGE as FAILURES_PAGE, type dataSources_MoveParams as MoveParams, type dataSources_PromoteParams as PromoteParams, type dataSources_RevectorizeParams as RevectorizeParams, type dataSources_RmParams as RmParams, type dataSources_RmWhereParams as RmWhereParams, type dataSources_SearchParams as SearchParams, type dataSources_SummarizedDocument as SummarizedDocument, type dataSources_WaitForCandidateParams as WaitForCandidateParams, type dataSources_WaitForCandidateResult as WaitForCandidateResult, type dataSources_WaitForIngestParams as WaitForIngestParams, type dataSources_WaitForIngestResult as WaitForIngestResult, type dataSources_WaitForMoveParams as WaitForMoveParams, type dataSources_WaitForMoveResult as WaitForMoveResult, dataSources_addDocument as addDocument, dataSources_allDocuments as allDocuments, dataSources_configGet as configGet, dataSources_configSet as configSet, dataSources_count as count, create$1 as create, dataSources_deleteSource as deleteSource, dataSources_documents as documents, dataSources_drop as drop, list$8 as list, dataSources_move as move, dataSources_promote as promote, dataSources_revectorize as revectorize, dataSources_rm as rm, dataSources_rmWhere as rmWhere, dataSources_rmWhereAll as rmWhereAll, dataSources_search as search, dataSources_stopMove as stopMove, dataSources_summarize as summarize, dataSources_waitForCandidate as waitForCandidate, dataSources_waitForIngest as waitForIngest, dataSources_waitForMove as waitForMove };
3408
+ export { type dataSources_AddDocumentParams as AddDocumentParams, type dataSources_AddDocumentResult as AddDocumentResult, type dataSources_ConfigSetParams as ConfigSetParams, type dataSources_CountParams as CountParams, type dataSources_CreateParams as CreateParams, DEFAULT_WAIT_TIMEOUT_MS$3 as DEFAULT_WAIT_TIMEOUT_MS, dataSources_DOCUMENTS_IDS_MAX as DOCUMENTS_IDS_MAX, type dataSources_DictionaryEntryInput as DictionaryEntryInput, type dataSources_DocumentsParams as DocumentsParams, type dataSources_DropParams as DropParams, type dataSources_EntitiesParams as EntitiesParams, dataSources_FAILURES_PAGE as FAILURES_PAGE, type dataSources_MoveParams as MoveParams, type dataSources_PassagesParams as PassagesParams, type dataSources_PromoteParams as PromoteParams, type dataSources_RevectorizeParams as RevectorizeParams, type dataSources_RmParams as RmParams, type dataSources_RmWhereParams as RmWhereParams, type dataSources_SearchParams as SearchParams, type dataSources_SummarizedDocument as SummarizedDocument, type dataSources_WaitForCandidateParams as WaitForCandidateParams, type dataSources_WaitForCandidateResult as WaitForCandidateResult, type dataSources_WaitForIngestParams as WaitForIngestParams, type dataSources_WaitForIngestResult as WaitForIngestResult, type dataSources_WaitForMoveParams as WaitForMoveParams, type dataSources_WaitForMoveResult as WaitForMoveResult, dataSources_addDocument as addDocument, dataSources_allDocuments as allDocuments, dataSources_configGet as configGet, dataSources_configSet as configSet, dataSources_count as count, create$1 as create, dataSources_deleteSource as deleteSource, dataSources_dictionary as dictionary, dataSources_documents as documents, dataSources_drop as drop, dataSources_entities as entities, dataSources_link as link, list$8 as list, dataSources_move as move, dataSources_passages as passages, dataSources_promote as promote, dataSources_pushDictionary as pushDictionary, dataSources_revectorize as revectorize, dataSources_rm as rm, dataSources_rmWhere as rmWhere, dataSources_rmWhereAll as rmWhereAll, dataSources_search as search, dataSources_stopMove as stopMove, dataSources_summarize as summarize, dataSources_waitForCandidate as waitForCandidate, dataSources_waitForIngest as waitForIngest, dataSources_waitForMove as waitForMove };
3050
3409
  }
3051
3410
 
3052
3411
  /**
@@ -3575,6 +3934,11 @@ interface MapTestParams {
3575
3934
  limit?: number;
3576
3935
  /** Run the LOCAL mapper through the app's dev session instead of the live bundle. */
3577
3936
  dev?: boolean;
3937
+ /**
3938
+ * With `dev`, which of your dev sessions: its dev release id. Default your
3939
+ * newest. Only ever your own.
3940
+ */
3941
+ releaseId?: string;
3578
3942
  }
3579
3943
  /**
3580
3944
  * Run the source's mapper over real objects and return the outcomes — nothing
@@ -3624,6 +3988,8 @@ declare function remap(ctx: AdminContext, params: RemapParams): Promise<DataSour
3624
3988
  interface QuarantineParams {
3625
3989
  id: string;
3626
3990
  kind?: 'skip' | 'error';
3991
+ /** Only the mapper's (`map`) or only the reader's (`read`). */
3992
+ stage?: 'map' | 'read';
3627
3993
  /** Only objects quarantined with exactly this reason. */
3628
3994
  reason?: string;
3629
3995
  cursor?: string;
@@ -3631,8 +3997,8 @@ interface QuarantineParams {
3631
3997
  limit?: number;
3632
3998
  }
3633
3999
  /**
3634
- * What a job's mapper skipped or failed on: counts, reasons by frequency, and
3635
- * a page of objects.
4000
+ * What a job's mapper skipped or failed on, and what its reader failed on:
4001
+ * counts, reasons by frequency, and a page of objects.
3636
4002
  *
3637
4003
  * @throws AdminApiError `job_not_found` (404).
3638
4004
  */
@@ -6292,6 +6658,16 @@ interface ReleasesByCommitResult extends ReleaseFailureFields {
6292
6658
  * Synthesised synchronously from the release id by buildPreviewUrl().
6293
6659
  */
6294
6660
  previewUrl: string | null;
6661
+ /**
6662
+ * The data sources this release declares app code for. A live release's
6663
+ * reader entries carry `readerUnread`: the source's documents its reader
6664
+ * hadn't read when the release went live.
6665
+ */
6666
+ dataSources?: {
6667
+ slug: string;
6668
+ reader?: unknown;
6669
+ readerUnread?: number;
6670
+ }[];
6295
6671
  }
6296
6672
  /** A compiled method entry as it appears on a live release. */
6297
6673
  interface DashboardReleaseMethod {
@@ -6789,6 +7165,15 @@ interface ReleaseSummary {
6789
7165
  failureKind?: 'build' | 'interrupted' | 'unbuildable';
6790
7166
  /** Build stage that was running when it failed; only when `failed`. */
6791
7167
  failurePhase?: string;
7168
+ /**
7169
+ * Each data source whose reader this live release brought live, with the
7170
+ * documents it hasn't read: what `datasources reread --unread` reads, priced
7171
+ * first. Absent when the release declares no reader.
7172
+ */
7173
+ readers?: {
7174
+ slug: string;
7175
+ unread: number;
7176
+ }[];
6792
7177
  }
6793
7178
  /**
6794
7179
  * Terminal outcome of a `waitForCommit` call.
@@ -7941,4 +8326,4 @@ declare class AdminTimeoutError extends Error {
7941
8326
 
7942
8327
  declare const admin: AdminClient;
7943
8328
 
7944
- export { AdminApiError, type AdminClient, type AdminClientOptions, type AdminContext, AdminTimeoutError, type AgentThreadDetail, type AgentThreadListItem, type AgentThreadsGetResult, type AgentThreadsListResult, type AgentToolCall, type AgentTranscriptMessage, type AgentTurnError, type AnalyticsAiHostRow, type AnalyticsAiSourcesResult, type AnalyticsAiVendorRow, type AnalyticsBatchResult, type AnalyticsCrawlersOverviewResult, type AnalyticsCrawlersRecentResult, type AnalyticsCrawlersRecentRow, type AnalyticsCrawlersResult, type AnalyticsCrawlersTimeseriesBucket, type AnalyticsCrawlersTimeseriesResult, type AnalyticsLiveResult, type AnalyticsMapPoint, type AnalyticsMapResult, type AnalyticsMetric, type AnalyticsQueryResult, type AnalyticsQueryResultRow, type AnalyticsSourceRow, type AnalyticsSourcesResult, type AppCronJobStatus, type AppCronJobStatusReason, type AppCronRunState, type AppEmailSuppression, type AppSecretRow, type CrashGroup, type CrashOccurrenceRow, type CrashesGetResult, type CrashesListResult, type CrashesOccurrencesResult, type CrashesStatsBucket, type CrashesStatsResult, type CronJobDecorated, type CronOverviewResult, type CronRunResult, type CronRunSummary, type DashboardLiveRelease, type DashboardReleaseMethod, type DashboardResult, type DataLiftFromDevResult, type DataLiftFromLiveResult, type DataSourceConnector, type DataSourceConnectorCredentials, type DataSourceConnectorDeletions, type DataSourceConnectorGetResult, type DataSourceConnectorPolicy, type DataSourceConnectorResult, type DataSourceInspectReport, type DataSourceInspectResult, type DataSourceJob, type DataSourceJobGetResult, type DataSourceJobManifestTokenResult, type DataSourceJobPlan, type DataSourceJobResult, type DataSourceJobSource, type DataSourceJobState, type DataSourceJobsListResult, type DataSourceMapDeployResult, type DataSourceMapTestDocument, type DataSourceMapTestOutcome, type DataSourceMapTestResult, type DataSourceMapper, type DataSourceObjectSelection, type DataSourceQuarantineResult, type DataSourceQuarantinedObject, type DataSourceRemapResult, type DataSourceSyncResult, type DataSourcesBuildProgress, type DataSourcesChunkingConfig, type DataSourcesChunkingStrategy, type DataSourcesConfigResult, type DataSourcesConfigUpdateResult, type DataSourcesCountResult, type DataSourcesCreateResult, type DataSourcesDeleteResult, type DataSourcesDocument, type DataSourcesDocumentConfirmResult, type DataSourcesDocumentDeleteManyResult, type DataSourcesDocumentDeleteResult, type DataSourcesDocumentSelector, type DataSourcesDocumentStatus, type DataSourcesDocumentsResult, type DataSourcesDropResult, type DataSourcesHydrateResult, type DataSourcesHydration, type DataSourcesIndex, type DataSourcesIngestConfig, type DataSourcesIngestUpdate, type DataSourcesListEntry, type DataSourcesListResult, type DataSourcesMigration, type DataSourcesMoveResult, type DataSourcesPlacement, type DataSourcesPromoteResult, type DataSourcesRetrievalConfig, type DataSourcesRetrievalUpdate, type DataSourcesRevectorizeResult, type DataSourcesSampleResult, type DataSourcesSearchCitation, type DataSourcesSearchResult, type DataSourcesSearchResultItem, type DataSourcesUploadTokenResult, type DatasetFile, type DbQueryResult, type DiagnosticsAuditEnvironment, type DiagnosticsDashboardResult, type DiagnosticsFinding, type DiagnosticsLighthouseScores, type DiagnosticsPayload, type DiagnosticsReleaseResult, type DiagnosticsRuntimeFindings, type DomainsCheckResult, type DomainsCustomAddResult, type DomainsCustomCheckResult, type DomainsCustomHostnameUiStatus, type DomainsCustomHostnameView, type DomainsCustomListResult, type DomainsCustomRemoveResult, type DomainsCustomRetryResult, type DomainsDnsInstructions, type DomainsGetResult, type DomainsSetResult, type EmailBatchLifecycle, type EmailBatchResult, type EmailBatchSummary, type EmailBatchesResult, type EmailDomainBase, type EmailEffectiveSender, type EmailInboxResult, type EmailListResult, type EmailMessageKind, type EmailMessageResult, type EmailMessageStatus, type EmailSenderTier, type EmailSendingStatusResult, type EmailStatsResult, type EmailSummary, type EmailSuppressResult, type EmailSuppressionsResult, type EmailUnsuppressResult, type EvalAggregates, type EvalCompareResult, type EvalExpectation, type EvalQueriesAddResult, type EvalQueriesListResult, type EvalQuery, type EvalQueryResult, type EvalQueryStyle, type EvalRetrieval, type EvalRun, type EvalRunResult, type EvalRunState, type EvalRunsListResult, type EvalSet, type EvalSetGetResult, type EvalSetResult, type EvalSetState, type EvalSetsListResult, type EventChannelActivity, type EventsChannelsListResult, type EventsPublishResult, type EventsTailFrame, type FilesDeleteResult, type FilesFileMeta, type FilesListEntry, type FilesListResult, type FilesLsResult, type FilesScanBadge, type FilesScanFlagged, type FilesScanStore, type FilesStatResult, type FilesStoreSummaryEntry, type FilesUploadUrlResult, type FilesUrlResult, type FrontendErrorType, type InboundDnsInstructions, type InboundEmailDomainAddResult, type InboundEmailDomainCheckResult, type InboundEmailDomainDeleteResult, type InboundEmailDomainUiStatus, type InboundEmailDomainVerifyResult, type InboundEmailDomainView, type InboundEmailDomainsListResult, type InboxEmailPreview, type IssueAuthorKind, type IssueCommentRow, type IssueEventType, type IssueRow, type IssueStatus, type IssuesCommentResult, type IssuesCreateResult, type IssuesDeleteResult, type IssuesGetResult, type IssuesListResult, type IssuesUpdateResult, type JewelPairRow, type JewelPairSummaryRow, type JewelVerdict, type JewelsDatasetSummary, type JewelsDryrunResult, type JewelsExportResult, type JewelsGradeResult, type JewelsGrading, type JewelsOverviewResult, type JewelsPairResult, type JewelsPairsResult, type JewelsQueueResult, type JewelsResolveResult, type JewelsRunResult, type JewelsRunsResult, type JewelsTimeseriesBucket, type JewelsTimeseriesResult, type JewelsTrainResult, type LiftedDatabase, type MethodsInvokeResult, type OperationProgress, type OutboundDnsInstructions, type OutboundDnsRecord, type OutboundEmailDomainAddResult, type OutboundEmailDomainCheckResult, type OutboundEmailDomainDeleteResult, type OutboundEmailDomainUiStatus, type OutboundEmailDomainVerifyResult, type OutboundEmailDomainView, type OutboundEmailDomainsListResult, type PlatformSuppression, type PrerenderGetResult, type PrerenderInvalidateResult, type PrerenderPage, type PrerenderPagesResult, type PrerenderViewResult, type ReleaseFailureFields, type ReleaseFragment, type ReleasesByCommitResult, type ReleasesGetResult, type ReleasesListResult, type RequestsGetResult, type RequestsListResult, type RequestsListRow, type RequestsStatsMethodBucket, type RequestsStatsMethodResult, type RequestsStatsSummaryBucket, type RequestsStatsSummaryResult, type SecretsDeleteResult, type SecretsGetResult, type SecretsListResult, type SecretsSetResult, type SettingsResult, type SuppressionSource, type TaskTraceOutcome, type TaskTraceSummary, type TaskTranscriptMessage, type TaskTurnError, type TasksGetResult, type TasksListResult, type TrainingLogEntry, type TrainingRunRow, type TrainingRunStatus, type UserAuthProvider, type UserListItem, type UserRecord, type UsersCreateApiKeyResult, type UsersListResult, type UsersRevokeApiKeyResult, type UsersSetRoleResult, type V2AppSettings, type V2BuildLogEntry, type V2BuildStats, type V2CommitInfo, type V2EmailMessage, type V2ReleaseStatus, type VoiceAvailableNumber, type VoiceNumbersBuyResult, type VoiceNumbersListResult, type VoiceNumbersReleaseResult, type VoiceNumbersSearchResult, type VoiceNumbersSetNameResult, type VoicePhoneNumberStatus, type VoicePhoneNumberView, type VoiceResolvedPolicy, type VoiceSessionChannel, type VoiceSessionCost, type VoiceSessionCostLine, type VoiceSessionDetail, type VoiceSessionGetResult, type VoiceSessionListItem, type VoiceSessionSip, type VoiceSessionSpeechEntry, type VoiceSessionStatus, type VoiceSessionToolEntry, type VoiceSessionTranscriptEntry, type VoiceSessionsListResult, type VoiceSettingsCeilings, type VoiceSettingsGetResult, type VoiceSettingsOverrides, type VoiceSettingsSetResult, admin, createAdminClient, admin as default };
8329
+ export { AdminApiError, type AdminClient, type AdminClientOptions, type AdminContext, AdminTimeoutError, type AgentThreadDetail, type AgentThreadListItem, type AgentThreadsGetResult, type AgentThreadsListResult, type AgentToolCall, type AgentTranscriptMessage, type AgentTurnError, type AnalyticsAiHostRow, type AnalyticsAiSourcesResult, type AnalyticsAiVendorRow, type AnalyticsBatchResult, type AnalyticsCrawlersOverviewResult, type AnalyticsCrawlersRecentResult, type AnalyticsCrawlersRecentRow, type AnalyticsCrawlersResult, type AnalyticsCrawlersTimeseriesBucket, type AnalyticsCrawlersTimeseriesResult, type AnalyticsLiveResult, type AnalyticsMapPoint, type AnalyticsMapResult, type AnalyticsMetric, type AnalyticsQueryResult, type AnalyticsQueryResultRow, type AnalyticsSourceRow, type AnalyticsSourcesResult, type AppCronJobStatus, type AppCronJobStatusReason, type AppCronRunState, type AppEmailSuppression, type AppSecretRow, type CrashGroup, type CrashOccurrenceRow, type CrashesGetResult, type CrashesListResult, type CrashesOccurrencesResult, type CrashesStatsBucket, type CrashesStatsResult, type CronJobDecorated, type CronOverviewResult, type CronRunResult, type CronRunSummary, type DashboardLiveRelease, type DashboardReleaseMethod, type DashboardResult, type DataLiftFromDevResult, type DataLiftFromLiveResult, type DataSourceConnector, type DataSourceConnectorCredentials, type DataSourceConnectorDeletions, type DataSourceConnectorGetResult, type DataSourceConnectorPolicy, type DataSourceConnectorResult, type DataSourceInspectReport, type DataSourceInspectResult, type DataSourceJob, type DataSourceJobGetResult, type DataSourceJobManifestTokenResult, type DataSourceJobPlan, type DataSourceJobResult, type DataSourceJobSource, type DataSourceJobState, type DataSourceJobsListResult, type DataSourceMapDeployResult, type DataSourceMapTestDocument, type DataSourceMapTestOutcome, type DataSourceMapTestResult, type DataSourceMapper, type DataSourceObjectSelection, type DataSourceQuarantineResult, type DataSourceQuarantinedObject, type DataSourceReader, type DataSourceReaderDeliveries, type DataSourceReaderRetryResult, type DataSourceReaderStatusResult, type DataSourceReaderTestDocument, type DataSourceReaderTestResult, type DataSourceRemapResult, type DataSourceRereadResult, type DataSourceSyncResult, type DataSourcesBuildProgress, type DataSourcesChunkingConfig, type DataSourcesChunkingStrategy, type DataSourcesConfigResult, type DataSourcesConfigUpdateResult, type DataSourcesCountResult, type DataSourcesCreateResult, type DataSourcesDeleteResult, type DataSourcesDictionaryPushResult, type DataSourcesDictionaryReport, type DataSourcesDictionaryStatus, type DataSourcesDocument, type DataSourcesDocumentConfirmResult, type DataSourcesDocumentDeleteManyResult, type DataSourcesDocumentDeleteResult, type DataSourcesDocumentSelector, type DataSourcesDocumentStatus, type DataSourcesDocumentsResult, type DataSourcesDropResult, type DataSourcesEntitiesResult, type DataSourcesHydrateResult, type DataSourcesHydration, type DataSourcesIndex, type DataSourcesIngestConfig, type DataSourcesIngestUpdate, type DataSourcesLinkResult, type DataSourcesListEntry, type DataSourcesListResult, type DataSourcesMigration, type DataSourcesMoveResult, type DataSourcesPassage, type DataSourcesPassagesResult, type DataSourcesPlacement, type DataSourcesPromoteResult, type DataSourcesRelink, type DataSourcesRetrievalConfig, type DataSourcesRetrievalUpdate, type DataSourcesRevectorizeResult, type DataSourcesSampleResult, type DataSourcesSearchCitation, type DataSourcesSearchResult, type DataSourcesSearchResultItem, type DataSourcesUploadTokenResult, type DatasetFile, type DbQueryResult, type DiagnosticsAuditEnvironment, type DiagnosticsDashboardResult, type DiagnosticsFinding, type DiagnosticsLighthouseScores, type DiagnosticsPayload, type DiagnosticsReleaseResult, type DiagnosticsRuntimeFindings, type DomainsCheckResult, type DomainsCustomAddResult, type DomainsCustomCheckResult, type DomainsCustomHostnameUiStatus, type DomainsCustomHostnameView, type DomainsCustomListResult, type DomainsCustomRemoveResult, type DomainsCustomRetryResult, type DomainsDnsInstructions, type DomainsGetResult, type DomainsSetResult, type EmailBatchLifecycle, type EmailBatchResult, type EmailBatchSummary, type EmailBatchesResult, type EmailDomainBase, type EmailEffectiveSender, type EmailInboxResult, type EmailListResult, type EmailMessageKind, type EmailMessageResult, type EmailMessageStatus, type EmailSenderTier, type EmailSendingStatusResult, type EmailStatsResult, type EmailSummary, type EmailSuppressResult, type EmailSuppressionsResult, type EmailUnsuppressResult, type EvalAggregates, type EvalCompareResult, type EvalExpectation, type EvalQueriesAddResult, type EvalQueriesListResult, type EvalQuery, type EvalQueryResult, type EvalQueryStyle, type EvalRetrieval, type EvalRun, type EvalRunResult, type EvalRunState, type EvalRunsListResult, type EvalSet, type EvalSetGetResult, type EvalSetResult, type EvalSetState, type EvalSetsListResult, type EventChannelActivity, type EventsChannelsListResult, type EventsPublishResult, type EventsTailFrame, type FilesDeleteResult, type FilesFileMeta, type FilesListEntry, type FilesListResult, type FilesLsResult, type FilesScanBadge, type FilesScanFlagged, type FilesScanStore, type FilesStatResult, type FilesStoreSummaryEntry, type FilesUploadUrlResult, type FilesUrlResult, type FrontendErrorType, type InboundDnsInstructions, type InboundEmailDomainAddResult, type InboundEmailDomainCheckResult, type InboundEmailDomainDeleteResult, type InboundEmailDomainUiStatus, type InboundEmailDomainVerifyResult, type InboundEmailDomainView, type InboundEmailDomainsListResult, type InboxEmailPreview, type IssueAuthorKind, type IssueCommentRow, type IssueEventType, type IssueRow, type IssueStatus, type IssuesCommentResult, type IssuesCreateResult, type IssuesDeleteResult, type IssuesGetResult, type IssuesListResult, type IssuesUpdateResult, type JewelPairRow, type JewelPairSummaryRow, type JewelVerdict, type JewelsDatasetSummary, type JewelsDryrunResult, type JewelsExportResult, type JewelsGradeResult, type JewelsGrading, type JewelsOverviewResult, type JewelsPairResult, type JewelsPairsResult, type JewelsQueueResult, type JewelsResolveResult, type JewelsRunResult, type JewelsRunsResult, type JewelsTimeseriesBucket, type JewelsTimeseriesResult, type JewelsTrainResult, type LiftedDatabase, type MethodsInvokeResult, type OperationProgress, type OutboundDnsInstructions, type OutboundDnsRecord, type OutboundEmailDomainAddResult, type OutboundEmailDomainCheckResult, type OutboundEmailDomainDeleteResult, type OutboundEmailDomainUiStatus, type OutboundEmailDomainVerifyResult, type OutboundEmailDomainView, type OutboundEmailDomainsListResult, type PlatformSuppression, type PrerenderGetResult, type PrerenderInvalidateResult, type PrerenderPage, type PrerenderPagesResult, type PrerenderViewResult, type ReleaseFailureFields, type ReleaseFragment, type ReleasesByCommitResult, type ReleasesGetResult, type ReleasesListResult, type RequestsGetResult, type RequestsListResult, type RequestsListRow, type RequestsStatsMethodBucket, type RequestsStatsMethodResult, type RequestsStatsSummaryBucket, type RequestsStatsSummaryResult, type SecretsDeleteResult, type SecretsGetResult, type SecretsListResult, type SecretsSetResult, type SettingsResult, type SuppressionSource, type TaskTraceOutcome, type TaskTraceSummary, type TaskTranscriptMessage, type TaskTurnError, type TasksGetResult, type TasksListResult, type TrainingLogEntry, type TrainingRunRow, type TrainingRunStatus, type UserAuthProvider, type UserListItem, type UserRecord, type UsersCreateApiKeyResult, type UsersListResult, type UsersRevokeApiKeyResult, type UsersSetRoleResult, type V2AppSettings, type V2BuildLogEntry, type V2BuildStats, type V2CommitInfo, type V2EmailMessage, type V2ReleaseStatus, type VoiceAvailableNumber, type VoiceNumbersBuyResult, type VoiceNumbersListResult, type VoiceNumbersReleaseResult, type VoiceNumbersSearchResult, type VoiceNumbersSetNameResult, type VoicePhoneNumberStatus, type VoicePhoneNumberView, type VoiceResolvedPolicy, type VoiceSessionChannel, type VoiceSessionCost, type VoiceSessionCostLine, type VoiceSessionDetail, type VoiceSessionGetResult, type VoiceSessionListItem, type VoiceSessionSip, type VoiceSessionSpeechEntry, type VoiceSessionStatus, type VoiceSessionToolEntry, type VoiceSessionTranscriptEntry, type VoiceSessionsListResult, type VoiceSettingsCeilings, type VoiceSettingsGetResult, type VoiceSettingsOverrides, type VoiceSettingsSetResult, admin, createAdminClient, admin as default };