@mutagent/sdk 0.4.0 → 0.4.2

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

@@ -0,0 +1,123 @@
+/*
+ * 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 PostApiSandboxAgentRunNoProviderConfiguredErrorData = {
+  error: string;
+  message: string;
+  code: operations.PostApiSandboxAgentRunCode;
+  workspaceId: string;
+  provider?: string | undefined;
+  directive: operations.PostApiSandboxAgentRunDirective;
+};
+
+/**
+ * Response for status 428
+ */
+export class PostApiSandboxAgentRunNoProviderConfiguredError
+  extends MutagentError
+{
+  error: string;
+  code: operations.PostApiSandboxAgentRunCode;
+  workspaceId: string;
+  provider?: string | undefined;
+  directive: operations.PostApiSandboxAgentRunDirective;
+
+  /** The original data that was passed to this error instance. */
+  data$: PostApiSandboxAgentRunNoProviderConfiguredErrorData;
+
+  constructor(
+    err: PostApiSandboxAgentRunNoProviderConfiguredErrorData,
+    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 = "PostApiSandboxAgentRunNoProviderConfiguredError";
+  }
+}
+
+/**
+ * Response for status 422
+ */
+export type PostApiSandboxAgentRunUnprocessableEntity =
+  | ErrorMessageModel
+  | ErrorMessage2;
+
+/** @internal */
+export const PostApiSandboxAgentRunNoProviderConfiguredError$inboundSchema:
+  z.ZodMiniType<PostApiSandboxAgentRunNoProviderConfiguredError, unknown> = z
+    .pipe(
+      z.object({
+        error: types.string(),
+        message: types.string(),
+        code: operations.PostApiSandboxAgentRunCode$inboundSchema,
+        workspaceId: types.string(),
+        provider: types.optional(types.string()),
+        _directive: z.lazy(() =>
+          operations.PostApiSandboxAgentRunDirective$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 PostApiSandboxAgentRunNoProviderConfiguredError(remapped, {
+          request: v.request$,
+          response: v.response$,
+          body: v.body$,
+        });
+      }),
+    );
+
+/** @internal */
+export const PostApiSandboxAgentRunUnprocessableEntity$inboundSchema:
+  z.ZodMiniType<PostApiSandboxAgentRunUnprocessableEntity, unknown> =
+    smartUnion([ErrorMessageModel$inboundSchema, ErrorMessage2$inboundSchema]);
+
+export function postApiSandboxAgentRunUnprocessableEntityFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  PostApiSandboxAgentRunUnprocessableEntity,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PostApiSandboxAgentRunUnprocessableEntity$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'PostApiSandboxAgentRunUnprocessableEntity' from JSON`,
+  );
+}

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/errors/workspace-model-listing-error.ts

@@ -0,0 +1,82 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as types from "../../types/primitives.js";
+import * as models from "../index.js";
+import { MutagentError } from "./mutagent-error.js";
+
+/**
+ * A provider configuration's models, with this workspace's enablement applied
+ */
+export type WorkspaceModelListingErrorData = {
+  models: Array<models.Model>;
+  /**
+   * 'live' — listed from the provider just now; 'stored' — the persisted allow-list
+   */
+  source?: models.SourceOpen | undefined;
+  /**
+   * True when the live listing failed and the stored allow-list is being shown
+   */
+  degraded: boolean;
+  /**
+   * Why the listing degraded, or a provider-stated caveat. Null when neither.
+   */
+  message: string | null;
+};
+
+/**
+ * A provider configuration's models, with this workspace's enablement applied
+ */
+export class WorkspaceModelListingError extends MutagentError {
+  models: Array<models.Model>;
+  /**
+   * 'live' — listed from the provider just now; 'stored' — the persisted allow-list
+   */
+  source?: models.SourceOpen | undefined;
+  /**
+   * True when the live listing failed and the stored allow-list is being shown
+   */
+  degraded: boolean;
+
+  /** The original data that was passed to this error instance. */
+  data$: WorkspaceModelListingErrorData;
+
+  constructor(
+    err: WorkspaceModelListingErrorData,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
+    const message = err.message || `API error occurred: ${JSON.stringify(err)}`;
+    super(message, httpMeta);
+    this.data$ = err;
+    this.models = err.models;
+    if (err.source != null) this.source = err.source;
+    this.degraded = err.degraded;
+
+    this.name = "WorkspaceModelListingError";
+  }
+}
+
+/** @internal */
+export const WorkspaceModelListingError$inboundSchema: z.ZodMiniType<
+  WorkspaceModelListingError,
+  unknown
+> = z.pipe(
+  z.object({
+    models: z.array(models.Model$inboundSchema),
+    source: z._default(models.Source$inboundSchema, models.Source.Live),
+    degraded: types.boolean(),
+    message: types.nullable(types.string()),
+    request$: z.custom<Request>(x => x instanceof Request),
+    response$: z.custom<Response>(x => x instanceof Response),
+    body$: z.string(),
+  }),
+  z.transform((v) => {
+    return new WorkspaceModelListingError(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
+  }),
+);

package/src/models/index.ts

@@ -5,37 +5,55 @@
 export * from "./agent-list.js";
 export * from "./agent-success-response.js";
 export * from "./agent.js";
+export * from "./array-of-trace-id-session-id-name.js";
+export * from "./command-cwd-timeout-ms.js";
 export * from "./current-password-new-password.js";
+export * from "./definition-provider.js";
+export * from "./definition-run-id.js";
 export * from "./email-role-expires-in-days.js";
 export * from "./id-display-name-family.js";
 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 "./name-api-key-base-url.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";
+export * from "./name-image-arch.js";
 export * from "./name-provider-api-key.js";
 export * from "./name-slug-description.js";
 export * from "./name-slug-description2.js";
 export * from "./name-slug-description3.js";
 export * from "./name-slug-description4.js";
 export * from "./name-slug-description5.js";
+export * from "./name-vars-secrets.js";
 export * from "./org-member-count-or-error-union.js";
 export * from "./org-success-or-error-union.js";
 export * from "./organization-list-or-error-union.js";
 export * from "./organization-or-error-union.js";
+export * from "./preset-timeout-ms-keep.js";
+export * from "./preset-timeout-ms-keep2.js";
 export * from "./provider-config.js";
 export * from "./provider-configs-list.js";
 export * from "./provider-success.js";
 export * from "./schemadefaul.js";
-export * from "./schemadefaul3.js";
-export * from "./schemanullab2.js";
+export * from "./schemadefaul10.js";
+export * from "./schemadefaul12.js";
+export * from "./schemadefaul5.js";
+export * from "./schemadefaul6.js";
+export * from "./schemadefaul7.js";
+export * from "./schemadefaul8.js";
 export * from "./security.js";
+export * from "./session-id-line.js";
+export * from "./session-id-signal.js";
+export * from "./snapshot-id-definition-partial.js";
 export * from "./success-message.js";
 export * from "./test-connection-result.js";
 export * from "./user-id-role-status.js";
 export * from "./user-id-role.js";
+export * from "./vars-secrets.js";
+export * from "./workspace-model-listing.js";
 export * from "./workspace.js";
 export * from "./workspaces-list.js";
 export * from "./ws-success.js";

package/src/models/mode-arm-model.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import {
+  Schemadefaul7,
+  Schemadefaul7$outboundSchema,
+  Schemadefaul7Open,
+} from "./schemadefaul7.js";
+import {
+  Schemadefaul8,
+  Schemadefaul8$outboundSchema,
+  Schemadefaul8Open,
+} from "./schemadefaul8.js";
+
+/**
+ * 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;
+};
+
+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`.
+   */
+  mode?: Schemadefaul7Open | undefined;
+  /**
+   * 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.
+   */
+  args?: Array<string> | 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;
+};
+
+/** @internal */
+export type ModeArmModelCapture$Outbound = {
+  workspace?: boolean | undefined;
+};
+
+/** @internal */
+export const ModeArmModelCapture$outboundSchema: z.ZodMiniType<
+  ModeArmModelCapture$Outbound,
+  ModeArmModelCapture
+> = z.object({
+  workspace: z.optional(z.boolean()),
+});
+
+export function modeArmModelCaptureToJSON(
+  modeArmModelCapture: ModeArmModelCapture,
+): string {
+  return JSON.stringify(
+    ModeArmModelCapture$outboundSchema.parse(modeArmModelCapture),
+  );
+}
+
+/** @internal */
+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?: ModeArmModelCapture$Outbound | undefined;
+};
+
+/** @internal */
+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(() => ModeArmModelCapture$outboundSchema)),
+});
+
+export function modeArmModelToJSON(modeArmModel: ModeArmModel): string {
+  return JSON.stringify(ModeArmModel$outboundSchema.parse(modeArmModel));
+}

