@mutagent/sdk 0.4.0 → 0.4.1

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

@@ -0,0 +1,70 @@
+/*
+ * 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";
+import * as models from "../index.js";
+
+/**
+ * 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: models.SchemadefaulOpen;
+  status: models.Schemadefaul5Open;
+  definitionName: string;
+  environmentName?: string | undefined;
+  /**
+   * ISO timestamp
+   */
+  createdAt: string;
+};
+
+/** @internal */
+export const PostApiSandboxResponse$inboundSchema: z.ZodMiniType<
+  PostApiSandboxResponse,
+  unknown
+> = z.object({
+  id: types.string(),
+  generation: types.number(),
+  provider: types.string(),
+  arch: z._default(
+    models.Schemadefaul$inboundSchema,
+    models.Schemadefaul.X8664,
+  ),
+  status: z._default(
+    models.Schemadefaul5$inboundSchema,
+    models.Schemadefaul5.Pending,
+  ),
+  definitionName: types.string(),
+  environmentName: types.optional(types.string()),
+  createdAt: types.string(),
+});
+
+export function postApiSandboxResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxResponse' from JSON`,
+  );
+}

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/put-api-sandbox-helix-defaults.ts

@@ -0,0 +1,121 @@
+/*
+ * 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 PutApiSandboxHelixDefaultsRequest = {
+  /**
+   * Ordered `provider/model` ids from the workspace’s list; the first becomes the default. Every entry must be in the list (422 names the list otherwise). An empty array clears the defaults.
+   */
+  models: Array<string>;
+};
+
+export type PutApiSandboxHelixDefaultsModel = {
+  /**
+   * `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 PutApiSandboxHelixDefaultsResponse = {
+  workspaceId: string;
+  models: Array<PutApiSandboxHelixDefaultsModel>;
+  /**
+   * 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 type PutApiSandboxHelixDefaultsRequest$Outbound = {
+  models: Array<string>;
+};
+
+/** @internal */
+export const PutApiSandboxHelixDefaultsRequest$outboundSchema: z.ZodMiniType<
+  PutApiSandboxHelixDefaultsRequest$Outbound,
+  PutApiSandboxHelixDefaultsRequest
+> = z.object({
+  models: z.array(z.string()),
+});
+
+export function putApiSandboxHelixDefaultsRequestToJSON(
+  putApiSandboxHelixDefaultsRequest: PutApiSandboxHelixDefaultsRequest,
+): string {
+  return JSON.stringify(
+    PutApiSandboxHelixDefaultsRequest$outboundSchema.parse(
+      putApiSandboxHelixDefaultsRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const PutApiSandboxHelixDefaultsModel$inboundSchema: z.ZodMiniType<
+  PutApiSandboxHelixDefaultsModel,
+  unknown
+> = z.object({
+  id: types.string(),
+  provider: types.string(),
+  harnessProvider: types.string(),
+  model: types.string(),
+  displayName: types.string(),
+});
+
+export function putApiSandboxHelixDefaultsModelFromJSON(
+  jsonString: string,
+): SafeParseResult<PutApiSandboxHelixDefaultsModel, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PutApiSandboxHelixDefaultsModel$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PutApiSandboxHelixDefaultsModel' from JSON`,
+  );
+}
+
+/** @internal */
+export const PutApiSandboxHelixDefaultsResponse$inboundSchema: z.ZodMiniType<
+  PutApiSandboxHelixDefaultsResponse,
+  unknown
+> = z.object({
+  workspaceId: types.string(),
+  models: z.array(z.lazy(() => PutApiSandboxHelixDefaultsModel$inboundSchema)),
+  defaults: z.array(types.string()),
+  default: types.nullable(types.string()),
+  unmapped: z.array(types.string()),
+});
+
+export function putApiSandboxHelixDefaultsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PutApiSandboxHelixDefaultsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PutApiSandboxHelixDefaultsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PutApiSandboxHelixDefaultsResponse' from JSON`,
+  );
+}

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

@@ -9,7 +9,7 @@ export type UpdateOrganizationMemberRequestBody = {
   /**
    * The new role for the member
    */
-  role?: models.Schemadefaul | 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.Schemadefaul$outboundSchema,
-    models.Schemadefaul.Owner,
+    models.Schemadefaul10$outboundSchema,
+    models.Schemadefaul10.Owner,
   ),
 });
 

package/src/models/operations/update-provider.ts

@@ -10,13 +10,13 @@ export type UpdateProviderRequest = {
   /**
    * Fields to update on an existing provider config (all optional)
    */
-  body: models.NameApiKeyBaseUrl;
+  body: models.NameApiKeyCredentialFields;
 };
 
 /** @internal */
 export type UpdateProviderRequest$Outbound = {
   id: string;
-  body: models.NameApiKeyBaseUrl$Outbound;
+  body: models.NameApiKeyCredentialFields$Outbound;
 };
 
 /** @internal */
