@mutagent/sdk 0.4.0 → 0.4.1

package/src/models/name-description-system-prompt.ts

@@ -4,8 +4,6 @@
 
 import * as z from "zod/v4-mini";
 
-export type NameDescriptionSystemPromptMetadata = {};
-
 export type NameDescriptionSystemPrompt = {
   name?: string | undefined;
   description?: string | undefined;
@@ -17,29 +15,10 @@ export type NameDescriptionSystemPrompt = {
   disallowedTools?: Array<string> | undefined;
   status?: string | undefined;
   isPublic?: boolean | undefined;
-  metadata?: NameDescriptionSystemPromptMetadata | undefined;
+  metadata?: { [k: string]: any } | undefined;
   tags?: Array<string> | undefined;
 };
 
-/** @internal */
-export type NameDescriptionSystemPromptMetadata$Outbound = {};
-
-/** @internal */
-export const NameDescriptionSystemPromptMetadata$outboundSchema: z.ZodMiniType<
-  NameDescriptionSystemPromptMetadata$Outbound,
-  NameDescriptionSystemPromptMetadata
-> = z.object({});
-
-export function nameDescriptionSystemPromptMetadataToJSON(
-  nameDescriptionSystemPromptMetadata: NameDescriptionSystemPromptMetadata,
-): string {
-  return JSON.stringify(
-    NameDescriptionSystemPromptMetadata$outboundSchema.parse(
-      nameDescriptionSystemPromptMetadata,
-    ),
-  );
-}
-
 /** @internal */
 export type NameDescriptionSystemPrompt$Outbound = {
   name?: string | undefined;
@@ -52,7 +31,7 @@ export type NameDescriptionSystemPrompt$Outbound = {
   disallowedTools?: Array<string> | undefined;
   status?: string | undefined;
   isPublic?: boolean | undefined;
-  metadata?: NameDescriptionSystemPromptMetadata$Outbound | undefined;
+  metadata?: { [k: string]: any } | undefined;
   tags?: Array<string> | undefined;
 };
 
@@ -71,9 +50,7 @@ export const NameDescriptionSystemPrompt$outboundSchema: z.ZodMiniType<
   disallowedTools: z.optional(z.array(z.string())),
   status: z.optional(z.string()),
   isPublic: z.optional(z.boolean()),
-  metadata: z.optional(
-    z.lazy(() => NameDescriptionSystemPromptMetadata$outboundSchema),
-  ),
+  metadata: z.optional(z.record(z.string(), z.any())),
   tags: z.optional(z.array(z.string())),
 });
 

package/src/models/name-image-arch.ts

