@madewithremy/admin 0.1.14 → 0.1.16

package/dist/index.d.ts

@@ -1059,6 +1059,38 @@ declare namespace data {
   export { type data_LiftFromLiveParams as LiftFromLiveParams, data_liftFromDev as liftFromDev, data_liftFromLive as liftFromLive };
 }
 
+/**
+ * One shape for every long operation's progress: a bulk load, an index
+ * reload, a move, an index build, a resource changing phase. Rate and ETA are
+ * measured by the platform from the operation's own record, so the CLI, the
+ * dashboard and a search's refusal message quote the same numbers.
+ *
+ * Transcribed from youai-api: src/common/DataSources/progress.ts
+ */
+interface OperationProgress {
+    /** The operation's own phase word: `running`, `copying`, `building`, `provisioning`… */
+    phase: string;
+    unit: 'documents' | 'objects' | 'vectors' | 'steps';
+    done: number;
+    /** Null when the operation has no known end (a planning walk, a phase transition). */
+    total: number | null;
+    /** Units per minute over the last few minutes; null until measured. */
+    ratePerMinute: number | null;
+    /** When the rest lands at that rate; null without a rate or a total. */
+    etaAt: string | null;
+    startedAt: string | null;
+    /** When the operation last moved. */
+    updatedAt: string | null;
+    /** No movement for 30 minutes while under way. */
+    stalled: boolean;
+    /** The operation's own word on itself: an error, a pause reason, a step. */
+    note: string | null;
+    history: {
+        phase: string;
+        at: string;
+    }[];
+}
+
 /**
  * Response types for bulk ingestion jobs.
  *
@@ -1066,6 +1098,7 @@ declare namespace data {
  *   src/http/routes/V2Apps/manage/dataSourceJobs.ts (jobView)
  *   src/common/DataSources/jobs/types.ts
  */
+
 /**
  * Where a job's documents come from. `store` is every object under a prefix of
  * one of the app's file stores (what `files put` fills); `manifest` is a JSONL
@@ -1153,10 +1186,37 @@ interface DataSourceJobPlan {
     capacity: {
         placement: 'shared' | 'dedicated';
         resourceId: string | null;
+        /**
+         * Chunks the placement holds in total at this source's dimensions: the
+         * shared pool's per-source cap, or what the resource would hold were this
+         * source alone on it.
+         */
         maxPoints: number;
+        /** Chunks already there (other sources on the resource, or this one's own). */
         heldPoints: number;
         /** False means approve is refused until the source moves or the resource grows. */
         fits: boolean;
+        /**
+         * Dedicated only: the bytes the decision was made on. `binding` names the
+         * limit that refused; `held`, `incoming` and `usable` are disk and RAM.
+         */
+        footprint?: {
+            dimensions: number;
+            fits: boolean;
+            binding: 'disk' | 'ram' | null;
+            held: {
+                diskBytes: number;
+                ramBytes: number;
+            };
+            incoming: {
+                diskBytes: number;
+                ramBytes: number;
+            };
+            usable: {
+                diskBytes: number;
+                ramBytes: number;
+            };
+        } | null;
     };
     durationMinutes: number;
     warnings: string[];
