@mutagent/sdk 0.3.55 → 0.4.1

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

@@ -0,0 +1,122 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { smartUnion } from "../../types/smart-union.js";
+import * as operations from "../operations/index.js";
+import {
+  ErrorMessageModel,
+  ErrorMessageModel$inboundSchema,
+} from "./error-message-model.js";
+import {
+  ErrorMessage2,
+  ErrorMessage2$inboundSchema,
+} from "./error-message2.js";
+import { MutagentError } from "./mutagent-error.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+
+/**
+ * Response for status 428
+ */
+export type PostApiSandboxByIdSessionNoProviderConfiguredErrorData = {
+  error: string;
+  message: string;
+  code: operations.PostApiSandboxByIdSessionCode;
+  workspaceId: string;
+  provider?: string | undefined;
+  directive: operations.PostApiSandboxByIdSessionDirective;
+};
+
+/**
+ * Response for status 428
+ */
+export class PostApiSandboxByIdSessionNoProviderConfiguredError
+  extends MutagentError
+{
+  error: string;
+  code: operations.PostApiSandboxByIdSessionCode;
+  workspaceId: string;
+  provider?: string | undefined;
+  directive: operations.PostApiSandboxByIdSessionDirective;
+
+  /** The original data that was passed to this error instance. */
+  data$: PostApiSandboxByIdSessionNoProviderConfiguredErrorData;
+
+  constructor(
+    err: PostApiSandboxByIdSessionNoProviderConfiguredErrorData,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
+    const message = err.message || `API error occurred: ${JSON.stringify(err)}`;
+    super(message, httpMeta);
+    this.data$ = err;
+    this.error = err.error;
+    this.code = err.code;
+    this.workspaceId = err.workspaceId;
+    if (err.provider != null) this.provider = err.provider;
+    this.directive = err.directive;
+
+    this.name = "PostApiSandboxByIdSessionNoProviderConfiguredError";
+  }
+}
+
+/**
+ * Response for status 422
+ */
+export type PostApiSandboxByIdSessionUnprocessableEntity =
+  | ErrorMessageModel
+  | ErrorMessage2;
+
+/** @internal */
+export const PostApiSandboxByIdSessionNoProviderConfiguredError$inboundSchema:
+  z.ZodMiniType<PostApiSandboxByIdSessionNoProviderConfiguredError, unknown> = z
+    .pipe(
+      z.object({
+        error: types.string(),
+        message: types.string(),
+        code: operations.PostApiSandboxByIdSessionCode$inboundSchema,
+        workspaceId: types.string(),
+        provider: types.optional(types.string()),
+        _directive: z.lazy(() =>
+          operations.PostApiSandboxByIdSessionDirective$inboundSchema
+        ),
+        request$: z.custom<Request>(x => x instanceof Request),
+        response$: z.custom<Response>(x => x instanceof Response),
+        body$: z.string(),
+      }),
+      z.transform((v) => {
+        const remapped = remap$(v, {
+          "_directive": "directive",
+        });
+
+        return new PostApiSandboxByIdSessionNoProviderConfiguredError(
+          remapped,
+          { request: v.request$, response: v.response$, body: v.body$ },
+        );
+      }),
+    );
+
+/** @internal */
+export const PostApiSandboxByIdSessionUnprocessableEntity$inboundSchema:
+  z.ZodMiniType<PostApiSandboxByIdSessionUnprocessableEntity, unknown> =
+    smartUnion([ErrorMessageModel$inboundSchema, ErrorMessage2$inboundSchema]);
+
+export function postApiSandboxByIdSessionUnprocessableEntityFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  PostApiSandboxByIdSessionUnprocessableEntity,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PostApiSandboxByIdSessionUnprocessableEntity$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'PostApiSandboxByIdSessionUnprocessableEntity' from JSON`,
+  );
+}

package/src/models/errors/put-api-sandbox-helix-defaults.ts

@@ -0,0 +1,45 @@
+/*
+ * 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 { smartUnion } from "../../types/smart-union.js";
+import {
+  ErrorMessageModel,
+  ErrorMessageModel$inboundSchema,
+} from "./error-message-model.js";
+import {
+  ErrorMessage2,
+  ErrorMessage2$inboundSchema,
+} from "./error-message2.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+
+/**
+ * Response for status 422
+ */
+export type PutApiSandboxHelixDefaultsUnprocessableEntity =
+  | ErrorMessageModel
+  | ErrorMessage2;
+
+/** @internal */
+export const PutApiSandboxHelixDefaultsUnprocessableEntity$inboundSchema:
+  z.ZodMiniType<PutApiSandboxHelixDefaultsUnprocessableEntity, unknown> =
+    smartUnion([ErrorMessageModel$inboundSchema, ErrorMessage2$inboundSchema]);
+
+export function putApiSandboxHelixDefaultsUnprocessableEntityFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  PutApiSandboxHelixDefaultsUnprocessableEntity,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PutApiSandboxHelixDefaultsUnprocessableEntity$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'PutApiSandboxHelixDefaultsUnprocessableEntity' from JSON`,
+  );
+}

