@mutagent/sdk 0.5.12 → 0.5.13

package/dist/esm/models/helix-session-input-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-input-request.js","sourceRoot":"","sources":["../../../src/models/helix-session-input-request.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAcjC,gBAAgB;AAChB,MAAM,CAAC,MAAM,uCAAuC,GAGhD,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAC5C,wBAAkD;IAElD,OAAO,IAAI,CAAC,SAAS,CACnB,uCAAuC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CACxE,CAAC;AACJ,CAAC"}

package/dist/esm/models/helix-session-list.d.ts

@@ -0,0 +1,25 @@
+import * as z from "zod/v4-mini";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import { HelixSessionSummary } from "./helix-session-summary.js";
+/**
+ * Every Helix session the workspace has — live and ended, across all of its sandboxes — assembled from the persisted event log and the sandbox records. `sandbox:read`, like the sandbox-addressed session listing: asking what exists is not driving the sandbox.
+ */
+export type HelixSessionList = {
+    /**
+     * The workspace the rows belong to — echoed so a client can verify the scope it asked about.
+     */
+    workspaceId: string;
+    /**
+     * Newest activity first.
+     */
+    sessions: Array<HelixSessionSummary>;
+    /**
+     * Pass back as `?cursor=` for the next page. Present exactly when another page exists; treat as opaque.
+     */
+    nextCursor?: string | undefined;
+};
+/** @internal */
+export declare const HelixSessionList$inboundSchema: z.ZodMiniType<HelixSessionList, unknown>;
+export declare function helixSessionListFromJSON(jsonString: string): SafeParseResult<HelixSessionList, SDKValidationError>;
+//# sourceMappingURL=helix-session-list.d.ts.map

package/dist/esm/models/helix-session-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-list.d.ts","sourceRoot":"","sources":["../../../src/models/helix-session-list.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACL,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,WAAW,CACxD,gBAAgB,EAChB,OAAO,CAKP,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAMvD"}

