@mutagent/sdk 0.3.37 → 0.3.39

package/src/models/operations/index.ts

@@ -17,6 +17,7 @@ export * from "./delete-session.js";
 export * from "./delete-workspace.js";
 export * from "./get-agent-by-slug.js";
 export * from "./get-agent.js";
+export * from "./get-api-sandbox-by-id-sessions.js";
 export * from "./get-api-sandbox-by-id-stream.js";
 export * from "./get-api-sandbox-by-id-traces.js";
 export * from "./get-api-sandbox-by-id.js";
@@ -30,19 +31,27 @@ export * from "./get-organization-member-count.js";
 export * from "./get-organization.js";
 export * from "./get-profile.js";
 export * from "./get-provider.js";
+export * from "./get-trace.js";
 export * from "./get-workspace.js";
+export * from "./ingest-trace-batch.js";
 export * from "./list-agents.js";
 export * from "./list-available-models.js";
 export * from "./list-invitations.js";
+export * from "./list-logs.js";
 export * from "./list-organization-members.js";
 export * from "./list-organizations.js";
 export * from "./list-provider-models.js";
 export * from "./list-providers.js";
 export * from "./list-sessions.js";
+export * from "./list-trace-spans.js";
+export * from "./list-traces.js";
 export * from "./list-workspace-members.js";
 export * from "./list-workspaces.js";
 export * from "./post-api-sandbox-agent-run.js";
 export * from "./post-api-sandbox-by-id-exec.js";
+export * from "./post-api-sandbox-by-id-input.js";
+export * from "./post-api-sandbox-by-id-session.js";
+export * from "./post-api-sandbox-by-id-signal.js";
 export * from "./post-api-sandbox-preflight.js";
 export * from "./post-api-sandbox-run.js";
 export * from "./post-api-sandbox-telemetry-v1-traces.js";

package/src/models/operations/ingest-trace-batch.ts

@@ -0,0 +1,73 @@
+/*
+ * 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 IngestTraceBatchRequest = {
+  traces: Array<models.ArrayOfTraceIdSessionIdName>;
+};
+
+/**
+ * Response for status 200
+ */
+export type IngestTraceBatchResponse = {
+  /**
+   * Records written
+   */
+  accepted: number;
+  /**
+   * Records the receiver could not store
+   */
+  rejected: number;
+  /**
+   * Why records were rejected
+   */
+  note?: string | undefined;
+};
+
+/** @internal */
+export type IngestTraceBatchRequest$Outbound = {
+  traces: Array<models.ArrayOfTraceIdSessionIdName$Outbound>;
+};
+
+/** @internal */
+export const IngestTraceBatchRequest$outboundSchema: z.ZodMiniType<
+  IngestTraceBatchRequest$Outbound,
+  IngestTraceBatchRequest
+> = z.object({
+  traces: z.array(models.ArrayOfTraceIdSessionIdName$outboundSchema),
+});
+
+export function ingestTraceBatchRequestToJSON(
+  ingestTraceBatchRequest: IngestTraceBatchRequest,
+): string {
+  return JSON.stringify(
+    IngestTraceBatchRequest$outboundSchema.parse(ingestTraceBatchRequest),
+  );
+}
+
+/** @internal */
+export const IngestTraceBatchResponse$inboundSchema: z.ZodMiniType<
+  IngestTraceBatchResponse,
+  unknown
+> = z.object({
+  accepted: types.number(),
+  rejected: types.number(),
+  note: types.optional(types.string()),
+});
+
+export function ingestTraceBatchResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<IngestTraceBatchResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IngestTraceBatchResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IngestTraceBatchResponse' from JSON`,
+  );
+}

package/src/models/operations/list-logs.ts

