@madewithremy/admin 0.1.29 → 0.1.31

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
@@ -166,6 +166,156 @@ declare namespace agent {
166
166
  export { type agent_ThreadsListParams as ThreadsListParams, agent_threadsGet as threadsGet, agent_threadsList as threadsList };
167
167
  }
168
168
 
169
+ /**
170
+ * Response types for the v2 task log.
171
+ *
172
+ * Transcribed from youai-api:
173
+ * apps/api/src/roles/http/routes/Apps/manage/taskTraces.ts — routes
174
+ * apps/api/src/customerApps/AppTaskAgents/traces.ts — summary and transcript shapes
175
+ */
176
+
177
+ /**
178
+ * How a task ended, as far as the platform can tell (it never sees the loop
179
+ * decide it's done):
180
+ * - `answered`: the last turn ended in a reply.
181
+ * - `in_progress`: the last turn asked for tools and the loop is still going.
182
+ * - `stopped`: the last turn asked for tools and nothing followed.
183
+ * - `error`: the last model call failed.
184
+ */
185
+ type TaskTraceOutcome = 'answered' | 'in_progress' | 'stopped' | 'error';
186
+ /** One task run, as the list shows it. */
187
+ interface TaskTraceSummary {
188
+ traceId: string;
189
+ /** The method execution that started the task — `requests get` opens it. */
190
+ requestId: string | null;
191
+ methodId: string | null;
192
+ source: string | null;
193
+ environment: string;
194
+ /** True = a builder's dev-tunnel run, not live traffic. */
195
+ devSession: boolean;
196
+ model: string;
197
+ outcome: TaskTraceOutcome;
198
+ lastStopReason: string | null;
199
+ turns: number;
200
+ /** More than `turns` means some turns were retried. */
201
+ modelCalls: number;
202
+ toolCallCount: number;
203
+ toolErrorCount: number;
204
+ /** Some turn's last attempt failed; see `turnError` in the transcript. */
205
+ hasTurnError: boolean;
206
+ inputTokens: number;
207
+ outputTokens: number;
208
+ /** Nanodollars (1/1,000,000,000th of a US dollar), retried calls included. */
209
+ billingCost: number;
210
+ /** ISO 8601. */
211
+ startedAt: string;
212
+ /** ISO 8601. */
213
+ updatedAt: string;
214
+ }
215
+ /** A model call that failed rather than replying. */
216
+ interface TaskTurnError {
217
+ message: string;
218
+ status?: number;
219
+ /** Milliseconds since epoch. */
220
+ at: number;
221
+ }
222
+ /**
223
+ * One message in a task transcript. The first is the task's input (a `user`
224
+ * message holding the JSON input); `assistant` messages are the model's
225
+ * turns; `user` messages carrying `toolCallId` are tool results.
226
+ */
227
+ interface TaskTranscriptMessage {
228
+ role: string;
229
+ content: string;
230
+ /** Present on an assistant message that requested tools. */
231
+ toolCalls?: AgentToolCall[];
232
+ /** Present on a tool result — matches the `toolCalls[].id` it answers. */
233
+ toolCallId?: string;
234
+ /** The tool reported a failure. */
235
+ isToolError?: boolean;
236
+ /**
237
+ * On a method tool's result: the `v2_request_log` id of that call — pass it
238
+ * to `requests get` for input, output, stdout and error. Absent on SDK
239
+ * action and function tools, and on tasks from SDKs older than this field.
240
+ */
241
+ requestId?: string;
242
+ /** On an assistant message: the turn that produced it. */
243
+ turn?: number;
244
+ stopReason?: string | null;
245
+ /** The model's reasoning for the turn, when it gave any. */
246
+ thinking?: string;
247
+ turnError?: TaskTurnError;
248
+ }
249
+ /** GET /_internal/v2/apps/:appId/task-traces */
250
+ interface TasksListResult {
251
+ traces: TaskTraceSummary[];
252
+ nextCursor: string | null;
253
+ }
254
+ /** GET /_internal/v2/apps/:appId/task-traces/:traceId */
255
+ interface TasksGetResult extends TaskTraceSummary {
256
+ /** The task's prompt as the model saw it (the output contract included). */
257
+ system: string | null;
258
+ tools: {
259
+ name: string;
260
+ description?: string;
261
+ }[];
262
+ messages: TaskTranscriptMessage[];
263
+ /** Turns whose record couldn't be read; the transcript has a hole there. */
264
+ missingTurns: number[];
265
+ }
266
+
267
+ /**
268
+ * Task log operations: every task agent (`runTask`) the app ran.
269
+ *
270
+ * Ops are pure: (ctx, params) → typed result, throwing AdminApiError /
271
+ * AdminTimeoutError. No printing, no process coupling — the CLI skin in
272
+ * commands/tasks.ts and the importable client both call these.
273
+ */
274
+
275
+ interface TasksListParams {
276
+ /** Max traces per page (default 20, server clamps to 100). */
277
+ limit?: number;
278
+ /** Pagination cursor from a prior page's `nextCursor`. */
279
+ cursor?: string;
280
+ }
281
+ /**
282
+ * Every task the app ran, newest started first, kept for 90 days.
283
+ *
284
+ * Returns cursored pages; pass `nextCursor` from one page as `cursor` for the
285
+ * next. Transcripts are not included — fetch one with `get`.
286
+ *
287
+ * `outcome`, `toolErrorCount` and `hasTurnError` are how you find the runs
288
+ * worth reading, and `devSession` separates your own dev runs from real
289
+ * traffic.
290
+ *
291
+ * @example
292
+ * const { traces } = await admin.tasks.list({ limit: 10 });
293
+ * const broken = traces.filter((t) => t.outcome !== 'answered' || t.toolErrorCount > 0);
294
+ */
295
+ declare function list$b(ctx: AdminContext, params?: TasksListParams): Promise<TasksListResult>;
296
+ /**
297
+ * One task with its full transcript: the prompt and tools it was given, its
298
+ * input, each turn's reply and reasoning, and every tool call with what came
299
+ * back.
300
+ *
301
+ * This is the primary tool for iterating on a task agent's prompt and tool
302
+ * descriptions — read what actually happened rather than guessing. A method
303
+ * tool's result carries a `requestId`; pass it to `requests.get()` for that
304
+ * call's input, output, stdout and error. `result.traceId` from `runTask()`
305
+ * is the id.
306
+ *
307
+ * @throws AdminApiError `task_trace_not_found` (404).
308
+ * @example
309
+ * const trace = await admin.tasks.get('0b9e…');
310
+ * console.log(trace.outcome, trace.messages);
311
+ */
312
+ declare function get$9(ctx: AdminContext, traceId: string): Promise<TasksGetResult>;
313
+
314
+ type tasks_TasksListParams = TasksListParams;
315
+ declare namespace tasks {
316
+ export { type tasks_TasksListParams as TasksListParams, get$9 as get, list$b as list };
317
+ }
318
+
169
319
  /**
170
320
  * Response types for the v2 analytics (insights) endpoints.
171
321
  *
@@ -1145,7 +1295,8 @@ interface OperationProgress {
1145
1295
  * bucket the source is connected to (`datasources sync`); `remap` runs the
1146
1296
  * live mapper over the source's own raw copies (`datasources remap`); `replay`
1147
1297
  * runs an earlier job's quarantined objects through the current mapper
1148
- * (`datasources jobs replay`).
1298
+ * (`datasources jobs replay`); `reread` reads the source's built documents
1299
+ * again with its live reader (`datasources reread`).
1149
1300
  */