package/dist/esm/models/helix-session-list.js

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as types from "../types/primitives.js";
+import { HelixSessionSummary$inboundSchema, } from "./helix-session-summary.js";
+/** @internal */
+export const HelixSessionList$inboundSchema = z.object({
+    workspaceId: types.string(),
+    sessions: z.array(HelixSessionSummary$inboundSchema),
+    nextCursor: types.optional(types.string()),
+});
+export function helixSessionListFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => HelixSessionList$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'HelixSessionList' from JSON`);
+}
+//# sourceMappingURL=helix-session-list.js.map

package/dist/esm/models/helix-session-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-list.js","sourceRoot":"","sources":["../../../src/models/helix-session-list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAEL,iCAAiC,GAClC,MAAM,4BAA4B,CAAC;AAoBpC,gBAAgB;AAChB,MAAM,CAAC,MAAM,8BAA8B,GAGvC,CAAC,CAAC,MAAM,CAAC;IACX,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iCAAiC,CAAC;IACpD,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CACtC,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,8BAA8B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAC1D,8CAA8C,CAC/C,CAAC;AACJ,CAAC"}

package/dist/esm/models/helix-session-restore-result.d.ts

@@ -0,0 +1,97 @@
+import * as z from "zod/v4-mini";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import { WorkspaceDrift } from "./workspace-drift.js";
+export type HelixSessionRestoreResultWorkspace = {
+    files: number;
+    bytes: number;
+};
+export type HelixSessionRestoreResultSkippedSnapshot = {
+    id: string;
+    reason: string;
+};
+/**
+ * A restored Helix session, addressed by its new reference.
+ */
+export type HelixSessionRestoreResult = {
+    /**
+     * True only. The digest matched and the harness confirmed the switch; anything else is an error status, never a `false` here.
+     */
+    restored: boolean;
+    /**
+     * UNCHANGED across the restore. That is the design: the logical sandbox keeps its id so a client cursor stays valid, and `generation` is what says the instance underneath was replaced.
+     */
+    sandboxId: string;
+    /**
+     * The previous generation plus one.
+     */
+    generation: number;
+    snapshotId: string;
+    /**
+     * The NEW control-plane Helix session in the rebuilt sandbox. Use it for `POST /:id/input`.
+     */
+    sessionId: string;
+    /**
+     * The harness's OWN session id, carried through from the snapshot. Unlike `sessionId` it survives the restore, so it is what identifies one conversation across the seam.
+     */
+    harnessSessionId: string;
+    /**
+     * The working directory the restored session runs in, from the checkpoint. Null when the checkpoint recorded none.
+     */
+    cwd: string | null;
+    bytes: number;
+    /**
+     * What the sandbox reported. Equal to the stored digest, or this call failed.
+     */
+    sha256: string;
+    /**
+     * The wire seq the `restored` marker took on the stream. It CONTINUES the killed instance's numbering, which is what lets a client keep using its old `?since=` cursor. -1 when this deployment has no event relay and no marker could be written.
+     */
+    seq: number;
+    /**
+     * Which runtime modes were actually replayed onto the restored session. A mode the checkpoint did not record is not replayed — imposing a default nobody chose is worse than leaving one unset.
+     */
+    settingsReplayed: Array<string>;
+    /**
+     * How many pending steer/follow-up instructions were re-enqueued.
+     */
+    queueReplayed: number;
+    /**
+     * What the workspace archive put back, or null when none travelled.
+     */
+    workspace: HelixSessionRestoreResultWorkspace | null;
+    /**
+     * Whether the restored context refers to files this sandbox does not have
+     */
+    workspaceDrift: WorkspaceDrift;
+    /**
+     * One line per thing that did NOT come back, each naming the leg and why. Read this before believing the rest: restoring the conversation alone is a legitimate outcome (a deployment with no object store, or a checkpoint whose manifest never landed) and must not be indistinguishable from a full-state restore.
+     */
+    notRestored: Array<string>;
+    /**
+     * True when the transcript restored is the incremental prefix beyond the checkpoint (`partial: true` was asked AND the prefix extended the row). The `session {status:"restored"}` frame carries the same flag. False when the checkpoint row was restored — including a `partial: true` request that fell back, which `notRestored` explains.
+     */
+    partial: boolean;
+    /**
+     * Transcript bytes restored BEYOND the checkpoint row. 0 unless `partial`.
+     */
+    partialBytes: number;
+    /**
+     * Newer checkpoints a DEFAULTED restore passed over to reach one with a manifest, each with why. A consistency point writes its conversation row first and its manifest last, so a sandbox that dies in between leaves a newest row that cannot be restored in full; the default walks back to the newest one that can and names what it skipped here. Empty when the newest row was used or when `snapshotId` was given (a named snapshot is restored as-is, with the session file’s own header cwd when it has no manifest).
+     */
+    skippedSnapshots: Array<HelixSessionRestoreResultSkippedSnapshot>;
+    /**
+     * The live execution reference of the session the restore started (`hs1_…`); attach, send and signal take it.
+     */
+    reference: string;
+};
+/** @internal */
+export declare const HelixSessionRestoreResultWorkspace$inboundSchema: z.ZodMiniType<HelixSessionRestoreResultWorkspace, unknown>;
+export declare function helixSessionRestoreResultWorkspaceFromJSON(jsonString: string): SafeParseResult<HelixSessionRestoreResultWorkspace, SDKValidationError>;
+/** @internal */
+export declare const HelixSessionRestoreResultSkippedSnapshot$inboundSchema: z.ZodMiniType<HelixSessionRestoreResultSkippedSnapshot, unknown>;
+export declare function helixSessionRestoreResultSkippedSnapshotFromJSON(jsonString: string): SafeParseResult<HelixSessionRestoreResultSkippedSnapshot, SDKValidationError>;
+/** @internal */
+export declare const HelixSessionRestoreResult$inboundSchema: z.ZodMiniType<HelixSessionRestoreResult, unknown>;
+export declare function helixSessionRestoreResultFromJSON(jsonString: string): SafeParseResult<HelixSessionRestoreResult, SDKValidationError>;
+//# sourceMappingURL=helix-session-restore-result.d.ts.map

package/dist/esm/models/helix-session-restore-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-restore-result.d.ts","sourceRoot":"","sources":["../../../src/models/helix-session-restore-result.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACL,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,kCAAkC,GAAG;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wCAAwC,GAAG;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,EAAE,kCAAkC,GAAG,IAAI,CAAC;IACrD;;OAEG;IACH,cAAc,EAAE,cAAc,CAAC;IAC/B;;OAEG;IACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,gBAAgB,EAAE,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAClE;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,gDAAgD,EAAE,CAAC,CAAC,WAAW,CAC1E,kCAAkC,EAClC,OAAO,CAIP,CAAC;AAEH,wBAAgB,0CAA0C,CACxD,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,kCAAkC,EAAE,kBAAkB,CAAC,CAOzE;AAED,gBAAgB;AAChB,eAAO,MAAM,sDAAsD,EACjE,CAAC,CAAC,WAAW,CAAC,wCAAwC,EAAE,OAAO,CAG7D,CAAC;AAEL,wBAAgB,gDAAgD,CAC9D,UAAU,EAAE,MAAM,GACjB,eAAe,CAChB,wCAAwC,EACxC,kBAAkB,CACnB,CASA;AAED,gBAAgB;AAChB,eAAO,MAAM,uCAAuC,EAAE,CAAC,CAAC,WAAW,CACjE,yBAAyB,EACzB,OAAO,CAyBP,CAAC;AAEH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,yBAAyB,EAAE,kBAAkB,CAAC,CAMhE"}

package/dist/esm/models/helix-session-restore-result.js

@@ -0,0 +1,49 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as types from "../types/primitives.js";
+import { WorkspaceDrift$inboundSchema, } from "./workspace-drift.js";
+/** @internal */
+export const HelixSessionRestoreResultWorkspace$inboundSchema = z.object({
+    files: types.number(),
+    bytes: types.number(),
+});
+export function helixSessionRestoreResultWorkspaceFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => HelixSessionRestoreResultWorkspace$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'HelixSessionRestoreResultWorkspace' from JSON`);
+}
+/** @internal */
+export const HelixSessionRestoreResultSkippedSnapshot$inboundSchema = z.object({
+    id: types.string(),
+    reason: types.string(),
+});
+export function helixSessionRestoreResultSkippedSnapshotFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => HelixSessionRestoreResultSkippedSnapshot$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'HelixSessionRestoreResultSkippedSnapshot' from JSON`);
+}
+/** @internal */
+export const HelixSessionRestoreResult$inboundSchema = z.object({
+    restored: types.boolean(),
+    sandboxId: types.string(),
+    generation: types.number(),
+    snapshotId: types.string(),
+    sessionId: types.string(),
+    harnessSessionId: types.string(),
+    cwd: types.nullable(types.string()),
+    bytes: types.number(),
+    sha256: types.string(),
+    seq: types.number(),
+    settingsReplayed: z.array(types.string()),
+    queueReplayed: types.number(),
+    workspace: types.nullable(z.lazy(() => HelixSessionRestoreResultWorkspace$inboundSchema)),
+    workspaceDrift: WorkspaceDrift$inboundSchema,
+    notRestored: z.array(types.string()),
+    partial: types.boolean(),
+    partialBytes: types.number(),
+    skippedSnapshots: z.array(z.lazy(() => HelixSessionRestoreResultSkippedSnapshot$inboundSchema)),
+    reference: types.string(),
+});
+export function helixSessionRestoreResultFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => HelixSessionRestoreResult$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'HelixSessionRestoreResult' from JSON`);
+}
+//# sourceMappingURL=helix-session-restore-result.js.map