@@ -0,0 +1,309 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+/**
+ * CPU architecture the image was built for. Validated against the provider at preflight.
+ */
+export enum NameImageArchArch {
+  X8664 = "x86_64",
+  Arm64 = "arm64",
+}
+
+/**
+ * Requested resources. A provider that does not expose a given dial REJECTS a definition that sets it, at preflight — never a silent downgrade.
+ */
+export type NameImageArchResources = {
+  /**
+   * Requested vCPU count
+   */
+  vcpu?: number | undefined;
+  /**
+   * Requested memory in MB
+   */
+  memoryMb?: number | undefined;
+  /**
+   * Requested disk in MB
+   */
+  diskMb?: number | undefined;
+  /**
+   * Whether a GPU is required
+   */
+  gpu?: boolean | undefined;
+};
+
+/**
+ * Outbound policy. Defaults to deny — opening egress is explicit.
+ */
+export enum NameImageArchEgress {
+  Deny = "deny",
+  Allowlist = "allowlist",
+  Allow = "allow",
+}
+
+/**
+ * What this rule constrains
+ */
+export enum NameImageArchKind {
+  Port = "port",
+  Cidr = "cidr",
+  Domain = "domain",
+}
+
+/**
+ * A single outbound-access allowance
+ */
+export type NameImageArchAllow = {
+  /**
+   * What this rule constrains
+   */
+  kind?: NameImageArchKind | undefined;
+  /**
+   * Port, CIDR block, or domain
+   */
+  value: string;
+};
+
+/**
+ * Network policy for the sandbox
+ */
+export type NameImageArchNetwork = {
+  /**
+   * Outbound policy. Defaults to deny — opening egress is explicit.
+   */
+  egress?: NameImageArchEgress | undefined;
+  /**
+   * Allowances, when egress is "allowlist". Requires provider egressControl support.
+   */
+  allow?: Array<NameImageArchAllow> | undefined;
+};
+
+/**
+ * Whether the working directory is archived at every consistency point. `auto` (default) archives it whenever an object store exists; `never` records the leg as disabled in the checkpoint manifest, so a restore reports it as disabled rather than as an archive that failed to travel.
+ */
+export enum NameImageArchWorkspace {
+  Auto = "auto",
+  Never = "never",
+}
+
+/**
+ * Which legs continuous capture carries for sessions on this definition.
+ */
+export type NameImageArchCapture = {
+  /**
+   * Whether the working directory is archived at every consistency point. `auto` (default) archives it whenever an object store exists; `never` records the leg as disabled in the checkpoint manifest, so a restore reports it as disabled rather than as an archive that failed to travel.
+   */
+  workspace?: NameImageArchWorkspace | undefined;
+  /**
+   * Whether `$HOME/.mutagent` (memory, plans, extension state; never the session transcript) is archived. Defaults to true.
+   */
+  home?: boolean | undefined;
+};
+
+export type NameImageArch = {
+  /**
+   * Human-readable definition name
+   */
+  name: string;
+  /**
+   * Image reference (repository:tag or @digest). The image content is a separate artifact.
+   */
+  image: string;
+  /**
+   * CPU architecture the image was built for. Validated against the provider at preflight.
+   */
+  arch?: NameImageArchArch | undefined;
+  /**
+   * Requested resources. A provider that does not expose a given dial REJECTS a definition that sets it, at preflight — never a silent downgrade.
+   */
+  resources?: NameImageArchResources | undefined;
+  /**
+   * Network policy for the sandbox
+   */
+  network?: NameImageArchNetwork | undefined;
+  /**
+   * Name of the Environment (secrets + variables) to load at spawn. Distinct from `provider`.
+   */
+  environment?: string | undefined;
+  /**
+   * Provider registry key. When omitted the backend default applies.
+   */
+  provider?: string | undefined;
+  /**
+   * Requested max lifetime. Rejected at preflight if it exceeds the provider ceiling.
+   */
+  timeoutMs?: number | undefined;
+  /**
+   * Working directory inside the sandbox
+   */
+  workdir?: string | undefined;
+  /**
+   * Non-secret environment variables. Secret material must come from an Environment.
+   */
+  vars?: { [k: string]: string } | undefined;
+  /**
+   * Which legs continuous capture carries for sessions on this definition.
+   */
+  capture?: NameImageArchCapture | undefined;
+};
+
+/** @internal */
+export const NameImageArchArch$outboundSchema: z.ZodMiniEnum<
+  typeof NameImageArchArch
+> = z.enum(NameImageArchArch);
+
+/** @internal */
+export type NameImageArchResources$Outbound = {
+  vcpu?: number | undefined;
+  memoryMb?: number | undefined;
+  diskMb?: number | undefined;
+  gpu?: boolean | undefined;
+};
+
+/** @internal */
+export const NameImageArchResources$outboundSchema: z.ZodMiniType<
+  NameImageArchResources$Outbound,
+  NameImageArchResources
+> = z.object({
+  vcpu: z.optional(z.number()),
+  memoryMb: z.optional(z.number()),
+  diskMb: z.optional(z.number()),
+  gpu: z.optional(z.boolean()),
+});
+
+export function nameImageArchResourcesToJSON(
+  nameImageArchResources: NameImageArchResources,
+): string {
+  return JSON.stringify(
+    NameImageArchResources$outboundSchema.parse(nameImageArchResources),
+  );
+}
+
+/** @internal */
+export const NameImageArchEgress$outboundSchema: z.ZodMiniEnum<
+  typeof NameImageArchEgress
+> = z.enum(NameImageArchEgress);
+
+/** @internal */
+export const NameImageArchKind$outboundSchema: z.ZodMiniEnum<
+  typeof NameImageArchKind
+> = z.enum(NameImageArchKind);
+
+/** @internal */
+export type NameImageArchAllow$Outbound = {
+  kind: string;
+  value: string;
+};
+
+/** @internal */
+export const NameImageArchAllow$outboundSchema: z.ZodMiniType<
+  NameImageArchAllow$Outbound,
+  NameImageArchAllow
+> = z.object({
+  kind: z._default(NameImageArchKind$outboundSchema, NameImageArchKind.Port),
+  value: z.string(),
+});
+
+export function nameImageArchAllowToJSON(
+  nameImageArchAllow: NameImageArchAllow,
+): string {
+  return JSON.stringify(
+    NameImageArchAllow$outboundSchema.parse(nameImageArchAllow),
+  );
+}
+
+/** @internal */
+export type NameImageArchNetwork$Outbound = {
+  egress: string;
+  allow?: Array<NameImageArchAllow$Outbound> | undefined;
+};
+
+/** @internal */
+export const NameImageArchNetwork$outboundSchema: z.ZodMiniType<
+  NameImageArchNetwork$Outbound,
+  NameImageArchNetwork
+> = z.object({
+  egress: z._default(
+    NameImageArchEgress$outboundSchema,
+    NameImageArchEgress.Deny,
+  ),
+  allow: z.optional(z.array(z.lazy(() => NameImageArchAllow$outboundSchema))),
+});
+
+export function nameImageArchNetworkToJSON(
+  nameImageArchNetwork: NameImageArchNetwork,
+): string {
+  return JSON.stringify(
+    NameImageArchNetwork$outboundSchema.parse(nameImageArchNetwork),
+  );
+}
+
+/** @internal */
+export const NameImageArchWorkspace$outboundSchema: z.ZodMiniEnum<
+  typeof NameImageArchWorkspace
+> = z.enum(NameImageArchWorkspace);
+
+/** @internal */
+export type NameImageArchCapture$Outbound = {
+  workspace: string;
+  home?: boolean | undefined;
+};
+
+/** @internal */
+export const NameImageArchCapture$outboundSchema: z.ZodMiniType<
+  NameImageArchCapture$Outbound,
+  NameImageArchCapture
+> = z.object({
+  workspace: z._default(
+    NameImageArchWorkspace$outboundSchema,
+    NameImageArchWorkspace.Auto,
+  ),
+  home: z.optional(z.boolean()),
+});
+
+export function nameImageArchCaptureToJSON(
+  nameImageArchCapture: NameImageArchCapture,
+): string {
+  return JSON.stringify(
+    NameImageArchCapture$outboundSchema.parse(nameImageArchCapture),
+  );
+}
+
+/** @internal */
+export type NameImageArch$Outbound = {
+  name: string;
+  image: string;
+  arch: string;
+  resources?: NameImageArchResources$Outbound | undefined;
+  network?: NameImageArchNetwork$Outbound | undefined;
+  environment?: string | undefined;
+  provider?: string | undefined;
+  timeoutMs?: number | undefined;
+  workdir?: string | undefined;
+  vars?: { [k: string]: string } | undefined;
+  capture?: NameImageArchCapture$Outbound | undefined;
+};
+
+/** @internal */
+export const NameImageArch$outboundSchema: z.ZodMiniType<
+  NameImageArch$Outbound,
+  NameImageArch
+> = z.object({
+  name: z.string(),
+  image: z.string(),
+  arch: z._default(NameImageArchArch$outboundSchema, NameImageArchArch.X8664),
+  resources: z.optional(z.lazy(() => NameImageArchResources$outboundSchema)),
+  network: z.optional(z.lazy(() => NameImageArchNetwork$outboundSchema)),
+  environment: z.optional(z.string()),
+  provider: z.optional(z.string()),
+  timeoutMs: z.optional(z.number()),
+  workdir: z.optional(z.string()),
+  vars: z.optional(z.record(z.string(), z.string())),
+  capture: z.optional(z.lazy(() => NameImageArchCapture$outboundSchema)),
+});
+
+export function nameImageArchToJSON(nameImageArch: NameImageArch): string {
+  return JSON.stringify(NameImageArch$outboundSchema.parse(nameImageArch));
+}

