@mutagent/sdk 0.3.36 → 0.3.38

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

@@ -0,0 +1,250 @@
+/*
+ * 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;
+};
+
+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;
+};
+
+/** @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 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;
+};
+
+/** @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())),
+});
+
+export function nameImageArchToJSON(nameImageArch: NameImageArch): string {
+  return JSON.stringify(NameImageArch$outboundSchema.parse(nameImageArch));
+}

package/src/models/operations/get-api-sandbox-by-id-sessions.ts

@@ -0,0 +1,61 @@
+/*
+ * 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 GetApiSandboxByIdSessionsRequest = {
+  id: string;
+};
+
+/**
+ * Helix session ids this sandbox is hosting
+ */
+export type GetApiSandboxByIdSessionsResponse = {
+  sessions: Array<string>;
+};
+
+/** @internal */
+export type GetApiSandboxByIdSessionsRequest$Outbound = {
+  id: string;
+};
+
+/** @internal */
+export const GetApiSandboxByIdSessionsRequest$outboundSchema: z.ZodMiniType<
+  GetApiSandboxByIdSessionsRequest$Outbound,
+  GetApiSandboxByIdSessionsRequest
+> = z.object({
+  id: z.string(),
+});
+
+export function getApiSandboxByIdSessionsRequestToJSON(
+  getApiSandboxByIdSessionsRequest: GetApiSandboxByIdSessionsRequest,
+): string {
+  return JSON.stringify(
+    GetApiSandboxByIdSessionsRequest$outboundSchema.parse(
+      getApiSandboxByIdSessionsRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const GetApiSandboxByIdSessionsResponse$inboundSchema: z.ZodMiniType<
+  GetApiSandboxByIdSessionsResponse,
+  unknown
+> = z.object({
+  sessions: z.array(types.string()),
+});
+
+export function getApiSandboxByIdSessionsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetApiSandboxByIdSessionsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetApiSandboxByIdSessionsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetApiSandboxByIdSessionsResponse' from JSON`,
+  );
+}

package/src/models/operations/get-api-sandbox-by-id-stream.ts

@@ -3,36 +3,24 @@
  */
 
 import * as z from "zod/v4-mini";
-import { smartUnion } from "../../types/smart-union.js";
-
-/**
- * Resume after this sequence number. Everything still buffered above it is replayed. If the buffer has already rolled past it, an `error` event says so — the gap is never skipped silently.
- */
-export type Since = string | number;
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
 
 export type GetApiSandboxByIdStreamRequest = {
   id: string;
-  /**
-   * Resume after this sequence number. Everything still buffered above it is replayed. If the buffer has already rolled past it, an `error` event says so — the gap is never skipped silently.
-   */
-  since?: string | number | undefined;
+  since?: number | undefined;
 };
 
-/** @internal */
-export type Since$Outbound = string | number;
-
-/** @internal */
-export const Since$outboundSchema: z.ZodMiniType<Since$Outbound, Since> =
-  smartUnion([z.string(), z.number()]);
-
-export function sinceToJSON(since: Since): string {
-  return JSON.stringify(Since$outboundSchema.parse(since));
-}
+/**
+ * Successful response
+ */
+export type GetApiSandboxByIdStreamResponse = {};
 
 /** @internal */
 export type GetApiSandboxByIdStreamRequest$Outbound = {
   id: string;
-  since?: string | number | undefined;
+  since?: number | undefined;
 };
 
 /** @internal */
@@ -41,7 +29,7 @@ export const GetApiSandboxByIdStreamRequest$outboundSchema: z.ZodMiniType<
   GetApiSandboxByIdStreamRequest
 > = z.object({
   id: z.string(),
-  since: z.optional(smartUnion([z.string(), z.number()])),
+  since: z.optional(z.number()),
 });
 
 export function getApiSandboxByIdStreamRequestToJSON(
@@ -53,3 +41,19 @@ export function getApiSandboxByIdStreamRequestToJSON(
     ),
   );
 }
+
+/** @internal */
+export const GetApiSandboxByIdStreamResponse$inboundSchema: z.ZodMiniType<
+  GetApiSandboxByIdStreamResponse,
+  unknown
+> = z.object({});
+
+export function getApiSandboxByIdStreamResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetApiSandboxByIdStreamResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetApiSandboxByIdStreamResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetApiSandboxByIdStreamResponse' from JSON`,
+  );
+}

package/src/models/operations/get-api-sandbox-by-id-traces.ts

@@ -11,13 +11,11 @@ export type GetApiSandboxByIdTracesRequest = {
   id: string;
 };
 