1150
1301
  type DataSourceJobSource = {
1151
1302
  type: 'store';
@@ -1171,6 +1322,12 @@ type DataSourceJobSource = {
1171
1322
  type: 'replay';
1172
1323
  fromJobId: string;
1173
1324
  kind: 'skip' | 'error' | null;
1325
+ } | {
1326
+ type: 'reread';
1327
+ /** Only the documents the reader has not read. */
1328
+ unread: boolean;
1329
+ /** Only documents matching this metadata filter. */
1330
+ filter: Record<string, unknown> | null;
1174
1331
  };
1175
1332
  /**
1176
1333
  * planning → planned → running ⇄ paused → done | failed | cancelled.
@@ -1207,6 +1364,28 @@ interface DataSourceJobPlan {
1207
1364
  errorShare: number;
1208
1365
  deleteShare: number;
1209
1366
  secondsPerObject: number;
1367
+ /** What the mapper's own model and step calls billed per sampled object. */
1368
+ creditsPerObject?: number;
1369
+ /** What the sample's mapper calls billed, spent before the run began. */
1370
+ sampleCredits?: number;
1371
+ } | null;
1372
+ /**
1373
+ * Sources with a live reader: what reading costs. `history` prices it from
1374
+ * what the live reader has done (a hundred documents or more); `slice`
1375
+ * from a reread's first slice, read for real before the plan (its reads
1376
+ * are done, and the run leaves them out); null when unmeasured, and the
1377
+ * budget alone bounds the reader. The failure share is the baseline the
1378
+ * run's reader gate pauses against.
1379
+ */
1380
+ reading?: {
1381
+ measured: 'history' | 'slice' | null;
1382
+ creditsPerDocument: number | null;
1383
+ sampleCredits?: number;
1384
+ sampleDocuments?: number;
1385
+ sampleRead?: number;
1386
+ /** How much the live database grew per document the slice read. */
1387
+ bytesPerDocument?: number | null;
1388
+ baselineFailureShare?: number;
1210
1389
  } | null;
1211
1390
  projected: {
1212
1391
  documents: number;
@@ -1218,8 +1397,14 @@ interface DataSourceJobPlan {
1218
1397
  embedding: number;
1219
1398
  extraction: number;
1220
1399
  contextual: number;
1400
+ /** Mapped sources: the mapper's own calls over every object, the sample's included. */
1401
+ mapping?: number;
1402
+ /** Reader sources: the reader's own calls over every document, a slice's included. */
1403
+ reading?: number;
1221
1404
  total: number;
1222
1405
  };
1406
+ /** A reread: the live database's size once every document is read. */
1407
+ databaseBytes?: number | null;
1223
1408
  };