@@ -0,0 +1,103 @@
+/*
+ * 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 ListLogsRequest = {
+  limit?: number | undefined;
+  cursor?: string | undefined;
+  traceId?: string | undefined;
+};
+
+export type ListLogsData = {
+  id: number;
+  time: Date;
+  observedTime: Date | null;
+  severityNumber: number;
+  severityText: string | null;
+  body: any;
+  attributes: { [k: string]: any };
+  traceId: string | null;
+  spanId: string | null;
+  scopeName: string | null;
+};
+
+/**
+ * Response for status 200
+ */
+export type ListLogsResponse = {
+  data: Array<ListLogsData>;
+  nextCursor: string | null;
+};
+
+/** @internal */
+export type ListLogsRequest$Outbound = {
+  limit?: number | undefined;
+  cursor?: string | undefined;
+  traceId?: string | undefined;
+};
+
+/** @internal */
+export const ListLogsRequest$outboundSchema: z.ZodMiniType<
+  ListLogsRequest$Outbound,
+  ListLogsRequest
+> = z.object({
+  limit: z.optional(z.number()),
+  cursor: z.optional(z.string()),
+  traceId: z.optional(z.string()),
+});
+
+export function listLogsRequestToJSON(
+  listLogsRequest: ListLogsRequest,
+): string {
+  return JSON.stringify(ListLogsRequest$outboundSchema.parse(listLogsRequest));
+}
+
+/** @internal */
+export const ListLogsData$inboundSchema: z.ZodMiniType<ListLogsData, unknown> =
+  z.object({
+    id: types.number(),
+    time: types.date(),
+    observedTime: types.nullable(types.date()),
+    severityNumber: types.number(),
+    severityText: types.nullable(types.string()),
+    body: z.any(),
+    attributes: z.record(z.string(), z.any()),
+    traceId: types.nullable(types.string()),
+    spanId: types.nullable(types.string()),
+    scopeName: types.nullable(types.string()),
+  });
+
+export function listLogsDataFromJSON(
+  jsonString: string,
+): SafeParseResult<ListLogsData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListLogsData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListLogsData' from JSON`,
+  );
+}
+
+/** @internal */
+export const ListLogsResponse$inboundSchema: z.ZodMiniType<
+  ListLogsResponse,
+  unknown
+> = z.object({
+  data: z.array(z.lazy(() => ListLogsData$inboundSchema)),
+  nextCursor: types.nullable(types.string()),
+});
+
+export function listLogsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ListLogsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListLogsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListLogsResponse' from JSON`,
+  );
+}

package/src/models/operations/list-trace-spans.ts

@@ -0,0 +1,109 @@
+/*
+ * 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 ListTraceSpansRequest = {
+  traceId: string;
+};
+
+export type ListTraceSpansData = {
+  spanId: string;
+  traceId: string;
+  parentSpanId: string | null;
+  name: string;
+  kind: number;
+  startTime: Date;
+  endTime: Date | null;
+  durationNanos: number | null;
+  statusCode: number;
+  statusMessage: string | null;
+  attributes: { [k: string]: any };
+  events: Array<any>;
+  links: Array<any>;
+  scopeName: string | null;
+  scopeVersion: string | null;
+};
+
+/**
+ * Response for status 200
+ */
+export type ListTraceSpansResponse = {
+  data: Array<ListTraceSpansData>;
+};
+
+/** @internal */
+export type ListTraceSpansRequest$Outbound = {
+  traceId: string;
+};
+
+/** @internal */
+export const ListTraceSpansRequest$outboundSchema: z.ZodMiniType<
+  ListTraceSpansRequest$Outbound,
+  ListTraceSpansRequest
+> = z.object({
+  traceId: z.string(),
+});
+
+export function listTraceSpansRequestToJSON(
+  listTraceSpansRequest: ListTraceSpansRequest,
+): string {
+  return JSON.stringify(
+    ListTraceSpansRequest$outboundSchema.parse(listTraceSpansRequest),
+  );
+}
+
+/** @internal */
+export const ListTraceSpansData$inboundSchema: z.ZodMiniType<
+  ListTraceSpansData,
+  unknown
+> = z.object({
+  spanId: types.string(),
+  traceId: types.string(),
+  parentSpanId: types.nullable(types.string()),
+  name: types.string(),
+  kind: types.number(),
+  startTime: types.date(),
+  endTime: types.nullable(types.date()),
+  durationNanos: types.nullable(types.number()),
+  statusCode: types.number(),
+  statusMessage: types.nullable(types.string()),
+  attributes: z.record(z.string(), z.any()),
+  events: z.array(z.any()),
+  links: z.array(z.any()),
+  scopeName: types.nullable(types.string()),
+  scopeVersion: types.nullable(types.string()),
+});
+
+export function listTraceSpansDataFromJSON(
+  jsonString: string,
+): SafeParseResult<ListTraceSpansData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListTraceSpansData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListTraceSpansData' from JSON`,
+  );
+}
+
+/** @internal */
+export const ListTraceSpansResponse$inboundSchema: z.ZodMiniType<
+  ListTraceSpansResponse,
+  unknown
+> = z.object({
+  data: z.array(z.lazy(() => ListTraceSpansData$inboundSchema)),
+});
+
+export function listTraceSpansResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ListTraceSpansResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListTraceSpansResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListTraceSpansResponse' from JSON`,
+  );
+}

