import * as z from "zod/v4-mini"; /** * Headless I/O transport. Defaults to rpc; with `agent`, to the package's harness.runtime.mode (oneshot when a task is given). Oneshot processes supplied work and exits; it does not limit model turns. */ export declare enum Mode { Rpc = "rpc", Oneshot = "oneshot" } /** * Native launcher arm. Defaults to classic (full ADLC). Agent Prime uses arm agent and --prime in args. */ export declare enum ModeArmModelArm { Classic = "classic", Prime = "prime", Agent = "agent" } /** * Per-session override of what continuous capture carries. */ export type ModeArmModelCapture = { /** * Archive this session's working directory at every consistency point. Overrides the definition's `capture.workspace` for this session only; `false` records the leg as disabled in every checkpoint manifest the session produces, so a restore says "disabled" rather than "did not travel". */ workspace?: boolean | undefined; }; /** * The newest validated revision, active or not. */ export declare enum RevisionEnum { Latest = "latest" } /** * Pin this revision number. */ export type RevisionUnion1 = string | number; /** * Omitted runs the slot's active revision. */ export type RevisionUnion2 = string | number | RevisionEnum; /** * Run a managed agent. `environment` selects its slot (agent × Environment; omitted is the default slot) and loads that Environment into the box as on every launch. The package's prompt, tools, skills and model are used, so `arm` other than `agent`, `model`, `cwd`, and any `args` other than `-p ` are refused (422). `mode` omitted: `oneshot` (headless) when a task is given, otherwise the package's harness.runtime.mode (interactive = rpc, headless = oneshot). Refused before a box is allocated: an unknown agent or slot (404), an archived agent (409 `MANAGED_AGENT_ARCHIVED`), a retired slot (409 `MANAGED_AGENT_SLOT_RETIRED`), no active revision or no such validated revision (422), a model outside the workspace list (422), an Environment that no longer exists (404), a headless run without a task (422), a sandbox provider that cannot stage a package (422). */ export type ModeArmModelAgent = { /** * A managed agent in this workspace, by slug (`mutagent agent deploy`). */ slug: string; /** * Omitted runs the slot's active revision. */ revision?: string | number | RevisionEnum | undefined; }; export type ModeArmModel = { /** * Headless I/O transport. Defaults to rpc; with `agent`, to the package's harness.runtime.mode (oneshot when a task is given). Oneshot processes supplied work and exits; it does not limit model turns. */ mode?: Mode | undefined; /** * Native launcher arm. Defaults to classic (full ADLC). Agent Prime uses arm agent and --prime in args. */ arm?: ModeArmModelArm | undefined; /** * The `provider/model` to run, from the workspace's Helix Cloud model list (GET /api/sandbox/helix/defaults, or `mutagent helix models`). Omitted: the workspace default; none configured: 428. A value outside the list is a 422 that names the list. Equivalent to `--model` in `args`; if both are given they must name the same model, or the request is a 422. A `--model` in `args` with no value is a 422 too, and so is more than one `--model` there, or any `--provider` or `--models`: the harness runs the last `--model`, and those flags change which model it resolves. */ model?: string | undefined; /** * Arguments for the Helix binary. Omitted starts it with none. */ args?: Array | undefined; /** * Per-call environment, merged OVER the sandbox's own scoped material and OVER `environment`. Rides the invocation payload, so it does not mint a new Runtime. */ env?: { [k: string]: string; } | undefined; /** * A workspace Environment (GET /api/sandbox/environments) to load into this session, resolved server-side and layered UNDER `env`. 404 when the workspace has none by that name. */ environment?: string | undefined; /** * Working directory for the agent. Omitted, an `rpc` session runs in `$HOME` (writable by construction); `oneshot` inherits the server cwd exactly as it always has. */ cwd?: string | undefined; /** * Per-session override of what continuous capture carries. */ capture?: ModeArmModelCapture | undefined; /** * Configured Helix preset. Omitted uses the deployment default, including its execution destination. */ preset?: string | undefined; /** * Cloud placement: run this launch on the named sandbox provider. The name must be one this server has configured, and the resolved Helix preset must run on it — anything else is refused before a box is allocated. Omitted uses the platform-configured placement, unchanged. */ sandboxProvider?: string | undefined; /** * Run a managed agent. `environment` selects its slot (agent × Environment; omitted is the default slot) and loads that Environment into the box as on every launch. The package's prompt, tools, skills and model are used, so `arm` other than `agent`, `model`, `cwd`, and any `args` other than `-p ` are refused (422). `mode` omitted: `oneshot` (headless) when a task is given, otherwise the package's harness.runtime.mode (interactive = rpc, headless = oneshot). Refused before a box is allocated: an unknown agent or slot (404), an archived agent (409 `MANAGED_AGENT_ARCHIVED`), a retired slot (409 `MANAGED_AGENT_SLOT_RETIRED`), no active revision or no such validated revision (422), a model outside the workspace list (422), an Environment that no longer exists (404), a headless run without a task (422), a sandbox provider that cannot stage a package (422). */ agent?: ModeArmModelAgent | undefined; }; /** @internal */ export declare const Mode$outboundSchema: z.ZodMiniEnum; /** @internal */ export declare const ModeArmModelArm$outboundSchema: z.ZodMiniEnum; /** @internal */ export type ModeArmModelCapture$Outbound = { workspace?: boolean | undefined; }; /** @internal */ export declare const ModeArmModelCapture$outboundSchema: z.ZodMiniType; export declare function modeArmModelCaptureToJSON(modeArmModelCapture: ModeArmModelCapture): string; /** @internal */ export declare const RevisionEnum$outboundSchema: z.ZodMiniEnum; /** @internal */ export type RevisionUnion1$Outbound = string | number; /** @internal */ export declare const RevisionUnion1$outboundSchema: z.ZodMiniType; export declare function revisionUnion1ToJSON(revisionUnion1: RevisionUnion1): string; /** @internal */ export type RevisionUnion2$Outbound = string | number | string; /** @internal */ export declare const RevisionUnion2$outboundSchema: z.ZodMiniType; export declare function revisionUnion2ToJSON(revisionUnion2: RevisionUnion2): string; /** @internal */ export type ModeArmModelAgent$Outbound = { slug: string; revision?: string | number | string | undefined; }; /** @internal */ export declare const ModeArmModelAgent$outboundSchema: z.ZodMiniType; export declare function modeArmModelAgentToJSON(modeArmModelAgent: ModeArmModelAgent): string; /** @internal */ export type ModeArmModel$Outbound = { mode?: string | undefined; arm?: string | undefined; model?: string | undefined; args?: Array | undefined; env?: { [k: string]: string; } | undefined; environment?: string | undefined; cwd?: string | undefined; capture?: ModeArmModelCapture$Outbound | undefined; preset?: string | undefined; sandboxProvider?: string | undefined; agent?: ModeArmModelAgent$Outbound | undefined; }; /** @internal */ export declare const ModeArmModel$outboundSchema: z.ZodMiniType; export declare function modeArmModelToJSON(modeArmModel: ModeArmModel): string; //# sourceMappingURL=mode-arm-model.d.ts.map