1224
1409
  capacity: {
1225
1410
  placement: 'shared' | 'dedicated';
@@ -1266,13 +1451,14 @@ interface DataSourceJob {
1266
1451
  pipelineId: string;
1267
1452
  source: DataSourceJobSource;
1268
1453
  /**
1269
- * Objects the mapper skipped or failed on. Counted on `jobs status`; on the
1270
- * list and on unmapped sources' jobs both are zero.
1454
+ * Objects the mapper skipped or failed on, and documents the reader failed
1455
+ * on. Counted on `jobs status`; null on the list.
1271
1456
  */
1272
1457
  quarantine: {
1273
1458
  skipped: number;
1274
1459
  errors: number;
1275
- };
1460
+ readErrors: number;
1461
+ } | null;
1276
1462
  state: DataSourceJobState;
1277
1463
  autoApprove: boolean;
1278
1464
  plan: DataSourceJobPlan | null;
@@ -1296,9 +1482,24 @@ interface DataSourceJob {
1296
1482
  embedTokens: number;
1297
1483
  extractionPages: number;
1298
1484
  };
1299
- /** Model spend so far at catalog rates — an estimate, not the ledger. */
1485
+ /**
1486
+ * Spend so far: embedding, extraction and contextual at catalog rates, plus
1487
+ * what the mapper's own calls billed. An estimate, not the ledger. The
1488
+ * budget pauses the job on it.
1489
+ */
1300
1490
  estimatedCredits: number;
1301
1491
  estimatedDollars: number;
1492
+ /**
1493
+ * What frames billed for their own calls: the mapper's and the reader's,
1494
+ * the plan's sample included.
1495
+ */
1496
+ mapperCredits?: number;
1497
+ mapperDollars?: number;
1498
+ /** A running job's read stage on a reader source: documents read of those cut. */
1499
+ reading?: {
1500
+ documentsRead: number;
1501
+ documentsTotal: number;
1502
+ } | null;
1302
1503
  /** Recent per-document failures, newest first, at most twenty. */
1303
1504
  samples: {
1304
1505
  ref: string;
@@ -1308,9 +1509,10 @@ interface DataSourceJob {
1308
1509
  error: string | null;
1309
1510
  /**
1310
1511
  * Why a running job stopped: the owner, the budget, repeated batch
1311
- * failures, or (mapped sources) a skip share far above the plan's.
1512
+ * failures, (mapped sources) a skip share far above the plan's, or (reader
1513
+ * sources) a reader failing on far more documents than it did at first.
1312
1514
  */
1313
- pauseReason: 'user' | 'budget' | 'errors' | 'skips' | null;
1515
+ pauseReason: 'user' | 'budget' | 'errors' | 'skips' | 'reader' | null;
1314
1516
  stalled: boolean;
1315
1517
  /** Times a pause for errors resumed itself on its own schedule. */
1316
1518
  autoResumes: number;
@@ -1786,12 +1988,16 @@ interface DataSourceRemapResult {
1786
1988
  slug: string;
1787
1989
  };
1788
1990
  }
1789
- /** One object a job's mapper did not turn into documents. */
1991
+ /**
1992
+ * One object a job's mapper did not turn into documents (`stage: 'map'`), or
1993
+ * one document its reader failed on (`stage: 'read'`).
1994
+ */
1790
1995
  interface DataSourceQuarantinedObject {
1791
1996
  id: string;
1792
- /** The key or URL the object was known by. */
1997
+ /** The key or URL the object was known by; a document id for a read. */
1793
1998
  ref: string;
1794
1999
  kind: 'skip' | 'error';
2000
+ stage: 'map' | 'read';
1795
2001
  reason: string;
1796
2002
  /** False when the object's raw copy never landed — a replay cannot reach it. */
1797
2003
  replayable: boolean;
@@ -1810,10 +2016,12 @@ interface DataSourceQuarantineResult {
1810
2016
  counts: {
1811
2017
  skipped: number;
1812
2018
  errors: number;
2019
+ readErrors: number;
1813
2020
  };
1814
2021
  /** Reasons by frequency, most common first. */
1815
2022
  reasons: {
1816
2023
  kind: 'skip' | 'error';
2024
+ stage: 'map' | 'read';
1817
2025
  reason: string;
1818
2026
  count: number;
1819
2027
  }[];
@@ -1821,6 +2029,104 @@ interface DataSourceQuarantineResult {
1821
2029
  nextCursor: string | null;
1822
2030
  }
1823
2031
 
2032
+ /**
2033
+ * Response types for data-source readers.
2034
+ *
2035
+ * Transcribed from youai-api:
2036
+ * src/roles/http/routes/Apps/manage/dataSources/readers.ts
2037
+ * src/customerApps/AppDataSources/reading.ts (liveReaderView)
2038
+ * src/customerApps/AppDataSources/dao/DeliveriesDao.ts (summary)
2039
+ */
2040
+
2041
+ /** The reader the live release declares for a source. */
2042
+ interface DataSourceReader {
2043
+ /** The reader file, from mindstudio.json. */
2044
+ path: string;
2045
+ export: string;
2046
+ /** Per delivery. */
2047
+ timeoutMs: number;
2048
+ /** Frames in flight for the source at once, across every carrier. */
2049
+ concurrency: number;
2050
+ releaseId: string;
2051
+ branch: string | null;
2052
+ commitSha: string;
2053
+ }
2054
+ /**
2055
+ * Where a source's standalone deliveries stand: what `add()`, `remove()`
2056
+ * and source deletion queued outside any job. Retrying ones back off 1, 5,
2057
+ * 15, 60 and 240 minutes; after that they park until `reader retry`.
2058
+ */
2059
+ interface DataSourceReaderDeliveries {
2060
+ pending: number;
2061
+ inFlight: number;
2062
+ retrying: number;
2063
+ parked: number;
2064
+ /** The newest failures, the document null for a `cleared`. */
2065
+ recentErrors: {
2066
+ documentId: string | null;
2067
+ error: string;
2068
+ at: string;
2069
+ }[];
2070
+ }
2071
+ /** POST /datasources/reader/status */
2072
+ interface DataSourceReaderStatusResult {
2073
+ /** Null when the live release declares no reader for the source. */
2074
+ reader: DataSourceReader | null;
2075
+ deliveries: DataSourceReaderDeliveries;
2076
+ /** Live documents the reader has not read (`reread --unread` reads them). */
2077
+ documents: {
2078
+ unread: number;
2079
+ };
2080
+ /**
2081
+ * What the live reader has done, since its bundle last changed: what a
2082
+ * plan prices reading from once it has read a hundred documents.
2083
+ */
2084
+ measured: {
2085
+ documents: number;
2086
+ failures: number;
2087
+ credits: number;
2088
+ creditsPerDocument: number | null;
2089
+ since: string;
2090
+ } | null;
2091
+ /** The live release's databases, in bytes; null when unknown. */
2092
+ database: {
2093
+ bytes: number | null;
2094
+ };
2095
+ }
2096
+ /** POST /datasources/reader/retry */
2097
+ interface DataSourceReaderRetryResult {
2098
+ /** Deliveries queued again. */
2099
+ retried: number;
2100
+ }
2101
+ /** One document's outcome in a reader test. */
2102
+ interface DataSourceReaderTestDocument {
2103
+ documentId: string;
2104
+ /**
2105
+ * `delivered`: the reader ran (a read, or a removal for a document removed
2106
+ * meanwhile); `failed`: it threw or timed out; `skipped`: nothing to read
2107
+ * (not built on the active version); `busy`: no slot on the source came
2108
+ * free in time.
2109
+ */
2110
+ status: 'delivered' | 'failed' | 'skipped' | 'busy';
2111
+ kind?: 'read' | 'removed';
2112
+ error?: string;
2113
+ }
2114
+ /** POST /datasources/reader/test */
2115
+ interface DataSourceReaderTestResult {
2116
+ dev: true;
2117
+ documents: DataSourceReaderTestDocument[];
2118
+ failed: number;
2119
+ durationMs: number;
2120
+ }
2121
+ /** POST /datasources/reread */
2122
+ interface DataSourceRereadResult {
2123
+ job: DataSourceJob;
2124
+ dataSource: {
2125
+ id: string;
2126
+ slug: string;
2127
+ };
2128
+ }
2129
+
1824
2130
  /**
1825
2131
  * Response types for the data-sources management API.
1826
2132
  *
@@ -1962,6 +2268,8 @@ interface DataSourcesDocument {
1962
2268
  sourceKey: string;
1963
2269
  /** App-supplied scalar metadata set at add time; filterable at search time. */
1964
2270
  metadata: Record<string, string | number | boolean> | null;
2271
+ /** Entities the document asserts, sorted; null when never set. */
2272
+ entities: string[] | null;
1965
2273
  createdAt: string;
1966
2274
  updatedAt: string;
1967
2275
  }
@@ -1979,6 +2287,7 @@ interface DataSourcesDocumentStatus {
1979
2287
  chunkCount: number | null;
1980
2288
  pageCount: number | null;
1981
2289
  metadata: Record<string, string | number | boolean> | null;
2290
+ entities: string[] | null;
1982
2291
  ingestedAt: string | null;
1983
2292
  }
1984
2293
  /**
@@ -2081,6 +2390,64 @@ interface DataSourcesMigration {
2081
2390
  /** The copy in the one progress shape, with the platform's measured rate and ETA. */
2082
2391
  progress: OperationProgress;
2083
2392
  }
2393
+ /** A source's committed dictionary: what a push reports, and what the source reads back. */
2394
+ interface DataSourcesDictionaryReport {
2395
+ version: number;
2396
+ /** The matching rule its names were keyed under, carried from push to push. */
2397
+ linkerVersion: number;
2398
+ entries: number;
2399
+ names: number;
2400
+ /** Names more than one id claims: each tags every claimant. */
2401
+ ambiguousNames: number;
2402
+ /** The names (as matched: folded, separators dropped) the most ids claim. */
2403
+ mostClaimed: {
2404
+ key: string;
2405
+ ids: number;
2406
+ }[];
2407
+ /** Names that can't match their own text as written, with a few of them. */
2408
+ unmatchable: {
2409
+ count: number;
2410
+ examples: string[];
2411
+ };
2412
+ committedAt: string;
2413
+ }
2414
+ /** POST /datasources/dictionary/commit. */
2415
+ interface DataSourcesDictionaryPushResult extends DataSourcesDictionaryReport {
2416
+ /** The push equalled the committed dictionary: no new version, no relink. */
2417
+ unchanged: boolean;
2418
+ }
2419
+ /**
2420
+ * A relink in flight: a version's passages re-tagged against the source's
2421
+ * newer dictionary, a lap at a time. A commit mid-lap marks the lap to run
2422
+ * once more, which writes little.
2423
+ */
2424
+ interface DataSourcesRelink {
2425
+ version: number;
2426
+ lap: number;
2427
+ walked: number;
2428
+ total: number;
2429
+ rewritten: number;
2430
+ startedAt: string;
2431
+ /** Why the lap is holding (the source's dedicated capacity is off). */
2432
+ waiting: string | null;
2433
+ error: string | null;
2434
+ progress: OperationProgress;
2435
+ }
2436
+ /** POST /datasources/dictionary. */
2437
+ interface DataSourcesDictionaryStatus {
2438
+ dictionary: DataSourcesDictionaryReport | null;
2439
+ relink: DataSourcesRelink | null;
2440
+ candidateRelink: DataSourcesRelink | null;
2441
+ }
2442
+ /** POST /datasources/link. */
2443
+ interface DataSourcesLinkResult {
2444
+ /** The dictionary version that linked, or null when the source has none. */
2445
+ version: number | null;
2446
+ mentions: {
2447
+ ids: string[];
2448
+ text: string;
2449
+ }[];
2450
+ }
2084
2451
  /** One data source in the GET /datasources listing. */
2085
2452
  interface DataSourcesListEntry {
2086
2453
  id: string;
@@ -2112,6 +2479,10 @@ interface DataSourcesListEntry {
2112
2479
  connector: DataSourceConnector | null;
2113
2480
  /** An index reload in flight after an eviction, or its last failure. */
2114
2481
  hydration: DataSourcesHydration | null;
2482
+ /** The source's current dictionary, or null when none was pushed. */
2483
+ dictionary: DataSourcesDictionaryReport | null;
2484
+ /** A relink of the active version onto the dictionary, while one runs. */
2485
+ relink: DataSourcesRelink | null;
2115
2486
  /**
2116
2487
  * Dedicated capacity only; null on the shared pool. `building` while the
2117
2488
  * optimizer is behind the writes, `ready` otherwise. Search answers
@@ -2122,6 +2493,10 @@ interface DataSourcesListEntry {
2122
2493
  sampleOf: string | null;
2123
2494
  /** The mapper the live release declares for this source, or null. */
2124
2495
  mapper: DataSourceMapper | null;
2496
+ /** The reader the live release declares for this source, or null. */
2497
+ reader: (DataSourceReader & {
2498
+ deliveries: DataSourceReaderDeliveries;
2499
+ }) | null;
2125
2500
  createdAt: string;
2126
2501
  }
2127
2502
  /** GET /datasources — all data sources for the app. */
@@ -2149,6 +2524,8 @@ interface DataSourcesSearchCitation {
2149
2524
  interface DataSourcesSearchResultItem {
2150
2525
  score: number;
2151
2526
  text: string;
2527
+ /** The entities this passage carries (its document's asserted ids). */
2528
+ entities: string[];
2152
2529
  citation: DataSourcesSearchCitation;
2153
2530
  /** Rank and score from retrieval, before reranking. */
2154
2531
  retrievalRank?: number;
@@ -2179,6 +2556,19 @@ interface DataSourcesCountResult {
2179
2556
  pipelineVersion: number;
2180
2557
  latencyMs: number;
2181
2558
  }
2559
+ /**
2560
+ * POST /datasources/entities. The entities the passages matching a filter are
2561
+ * about, most first. `chunks` is passages carrying each id, not documents, and
2562
+ * approximate.
2563
+ */
2564
+ interface DataSourcesEntitiesResult {
2565
+ entities: {
2566
+ id: string;
2567
+ chunks: number;
2568
+ }[];
2569
+ pipelineVersion: number;
2570
+ latencyMs: number;
2571
+ }
2182
2572
  /**
2183
2573
  * POST /datasources/search.
2184
2574
  *
@@ -2358,6 +2748,11 @@ interface AddDocumentParams {
2358
2748
  * `string | number | boolean` values).
2359
2749
  */
2360
2750
  metadata?: Record<string, string | number | boolean>;
2751
+ /**
2752
+ * What the document is about, as the app's own ids (≤ 256, printable ASCII,
2753
+ * no whitespace or commas). Every passage carries them; `[]` clears them.
2754
+ */
2755
+ entities?: string[];
2361
2756
  /**
2362
2757
  * Receives the exact progress strings the CLI prints today:
2363
2758
  * - `${filename}: unchanged, skipped`
@@ -2574,6 +2969,30 @@ interface CountParams {
2574
2969
  * const { chunks } = await admin.dataSources.count({ slug: 'policies', filter: { contains: 'notice period' } });
2575
2970
  */
2576
2971
  declare function count(ctx: AdminContext, params: CountParams): Promise<DataSourcesCountResult>;
2972
+ interface EntitiesParams {
2973
+ /** Data source slug. */
2974
+ slug: string;
2975
+ /** Same grammar as search's filter; absent covers the whole corpus. */
2976
+ filter?: Record<string, unknown>;
2977
+ /** Entities to return, most first (default 20, at most 100). */
2978
+ limit?: number;
2979
+ /** Read the candidate version instead of the live one. */
2980
+ candidate?: boolean;
2981
+ }
2982
+ /**
2983
+ * Which entities the passages matching a filter are about, most first.
2984
+ *
2985
+ * Filtered on one entity, it answers what appears beside it: a co-mention
2986
+ * graph. `chunks` counts passages carrying each id, not documents, and is
2987
+ * approximate.
2988
+ *
2989
+ * @throws AdminApiError `invalid_filter` (400); `no_candidate_pipeline` (404)
2990
+ * with `candidate: true` and no revectorization in flight; `index_warming` /
2991
+ * `index_building` (503) while the corpus is loading or building.
2992
+ * @example
2993
+ * const { entities } = await admin.dataSources.entities({ slug: 'manuals', filter: { entities: ['P-101A'] } });
2994
+ */
2995
+ declare function entities(ctx: AdminContext, params: EntitiesParams): Promise<DataSourcesEntitiesResult>;
2577
2996
  /**
2578
2997
  * Read the full pipeline configuration for one data source.
2579
2998
  *
@@ -2852,6 +3271,48 @@ declare function rmWhereAll(ctx: AdminContext, params: RmWhereParams & {
2852
3271
  * const { documents, versions } = await admin.dataSources.deleteSource('policies');
2853
3272
  */
2854
3273
  declare function deleteSource(ctx: AdminContext, slug: string): Promise<DataSourcesDeleteResult>;
3274
+ /** One dictionary entry: the app's id for a thing and the names it goes by. */
3275
+ interface DictionaryEntryInput {
3276
+ id: string;
3277
+ names: string[];
3278
+ }
3279
+ /**
3280
+ * Push a source's dictionary, replacing the one it had: a stage, its pages
3281
+ * (each retried alone), and the commit. A new version re-tags the source's
3282
+ * passages in the background; an unchanged one commits nothing.
3283
+ *
3284
+ * @throws AdminApiError `invalid_dictionary` / `dictionary_name_too_short` (400)
3285
+ * on a page, naming the entry; `dictionary_too_large` (400) at the commit.
3286
+ * @example
3287
+ * await admin.dataSources.pushDictionary({ slug: 'manuals', entries: [{ id: 'P-101A', names: ['P-101A', 'Main Feed Pump'] }] });
3288
+ */
3289
+ declare function pushDictionary(ctx: AdminContext, params: {
3290
+ slug: string;
3291
+ entries: DictionaryEntryInput[];
3292
+ linkerVersion?: number;
3293
+ onProgress?: (sent: number, total: number) => void;
3294
+ }): Promise<DataSourcesDictionaryPushResult>;
3295
+ /**
3296
+ * A source's current dictionary, and the relinks re-tagging its versions
3297
+ * while they run.
3298
+ *
3299
+ * @throws AdminApiError `data_source_not_found` (404).
3300
+ */
3301
+ declare function dictionary(ctx: AdminContext, params: {
3302
+ slug: string;
3303
+ }): Promise<DataSourcesDictionaryStatus>;
3304
+ /**
3305
+ * What the source's current dictionary finds in a piece of text: each
3306
+ * mention, in order, with the ids it tags.
3307
+ *
3308
+ * @throws AdminApiError `data_source_not_found` (404).
3309
+ * @example
3310
+ * const { mentions } = await admin.dataSources.link({ slug: 'manuals', text: 'Replaced the seal on P101A.' });
3311
+ */
3312
+ declare function link(ctx: AdminContext, params: {
3313
+ slug: string;
3314
+ text: string;
3315
+ }): Promise<DataSourcesLinkResult>;
2855
3316
 
2856
3317
  type dataSources_AddDocumentParams = AddDocumentParams;
2857
3318
  type dataSources_AddDocumentResult = AddDocumentResult;
@@ -2859,8 +3320,10 @@ type dataSources_ConfigSetParams = ConfigSetParams;
2859
3320
  type dataSources_CountParams = CountParams;
2860
3321
  type dataSources_CreateParams = CreateParams;
2861
3322
  declare const dataSources_DOCUMENTS_IDS_MAX: typeof DOCUMENTS_IDS_MAX;
3323
+ type dataSources_DictionaryEntryInput = DictionaryEntryInput;
2862
3324
  type dataSources_DocumentsParams = DocumentsParams;
2863
3325
  type dataSources_DropParams = DropParams;
3326
+ type dataSources_EntitiesParams = EntitiesParams;
2864
3327
  declare const dataSources_FAILURES_PAGE: typeof FAILURES_PAGE;
2865
3328
  type dataSources_MoveParams = MoveParams;
2866
3329
  type dataSources_PromoteParams = PromoteParams;
@@ -2881,10 +3344,14 @@ declare const dataSources_configGet: typeof configGet;
2881
3344
  declare const dataSources_configSet: typeof configSet;
2882
3345
  declare const dataSources_count: typeof count;
2883
3346
  declare const dataSources_deleteSource: typeof deleteSource;
3347
+ declare const dataSources_dictionary: typeof dictionary;
2884
3348
  declare const dataSources_documents: typeof documents;
2885
3349
  declare const dataSources_drop: typeof drop;
3350
+ declare const dataSources_entities: typeof entities;
3351
+ declare const dataSources_link: typeof link;
2886
3352
  declare const dataSources_move: typeof move;
2887
3353
  declare const dataSources_promote: typeof promote;
3354
+ declare const dataSources_pushDictionary: typeof pushDictionary;
2888
3355
  declare const dataSources_revectorize: typeof revectorize;
2889
3356
  declare const dataSources_rm: typeof rm;
2890
3357
  declare const dataSources_rmWhere: typeof rmWhere;
@@ -2896,7 +3363,7 @@ declare const dataSources_waitForCandidate: typeof waitForCandidate;
2896
3363
  declare const dataSources_waitForIngest: typeof waitForIngest;
2897
3364
  declare const dataSources_waitForMove: typeof waitForMove;
2898
3365
  declare namespace dataSources {
2899
- 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 };
3366
+ 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_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_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 };
2900
3367
  }
2901
3368
 
2902
3369
  /**
@@ -3474,6 +3941,8 @@ declare function remap(ctx: AdminContext, params: RemapParams): Promise<DataSour
3474
3941
  interface QuarantineParams {
3475
3942
  id: string;
3476
3943
  kind?: 'skip' | 'error';
3944
+ /** Only the mapper's (`map`) or only the reader's (`read`). */
3945
+ stage?: 'map' | 'read';
3477
3946
  /** Only objects quarantined with exactly this reason. */
3478
3947
  reason?: string;
3479
3948
  cursor?: string;
@@ -3481,8 +3950,8 @@ interface QuarantineParams {
3481
3950
  limit?: number;
3482
3951
  }
3483
3952
  /**
3484
- * What a job's mapper skipped or failed on: counts, reasons by frequency, and
3485
- * a page of objects.
3953
+ * What a job's mapper skipped or failed on, and what its reader failed on:
3954
+ * counts, reasons by frequency, and a page of objects.
3486
3955
  *
3487
3956
  * @throws AdminApiError `job_not_found` (404).
3488
3957
  */
@@ -3945,20 +4414,21 @@ declare namespace domains {
3945
4414
  }
3946
4415
 
3947
4416
  /**
3948
- * Response shapes for the email command group — transcribed from youai-api.
4417
+ * Response shapes for the email command group — transcribed from the api
4418
+ * (apps/api/src).
3949
4419
  *
3950
4420
  * Sources:
3951
- * src/http/routes/V2Apps/manage/outboundEmail.ts
3952
- * src/http/routes/V2Apps/manage/outboundEmailDomains.ts
3953
- * src/http/routes/V2Apps/manage/emailDomains.ts
3954
- * src/http/routes/V2Apps/manage/requestLog.ts (inbox route only)
3955
- * src/common/Db/v2Apps/V2EmailMessagesDao/index.ts
3956
- * src/common/Db/v2Apps/V2EmailBatchesDao/index.ts
3957
- * src/common/Db/v2Apps/V2EmailTenantStateDao/index.ts
3958
- * src/common/Db/v2Apps/AppEmailSuppressionsDao/index.ts
3959
- * src/common/OutboundEmail/batchView.ts
3960
- * src/common/Aws/SesIdentityService.ts
3961
- * src/common/Db/v2Apps/RequestLogDao.ts
4421
+ * roles/http/routes/Apps/manage/outboundEmail.ts
4422
+ * roles/http/routes/Apps/manage/outboundEmailDomains.ts
4423
+ * roles/http/routes/_helpers/outboundEmailDomainView.ts
4424
+ * roles/http/routes/Apps/manage/emailDomains.ts
4425
+ * roles/http/routes/Apps/manage/requestLog.ts (inbox route only)
4426
+ * customerApps/AppOutboundEmail/dao/EmailMessagesDao.ts
4427
+ * customerApps/AppOutboundEmail/dao/EmailBatchesDao.ts
4428
+ * customerApps/AppOutboundEmail/dao/EmailTenantStateDao.ts
4429
+ * customerApps/AppOutboundEmail/dao/AppEmailSuppressionsDao.ts
4430
+ * customerApps/AppOutboundEmail/batchView.ts
4431
+ * core/EmailTransport/drivers/index.ts
3962
4432
  */
3963
4433
  /** Per-recipient outbound delivery status. */
3964
4434
  type EmailMessageStatus = 'suppressed' | 'failed' | 'sent' | 'delivered' | 'blocked' | 'bounced' | 'complained' | 'delayed' | 'rejected';
@@ -4053,9 +4523,10 @@ interface AppEmailSuppression {
4053
4523
  createdAt: string;
4054
4524
  }
4055
4525
  /**
4056
- * SES account-level suppression entry (SesIdentityService.getPlatformSuppression).
4057
- * Non-null means this address stays blocked even after removing the app-level row —
4058
- * the platform list is account-wide and is never cleared by the CLI.
4526
+ * The email provider's account-level suppression entry (on SES, its account
4527
+ * suppression list). Non-null means this address stays blocked even after
4528
+ * removing the app-level row — the provider's list is account-wide and is
4529
+ * never cleared by the CLI. Always null where the provider keeps none.
4059
4530
  */
4060
4531
  interface PlatformSuppression {
4061
4532
  /** SES-reported reason, e.g. 'BOUNCE' or 'COMPLAINT'. */
@@ -4087,18 +4558,24 @@ interface EmailDomainBase {
4087
4558
  }
4088
4559
  /** Visual verification status on the outbound-domains settings UI. */
4089
4560
  type OutboundEmailDomainUiStatus = 'verified' | 'action_needed' | 'pending';
4090
- /** DNS records to create at the customer's DNS host for outbound sending. */
4561
+ /** One DNS record to create at the customer's DNS host. */
4562
+ interface OutboundDnsRecord {
4563
+ type: 'CNAME' | 'TXT' | 'MX';
4564
+ /** Fully qualified. */
4565
+ name: string;
4566
+ value: string;
4567
+ /** MX records only. */
4568
+ priority?: number;
4569
+ /** False for a record verification doesn't wait on (an SPF include, a return path). */
4570
+ required: boolean;
4571
+ }
4572
+ /**
4573
+ * DNS records to create at the customer's DNS host for outbound sending:
4574
+ * whatever the deployment's email provider issues (on SES, three DKIM CNAMEs,
4575
+ * all required, and an SPF TXT, recommended; merge it into an existing one).
4576
+ */
4091
4577
  interface OutboundDnsInstructions {
4092
- /** Three DKIM CNAME records — all required for SES identity verification. */
4093
- cnameRecords: Array<{
4094
- name: string;
4095
- value: string;
4096
- }>;
4097
- /** Recommended SPF TXT record; merge with an existing one if present. */
4098
- recommendedSpf: {
4099
- name: string;
4100
- value: string;
4101
- };
4578
+ records: OutboundDnsRecord[];
4102
4579
  }
4103
4580
  /** Outbound (sending) domain view shape (outboundEmailDomains.ts toView). */
4104
4581
  interface OutboundEmailDomainView extends EmailDomainBase {
@@ -4139,11 +4616,13 @@ interface InboundEmailDomainView extends EmailDomainBase {
4139
4616
  }
4140
4617
  /**
4141
4618
  * Which rung of the sender fallback chain won. `app_domain` / `org_domain` /
4142
- * `subdomain` / `default` are the no-`from` default-sender tiers; `custom_from`
4143
- * is a caller-supplied handle on an owned domain; `sendgrid` is the v1 path.
4144
- * (OutboundSenderTier in youai-api resolveOutboundFromAddress.ts.)
4619
+ * `subdomain` / `default` / `deployment` are the no-`from` default-sender
4620
+ * tiers (`deployment` is the deployment's own address, where its email
4621
+ * transport has one); `custom_from` is a caller-supplied handle on an owned
4622
+ * domain; `sendgrid` is the v1 path. (OutboundSenderTier in the api's
4623
+ * customerApps/AppOutboundEmail/resolveOutboundFromAddress.ts.)
4145
4624
  */
4146
- type EmailSenderTier = 'app_domain' | 'org_domain' | 'subdomain' | 'default' | 'custom_from' | 'sendgrid';
4625
+ type EmailSenderTier = 'app_domain' | 'org_domain' | 'subdomain' | 'default' | 'deployment' | 'custom_from' | 'sendgrid';
4147
4626
  /** Effective sender resolved from the fallback chain (outbound-email-domains list). */
4148
4627
  interface EmailEffectiveSender {
4149
4628
  address: string;
@@ -4264,7 +4743,11 @@ interface EmailInboxResult {
4264
4743
  /** email domains list → GET /settings/outbound-email-domains */
4265
4744
  interface OutboundEmailDomainsListResult {
4266
4745
  domains: OutboundEmailDomainView[];
4267
- effectiveSender: EmailEffectiveSender;
4746
+ /** Null where the deployment sends no email (`emailConfigured` false). */
4747
+ effectiveSender: EmailEffectiveSender | null;
4748
+ emailConfigured: boolean;
4749
+ /** False where every app sends from the deployment's address, so there's no domain to add. */
4750
+ sendingDomainsAvailable: boolean;
4268
4751
  }
4269
4752
  /** email domains check → POST /settings/outbound-email-domains/check-domain */
4270
4753
  interface OutboundEmailDomainCheckResult {
@@ -4368,7 +4851,7 @@ interface EmailInboxParams {
4368
4851
  cursor?: string;
4369
4852
  limit?: number;
4370
4853
  }
4371
- /** Direction of mail flow: `sending` = outbound (SES identity/DKIM); `inbound` = receiving (MX). */
4854
+ /** Direction of mail flow: `sending` = outbound (a domain at the email provider); `inbound` = receiving (MX). */
4372
4855
  type DomainDirection = 'sending' | 'inbound';
4373
4856
  /**
4374
4857
  * Direction-conditional result selector: maps a literal `DomainDirection` to
@@ -6128,6 +6611,16 @@ interface ReleasesByCommitResult extends ReleaseFailureFields {
6128
6611
  * Synthesised synchronously from the release id by buildPreviewUrl().
6129
6612
  */
6130
6613
  previewUrl: string | null;
6614
+ /**
6615
+ * The data sources this release declares app code for. A live release's
6616
+ * reader entries carry `readerUnread`: the source's documents its reader
6617
+ * hadn't read when the release went live.
6618
+ */
6619
+ dataSources?: {
6620
+ slug: string;
6621
+ reader?: unknown;
6622
+ readerUnread?: number;
6623
+ }[];
6131
6624
  }
6132
6625
  /** A compiled method entry as it appears on a live release. */
6133
6626
  interface DashboardReleaseMethod {
@@ -6625,6 +7118,15 @@ interface ReleaseSummary {
6625
7118
  failureKind?: 'build' | 'interrupted' | 'unbuildable';
6626
7119
  /** Build stage that was running when it failed; only when `failed`. */
6627
7120
  failurePhase?: string;
7121
+ /**
7122
+ * Each data source whose reader this live release brought live, with the
7123
+ * documents it hasn't read: what `datasources reread --unread` reads, priced
7124
+ * first. Absent when the release declares no reader.
7125
+ */
7126
+ readers?: {
7127
+ slug: string;
7128
+ unread: number;
7129
+ }[];
6628
7130
  }
6629
7131
  /**
6630
7132
  * Terminal outcome of a `waitForCommit` call.
@@ -7669,7 +8171,7 @@ interface AdminClientOptions {
7669
8171
  * pass explicitly anywhere that file doesn't exist.
7670
8172
  */
7671
8173
  appId?: string;
7672
- /** API origin. Falls back to API_BASE_URL, then the production default. */
8174
+ /** API origin. Falls back to MINDSTUDIO_BASE_URL, then the production default. */
7673
8175
  baseUrl?: string;
7674
8176
  }
7675
8177
  /** An ops module with the AdminContext pre-applied to every function. */
@@ -7689,6 +8191,7 @@ declare function buildClient(ctx: AdminContext): {
7689
8191
  */
7690
8192
  forApp(appId: string): /*elided*/ any;
7691
8193
  agent: BoundOps<typeof agent>;
8194
+ tasks: BoundOps<typeof tasks>;
7692
8195
  analytics: BoundOps<typeof analytics>;
7693
8196
  events: BoundOps<typeof appEvents>;
7694
8197
  crashes: BoundOps<typeof crashes>;
@@ -7776,4 +8279,4 @@ declare class AdminTimeoutError extends Error {
7776
8279
 
7777
8280
  declare const admin: AdminClient;
7778
8281
 
7779
- 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 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 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 };
8282
+ 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 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 };