@@ -25,7 +25,7 @@ export const UpdateProviderRequest$outboundSchema: z.ZodMiniType<
   UpdateProviderRequest
 > = z.object({
   id: z.string(),
-  body: models.NameApiKeyBaseUrl$outboundSchema,
+  body: models.NameApiKeyCredentialFields$outboundSchema,
 });
 
 export function updateProviderRequestToJSON(

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

@@ -9,7 +9,7 @@ export type UpdateWorkspaceMemberRequestBody = {
   /**
    * The new role for the member
    */
-  role?: models.Schemadefaul3 | 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.Schemadefaul3$outboundSchema,
-    models.Schemadefaul3.Admin,
+    models.Schemadefaul12$outboundSchema,
+    models.Schemadefaul12.Admin,
   ),
 });
 

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

@@ -0,0 +1,66 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type PresetTimeoutMsKeep = {
+  /**
+   * 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;
+  /**
+   * 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.
+   */
+  command: Array<string>;
+  cwd?: string | undefined;
+};
+
+/** @internal */
+export type PresetTimeoutMsKeep$Outbound = {
+  preset?: string | undefined;
+  timeoutMs?: number | undefined;
+  keep?: boolean | undefined;
+  runId?: string | undefined;
+  environment?: string | undefined;
+  command: Array<string>;
+  cwd?: string | undefined;
+};
+
+/** @internal */
+export const PresetTimeoutMsKeep$outboundSchema: z.ZodMiniType<
+  PresetTimeoutMsKeep$Outbound,
+  PresetTimeoutMsKeep
+> = z.object({
+  preset: z.optional(z.string()),
+  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()),
+});
+
+export function presetTimeoutMsKeepToJSON(
+  presetTimeoutMsKeep: PresetTimeoutMsKeep,
+): string {
+  return JSON.stringify(
+    PresetTimeoutMsKeep$outboundSchema.parse(presetTimeoutMsKeep),
+  );
+}

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

@@ -0,0 +1,93 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type PresetTimeoutMsKeep2 = {
+  /**
+   * 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;
+  /**
+   * 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.
+   */
+  prompt?: string | undefined;
+  /**
+   * WHAT to do this turn — the task, passed as `-p`. A different prompt from `prompt`.
+   */
+  task: string;
+  /**
+   * 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;
+  /**
+   * Run the agent on the ASPS-Prime scaffold instead of the default ASPS one — leaner, code-first, no orchestrator persona. Forwarded to the binary as `--prime`.
+   */
+  prime?: boolean | undefined;
+  /**
+   * Harness argv, forwarded verbatim between the definition flags and `-p <task>`. Not interpreted here: the flag vocabulary belongs to the binary. Max 64 entries, 4 KiB each, no NUL.
+   */
+  args?: Array<string> | undefined;
+  /**
+   * Working directory for the turn inside the sandbox. Omitted takes the box default.
+   */
+  cwd?: string | undefined;
+};
+
+/** @internal */
+export type PresetTimeoutMsKeep2$Outbound = {
+  preset?: string | undefined;
+  timeoutMs?: number | undefined;
+  keep?: boolean | undefined;
+  runId?: string | undefined;
+  environment?: string | undefined;
+  prompt?: string | undefined;
+  task: string;
+  model?: string | undefined;
+  prime?: boolean | undefined;
+  args?: Array<string> | undefined;
+  cwd?: string | undefined;
+};
+
+/** @internal */
+export const PresetTimeoutMsKeep2$outboundSchema: z.ZodMiniType<
+  PresetTimeoutMsKeep2$Outbound,
+  PresetTimeoutMsKeep2
+> = z.object({
+  preset: z.optional(z.string()),
+  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(),
+  model: z.optional(z.string()),
+  prime: z.optional(z.boolean()),
+  args: z.optional(z.array(z.string())),
+  cwd: z.optional(z.string()),
+});
+
+export function presetTimeoutMsKeep2ToJSON(
+  presetTimeoutMsKeep2: PresetTimeoutMsKeep2,
+): string {
+  return JSON.stringify(
+    PresetTimeoutMsKeep2$outboundSchema.parse(presetTimeoutMsKeep2),
+  );
+}

package/src/models/provider-config.ts