package/src/models/name-api-key-credential-fields.ts

@@ -0,0 +1,100 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import {
+  IdDisplayNameFamily,
+  IdDisplayNameFamily$Outbound,
+  IdDisplayNameFamily$outboundSchema,
+} from "./id-display-name-family.js";
+
+export type NameApiKeyCredentialFields = {
+  /**
+   * Updated display name
+   */
+  name?: string | undefined;
+  /**
+   * New API key (will be re-encrypted)
+   */
+  apiKey?: string | undefined;
+  /**
+   * Per-entry credential material to merge over the stored values, keyed by the catalog wire names for this provider. Keys you omit are left untouched; an explicit null clears the field, and is refused if the catalog declares it required. The merged result is validated as a whole, so a patch that leaves the configuration incomplete is refused even when every value it carries is individually valid. A secret sent here is extracted and encrypted, never stored in the clear.
+   */
+  credentialFields?: { [k: string]: string | null } | undefined;
+  /**
+   * Updated base URL (null to clear)
+   */
+  baseUrl?: string | null | undefined;
+  /**
+   * Updated model mappings (null to clear)
+   */
+  modelOverrides?: { [k: string]: string } | null | undefined;
+  /**
+   * Activate or deactivate this config
+   */
+  isActive?: boolean | undefined;
+  /**
+   * Set or unset as default provider
+   */
+  isDefault?: boolean | undefined;
+  /**
+   * Which hosted model family a gateway configuration targets (null to clear). Named for the column it populates.
+   */
+  hostedFamily?: string | null | undefined;
+  /**
+   * Updated declared models (null to clear)
+   */
+  supportedModels?: Array<IdDisplayNameFamily> | null | undefined;
+  /**
+   * Updated API version (null to clear)
+   */
+  apiVersion?: string | null | undefined;
+  /**
+   * Updated metadata (null to clear)
+   */
+  metadata?: { [k: string]: any } | null | undefined;
+};
+
+/** @internal */
+export type NameApiKeyCredentialFields$Outbound = {
+  name?: string | undefined;
+  apiKey?: string | undefined;
+  credentialFields?: { [k: string]: string | null } | undefined;
+  baseUrl?: string | null | undefined;
+  modelOverrides?: { [k: string]: string } | null | undefined;
+  isActive?: boolean | undefined;
+  isDefault?: boolean | undefined;
+  hostedFamily?: string | null | undefined;
+  supportedModels?: Array<IdDisplayNameFamily$Outbound> | null | undefined;
+  apiVersion?: string | null | undefined;
+  metadata?: { [k: string]: any } | null | undefined;
+};
+
+/** @internal */
+export const NameApiKeyCredentialFields$outboundSchema: z.ZodMiniType<
+  NameApiKeyCredentialFields$Outbound,
+  NameApiKeyCredentialFields
+> = z.object({
+  name: z.optional(z.string()),
+  apiKey: z.optional(z.string()),
+  credentialFields: z.optional(z.record(z.string(), z.nullable(z.string()))),
+  baseUrl: z.optional(z.nullable(z.string())),
+  modelOverrides: z.optional(z.nullable(z.record(z.string(), z.string()))),
+  isActive: z.optional(z.boolean()),
+  isDefault: z.optional(z.boolean()),
+  hostedFamily: z.optional(z.nullable(z.string())),
+  supportedModels: z.optional(
+    z.nullable(z.array(IdDisplayNameFamily$outboundSchema)),
+  ),
+  apiVersion: z.optional(z.nullable(z.string())),
+  metadata: z.optional(z.nullable(z.record(z.string(), z.any()))),
+});
+
+export function nameApiKeyCredentialFieldsToJSON(
+  nameApiKeyCredentialFields: NameApiKeyCredentialFields,
+): string {
+  return JSON.stringify(
+    NameApiKeyCredentialFields$outboundSchema.parse(nameApiKeyCredentialFields),
+  );
+}