@mutagent/sdk 0.3.33 → 0.3.35

package/dist/esm/models/operations/post-api-sandbox.d.ts

@@ -0,0 +1,254 @@
+import * as z from "zod/v4-mini";
+import { OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+/**
+ * CPU architecture the image was built for. Validated against the provider at preflight.
+ */
+export declare enum PostApiSandboxArchRequest {
+    X8664 = "x86_64",
+    Arm64 = "arm64"
+}
+/**
+ * Requested resources. A provider that does not expose a given dial REJECTS a definition that sets it, at preflight — never a silent downgrade.
+ */
+export type PostApiSandboxResources = {
+    /**
+     * Requested vCPU count
+     */
+    vcpu?: number | undefined;
+    /**
+     * Requested memory in MB
+     */
+    memoryMb?: number | undefined;
+    /**
+     * Requested disk in MB
+     */
+    diskMb?: number | undefined;
+    /**
+     * Whether a GPU is required
+     */
+    gpu?: boolean | undefined;
+};
+/**
+ * Outbound policy. Defaults to deny — opening egress is explicit.
+ */
+export declare enum PostApiSandboxEgress {
+    Deny = "deny",
+    Allowlist = "allowlist",
+    Allow = "allow"
+}
+/**
+ * What this rule constrains
+ */
+export declare enum PostApiSandboxKind {
+    Port = "port",
+    Cidr = "cidr",
+    Domain = "domain"
+}
+/**
+ * A single outbound-access allowance
+ */
+export type PostApiSandboxAllow = {
+    /**
+     * What this rule constrains
+     */
+    kind?: PostApiSandboxKind | undefined;
+    /**
+     * Port, CIDR block, or domain
+     */
+    value: string;
+};
+/**
+ * Network policy for the sandbox
+ */
+export type PostApiSandboxNetwork = {
+    /**
+     * Outbound policy. Defaults to deny — opening egress is explicit.
+     */
+    egress?: PostApiSandboxEgress | undefined;
+    /**
+     * Allowances, when egress is "allowlist". Requires provider egressControl support.
+     */
+    allow?: Array<PostApiSandboxAllow> | undefined;
+};
+/**
+ * Non-secret environment variables. Secret material must come from an Environment.
+ */
+export type PostApiSandboxVars = {};
+/**
+ * Sandbox configuration. Separate artifact from the image content (R-C20).
+ */
+export type PostApiSandboxDefinition = {
+    /**
+     * Human-readable definition name
+     */
+    name: string;
+    /**
+     * Image reference (repository:tag or @digest). The image content is a separate artifact.
+     */
+    image: string;
+    /**
+     * CPU architecture the image was built for. Validated against the provider at preflight.
+     */
+    arch?: PostApiSandboxArchRequest | undefined;
+    /**
+     * Requested resources. A provider that does not expose a given dial REJECTS a definition that sets it, at preflight — never a silent downgrade.
+     */
+    resources?: PostApiSandboxResources | undefined;
+    /**
+     * Network policy for the sandbox
+     */
+    network?: PostApiSandboxNetwork | undefined;
+    /**
+     * Name of the Environment (secrets + variables) to load at spawn. Distinct from `provider`.
+     */
+    environment?: string | undefined;
+    /**
+     * Provider registry key. When omitted the backend default applies.
+     */
+    provider?: string | undefined;
+    /**
+     * Requested max lifetime. Rejected at preflight if it exceeds the provider ceiling.
+     */
+    timeoutMs?: number | undefined;
+    /**
+     * Working directory inside the sandbox
+     */
+    workdir?: string | undefined;
+    /**
+     * Non-secret environment variables. Secret material must come from an Environment.
+     */
+    vars?: PostApiSandboxVars | undefined;
+};
+/**
+ * Spawn a sandbox from a definition
+ */
+export type PostApiSandboxRequest = {
+    /**
+     * Sandbox configuration. Separate artifact from the image content (R-C20).
+     */
+    definition: PostApiSandboxDefinition;
+    /**
+     * Correlation id for trace attribution
+     */
+    runId?: string | undefined;
+};
+/**
+ * CPU architecture the image was built for. Validated against the provider at preflight.
+ */
+export declare enum PostApiSandboxArchResponse {
+    X8664 = "x86_64",
+    Arm64 = "arm64"
+}
+/**
+ * CPU architecture the image was built for. Validated against the provider at preflight.
+ */
+export type PostApiSandboxArchResponseOpen = OpenEnum<typeof PostApiSandboxArchResponse>;
+export declare enum PostApiSandboxStatus {
+    Pending = "pending",
+    Starting = "starting",
+    Running = "running",
+    Paused = "paused",
+    Stopping = "stopping",
+    Stopped = "stopped",
+    Failed = "failed"
+}
+export type PostApiSandboxStatusOpen = OpenEnum<typeof PostApiSandboxStatus>;
+/**
+ * A sandbox as recorded by the service — one record whether spawned from CLI or platform
+ */
+export type PostApiSandboxResponse = {
+    /**
+     * Sandbox identifier
+     */
+    id: string;
+    /**
+     * Bumps when the underlying instance is replaced
+     */
+    generation: number;
+    /**
+     * Provider that owns this sandbox
+     */
+    provider: string;
+    /**
+     * CPU architecture the image was built for. Validated against the provider at preflight.
+     */
+    arch: PostApiSandboxArchResponseOpen;
+    status: PostApiSandboxStatusOpen;
+    definitionName: string;
+    environmentName?: string | undefined;
+    /**
+     * ISO timestamp
+     */
+    createdAt: string;
+};
+/** @internal */
+export declare const PostApiSandboxArchRequest$outboundSchema: z.ZodMiniEnum<typeof PostApiSandboxArchRequest>;
+/** @internal */
+export type PostApiSandboxResources$Outbound = {
+    vcpu?: number | undefined;
+    memoryMb?: number | undefined;
+    diskMb?: number | undefined;
+    gpu?: boolean | undefined;
+};
+/** @internal */
+export declare const PostApiSandboxResources$outboundSchema: z.ZodMiniType<PostApiSandboxResources$Outbound, PostApiSandboxResources>;
+export declare function postApiSandboxResourcesToJSON(postApiSandboxResources: PostApiSandboxResources): string;
+/** @internal */
+export declare const PostApiSandboxEgress$outboundSchema: z.ZodMiniEnum<typeof PostApiSandboxEgress>;
+/** @internal */
+export declare const PostApiSandboxKind$outboundSchema: z.ZodMiniEnum<typeof PostApiSandboxKind>;
+/** @internal */
+export type PostApiSandboxAllow$Outbound = {
+    kind: string;
+    value: string;
+};
+/** @internal */
+export declare const PostApiSandboxAllow$outboundSchema: z.ZodMiniType<PostApiSandboxAllow$Outbound, PostApiSandboxAllow>;
+export declare function postApiSandboxAllowToJSON(postApiSandboxAllow: PostApiSandboxAllow): string;
+/** @internal */
+export type PostApiSandboxNetwork$Outbound = {
+    egress: string;
+    allow?: Array<PostApiSandboxAllow$Outbound> | undefined;
+};
+/** @internal */
+export declare const PostApiSandboxNetwork$outboundSchema: z.ZodMiniType<PostApiSandboxNetwork$Outbound, PostApiSandboxNetwork>;
+export declare function postApiSandboxNetworkToJSON(postApiSandboxNetwork: PostApiSandboxNetwork): string;
+/** @internal */
+export type PostApiSandboxVars$Outbound = {};
+/** @internal */
+export declare const PostApiSandboxVars$outboundSchema: z.ZodMiniType<PostApiSandboxVars$Outbound, PostApiSandboxVars>;
+export declare function postApiSandboxVarsToJSON(postApiSandboxVars: PostApiSandboxVars): string;
+/** @internal */
+export type PostApiSandboxDefinition$Outbound = {
+    name: string;
+    image: string;
+    arch: string;
+    resources?: PostApiSandboxResources$Outbound | undefined;
+    network?: PostApiSandboxNetwork$Outbound | undefined;
+    environment?: string | undefined;
+    provider?: string | undefined;
+    timeoutMs?: number | undefined;
+    workdir?: string | undefined;
+    vars?: PostApiSandboxVars$Outbound | undefined;
+};
+/** @internal */
+export declare const PostApiSandboxDefinition$outboundSchema: z.ZodMiniType<PostApiSandboxDefinition$Outbound, PostApiSandboxDefinition>;
+export declare function postApiSandboxDefinitionToJSON(postApiSandboxDefinition: PostApiSandboxDefinition): string;
+/** @internal */
+export type PostApiSandboxRequest$Outbound = {
+    definition: PostApiSandboxDefinition$Outbound;
+    runId?: string | undefined;
+};
+/** @internal */
+export declare const PostApiSandboxRequest$outboundSchema: z.ZodMiniType<PostApiSandboxRequest$Outbound, PostApiSandboxRequest>;
+export declare function postApiSandboxRequestToJSON(postApiSandboxRequest: PostApiSandboxRequest): string;
+/** @internal */
+export declare const PostApiSandboxArchResponse$inboundSchema: z.ZodMiniType<PostApiSandboxArchResponseOpen, unknown>;
+/** @internal */
+export declare const PostApiSandboxStatus$inboundSchema: z.ZodMiniType<PostApiSandboxStatusOpen, unknown>;
+/** @internal */
+export declare const PostApiSandboxResponse$inboundSchema: z.ZodMiniType<PostApiSandboxResponse, unknown>;
+export declare function postApiSandboxResponseFromJSON(jsonString: string): SafeParseResult<PostApiSandboxResponse, SDKValidationError>;
+//# sourceMappingURL=post-api-sandbox.d.ts.map

package/dist/esm/models/operations/post-api-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-api-sandbox.d.ts","sourceRoot":"","sources":["../../../../src/models/operations/post-api-sandbox.ts"],"names":[],"mappings":"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"}

package/dist/esm/models/operations/post-api-sandbox.js

@@ -0,0 +1,131 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+import * as types from "../../types/primitives.js";
+/**
+ * CPU architecture the image was built for. Validated against the provider at preflight.
+ */
+export var PostApiSandboxArchRequest;
+(function (PostApiSandboxArchRequest) {
+    PostApiSandboxArchRequest["X8664"] = "x86_64";
+    PostApiSandboxArchRequest["Arm64"] = "arm64";
+})(PostApiSandboxArchRequest || (PostApiSandboxArchRequest = {}));
+/**
+ * Outbound policy. Defaults to deny — opening egress is explicit.
+ */
+export var PostApiSandboxEgress;
+(function (PostApiSandboxEgress) {
+    PostApiSandboxEgress["Deny"] = "deny";
+    PostApiSandboxEgress["Allowlist"] = "allowlist";
+    PostApiSandboxEgress["Allow"] = "allow";
+})(PostApiSandboxEgress || (PostApiSandboxEgress = {}));
+/**
+ * What this rule constrains
+ */
+export var PostApiSandboxKind;
+(function (PostApiSandboxKind) {
+    PostApiSandboxKind["Port"] = "port";
+    PostApiSandboxKind["Cidr"] = "cidr";
+    PostApiSandboxKind["Domain"] = "domain";
+})(PostApiSandboxKind || (PostApiSandboxKind = {}));
+/**
+ * CPU architecture the image was built for. Validated against the provider at preflight.
+ */
+export var PostApiSandboxArchResponse;
+(function (PostApiSandboxArchResponse) {
+    PostApiSandboxArchResponse["X8664"] = "x86_64";
+    PostApiSandboxArchResponse["Arm64"] = "arm64";
+})(PostApiSandboxArchResponse || (PostApiSandboxArchResponse = {}));
+export var PostApiSandboxStatus;
+(function (PostApiSandboxStatus) {
+    PostApiSandboxStatus["Pending"] = "pending";
+    PostApiSandboxStatus["Starting"] = "starting";
+    PostApiSandboxStatus["Running"] = "running";
+    PostApiSandboxStatus["Paused"] = "paused";
+    PostApiSandboxStatus["Stopping"] = "stopping";
+    PostApiSandboxStatus["Stopped"] = "stopped";
+    PostApiSandboxStatus["Failed"] = "failed";
+})(PostApiSandboxStatus || (PostApiSandboxStatus = {}));
+/** @internal */
+export const PostApiSandboxArchRequest$outboundSchema = z.enum(PostApiSandboxArchRequest);
+/** @internal */
+export const PostApiSandboxResources$outboundSchema = z.object({
+    vcpu: z.optional(z.number()),
+    memoryMb: z.optional(z.number()),
+    diskMb: z.optional(z.number()),
+    gpu: z.optional(z.boolean()),
+});
+export function postApiSandboxResourcesToJSON(postApiSandboxResources) {
+    return JSON.stringify(PostApiSandboxResources$outboundSchema.parse(postApiSandboxResources));
+}
+/** @internal */
+export const PostApiSandboxEgress$outboundSchema = z.enum(PostApiSandboxEgress);
+/** @internal */
+export const PostApiSandboxKind$outboundSchema = z.enum(PostApiSandboxKind);
+/** @internal */
+export const PostApiSandboxAllow$outboundSchema = z.object({
+    kind: z._default(PostApiSandboxKind$outboundSchema, PostApiSandboxKind.Port),
+    value: z.string(),
+});
+export function postApiSandboxAllowToJSON(postApiSandboxAllow) {
+    return JSON.stringify(PostApiSandboxAllow$outboundSchema.parse(postApiSandboxAllow));
+}
+/** @internal */
+export const PostApiSandboxNetwork$outboundSchema = z.object({
+    egress: z._default(PostApiSandboxEgress$outboundSchema, PostApiSandboxEgress.Deny),
+    allow: z.optional(z.array(z.lazy(() => PostApiSandboxAllow$outboundSchema))),
+});
+export function postApiSandboxNetworkToJSON(postApiSandboxNetwork) {
+    return JSON.stringify(PostApiSandboxNetwork$outboundSchema.parse(postApiSandboxNetwork));
+}
+/** @internal */
+export const PostApiSandboxVars$outboundSchema = z.object({});
+export function postApiSandboxVarsToJSON(postApiSandboxVars) {
+    return JSON.stringify(PostApiSandboxVars$outboundSchema.parse(postApiSandboxVars));
+}
+/** @internal */
+export const PostApiSandboxDefinition$outboundSchema = z.object({
+    name: z.string(),
+    image: z.string(),
+    arch: z._default(PostApiSandboxArchRequest$outboundSchema, PostApiSandboxArchRequest.X8664),
+    resources: z.optional(z.lazy(() => PostApiSandboxResources$outboundSchema)),
+    network: z.optional(z.lazy(() => PostApiSandboxNetwork$outboundSchema)),
+    environment: z.optional(z.string()),
+    provider: z.optional(z.string()),
+    timeoutMs: z.optional(z.number()),
+    workdir: z.optional(z.string()),
+    vars: z.optional(z.lazy(() => PostApiSandboxVars$outboundSchema)),
+});
+export function postApiSandboxDefinitionToJSON(postApiSandboxDefinition) {
+    return JSON.stringify(PostApiSandboxDefinition$outboundSchema.parse(postApiSandboxDefinition));
+}
+/** @internal */
+export const PostApiSandboxRequest$outboundSchema = z.object({
+    definition: z.lazy(() => PostApiSandboxDefinition$outboundSchema),
+    runId: z.optional(z.string()),
+});
+export function postApiSandboxRequestToJSON(postApiSandboxRequest) {
+    return JSON.stringify(PostApiSandboxRequest$outboundSchema.parse(postApiSandboxRequest));
+}
+/** @internal */
+export const PostApiSandboxArchResponse$inboundSchema = openEnums.inboundSchema(PostApiSandboxArchResponse);
+/** @internal */
+export const PostApiSandboxStatus$inboundSchema = openEnums.inboundSchema(PostApiSandboxStatus);
+/** @internal */
+export const PostApiSandboxResponse$inboundSchema = z.object({
+    id: types.string(),
+    generation: types.number(),
+    provider: types.string(),
+    arch: z._default(PostApiSandboxArchResponse$inboundSchema, PostApiSandboxArchResponse.X8664),
+    status: z._default(PostApiSandboxStatus$inboundSchema, PostApiSandboxStatus.Pending),
+    definitionName: types.string(),
+    environmentName: types.optional(types.string()),
+    createdAt: types.string(),
+});
+export function postApiSandboxResponseFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => PostApiSandboxResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'PostApiSandboxResponse' from JSON`);
+}
+//# sourceMappingURL=post-api-sandbox.js.map

package/dist/esm/models/operations/post-api-sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-api-sandbox.js","sourceRoot":"","sources":["../../../../src/models/operations/post-api-sandbox.ts"],"names":[],"mappings":"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"}

package/dist/esm/sdk/sandbox.d.ts

@@ -0,0 +1,97 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+export declare class Sandbox extends ClientSDK {
+    /**
+     * Spawn a sandbox
+     *
+     * @remarks
+     * Requires an operator token. A session or task token is rejected with 403.
+     */
+    postApiSandbox(request: operations.PostApiSandboxRequest, options?: RequestOptions): Promise<operations.PostApiSandboxResponse>;
+    /**
+     * List sandboxes
+     *
+     * @remarks
+     * Always tenant-scoped. There is no unscoped listing path.
+     */
+    getApiSandbox(options?: RequestOptions): Promise<Array<operations.GetApiSandboxResponse>>;
+    /**
+     * Run one command in a fresh sandbox
+     *
+     * @remarks
+     * Spawns from a preset, runs the command, tears the sandbox down. Requires an operator token — a one-shot run creates a sandbox. 200, not 201: the durable outcome is a result, and the sandbox it names is already gone unless `keep` was set. Blocking, and therefore bounded by the provider invocation timeout — long or interactive runs belong on POST /api/sandbox + /:id/exec.
+     */
+    postApiSandboxRun(request: operations.PostApiSandboxRunRequest, options?: RequestOptions): Promise<operations.PostApiSandboxRunResponse>;
+    /**
+     * Run one agent turn in a fresh sandbox
+     *
+     * @remarks
+     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+     */
+    postApiSandboxAgentRun(request: operations.PostApiSandboxAgentRunRequest, options?: RequestOptions): Promise<operations.PostApiSandboxAgentRunResponse>;
+    /**
+     * List sandbox presets
+     *
+     * @remarks
+     * Named definitions a one-shot run can name. A preset is what lets a caller run something without knowing our registry, region or image tag. Image references are deliberately not returned.
+     */
+    getApiSandboxPresets(options?: RequestOptions): Promise<operations.GetApiSandboxPresetsResponse>;
+    /**
+     * List sandbox providers
+     *
+     * @remarks
+     * Providers this backend can reach and which is the default. A CLI that has no provider configured uses the default.
+     */
+    getApiSandboxProviders(options?: RequestOptions): Promise<operations.GetApiSandboxProvidersResponse>;
+    /**
+     * Preflight a sandbox definition
+     *
+     * @remarks
+     * Validate a definition against a provider without creating anything. Returns every violation, not just the first.
+     */
+    postApiSandboxPreflight(request: operations.PostApiSandboxPreflightRequest, options?: RequestOptions): Promise<operations.PostApiSandboxPreflightResponse>;
+    /**
+     * Exchange a platform API key for a sandbox operator token
+     *
+     * @remarks
+     * Trades a platform API key (`x-api-key: mg_live_…`) for a short-lived operator token scoped to one workspace. The caller must be able to create resources in that workspace.
+     */
+    postApiSandboxToken(request: operations.PostApiSandboxTokenRequest, options?: RequestOptions): Promise<operations.PostApiSandboxTokenResponse>;
+    /**
+     * Ingest OTLP spans from inside a sandbox
+     *
+     * @remarks
+     * OTLP/HTTP JSON. Requires a task token; spans are attributed to the sandbox the token is bound to, never to the sandbox named in the payload.
+     */
+    postApiSandboxTelemetryV1Traces(options?: RequestOptions): Promise<operations.PostApiSandboxTelemetryV1TracesResponse>;
+    /**
+     * Get sandbox status
+     */
+    getApiSandboxById(request: operations.GetApiSandboxByIdRequest, options?: RequestOptions): Promise<operations.GetApiSandboxByIdResponse>;
+    /**
+     * Tear down a sandbox
+     *
+     * @remarks
+     * Idempotent. The record is forgotten even if the provider teardown fails.
+     */
+    deleteApiSandboxById(request: operations.DeleteApiSandboxByIdRequest, options?: RequestOptions): Promise<operations.DeleteApiSandboxByIdResponse>;
+    /**
+     * Run a command in a sandbox
+     *
+     * @remarks
+     * Returns the command's real exit code. A task token is rejected — in-sandbox code reports on itself, it does not drive the box. With `?stream=1` the same result comes back as the event stream of `GET /:id/stream`, scoped to this one invocation and terminated by a `status` event carrying the exit code.
+     */
+    postApiSandboxByIdExec(request: operations.PostApiSandboxByIdExecRequest, options?: RequestOptions): Promise<operations.PostApiSandboxByIdExecResponse>;
+    /**
+     * Watch a sandbox's output live
+     *
+     * @remarks
+     * Server-sent events: `stdout`, `stderr`, `status`, `ping` (every 15s), `error`. `seq` is monotonic per sandbox and starts at 1; pass the last one seen as `?since=` to resume. If the buffer has already rolled past `since`, an `error` event names the lost range rather than skipping it silently. Disconnecting tears down the upstream.
+     */
+    getApiSandboxByIdStream(request: operations.GetApiSandboxByIdStreamRequest, options?: RequestOptions): Promise<void>;
+    /**
+     * Read a sandbox's captured spans
+     */
+    getApiSandboxByIdTraces(request: operations.GetApiSandboxByIdTracesRequest, options?: RequestOptions): Promise<operations.GetApiSandboxByIdTracesResponse>;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/esm/sdk/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/sdk/sandbox.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAG5D,qBAAa,OAAQ,SAAQ,SAAS;IACpC;;;;;OAKG;IACG,cAAc,CAClB,OAAO,EAAE,UAAU,CAAC,qBAAqB,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC;IAQ7C;;;;;OAKG;IACG,aAAa,CACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAOnD;;;;;OAKG;IACG,iBAAiB,CACrB,OAAO,EAAE,UAAU,CAAC,wBAAwB,EAC5C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,yBAAyB,CAAC;IAQhD;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,UAAU,CAAC,6BAA6B,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC;IAQrD;;;;;OAKG;IACG,oBAAoB,CACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,4BAA4B,CAAC;IAOnD;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC;IAOrD;;;;;OAKG;IACG,uBAAuB,CAC3B,OAAO,EAAE,UAAU,CAAC,8BAA8B,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,+BAA+B,CAAC;IAQtD;;;;;OAKG;IACG,mBAAmB,CACvB,OAAO,EAAE,UAAU,CAAC,0BAA0B,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,2BAA2B,CAAC;IAQlD;;;;;OAKG;IACG,+BAA+B,CACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,uCAAuC,CAAC;IAO9D;;OAEG;IACG,iBAAiB,CACrB,OAAO,EAAE,UAAU,CAAC,wBAAwB,EAC5C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,yBAAyB,CAAC;IAQhD;;;;;OAKG;IACG,oBAAoB,CACxB,OAAO,EAAE,UAAU,CAAC,2BAA2B,EAC/C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,4BAA4B,CAAC;IAQnD;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,UAAU,CAAC,6BAA6B,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC;IAQrD;;;;;OAKG;IACG,uBAAuB,CAC3B,OAAO,EAAE,UAAU,CAAC,8BAA8B,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,uBAAuB,CAC3B,OAAO,EAAE,UAAU,CAAC,8BAA8B,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,+BAA+B,CAAC;CAOvD"}

package/dist/esm/sdk/sandbox.js

@@ -0,0 +1,142 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { sandboxDeleteApiSandboxById } from "../funcs/sandbox-delete-api-sandbox-by-id.js";
+import { sandboxGetApiSandboxByIdStream } from "../funcs/sandbox-get-api-sandbox-by-id-stream.js";
+import { sandboxGetApiSandboxByIdTraces } from "../funcs/sandbox-get-api-sandbox-by-id-traces.js";
+import { sandboxGetApiSandboxById } from "../funcs/sandbox-get-api-sandbox-by-id.js";
+import { sandboxGetApiSandboxPresets } from "../funcs/sandbox-get-api-sandbox-presets.js";
+import { sandboxGetApiSandboxProviders } from "../funcs/sandbox-get-api-sandbox-providers.js";
+import { sandboxGetApiSandbox } from "../funcs/sandbox-get-api-sandbox.js";
+import { sandboxPostApiSandboxAgentRun } from "../funcs/sandbox-post-api-sandbox-agent-run.js";
+import { sandboxPostApiSandboxByIdExec } from "../funcs/sandbox-post-api-sandbox-by-id-exec.js";
+import { sandboxPostApiSandboxPreflight } from "../funcs/sandbox-post-api-sandbox-preflight.js";
+import { sandboxPostApiSandboxRun } from "../funcs/sandbox-post-api-sandbox-run.js";
+import { sandboxPostApiSandboxTelemetryV1Traces } from "../funcs/sandbox-post-api-sandbox-telemetry-v1-traces.js";
+import { sandboxPostApiSandboxToken } from "../funcs/sandbox-post-api-sandbox-token.js";
+import { sandboxPostApiSandbox } from "../funcs/sandbox-post-api-sandbox.js";
+import { ClientSDK } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+export class Sandbox extends ClientSDK {
+    /**
+     * Spawn a sandbox
+     *
+     * @remarks
+     * Requires an operator token. A session or task token is rejected with 403.
+     */
+    async postApiSandbox(request, options) {
+        return unwrapAsync(sandboxPostApiSandbox(this, request, options));
+    }
+    /**
+     * List sandboxes
+     *
+     * @remarks
+     * Always tenant-scoped. There is no unscoped listing path.
+     */
+    async getApiSandbox(options) {
+        return unwrapAsync(sandboxGetApiSandbox(this, options));
+    }
+    /**
+     * Run one command in a fresh sandbox
+     *
+     * @remarks
+     * Spawns from a preset, runs the command, tears the sandbox down. Requires an operator token — a one-shot run creates a sandbox. 200, not 201: the durable outcome is a result, and the sandbox it names is already gone unless `keep` was set. Blocking, and therefore bounded by the provider invocation timeout — long or interactive runs belong on POST /api/sandbox + /:id/exec.
+     */
+    async postApiSandboxRun(request, options) {
+        return unwrapAsync(sandboxPostApiSandboxRun(this, request, options));
+    }
+    /**
+     * Run one agent turn in a fresh sandbox
+     *
+     * @remarks
+     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+     */
+    async postApiSandboxAgentRun(request, options) {
+        return unwrapAsync(sandboxPostApiSandboxAgentRun(this, request, options));
+    }
+    /**
+     * List sandbox presets
+     *
+     * @remarks
+     * Named definitions a one-shot run can name. A preset is what lets a caller run something without knowing our registry, region or image tag. Image references are deliberately not returned.
+     */
+    async getApiSandboxPresets(options) {
+        return unwrapAsync(sandboxGetApiSandboxPresets(this, options));
+    }
+    /**
+     * List sandbox providers
+     *
+     * @remarks
+     * Providers this backend can reach and which is the default. A CLI that has no provider configured uses the default.
+     */
+    async getApiSandboxProviders(options) {
+        return unwrapAsync(sandboxGetApiSandboxProviders(this, options));
+    }
+    /**
+     * Preflight a sandbox definition
+     *
+     * @remarks
+     * Validate a definition against a provider without creating anything. Returns every violation, not just the first.
+     */
+    async postApiSandboxPreflight(request, options) {
+        return unwrapAsync(sandboxPostApiSandboxPreflight(this, request, options));
+    }
+    /**
+     * Exchange a platform API key for a sandbox operator token
+     *
+     * @remarks
+     * Trades a platform API key (`x-api-key: mg_live_…`) for a short-lived operator token scoped to one workspace. The caller must be able to create resources in that workspace.
+     */
+    async postApiSandboxToken(request, options) {
+        return unwrapAsync(sandboxPostApiSandboxToken(this, request, options));
+    }
+    /**
+     * Ingest OTLP spans from inside a sandbox
+     *
+     * @remarks
+     * OTLP/HTTP JSON. Requires a task token; spans are attributed to the sandbox the token is bound to, never to the sandbox named in the payload.
+     */
+    async postApiSandboxTelemetryV1Traces(options) {
+        return unwrapAsync(sandboxPostApiSandboxTelemetryV1Traces(this, options));
+    }
+    /**
+     * Get sandbox status
+     */
+    async getApiSandboxById(request, options) {
+        return unwrapAsync(sandboxGetApiSandboxById(this, request, options));
+    }
+    /**
+     * Tear down a sandbox
+     *
+     * @remarks
+     * Idempotent. The record is forgotten even if the provider teardown fails.
+     */
+    async deleteApiSandboxById(request, options) {
+        return unwrapAsync(sandboxDeleteApiSandboxById(this, request, options));
+    }
+    /**
+     * Run a command in a sandbox
+     *
+     * @remarks
+     * Returns the command's real exit code. A task token is rejected — in-sandbox code reports on itself, it does not drive the box. With `?stream=1` the same result comes back as the event stream of `GET /:id/stream`, scoped to this one invocation and terminated by a `status` event carrying the exit code.
+     */
+    async postApiSandboxByIdExec(request, options) {
+        return unwrapAsync(sandboxPostApiSandboxByIdExec(this, request, options));
+    }
+    /**
+     * Watch a sandbox's output live
+     *
+     * @remarks
+     * Server-sent events: `stdout`, `stderr`, `status`, `ping` (every 15s), `error`. `seq` is monotonic per sandbox and starts at 1; pass the last one seen as `?since=` to resume. If the buffer has already rolled past `since`, an `error` event names the lost range rather than skipping it silently. Disconnecting tears down the upstream.
+     */
+    async getApiSandboxByIdStream(request, options) {
+        return unwrapAsync(sandboxGetApiSandboxByIdStream(this, request, options));
+    }
+    /**
+     * Read a sandbox's captured spans
+     */
+    async getApiSandboxByIdTraces(request, options) {
+        return unwrapAsync(sandboxGetApiSandboxByIdTraces(this, request, options));
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/esm/sdk/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../../src/sdk/sandbox.ts"],"names":[],"mappings":"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"}