package/dist/esm/models/helix-session-restore-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-restore-result.js","sourceRoot":"","sources":["../../../src/models/helix-session-restore-result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAEL,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAwF9B,gBAAgB;AAChB,MAAM,CAAC,MAAM,gDAAgD,GAGzD,CAAC,CAAC,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,0CAA0C,CACxD,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CACJ,gDAAgD,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACvE,gEAAgE,CACjE,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,sDAAsD,GACE,CAAC,CAAC,MAAM,CAAC;IAC1E,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEL,MAAM,UAAU,gDAAgD,CAC9D,UAAkB;IAKlB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CACJ,sDAAsD,CAAC,KAAK,CAC1D,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CACd,EACH,sEAAsE,CACvE,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,uCAAuC,GAGhD,CAAC,CAAC,MAAM,CAAC;IACX,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE;IACzB,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;IACzB,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE;IAC1B,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;IACzB,gBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE;IAChC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACnC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;IACtB,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE;IACnB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACzC,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE;IAC7B,SAAS,EAAE,KAAK,CAAC,QAAQ,CACvB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,gDAAgD,CAAC,CAC/D;IACD,cAAc,EAAE,4BAA4B;IAC5C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACpC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;IACxB,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE;IAC5B,gBAAgB,EAAE,CAAC,CAAC,KAAK,CACvB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,sDAAsD,CAAC,CACrE;IACD,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,UAAU,iCAAiC,CAC/C,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,uCAAuC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACnE,uDAAuD,CACxD,CAAC;AACJ,CAAC"}

