@mutagent/sdk 0.4.0 → 0.4.2

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

@@ -0,0 +1,150 @@
+/*
+ * 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";
+
+export type PostApiSandboxAgentRunRequest = {
+  stream?: models.Schemadefaul6 | undefined;
+  /**
+   * Run one agent turn in a fresh sandbox and tear it down
+   */
+  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
+ */
+export type PostApiSandboxAgentRunResponse = {
+  /**
+   * The sandbox the run happened in. Already gone unless `keep` was true.
+   */
+  sandboxId: string;
+  /**
+   * Preset that was resolved — useful when the default was taken.
+   */
+  preset: string;
+  /**
+   * The command's real exit code. Never synthesised.
+   */
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+  timedOut: boolean;
+  /**
+   * Whether teardown was CONFIRMED. False with `keep` false means the release failed and the box may still exist — the run result is still valid.
+   */
+  tornDown: boolean;
+};
+
+/** @internal */
+export type PostApiSandboxAgentRunRequest$Outbound = {
+  stream: string;
+  body: models.PresetTimeoutMsKeep2$Outbound;
+};
+
+/** @internal */
+export const PostApiSandboxAgentRunRequest$outboundSchema: z.ZodMiniType<
+  PostApiSandboxAgentRunRequest$Outbound,
+  PostApiSandboxAgentRunRequest
+> = z.object({
+  stream: z._default(
+    models.Schemadefaul6$outboundSchema,
+    models.Schemadefaul6.Zero,
+  ),
+  body: models.PresetTimeoutMsKeep2$outboundSchema,
+});
+
+export function postApiSandboxAgentRunRequestToJSON(
+  postApiSandboxAgentRunRequest: PostApiSandboxAgentRunRequest,
+): string {
+  return JSON.stringify(
+    PostApiSandboxAgentRunRequest$outboundSchema.parse(
+      postApiSandboxAgentRunRequest,
+    ),
+  );
+}
+
+/** @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,
+  unknown
+> = z.object({
+  sandboxId: types.string(),
+  preset: types.string(),
+  exitCode: types.number(),
+  stdout: types.string(),
+  stderr: types.string(),
+  timedOut: types.boolean(),
+  tornDown: types.boolean(),
+});
+
+export function postApiSandboxAgentRunResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxAgentRunResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxAgentRunResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxAgentRunResponse' from JSON`,
+  );
+}

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

@@ -0,0 +1,151 @@
+/*
+ * 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";
+
+/**
+ * Capture a running Helix session's own transcript into a snapshot
+ */
+export type PostApiSandboxByIdCheckpointRequestBody = {
+  /**
+   * The Helix session to capture — from the `start` that created it. The harness writes its session file LAZILY, so a session that has not completed a turn has nothing to capture and answers 409.
+   */
+  sessionId: string;
+};
+
+export type PostApiSandboxByIdCheckpointRequest = {
+  id: string;
+  /**
+   * Capture a running Helix session's own transcript into a snapshot
+   */
+  body: PostApiSandboxByIdCheckpointRequestBody;
+};
+
+/**
+ * A stored checkpoint of the agent’s own conversation state
+ */
+export type PostApiSandboxByIdCheckpointResponse = {
+  /**
+   * Names the snapshot in a later restore.
+   */
+  snapshotId: string;
+  /**
+   * Size of the captured file in RAW bytes, not base64.
+   */
+  bytes: number;
+  /**
+   * sha256 of the raw bytes, hex. A restore re-reads this from the receiving box and refuses to switch the session if it differs.
+   */
+  sha256: string;
+  /**
+   * The harness's OWN session id, from inside the file. Distinct from the control-plane sessionId, and the one that survives a restore.
+   */
+  harnessSessionId: string;
+  /**
+   * Messages the harness reported at capture time. Never zero — a zero capture is refused.
+   */
+  messageCount: number;
+  /**
+   * Where the file lived on the origin box. Diagnostic only — a restore derives its path from the RECEIVING box, since cwd is a per-session choice.
+   */
+  sourcePath: string;
+  /**
+   * Where the settings-and-queue manifest was written in the object store, or null when this deployment has none. The manifest also holds the workspace and extension-state archive references.
+   */
+  manifestKey: string | null;
+  /**
+   * Size of the workspace archive that travelled with this checkpoint. Null when none did.
+   */
+  workspaceBytes: number | null;
+  /**
+   * How many files that archive holds. Null when no workspace travelled.
+   */
+  workspaceFiles: number | null;
+  /**
+   * One line per leg that did NOT travel, each naming the leg and the reason. Empty means everything was captured. Read this before treating a 200 as a full-state checkpoint: a capture that stored the conversation and carried no workspace is a legitimate outcome and must not look like one that carried it.
+   */
+  notCaptured: Array<string>;
+};
+
+/** @internal */
+export type PostApiSandboxByIdCheckpointRequestBody$Outbound = {
+  sessionId: string;
+};
+
+/** @internal */
+export const PostApiSandboxByIdCheckpointRequestBody$outboundSchema:
+  z.ZodMiniType<
+    PostApiSandboxByIdCheckpointRequestBody$Outbound,
+    PostApiSandboxByIdCheckpointRequestBody
+  > = z.object({
+    sessionId: z.string(),
+  });
+
+export function postApiSandboxByIdCheckpointRequestBodyToJSON(
+  postApiSandboxByIdCheckpointRequestBody:
+    PostApiSandboxByIdCheckpointRequestBody,
+): string {
+  return JSON.stringify(
+    PostApiSandboxByIdCheckpointRequestBody$outboundSchema.parse(
+      postApiSandboxByIdCheckpointRequestBody,
+    ),
+  );
+}
+
+/** @internal */
+export type PostApiSandboxByIdCheckpointRequest$Outbound = {
+  id: string;
+  body: PostApiSandboxByIdCheckpointRequestBody$Outbound;
+};
+
+/** @internal */
+export const PostApiSandboxByIdCheckpointRequest$outboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdCheckpointRequest$Outbound,
+  PostApiSandboxByIdCheckpointRequest
+> = z.object({
+  id: z.string(),
+  body: z.lazy(() => PostApiSandboxByIdCheckpointRequestBody$outboundSchema),
+});
+
+export function postApiSandboxByIdCheckpointRequestToJSON(
+  postApiSandboxByIdCheckpointRequest: PostApiSandboxByIdCheckpointRequest,
+): string {
+  return JSON.stringify(
+    PostApiSandboxByIdCheckpointRequest$outboundSchema.parse(
+      postApiSandboxByIdCheckpointRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const PostApiSandboxByIdCheckpointResponse$inboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdCheckpointResponse,
+  unknown
+> = z.object({
+  snapshotId: types.string(),
+  bytes: types.number(),
+  sha256: types.string(),
+  harnessSessionId: types.string(),
+  messageCount: types.number(),
+  sourcePath: types.string(),
+  manifestKey: types.nullable(types.string()),
+  workspaceBytes: types.nullable(types.number()),
+  workspaceFiles: types.nullable(types.number()),
+  notCaptured: z.array(types.string()),
+});
+
+export function postApiSandboxByIdCheckpointResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxByIdCheckpointResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PostApiSandboxByIdCheckpointResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxByIdCheckpointResponse' from JSON`,
+  );
+}

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

@@ -0,0 +1,83 @@
+/*
+ * 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";
+
+export type PostApiSandboxByIdExecRequest = {
+  id: string;
+  stream?: models.Schemadefaul6 | undefined;
+  /**
+   * Run a command inside a sandbox
+   */
+  body: models.CommandCwdTimeoutMs;
+};
+
+/**
+ * Command result
+ */
+export type PostApiSandboxByIdExecResponse = {
+  /**
+   * The command's real exit code
+   */
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+  timedOut: boolean;
+};
+
+/** @internal */
+export type PostApiSandboxByIdExecRequest$Outbound = {
+  id: string;
+  stream: string;
+  body: models.CommandCwdTimeoutMs$Outbound;
+};
+
+/** @internal */
+export const PostApiSandboxByIdExecRequest$outboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdExecRequest$Outbound,
+  PostApiSandboxByIdExecRequest
+> = z.object({
+  id: z.string(),
+  stream: z._default(
+    models.Schemadefaul6$outboundSchema,
+    models.Schemadefaul6.Zero,
+  ),
+  body: models.CommandCwdTimeoutMs$outboundSchema,
+});
+
+export function postApiSandboxByIdExecRequestToJSON(
+  postApiSandboxByIdExecRequest: PostApiSandboxByIdExecRequest,
+): string {
+  return JSON.stringify(
+    PostApiSandboxByIdExecRequest$outboundSchema.parse(
+      postApiSandboxByIdExecRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const PostApiSandboxByIdExecResponse$inboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdExecResponse,
+  unknown
+> = z.object({
+  exitCode: types.number(),
+  stdout: types.string(),
+  stderr: types.string(),
+  timedOut: types.boolean(),
+});
+
+export function postApiSandboxByIdExecResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxByIdExecResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxByIdExecResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxByIdExecResponse' from JSON`,
+  );
+}

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

@@ -0,0 +1,68 @@
+/*
+ * 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";
+
+export type PostApiSandboxByIdInputRequest = {
+  id: string;
+  /**
+   * Write one NDJSON command line to a running Helix session's stdin
+   */
+  body: models.SessionIdLine;
+};
+
+/**
+ * The line reached the session. Whether the agent accepted it is reported on the `rpc` stream, not here.
+ */
+export type PostApiSandboxByIdInputResponse = {
+  accepted: true;
+};
+
+/** @internal */
+export type PostApiSandboxByIdInputRequest$Outbound = {
+  id: string;
+  body: models.SessionIdLine$Outbound;
+};
+
+/** @internal */
+export const PostApiSandboxByIdInputRequest$outboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdInputRequest$Outbound,
+  PostApiSandboxByIdInputRequest
+> = z.object({
+  id: z.string(),
+  body: models.SessionIdLine$outboundSchema,
+});
+
+export function postApiSandboxByIdInputRequestToJSON(
+  postApiSandboxByIdInputRequest: PostApiSandboxByIdInputRequest,
+): string {
+  return JSON.stringify(
+    PostApiSandboxByIdInputRequest$outboundSchema.parse(
+      postApiSandboxByIdInputRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const PostApiSandboxByIdInputResponse$inboundSchema: z.ZodMiniType<
+  PostApiSandboxByIdInputResponse,
+  unknown
+> = z.object({
+  accepted: types.literal(true),
+});
+
+export function postApiSandboxByIdInputResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PostApiSandboxByIdInputResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PostApiSandboxByIdInputResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PostApiSandboxByIdInputResponse' from JSON`,
+  );
+}