package/src/models/name-provider-api-key.ts

@@ -5,43 +5,22 @@
 import * as z from "zod/v4-mini";
 
 /**
- * Provider type (openai, anthropic, google, azure, bedrock, xai, glm, moonshot, custom)
+ * Provider type (openai, anthropic, google, moonshot, glm, deepseek, xai, azure, vertex, bedrock, custom)
  */
 export enum Provider {
   Openai = "openai",
   Anthropic = "anthropic",
   Google = "google",
+  Moonshot = "moonshot",
+  Glm = "glm",
+  Deepseek = "deepseek",
+  Xai = "xai",
   Azure = "azure",
+  Vertex = "vertex",
   Bedrock = "bedrock",
-  Xai = "xai",
-  Glm = "glm",
-  Moonshot = "moonshot",
   Custom = "custom",
 }
 
-/**
- * Scope specification - exactly one must be provided
- */
-export type Scope = {
-  /**
-   * Organization ID for org-level config
-   */
-  organizationId?: string | undefined;
-  /**
-   * Workspace ID for workspace-level config
-   */
-  workspaceId?: string | undefined;
-  /**
-   * User ID for personal config (UUID format)
-   */
-  userId?: string | undefined;
-};
-
-/**
- * Model name mappings (e.g., {"gpt-4": "custom-gpt-4"})
- */
-export type NameProviderApiKeyModelOverrides = {};
-
 export type NameProviderApiKeySupportedModel = {
   /**
    * Model identifier
@@ -65,28 +44,27 @@ export type NameProviderApiKeySupportedModel = {
   source?: string | undefined;
 };
 
-/**
- * Additional metadata
- */
-export type NameProviderApiKeyMetadata = {};
-
 export type NameProviderApiKey = {
   /**
    * Display name for this provider configuration
    */
   name: string;
   /**
-   * Provider type (openai, anthropic, google, azure, bedrock, xai, glm, moonshot, custom)
+   * Provider type (openai, anthropic, google, moonshot, glm, deepseek, xai, azure, vertex, bedrock, custom)
    */
   provider?: Provider | undefined;
   /**
-   * API key for the provider (will be encrypted)
+   * The entry's single secret, when sent in this top-level slot. OPTIONAL because the secret's wire name is per-entry — ten entries call it 'apiKey', Google Vertex calls it 'serviceAccountKey'. Send it here or as the correspondingly-named key in credentialFields.
+   */
+  apiKey?: string | undefined;
+  /**
+   * Per-entry credential material keyed by the catalog wire names for this provider. GET /providers/catalog declares which fields each entry accepts. The secret is extracted and encrypted; only the non-secret remainder is stored.
    */
-  apiKey: string;
+  credentialFields?: { [k: string]: string } | undefined;
   /**
-   * Scope specification - exactly one must be provided
+   * Which hosted model family a gateway configuration targets. Required for gateways hosting more than one (Azure, Google Vertex); derived for single-family gateways (AWS Bedrock); not accepted for direct providers.
    */
-  scope: Scope;
+  hostedFamily?: string | undefined;
   /**
    * Custom base URL for the provider API
    */
@@ -94,15 +72,11 @@ export type NameProviderApiKey = {
   /**
    * Model name mappings (e.g., {"gpt-4": "custom-gpt-4"})
    */
-  modelOverrides?: NameProviderApiKeyModelOverrides | undefined;
+  modelOverrides?: { [k: string]: string } | undefined;
   /**
    * Set as default provider for this scope
    */
   isDefault?: boolean | undefined;
-  /**
-   * Azure/custom wire-format family: 'openai' | 'anthropic' | 'inference'
-   */
-  family?: string | undefined;
   /**
    * Declared models this provider serves
    */
@@ -114,7 +88,7 @@ export type NameProviderApiKey = {
   /**
    * Additional metadata
    */
-  metadata?: NameProviderApiKeyMetadata | undefined;
+  metadata?: { [k: string]: any } | undefined;
 };
 
 /** @internal */
@@ -122,44 +96,6 @@ export const Provider$outboundSchema: z.ZodMiniEnum<typeof Provider> = z.enum(
   Provider,
 );
 
-/** @internal */
-export type Scope$Outbound = {
-  organizationId?: string | undefined;
-  workspaceId?: string | undefined;
-  userId?: string | undefined;
-};
-
-/** @internal */
-export const Scope$outboundSchema: z.ZodMiniType<Scope$Outbound, Scope> = z
-  .object({
-    organizationId: z.optional(z.string()),
-    workspaceId: z.optional(z.string()),
-    userId: z.optional(z.string()),
-  });
-
-export function scopeToJSON(scope: Scope): string {
-  return JSON.stringify(Scope$outboundSchema.parse(scope));
-}
-
-/** @internal */
-export type NameProviderApiKeyModelOverrides$Outbound = {};
-
-/** @internal */
-export const NameProviderApiKeyModelOverrides$outboundSchema: z.ZodMiniType<
-  NameProviderApiKeyModelOverrides$Outbound,
-  NameProviderApiKeyModelOverrides
-> = z.object({});
-
-export function nameProviderApiKeyModelOverridesToJSON(
-  nameProviderApiKeyModelOverrides: NameProviderApiKeyModelOverrides,
-): string {
-  return JSON.stringify(
-    NameProviderApiKeyModelOverrides$outboundSchema.parse(
-      nameProviderApiKeyModelOverrides,
-    ),
-  );
-}
-
 /** @internal */
 export type NameProviderApiKeySupportedModel$Outbound = {
   id: string;
@@ -191,38 +127,21 @@ export function nameProviderApiKeySupportedModelToJSON(
   );
 }
 
-/** @internal */
-export type NameProviderApiKeyMetadata$Outbound = {};
-
-/** @internal */
-export const NameProviderApiKeyMetadata$outboundSchema: z.ZodMiniType<
-  NameProviderApiKeyMetadata$Outbound,
-  NameProviderApiKeyMetadata
-> = z.object({});
-
-export function nameProviderApiKeyMetadataToJSON(
-  nameProviderApiKeyMetadata: NameProviderApiKeyMetadata,
-): string {
-  return JSON.stringify(
-    NameProviderApiKeyMetadata$outboundSchema.parse(nameProviderApiKeyMetadata),
-  );
-}
-
 /** @internal */
 export type NameProviderApiKey$Outbound = {
   name: string;
   provider: string;
-  apiKey: string;
-  scope: Scope$Outbound;
+  apiKey?: string | undefined;
+  credentialFields?: { [k: string]: string } | undefined;
+  hostedFamily?: string | undefined;
   baseUrl?: string | undefined;
-  modelOverrides?: NameProviderApiKeyModelOverrides$Outbound | undefined;
+  modelOverrides?: { [k: string]: string } | undefined;
   isDefault: boolean;
-  family?: string | undefined;
   supportedModels?:
     | Array<NameProviderApiKeySupportedModel$Outbound>
     | undefined;
   apiVersion?: string | undefined;
-  metadata?: NameProviderApiKeyMetadata$Outbound | undefined;
+  metadata?: { [k: string]: any } | undefined;
 };
 
 /** @internal */
@@ -232,19 +151,17 @@ export const NameProviderApiKey$outboundSchema: z.ZodMiniType<
 > = z.object({
   name: z.string(),
   provider: z._default(Provider$outboundSchema, Provider.Openai),
-  apiKey: z.string(),
-  scope: z.lazy(() => Scope$outboundSchema),
+  apiKey: z.optional(z.string()),
+  credentialFields: z.optional(z.record(z.string(), z.string())),
+  hostedFamily: z.optional(z.string()),
   baseUrl: z.optional(z.string()),
-  modelOverrides: z.optional(
-    z.lazy(() => NameProviderApiKeyModelOverrides$outboundSchema),
-  ),
+  modelOverrides: z.optional(z.record(z.string(), z.string())),
   isDefault: z._default(z.boolean(), false),
-  family: z.optional(z.string()),
   supportedModels: z.optional(
     z.array(z.lazy(() => NameProviderApiKeySupportedModel$outboundSchema)),
   ),
   apiVersion: z.optional(z.string()),
-  metadata: z.optional(z.lazy(() => NameProviderApiKeyMetadata$outboundSchema)),
+  metadata: z.optional(z.record(z.string(), z.any())),
 });
 
 export function nameProviderApiKeyToJSON(

package/src/models/name-slug-description.ts

@@ -4,8 +4,6 @@
 
 import * as z from "zod/v4-mini";
 
-export type NameSlugDescriptionMetadata = {};
-
 export type NameSlugDescription = {
   name: string;
   /**
@@ -21,30 +19,11 @@ export type NameSlugDescription = {
   disallowedTools?: Array<string> | undefined;
   status?: string | undefined;
   isPublic?: boolean | undefined;
-  metadata?: NameSlugDescriptionMetadata | undefined;
+  metadata?: { [k: string]: any } | undefined;
   tags?: Array<string> | undefined;
   createdBy?: string | undefined;
 };
 
-/** @internal */
-export type NameSlugDescriptionMetadata$Outbound = {};
-
-/** @internal */
-export const NameSlugDescriptionMetadata$outboundSchema: z.ZodMiniType<
-  NameSlugDescriptionMetadata$Outbound,
-  NameSlugDescriptionMetadata
-> = z.object({});
-
-export function nameSlugDescriptionMetadataToJSON(
-  nameSlugDescriptionMetadata: NameSlugDescriptionMetadata,
-): string {
-  return JSON.stringify(
-    NameSlugDescriptionMetadata$outboundSchema.parse(
-      nameSlugDescriptionMetadata,
-    ),
-  );
-}
-
 /** @internal */
 export type NameSlugDescription$Outbound = {
   name: string;
@@ -58,7 +37,7 @@ export type NameSlugDescription$Outbound = {
   disallowedTools?: Array<string> | undefined;
   status?: string | undefined;
   isPublic?: boolean | undefined;
-  metadata?: NameSlugDescriptionMetadata$Outbound | undefined;
+  metadata?: { [k: string]: any } | undefined;
   tags?: Array<string> | undefined;
   createdBy?: string | undefined;
 };
@@ -79,9 +58,7 @@ export const NameSlugDescription$outboundSchema: z.ZodMiniType<
   disallowedTools: z.optional(z.array(z.string())),
   status: z.optional(z.string()),
   isPublic: z.optional(z.boolean()),
-  metadata: z.optional(
-    z.lazy(() => NameSlugDescriptionMetadata$outboundSchema),
-  ),
+  metadata: z.optional(z.record(z.string(), z.any())),
   tags: z.optional(z.array(z.string())),
   createdBy: z.optional(z.string()),
 });