@@ -8,11 +8,6 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
-/**
- * Model name mappings
- */
-export type ProviderConfigModelOverrides = {};
-
 export type ProviderConfigSupportedModel = {
   /**
    * Model identifier
@@ -24,11 +19,6 @@ export type ProviderConfigSupportedModel = {
   source?: string | undefined;
 };
 
-/**
- * Additional metadata
- */
-export type ProviderConfigMetadata = {};
-
 /**
  * Provider config object (API key is masked)
  */
@@ -50,17 +40,9 @@ export type ProviderConfig = {
    */
   apiKeyMasked: string;
   /**
-   * Organization ID if org-scoped
-   */
-  organizationId: string | null;
-  /**
-   * Workspace ID if workspace-scoped
+   * Workspace this configuration belongs to
    */
-  workspaceId: string | null;
-  /**
-   * User ID if personal
-   */
-  userId: string | null;
+  workspaceId: string;
   /**
    * Custom base URL
    */
@@ -68,19 +50,19 @@ export type ProviderConfig = {
   /**
    * Model name mappings
    */
-  modelOverrides: ProviderConfigModelOverrides | null;
+  modelOverrides: { [k: string]: string } | null;
   /**
    * Whether the config is active
    */
   isActive: boolean;
   /**
-   * Whether this is the default for its scope
+   * Whether this is the default for its workspace
    */
   isDefault: boolean;
   /**
-   * Azure/custom wire-format family: 'openai' | 'anthropic' | 'inference'
+   * Hosted model family for gateway entries: 'openai' | 'anthropic' | 'inference'; null for direct providers
    */
-  family: string | null;
+  hostedFamily: string | null;
   /**
    * Declared models this provider serves
    */
@@ -92,7 +74,11 @@ export type ProviderConfig = {
   /**
    * Additional metadata
    */
-  metadata: ProviderConfigMetadata | null;
+  metadata: { [k: string]: any } | null;
+  /**
+   * Non-secret per-entry credential material for this provider (region, projectId, deploymentName, etc.), keyed by the catalog wire names. Never carries the secret — that stays masked in apiKeyMasked. Exposed so an edit form can show what is actually stored: both create and update (#1388) persist non-column catalog fields here, and before this the column was write-only from the API's perspective, so an edited value vanished from the dialog on the next load even though the row held it.
+   */
+  credentialFields: { [k: string]: string } | null;
   /**
    * User ID of the creator
    */
@@ -107,22 +93,6 @@ export type ProviderConfig = {
   updatedAt: Date;
 };
 
-/** @internal */
-export const ProviderConfigModelOverrides$inboundSchema: z.ZodMiniType<
-  ProviderConfigModelOverrides,
-  unknown
-> = z.object({});
-
-export function providerConfigModelOverridesFromJSON(
-  jsonString: string,
-): SafeParseResult<ProviderConfigModelOverrides, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => ProviderConfigModelOverrides$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ProviderConfigModelOverrides' from JSON`,
-  );
-}
-
 /** @internal */
 export const ProviderConfigSupportedModel$inboundSchema: z.ZodMiniType<
   ProviderConfigSupportedModel,
@@ -145,22 +115,6 @@ export function providerConfigSupportedModelFromJSON(
   );
 }
 
-/** @internal */
-export const ProviderConfigMetadata$inboundSchema: z.ZodMiniType<
-  ProviderConfigMetadata,
-  unknown
-> = z.object({});
-
-export function providerConfigMetadataFromJSON(
-  jsonString: string,
-): SafeParseResult<ProviderConfigMetadata, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => ProviderConfigMetadata$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ProviderConfigMetadata' from JSON`,
-  );
-}
-
 /** @internal */
 export const ProviderConfig$inboundSchema: z.ZodMiniType<
   ProviderConfig,
@@ -170,21 +124,18 @@ export const ProviderConfig$inboundSchema: z.ZodMiniType<
   name: types.string(),
   provider: types.string(),
   apiKeyMasked: types.string(),
-  organizationId: types.nullable(types.string()),
-  workspaceId: types.nullable(types.string()),
-  userId: types.nullable(types.string()),
+  workspaceId: types.string(),
   baseUrl: types.nullable(types.string()),
-  modelOverrides: types.nullable(
-    z.lazy(() => ProviderConfigModelOverrides$inboundSchema),
-  ),
+  modelOverrides: types.nullable(z.record(z.string(), types.string())),
   isActive: types.boolean(),
   isDefault: types.boolean(),
-  family: types.nullable(types.string()),
+  hostedFamily: types.nullable(types.string()),
   supportedModels: types.nullable(
     z.array(z.lazy(() => ProviderConfigSupportedModel$inboundSchema)),
   ),
   apiVersion: types.nullable(types.string()),
-  metadata: types.nullable(z.lazy(() => ProviderConfigMetadata$inboundSchema)),
+  metadata: types.nullable(z.record(z.string(), z.any())),
+  credentialFields: types.nullable(z.record(z.string(), types.string())),
   createdBy: types.nullable(types.string()),
   createdAt: types.date(),
   updatedAt: types.date(),