-export type Span = {};
-
 /**
  * Response for status 200
  */
 export type GetApiSandboxByIdTracesResponse = {
-  spans: Array<Span>;
+  spans: Array<{ [k: string]: any }>;
 };
 
 /** @internal */
@@ -43,25 +41,12 @@ export function getApiSandboxByIdTracesRequestToJSON(
   );
 }
 
-/** @internal */
-export const Span$inboundSchema: z.ZodMiniType<Span, unknown> = z.object({});
-
-export function spanFromJSON(
-  jsonString: string,
-): SafeParseResult<Span, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Span$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Span' from JSON`,
-  );
-}
-
 /** @internal */
 export const GetApiSandboxByIdTracesResponse$inboundSchema: z.ZodMiniType<
   GetApiSandboxByIdTracesResponse,
   unknown
 > = z.object({
-  spans: z.array(z.lazy(() => Span$inboundSchema)),
+  spans: z.array(z.record(z.string(), z.any())),
 });
 
 export function getApiSandboxByIdTracesResponseFromJSON(

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

@@ -4,33 +4,19 @@
 
 import * as z from "zod/v4-mini";
 import { safeParse } from "../../lib/schemas.js";
-import * as openEnums from "../../types/enums.js";
-import { OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdk-validation-error.js";
+import * as models from "../index.js";
 
 export type GetApiSandboxByIdRequest = {
   id: string;
 };
 
-export enum GetApiSandboxByIdStatus {
-  Pending = "pending",
-  Starting = "starting",
-  Running = "running",
-  Paused = "paused",
-  Stopping = "stopping",
-  Stopped = "stopped",
-  Failed = "failed",
-}
-export type GetApiSandboxByIdStatusOpen = OpenEnum<
-  typeof GetApiSandboxByIdStatus
->;
-
 /**
  * Response for status 200
  */
 export type GetApiSandboxByIdResponse = {
-  status: GetApiSandboxByIdStatusOpen;
+  status: models.Schemadefaul4Open;
 };
 
 /** @internal */
@@ -54,20 +40,14 @@ export function getApiSandboxByIdRequestToJSON(
   );
 }
 
-/** @internal */
-export const GetApiSandboxByIdStatus$inboundSchema: z.ZodMiniType<
-  GetApiSandboxByIdStatusOpen,
-  unknown
-> = openEnums.inboundSchema(GetApiSandboxByIdStatus);
-
 /** @internal */
 export const GetApiSandboxByIdResponse$inboundSchema: z.ZodMiniType<
   GetApiSandboxByIdResponse,
   unknown
 > = z.object({
   status: z._default(
-    GetApiSandboxByIdStatus$inboundSchema,
-    GetApiSandboxByIdStatus.Pending,
+    models.Schemadefaul4$inboundSchema,
+    models.Schemadefaul4.Pending,
   ),
 });
 

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

@@ -4,25 +4,10 @@
 
 import * as z from "zod/v4-mini";
 import { safeParse } from "../../lib/schemas.js";
-import * as openEnums from "../../types/enums.js";
-import { OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdk-validation-error.js";
-
-/**
- * CPU architecture the image was built for. Validated against the provider at preflight.
- */
-export enum GetApiSandboxPresetsArch {
-  X8664 = "x86_64",
-  Arm64 = "arm64",
-}
-/**
- * CPU architecture the image was built for. Validated against the provider at preflight.
- */
-export type GetApiSandboxPresetsArchOpen = OpenEnum<
-  typeof GetApiSandboxPresetsArch
->;
+import * as models from "../index.js";
 
 export type Preset = {
   name: string;
@@ -30,7 +15,7 @@ export type Preset = {
   /**
    * CPU architecture the image was built for. Validated against the provider at preflight.
    */
-  arch: GetApiSandboxPresetsArchOpen;
+  arch: models.SchemadefaulOpen;
   provider?: string | undefined;
   /**
    * Environment loaded at spawn, when the preset names one.
@@ -49,19 +34,13 @@ export type GetApiSandboxPresetsResponse = {
   default: string | null;
 };
 
-/** @internal */
-export const GetApiSandboxPresetsArch$inboundSchema: z.ZodMiniType<
-  GetApiSandboxPresetsArchOpen,
-  unknown
-> = openEnums.inboundSchema(GetApiSandboxPresetsArch);
-
 /** @internal */
 export const Preset$inboundSchema: z.ZodMiniType<Preset, unknown> = z.object({
   name: types.string(),
   description: types.string(),
   arch: z._default(
-    GetApiSandboxPresetsArch$inboundSchema,
-    GetApiSandboxPresetsArch.X8664,
+    models.Schemadefaul$inboundSchema,
+    models.Schemadefaul.X8664,
   ),
   provider: types.optional(types.string()),
   environment: types.optional(types.string()),

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

@@ -4,34 +4,10 @@
 
 import * as z from "zod/v4-mini";
 import { safeParse } from "../../lib/schemas.js";
-import * as openEnums from "../../types/enums.js";
-import { OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdk-validation-error.js";
-
-/**
- * CPU architecture the image was built for. Validated against the provider at preflight.
- */
-export enum GetApiSandboxArch {
-  X8664 = "x86_64",
-  Arm64 = "arm64",
-}
-/**
- * CPU architecture the image was built for. Validated against the provider at preflight.
- */
-export type GetApiSandboxArchOpen = OpenEnum<typeof GetApiSandboxArch>;
-
-export enum GetApiSandboxStatus {
-  Pending = "pending",
-  Starting = "starting",
-  Running = "running",
-  Paused = "paused",
-  Stopping = "stopping",
-  Stopped = "stopped",
-  Failed = "failed",
-}
-export type GetApiSandboxStatusOpen = OpenEnum<typeof GetApiSandboxStatus>;
+import * as models from "../index.js";
 
 /**
  * A sandbox as recorded by the service — one record whether spawned from CLI or platform
@@ -52,8 +28,8 @@ export type GetApiSandboxResponse = {
   /**
    * CPU architecture the image was built for. Validated against the provider at preflight.
    */
-  arch: GetApiSandboxArchOpen;
-  status: GetApiSandboxStatusOpen;
+  arch: models.SchemadefaulOpen;
+  status: models.Schemadefaul4Open;
   definitionName: string;
   environmentName?: string | undefined;
   /**
@@ -62,18 +38,6 @@ export type GetApiSandboxResponse = {
   createdAt: string;
 };
 
-/** @internal */
-export const GetApiSandboxArch$inboundSchema: z.ZodMiniType<
-  GetApiSandboxArchOpen,
-  unknown
-> = openEnums.inboundSchema(GetApiSandboxArch);
-
-/** @internal */
-export const GetApiSandboxStatus$inboundSchema: z.ZodMiniType<
-  GetApiSandboxStatusOpen,
-  unknown
-> = openEnums.inboundSchema(GetApiSandboxStatus);
-
 /** @internal */
 export const GetApiSandboxResponse$inboundSchema: z.ZodMiniType<
   GetApiSandboxResponse,
@@ -82,10 +46,13 @@ export const GetApiSandboxResponse$inboundSchema: z.ZodMiniType<
   id: types.string(),
   generation: types.number(),
   provider: types.string(),
-  arch: z._default(GetApiSandboxArch$inboundSchema, GetApiSandboxArch.X8664),
+  arch: z._default(
+    models.Schemadefaul$inboundSchema,
+    models.Schemadefaul.X8664,
+  ),
   status: z._default(
-    GetApiSandboxStatus$inboundSchema,
-    GetApiSandboxStatus.Pending,
+    models.Schemadefaul4$inboundSchema,
+    models.Schemadefaul4.Pending,
   ),
   definitionName: types.string(),
   environmentName: types.optional(types.string()),

package/src/models/operations/get-trace.ts

@@ -0,0 +1,69 @@
+/*
+ * 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 GetTraceRequest = {
+  traceId: string;
+};
+
+/**
+ * Response for status 200
+ */
+export type GetTraceResponse = {
+  traceId: string;
+  serviceName: string | null;
+  sessionId: string | null;
+  startTime: Date;
+  endTime: Date | null;
+  spanCount: number;
+  resource: { [k: string]: any } | null;
+};
+
+/** @internal */
+export type GetTraceRequest$Outbound = {
+  traceId: string;
+};
+
+/** @internal */
+export const GetTraceRequest$outboundSchema: z.ZodMiniType<
+  GetTraceRequest$Outbound,
+  GetTraceRequest
+> = z.object({
+  traceId: z.string(),
+});
+
+export function getTraceRequestToJSON(
+  getTraceRequest: GetTraceRequest,
+): string {
+  return JSON.stringify(GetTraceRequest$outboundSchema.parse(getTraceRequest));
+}
+
+/** @internal */
+export const GetTraceResponse$inboundSchema: z.ZodMiniType<
+  GetTraceResponse,
+  unknown
+> = z.object({
+  traceId: types.string(),
+  serviceName: types.nullable(types.string()),
+  sessionId: types.nullable(types.string()),
+  startTime: types.date(),
+  endTime: types.nullable(types.date()),
+  spanCount: types.number(),
+  resource: types.nullable(z.record(z.string(), z.any())),
+});
+
+export function getTraceResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetTraceResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetTraceResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetTraceResponse' from JSON`,
+  );
+}