@mutagent/sdk 0.3.48 → 0.3.49

package/src/models/operations/get-api-sandbox-environments-by-name.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type GetApiSandboxEnvironmentsByNameRequest = {
+  name: string;
+};
+
+/** @internal */
+export type GetApiSandboxEnvironmentsByNameRequest$Outbound = {
+  name: string;
+};
+
+/** @internal */
+export const GetApiSandboxEnvironmentsByNameRequest$outboundSchema:
+  z.ZodMiniType<
+    GetApiSandboxEnvironmentsByNameRequest$Outbound,
+    GetApiSandboxEnvironmentsByNameRequest
+  > = z.object({
+    name: z.string(),
+  });
+
+export function getApiSandboxEnvironmentsByNameRequestToJSON(
+  getApiSandboxEnvironmentsByNameRequest:
+    GetApiSandboxEnvironmentsByNameRequest,
+): string {
+  return JSON.stringify(
+    GetApiSandboxEnvironmentsByNameRequest$outboundSchema.parse(
+      getApiSandboxEnvironmentsByNameRequest,
+    ),
+  );
+}

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

@@ -0,0 +1,34 @@
+/*
+ * 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 { SDKValidationError } from "../errors/sdk-validation-error.js";
+import * as models from "../index.js";
+
+/**
+ * Every Environment in the workspace, by name.
+ */
+export type GetApiSandboxEnvironmentsResponse = {
+  environments: Array<models.NameVarsSecrets>;
+};
+
+/** @internal */
+export const GetApiSandboxEnvironmentsResponse$inboundSchema: z.ZodMiniType<
+  GetApiSandboxEnvironmentsResponse,
+  unknown
+> = z.object({
+  environments: z.array(models.NameVarsSecrets$inboundSchema),
+});
+
+export function getApiSandboxEnvironmentsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetApiSandboxEnvironmentsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetApiSandboxEnvironmentsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetApiSandboxEnvironmentsResponse' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -10,6 +10,7 @@ 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-api-sandbox-environments-by-name.js";
 export * from "./delete-invitation.js";
 export * from "./delete-organization.js";
 export * from "./delete-provider.js";
@@ -22,6 +23,8 @@ export * from "./get-api-sandbox-by-id-sessions.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-environments-by-name.js";
+export * from "./get-api-sandbox-environments.js";
 export * from "./get-api-sandbox-presets.js";
 export * from "./get-api-sandbox-providers.js";
 export * from "./get-api-sandbox.js";
@@ -48,6 +51,7 @@ export * from "./list-trace-spans.js";
 export * from "./list-traces.js";
 export * from "./list-workspace-members.js";
 export * from "./list-workspaces.js";
+export * from "./patch-api-sandbox-environments-by-name.js";
 export * from "./post-api-sandbox-agent-run.js";
 export * from "./post-api-sandbox-by-id-checkpoint.js";
 export * from "./post-api-sandbox-by-id-exec.js";
@@ -60,6 +64,7 @@ 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 "./put-api-sandbox-environments-by-name.js";
 export * from "./remove-organization-member.js";
 export * from "./remove-workspace-member.js";
 export * from "./resend-invitation.js";

package/src/models/operations/patch-api-sandbox-environments-by-name.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as models from "../index.js";
+
+export type PatchApiSandboxEnvironmentsByNameRequest = {
+  name: string;
+  allowProviderKey?: models.Schemadefaul6 | undefined;
+  /**
+   * Set or unset individual entries. Creates the Environment when absent.
+   */
+  body: models.VarsSecrets;
+};
+
+/** @internal */
+export type PatchApiSandboxEnvironmentsByNameRequest$Outbound = {
+  name: string;
+  allowProviderKey: string;
+  body: models.VarsSecrets$Outbound;
+};
+
+/** @internal */
+export const PatchApiSandboxEnvironmentsByNameRequest$outboundSchema:
+  z.ZodMiniType<
+    PatchApiSandboxEnvironmentsByNameRequest$Outbound,
+    PatchApiSandboxEnvironmentsByNameRequest
+  > = z.object({
+    name: z.string(),
+    allowProviderKey: z._default(
+      models.Schemadefaul6$outboundSchema,
+      models.Schemadefaul6.Zero,
+    ),
+    body: models.VarsSecrets$outboundSchema,
+  });
+
+export function patchApiSandboxEnvironmentsByNameRequestToJSON(
+  patchApiSandboxEnvironmentsByNameRequest:
+    PatchApiSandboxEnvironmentsByNameRequest,
+): string {
+  return JSON.stringify(
+    PatchApiSandboxEnvironmentsByNameRequest$outboundSchema.parse(
+      patchApiSandboxEnvironmentsByNameRequest,
+    ),
+  );
+}

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