package/dist/esm/models/helix-session-signal-request.d.ts

@@ -0,0 +1,19 @@
+import * as z from "zod/v4-mini";
+import { HelixSignal } from "./helix-signal.js";
+/**
+ * Omitted `signal` sends SIGTERM.
+ */
+export type HelixSessionSignalRequest = {
+    /**
+     * `SIGINT` or `SIGTERM`. Both stop the session's Helix process; the sandbox keeps running. To end only the current turn, send an `abort` command as input instead.
+     */
+    signal?: HelixSignal | undefined;
+};
+/** @internal */
+export type HelixSessionSignalRequest$Outbound = {
+    signal?: string | undefined;
+};
+/** @internal */
+export declare const HelixSessionSignalRequest$outboundSchema: z.ZodMiniType<HelixSessionSignalRequest$Outbound, HelixSessionSignalRequest>;
+export declare function helixSessionSignalRequestToJSON(helixSessionSignalRequest: HelixSessionSignalRequest): string;
+//# sourceMappingURL=helix-session-signal-request.d.ts.map

package/dist/esm/models/helix-session-signal-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-signal-request.d.ts","sourceRoot":"","sources":["../../../src/models/helix-session-signal-request.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,wCAAwC,EAAE,CAAC,CAAC,WAAW,CAClE,kCAAkC,EAClC,yBAAyB,CAGzB,CAAC;AAEH,wBAAgB,+BAA+B,CAC7C,yBAAyB,EAAE,yBAAyB,GACnD,MAAM,CAIR"}

package/dist/esm/models/helix-session-signal-request.js

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { HelixSignal$outboundSchema } from "./helix-signal.js";
+/** @internal */
+export const HelixSessionSignalRequest$outboundSchema = z.object({
+    signal: z.optional(HelixSignal$outboundSchema),
+});
+export function helixSessionSignalRequestToJSON(helixSessionSignalRequest) {
+    return JSON.stringify(HelixSessionSignalRequest$outboundSchema.parse(helixSessionSignalRequest));
+}
+//# sourceMappingURL=helix-session-signal-request.js.map

package/dist/esm/models/helix-session-signal-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-signal-request.js","sourceRoot":"","sources":["../../../src/models/helix-session-signal-request.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAe,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAiB5E,gBAAgB;AAChB,MAAM,CAAC,MAAM,wCAAwC,GAGjD,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,UAAU,+BAA+B,CAC7C,yBAAoD;IAEpD,OAAO,IAAI,CAAC,SAAS,CACnB,wCAAwC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAC1E,CAAC;AACJ,CAAC"}

package/dist/esm/models/helix-session-status.d.ts

@@ -0,0 +1,18 @@
+import * as z from "zod/v4-mini";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * `ended` — an `exited` frame is persisted (`exitCode` carries what the sandbox reported). `stopped-for-idling` — never exited, and the sandbox was reaped by the idle sweep. `restored` — running on a sandbox rebuilt from a checkpoint. `live` — everything else: no terminal frame and a live record.
+ */
+export declare enum HelixSessionStatus {
+    Live = "live",
+    Ended = "ended",
+    StoppedForIdling = "stopped-for-idling",
+    Restored = "restored"
+}
+/**
+ * `ended` — an `exited` frame is persisted (`exitCode` carries what the sandbox reported). `stopped-for-idling` — never exited, and the sandbox was reaped by the idle sweep. `restored` — running on a sandbox rebuilt from a checkpoint. `live` — everything else: no terminal frame and a live record.
+ */
+export type HelixSessionStatusOpen = OpenEnum<typeof HelixSessionStatus>;
+/** @internal */
+export declare const HelixSessionStatus$inboundSchema: z.ZodMiniType<HelixSessionStatusOpen, unknown>;
+//# sourceMappingURL=helix-session-status.d.ts.map

package/dist/esm/models/helix-session-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-status.d.ts","sourceRoot":"","sources":["../../../src/models/helix-session-status.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,KAAK,UAAU;IACf,gBAAgB,uBAAuB;IACvC,QAAQ,aAAa;CACtB;AACD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEzE,gBAAgB;AAChB,eAAO,MAAM,gCAAgC,EAAE,CAAC,CAAC,WAAW,CAC1D,sBAAsB,EACtB,OAAO,CACsC,CAAC"}

