@madewithremy/admin 0.1.30 → 0.1.31

package/dist/index.d.ts

@@ -1295,7 +1295,8 @@ interface OperationProgress {
  * bucket the source is connected to (`datasources sync`); `remap` runs the
  * live mapper over the source's own raw copies (`datasources remap`); `replay`
  * runs an earlier job's quarantined objects through the current mapper
- * (`datasources jobs replay`).
+ * (`datasources jobs replay`); `reread` reads the source's built documents
+ * again with its live reader (`datasources reread`).
  */
 type DataSourceJobSource = {
     type: 'store';
@@ -1321,6 +1322,12 @@ type DataSourceJobSource = {
     type: 'replay';
     fromJobId: string;
     kind: 'skip' | 'error' | null;
+} | {
+    type: 'reread';
+    /** Only the documents the reader has not read. */
+    unread: boolean;
+    /** Only documents matching this metadata filter. */
+    filter: Record<string, unknown> | null;
 };
 /**
  * planning → planned → running ⇄ paused → done | failed | cancelled.
@@ -1357,6 +1364,28 @@ interface DataSourceJobPlan {
         errorShare: number;
         deleteShare: number;
         secondsPerObject: number;
+        /** What the mapper's own model and step calls billed per sampled object. */
+        creditsPerObject?: number;
+        /** What the sample's mapper calls billed, spent before the run began. */
+        sampleCredits?: number;
+    } | null;
+    /**
+     * Sources with a live reader: what reading costs. `history` prices it from
+     * what the live reader has done (a hundred documents or more); `slice`
+     * from a reread's first slice, read for real before the plan (its reads
+     * are done, and the run leaves them out); null when unmeasured, and the
+     * budget alone bounds the reader. The failure share is the baseline the
+     * run's reader gate pauses against.
+     */
+    reading?: {
+        measured: 'history' | 'slice' | null;
+        creditsPerDocument: number | null;
+        sampleCredits?: number;
+        sampleDocuments?: number;
+        sampleRead?: number;
+        /** How much the live database grew per document the slice read. */
+        bytesPerDocument?: number | null;
+        baselineFailureShare?: number;
     } | null;
     projected: {
         documents: number;
@@ -1368,8 +1397,14 @@ interface DataSourceJobPlan {
             embedding: number;
             extraction: number;
             contextual: number;
+            /** Mapped sources: the mapper's own calls over every object, the sample's included. */
+            mapping?: number;
+            /** Reader sources: the reader's own calls over every document, a slice's included. */
+            reading?: number;
             total: number;
         };
+        /** A reread: the live database's size once every document is read. */
+        databaseBytes?: number | null;
     };
     capacity: {
         placement: 'shared' | 'dedicated';
@@ -1416,13 +1451,14 @@ interface DataSourceJob {
     pipelineId: string;
     source: DataSourceJobSource;
     /**
-     * Objects the mapper skipped or failed on. Counted on `jobs status`; on the
-     * list and on unmapped sources' jobs both are zero.
+     * Objects the mapper skipped or failed on, and documents the reader failed
+     * on. Counted on `jobs status`; null on the list.
      */
     quarantine: {
         skipped: number;
         errors: number;
-    };
+        readErrors: number;
+    } | null;
     state: DataSourceJobState;
     autoApprove: boolean;
     plan: DataSourceJobPlan | null;
@@ -1446,9 +1482,24 @@ interface DataSourceJob {
         embedTokens: number;
         extractionPages: number;
     };
-    /** Model spend so far at catalog rates — an estimate, not the ledger. */
+    /**
+     * Spend so far: embedding, extraction and contextual at catalog rates, plus
+     * what the mapper's own calls billed. An estimate, not the ledger. The
+     * budget pauses the job on it.
+     */
     estimatedCredits: number;
     estimatedDollars: number;
+    /**
+     * What frames billed for their own calls: the mapper's and the reader's,
+     * the plan's sample included.
+     */
+    mapperCredits?: number;
+    mapperDollars?: number;
+    /** A running job's read stage on a reader source: documents read of those cut. */
+    reading?: {
+        documentsRead: number;
+        documentsTotal: number;
+    } | null;
     /** Recent per-document failures, newest first, at most twenty. */
     samples: {
         ref: string;
@@ -1458,9 +1509,10 @@ interface DataSourceJob {
     error: string | null;
     /**
      * Why a running job stopped: the owner, the budget, repeated batch
-     * failures, or (mapped sources) a skip share far above the plan's.
+     * failures, (mapped sources) a skip share far above the plan's, or (reader
+     * sources) a reader failing on far more documents than it did at first.
      */
-    pauseReason: 'user' | 'budget' | 'errors' | 'skips' | null;
+    pauseReason: 'user' | 'budget' | 'errors' | 'skips' | 'reader' | null;
     stalled: boolean;
     /** Times a pause for errors resumed itself on its own schedule. */
     autoResumes: number;
@@ -1936,12 +1988,16 @@ interface DataSourceRemapResult {
         slug: string;
     };
 }
-/** One object a job's mapper did not turn into documents. */
+/**
+ * One object a job's mapper did not turn into documents (`stage: 'map'`), or
+ * one document its reader failed on (`stage: 'read'`).
+ */
 interface DataSourceQuarantinedObject {
     id: string;
-    /** The key or URL the object was known by. */
+    /** The key or URL the object was known by; a document id for a read. */
     ref: string;
     kind: 'skip' | 'error';
+    stage: 'map' | 'read';
     reason: string;
     /** False when the object's raw copy never landed — a replay cannot reach it. */
     replayable: boolean;
@@ -1960,10 +2016,12 @@ interface DataSourceQuarantineResult {
     counts: {
         skipped: number;
         errors: number;
+        readErrors: number;
     };
     /** Reasons by frequency, most common first. */
     reasons: {
         kind: 'skip' | 'error';
+        stage: 'map' | 'read';
         reason: string;
         count: number;
     }[];
@@ -1971,6 +2029,104 @@ interface DataSourceQuarantineResult {
     nextCursor: string | null;
 }
 
+/**
+ * Response types for data-source readers.
+ *
+ * Transcribed from youai-api:
+ *   src/roles/http/routes/Apps/manage/dataSources/readers.ts
+ *   src/customerApps/AppDataSources/reading.ts (liveReaderView)
+ *   src/customerApps/AppDataSources/dao/DeliveriesDao.ts (summary)
+ */
+
+/** The reader the live release declares for a source. */
+interface DataSourceReader {
+    /** The reader file, from mindstudio.json. */
+    path: string;
+    export: string;
+    /** Per delivery. */
+    timeoutMs: number;
+    /** Frames in flight for the source at once, across every carrier. */
+    concurrency: number;
+    releaseId: string;
+    branch: string | null;
+    commitSha: string;
+}
+/**
+ * Where a source's standalone deliveries stand: what `add()`, `remove()`
+ * and source deletion queued outside any job. Retrying ones back off 1, 5,
+ * 15, 60 and 240 minutes; after that they park until `reader retry`.
+ */
+interface DataSourceReaderDeliveries {
+    pending: number;
+    inFlight: number;
+    retrying: number;
+    parked: number;
+    /** The newest failures, the document null for a `cleared`. */
+    recentErrors: {
+        documentId: string | null;
+        error: string;
+        at: string;
+    }[];
+}
+/** POST /datasources/reader/status */
+interface DataSourceReaderStatusResult {
+    /** Null when the live release declares no reader for the source. */
+    reader: DataSourceReader | null;
+    deliveries: DataSourceReaderDeliveries;
+    /** Live documents the reader has not read (`reread --unread` reads them). */
+    documents: {
+        unread: number;
+    };
+    /**
+     * What the live reader has done, since its bundle last changed: what a
+     * plan prices reading from once it has read a hundred documents.
+     */
+    measured: {
+        documents: number;
+        failures: number;
+        credits: number;
+        creditsPerDocument: number | null;
+        since: string;
+    } | null;
+    /** The live release's databases, in bytes; null when unknown. */
+    database: {
+        bytes: number | null;
+    };
+}
+/** POST /datasources/reader/retry */
+interface DataSourceReaderRetryResult {
+    /** Deliveries queued again. */
+    retried: number;
+}
+/** One document's outcome in a reader test. */
+interface DataSourceReaderTestDocument {
+    documentId: string;
+    /**
+     * `delivered`: the reader ran (a read, or a removal for a document removed
+     * meanwhile); `failed`: it threw or timed out; `skipped`: nothing to read
+     * (not built on the active version); `busy`: no slot on the source came
+     * free in time.
+     */
+    status: 'delivered' | 'failed' | 'skipped' | 'busy';
+    kind?: 'read' | 'removed';
+    error?: string;
+}
+/** POST /datasources/reader/test */
+interface DataSourceReaderTestResult {
+    dev: true;
+    documents: DataSourceReaderTestDocument[];
+    failed: number;
+    durationMs: number;
+}
+/** POST /datasources/reread */
+interface DataSourceRereadResult {
+    job: DataSourceJob;
+    dataSource: {
+        id: string;
+        slug: string;
+    };
+}
+
 /**
  * Response types for the data-sources management API.
  *
@@ -2112,6 +2268,8 @@ interface DataSourcesDocument {
     sourceKey: string;
     /** App-supplied scalar metadata set at add time; filterable at search time. */
     metadata: Record<string, string | number | boolean> | null;
+    /** Entities the document asserts, sorted; null when never set. */
+    entities: string[] | null;
     createdAt: string;
     updatedAt: string;
 }
@@ -2129,6 +2287,7 @@ interface DataSourcesDocumentStatus {
     chunkCount: number | null;
     pageCount: number | null;
     metadata: Record<string, string | number | boolean> | null;
+    entities: string[] | null;
     ingestedAt: string | null;
 }
 /**
@@ -2231,6 +2390,64 @@ interface DataSourcesMigration {
     /** The copy in the one progress shape, with the platform's measured rate and ETA. */
     progress: OperationProgress;
 }
+/** A source's committed dictionary: what a push reports, and what the source reads back. */
+interface DataSourcesDictionaryReport {
+    version: number;
+    /** The matching rule its names were keyed under, carried from push to push. */
+    linkerVersion: number;
+    entries: number;
+    names: number;
+    /** Names more than one id claims: each tags every claimant. */
+    ambiguousNames: number;
+    /** The names (as matched: folded, separators dropped) the most ids claim. */
+    mostClaimed: {
+        key: string;
+        ids: number;
+    }[];
+    /** Names that can't match their own text as written, with a few of them. */
+    unmatchable: {
+        count: number;
+        examples: string[];
+    };
+    committedAt: string;
+}
+/** POST /datasources/dictionary/commit. */
+interface DataSourcesDictionaryPushResult extends DataSourcesDictionaryReport {
+    /** The push equalled the committed dictionary: no new version, no relink. */
+    unchanged: boolean;
+}
+/**
+ * A relink in flight: a version's passages re-tagged against the source's
+ * newer dictionary, a lap at a time. A commit mid-lap marks the lap to run
+ * once more, which writes little.
+ */
+interface DataSourcesRelink {
+    version: number;
+    lap: number;
+    walked: number;
+    total: number;
+    rewritten: number;
+    startedAt: string;
+    /** Why the lap is holding (the source's dedicated capacity is off). */
+    waiting: string | null;
+    error: string | null;
+    progress: OperationProgress;
+}
+/** POST /datasources/dictionary. */
+interface DataSourcesDictionaryStatus {
+    dictionary: DataSourcesDictionaryReport | null;
+    relink: DataSourcesRelink | null;
+    candidateRelink: DataSourcesRelink | null;
+}
+/** POST /datasources/link. */
+interface DataSourcesLinkResult {
+    /** The dictionary version that linked, or null when the source has none. */
+    version: number | null;
+    mentions: {
+        ids: string[];
+        text: string;
+    }[];
+}
 /** One data source in the GET /datasources listing. */
 interface DataSourcesListEntry {
     id: string;
@@ -2262,6 +2479,10 @@ interface DataSourcesListEntry {
     connector: DataSourceConnector | null;
     /** An index reload in flight after an eviction, or its last failure. */
     hydration: DataSourcesHydration | null;
+    /** The source's current dictionary, or null when none was pushed. */
+    dictionary: DataSourcesDictionaryReport | null;
+    /** A relink of the active version onto the dictionary, while one runs. */
+    relink: DataSourcesRelink | null;
     /**
      * Dedicated capacity only; null on the shared pool. `building` while the
      * optimizer is behind the writes, `ready` otherwise. Search answers
@@ -2272,6 +2493,10 @@ interface DataSourcesListEntry {
     sampleOf: string | null;
     /** The mapper the live release declares for this source, or null. */
     mapper: DataSourceMapper | null;
+    /** The reader the live release declares for this source, or null. */
+    reader: (DataSourceReader & {
+        deliveries: DataSourceReaderDeliveries;
+    }) | null;
     createdAt: string;
 }
 /** GET /datasources — all data sources for the app. */
@@ -2299,6 +2524,8 @@ interface DataSourcesSearchCitation {
 interface DataSourcesSearchResultItem {
     score: number;
     text: string;
+    /** The entities this passage carries (its document's asserted ids). */
+    entities: string[];
     citation: DataSourcesSearchCitation;
     /** Rank and score from retrieval, before reranking. */
     retrievalRank?: number;
@@ -2329,6 +2556,19 @@ interface DataSourcesCountResult {
     pipelineVersion: number;
     latencyMs: number;
 }
+/**
+ * POST /datasources/entities. The entities the passages matching a filter are
+ * about, most first. `chunks` is passages carrying each id, not documents, and
+ * approximate.
+ */
+interface DataSourcesEntitiesResult {
+    entities: {
+        id: string;
+        chunks: number;
+    }[];
+    pipelineVersion: number;
+    latencyMs: number;
+}
 /**
  * POST /datasources/search.
  *
@@ -2508,6 +2748,11 @@ interface AddDocumentParams {
      * `string | number | boolean` values).
      */
     metadata?: Record<string, string | number | boolean>;
+    /**
+     * What the document is about, as the app's own ids (≤ 256, printable ASCII,
+     * no whitespace or commas). Every passage carries them; `[]` clears them.
+     */
+    entities?: string[];
     /**
      * Receives the exact progress strings the CLI prints today:
      * - `${filename}: unchanged, skipped`
@@ -2724,6 +2969,30 @@ interface CountParams {
  * const { chunks } = await admin.dataSources.count({ slug: 'policies', filter: { contains: 'notice period' } });
  */
 declare function count(ctx: AdminContext, params: CountParams): Promise<DataSourcesCountResult>;
+interface EntitiesParams {
+    /** Data source slug. */
+    slug: string;
+    /** Same grammar as search's filter; absent covers the whole corpus. */
+    filter?: Record<string, unknown>;
+    /** Entities to return, most first (default 20, at most 100). */
+    limit?: number;
+    /** Read the candidate version instead of the live one. */
+    candidate?: boolean;
+}
+/**
+ * Which entities the passages matching a filter are about, most first.
+ *
+ * Filtered on one entity, it answers what appears beside it: a co-mention
+ * graph. `chunks` counts passages carrying each id, not documents, and is
+ * approximate.
+ *
+ * @throws AdminApiError `invalid_filter` (400); `no_candidate_pipeline` (404)
+ *   with `candidate: true` and no revectorization in flight; `index_warming` /
+ *   `index_building` (503) while the corpus is loading or building.
+ * @example
+ * const { entities } = await admin.dataSources.entities({ slug: 'manuals', filter: { entities: ['P-101A'] } });
+ */
+declare function entities(ctx: AdminContext, params: EntitiesParams): Promise<DataSourcesEntitiesResult>;
 /**
  * Read the full pipeline configuration for one data source.
  *
@@ -3002,6 +3271,48 @@ declare function rmWhereAll(ctx: AdminContext, params: RmWhereParams & {
  * const { documents, versions } = await admin.dataSources.deleteSource('policies');
  */
 declare function deleteSource(ctx: AdminContext, slug: string): Promise<DataSourcesDeleteResult>;
+/** One dictionary entry: the app's id for a thing and the names it goes by. */
+interface DictionaryEntryInput {
+    id: string;
+    names: string[];
+}
+/**
+ * Push a source's dictionary, replacing the one it had: a stage, its pages
+ * (each retried alone), and the commit. A new version re-tags the source's
+ * passages in the background; an unchanged one commits nothing.
+ *
+ * @throws AdminApiError `invalid_dictionary` / `dictionary_name_too_short` (400)
+ *   on a page, naming the entry; `dictionary_too_large` (400) at the commit.
+ * @example
+ * await admin.dataSources.pushDictionary({ slug: 'manuals', entries: [{ id: 'P-101A', names: ['P-101A', 'Main Feed Pump'] }] });
+ */
+declare function pushDictionary(ctx: AdminContext, params: {
+    slug: string;
+    entries: DictionaryEntryInput[];
+    linkerVersion?: number;
+    onProgress?: (sent: number, total: number) => void;
+}): Promise<DataSourcesDictionaryPushResult>;
+/**
+ * A source's current dictionary, and the relinks re-tagging its versions
+ * while they run.
+ *
+ * @throws AdminApiError `data_source_not_found` (404).
+ */
+declare function dictionary(ctx: AdminContext, params: {
+    slug: string;
+}): Promise<DataSourcesDictionaryStatus>;
+/**
+ * What the source's current dictionary finds in a piece of text: each
+ * mention, in order, with the ids it tags.
+ *
+ * @throws AdminApiError `data_source_not_found` (404).
+ * @example
+ * const { mentions } = await admin.dataSources.link({ slug: 'manuals', text: 'Replaced the seal on P101A.' });
+ */
+declare function link(ctx: AdminContext, params: {
+    slug: string;
+    text: string;
+}): Promise<DataSourcesLinkResult>;
 
 type dataSources_AddDocumentParams = AddDocumentParams;
 type dataSources_AddDocumentResult = AddDocumentResult;
@@ -3009,8 +3320,10 @@ type dataSources_ConfigSetParams = ConfigSetParams;
 type dataSources_CountParams = CountParams;
 type dataSources_CreateParams = CreateParams;
 declare const dataSources_DOCUMENTS_IDS_MAX: typeof DOCUMENTS_IDS_MAX;
+type dataSources_DictionaryEntryInput = DictionaryEntryInput;
 type dataSources_DocumentsParams = DocumentsParams;
 type dataSources_DropParams = DropParams;
+type dataSources_EntitiesParams = EntitiesParams;
 declare const dataSources_FAILURES_PAGE: typeof FAILURES_PAGE;
 type dataSources_MoveParams = MoveParams;
 type dataSources_PromoteParams = PromoteParams;
@@ -3031,10 +3344,14 @@ declare const dataSources_configGet: typeof configGet;
 declare const dataSources_configSet: typeof configSet;
 declare const dataSources_count: typeof count;
 declare const dataSources_deleteSource: typeof deleteSource;
+declare const dataSources_dictionary: typeof dictionary;
 declare const dataSources_documents: typeof documents;
 declare const dataSources_drop: typeof drop;
+declare const dataSources_entities: typeof entities;
+declare const dataSources_link: typeof link;
 declare const dataSources_move: typeof move;
 declare const dataSources_promote: typeof promote;
+declare const dataSources_pushDictionary: typeof pushDictionary;
 declare const dataSources_revectorize: typeof revectorize;
 declare const dataSources_rm: typeof rm;
 declare const dataSources_rmWhere: typeof rmWhere;
@@ -3046,7 +3363,7 @@ declare const dataSources_waitForCandidate: typeof waitForCandidate;
 declare const dataSources_waitForIngest: typeof waitForIngest;
 declare const dataSources_waitForMove: typeof waitForMove;
 declare namespace dataSources {
-  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 };
+  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 };
 }
 
 /**
@@ -3624,6 +3941,8 @@ declare function remap(ctx: AdminContext, params: RemapParams): Promise<DataSour
 interface QuarantineParams {
     id: string;
     kind?: 'skip' | 'error';
+    /** Only the mapper's (`map`) or only the reader's (`read`). */
+    stage?: 'map' | 'read';
     /** Only objects quarantined with exactly this reason. */
     reason?: string;
     cursor?: string;
@@ -3631,8 +3950,8 @@ interface QuarantineParams {
     limit?: number;
 }
 /**
- * What a job's mapper skipped or failed on: counts, reasons by frequency, and
- * a page of objects.
+ * What a job's mapper skipped or failed on, and what its reader failed on:
+ * counts, reasons by frequency, and a page of objects.
  *
  * @throws AdminApiError `job_not_found` (404).
  */
@@ -6292,6 +6611,16 @@ interface ReleasesByCommitResult extends ReleaseFailureFields {
      * Synthesised synchronously from the release id by buildPreviewUrl().
      */
     previewUrl: string | null;
+    /**
+     * The data sources this release declares app code for. A live release's
+     * reader entries carry `readerUnread`: the source's documents its reader
+     * hadn't read when the release went live.
+     */
+    dataSources?: {
+        slug: string;
+        reader?: unknown;
+        readerUnread?: number;
+    }[];
 }
 /** A compiled method entry as it appears on a live release. */
 interface DashboardReleaseMethod {
@@ -6789,6 +7118,15 @@ interface ReleaseSummary {
     failureKind?: 'build' | 'interrupted' | 'unbuildable';
     /** Build stage that was running when it failed; only when `failed`. */
     failurePhase?: string;
+    /**
+     * Each data source whose reader this live release brought live, with the
+     * documents it hasn't read: what `datasources reread --unread` reads, priced
+     * first. Absent when the release declares no reader.
+     */
+    readers?: {
+        slug: string;
+        unread: number;
+    }[];
 }
 /**
  * Terminal outcome of a `waitForCommit` call.
@@ -7941,4 +8279,4 @@ declare class AdminTimeoutError extends Error {
 
 declare const admin: AdminClient;
 
-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 };
+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 };