@mutagent/sdk 0.3.34 → 0.3.36

package/src/models/operations/get-api-sandbox-providers.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * Response for status 200
+ */
+export type GetApiSandboxProvidersResponse = {
+  names: Array<string>;
+  default: string | null;
+};
+
+/** @internal */
+export const GetApiSandboxProvidersResponse$inboundSchema: z.ZodMiniType<
+  GetApiSandboxProvidersResponse,
+  unknown
+> = z.object({
+  names: z.array(types.string()),
+  default: types.nullable(types.string()),
+});
+
+export function getApiSandboxProvidersResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetApiSandboxProvidersResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetApiSandboxProvidersResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetApiSandboxProvidersResponse' from JSON`,
+  );
+}

package/src/models/operations/get-api-sandbox.ts

@@ -0,0 +1,103 @@
+/*
+ * 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 { OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * CPU architecture the image was built for. Validated against the provider at preflight.
+ */
+export enum GetApiSandboxArch {
+  X8664 = "x86_64",
+  Arm64 = "arm64",
+}
+/**
+ * CPU architecture the image was built for. Validated against the provider at preflight.
+ */
+export type GetApiSandboxArchOpen = OpenEnum<typeof GetApiSandboxArch>;
+
+export enum GetApiSandboxStatus {
+  Pending = "pending",
+  Starting = "starting",
+  Running = "running",
+  Paused = "paused",
+  Stopping = "stopping",
+  Stopped = "stopped",
+  Failed = "failed",
+}
+export type GetApiSandboxStatusOpen = OpenEnum<typeof GetApiSandboxStatus>;
+
+/**
+ * A sandbox as recorded by the service — one record whether spawned from CLI or platform
+ */
+export type GetApiSandboxResponse = {
+  /**
+   * 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: GetApiSandboxArchOpen;
+  status: GetApiSandboxStatusOpen;
+  definitionName: string;
+  environmentName?: string | undefined;
+  /**
+   * ISO timestamp
+   */
+  createdAt: string;
+};
+
+/** @internal */
+export const GetApiSandboxArch$inboundSchema: z.ZodMiniType<
+  GetApiSandboxArchOpen,
+  unknown
+> = openEnums.inboundSchema(GetApiSandboxArch);
+
+/** @internal */
+export const GetApiSandboxStatus$inboundSchema: z.ZodMiniType<
+  GetApiSandboxStatusOpen,
+  unknown
+> = openEnums.inboundSchema(GetApiSandboxStatus);
+
+/** @internal */
+export const GetApiSandboxResponse$inboundSchema: z.ZodMiniType<
+  GetApiSandboxResponse,
+  unknown
+> = z.object({
+  id: types.string(),
+  generation: types.number(),
+  provider: types.string(),
+  arch: z._default(GetApiSandboxArch$inboundSchema, GetApiSandboxArch.X8664),
+  status: z._default(
+    GetApiSandboxStatus$inboundSchema,
+    GetApiSandboxStatus.Pending,
+  ),
+  definitionName: types.string(),
+  environmentName: types.optional(types.string()),
+  createdAt: types.string(),
+});
+
+export function getApiSandboxResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetApiSandboxResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetApiSandboxResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetApiSandboxResponse' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -9,6 +9,7 @@ export * from "./check-organization-slug.js";
 export * from "./create-invitation.js";
 export * from "./delete-account.js";
 export * from "./delete-agent.js";
+export * from "./delete-api-sandbox-by-id.js";
 export * from "./delete-invitation.js";
 export * from "./delete-organization.js";
 export * from "./delete-provider.js";
@@ -16,6 +17,12 @@ export * from "./delete-session.js";
 export * from "./delete-workspace.js";
 export * from "./get-agent-by-slug.js";
 export * from "./get-agent.js";
+export * from "./get-api-sandbox-by-id-stream.js";
+export * from "./get-api-sandbox-by-id-traces.js";
+export * from "./get-api-sandbox-by-id.js";
+export * from "./get-api-sandbox-presets.js";
+export * from "./get-api-sandbox-providers.js";
+export * from "./get-api-sandbox.js";
 export * from "./get-invitation.js";
 export * from "./get-models-catalog.js";
 export * from "./get-organization-by-slug.js";
@@ -34,6 +41,13 @@ export * from "./list-providers.js";
 export * from "./list-sessions.js";
 export * from "./list-workspace-members.js";
 export * from "./list-workspaces.js";
