@madewithremy/admin 0.1.31 → 0.1.33

package/dist/index.d.ts

@@ -1177,12 +1177,11 @@ interface DataLiftFromLiveResult {
 
 interface LiftFromDevParams {
     /**
-     * Which dev session to lift from, by dev release id. An app has a dev session per workspace — one
-     * per person's box, one per person's CLI — so this is required once more than one is open. The
-     * server refuses rather than picking: promoting the wrong workspace's data over live is not
-     * recoverable, and nothing in the request would show it had happened.
-     *
-     * The ids are on the dashboard's `devSessions`, and the `ambiguous_dev_session` error lists them.
+     * Which of YOUR dev sessions to lift from, by dev release id. An app has a dev session per
+     * workspace (one per person's box, one per person's CLI), and a lift only ever touches the
+     * caller's own: without this it takes your newest, and a colleague's id is refused
+     * (`not_your_dev_session`). Name it when you have more than one open. The ids are on the
+     * dashboard's `devSessions`.
      */
     releaseId?: string;
 }
@@ -1197,12 +1196,11 @@ interface LiftFromDevParams {
  *
  * @throws AdminApiError `no_dev_session` (404) — no dev release exists (start a dev session first);
  *   `no_live_release` (404) — app has never been published (publish first, then lift);
- *   `ambiguous_dev_session` (400) — the app has several dev sessions open, so `releaseId` is
- *   required; the error message lists the open ones.
+ *   `not_your_dev_session` (403) — `releaseId` names someone else's dev session.
  * @example
  * const result = await admin.data.liftFromDev();
  * console.log(`Lifted ${result.databasesAffected.length} databases to live`);
- * // With more than one dev session open, name the one you mean:
+ * // With more than one of your dev sessions open, name the one you mean:
  * await admin.data.liftFromDev({ releaseId: '8f2c1e04-...' });
  */
 declare function liftFromDev(ctx: AdminContext, params?: LiftFromDevParams): Promise<DataLiftFromDevResult>;
@@ -1213,8 +1211,8 @@ interface LiftFromLiveParams {
      */
     truncate?: boolean;
     /**
-     * Which dev session to overwrite, by dev release id. Required once the app has more than one
-     * open — see `LiftFromDevParams.releaseId`.
+     * Which of your dev sessions to overwrite, by dev release id; your newest when absent. See
+     * `LiftFromDevParams.releaseId`.
      */
     releaseId?: string;
 }
@@ -1230,7 +1228,7 @@ interface LiftFromLiveParams {
  *
  * @throws AdminApiError `no_dev_session` (404) — no dev release exists (start a dev session first);
  *   `no_live_release` (404) — no live release (copy mode only; not thrown when `truncate` is true);
- *   `ambiguous_dev_session` (400) — several dev sessions are open, so `releaseId` is required.
+ *   `not_your_dev_session` (403) — `releaseId` names someone else's dev session.
  * @example
  * // Pull live data into dev for debugging:
  * await admin.data.liftFromLive();
@@ -1328,6 +1326,13 @@ type DataSourceJobSource = {
     unread: boolean;
     /** Only documents matching this metadata filter. */
     filter: Record<string, unknown> | null;
+} | {
+    /**
+     * The rest of one file a `datasources add` (or an app's `add()`) took
+     * that maps to more than a thousand documents; `ref` is its filename.
+     */
+    type: 'object';
+    ref: string;
 };
 /**
  * planning → planned → running ⇄ paused → done | failed | cancelled.
@@ -1943,7 +1948,24 @@ interface DataSourceMapTestDocument {
 }
 type DataSourceMapTestOutcome = {
     kind: 'documents';
+    /** The first twenty of them. */
     documents: DataSourceMapTestDocument[];
+    /** Every valid document the object produced. */
+    count: number;
+    /**
+     * Its documents that failed validation, by their index in the mapper's
+     * output: a job leaves them out and quarantines the object for them.
+     * Null when every one passed.
+     */
+    invalid: {
+        count: number;
+        examples: {
+            document: number;
+            reason: string;
+        }[];
+    } | null;
+    /** Parts of the frame's documents that storage did not have. */
+    missingParts?: number;
 } | {
     kind: 'passthrough';
     metadata: Record<string, string | number | boolean> | null;
@@ -2313,8 +2335,10 @@ interface DataSourcesDocumentsResult {
 type DataSourcesUploadTokenResult = {
     alreadyCurrent: true;
     document: DataSourcesDocument;
-    /** Mapped sources: every document this mapper version produced from the bytes. */
+    /** Mapped sources: what this mapper version produced from the bytes, the first thousand at most. */
     documents?: DataSourcesDocument[];
+    /** Mapped sources: how many it produced in all. */
+    documentCount?: number;
 } | {
     alreadyCurrent: false;
     contentType: string;
@@ -2328,16 +2352,30 @@ type DataSourcesUploadTokenResult = {
  * POST /datasources/documents — confirm an uploaded object and queue its
  * builds. On a mapped source the object is a raw copy and the mapper decides
  * what it becomes: `documents` holds everything produced, `document` the first
- * of them (null only for a `deletes` outcome).
+ * of them (null only for a `deletes` outcome). An object that maps to more
+ * than a thousand documents returns the first thousand and `job`, which
+ * registers and builds the rest.
  */
 interface DataSourcesDocumentConfirmResult {
     document: DataSourcesDocument | null;
     documents: DataSourcesDocument[];
+    /** Every document the object maps to; `documents.length` unless `job` is set. */
+    documentCount: number;
     /** Whether any document was queued for a build. */
     queued: boolean;
     outcome: 'unmapped' | 'documents' | 'passthrough' | 'deletes';
     /** Documents removed or superseded as a result. */
     removed: number;
+    /** Documents that failed validation and were not registered; null when none did. */
+    invalid: {
+        count: number;
+        examples: {
+            document: number;
+            reason: string;
+        }[];
+    } | null;
+    /** The job taking the rest of an object larger than a thousand documents. */
+    job: DataSourceJob | null;
 }
 /** Build progress counts used in several list and status shapes. */
 interface DataSourcesBuildProgress {
@@ -2399,9 +2437,14 @@ interface DataSourcesDictionaryReport {
     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. */
+    /**
+     * The names the most ids claim: `name` as you pushed it (one of them, when
+     * several fold alike), `key` as the linker matches it (folded, separators
+     * dropped), and how many ids claim it.
+     */
     mostClaimed: {
         key: string;
+        name?: string;
         ids: number;
     }[];
     /** Names that can't match their own text as written, with a few of them. */
@@ -2569,6 +2612,20 @@ interface DataSourcesEntitiesResult {
     pipelineVersion: number;
     latencyMs: number;
 }
+/** One passage of a listing: a search hit without the ranking. */
+interface DataSourcesPassage {
+    text: string;
+    entities: string[];
+    citation: DataSourcesSearchCitation;
+}
+/** POST /datasources/passages — a page of every passage matching a filter. */
+interface DataSourcesPassagesResult {
+    passages: DataSourcesPassage[];
+    /** Pass back as `cursor` for the next page; null after the last. */
+    nextCursor: string | null;
+    pipelineVersion: number;
+    latencyMs: number;
+}
 /**
  * POST /datasources/search.
  *
@@ -2753,6 +2810,11 @@ interface AddDocumentParams {
      * no whitespace or commas). Every passage carries them; `[]` clears them.
      */
     entities?: string[];
+    /**
+     * The budget in dollars of the job that takes the rest of a file mapping
+     * to more than a thousand documents (`AddDocumentResult.job`).
+     */
+    budgetDollars?: number;
     /**
      * Receives the exact progress strings the CLI prints today:
      * - `${filename}: unchanged, skipped`
@@ -2769,10 +2831,28 @@ interface AddDocumentResult {
      * source's mapper answered `deletes` for the file.
      */
     document: DataSourcesDocument | null;
-    /** Every document the file became — one on an unmapped source. */
+    /**
+     * Every document the file became — one on an unmapped source — or the
+     * first thousand of a file that maps to more.
+     */
     documents: DataSourcesDocument[];
+    /** How many documents the file maps to in all. */
+    documentCount: number;
     /** How the source took the file; absent when it was already current. */
     outcome?: 'unmapped' | 'documents' | 'passthrough' | 'deletes';
+    /** Documents the mapper produced that failed validation and were not registered. */
+    invalid?: {
+        count: number;
+        examples: {
+            document: number;
+            reason: string;
+        }[];
+    } | null;
+    /**
+     * The job registering and building the rest of a file that maps to more
+     * than a thousand documents; it plans and starts on its own.
+     */
+    job?: DataSourceJob | null;
 }
 /**
  * Add one document to a data source.
@@ -2974,7 +3054,7 @@ interface EntitiesParams {
     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). */
+    /** Entities to return, most first (default 20, at most 1,000). */
     limit?: number;
     /** Read the candidate version instead of the live one. */
     candidate?: boolean;
@@ -2993,6 +3073,29 @@ interface EntitiesParams {
  * const { entities } = await admin.dataSources.entities({ slug: 'manuals', filter: { entities: ['P-101A'] } });
  */
 declare function entities(ctx: AdminContext, params: EntitiesParams): Promise<DataSourcesEntitiesResult>;
+interface PassagesParams {
+    /** Data source slug. */
+    slug: string;
+    /** Same grammar as search's filter; absent lists the whole corpus. */
+    filter?: Record<string, unknown>;
+    /** The previous page's `nextCursor`. */
+    cursor?: string;
+    /** Passages per page (default 50, at most 200). */
+    limit?: number;
+    /** Read the candidate version instead of the live one. */
+    candidate?: boolean;
+}
+/**
+ * One page of every passage matching a filter, unranked: all the pages that
+ * mention an entity, rather than search's best few. Passages come document by
+ * document, each document's in order.
+ *
+ * @throws AdminApiError `invalid_filter` (400); `invalid_cursor` (400);
+ *   `no_candidate_pipeline` (404); `index_warming` / `index_building` (503).
+ * @example
+ * const { passages, nextCursor } = await admin.dataSources.passages({ slug: 'manuals', filter: { entities: ['P-1004A'] } });
+ */
+declare function passages(ctx: AdminContext, params: PassagesParams): Promise<DataSourcesPassagesResult>;
 /**
  * Read the full pipeline configuration for one data source.
  *
@@ -3326,6 +3429,7 @@ type dataSources_DropParams = DropParams;
 type dataSources_EntitiesParams = EntitiesParams;
 declare const dataSources_FAILURES_PAGE: typeof FAILURES_PAGE;
 type dataSources_MoveParams = MoveParams;
+type dataSources_PassagesParams = PassagesParams;
 type dataSources_PromoteParams = PromoteParams;
 type dataSources_RevectorizeParams = RevectorizeParams;
 type dataSources_RmParams = RmParams;
@@ -3350,6 +3454,7 @@ 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_passages: typeof passages;
 declare const dataSources_promote: typeof promote;
 declare const dataSources_pushDictionary: typeof pushDictionary;
 declare const dataSources_revectorize: typeof revectorize;
@@ -3363,7 +3468,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_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 };
+  export { type dataSources_AddDocumentParams as AddDocumentParams, type dataSources_AddDocumentResult as AddDocumentResult, type dataSources_ConfigSetParams as ConfigSetParams, type dataSources_CountParams as CountParams, type dataSources_CreateParams as CreateParams, DEFAULT_WAIT_TIMEOUT_MS$3 as DEFAULT_WAIT_TIMEOUT_MS, dataSources_DOCUMENTS_IDS_MAX as DOCUMENTS_IDS_MAX, type dataSources_DictionaryEntryInput as DictionaryEntryInput, type dataSources_DocumentsParams as DocumentsParams, type dataSources_DropParams as DropParams, type dataSources_EntitiesParams as EntitiesParams, dataSources_FAILURES_PAGE as FAILURES_PAGE, type dataSources_MoveParams as MoveParams, type dataSources_PassagesParams as PassagesParams, type dataSources_PromoteParams as PromoteParams, type dataSources_RevectorizeParams as RevectorizeParams, type dataSources_RmParams as RmParams, type dataSources_RmWhereParams as RmWhereParams, type dataSources_SearchParams as SearchParams, type dataSources_SummarizedDocument as SummarizedDocument, type dataSources_WaitForCandidateParams as WaitForCandidateParams, type dataSources_WaitForCandidateResult as WaitForCandidateResult, type dataSources_WaitForIngestParams as WaitForIngestParams, type dataSources_WaitForIngestResult as WaitForIngestResult, type dataSources_WaitForMoveParams as WaitForMoveParams, type dataSources_WaitForMoveResult as WaitForMoveResult, dataSources_addDocument as addDocument, dataSources_allDocuments as allDocuments, dataSources_configGet as configGet, dataSources_configSet as configSet, dataSources_count as count, create$1 as create, dataSources_deleteSource as deleteSource, dataSources_dictionary as dictionary, dataSources_documents as documents, dataSources_drop as drop, dataSources_entities as entities, dataSources_link as link, list$8 as list, dataSources_move as move, dataSources_passages as passages, dataSources_promote as promote, dataSources_pushDictionary as pushDictionary, dataSources_revectorize as revectorize, dataSources_rm as rm, dataSources_rmWhere as rmWhere, dataSources_rmWhereAll as rmWhereAll, dataSources_search as search, dataSources_stopMove as stopMove, dataSources_summarize as summarize, dataSources_waitForCandidate as waitForCandidate, dataSources_waitForIngest as waitForIngest, dataSources_waitForMove as waitForMove };
 }
 
 /**
@@ -3892,6 +3997,11 @@ interface MapTestParams {
     limit?: number;
     /** Run the LOCAL mapper through the app's dev session instead of the live bundle. */
     dev?: boolean;
+    /**
+     * With `dev`, which of your dev sessions: its dev release id. Default your
+     * newest. Only ever your own.
+     */
+    releaseId?: string;
 }
 /**
  * Run the source's mapper over real objects and return the outcomes — nothing
@@ -8279,4 +8389,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 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 };
+export { AdminApiError, type AdminClient, type AdminClientOptions, type AdminContext, AdminTimeoutError, type AgentThreadDetail, type AgentThreadListItem, type AgentThreadsGetResult, type AgentThreadsListResult, type AgentToolCall, type AgentTranscriptMessage, type AgentTurnError, type AnalyticsAiHostRow, type AnalyticsAiSourcesResult, type AnalyticsAiVendorRow, type AnalyticsBatchResult, type AnalyticsCrawlersOverviewResult, type AnalyticsCrawlersRecentResult, type AnalyticsCrawlersRecentRow, type AnalyticsCrawlersResult, type AnalyticsCrawlersTimeseriesBucket, type AnalyticsCrawlersTimeseriesResult, type AnalyticsLiveResult, type AnalyticsMapPoint, type AnalyticsMapResult, type AnalyticsMetric, type AnalyticsQueryResult, type AnalyticsQueryResultRow, type AnalyticsSourceRow, type AnalyticsSourcesResult, type AppCronJobStatus, type AppCronJobStatusReason, type AppCronRunState, type AppEmailSuppression, type AppSecretRow, type CrashGroup, type CrashOccurrenceRow, type CrashesGetResult, type CrashesListResult, type CrashesOccurrencesResult, type CrashesStatsBucket, type CrashesStatsResult, type CronJobDecorated, type CronOverviewResult, type CronRunResult, type CronRunSummary, type DashboardLiveRelease, type DashboardReleaseMethod, type DashboardResult, type DataLiftFromDevResult, type DataLiftFromLiveResult, type DataSourceConnector, type DataSourceConnectorCredentials, type DataSourceConnectorDeletions, type DataSourceConnectorGetResult, type DataSourceConnectorPolicy, type DataSourceConnectorResult, type DataSourceInspectReport, type DataSourceInspectResult, type DataSourceJob, type DataSourceJobGetResult, type DataSourceJobManifestTokenResult, type DataSourceJobPlan, type DataSourceJobResult, type DataSourceJobSource, type DataSourceJobState, type DataSourceJobsListResult, type DataSourceMapDeployResult, type DataSourceMapTestDocument, type DataSourceMapTestOutcome, type DataSourceMapTestResult, type DataSourceMapper, type DataSourceObjectSelection, type DataSourceQuarantineResult, type DataSourceQuarantinedObject, type DataSourceReader, type DataSourceReaderDeliveries, type DataSourceReaderRetryResult, type DataSourceReaderStatusResult, type DataSourceReaderTestDocument, type DataSourceReaderTestResult, type DataSourceRemapResult, type DataSourceRereadResult, type DataSourceSyncResult, type DataSourcesBuildProgress, type DataSourcesChunkingConfig, type DataSourcesChunkingStrategy, type DataSourcesConfigResult, type DataSourcesConfigUpdateResult, type DataSourcesCountResult, type DataSourcesCreateResult, type DataSourcesDeleteResult, type DataSourcesDictionaryPushResult, type DataSourcesDictionaryReport, type DataSourcesDictionaryStatus, type DataSourcesDocument, type DataSourcesDocumentConfirmResult, type DataSourcesDocumentDeleteManyResult, type DataSourcesDocumentDeleteResult, type DataSourcesDocumentSelector, type DataSourcesDocumentStatus, type DataSourcesDocumentsResult, type DataSourcesDropResult, type DataSourcesEntitiesResult, type DataSourcesHydrateResult, type DataSourcesHydration, type DataSourcesIndex, type DataSourcesIngestConfig, type DataSourcesIngestUpdate, type DataSourcesLinkResult, type DataSourcesListEntry, type DataSourcesListResult, type DataSourcesMigration, type DataSourcesMoveResult, type DataSourcesPassage, type DataSourcesPassagesResult, type DataSourcesPlacement, type DataSourcesPromoteResult, type DataSourcesRelink, type DataSourcesRetrievalConfig, type DataSourcesRetrievalUpdate, type DataSourcesRevectorizeResult, type DataSourcesSampleResult, type DataSourcesSearchCitation, type DataSourcesSearchResult, type DataSourcesSearchResultItem, type DataSourcesUploadTokenResult, type DatasetFile, type DbQueryResult, type DiagnosticsAuditEnvironment, type DiagnosticsDashboardResult, type DiagnosticsFinding, type DiagnosticsLighthouseScores, type DiagnosticsPayload, type DiagnosticsReleaseResult, type DiagnosticsRuntimeFindings, type DomainsCheckResult, type DomainsCustomAddResult, type DomainsCustomCheckResult, type DomainsCustomHostnameUiStatus, type DomainsCustomHostnameView, type DomainsCustomListResult, type DomainsCustomRemoveResult, type DomainsCustomRetryResult, type DomainsDnsInstructions, type DomainsGetResult, type DomainsSetResult, type EmailBatchLifecycle, type EmailBatchResult, type EmailBatchSummary, type EmailBatchesResult, type EmailDomainBase, type EmailEffectiveSender, type EmailInboxResult, type EmailListResult, type EmailMessageKind, type EmailMessageResult, type EmailMessageStatus, type EmailSenderTier, type EmailSendingStatusResult, type EmailStatsResult, type EmailSummary, type EmailSuppressResult, type EmailSuppressionsResult, type EmailUnsuppressResult, type EvalAggregates, type EvalCompareResult, type EvalExpectation, type EvalQueriesAddResult, type EvalQueriesListResult, type EvalQuery, type EvalQueryResult, type EvalQueryStyle, type EvalRetrieval, type EvalRun, type EvalRunResult, type EvalRunState, type EvalRunsListResult, type EvalSet, type EvalSetGetResult, type EvalSetResult, type EvalSetState, type EvalSetsListResult, type EventChannelActivity, type EventsChannelsListResult, type EventsPublishResult, type EventsTailFrame, type FilesDeleteResult, type FilesFileMeta, type FilesListEntry, type FilesListResult, type FilesLsResult, type FilesScanBadge, type FilesScanFlagged, type FilesScanStore, type FilesStatResult, type FilesStoreSummaryEntry, type FilesUploadUrlResult, type FilesUrlResult, type FrontendErrorType, type InboundDnsInstructions, type InboundEmailDomainAddResult, type InboundEmailDomainCheckResult, type InboundEmailDomainDeleteResult, type InboundEmailDomainUiStatus, type InboundEmailDomainVerifyResult, type InboundEmailDomainView, type InboundEmailDomainsListResult, type InboxEmailPreview, type IssueAuthorKind, type IssueCommentRow, type IssueEventType, type IssueRow, type IssueStatus, type IssuesCommentResult, type IssuesCreateResult, type IssuesDeleteResult, type IssuesGetResult, type IssuesListResult, type IssuesUpdateResult, type JewelPairRow, type JewelPairSummaryRow, type JewelVerdict, type JewelsDatasetSummary, type JewelsDryrunResult, type JewelsExportResult, type JewelsGradeResult, type JewelsGrading, type JewelsOverviewResult, type JewelsPairResult, type JewelsPairsResult, type JewelsQueueResult, type JewelsResolveResult, type JewelsRunResult, type JewelsRunsResult, type JewelsTimeseriesBucket, type JewelsTimeseriesResult, type JewelsTrainResult, type LiftedDatabase, type MethodsInvokeResult, type OperationProgress, type OutboundDnsInstructions, type OutboundDnsRecord, type OutboundEmailDomainAddResult, type OutboundEmailDomainCheckResult, type OutboundEmailDomainDeleteResult, type OutboundEmailDomainUiStatus, type OutboundEmailDomainVerifyResult, type OutboundEmailDomainView, type OutboundEmailDomainsListResult, type PlatformSuppression, type PrerenderGetResult, type PrerenderInvalidateResult, type PrerenderPage, type PrerenderPagesResult, type PrerenderViewResult, type ReleaseFailureFields, type ReleaseFragment, type ReleasesByCommitResult, type ReleasesGetResult, type ReleasesListResult, type RequestsGetResult, type RequestsListResult, type RequestsListRow, type RequestsStatsMethodBucket, type RequestsStatsMethodResult, type RequestsStatsSummaryBucket, type RequestsStatsSummaryResult, type SecretsDeleteResult, type SecretsGetResult, type SecretsListResult, type SecretsSetResult, type SettingsResult, type SuppressionSource, type TaskTraceOutcome, type TaskTraceSummary, type TaskTranscriptMessage, type TaskTurnError, type TasksGetResult, type TasksListResult, type TrainingLogEntry, type TrainingRunRow, type TrainingRunStatus, type UserAuthProvider, type UserListItem, type UserRecord, type UsersCreateApiKeyResult, type UsersListResult, type UsersRevokeApiKeyResult, type UsersSetRoleResult, type V2AppSettings, type V2BuildLogEntry, type V2BuildStats, type V2CommitInfo, type V2EmailMessage, type V2ReleaseStatus, type VoiceAvailableNumber, type VoiceNumbersBuyResult, type VoiceNumbersListResult, type VoiceNumbersReleaseResult, type VoiceNumbersSearchResult, type VoiceNumbersSetNameResult, type VoicePhoneNumberStatus, type VoicePhoneNumberView, type VoiceResolvedPolicy, type VoiceSessionChannel, type VoiceSessionCost, type VoiceSessionCostLine, type VoiceSessionDetail, type VoiceSessionGetResult, type VoiceSessionListItem, type VoiceSessionSip, type VoiceSessionSpeechEntry, type VoiceSessionStatus, type VoiceSessionToolEntry, type VoiceSessionTranscriptEntry, type VoiceSessionsListResult, type VoiceSettingsCeilings, type VoiceSettingsGetResult, type VoiceSettingsOverrides, type VoiceSettingsSetResult, admin, createAdminClient, admin as default };

package/dist/index.js

@@ -411,6 +411,7 @@ __export(dataSources_exports, {
   link: () => link,
   list: () => list4,
   move: () => move,
+  passages: () => passages,
   promote: () => promote,
   pushDictionary: () => pushDictionary,
   revectorize: () => revectorize,
@@ -551,6 +552,7 @@ var summarize = (d) => ({
 });
 async function addDocument(ctx, params) {
   const { slug, filename, content, metadata, entities: entities2, onProgress } = params;
+  const { budgetDollars } = params;
   const contentHash = createHash("sha256").update(content).digest("hex");
   const token = await call(
     ctx,
@@ -566,11 +568,13 @@ async function addDocument(ctx, params) {
   );
   if (token.alreadyCurrent) {
     onProgress?.(`${filename}: unchanged, skipped`);
+    const documents3 = token.documents ?? [token.document];
     return {
       filename,
       skipped: true,
       document: token.document,
-      documents: token.documents ?? [token.document]
+      documents: documents3,
+      documentCount: token.documentCount ?? documents3.length
     };
   }
   onProgress?.(
@@ -588,16 +592,21 @@ async function addDocument(ctx, params) {
       contentType: token.contentType,
       size: content.length,
       ...metadata ? { metadata } : {},
-      ...entities2 ? { entities: entities2 } : {}
+      ...entities2 ? { entities: entities2 } : {},
+      ...budgetDollars !== void 0 ? { budgetDollars } : {}
     }
   );
+  const documents2 = confirmed.documents ?? (confirmed.document ? [confirmed.document] : []);
   return {
     filename,
     skipped: false,
     queued: confirmed.queued,
     document: confirmed.document,
-    documents: confirmed.documents ?? (confirmed.document ? [confirmed.document] : []),
-    outcome: confirmed.outcome
+    documents: documents2,
+    documentCount: confirmed.documentCount ?? documents2.length,
+    outcome: confirmed.outcome,
+    invalid: confirmed.invalid ?? null,
+    job: confirmed.job ?? null
   };
 }
 async function waitForIngest(ctx, params) {
@@ -779,6 +788,21 @@ function entities(ctx, params) {
     }
   );
 }
+function passages(ctx, params) {
+  const { slug, filter, cursor, limit, candidate } = params;
+  return call(
+    ctx,
+    "POST",
+    `${base(ctx.appId)}/passages`,
+    {
+      slug,
+      ...filter ? { filter } : {},
+      ...cursor ? { cursor } : {},
+      ...limit !== void 0 ? { limit } : {},
+      ...candidate ? { candidate: true } : {}
+    }
+  );
+}
 function configGet(ctx, slug) {
   return call(
     ctx,
@@ -1528,7 +1552,8 @@ function mapTest(ctx, params) {
       ...selectionBody(params.selection),
       ...params.keys ? { keys: params.keys } : {},
       ...params.limit !== void 0 ? { limit: params.limit } : {},
-      ...params.dev ? { dev: true } : {}
+      ...params.dev ? { dev: true } : {},
+      ...params.releaseId ? { releaseId: params.releaseId } : {}
     }
   );
 }
@@ -1632,13 +1657,6 @@ async function dashboardLive(ctx) {
   );
   return dashboard.liveRelease;
 }
-function buildFailureReason(release) {
-  const log = Array.isArray(release.buildLog) ? release.buildLog : [];
-  const errors = log.filter(
-    (entry) => entry?.phase === "error" && typeof entry.message === "string"
-  );
-  return errors.length ? errors[errors.length - 1].message : null;
-}
 function summarizeRelease(release) {
   const summary2 = {
     releaseId: release.id,
@@ -1661,7 +1679,7 @@ function summarizeRelease(release) {
   }
   return {
     ...summary2,
-    error: release.failureReason ?? buildFailureReason(release) ?? "Build failed (no error entry in the build log)",
+    error: release.failureReason ?? "Build failed (no error entry in the build log)",
     ...release.failureKind ? { failureKind: release.failureKind } : {},
     ...release.failurePhase ? { failurePhase: release.failurePhase } : {}
   };