@madewithremy/admin 0.1.13 → 0.1.15

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 {
@@ -1873,7 +1945,8 @@ interface DataSourcesDocumentStatus {
 }
 /**
  * GET /datasources/documents — one page of per-document ingest state for one
- * pipeline, oldest first.
+ * pipeline, oldest first unless `order=newest`; `status=error` is the failures,
+ * newest failure first; `filename` a prefix.
  *
  * `pipelineVersion` is absent when the data source does not exist (returns `{ documents: [] }`).
  * `candidate=true` watches a migration in progress. `nextCursor` is set when
@@ -1947,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. */
@@ -1965,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 {
@@ -1998,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. */
@@ -2152,13 +2228,18 @@ interface DataSourcesPromoteResult {
 interface DataSourcesDropResult {
     dropped: number;
 }
-/** POST /datasources/delete — delete every version, document, and byte. */
+/**
+ * POST /datasources/delete — delete every version, document, and byte. The
+ * source is gone to every reader when this returns; its rows and objects are
+ * removed by a background job, which `purging` says.
+ */
 interface DataSourcesDeleteResult {
     deleted: true;
-    /** Number of documents removed. */
+    /** Number of documents being removed. */
     documents: number;
-    /** Number of pipeline versions dropped. */
+    /** Number of pipeline versions being dropped. */
     versions: number;
+    purging: boolean;
 }
 /**
  * POST /datasources/documents/delete — always responds 204 (empty body).
@@ -2272,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:
@@ -2309,20 +2390,27 @@ 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;
 }
 interface WaitForCandidateResult {
     status: 'ready' | 'error' | 'timeout';
+    /** The candidate's build counts when the wait ended; null when it had no candidate. */
+    counts: DataSourcesBuildProgress | null;
+    /** The failed documents, first page, when any failed. */
     documents: SummarizedDocument[];
     /** Present only on status === 'timeout'. */
     error?: string;
 }
+/** Failed documents fetched for a status or a candidate wait. */
+declare const FAILURES_PAGE = 50;
 /**
  * Poll a candidate version (`revectorize`) until every document has built.
- * `error` means at least one failed; `promote` with `force` accepts that.
+ * Reads the candidate's counts from the source list — one row, whatever the
+ * corpus holds — and fetches the failures only at the end. `error` means at
+ * least one failed; `promote` with `force` accepts that.
  */
 declare function waitForCandidate(ctx: AdminContext, params: WaitForCandidateParams): Promise<WaitForCandidateResult>;
 interface DocumentsParams {
@@ -2336,11 +2424,19 @@ interface DocumentsParams {
     limit?: number;
     /** `nextCursor` from the previous page. */
     cursor?: string;
+    /** By the time the document was added; oldest first unless said otherwise. */
+    order?: 'oldest' | 'newest';
+    /** The failed builds only, newest failure first. */
+    status?: 'error';
+    /** Filenames starting with this. */
+    filename?: string;
 }
 /** The server's cap on `ids` per request; `allDocuments` chunks to it. */
 declare const DOCUMENTS_IDS_MAX = 200;
 /**
- * Fetch one page of per-document ingest state for one pipeline, oldest first.
+ * Fetch one page of per-document ingest state for one pipeline, oldest first
+ * unless `order` says otherwise; `status: 'error'` narrows to the failures and
+ * `filename` to a name prefix.
  *
  * Returns an empty document list when the data source does not exist yet.
  * Pass `candidate: true` to watch a revectorization in progress. Follow
@@ -2348,6 +2444,7 @@ declare const DOCUMENTS_IDS_MAX = 200;
  *
  * @example
  * const { documents, nextCursor } = await admin.dataSources.documents({ slug: 'policies' });
+ * const failed = await admin.dataSources.documents({ slug: 'policies', status: 'error' });
  */
 declare function documents(ctx: AdminContext, params: DocumentsParams): Promise<DataSourcesDocumentsResult>;
 /**
@@ -2518,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 = {
@@ -2666,6 +2763,7 @@ type dataSources_CreateParams = CreateParams;
 declare const dataSources_DOCUMENTS_IDS_MAX: typeof DOCUMENTS_IDS_MAX;
 type dataSources_DocumentsParams = DocumentsParams;
 type dataSources_DropParams = DropParams;
+declare const dataSources_FAILURES_PAGE: typeof FAILURES_PAGE;
 type dataSources_MoveParams = MoveParams;
 type dataSources_PromoteParams = PromoteParams;
 type dataSources_RevectorizeParams = RevectorizeParams;
@@ -2698,7 +2796,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_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, 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, 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_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_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, 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_summarize as summarize, dataSources_waitForCandidate as waitForCandidate, dataSources_waitForIngest as waitForIngest, dataSources_waitForMove as waitForMove };
 }
 
 /**
@@ -2794,7 +2892,7 @@ declare function resume$1(ctx: AdminContext, params: JobIdParams & {
 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;
 }
@@ -2830,7 +2928,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;
@@ -2970,7 +3072,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 = {
@@ -4496,32 +4600,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;
@@ -4544,17 +4658,46 @@ 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`.
+     */
+    billing: {
+        activeHours: number;
+        hibernatedHours: number;
+        billedDollars: number;
+        lastBilledAt: string | null;
+    };
     activatedAt: string | null;
     hibernatedAt: string | null;
     destroyedAt: string | null;
@@ -4571,6 +4714,24 @@ interface InfraEvent {
     reason: string | null;
     createdAt: string;
 }
+/**
+ * One line of the platform's narration of a resource: a step reported while
+ * 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.
+ */
+interface InfraLogLine {
+    id: string;
+    phase: InfraPhase;
+    level: 'info' | 'warn' | 'error';
+    message: string;
+    data: {
+        podEvents: string[];
+        logTail: string[];
+    } | null;
+    createdAt: string;
+}
 /** GET /infra */
 interface InfraListResult {
     resources: InfraResource[];
@@ -4582,12 +4743,19 @@ interface InfraListResult {
 interface InfraGetResult {
     resource: InfraResource;
     events: InfraEvent[];
+    /** The newest 200 narration lines, oldest first; `logs()` pages further. */
+    logs: InfraLogLine[];
     attachedSources: {
         id: string;
         slug: string;
         name: string | null;
     }[];
 }
+/** GET /infra/:id/logs */
+interface InfraLogsResult {
+    /** Oldest first. */
+    logs: InfraLogLine[];
+}
 /** POST /infra, /infra/:id/{hibernate,resume,destroy,rename,resize} */
 interface InfraResourceResult {
     resource: InfraResource;
@@ -4625,6 +4793,23 @@ interface GetParams {
  * @throws AdminApiError `resource_not_found` (404).
  */
 declare function get$4(ctx: AdminContext, params: GetParams): Promise<InfraGetResult>;
+interface LogsParams {
+    /** Resource id. */
+    id: string;
+    /** Continue after this line id (the last line of a previous page). */
+    after?: string;
+    /** Lines per page; without `after`, the newest this many. Max 500. */
+    limit?: number;
+}
+/**
+ * The platform's narration of a resource, oldest first: the steps a
+ * transition went through, failed attempts, and failures with the pod's
+ * events and a warnings-and-errors tail of the instance log. Not the
+ * instance's own stdout.
+ *
+ * @throws AdminApiError `resource_not_found` (404).
+ */
+declare function logs(ctx: AdminContext, params: LogsParams): Promise<InfraLogsResult>;
 interface ProvisionParams {
     /** Offering id from `list().offerings`, e.g. `retrieval.small`. */
     offeringId: string;
@@ -4679,16 +4864,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),
@@ -4713,7 +4899,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;
 }
@@ -4741,6 +4927,7 @@ declare function waitForPhase(ctx: AdminContext, params: WaitForPhaseParams): Pr
 declare const infra_DEFAULT_WAIT_TIMEOUT_MS: typeof DEFAULT_WAIT_TIMEOUT_MS;
 type infra_GetParams = GetParams;
 type infra_ListParams = ListParams;
+type infra_LogsParams = LogsParams;
 type infra_ProvisionParams = ProvisionParams;
 type infra_RenameParams = RenameParams;
 type infra_ResizeParams = ResizeParams;
@@ -4749,13 +4936,14 @@ type infra_WaitForPhaseParams = WaitForPhaseParams;
 type infra_WaitForPhaseResult = WaitForPhaseResult;
 declare const infra_destroy: typeof destroy;
 declare const infra_hibernate: typeof hibernate;
+declare const infra_logs: typeof logs;
 declare const infra_provision: typeof provision;
 declare const infra_rename: typeof rename;
 declare const infra_resize: typeof resize;
 declare const infra_resume: typeof resume;
 declare const infra_waitForPhase: typeof waitForPhase;
 declare namespace infra {
-  export { infra_DEFAULT_WAIT_TIMEOUT_MS as DEFAULT_WAIT_TIMEOUT_MS, type infra_GetParams as GetParams, type infra_ListParams as ListParams, type infra_ProvisionParams as ProvisionParams, type infra_RenameParams as RenameParams, type infra_ResizeParams as ResizeParams, type infra_ResourceIdParams as ResourceIdParams, type infra_WaitForPhaseParams as WaitForPhaseParams, type infra_WaitForPhaseResult as WaitForPhaseResult, infra_destroy as destroy, get$4 as get, infra_hibernate as hibernate, list$6 as list, infra_provision as provision, infra_rename as rename, infra_resize as resize, infra_resume as resume, infra_waitForPhase as waitForPhase };
+  export { infra_DEFAULT_WAIT_TIMEOUT_MS as DEFAULT_WAIT_TIMEOUT_MS, type infra_GetParams as GetParams, type infra_ListParams as ListParams, type infra_LogsParams as LogsParams, type infra_ProvisionParams as ProvisionParams, type infra_RenameParams as RenameParams, type infra_ResizeParams as ResizeParams, type infra_ResourceIdParams as ResourceIdParams, type infra_WaitForPhaseParams as WaitForPhaseParams, type infra_WaitForPhaseResult as WaitForPhaseResult, infra_destroy as destroy, get$4 as get, infra_hibernate as hibernate, list$6 as list, infra_logs as logs, infra_provision as provision, infra_rename as rename, infra_resize as resize, infra_resume as resume, infra_waitForPhase as waitForPhase };
 }
 
 /**
@@ -7288,4 +7476,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 };