@@ -9,21 +9,8 @@ import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdk-validation-error.js";
 import * as models from "../index.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",
-}
-
 export type PostApiSandboxAgentRunRequest = {
-  /**
-   * Set to `1` to watch the turn as an event stream instead of awaiting one JSON body.
-   */
-  stream?: PostApiSandboxAgentRunStream | undefined;
+  stream?: models.Schemadefaul6 | undefined;
   /**
    * Run one agent turn in a fresh sandbox and tear it down
    */
@@ -55,11 +42,6 @@ export type PostApiSandboxAgentRunResponse = {
   tornDown: boolean;
 };
 
-/** @internal */
-export const PostApiSandboxAgentRunStream$outboundSchema: z.ZodMiniEnum<
-  typeof PostApiSandboxAgentRunStream
-> = z.enum(PostApiSandboxAgentRunStream);
-
 /** @internal */
 export type PostApiSandboxAgentRunRequest$Outbound = {
   stream: string;
@@ -72,8 +54,8 @@ export const PostApiSandboxAgentRunRequest$outboundSchema: z.ZodMiniType<
   PostApiSandboxAgentRunRequest
 > = z.object({
   stream: z._default(
-    PostApiSandboxAgentRunStream$outboundSchema,
-    PostApiSandboxAgentRunStream.Zero,
+    models.Schemadefaul6$outboundSchema,
+    models.Schemadefaul6.Zero,
   ),
   body: models.PresetTimeoutMsKeep2$outboundSchema,
 });

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

@@ -9,22 +9,9 @@ import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdk-validation-error.js";
 import * as models from "../index.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",
-}
-
 export type PostApiSandboxByIdExecRequest = {
   id: string;
-  /**
-   * Set to `1` to receive the result as an event stream instead of JSON.
-   */
-  stream?: PostApiSandboxByIdExecStream | undefined;
+  stream?: models.Schemadefaul6 | undefined;
   /**
    * Run a command inside a sandbox
    */
@@ -44,11 +31,6 @@ export type PostApiSandboxByIdExecResponse = {
   timedOut: boolean;
 };
 
-/** @internal */
-export const PostApiSandboxByIdExecStream$outboundSchema: z.ZodMiniEnum<
-  typeof PostApiSandboxByIdExecStream
-> = z.enum(PostApiSandboxByIdExecStream);
-
 /** @internal */
 export type PostApiSandboxByIdExecRequest$Outbound = {
   id: string;
@@ -63,8 +45,8 @@ export const PostApiSandboxByIdExecRequest$outboundSchema: z.ZodMiniType<
 > = z.object({
   id: z.string(),
   stream: z._default(
-    PostApiSandboxByIdExecStream$outboundSchema,
-    PostApiSandboxByIdExecStream.Zero,
+    models.Schemadefaul6$outboundSchema,
+    models.Schemadefaul6.Zero,
   ),
   body: models.CommandCwdTimeoutMs$outboundSchema,
 });

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

@@ -32,11 +32,11 @@ export type PostApiSandboxByIdSessionResponse = {
   /**
    * The mode the session was actually started in.
    */
-  mode: models.Schemadefaul6Open;
+  mode: models.Schemadefaul7Open;
   /**
    * The launcher arm the session was actually started on.
    */
-  arm: models.Schemadefaul7Open;
+  arm: models.Schemadefaul8Open;
 };
 
 /** @internal */
@@ -72,12 +72,12 @@ export const PostApiSandboxByIdSessionResponse$inboundSchema: z.ZodMiniType<
   sessionId: types.string(),
   status: types.string(),
   mode: z._default(
-    models.Schemadefaul6$inboundSchema,
-    models.Schemadefaul6.Oneshot,
+    models.Schemadefaul7$inboundSchema,
+    models.Schemadefaul7.Oneshot,
   ),
   arm: z._default(
-    models.Schemadefaul7$inboundSchema,
-    models.Schemadefaul7.Classic,
+    models.Schemadefaul8$inboundSchema,
+    models.Schemadefaul8.Classic,
   ),
 });
 

package/src/models/operations/put-api-sandbox-environments-by-name.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as models from "../index.js";
+
+export type PutApiSandboxEnvironmentsByNameRequest = {
+  name: string;
+  allowProviderKey?: models.Schemadefaul6 | undefined;
+  /**
+   * Create or replace an Environment. Entries not present are removed.
+   */
+  body: models.VarsSecrets;
+};
+
+/** @internal */
+export type PutApiSandboxEnvironmentsByNameRequest$Outbound = {
+  name: string;
+  allowProviderKey: string;
+  body: models.VarsSecrets$Outbound;
+};
+
+/** @internal */
+export const PutApiSandboxEnvironmentsByNameRequest$outboundSchema:
+  z.ZodMiniType<
+    PutApiSandboxEnvironmentsByNameRequest$Outbound,
+    PutApiSandboxEnvironmentsByNameRequest
+  > = z.object({
+    name: z.string(),
+    allowProviderKey: z._default(
+      models.Schemadefaul6$outboundSchema,
+      models.Schemadefaul6.Zero,
+    ),
+    body: models.VarsSecrets$outboundSchema,
+  });
+
+export function putApiSandboxEnvironmentsByNameRequestToJSON(
+  putApiSandboxEnvironmentsByNameRequest:
+    PutApiSandboxEnvironmentsByNameRequest,
+): string {
+  return JSON.stringify(
+    PutApiSandboxEnvironmentsByNameRequest$outboundSchema.parse(
+      putApiSandboxEnvironmentsByNameRequest,
+    ),
+  );
+}

package/src/models/operations/update-organization-member.ts

@@ -9,7 +9,7 @@ export type UpdateOrganizationMemberRequestBody = {
   /**
    * The new role for the member
    */
-  role?: models.Schemadefaul9 | undefined;
+  role?: models.Schemadefaul10 | undefined;
 };
 
 export type UpdateOrganizationMemberRequest = {
@@ -29,8 +29,8 @@ export const UpdateOrganizationMemberRequestBody$outboundSchema: z.ZodMiniType<
   UpdateOrganizationMemberRequestBody
 > = z.object({
   role: z._default(
-    models.Schemadefaul9$outboundSchema,
-    models.Schemadefaul9.Owner,
+    models.Schemadefaul10$outboundSchema,
+    models.Schemadefaul10.Owner,
   ),
 });
 

package/src/models/operations/update-workspace-member.ts

@@ -9,7 +9,7 @@ export type UpdateWorkspaceMemberRequestBody = {
   /**
    * The new role for the member
    */
-  role?: models.Schemadefaul11 | undefined;
+  role?: models.Schemadefaul12 | undefined;
 };
 
 export type UpdateWorkspaceMemberRequest = {
@@ -29,8 +29,8 @@ export const UpdateWorkspaceMemberRequestBody$outboundSchema: z.ZodMiniType<
   UpdateWorkspaceMemberRequestBody
 > = z.object({
   role: z._default(
-    models.Schemadefaul11$outboundSchema,
-    models.Schemadefaul11.Admin,
+    models.Schemadefaul12$outboundSchema,
+    models.Schemadefaul12.Admin,
   ),
 });
 

package/src/models/preset-timeout-ms-keep.ts

@@ -21,6 +21,10 @@ export type PresetTimeoutMsKeep = {
    * Correlation id for trace attribution
    */
   runId?: string | undefined;
+  /**
+   * A workspace Environment (see GET /api/sandbox/environments) to load into the fresh box, resolved server-side. Overrides the preset definition's own `environment` for this run. 404 when the workspace has none by that name.
+   */
+  environment?: string | undefined;
   /**
    * argv. Not a shell string — no shell is involved unless you name one.
    */
@@ -34,6 +38,7 @@ export type PresetTimeoutMsKeep$Outbound = {
   timeoutMs?: number | undefined;
   keep?: boolean | undefined;
   runId?: string | undefined;
+  environment?: string | undefined;
   command: Array<string>;
   cwd?: string | undefined;
 };
@@ -47,6 +52,7 @@ export const PresetTimeoutMsKeep$outboundSchema: z.ZodMiniType<
   timeoutMs: z.optional(z.number()),
   keep: z.optional(z.boolean()),
   runId: z.optional(z.string()),
+  environment: z.optional(z.string()),
   command: z.array(z.string()),
   cwd: z.optional(z.string()),
 });

package/src/models/preset-timeout-ms-keep2.ts

@@ -21,6 +21,10 @@ export type PresetTimeoutMsKeep2 = {
    * Correlation id for trace attribution
    */
   runId?: string | undefined;
+  /**
+   * A workspace Environment (see GET /api/sandbox/environments) to load into the fresh box, resolved server-side. Overrides the preset definition's own `environment` for this run. 404 when the workspace has none by that name.
+   */
+  environment?: string | undefined;
   /**
    * WHO the agent is — the agent definition, passed as `helix agent --prompt`. Omit it to name a definition the BOX resolves instead: `args` must then carry `--name <agent>` (the image’s bundled roster, then the box’s agent dirs). Exactly one of `prompt` or a `--name` in `args` is required.
    */
@@ -49,6 +53,7 @@ export type PresetTimeoutMsKeep2$Outbound = {
   timeoutMs?: number | undefined;
   keep?: boolean | undefined;
   runId?: string | undefined;
+  environment?: string | undefined;
   prompt?: string | undefined;
   task: string;
   prime?: boolean | undefined;
@@ -65,6 +70,7 @@ export const PresetTimeoutMsKeep2$outboundSchema: z.ZodMiniType<
   timeoutMs: z.optional(z.number()),
   keep: z.optional(z.boolean()),
   runId: z.optional(z.string()),
+  environment: z.optional(z.string()),
   prompt: z.optional(z.string()),
   task: z.string(),
   prime: z.optional(z.boolean()),

package/src/models/{schemadefaul9.ts → schemadefaul10.ts}

@@ -4,7 +4,7 @@
 
 import * as z from "zod/v4-mini";
 
-export enum Schemadefaul9 {
+export enum Schemadefaul10 {
   Owner = "owner",
   Admin = "admin",
   Editor = "editor",
@@ -12,5 +12,6 @@ export enum Schemadefaul9 {
 }
 
 /** @internal */
-export const Schemadefaul9$outboundSchema: z.ZodMiniEnum<typeof Schemadefaul9> =
-  z.enum(Schemadefaul9);
+export const Schemadefaul10$outboundSchema: z.ZodMiniEnum<
+  typeof Schemadefaul10
+> = z.enum(Schemadefaul10);

package/src/models/{schemadefaul11.ts → schemadefaul12.ts}

@@ -4,13 +4,13 @@
 
 import * as z from "zod/v4-mini";
 
-export enum Schemadefaul11 {
+export enum Schemadefaul12 {
   Admin = "admin",
   Editor = "editor",
   Viewer = "viewer",
 }
 
 /** @internal */
-export const Schemadefaul11$outboundSchema: z.ZodMiniEnum<
-  typeof Schemadefaul11
-> = z.enum(Schemadefaul11);
+export const Schemadefaul12$outboundSchema: z.ZodMiniEnum<
+  typeof Schemadefaul12
+> = z.enum(Schemadefaul12);

package/src/models/schemadefaul6.ts

@@ -3,22 +3,14 @@
  */
 
 import * as z from "zod/v4-mini";
-import * as openEnums from "../types/enums.js";
-import { OpenEnum } from "../types/enums.js";
 
 export enum Schemadefaul6 {
-  Oneshot = "oneshot",
-  Rpc = "rpc",
+  Zero = "0",
+  One = "1",
+  False = "false",
+  True = "true",
 }
-export type Schemadefaul6Open = OpenEnum<typeof Schemadefaul6>;
 
 /** @internal */
-export const Schemadefaul6$inboundSchema: z.ZodMiniType<
-  Schemadefaul6Open,
-  unknown
-> = openEnums.inboundSchema(Schemadefaul6);
-/** @internal */
-export const Schemadefaul6$outboundSchema: z.ZodMiniType<
-  string,
-  Schemadefaul6Open
-> = openEnums.outboundSchema(Schemadefaul6);
+export const Schemadefaul6$outboundSchema: z.ZodMiniEnum<typeof Schemadefaul6> =
+  z.enum(Schemadefaul6);

package/src/models/schemadefaul7.ts

@@ -7,9 +7,8 @@ import * as openEnums from "../types/enums.js";
 import { OpenEnum } from "../types/enums.js";
 
 export enum Schemadefaul7 {
-  Classic = "classic",
-  Prime = "prime",
-  Agent = "agent",
+  Oneshot = "oneshot",
+  Rpc = "rpc",
 }
 export type Schemadefaul7Open = OpenEnum<typeof Schemadefaul7>;
 

package/src/models/schemadefaul8.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+export enum Schemadefaul8 {
+  Classic = "classic",
+  Prime = "prime",
+  Agent = "agent",
+}
+export type Schemadefaul8Open = OpenEnum<typeof Schemadefaul8>;
+
+/** @internal */
+export const Schemadefaul8$inboundSchema: z.ZodMiniType<
+  Schemadefaul8Open,
+  unknown
+> = openEnums.inboundSchema(Schemadefaul8);
+/** @internal */
+export const Schemadefaul8$outboundSchema: z.ZodMiniType<
+  string,
+  Schemadefaul8Open
+> = openEnums.outboundSchema(Schemadefaul8);

package/src/models/snapshot-id-definition-partial.ts

@@ -30,6 +30,14 @@ export type SnapshotIdDefinitionPartial = {
    * 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 */
@@ -43,6 +51,8 @@ export type SnapshotIdDefinitionPartial$Outbound = {
   definition?: any | undefined;
   partial?: boolean | undefined;
   onWorkspaceDrift: string;
+  env?: { [k: string]: string } | undefined;
+  environment?: string | undefined;
 };
 
 /** @internal */
@@ -57,6 +67,8 @@ export const SnapshotIdDefinitionPartial$outboundSchema: z.ZodMiniType<
     OnWorkspaceDrift$outboundSchema,
     OnWorkspaceDrift.Warn,
   ),
+  env: z.optional(z.record(z.string(), z.string())),
+  environment: z.optional(z.string()),
 });
 
 export function snapshotIdDefinitionPartialToJSON(

package/src/models/vars-secrets.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type VarsSecrets = {
+  /**
+   * Non-secret variables, name → value. Stored readable; returned only as fingerprints.
+   */
+  vars?: { [k: string]: any } | undefined;
+  /**
+   * Secret values, name → value. WRITE-ONLY: encrypted at rest with the provider-credential key, never returned by any route.
+   */
+  secrets?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export type VarsSecrets$Outbound = {
+  vars?: { [k: string]: any } | undefined;
+  secrets?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const VarsSecrets$outboundSchema: z.ZodMiniType<
+  VarsSecrets$Outbound,
+  VarsSecrets
+> = z.object({
+  vars: z.optional(z.record(z.string(), z.any())),
+  secrets: z.optional(z.record(z.string(), z.any())),
+});
+
+export function varsSecretsToJSON(varsSecrets: VarsSecrets): string {
+  return JSON.stringify(VarsSecrets$outboundSchema.parse(varsSecrets));
+}