+export * from "./post-api-sandbox-agent-run.js";
+export * from "./post-api-sandbox-by-id-exec.js";
+export * from "./post-api-sandbox-preflight.js";
+export * from "./post-api-sandbox-run.js";
+export * from "./post-api-sandbox-telemetry-v1-traces.js";
+export * from "./post-api-sandbox-token.js";
+export * from "./post-api-sandbox.js";
 export * from "./remove-organization-member.js";
 export * from "./remove-workspace-member.js";
 export * from "./resend-invitation.js";

package/src/models/operations/post-api-sandbox-agent-run.ts

@@ -0,0 +1,175 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * Set to `1` to watch the turn as an event stream instead of awaiting one JSON body.
+ */
+export enum PostApiSandboxAgentRunStream {
+  Zero = "0",
+  One = "1",
+  False = "false",
+  True = "true",
+}
+
+/**
+ * Run one agent turn in a fresh sandbox and tear it down
+ */
+export type PostApiSandboxAgentRunRequestBody = {
+  /**
+   * Named preset to run on. Omitted means the backend default — see GET /api/sandbox/presets.
+   */
+  preset?: string | undefined;
+  /**
+   * Per-command timeout. The provider invocation timeout also applies and may be lower — a one-shot call is not the way to run something long.
+   */
+  timeoutMs?: number | undefined;
+  /**
+   * Keep the sandbox after the run instead of tearing it down. Defaults to false; the returned sandboxId is then usable with /api/sandbox/:id/exec.
+   */
+  keep?: boolean | undefined;
+  /**
+   * Correlation id for trace attribution
+   */
+  runId?: string | undefined;
+  /**
+   * WHO the agent is — the agent definition, passed as `helix agent --prompt`.
+   */
+  prompt: string;
+  /**
+   * WHAT to do this turn — the task, passed as `-p`. A different prompt from `prompt`.
+   */
+  task: string;
+};
+
+export type PostApiSandboxAgentRunRequest = {
+  /**
+   * Set to `1` to watch the turn as an event stream instead of awaiting one JSON body.
+   */
+  stream?: PostApiSandboxAgentRunStream | undefined;
+  /**
+   * Run one agent turn in a fresh sandbox and tear it down
+   */
+  body: PostApiSandboxAgentRunRequestBody;
+};
+
+/**
+ * Result of a one-shot run
+ */
+export type PostApiSandboxAgentRunResponse = {
+  /**
+   * The sandbox the run happened in. Already gone unless `keep` was true.
+   */
+  sandboxId: string;
+  /**
+   * Preset that was resolved — useful when the default was taken.
+   */
+  preset: string;
+  /**
+   * The command's real exit code. Never synthesised.
+   */
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+  timedOut: boolean;
+  /**
+   * Whether teardown was CONFIRMED. False with `keep` false means the release failed and the box may still exist — the run result is still valid.
+   */
+  tornDown: boolean;
+};
+
+/** @internal */
+export const PostApiSandboxAgentRunStream$outboundSchema: z.ZodMiniEnum<
+  typeof PostApiSandboxAgentRunStream
+> = z.enum(PostApiSandboxAgentRunStream);
+
+/** @internal */
+export type PostApiSandboxAgentRunRequestBody$Outbound = {
+  preset?: string | undefined;
+  timeoutMs?: number | undefined;
+  keep?: boolean | undefined;
+  runId?: string | undefined;
+  prompt: string;
+  task: string;
+};
+
+/** @internal */
+export const PostApiSandboxAgentRunRequestBody$outboundSchema: z.ZodMiniType<
+  PostApiSandboxAgentRunRequestBody$Outbound,
+  PostApiSandboxAgentRunRequestBody
+> = z.object({
+  preset: z.optional(z.string()),
+  timeoutMs: z.optional(z.number()),
+  keep: z.optional(z.boolean()),
+  runId: z.optional(z.string()),
+  prompt: z.string(),
+  task: z.string(),
+});
+
+export function postApiSandboxAgentRunRequestBodyToJSON(
+  postApiSandboxAgentRunRequestBody: PostApiSandboxAgentRunRequestBody,
+): string {
+  return JSON.stringify(
+    PostApiSandboxAgentRunRequestBody$outboundSchema.parse(
+      postApiSandboxAgentRunRequestBody,
+    ),
+  );
+}
+
+/** @internal */
+export type PostApiSandboxAgentRunRequest$Outbound = {
+  stream: string;
+  body: PostApiSandboxAgentRunRequestBody$Outbound;
+};
+
+/** @internal */
+export const PostApiSandboxAgentRunRequest$outboundSchema: z.ZodMiniType<
+  PostApiSandboxAgentRunRequest$Outbound,
+  PostApiSandboxAgentRunRequest
+> = z.object({
+  stream: z._default(
+    PostApiSandboxAgentRunStream$outboundSchema,
+    PostApiSandboxAgentRunStream.Zero,
+  ),
+  body: z.lazy(() => PostApiSandboxAgentRunRequestBody$outboundSchema),
+});
+
+export function postApiSandboxAgentRunRequestToJSON(
+  postApiSandboxAgentRunRequest: PostApiSandboxAgentRunRequest,
+): string {
+  return JSON.stringify(
+    PostApiSandboxAgentRunRequest$outboundSchema.parse(
+      postApiSandboxAgentRunRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const PostApiSandboxAgentRunResponse$inboundSchema: z.ZodMiniType<
+  PostApiSandboxAgentRunResponse,
+  unknown
+> = z.object({
+  sandboxId: types.string(),
+  preset: types.string(),
+  exitCode: types.number(),
+  stdout: types.string(),
+  stderr: types.string(),
+  timedOut: types.boolean(),
+  tornDown: types.boolean(),
+});
+
+export function postApiSandboxAgentRunResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxAgentRunResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxAgentRunResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxAgentRunResponse' from JSON`,
+  );
+}

package/src/models/operations/post-api-sandbox-by-id-exec.ts

@@ -0,0 +1,136 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * Set to `1` to receive the result as an event stream instead of JSON.
+ */
+export enum PostApiSandboxByIdExecStream {
+  Zero = "0",
+  One = "1",
+  False = "false",
+  True = "true",
+}
+
+/**
+ * Run a command inside a sandbox
+ */
+export type PostApiSandboxByIdExecRequestBody = {
+  command: Array<string>;
+  cwd?: string | undefined;
+  timeoutMs?: number | undefined;
+};
+
+export type PostApiSandboxByIdExecRequest = {
+  id: string;
+  /**
+   * Set to `1` to receive the result as an event stream instead of JSON.
+   */
+  stream?: PostApiSandboxByIdExecStream | undefined;
+  /**
+   * Run a command inside a sandbox
+   */
+  body: PostApiSandboxByIdExecRequestBody;
+};
+
+/**
+ * Command result
+ */
+export type PostApiSandboxByIdExecResponse = {
+  /**
+   * The command's real exit code
+   */
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+  timedOut: boolean;
+};
+
+/** @internal */
+export const PostApiSandboxByIdExecStream$outboundSchema: z.ZodMiniEnum<
+  typeof PostApiSandboxByIdExecStream
+> = z.enum(PostApiSandboxByIdExecStream);
+
+/** @internal */
+export type PostApiSandboxByIdExecRequestBody$Outbound = {
+  command: Array<string>;
+  cwd?: string | undefined;
+  timeoutMs?: number | undefined;
+};
+
+/** @internal */
+export const PostApiSandboxByIdExecRequestBody$outboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdExecRequestBody$Outbound,
+  PostApiSandboxByIdExecRequestBody
+> = z.object({
+  command: z.array(z.string()),
+  cwd: z.optional(z.string()),
+  timeoutMs: z.optional(z.number()),
+});
+
+export function postApiSandboxByIdExecRequestBodyToJSON(
+  postApiSandboxByIdExecRequestBody: PostApiSandboxByIdExecRequestBody,
+): string {
+  return JSON.stringify(
+    PostApiSandboxByIdExecRequestBody$outboundSchema.parse(
+      postApiSandboxByIdExecRequestBody,
+    ),
+  );
+}
+
+/** @internal */
+export type PostApiSandboxByIdExecRequest$Outbound = {
+  id: string;
+  stream: string;
+  body: PostApiSandboxByIdExecRequestBody$Outbound;
+};
+
+/** @internal */
+export const PostApiSandboxByIdExecRequest$outboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdExecRequest$Outbound,
+  PostApiSandboxByIdExecRequest
+> = z.object({
+  id: z.string(),
+  stream: z._default(
+    PostApiSandboxByIdExecStream$outboundSchema,
+    PostApiSandboxByIdExecStream.Zero,
+  ),
+  body: z.lazy(() => PostApiSandboxByIdExecRequestBody$outboundSchema),
+});
+
+export function postApiSandboxByIdExecRequestToJSON(
+  postApiSandboxByIdExecRequest: PostApiSandboxByIdExecRequest,
+): string {
+  return JSON.stringify(
+    PostApiSandboxByIdExecRequest$outboundSchema.parse(
+      postApiSandboxByIdExecRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const PostApiSandboxByIdExecResponse$inboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdExecResponse,
+  unknown
+> = z.object({
+  exitCode: types.number(),
+  stdout: types.string(),
+  stderr: types.string(),
+  timedOut: types.boolean(),
+});
+
+export function postApiSandboxByIdExecResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxByIdExecResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxByIdExecResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxByIdExecResponse' from JSON`,
+  );
+}