package/src/models/operations/list-traces.ts

@@ -0,0 +1,101 @@
+/*
+ * 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 ListTracesRequest = {
+  limit?: number | undefined;
+  cursor?: string | undefined;
+  sessionId?: string | undefined;
+};
+
+export type ListTracesData = {
+  traceId: string;
+  serviceName: string | null;
+  sessionId: string | null;
+  startTime: Date;
+  endTime: Date | null;
+  spanCount: number;
+  resource: { [k: string]: any } | null;
+};
+
+/**
+ * Response for status 200
+ */
+export type ListTracesResponse = {
+  data: Array<ListTracesData>;
+  nextCursor: string | null;
+};
+
+/** @internal */
+export type ListTracesRequest$Outbound = {
+  limit?: number | undefined;
+  cursor?: string | undefined;
+  sessionId?: string | undefined;
+};
+
+/** @internal */
+export const ListTracesRequest$outboundSchema: z.ZodMiniType<
+  ListTracesRequest$Outbound,
+  ListTracesRequest
+> = z.object({
+  limit: z.optional(z.number()),
+  cursor: z.optional(z.string()),
+  sessionId: z.optional(z.string()),
+});
+
+export function listTracesRequestToJSON(
+  listTracesRequest: ListTracesRequest,
+): string {
+  return JSON.stringify(
+    ListTracesRequest$outboundSchema.parse(listTracesRequest),
+  );
+}
+
+/** @internal */
+export const ListTracesData$inboundSchema: z.ZodMiniType<
+  ListTracesData,
+  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 listTracesDataFromJSON(
+  jsonString: string,
+): SafeParseResult<ListTracesData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListTracesData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListTracesData' from JSON`,
+  );
+}
+
+/** @internal */
+export const ListTracesResponse$inboundSchema: z.ZodMiniType<
+  ListTracesResponse,
+  unknown
+> = z.object({
+  data: z.array(z.lazy(() => ListTracesData$inboundSchema)),
+  nextCursor: types.nullable(types.string()),
+});
+
+export function listTracesResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ListTracesResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListTracesResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListTracesResponse' from JSON`,
+  );
+}

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

@@ -7,6 +7,7 @@ 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";
 
 /**
  * Set to `1` to watch the turn as an event stream instead of awaiting one JSON body.
@@ -18,36 +19,6 @@ export enum PostApiSandboxAgentRunStream {
   True = "true",
 }
 
-/**
- * Run one agent turn in a fresh sandbox and tear it down
- */
-export type PostApiSandboxAgentRunRequestBody = {
-  /**
-   * 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;
-  /**
-   * WHO the agent is — the agent definition, passed as `helix agent --prompt`.
-   */
-  prompt: string;
-  /**
-   * WHAT to do this turn — the task, passed as `-p`. A different prompt from `prompt`.
-   */
-  task: string;
-};
-
 export type PostApiSandboxAgentRunRequest = {
   /**
    * Set to `1` to watch the turn as an event stream instead of awaiting one JSON body.
@@ -56,7 +27,7 @@ export type PostApiSandboxAgentRunRequest = {
   /**
    * Run one agent turn in a fresh sandbox and tear it down
    */
-  body: PostApiSandboxAgentRunRequestBody;
+  body: models.PresetTimeoutMsKeep2;
 };
 
 /**
@@ -89,43 +60,10 @@ export const PostApiSandboxAgentRunStream$outboundSchema: z.ZodMiniEnum<
   typeof PostApiSandboxAgentRunStream
 > = z.enum(PostApiSandboxAgentRunStream);
 
-/** @internal */
-export type PostApiSandboxAgentRunRequestBody$Outbound = {
-  preset?: string | undefined;
-  timeoutMs?: number | undefined;
-  keep?: boolean | undefined;
-  runId?: string | undefined;
-  prompt: string;
-  task: string;
-};
-
-/** @internal */
-export const PostApiSandboxAgentRunRequestBody$outboundSchema: z.ZodMiniType<
-  PostApiSandboxAgentRunRequestBody$Outbound,
-  PostApiSandboxAgentRunRequestBody
-> = z.object({
-  preset: z.optional(z.string()),
-  timeoutMs: z.optional(z.number()),
-  keep: z.optional(z.boolean()),
-  runId: z.optional(z.string()),
-  prompt: z.string(),
-  task: z.string(),
-});
-
-export function postApiSandboxAgentRunRequestBodyToJSON(
-  postApiSandboxAgentRunRequestBody: PostApiSandboxAgentRunRequestBody,
-): string {
-  return JSON.stringify(
-    PostApiSandboxAgentRunRequestBody$outboundSchema.parse(
-      postApiSandboxAgentRunRequestBody,
-    ),
-  );
-}
-
 /** @internal */
 export type PostApiSandboxAgentRunRequest$Outbound = {
   stream: string;
-  body: PostApiSandboxAgentRunRequestBody$Outbound;
+  body: models.PresetTimeoutMsKeep2$Outbound;
 };
 
 /** @internal */