@@ -1222,6 +1282,12 @@ interface DataSourceJob {
     startedAt: string | null;
     finishedAt: string | null;
     lastProgressAt: string | null;
+    /**
+     * The job in the one progress shape: objects listed while planning,
+     * documents processed against the plan's projection after, with the
+     * coordinator's measured rate and ETA.
+     */
+    progress: OperationProgress;
 }
 /** GET /datasources/jobs */
 interface DataSourceJobsListResult {
@@ -1318,12 +1384,18 @@ interface DataSourceSyncResult {
  *   src/common/DataSources/evals/types.ts
  */
 
-/** An index reload in flight after an eviction, or its last failure. */
+/**
+ * An index reload in flight, or its last failure: after an eviction on the
+ * shared pool, after a lost node or a resume on dedicated capacity, or a
+ * reindex. Null on the source when the index is simply resident.
+ */
 interface DataSourcesHydration {
     copied: number;
     total: number;
     startedAt: string;
     error: string | null;
+    /** The reload in the one progress shape, with the platform's measured rate and ETA. */
+    progress: OperationProgress;
 }
 /** POST /datasources/hydrate */
 interface DataSourcesHydrateResult {
@@ -1948,14 +2020,16 @@ interface DataSourcesPlacement {
  * null) can be moving too.
  */
 /**
- * Dedicated capacity's index, as Qdrant reports it: `deferred` while a bulk
- * load runs (the node writes, nothing is indexed), `building` while the graph
- * is built after one, `ready` otherwise.
+ * Dedicated capacity's index, as Qdrant reports it: `building` while the
+ * optimizer is behind the writes (a load can outrun it for a while), `ready`
+ * otherwise.
  */
 interface DataSourcesIndex {
-    state: 'ready' | 'deferred' | 'building';
+    state: 'ready' | 'building';
     indexedVectors: number;
     totalVectors: number;
+    /** The optimizer's progress in the one shape, with the platform's measured rate and ETA. */
+    progress: OperationProgress;
 }
 interface DataSourcesMigration {
     /** Where it is going; null is the shared pool. */
@@ -1966,6 +2040,8 @@ interface DataSourcesMigration {
     startedAt: string;
     /** Set when the move failed; the source is unfrozen and a new move may start. */
     error: string | null;
+    /** The copy in the one progress shape, with the platform's measured rate and ETA. */
+    progress: OperationProgress;
 }
 /** One data source in the GET /datasources listing. */
 interface DataSourcesListEntry {
@@ -1999,10 +2075,9 @@ interface DataSourcesListEntry {
     /** An index reload in flight after an eviction, or its last failure. */
     hydration: DataSourcesHydration | null;
     /**
-     * Dedicated capacity only; null on the shared pool. `deferred` while a bulk
-     * load runs (the node writes, nothing is indexed), `building` while the
-     * index is built after one, `ready` otherwise. Search answers
-     * `index_building` (503) in the first two states.
+     * Dedicated capacity only; null on the shared pool. `building` while the
+     * optimizer is behind the writes, `ready` otherwise. Search answers
+     * `index_building` (503) while building.
      */
     index: DataSourcesIndex | null;
     /** The source this one was sampled from (`datasources sample`), or null. */
@@ -2278,7 +2353,7 @@ declare function addDocument(ctx: AdminContext, params: AddDocumentParams): Prom
 interface WaitForIngestParams {
     slug: string;
     documentIds: string[];
-    /** Defaults to DEFAULT_WAIT_TIMEOUT_MS (15 min). */
+    /** How long without movement before giving up. Defaults to DEFAULT_WAIT_TIMEOUT_MS (15 min). */
     timeoutMs?: number;
     /**
      * Receives the exact progress strings the CLI prints today:
@@ -2315,7 +2390,7 @@ interface WaitForIngestResult {
 declare function waitForIngest(ctx: AdminContext, params: WaitForIngestParams): Promise<WaitForIngestResult>;
 interface WaitForCandidateParams {
     slug: string;
-    /** Defaults to DEFAULT_WAIT_TIMEOUT_MS (15 min). */
+    /** How long without movement before giving up. Defaults to DEFAULT_WAIT_TIMEOUT_MS (15 min). */
     timeoutMs?: number;
     /** Receives `rebuilding… X/Y done (Ns)`. */
     onProgress?: (message: string) => void;
@@ -2540,9 +2615,9 @@ interface MoveParams {
 declare function move(ctx: AdminContext, params: MoveParams): Promise<DataSourcesMoveResult>;
 interface WaitForMoveParams {
     slug: string;
-    /** Defaults to DEFAULT_WAIT_TIMEOUT_MS (15 min). */
+    /** How long without movement before giving up. Defaults to DEFAULT_WAIT_TIMEOUT_MS (15 min). */
     timeoutMs?: number;
-    /** Receives `moving… X/Y documents (Ns)`. */
+    /** Receives `copying… X/Y documents · N/min · about M min left (Ns)`. */
     onProgress?: (message: string) => void;
 }
 type WaitForMoveResult = {
@@ -2813,11 +2888,16 @@ declare function resume$1(ctx: AdminContext, params: JobIdParams & {
     /** Embed at the provider's priority tier from here on (1.5x the embedding price). */
     priority?: boolean;
 }): Promise<DataSourceJobResult>;
+/**
+ * Run a finished job's failed batches again, after fixing what failed them.
+ * The job goes back to `running`; `nothing_to_retry` when none failed.
+ */
+declare function retry(ctx: AdminContext, params: JobIdParams): Promise<DataSourceJobResult>;
 /** End the job. Documents already indexed stay. */
 declare function cancel(ctx: AdminContext, params: JobIdParams): Promise<DataSourceJobResult>;
 interface WaitParams$1 {
     id: string;
-    /** Default one hour. */
+    /** How long without movement before giving up. Default one hour. */
     timeoutMs?: number;
     onProgress?: (message: string) => void;
 }
@@ -2853,7 +2933,11 @@ declare function waitForPlan(ctx: AdminContext, params: WaitParams$1): Promise<W
  * with the pause reason, since nothing more will happen without them.
  */
 declare function waitForJob(ctx: AdminContext, params: WaitParams$1): Promise<WaitResult>;
-/** One line of progress in the job's own terms. */
+/**
+ * One line of progress in the job's own terms: the platform's phase, count,
+ * rate and ETA, with the spend so far beside them. A planning walk that has
+ * finished listing says so, since its count has stopped moving on purpose.
+ */
 declare function describeProgress(job: DataSourceJob, start: number): string;
 
 type dataSourceJobs_JobIdParams = JobIdParams;
@@ -2864,12 +2948,13 @@ declare const dataSourceJobs_approve: typeof approve;
 declare const dataSourceJobs_cancel: typeof cancel;
 declare const dataSourceJobs_describeProgress: typeof describeProgress;
 declare const dataSourceJobs_pause: typeof pause;
+declare const dataSourceJobs_retry: typeof retry;
 declare const dataSourceJobs_start: typeof start;
 declare const dataSourceJobs_uploadManifest: typeof uploadManifest;
 declare const dataSourceJobs_waitForJob: typeof waitForJob;
 declare const dataSourceJobs_waitForPlan: typeof waitForPlan;
 declare namespace dataSourceJobs {
-  export { DEFAULT_WAIT_TIMEOUT_MS$2 as DEFAULT_WAIT_TIMEOUT_MS, type dataSourceJobs_JobIdParams as JobIdParams, type ListParams$1 as ListParams, type dataSourceJobs_StartParams as StartParams, type dataSourceJobs_UploadManifestParams as UploadManifestParams, type WaitParams$1 as WaitParams, type dataSourceJobs_WaitResult as WaitResult, dataSourceJobs_approve as approve, dataSourceJobs_cancel as cancel, dataSourceJobs_describeProgress as describeProgress, get$7 as get, list$7 as list, dataSourceJobs_pause as pause, resume$1 as resume, dataSourceJobs_start as start, dataSourceJobs_uploadManifest as uploadManifest, dataSourceJobs_waitForJob as waitForJob, dataSourceJobs_waitForPlan as waitForPlan };
+  export { DEFAULT_WAIT_TIMEOUT_MS$2 as DEFAULT_WAIT_TIMEOUT_MS, type dataSourceJobs_JobIdParams as JobIdParams, type ListParams$1 as ListParams, type dataSourceJobs_StartParams as StartParams, type dataSourceJobs_UploadManifestParams as UploadManifestParams, type WaitParams$1 as WaitParams, type dataSourceJobs_WaitResult as WaitResult, dataSourceJobs_approve as approve, dataSourceJobs_cancel as cancel, dataSourceJobs_describeProgress as describeProgress, get$7 as get, list$7 as list, dataSourceJobs_pause as pause, resume$1 as resume, dataSourceJobs_retry as retry, dataSourceJobs_start as start, dataSourceJobs_uploadManifest as uploadManifest, dataSourceJobs_waitForJob as waitForJob, dataSourceJobs_waitForPlan as waitForPlan };
 }
 
 /**
@@ -2973,15 +3058,9 @@ declare const DEFAULT_WAIT_TIMEOUT_MS$1: number;
  * Warm a source's index if it is cold. A search on a large cold index answers
  * `index_warming` until the reload lands; call this before a demo, or after an
  * eviction you know about. Answers `resident: true` when nothing was needed.
- *
- * With `since`, refill instead: copy every document built at or after that
- * time into the index whether or not it is resident. What a dedicated
- * instance needs after restoring from a snapshot taken then; the platform
- * does this on its own when it sees the restore, this is the by-hand path.
  */
 declare function hydrate(ctx: AdminContext, params: {
     slug: string;
-    since?: string;
 }): Promise<DataSourcesHydrateResult>;
 /**
  * Recreate a dedicated source's collection with the platform's current shape
@@ -2999,7 +3078,9 @@ declare function reindex(ctx: AdminContext, params: {
 }): Promise<DataSourcesHydrateResult>;
 interface WaitForHydrationParams {
     slug: string;
+    /** How long without movement before giving up. Defaults to DEFAULT_WAIT_TIMEOUT_MS (30 min). */
     timeoutMs?: number;
+    /** Receives `copying… X/Y documents · N/min · about M min left (Ns)`. */
     onProgress?: (message: string) => void;
 }
 type WaitForHydrationResult = {
@@ -4525,32 +4606,42 @@ declare namespace files {
  *   src/common/Provisioning/types.ts
  *   src/common/Provisioning/offerings/define.ts
  */
+
 /** Where a resource is in its lifecycle. Written only by the platform. */
 type InfraPhase = 'requested' | 'provisioning' | 'active' | 'hibernating' | 'hibernated' | 'resuming' | 'decommissioning' | 'destroyed' | 'failed';
 /** What the owner asked for. Written only by the owner's actions. */
 type InfraDesiredState = 'active' | 'hibernated' | 'destroyed';
 /**
- * What the platform last saw of an active resource's instance. `restoring` is
- * an instance that came back empty and is being refilled from its snapshot;
- * searches return `capacity_restoring` until it is `ready`.
+ * What the platform last saw of an active resource's instance. `rebuilding`
+ * is a serving instance onto which one or more placed sources are being copied
+ * back from durable storage (a new pod found their index empty); searches on
+ * those sources answer `index_warming` with the copy's progress until it lands.
  */
-type InfraHealth = 'ready' | 'not-ready' | 'missing' | 'restoring';
+type InfraHealth = 'ready' | 'not-ready' | 'missing' | 'rebuilding';
 /** A leasable product from the platform catalog. Prices are cogs + margin. */
 interface InfraOffering {
     id: string;
     kind: 'retrieval';
     /** User-facing size, e.g. "Small". */
     label: string;
-    /** User-facing capacity, e.g. "Up to ~1M chunks". */
+    /** User-facing capacity, e.g. "Up to ~34M chunks at 2560 dimensions (~48M at 1024, ~26M at 4096)". */
     description: string;
     hourlyPriceDollars: number;
     /** Hourly × 730. */
     monthlyPriceDollars: number;
-    /** Retained-storage rate while hibernated. */
+    /** Zero: a hibernated resource holds nothing; its sources' documents stay in the platform's own store. */
     hibernatedHourlyPriceDollars: number;
     hibernatedMonthlyPriceDollars: number;
+    /**
+     * What the size holds: its disk and RAM, and the chunks that comes to at
+     * each embedding dimension on offer, keyed by dimension ("2560"). A chunk
+     * embedded at 2560 dimensions takes two and a half times a 1024-dimension
+     * one, so a resource's room depends on what is placed on it.
+     */
     capacity: {
-        maxPoints: number;
+        diskGiB: number;
+        memoryGiB: number;
+        chunksByDimensions: Record<string, number>;
     };
     capabilities: {
         hibernate: boolean;
@@ -4573,17 +4664,36 @@ interface InfraResource {
     health: InfraHealth | null;
     /**
      * What the instance is doing right now, while a transition is under way
-     * ("Waiting for capacity", "Snapshotting collection 1/2"); null when nothing is.
+     * ("Waiting for capacity", "Starting Qdrant", "Scaling down"); null when nothing is.
      */
     detail: string | null;
+    /**
+     * The same in the one progress shape, with numbers where there are any: a
+     * rebuild of the sources placed here (documents, rate, ETA), an index build
+     * the optimizer is behind on (vectors), or a transition's step. Null when the
+     * resource is simply serving.
+     */
+    progress: OperationProgress | null;
+    /**
+     * What the sources placed here take on the instance: estimated from their
+     * chunk counts at their dimensions, and measured from the instance itself
+     * while it is up (null until it has reported), against what the size can
+     * hold. Null when the offering is unknown.
+     */
+    footprint: {
+        chunks: number;
+        estimatedDiskBytes: number;
+        measuredDiskBytes: number | null;
+        measuredRamBytes: number | null;
+        measuredAt: string | null;
+        usableDiskBytes: number;
+    } | null;
     /**
      * The size this resource is being resized to, while a resize is under way;
      * null otherwise. A resize passes through `hibernated` and back to the phase
      * it started from.
      */
     resizingTo: InfraOffering | null;
-    /** When the last verified snapshot was taken; null if never. */
-    lastSnapshotAt: string | null;
     /**
      * What this resource has actually been charged, from the ledger's own
      * writes, with the hours at each rate beside it. Rates are on `offering`.
@@ -4612,7 +4722,8 @@ interface InfraEvent {
 }
 /**
  * One line of the platform's narration of a resource: a step reported while
- * a transition ran ("Waiting for capacity", "Restoring collections 2/3"), a
+ * a transition ran ("Waiting for capacity", "Starting Qdrant"), a rebuild it
+ * started ("Instance replaced; checking each placed source's index on it"), a
  * failed attempt, or a failure with what Kubernetes said about the pod at the
  * time (`data`). Not the instance's own stdout.
  */
@@ -4759,16 +4870,17 @@ interface ResizeParams {
     offeringId: string;
 }
 /**
- * Change a resource's size, keeping its data.
+ * Change a resource's size, keeping its documents.
  *
- * The platform parks the resource (a fresh snapshot), swaps its spec, and
- * brings it back up restored from that snapshot, so a resize passes through
- * `hibernated` and searches on its sources pause for the few minutes it
- * takes. A resource that is already hibernated swaps in place and stays
- * parked. Growing is gated on a month of credits at the new rate like a
- * provision; shrinking is refused below what the resource holds. The response
- * carries `resizingTo` until the swap has happened; `waitForPhase` with
- * `until: (r) => r.resizingTo === null` blocks on the whole thing.
+ * The platform parks the resource, swaps its spec, and brings it back up with
+ * its sources' indexes rebuilt from durable storage in the background, so a
+ * resize passes through `hibernated` and searches on those sources answer
+ * `index_warming` with the rebuild's progress until it lands. A resource that
+ * is already hibernated swaps in place and stays parked. Growing is gated on a
+ * month of credits at the new rate like a provision; shrinking is refused
+ * below what the resource holds. The response carries `resizingTo` until the
+ * swap has happened; `waitForPhase` with `until: (r) => r.resizingTo === null`
+ * blocks on the whole thing.
  *
  * @throws AdminApiError `resource_not_found` (404), `offering_not_found`
  *   (400), `offering_retired` (422), `same_offering` (400),
@@ -4793,7 +4905,7 @@ interface WaitForPhaseParams {
      * phase it started from and is done only once `resizingTo` has cleared.
      */
     until?: (resource: InfraResource) => boolean;
-    /** Default 10 minutes. */
+    /** How long without movement before giving up. Default 10 minutes. */
     timeoutMs?: number;
     onProgress?: (message: string) => void;
 }
@@ -7370,4 +7482,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 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 IssueKind, 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 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 };
+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 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 IssueKind, 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 };

package/dist/index.js

@@ -393,6 +393,8 @@ function sleep(ms) {
 // src/poll.ts
 async function pollUntil(read, isSettled, options) {
   const start2 = Date.now();
+  let movedAt = start2;
+  let lastKey;
   let transientSince = null;
   while (true) {
     let value;
@@ -416,7 +418,14 @@ async function pollUntil(read, isSettled, options) {
     if (isSettled(value)) {
       return { settled: true, value };
     }
-    if (Date.now() - start2 > options.timeoutMs) {
+    if (options.progressKey) {
+      const key = options.progressKey(value);
+      if (key !== lastKey) {
+        lastKey = key;
+        movedAt = Date.now();
+      }
+    }
+    if (Date.now() - movedAt > options.timeoutMs) {
       return { settled: false, value };
     }
     if (options.describe) {
@@ -432,6 +441,34 @@ function timedOut(timeoutMs, still) {
   return `Timed out after ${Math.round(timeoutMs / 1e3)}s ${still}`;
 }
 
+// src/output.ts
+var PRETTY = process.stdout.isTTY === true;
+function describeEta(eta, now = Date.now()) {
+  if (!eta) {
+    return null;
+  }
+  const minutes = Math.max(1, Math.round((Date.parse(eta) - now) / 6e4));
+  if (minutes < 90) {
+    return `about ${minutes} min left`;
+  }
+  const hours = Math.round(minutes / 60 * 10) / 10;
+  return `about ${hours} h left`;
+}
+function renderProgress(p, start2, extra) {
+  const count = p.total !== null ? `${p.done.toLocaleString()}/${p.total.toLocaleString()} ${p.unit}` : p.done > 0 ? `${p.done.toLocaleString()} ${p.unit}` : null;
+  const rate = p.ratePerMinute !== null && p.ratePerMinute > 0 ? `${Math.round(p.ratePerMinute).toLocaleString()}/min` : null;
+  const parts = [
+    `${p.phase}\u2026`,
+    count,
+    rate,
+    describeEta(p.etaAt),
+    extra ?? null,
+    p.stalled ? "no progress for 30 min" : null
+  ].filter((part) => Boolean(part));
+  const elapsed = start2 !== void 0 ? ` (${elapsedSeconds(start2)}s)` : "";
+  return `${parts.join(" \xB7 ")}${elapsed}`;
+}
+
 // src/upload.ts
 async function uploadDirect(upload, bytes, filename) {
   const form = new FormData();
@@ -534,6 +571,7 @@ async function waitForIngest(ctx, params) {
       timeoutMs,
       pollMs: POLL_MS,
       describe: (tracked2, start2) => `ingesting\u2026 ${tracked2.length - pendingOf(tracked2).length}/${tracked2.length} done (${elapsedSeconds(start2)}s)`,
+      progressKey: (tracked2) => pendingOf(tracked2).length,
       onProgress
     }
   );
@@ -570,6 +608,7 @@ async function waitForCandidate(ctx, params) {
       timeoutMs,
       pollMs: POLL_MS,
       describe: (progress, start2) => progress ? `rebuilding\u2026 ${progress.done}/${progress.total} done (${elapsedSeconds(start2)}s)` : `rebuilding\u2026 (${elapsedSeconds(start2)}s)`,
+      progressKey: (progress) => progress?.processing ?? null,
       onProgress: params.onProgress
     }
   );
@@ -722,7 +761,10 @@ async function waitForMove(ctx, params) {
     {
       timeoutMs,
       pollMs: POLL_MS,
-      describe: (source2, start2) => `moving\u2026 ${source2.migration.copied}/${source2.migration.total} documents (${elapsedSeconds(start2)}s)`,
+      describe: (source2, start2) => renderProgress(source2.migration.progress, start2),
+      // A corpus of any size moves as long as it keeps moving; the timeout
+      // bounds silence.
+      progressKey: (source2) => source2.migration?.copied ?? null,
       onProgress: params.onProgress
     }
   );
@@ -829,6 +871,7 @@ __export(dataSourceJobs_exports, {
   list: () => list4,
   pause: () => pause,
   resume: () => resume,
+  retry: () => retry,
   start: () => start,
   uploadManifest: () => uploadManifest,
   waitForJob: () => waitForJob,
@@ -905,6 +948,13 @@ function resume(ctx, params) {
     controlBody(params)
   );
 }
+function retry(ctx, params) {
+  return call(
+    ctx,
+    "POST",
+    `${base2(ctx.appId)}/${encodeURIComponent(params.id)}/retry`
+  );
+}
 function cancel(ctx, params) {
   return call(
     ctx,
@@ -931,6 +981,9 @@ async function settle(ctx, params, isSettled) {
       timeoutMs,
       pollMs: POLL_MS2,
       describe: describeProgress,
+      // A load of any length is waited out while it moves; the timeout bounds
+      // silence. Planning moves by objects listed, a run by documents.
+      progressKey: (job2) => `${job2.state}:${job2.progress.done}`,
       onProgress: params.onProgress
     }
   );
@@ -966,14 +1019,15 @@ async function settle(ctx, params, isSettled) {
   return { status: "done", job };
 }
 function describeProgress(job, start2) {
-  const elapsed = `(${elapsedSeconds(start2)}s)`;
-  if (job.state === "planning") {
-    return job.enumerationDone ? `planning\u2026 reading a sample of ${job.counts.objectsSeen.toLocaleString()} objects ${elapsed}` : `planning\u2026 ${job.counts.objectsSeen.toLocaleString()} objects counted ${elapsed}`;
+  if (job.state === "planning" && job.enumerationDone) {
+    return renderProgress(
+      { ...job.progress, phase: "planning" },
+      start2,
+      `reading a sample of ${job.counts.objectsSeen.toLocaleString()} objects`
+    );
   }
-  const total = job.plan?.projected.documents ?? job.counts.objectsSeen;
-  const processed = job.counts.documentsDone + job.counts.documentsSkipped + job.counts.documentsFailed;
-  const spend = `$${job.estimatedDollars.toFixed(2)}${job.budgetDollars !== null ? ` of $${job.budgetDollars.toFixed(2)}` : ""}`;
-  return `${job.state}\u2026 ${processed.toLocaleString()}/${total.toLocaleString()} documents \xB7 ${spend} ${elapsed}`;
+  const spend = job.state === "planning" ? null : `$${job.estimatedDollars.toFixed(2)}${job.budgetDollars !== null ? ` of $${job.budgetDollars.toFixed(2)}` : ""}`;
+  return renderProgress(job.progress, start2, spend);
 }
 
 // src/ops/dataSourceConnectors.ts
@@ -1073,7 +1127,7 @@ function hydrate(ctx, params) {
     ctx,
     "POST",
     `${base4(ctx.appId)}/hydrate`,
-    { slug: params.slug, ...params.since ? { since: params.since } : {} }
+    { slug: params.slug }
   );
 }
 function reindex(ctx, params) {
@@ -1099,7 +1153,10 @@ async function waitForHydration(ctx, params) {
     {
       timeoutMs,
       pollMs: POLL_MS3,
-      describe: (source2, start2) => `loading\u2026 ${source2.hydration.copied}/${source2.hydration.total} documents (${elapsedSeconds(start2)}s)`,
+      describe: (source2, start2) => renderProgress(source2.hydration.progress, start2),
+      // A reload of any size is waited out while it moves; the timeout
+      // bounds silence.
+      progressKey: (source2) => source2.hydration?.copied ?? null,
       onProgress: params.onProgress
     }
   );
@@ -1978,7 +2035,14 @@ async function waitForPhase(ctx, params) {
     {
       timeoutMs,
       pollMs: POLL_MS5,
-      describe: (resource2, start2) => `${resource2.phase}${resource2.detail ? ` \xB7 ${resource2.detail}` : ""}${resource2.resizingTo ? ` \xB7 resizing to ${resource2.resizingTo.label}` : ""}\u2026 (${elapsedSeconds(start2)}s)`,
+      describe: (resource2, start2) => resource2.progress ? renderProgress(
+        resource2.progress,
+        start2,
+        resource2.resizingTo ? `resizing to ${resource2.resizingTo.label}` : null
+      ) : `${resource2.phase}${resource2.detail ? ` \xB7 ${resource2.detail}` : ""}${resource2.resizingTo ? ` \xB7 resizing to ${resource2.resizingTo.label}` : ""}\u2026 (${elapsedSeconds(start2)}s)`,
+      // A rebuild after a resume runs as long as it must; the timeout bounds
+      // silence, and a phase or step change counts as movement.
+      progressKey: (resource2) => `${resource2.phase}:${resource2.progress?.done ?? ""}:${resource2.detail ?? ""}`,
       onProgress: params.onProgress
     }
   );