package/dist/esm/models/helix-session-status.js

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * `ended` — an `exited` frame is persisted (`exitCode` carries what the sandbox reported). `stopped-for-idling` — never exited, and the sandbox was reaped by the idle sweep. `restored` — running on a sandbox rebuilt from a checkpoint. `live` — everything else: no terminal frame and a live record.
+ */
+export var HelixSessionStatus;
+(function (HelixSessionStatus) {
+    HelixSessionStatus["Live"] = "live";
+    HelixSessionStatus["Ended"] = "ended";
+    HelixSessionStatus["StoppedForIdling"] = "stopped-for-idling";
+    HelixSessionStatus["Restored"] = "restored";
+})(HelixSessionStatus || (HelixSessionStatus = {}));
+/** @internal */
+export const HelixSessionStatus$inboundSchema = openEnums.inboundSchema(HelixSessionStatus);
+//# sourceMappingURL=helix-session-status.js.map

package/dist/esm/models/helix-session-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-status.js","sourceRoot":"","sources":["../../../src/models/helix-session-status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAG/C;;GAEG;AACH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,qCAAe,CAAA;IACf,6DAAuC,CAAA;IACvC,2CAAqB,CAAA;AACvB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAMD,gBAAgB;AAChB,MAAM,CAAC,MAAM,gCAAgC,GAGzC,SAAS,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/esm/models/helix-session-summary.d.ts

@@ -0,0 +1,67 @@
+import * as z from "zod/v4-mini";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import { HelixArmOpen } from "./helix-arm.js";
+import { HelixSessionStatusOpen } from "./helix-session-status.js";
+import { ModeOpen } from "./mode.js";
+/**
+ * One Helix session of the workspace. Carries addressing (reference, sandbox), what it is (arm, mode, status) and where it stands (seq, activity) — and NOTHING from the session environment: no variable names, no model keys, no argv. A prompt is content; a listing is metadata.
+ */
+export type HelixSessionSummary = {
+    /**
+     * The live execution reference (`hs1_…`) — the exact value attach/send/signal/checkpoint take. Derived from the sandbox id and session id, so it resolves for ended sessions too.
+     */
+    reference: string;
+    /**
+     * The sandbox the session ran (or runs) on.
+     */
+    sandboxId: string;
+    /**
+     * The sandbox INSTANCE this session belongs to, from its own lifecycle frames — not merely the record's current value, which a restore advances out from under older sessions.
+     */
+    generation: number;
+    /**
+     * The sandbox's CPU architecture (`sandbox_records.arch`).
+     */
+    arch: string;
+    /**
+     * `ended` — an `exited` frame is persisted (`exitCode` carries what the sandbox reported). `stopped-for-idling` — never exited, and the sandbox was reaped by the idle sweep. `restored` — running on a sandbox rebuilt from a checkpoint. `live` — everything else: no terminal frame and a live record.
+     */
+    status: HelixSessionStatusOpen;
+    /**
+     * On an `ended` session, the exit code its `exited` frame carried — null when the sandbox named none. Never synthesised, and never present on a session that did not end.
+     */
+    exitCode?: number | null | undefined;
+    /**
+     * Which Helix program runs: `classic` (`helix`, with the orchestrator loaded), `prime` (`helix --prime`), or `agent` (`helix agent`; add `--prime` in `args` for the Prime agent).
+     */
+    arm?: HelixArmOpen | undefined;
+    /**
+     * `headless`: the session runs the task in its arguments to completion and ends; it takes no input. `interactive`: the session stays open, reads JSON commands on stdin, and emits `rpc` events on the stream.
+     */
+    mode?: ModeOpen | undefined;
+    /**
+     * On a `restored` session, the checkpoint it was restored from.
+     */
+    snapshotId?: string | undefined;
+    /**
+     * For a session launched from a managed agent, `slug:vN`: the agent and the revision it runs. Absent otherwise.
+     */
+    agent?: string | undefined;
+    /**
+     * When the first frame attributed to this session was logged.
+     */
+    createdAt: Date;
+    /**
+     * When the last frame attributed to this session was logged — the sort key, newest first.
+     */
+    lastActivityAt: Date;
+    /**
+     * The highest stream seq over frames attributed to this session. The relay's per-sandbox counter, not the sandbox's own per-session `lastSeq` — usable as a `?since=` position within the sandbox's stream, which `lastSeq` is not.
+     */
+    seqHighWater: number;
+};
+/** @internal */
+export declare const HelixSessionSummary$inboundSchema: z.ZodMiniType<HelixSessionSummary, unknown>;
+export declare function helixSessionSummaryFromJSON(jsonString: string): SafeParseResult<HelixSessionSummary, SDKValidationError>;
+//# sourceMappingURL=helix-session-summary.d.ts.map