package/src/models/index.ts

@@ -16,7 +16,7 @@ export * from "./id-name-email.js";
 export * from "./id-organization-id-email.js";
 export * from "./id-user-id-role.js";
 export * from "./id-user-id-role2.js";
-export * from "./mode-arm-args.js";
+export * from "./mode-arm-model.js";
 export * from "./name-api-key-credential-fields.js";
 export * from "./name-description-system-prompt.js";
 export * from "./name-email-avatar-url.js";

package/src/models/{mode-arm-args.ts → mode-arm-model.ts}

@@ -17,14 +17,14 @@ import {
 /**
  * Per-session override of what continuous capture carries.
  */
-export type ModeArmArgsCapture = {
+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;
 };
 
-export type ModeArmArgs = {
+export type ModeArmModel = {
   /**
    * Defaults to `oneshot` — the pre-existing behaviour. `rpc` starts a duplex session that emits `rpc` events on the stream and accepts `POST /:id/input`.
    */
@@ -33,6 +33,10 @@ export type ModeArmArgs = {
    * Which launcher arm to run. `classic` = `helix …` (orchestrator loaded), `prime` = `helix --prime …`, `agent` = `helix agent …`. Defaults to `agent`.
    */
   arm?: Schemadefaul8Open | 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.
    */
@@ -52,55 +56,57 @@ export type ModeArmArgs = {
   /**
    * Per-session override of what continuous capture carries.
    */
-  capture?: ModeArmArgsCapture | undefined;
+  capture?: ModeArmModelCapture | undefined;
 };
 
 /** @internal */
-export type ModeArmArgsCapture$Outbound = {
+export type ModeArmModelCapture$Outbound = {
   workspace?: boolean | undefined;
 };
 
 /** @internal */
-export const ModeArmArgsCapture$outboundSchema: z.ZodMiniType<
-  ModeArmArgsCapture$Outbound,
-  ModeArmArgsCapture
+export const ModeArmModelCapture$outboundSchema: z.ZodMiniType<
+  ModeArmModelCapture$Outbound,
+  ModeArmModelCapture
 > = z.object({
   workspace: z.optional(z.boolean()),
 });
 
-export function modeArmArgsCaptureToJSON(
-  modeArmArgsCapture: ModeArmArgsCapture,
+export function modeArmModelCaptureToJSON(
+  modeArmModelCapture: ModeArmModelCapture,
 ): string {
   return JSON.stringify(
-    ModeArmArgsCapture$outboundSchema.parse(modeArmArgsCapture),
+    ModeArmModelCapture$outboundSchema.parse(modeArmModelCapture),
   );
 }
 
 /** @internal */
-export type ModeArmArgs$Outbound = {
+export type ModeArmModel$Outbound = {
   mode: string;
   arm: string;
+  model?: string | undefined;
   args?: Array<string> | undefined;
   env?: { [k: string]: string } | undefined;
   environment?: string | undefined;
   cwd?: string | undefined;
-  capture?: ModeArmArgsCapture$Outbound | undefined;
+  capture?: ModeArmModelCapture$Outbound | undefined;
 };
 
 /** @internal */
-export const ModeArmArgs$outboundSchema: z.ZodMiniType<
-  ModeArmArgs$Outbound,
-  ModeArmArgs
+export const ModeArmModel$outboundSchema: z.ZodMiniType<
+  ModeArmModel$Outbound,
+  ModeArmModel
 > = z.object({
   mode: z._default(Schemadefaul7$outboundSchema, Schemadefaul7.Oneshot),
   arm: z._default(Schemadefaul8$outboundSchema, Schemadefaul8.Classic),
+  model: z.optional(z.string()),
   args: z.optional(z.array(z.string())),
   env: z.optional(z.record(z.string(), z.string())),
   environment: z.optional(z.string()),
   cwd: z.optional(z.string()),
-  capture: z.optional(z.lazy(() => ModeArmArgsCapture$outboundSchema)),
+  capture: z.optional(z.lazy(() => ModeArmModelCapture$outboundSchema)),
 });
 
-export function modeArmArgsToJSON(modeArmArgs: ModeArmArgs): string {
-  return JSON.stringify(ModeArmArgs$outboundSchema.parse(modeArmArgs));
+export function modeArmModelToJSON(modeArmModel: ModeArmModel): string {
+  return JSON.stringify(ModeArmModel$outboundSchema.parse(modeArmModel));
 }

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

@@ -0,0 +1,91 @@
+/*
+ * 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";
+
+export type GetApiSandboxHelixDefaultsModel = {
+  /**
+   * `provider/model` in the harness spelling — the exact value `--model` (or a session/agent-run `model`) takes.
+   */
+  id: string;
+  /**
+   * The platform provider id of the row this model comes from (`provider_configs.provider`).
+   */
+  provider: string;
+  /**
+   * The harness provider id — the key in the box’s generated `models.json`.
+   */
+  harnessProvider: string;
+  model: string;
+  displayName: string;
+};
+
+/**
+ * The workspace’s Helix Cloud model list — the platform catalog restricted to the workspace’s active providers — and its default models.
+ */
+export type GetApiSandboxHelixDefaultsResponse = {
+  workspaceId: string;
+  models: Array<GetApiSandboxHelixDefaultsModel>;
+  /**
+   * The stored `helix_default_models`, ordered, as written — an entry whose provider has since been deactivated stays listed here and is skipped at resolution.
+   */
+  defaults: Array<string>;
+  /**
+   * The model a run that names none will use: the first entry of `defaults` that is in `models`. Null means such a run answers 428 NO_PROVIDER_CONFIGURED.
+   */
+  default: string | null;
+  /**
+   * Active providers the box cannot credential, by name (a `custom` row as `custom:<harnessProvider>`). They contribute no models.
+   */
+  unmapped: Array<string>;
+};
+
+/** @internal */
+export const GetApiSandboxHelixDefaultsModel$inboundSchema: z.ZodMiniType<
+  GetApiSandboxHelixDefaultsModel,
+  unknown
+> = z.object({
+  id: types.string(),
+  provider: types.string(),
+  harnessProvider: types.string(),
+  model: types.string(),
+  displayName: types.string(),
+});
+
+export function getApiSandboxHelixDefaultsModelFromJSON(
+  jsonString: string,
+): SafeParseResult<GetApiSandboxHelixDefaultsModel, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetApiSandboxHelixDefaultsModel$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetApiSandboxHelixDefaultsModel' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetApiSandboxHelixDefaultsResponse$inboundSchema: z.ZodMiniType<
+  GetApiSandboxHelixDefaultsResponse,
+  unknown
+> = z.object({
+  workspaceId: types.string(),
+  models: z.array(z.lazy(() => GetApiSandboxHelixDefaultsModel$inboundSchema)),
+  defaults: z.array(types.string()),
+  default: types.nullable(types.string()),
+  unmapped: z.array(types.string()),
+});
+
+export function getApiSandboxHelixDefaultsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetApiSandboxHelixDefaultsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetApiSandboxHelixDefaultsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetApiSandboxHelixDefaultsResponse' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -25,6 +25,7 @@ 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-helix-defaults.js";
 export * from "./get-api-sandbox-presets.js";
 export * from "./get-api-sandbox-providers.js";
 export * from "./get-api-sandbox.js";
@@ -65,6 +66,7 @@ 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 "./put-api-sandbox-helix-defaults.js";
 export * from "./remove-organization-member.js";
 export * from "./remove-workspace-member.js";
 export * from "./resend-invitation.js";

package/src/models/operations/list-available-models.ts

@@ -8,7 +8,7 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdk-validation-error.js";
 
-export type Model = {
+export type ListAvailableModelsModel = {
   /**
    * Model identifier (e.g., "gpt-4o")
    */
@@ -38,7 +38,7 @@ export type ListAvailableModelsResponse = {
   /**
    * Available models from configured providers
    */
-  models: Array<Model>;
+  models: Array<ListAvailableModelsModel>;
   /**
    * Provider types that have active configurations
    */
@@ -46,7 +46,10 @@ export type ListAvailableModelsResponse = {
 };
 
 /** @internal */
-export const Model$inboundSchema: z.ZodMiniType<Model, unknown> = z.object({
+export const ListAvailableModelsModel$inboundSchema: z.ZodMiniType<
+  ListAvailableModelsModel,
+  unknown
+> = z.object({
   id: types.string(),
   name: types.string(),
   provider: types.string(),
@@ -54,13 +57,13 @@ export const Model$inboundSchema: z.ZodMiniType<Model, unknown> = z.object({
   description: types.optional(types.string()),
 });
 
-export function modelFromJSON(
+export function listAvailableModelsModelFromJSON(
   jsonString: string,
-): SafeParseResult<Model, SDKValidationError> {
+): SafeParseResult<ListAvailableModelsModel, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => Model$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Model' from JSON`,
+    (x) => ListAvailableModelsModel$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListAvailableModelsModel' from JSON`,
   );
 }
 
@@ -69,7 +72,7 @@ export const ListAvailableModelsResponse$inboundSchema: z.ZodMiniType<
   ListAvailableModelsResponse,
   unknown
 > = z.object({
-  models: z.array(z.lazy(() => Model$inboundSchema)),
+  models: z.array(z.lazy(() => ListAvailableModelsModel$inboundSchema)),
   providers: z.array(types.string()),
 });
 

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

@@ -17,6 +17,19 @@ export type PostApiSandboxAgentRunRequest = {
   body: models.PresetTimeoutMsKeep2;
 };
 
+export enum PostApiSandboxAgentRunCode {
+  NoProviderConfigured = "NO_PROVIDER_CONFIGURED",
+}
+
+export type PostApiSandboxAgentRunNext = {
+  command?: string | undefined;
+  url?: string | undefined;
+};
+
+export type PostApiSandboxAgentRunDirective = {
+  next: Array<PostApiSandboxAgentRunNext>;
+};
+
 /**
  * Result of a one-shot run
  */
@@ -70,6 +83,48 @@ export function postApiSandboxAgentRunRequestToJSON(
   );
 }
 
+/** @internal */
+export const PostApiSandboxAgentRunCode$inboundSchema: z.ZodMiniEnum<
+  typeof PostApiSandboxAgentRunCode
+> = z.enum(PostApiSandboxAgentRunCode);
+
+/** @internal */
+export const PostApiSandboxAgentRunNext$inboundSchema: z.ZodMiniType<
+  PostApiSandboxAgentRunNext,
+  unknown
+> = z.object({
+  command: types.optional(types.string()),
+  url: types.optional(types.string()),
+});
+
+export function postApiSandboxAgentRunNextFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxAgentRunNext, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxAgentRunNext$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxAgentRunNext' from JSON`,
+  );
+}
+
+/** @internal */
+export const PostApiSandboxAgentRunDirective$inboundSchema: z.ZodMiniType<
+  PostApiSandboxAgentRunDirective,
+  unknown
+> = z.object({
+  next: z.array(z.lazy(() => PostApiSandboxAgentRunNext$inboundSchema)),
+});
+
+export function postApiSandboxAgentRunDirectiveFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxAgentRunDirective, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxAgentRunDirective$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxAgentRunDirective' from JSON`,
+  );
+}
+
 /** @internal */
 export const PostApiSandboxAgentRunResponse$inboundSchema: z.ZodMiniType<
   PostApiSandboxAgentRunResponse,

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

@@ -14,7 +14,20 @@ export type PostApiSandboxByIdSessionRequest = {
   /**
    * Start a Helix session inside a running sandbox
    */
-  body: models.ModeArmArgs;
+  body: models.ModeArmModel;
+};
+
+export enum PostApiSandboxByIdSessionCode {
+  NoProviderConfigured = "NO_PROVIDER_CONFIGURED",
+}
+
+export type PostApiSandboxByIdSessionNext = {
+  command?: string | undefined;
+  url?: string | undefined;
+};
+
+export type PostApiSandboxByIdSessionDirective = {
+  next: Array<PostApiSandboxByIdSessionNext>;
 };
 
 /**
@@ -42,7 +55,7 @@ export type PostApiSandboxByIdSessionResponse = {
 /** @internal */
 export type PostApiSandboxByIdSessionRequest$Outbound = {
   id: string;
-  body: models.ModeArmArgs$Outbound;
+  body: models.ModeArmModel$Outbound;
 };
 
 /** @internal */
@@ -51,7 +64,7 @@ export const PostApiSandboxByIdSessionRequest$outboundSchema: z.ZodMiniType<
   PostApiSandboxByIdSessionRequest
 > = z.object({
   id: z.string(),
-  body: models.ModeArmArgs$outboundSchema,
+  body: models.ModeArmModel$outboundSchema,
 });
 
 export function postApiSandboxByIdSessionRequestToJSON(
@@ -64,6 +77,49 @@ export function postApiSandboxByIdSessionRequestToJSON(
   );
 }
 
+/** @internal */
+export const PostApiSandboxByIdSessionCode$inboundSchema: z.ZodMiniEnum<
+  typeof PostApiSandboxByIdSessionCode
+> = z.enum(PostApiSandboxByIdSessionCode);
+
+/** @internal */
+export const PostApiSandboxByIdSessionNext$inboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdSessionNext,
+  unknown
+> = z.object({
+  command: types.optional(types.string()),
+  url: types.optional(types.string()),
+});
+
+export function postApiSandboxByIdSessionNextFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxByIdSessionNext, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxByIdSessionNext$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxByIdSessionNext' from JSON`,
+  );
+}
+
+/** @internal */
+export const PostApiSandboxByIdSessionDirective$inboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdSessionDirective,
+  unknown
+> = z.object({
+  next: z.array(z.lazy(() => PostApiSandboxByIdSessionNext$inboundSchema)),
+});
+
+export function postApiSandboxByIdSessionDirectiveFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxByIdSessionDirective, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PostApiSandboxByIdSessionDirective$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxByIdSessionDirective' from JSON`,
+  );
+}
+
 /** @internal */
 export const PostApiSandboxByIdSessionResponse$inboundSchema: z.ZodMiniType<
   PostApiSandboxByIdSessionResponse,