@@ -137,7 +75,7 @@ export const PostApiSandboxAgentRunRequest$outboundSchema: z.ZodMiniType<
     PostApiSandboxAgentRunStream$outboundSchema,
     PostApiSandboxAgentRunStream.Zero,
   ),
-  body: z.lazy(() => PostApiSandboxAgentRunRequestBody$outboundSchema),
+  body: models.PresetTimeoutMsKeep2$outboundSchema,
 });
 
 export function postApiSandboxAgentRunRequestToJSON(

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

@@ -7,6 +7,7 @@ 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";
 
 /**
  * Set to `1` to receive the result as an event stream instead of JSON.
@@ -18,15 +19,6 @@ export enum PostApiSandboxByIdExecStream {
   True = "true",
 }
 
-/**
- * Run a command inside a sandbox
- */
-export type PostApiSandboxByIdExecRequestBody = {
-  command: Array<string>;
-  cwd?: string | undefined;
-  timeoutMs?: number | undefined;
-};
-
 export type PostApiSandboxByIdExecRequest = {
   id: string;
   /**
@@ -36,7 +28,7 @@ export type PostApiSandboxByIdExecRequest = {
   /**
    * Run a command inside a sandbox
    */
-  body: PostApiSandboxByIdExecRequestBody;
+  body: models.CommandCwdTimeoutMs;
 };
 
 /**
@@ -57,38 +49,11 @@ export const PostApiSandboxByIdExecStream$outboundSchema: z.ZodMiniEnum<
   typeof PostApiSandboxByIdExecStream
 > = z.enum(PostApiSandboxByIdExecStream);
 
-/** @internal */
-export type PostApiSandboxByIdExecRequestBody$Outbound = {
-  command: Array<string>;
-  cwd?: string | undefined;
-  timeoutMs?: number | undefined;
-};
-
-/** @internal */
-export const PostApiSandboxByIdExecRequestBody$outboundSchema: z.ZodMiniType<
-  PostApiSandboxByIdExecRequestBody$Outbound,
-  PostApiSandboxByIdExecRequestBody
-> = z.object({
-  command: z.array(z.string()),
-  cwd: z.optional(z.string()),
-  timeoutMs: z.optional(z.number()),
-});
-
-export function postApiSandboxByIdExecRequestBodyToJSON(
-  postApiSandboxByIdExecRequestBody: PostApiSandboxByIdExecRequestBody,
-): string {
-  return JSON.stringify(
-    PostApiSandboxByIdExecRequestBody$outboundSchema.parse(
-      postApiSandboxByIdExecRequestBody,
-    ),
-  );
-}
-
 /** @internal */
 export type PostApiSandboxByIdExecRequest$Outbound = {
   id: string;
   stream: string;
-  body: PostApiSandboxByIdExecRequestBody$Outbound;
+  body: models.CommandCwdTimeoutMs$Outbound;
 };
 
 /** @internal */
@@ -101,7 +66,7 @@ export const PostApiSandboxByIdExecRequest$outboundSchema: z.ZodMiniType<
     PostApiSandboxByIdExecStream$outboundSchema,
     PostApiSandboxByIdExecStream.Zero,
   ),
-  body: z.lazy(() => PostApiSandboxByIdExecRequestBody$outboundSchema),
+  body: models.CommandCwdTimeoutMs$outboundSchema,
 });
 
 export function postApiSandboxByIdExecRequestToJSON(

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`,
+  );
+}