@madewithremy/admin 0.1.5 → 0.1.6

package/dist/index.d.ts

@@ -808,7 +808,7 @@ interface CrashesStatsParams {
  * @example
  * const { errors } = await admin.crashes.list({ sort: 'frequent', limit: 10 });
  */
-declare function list$8(ctx: AdminContext, params?: CrashesListParams): Promise<CrashesListResult>;
+declare function list$9(ctx: AdminContext, params?: CrashesListParams): Promise<CrashesListResult>;
 /**
  * Individual crash events for one fingerprint, cursor-paginated.
  *
@@ -829,7 +829,7 @@ declare function occurrences(ctx: AdminContext, fingerprint: string, params?: Cr
  * @example
  * const event = await admin.crashes.get('evt_xyz789');
  */
-declare function get$5(ctx: AdminContext, eventId: string): Promise<CrashesGetResult>;
+declare function get$6(ctx: AdminContext, eventId: string): Promise<CrashesGetResult>;
 /**
  * Bucketed time series of total crash occurrence volume for the app.
  *
@@ -847,7 +847,7 @@ type crashes_CrashesStatsParams = CrashesStatsParams;
 declare const crashes_occurrences: typeof occurrences;
 declare const crashes_stats: typeof stats;
 declare namespace crashes {
-  export { type crashes_CrashesListParams as CrashesListParams, type crashes_CrashesOccurrencesParams as CrashesOccurrencesParams, type crashes_CrashesStatsParams as CrashesStatsParams, get$5 as get, list$8 as list, crashes_occurrences as occurrences, crashes_stats as stats };
+  export { type crashes_CrashesListParams as CrashesListParams, type crashes_CrashesOccurrencesParams as CrashesOccurrencesParams, type crashes_CrashesStatsParams as CrashesStatsParams, get$6 as get, list$9 as list, crashes_occurrences as occurrences, crashes_stats as stats };
 }
 
 /**
@@ -942,7 +942,7 @@ interface CronListParams {
  * const { jobs } = await admin.cron.list({ runs: 50 });
  * const blocked = jobs.filter((j) => j.status === 'blocked');
  */
-declare function list$7(ctx: AdminContext, params?: CronListParams): Promise<CronOverviewResult>;
+declare function list$8(ctx: AdminContext, params?: CronListParams): Promise<CronOverviewResult>;
 /**
  * Trigger a job now (does not affect its schedule).
  *
@@ -962,7 +962,7 @@ declare function run(ctx: AdminContext, route: string): Promise<CronRunResult>;
 type cron_CronListParams = CronListParams;
 declare const cron_run: typeof run;
 declare namespace cron {
-  export { type cron_CronListParams as CronListParams, list$7 as list, cron_run as run };
+  export { type cron_CronListParams as CronListParams, list$8 as list, cron_run as run };
 }
 
 /**
@@ -1075,10 +1075,20 @@ declare namespace data {
  * Chunking settings pinned at pipeline creation.
  * Any change requires a revectorize, not a config update.
  */
+/**
+ * `structural` splits on document structure (headings, blocks, paragraphs);
+ * `whole` embeds each document as a single chunk, for corpora of short records
+ * where the document is the retrieval unit.
+ */
+type DataSourcesChunkingStrategy = 'structural' | 'whole';
 interface DataSourcesChunkingConfig {
-    strategy: 'structural';
+    strategy: DataSourcesChunkingStrategy;
     version: number;
-    /** Rough char budget per chunk; structure wins over budget, never the reverse. */
+    /**
+     * Rough char budget per chunk; structure wins over budget, never the reverse.
+     * For `whole`, the ceiling above which a document is chunked structurally
+     * instead (default 24000).
+     */
     maxChars: number;
     /** Below this a chunk is merged forward rather than embedded on its own. */
     minChars: number;
@@ -1123,6 +1133,8 @@ interface DataSourcesIngestConfig {
  */
 interface DataSourcesIngestUpdate {
     chunking?: {
+        /** Naming a strategy pins its current version; versions are not settable. */
+        strategy?: DataSourcesChunkingStrategy;
         maxChars?: number;
         minChars?: number;
         dropBlockTypes?: string[];
@@ -1135,8 +1147,13 @@ interface DataSourcesIngestUpdate {
         describe?: boolean;
         modelId?: string;
     };
+    /**
+     * `dimensions` must be the model's native size or one of its Matryoshka
+     * sizes; omitted = native. Either half alone re-resolves the pair.
+     */
     embedding?: {
-        modelId: string;
+        modelId?: string;
+        dimensions?: number;
     };
     extraction?: {
         modelId: string;
@@ -1203,13 +1220,16 @@ interface DataSourcesDocumentStatus {
     ingestedAt: string | null;
 }
 /**
- * GET /datasources/documents — per-document ingest state for one pipeline.
+ * GET /datasources/documents — one page of per-document ingest state for one
+ * pipeline, oldest first.
  *
  * `pipelineVersion` is absent when the data source does not exist (returns `{ documents: [] }`).
- * `candidate=true` watches a migration in progress.
+ * `candidate=true` watches a migration in progress. `nextCursor` is set when
+ * more pages follow; `allDocuments` walks them.
  */
 interface DataSourcesDocumentsResult {
     pipelineVersion?: number;
+    nextCursor?: string | null;
     documents: DataSourcesDocumentStatus[];
 }
 /**
@@ -1242,6 +1262,17 @@ interface DataSourcesBuildProgress {
     processing: number;
     error: number;
 }
+/**
+ * Where a source's index lives. Null is the shared pool. `phase` is the
+ * resource's lifecycle phase (see types/infra.ts); anything but `active` means
+ * searches on this source fail with `capacity_<phase>`.
+ */
+interface DataSourcesPlacement {
+    resourceId: string;
+    name: string | null;
+    offeringLabel: string | null;
+    phase: string;
+}
 /** One data source in the GET /datasources listing. */
 interface DataSourcesListEntry {
     id: string;
@@ -1263,6 +1294,8 @@ interface DataSourcesListEntry {
         version: number;
         progress: DataSourcesBuildProgress;
     } | null;
+    /** Dedicated placement, or null for the shared pool. */
+    placement: DataSourcesPlacement | null;
     createdAt: string;
 }
 /** GET /datasources — all data sources for the app. */
@@ -1350,8 +1383,26 @@ interface DataSourcesConfigResult {
 /** POST /datasources/config — response after updating configuration. */
 interface DataSourcesConfigUpdateResult {
     ingestChanged: boolean;
+    placementChanged: boolean;
     ingest: DataSourcesIngestConfig;
     retrieval: Partial<DataSourcesRetrievalConfig>;
+    placement: DataSourcesPlacement | null;
+}
+/** POST /datasources — an empty source, on the requested placement. */
+interface DataSourcesCreateResult {
+    dataSource: {
+        id: string;
+        slug: string;
+        name: string | null;
+        /** Dedicated resource id, or null for the shared pool. */
+        resourceId: string | null;
+        createdAt: string;
+    };
+    pipeline: {
+        version: number;
+        config: DataSourcesIngestConfig;
+    };
+    placement: DataSourcesPlacement | null;
 }
 /**
  * POST /datasources/revectorize — starts a new candidate pipeline alongside the live one.
@@ -1405,7 +1456,7 @@ interface DataSourcesDocumentDeleteResult {
  */
 
 /** @internal Consumed by the CLI skin; waitForIngest documents the default. */
-declare const DEFAULT_WAIT_TIMEOUT_MS: number;
+declare const DEFAULT_WAIT_TIMEOUT_MS$1: number;
 /**
  * The per-document summary projection used by waitForIngest, status, and the
  * revectorize watch loop in the skin. Exported so the skin can reuse it for
@@ -1507,17 +1558,37 @@ interface DocumentsParams {
     slug: string;
     /** true → watch a candidate pipeline (revectorize in progress). */
     candidate?: boolean;
+    /** Only these documents (at most DOCUMENTS_IDS_MAX per request). */
+    ids?: string[];
+    /** Page size, 1..1000 (server default 500). */
+    limit?: number;
+    /** `nextCursor` from the previous page. */
+    cursor?: string;
 }
+/** The server's cap on `ids` per request; `allDocuments` chunks to it. */
+declare const DOCUMENTS_IDS_MAX = 200;
 /**
- * Fetch per-document ingest state for one pipeline.
+ * Fetch one page of per-document ingest state for one pipeline, oldest first.
  *
  * Returns an empty document list when the data source does not exist yet.
- * Pass `candidate: true` to watch a revectorization in progress.
+ * Pass `candidate: true` to watch a revectorization in progress. Follow
+ * `nextCursor` for the next page, or use `allDocuments` to walk them all.
  *
  * @example
- * const { documents } = await admin.dataSources.documents({ slug: 'policies' });
+ * const { documents, nextCursor } = await admin.dataSources.documents({ slug: 'policies' });
  */
 declare function documents(ctx: AdminContext, params: DocumentsParams): Promise<DataSourcesDocumentsResult>;
+/**
+ * Every document (or every one of `ids`), following pages to the end.
+ *
+ * With `ids`, requests are chunked to the server's per-request cap, so a wait
+ * over hundreds of just-added files stays a handful of small calls rather than
+ * a walk of the whole source.
+ *
+ * @example
+ * const docs = await admin.dataSources.allDocuments({ slug: 'policies' });
+ */
+declare function allDocuments(ctx: AdminContext, params: Omit<DocumentsParams, 'cursor' | 'limit'>): Promise<DataSourcesDocumentStatus[]>;
 /**
  * List all data sources with document counts, build progress, and active
  * version metadata.
@@ -1525,7 +1596,7 @@ declare function documents(ctx: AdminContext, params: DocumentsParams): Promise<
  * @example
  * const { dataSources } = await admin.dataSources.list();
  */
-declare function list$6(ctx: AdminContext): Promise<DataSourcesListResult>;
+declare function list$7(ctx: AdminContext): Promise<DataSourcesListResult>;
 interface SearchParams {
     /** Data source slug. */
     slug: string;
@@ -1588,6 +1659,15 @@ interface ConfigSetParams {
      * required.
      */
     retrieval?: DataSourcesRetrievalUpdate;
+    /**
+     * Where the corpus lives: a dedicated resource (see `admin.infra`) or the
+     * shared pool. Accepted only while the source has no built documents —
+     * moving a populated source is refused with
+     * `placement_change_requires_migration`.
+     */
+    placement?: {
+        resourceId: string;
+    } | 'shared';
 }
 /**
  * Update pipeline configuration.
@@ -1605,6 +1685,37 @@ interface ConfigSetParams {
  * });
  */
 declare function configSet(ctx: AdminContext, params: ConfigSetParams): Promise<DataSourcesConfigUpdateResult>;
+interface CreateParams {
+    /** Data source slug: lowercase [a-z0-9_-], up to 64 characters. */
+    slug: string;
+    /** Display name. */
+    name?: string;
+    /** Pinned ingest settings for the new pipeline; platform defaults otherwise. */
+    ingest?: DataSourcesIngestUpdate;
+    /**
+     * Where the corpus lives from the start: a dedicated resource (see
+     * `admin.infra`) or the shared pool (the default).
+     */
+    placement?: {
+        resourceId: string;
+    } | 'shared';
+}
+/**
+ * Create an empty data source, optionally on dedicated capacity.
+ *
+ * The one-step way to start a corpus on a resource. `add` also creates a
+ * source on first use, but on the shared pool, and a source with built
+ * documents cannot move, so a corpus meant for dedicated capacity starts here.
+ * Calling this for a source that already exists returns it; a placement given
+ * then follows `configSet`'s rule and moves it only while it is empty.
+ *
+ * @throws AdminApiError `invalid_data_source` (400), `data_source_limit` (422),
+ *   `resource_not_found` (404), `resource_destroyed` (422),
+ *   `placement_change_requires_migration` (422).
+ * @example
+ * await admin.dataSources.create({ slug: 'archive', placement: { resourceId } });
+ */
+declare function create$1(ctx: AdminContext, params: CreateParams): Promise<DataSourcesCreateResult>;
 interface RevectorizeParams {
     /** Data source slug. */
     slug: string;
@@ -1700,7 +1811,8 @@ declare function deleteSource(ctx: AdminContext, slug: string): Promise<DataSour
 type dataSources_AddDocumentParams = AddDocumentParams;
 type dataSources_AddDocumentResult = AddDocumentResult;
 type dataSources_ConfigSetParams = ConfigSetParams;
-declare const dataSources_DEFAULT_WAIT_TIMEOUT_MS: typeof DEFAULT_WAIT_TIMEOUT_MS;
+type dataSources_CreateParams = CreateParams;
+declare const dataSources_DOCUMENTS_IDS_MAX: typeof DOCUMENTS_IDS_MAX;
 type dataSources_DocumentsParams = DocumentsParams;
 type dataSources_DropParams = DropParams;
 type dataSources_PromoteParams = PromoteParams;
@@ -1711,6 +1823,7 @@ type dataSources_SummarizedDocument = SummarizedDocument;
 type dataSources_WaitForIngestParams = WaitForIngestParams;
 type dataSources_WaitForIngestResult = WaitForIngestResult;
 declare const dataSources_addDocument: typeof addDocument;
+declare const dataSources_allDocuments: typeof allDocuments;
 declare const dataSources_configGet: typeof configGet;
 declare const dataSources_configSet: typeof configSet;
 declare const dataSources_deleteSource: typeof deleteSource;
@@ -1723,7 +1836,7 @@ declare const dataSources_search: typeof search;
 declare const dataSources_summarize: typeof summarize;
 declare const dataSources_waitForIngest: typeof waitForIngest;
 declare namespace dataSources {
-  export { type dataSources_AddDocumentParams as AddDocumentParams, type dataSources_AddDocumentResult as AddDocumentResult, type dataSources_ConfigSetParams as ConfigSetParams, dataSources_DEFAULT_WAIT_TIMEOUT_MS as DEFAULT_WAIT_TIMEOUT_MS, type dataSources_DocumentsParams as DocumentsParams, type dataSources_DropParams as DropParams, type dataSources_PromoteParams as PromoteParams, type dataSources_RevectorizeParams as RevectorizeParams, type dataSources_RmParams as RmParams, type dataSources_SearchParams as SearchParams, type dataSources_SummarizedDocument as SummarizedDocument, type dataSources_WaitForIngestParams as WaitForIngestParams, type dataSources_WaitForIngestResult as WaitForIngestResult, dataSources_addDocument as addDocument, dataSources_configGet as configGet, dataSources_configSet as configSet, dataSources_deleteSource as deleteSource, dataSources_documents as documents, dataSources_drop as drop, list$6 as list, dataSources_promote as promote, dataSources_revectorize as revectorize, dataSources_rm as rm, dataSources_search as search, dataSources_summarize as summarize, dataSources_waitForIngest as waitForIngest };
+  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$1 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_PromoteParams as PromoteParams, type dataSources_RevectorizeParams as RevectorizeParams, type dataSources_RmParams as RmParams, type dataSources_SearchParams as SearchParams, type dataSources_SummarizedDocument as SummarizedDocument, type dataSources_WaitForIngestParams as WaitForIngestParams, type dataSources_WaitForIngestResult as WaitForIngestResult, 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$7 as list, dataSources_promote as promote, dataSources_revectorize as revectorize, dataSources_rm as rm, dataSources_search as search, dataSources_summarize as summarize, dataSources_waitForIngest as waitForIngest };
 }
 
 /**
@@ -2049,7 +2162,7 @@ interface DomainsCustomRetryResult {
  * @example
  * const { subdomain } = await admin.domains.get();
  */
-declare function get$4(ctx: AdminContext): Promise<DomainsGetResult>;
+declare function get$5(ctx: AdminContext): Promise<DomainsGetResult>;
 /**
  * Set the app's platform subdomain.
  *
@@ -2150,7 +2263,7 @@ declare const domains_customRemove: typeof customRemove;
 declare const domains_customRetry: typeof customRetry;
 declare const domains_findHostname: typeof findHostname;
 declare namespace domains {
-  export { domains_check as check, domains_customAdd as customAdd, domains_customCheck as customCheck, domains_customList as customList, domains_customRemove as customRemove, domains_customRetry as customRetry, domains_findHostname as findHostname, get$4 as get, set$1 as set };
+  export { domains_check as check, domains_customAdd as customAdd, domains_customCheck as customCheck, domains_customList as customList, domains_customRemove as customRemove, domains_customRetry as customRetry, domains_findHostname as findHostname, get$5 as get, set$1 as set };
 }
 
 /**
@@ -2907,6 +3020,237 @@ declare namespace files {
   export { type files_FileAccess as FileAccess, type files_FileRef as FileRef, type files_FilesLsParams as FilesLsParams, type files_FilesPutParams as FilesPutParams, files_fetchBytes as fetchBytes, files_ls as ls, files_put as put, files_remove as remove, files_sign as sign, files_stat as stat, files_summary as summary };
 }
 
+/**
+ * Response types for the provisioned-infrastructure management API.
+ *
+ * Transcribed from youai-api:
+ *   src/http/routes/V2Apps/manage/provisionedResources.ts
+ *   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`.
+ */
+type InfraHealth = 'ready' | 'not-ready' | 'missing' | 'restoring';
+/** 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". */
+    description: string;
+    hourlyPriceDollars: number;
+    /** Hourly × 730. */
+    monthlyPriceDollars: number;
+    /** Retained-storage rate while hibernated. */
+    hibernatedHourlyPriceDollars: number;
+    hibernatedMonthlyPriceDollars: number;
+    capacity: {
+        maxPoints: number;
+    };
+    capabilities: {
+        hibernate: boolean;
+    };
+    retired: boolean;
+}
+interface InfraResource {
+    id: string;
+    appId: string;
+    name: string;
+    kind: 'retrieval';
+    offeringId: string;
+    offering: InfraOffering | null;
+    phase: InfraPhase;
+    desiredState: InfraDesiredState;
+    /** Data sources placed on this resource. Destroy is refused while > 0. */
+    attachedSources: number;
+    lastError: string | null;
+    /** Null until the instance exists (requested, hibernated, destroyed). */
+    health: InfraHealth | null;
+    /**
+     * What the instance is doing right now, while a transition is under way
+     * ("Waiting for capacity", "Snapshotting ds_x (1/2)"); null when nothing is.
+     */
+    detail: string | null;
+    /** When the last verified snapshot was taken; null if never. */
+    lastSnapshotAt: string | null;
+    activatedAt: string | null;
+    hibernatedAt: string | null;
+    destroyedAt: string | null;
+    phaseChangedAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface InfraEvent {
+    id: string;
+    fromPhase: InfraPhase | null;
+    toPhase: InfraPhase;
+    /** `user:<id>` or `system`. */
+    actor: string;
+    reason: string | null;
+    createdAt: string;
+}
+/** GET /infra */
+interface InfraListResult {
+    resources: InfraResource[];
+    offerings: InfraOffering[];
+    /** False on hosts that cannot provision; `provision` will be refused. */
+    provisioningAvailable: boolean;
+}
+/** GET /infra/:id */
+interface InfraGetResult {
+    resource: InfraResource;
+    events: InfraEvent[];
+    attachedSources: {
+        id: string;
+        slug: string;
+        name: string | null;
+    }[];
+}
+/** POST /infra, /infra/:id/{hibernate,resume,destroy,rename} */
+interface InfraResourceResult {
+    resource: InfraResource;
+}
+
+/**
+ * Provisioned-infrastructure operations: lease, park, resume and delete
+ * dedicated resources (first kind: retrieval capacity for data sources).
+ *
+ * Ops are pure (ctx, params) → typed result. The CLI skin in
+ * commands/infra.ts owns flag parsing, progress printing and exit codes.
+ */
+
+/** @internal Consumed by the CLI skin; waitForPhase documents the default. */
+declare const DEFAULT_WAIT_TIMEOUT_MS: number;
+interface ListParams {
+    /** Include resources that have been deleted; off by default. */
+    includeDestroyed?: boolean;
+}
+/**
+ * The app's dedicated resources plus the offerings it can provision, with
+ * their hourly and monthly prices.
+ *
+ * @example
+ * const { resources, offerings } = await admin.infra.list();
+ */
+declare function list$6(ctx: AdminContext, params?: ListParams): Promise<InfraListResult>;
+interface GetParams {
+    /** Resource id. */
+    id: string;
+}
+/**
+ * One resource with its state timeline and the data sources placed on it.
+ *
+ * @throws AdminApiError `resource_not_found` (404).
+ */
+declare function get$4(ctx: AdminContext, params: GetParams): Promise<InfraGetResult>;
+interface ProvisionParams {
+    /** Offering id from `list().offerings`, e.g. `retrieval.small`. */
+    offeringId: string;
+    /** Display name; defaults to the offering label. */
+    name?: string;
+}
+/**
+ * Lease a new resource. Spends credits: the workspace must have a month's
+ * worth available before the request is accepted; nothing is charged until
+ * activation, and from then the resource bills by the hour.
+ *
+ * The response is the row in `requested`; the platform brings it to `active`
+ * within a minute or so. Use `waitForPhase` to block on that.
+ *
+ * @throws AdminApiError `offering_not_found` (400), `offering_retired` (422),
+ *   `provisioning_unavailable` (422), `insufficient_credits` (402).
+ * @example
+ * const { resource } = await admin.infra.provision({ offeringId: 'retrieval.small' });
+ */
+declare function provision(ctx: AdminContext, params: ProvisionParams): Promise<InfraResourceResult>;
+interface ResourceIdParams {
+    /** Resource id. */
+    id: string;
+}
+/**
+ * Park an active resource. Data is kept; searches on its data sources return
+ * `capacity_hibernating` while it parks and `capacity_hibernated` once parked,
+ * until it resumes; billing drops to the retained-storage rate.
+ *
+ * @throws AdminApiError `resource_not_found` (404), `invalid_transition` (422).
+ */
+declare function hibernate(ctx: AdminContext, params: ResourceIdParams): Promise<InfraResourceResult>;
+/**
+ * Bring a hibernated (or failed) resource back to active.
+ *
+ * @throws AdminApiError `resource_not_found` (404), `invalid_transition` (422).
+ */
+declare function resume(ctx: AdminContext, params: ResourceIdParams): Promise<InfraResourceResult>;
+/**
+ * Delete a resource. Refused while any data source is placed on it — move
+ * those to shared capacity (`datasources config --placement shared`) or
+ * delete them first. Billing stops when the phase reaches `destroyed`.
+ *
+ * @throws AdminApiError `resource_not_found` (404),
+ *   `resource_has_attachments` (422), `invalid_transition` (422).
+ */
+declare function destroy(ctx: AdminContext, params: ResourceIdParams): Promise<InfraResourceResult>;
+interface RenameParams {
+    id: string;
+    name: string;
+}
+/** @throws AdminApiError `resource_not_found` (404), `invalid_name` (400). */
+declare function rename(ctx: AdminContext, params: RenameParams): Promise<InfraResourceResult>;
+interface WaitForPhaseParams {
+    id: string;
+    /** The phase(s) that count as done. */
+    phases: InfraPhase[];
+    /** Default 10 minutes. */
+    timeoutMs?: number;
+    onProgress?: (message: string) => void;
+}
+type WaitForPhaseResult = {
+    status: 'done';
+    resource: InfraResource;
+} | {
+    status: 'failed';
+    resource: InfraResource;
+    error: string;
+} | {
+    status: 'timeout';
+    resource: InfraResource;
+    error: string;
+};
+/**
+ * Poll a resource until it reaches one of `phases`, fails, or the timeout
+ * elapses. A `failed` phase returns immediately with the platform's error.
+ *
+ * @example
+ * const result = await admin.infra.waitForPhase({ id, phases: ['active'] });
+ */
+declare function waitForPhase(ctx: AdminContext, params: WaitForPhaseParams): Promise<WaitForPhaseResult>;
+
+declare const infra_DEFAULT_WAIT_TIMEOUT_MS: typeof DEFAULT_WAIT_TIMEOUT_MS;
+type infra_GetParams = GetParams;
+type infra_ListParams = ListParams;
+type infra_ProvisionParams = ProvisionParams;
+type infra_RenameParams = RenameParams;
+type infra_ResourceIdParams = ResourceIdParams;
+type infra_WaitForPhaseParams = WaitForPhaseParams;
+type infra_WaitForPhaseResult = WaitForPhaseResult;
+declare const infra_destroy: typeof destroy;
+declare const infra_hibernate: typeof hibernate;
+declare const infra_provision: typeof provision;
+declare const infra_rename: typeof rename;
+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_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_resume as resume, infra_waitForPhase as waitForPhase };
+}
+
 /**
  * Result types for the `issues` CLI commands.
  *
@@ -3794,12 +4138,30 @@ interface V2BuildLogEntry {
 }
 /** Terminal and in-progress states a release moves through. */
 type V2ReleaseStatus = 'building' | 'compiled' | 'live' | 'preview' | 'dev' | 'failed' | 'superseded';
+/**
+ * Why a failed release failed — derived server-side from the build log
+ * (describeReleaseFailure() in youai-api) and present on every release
+ * shape. All three are null unless `status` is 'failed'.
+ *
+ * `failureKind` is the field to branch on:
+ *   'interrupted' — the build's orchestrator died (platform restart); the
+ *                   platform retries once automatically. Transient.
+ *   'unbuildable' — the commit couldn't be read as an app (mindstudio.json
+ *                   missing/invalid). Fix the commit; nothing to retry.
+ *   'build'       — the build itself failed (compile error, deploy step).
+ */
+interface ReleaseFailureFields {
+    failureReason: string | null;
+    /** Build stage that was running when it failed (`interfaces`, `promote`…). */
+    failurePhase: string | null;
+    failureKind: 'build' | 'interrupted' | 'unbuildable' | null;
+}
 /**
  * Lightweight release projection returned by the paginated list endpoint.
  * Heavy fields (buildLog, manifest, methods, interfaces) are dropped.
  * Produced by toReleaseFragment() in youai-api.
  */
-interface ReleaseFragment {
+interface ReleaseFragment extends ReleaseFailureFields {
     id: string;
     commitSha: string;
     commitInfo: V2CommitInfo;
@@ -3827,7 +4189,7 @@ interface ReleasesListResult {
  * Includes build log, databases, signed diff/diagnostics URLs, and the
  * post-deploy async progress signal.
  */
-interface ReleasesGetResult {
+interface ReleasesGetResult extends ReleaseFailureFields {
     id: string;
     appId: string;
     commitSha: string;
@@ -3873,7 +4235,7 @@ interface ReleasesGetResult {
  * Plain release row — no databases/diff enrichment — plus previewUrl.
  * Used by 'releases wait', which polls this endpoint in a loop.
  */
-interface ReleasesByCommitResult {
+interface ReleasesByCommitResult extends ReleaseFailureFields {
     id: string;
     appId: string;
     commitSha: string;
@@ -4262,8 +4624,16 @@ interface ReleaseSummary {
     buildDurationMs: number | null;
     publishedAt: string | null;
     previewUrl?: string;
-    /** Build failure reason from the last build-log `error` phase entry; only present when status is `failed`. */
+    /** Why it failed; only present when status is `failed`. */
     error?: string;
+    /**
+     * Only present when status is `failed`. 'interrupted' means a platform
+     * restart killed the build and a retry is already running — not a code
+     * problem. See ReleaseFailureFields.
+     */
+    failureKind?: 'build' | 'interrupted' | 'unbuildable';
+    /** Build stage that was running when it failed; only when `failed`. */
+    failurePhase?: string;
 }
 /**
  * Terminal outcome of a `waitForCommit` call.
@@ -5352,6 +5722,7 @@ declare function buildClient(ctx: AdminContext): {
         inbox: (params?: EmailInboxParams | undefined) => Promise<EmailInboxResult>;
     };
     files: BoundOps<typeof files>;
+    infra: BoundOps<typeof infra>;
     issues: BoundOps<typeof issues>;
     jewels: BoundOps<typeof jewels>;
     methods: BoundOps<typeof methods>;
@@ -5406,4 +5777,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 DataSourcesBuildProgress, type DataSourcesChunkingConfig, type DataSourcesConfigResult, type DataSourcesConfigUpdateResult, type DataSourcesDeleteResult, type DataSourcesDocument, type DataSourcesDocumentConfirmResult, type DataSourcesDocumentDeleteResult, type DataSourcesDocumentStatus, type DataSourcesDocumentsResult, type DataSourcesDropResult, type DataSourcesIngestConfig, type DataSourcesIngestUpdate, type DataSourcesListEntry, type DataSourcesListResult, type DataSourcesPromoteResult, type DataSourcesRetrievalConfig, type DataSourcesRetrievalUpdate, type DataSourcesRevectorizeResult, 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 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 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 DataSourcesBuildProgress, type DataSourcesChunkingConfig, type DataSourcesChunkingStrategy, type DataSourcesConfigResult, type DataSourcesConfigUpdateResult, type DataSourcesCreateResult, type DataSourcesDeleteResult, type DataSourcesDocument, type DataSourcesDocumentConfirmResult, type DataSourcesDocumentDeleteResult, type DataSourcesDocumentStatus, type DataSourcesDocumentsResult, type DataSourcesDropResult, type DataSourcesIngestConfig, type DataSourcesIngestUpdate, type DataSourcesListEntry, type DataSourcesListResult, type DataSourcesPlacement, type DataSourcesPromoteResult, type DataSourcesRetrievalConfig, type DataSourcesRetrievalUpdate, type DataSourcesRevectorizeResult, 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 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 };