import * as z from "zod/v4-mini"; import { Schemadefaul8Open } from "./schemadefaul8.js"; /** * Explicit native recovery configuration when launch metadata or definition contents are unavailable. File/name/inline definitions must be reconstructed explicitly; a stored path alone cannot prove their bytes. Not a deployment package compiler or package restore bypass. */ export type Launch = { arm?: Schemadefaul8Open | undefined; /** * Arguments for the Helix binary. Omitted starts it with none. */ args?: Array | undefined; }; /** * What to do when the transcript references files the receiving box does not have. A checkpoint moves the session file ONLY — the workspace does not travel — so a restore into a fresh box normally finds them missing. `warn` (default) restores and reports them in `workspaceDrift`. `refuse` fails with 409 BEFORE switching the session; use it when the box is meant to already hold the work. `skip` does not probe at all, and reports status `unchecked`. */ export declare enum OnWorkspaceDrift { Warn = "warn", Refuse = "refuse", Skip = "skip" } export type LaunchModelSnapshotId = { /** * Explicit native recovery configuration when launch metadata or definition contents are unavailable. File/name/inline definitions must be reconstructed explicitly; a stored path alone cannot prove their bytes. Not a deployment package compiler or package restore bypass. */ launch?: Launch | undefined; /** * Explicit recovery model. Omit to require the original captured model; unavailable configuration fails before replacement rather than selecting another default. */ model?: string | undefined; /** * Which checkpoint to restore. Defaults to the NEWEST one captured from this sandbox. Only consistency points are listed, so a default restore can never land on a mid-turn prefix. */ snapshotId?: string | undefined; /** * The sandbox definition to rebuild from, when the original was not a registered preset. The stored record keeps a definition NAME, not the image/arch/network it stood for, so a sandbox spawned from an ad-hoc definition must be handed one back. Omit for preset-spawned sandboxes. */ definition?: any | undefined; /** * Restore the INCREMENTAL transcript prefix when it is newer than the checkpoint row — the bytes a mid-turn kill would otherwise lose — together with the checkpoint's own workspace archive. Default false. ACCEPTED RISK: the prefix is cut at its last complete line and may end on a tool call whose result never landed; the harness answers such a call with a synthetic error result on the next turn, so the agent sees a failed call and may redo it — any side effect the original call had is not undone. Falls back to the checkpoint row, with the reason in `notRestored`, when no prefix exists, when it is not beyond the row, or when it does not extend the row's bytes (a compaction rewrote the file). `partial` on the response says which happened. */ partial?: boolean | undefined; /** * What to do when the transcript references files the receiving box does not have. A checkpoint moves the session file ONLY — the workspace does not travel — so a restore into a fresh box normally finds them missing. `warn` (default) restores and reports them in `workspaceDrift`. `refuse` fails with 409 BEFORE switching the session; use it when the box is meant to already hold the work. `skip` does not probe at all, and reports status `unchecked`. */ onWorkspaceDrift?: OnWorkspaceDrift | undefined; /** * Per-call environment for the RESTORED session, layered exactly as on session start: over `environment`, under the platform-owned variables. NEVER stored — not in the checkpoint, not in its manifest — so a restore that omits it does not bring back what the original session was given this way. A model key sent as `env` at session start must be sent again here. */ env?: { [k: string]: string; } | undefined; /** * A workspace Environment to load into the restored session. Omitted, the Environment the checkpointed session was started with — recorded by NAME, never values, in the checkpoint manifest — is re-resolved; a name given here wins. 404 before anything is torn down when the workspace has none by this name. A recorded name that no longer exists is skipped and named in `notRestored`. */ environment?: string | undefined; }; /** @internal */ export type Launch$Outbound = { arm: string; args?: Array | undefined; }; /** @internal */ export declare const Launch$outboundSchema: z.ZodMiniType; export declare function launchToJSON(launch: Launch): string; /** @internal */ export declare const OnWorkspaceDrift$outboundSchema: z.ZodMiniEnum; /** @internal */ export type LaunchModelSnapshotId$Outbound = { launch?: Launch$Outbound | undefined; model?: string | undefined; snapshotId?: string | undefined; definition?: any | undefined; partial?: boolean | undefined; onWorkspaceDrift: string; env?: { [k: string]: string; } | undefined; environment?: string | undefined; }; /** @internal */ export declare const LaunchModelSnapshotId$outboundSchema: z.ZodMiniType; export declare function launchModelSnapshotIdToJSON(launchModelSnapshotId: LaunchModelSnapshotId): string; //# sourceMappingURL=launch-model-snapshot-id.d.ts.map