package/dist/esm/models/helix-session-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-summary.d.ts","sourceRoot":"","sources":["../../../src/models/helix-session-summary.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAA0B,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAEL,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAsB,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,GAAG,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAChB;;OAEG;IACH,cAAc,EAAE,IAAI,CAAC;IACrB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,WAAW,CAC3D,mBAAmB,EACnB,OAAO,CAeP,CAAC;AAEH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAM1D"}

package/dist/esm/models/helix-session-summary.js

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as types from "../types/primitives.js";
+import { HelixArm$inboundSchema } from "./helix-arm.js";
+import { HelixSessionStatus$inboundSchema, } from "./helix-session-status.js";
+import { Mode$inboundSchema } from "./mode.js";
+/** @internal */
+export const HelixSessionSummary$inboundSchema = z.object({
+    reference: types.string(),
+    sandboxId: types.string(),
+    generation: types.number(),
+    arch: types.string(),
+    status: HelixSessionStatus$inboundSchema,
+    exitCode: z.optional(z.nullable(types.number())),
+    arm: types.optional(HelixArm$inboundSchema),
+    mode: types.optional(Mode$inboundSchema),
+    snapshotId: types.optional(types.string()),
+    agent: types.optional(types.string()),
+    createdAt: types.date(),
+    lastActivityAt: types.date(),
+    seqHighWater: types.number(),
+});
+export function helixSessionSummaryFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => HelixSessionSummary$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'HelixSessionSummary' from JSON`);
+}
+//# sourceMappingURL=helix-session-summary.js.map

package/dist/esm/models/helix-session-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-session-summary.js","sourceRoot":"","sources":["../../../src/models/helix-session-summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAgB,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,gCAAgC,GAEjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAY,MAAM,WAAW,CAAC;AA4DzD,gBAAgB;AAChB,MAAM,CAAC,MAAM,iCAAiC,GAG1C,CAAC,CAAC,MAAM,CAAC;IACX,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;IACzB,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;IACzB,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE;IAC1B,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,gCAAgC;IACxC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC3C,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACxC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC1C,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACrC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE;IACvB,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE;IAC5B,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CACzC,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,iCAAiC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAC7D,iDAAiD,CAClD,CAAC;AACJ,CAAC"}

package/dist/esm/models/helix-signal.d.ts

@@ -0,0 +1,11 @@
+import * as z from "zod/v4-mini";
+/**
+ * `SIGINT` or `SIGTERM`. Both stop the session's Helix process; the sandbox keeps running. To end only the current turn, send an `abort` command as input instead.
+ */
+export declare enum HelixSignal {
+    Sigint = "SIGINT",
+    Sigterm = "SIGTERM"
+}
+/** @internal */
+export declare const HelixSignal$outboundSchema: z.ZodMiniEnum<typeof HelixSignal>;
+//# sourceMappingURL=helix-signal.d.ts.map

package/dist/esm/models/helix-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-signal.d.ts","sourceRoot":"","sources":["../../../src/models/helix-signal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC;;GAEG;AACH,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,gBAAgB;AAChB,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO,WAAW,CACrD,CAAC"}

package/dist/esm/models/helix-signal.js

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+/**
+ * `SIGINT` or `SIGTERM`. Both stop the session's Helix process; the sandbox keeps running. To end only the current turn, send an `abort` command as input instead.
+ */
+export var HelixSignal;
+(function (HelixSignal) {
+    HelixSignal["Sigint"] = "SIGINT";
+    HelixSignal["Sigterm"] = "SIGTERM";
+})(HelixSignal || (HelixSignal = {}));
+/** @internal */
+export const HelixSignal$outboundSchema = z
+    .enum(HelixSignal);
+//# sourceMappingURL=helix-signal.js.map

package/dist/esm/models/helix-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-signal.js","sourceRoot":"","sources":["../../../src/models/helix-signal.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACrB,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,0BAA0B,GAAsC,CAAC;KAC3E,IAAI,CAAC,WAAW,CAAC,CAAC"}