@mutagent/sdk 0.11.6 → 0.12.1

package/dist/commonjs/sdk/helix-sessions.d.ts

@@ -3,45 +3,102 @@ import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
 export declare class HelixSessions extends ClientSDK {
     /**
-     * Launch a Helix session
+     * Launch a session (the helix harness)
      *
      * @remarks
-     * Uses the configured Helix preset and sandbox provider. Defaults: arm `classic`, mode `interactive`. With `agent`, runs a managed agent: the slot (agent and `environment`) selects the revision, the revision is copied into the sandbox and started on the `agent` arm, and the response names `agent.slug` and `agent.revision`. Returns the session reference. If the new sandbox cannot be set up, the start is refused after the sandbox is released: 503 `SANDBOX_SETUP_TIMEOUT` when setup ran out of time (retry), 502 `SANDBOX_SETUP_FAILED` when it failed. Disconnecting does not stop the session; an idle sandbox stops after 15 minutes.
+     * Starts a session of the helix harness. With `harness` helix: the configured Helix preset and sandbox provider; defaults: arm `classic`, mode `interactive`; with `agent`, runs a managed agent (the slot, agent and `environment`, selects the revision; the response names `agent.slug` and `agent.revision`). A harness preset (another harness) is a 422 `SESSION_HARNESS_MISMATCH`. Returns the session reference. If the new sandbox cannot be set up, the start is refused after the sandbox is released: 503 `SANDBOX_SETUP_TIMEOUT` (retry) or 502 `SANDBOX_SETUP_FAILED`. Disconnecting does not stop the session; an idle sandbox stops after 15 minutes.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    launchHelixSession(request: models.HelixLaunchRequest, options?: RequestOptions): Promise<models.HelixLaunchedSession>;
+    launchHelixSessionDeprecated(request: models.HelixLaunchRequest, options?: RequestOptions): Promise<models.HelixLaunchedSession>;
     /**
-     * List the workspace's Helix sessions across all sandboxes
+     * List the workspace's sessions (the helix harness)
      *
      * @remarks
-     * Every Helix session the workspace has, live and ended, in every sandbox, newest activity first. Assembled from the persisted event log and the sandbox records: a live row is a session with no terminal frame in a live sandbox, ended rows carry the exit code, a session whose sandbox was stopped for idling is `stopped-for-idling`, and a session in a restored sandbox is `restored`. Each row has `reference`, `sandboxId`, `arm` and `mode` (when known), `seqHighWater` and activity times, and no Environment values. Requires `sandbox:read`. Paged: pass `nextCursor` back as `?cursor=`.
+     * The workspace's sessions of the helix harness only. Live and ended, in every sandbox, newest activity first. A live row is a session with no terminal frame in a live sandbox, ended rows carry the exit code, a session whose sandbox was stopped for idling is `stopped-for-idling`, and a session in a restored sandbox is `restored`. Each row has `reference`, `sandboxId`, `arm` and `mode` (when known), `caller` and `harness`, `seqHighWater` and activity times, and no Environment values. Requires `sandbox:read`. Paged: pass `nextCursor` back as `?cursor=`. With a filter, one request reads a bounded number of sessions, so a page can hold fewer rows than `limit` (even none) while `nextCursor` is present: keep paging until it is absent.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    listHelixSessions(request?: operations.ListHelixSessionsRequest | undefined, options?: RequestOptions): Promise<models.HelixSessionList>;
+    listHelixSessionsDeprecated(request?: operations.ListHelixSessionsDeprecatedRequest | undefined, options?: RequestOptions): Promise<models.HelixSessionList>;
     /**
      * Send a JSON command to a session
      *
      * @remarks
-     * `line` is one serialised JSON object. Requires `sandbox:exec` on the session's workspace. Helix's reply arrives on the session stream. A session whose sandbox no longer runs it is ended and, when it can be, restored from its last checkpoint and sent the line (`wake`); otherwise 410 `SESSION_GONE`.
+     * `line` is one serialised JSON object. Requires `sandbox:exec` on the session's workspace. The reply arrives on the session stream. A session whose sandbox no longer runs it is ended and, when it can be, restored from its last checkpoint and sent the line (`wake`); otherwise 410 `SESSION_GONE`.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    sendHelixSessionInput(request: operations.SendHelixSessionInputRequest, options?: RequestOptions): Promise<models.SessionInputAccepted>;
+    sendHelixSessionInputDeprecated(request: operations.SendHelixSessionInputDeprecatedRequest, options?: RequestOptions): Promise<models.SessionInputAccepted>;
     /**
      * Close a session's input
      *
      * @remarks
      * Sends end-of-file to the session's stdin. Calling it again succeeds. It is not an abort and not a signal. A sandbox image that cannot close input answers 422. The session's remaining output and its exit arrive on the stream. 410 `SESSION_GONE` when the session's sandbox no longer runs it.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    closeHelixSessionInput(request: operations.CloseHelixSessionInputRequest, options?: RequestOptions): Promise<operations.CloseHelixSessionInputResponse>;
+    closeHelixSessionInputDeprecated(request: operations.CloseHelixSessionInputDeprecatedRequest, options?: RequestOptions): Promise<operations.CloseHelixSessionInputDeprecatedResponse>;
     /**
-     * End a Helix session
+     * End a session
      *
      * @remarks
      * Ends the session and removes the sandbox that hosts it, with every other session on it. Requires an operator token on the session's workspace (`sandbox:delete`), or the session's OWN sandbox token, which may end its own session only; any other sandbox token is 403 `SESSION_NOT_OWN`. A reference with no live session in the workspace is 404 `SESSION_NOT_FOUND`. Answers name the session reference only.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    endHelixSession(request: operations.EndHelixSessionRequest, options?: RequestOptions): Promise<models.HelixSessionEndResponse>;
+    endHelixSessionDeprecated(request: operations.EndHelixSessionDeprecatedRequest, options?: RequestOptions): Promise<models.HelixSessionEndResponse>;
     /**
-     * Refresh a running session's sandbox token
+     * Stop a session's live process
+     *
+     * @remarks
+     * Signals this session's process. The sandbox keeps running. Omitted `signal` sends SIGTERM. 409 when the session has already ended.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    signalHelixSessionDeprecated(request: operations.SignalHelixSessionDeprecatedRequest, options?: RequestOptions): Promise<models.SessionSignalled>;
+    /**
+     * Checkpoint a session
+     *
+     * @remarks
+     * Saves the session's transcript and, where supported, its working directory and settings. 409 before the session has finished a turn.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    checkpointHelixSessionDeprecated(request: operations.CheckpointHelixSessionDeprecatedRequest, options?: RequestOptions): Promise<models.Checkpoint>;
+    /**
+     * List the checkpoints of a session's sandbox
+     *
+     * @remarks
+     * Newest first, without the stored bytes. Covers every session the sandbox has hosted; each row names its session. Requires `sandbox:read`.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    listHelixSessionCheckpointsDeprecated(request: operations.ListHelixSessionCheckpointsDeprecatedRequest, options?: RequestOptions): Promise<models.CheckpointList>;
+    /**
+     * Restore a session from a checkpoint
+     *
+     * @remarks
+     * Rebuilds the session's sandbox from a checkpoint and starts a new session of the same harness; the response carries the new session reference. The old sandbox does not need to exist. Same body as `POST /api/sandbox/{id}/restore`. A session that ran a managed agent restores with the same revision re-staged and its environment rebuilt. It is refused with 409 `MANAGED_AGENT_REVISION_UNAVAILABLE`, `MANAGED_AGENT_SLOT_UNAVAILABLE`, `MANAGED_AGENT_SLOT_RETIRED` or `MANAGED_AGENT_ARCHIVED`, or 404 `AGENT_NOT_FOUND`, when the revision, the slot or the agent is gone, retired or archived, and with 409 `MANAGED_AGENT_RESTORE_UNSUPPORTED` when its checkpoint predates the agent record.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    restoreHelixSessionDeprecated(request: operations.RestoreHelixSessionDeprecatedRequest, options?: RequestOptions): Promise<models.HelixSessionRestoreResult>;
+    /**
+     * Stream a session's output
+     *
+     * @remarks
+     * Server-sent events for this session only; pass `?since=<seq>` to resume. The stream ends when the session exits. `rpc` events carry the harness's JSON lines unchanged; the event name refers to the JSON-lines RPC protocol, not to the session mode. Disconnecting does not stop the session. After an API restart the stream can open with `live: false` and replay stored events only.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    streamHelixSessionDeprecated(request: operations.StreamHelixSessionDeprecatedRequest, options?: RequestOptions): Promise<string>;
+    /**
+     * Refresh a running session's sandbox token (deprecated: POST /api/sandbox/sessions/token)
      *
      * @remarks
      * A session's task token lives one hour. Its Helix process trades its LIVE token for a fresh one before it expires: the same session and scopes, a new expiry. Only a session's own token, while its sandbox exists (404 otherwise); an expired token is 401 and cannot be revived; any other token 403.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     refreshHelixSessionToken(options?: RequestOptions): Promise<models.HelixSessionToken>;
     /**
@@ -52,14 +109,63 @@ export declare class HelixSessions extends ClientSDK {
      */
     getHelixAccess(options?: RequestOptions): Promise<models.SandboxAccess>;
     /**
-     * Stop a live Helix process
+     * List the workspace's Helix Cloud models and its default
+     *
+     * @remarks
+     * The platform model catalog restricted to the workspace's active LLM providers, each as `provider/model` as Helix names it, plus the stored ordered defaults and the model a run that names none uses now. LLM providers whose keys Helix cannot load are listed in `unmapped`. Requires `sandbox:read`.
+     */
+    getHelixModels(options?: RequestOptions): Promise<models.HelixModelList>;
+    /**
+     * Set the workspace's default Helix Cloud models
+     *
+     * @remarks
+     * Replaces the ordered list; the first entry becomes the default for session starts and agent runs that name no model. Every entry must be in the workspace’s list (422 names the list). `[]` clears the defaults, after which such runs answer 428 NO_PROVIDER_CONFIGURED. Operator tokens only. 409 `HELIX_DEFAULTS_UNAVAILABLE` when this server has no Helix Cloud model source configured.
+     */
+    setHelixDefaultModels(request: models.HelixDefaultModelsRequest, options?: RequestOptions): Promise<models.HelixModelList>;
+    /**
+     * Launch a session (the helix harness)
      *
      * @remarks
-     * Signals this session's Helix process. The sandbox keeps running. Omitted `signal` sends SIGTERM. 409 when the session has already ended.
+     * Starts a session of the helix harness. With `harness` helix: the configured Helix preset and sandbox provider; defaults: arm `classic`, mode `interactive`; with `agent`, runs a managed agent (the slot, agent and `environment`, selects the revision; the response names `agent.slug` and `agent.revision`). A harness preset (another harness) is a 422 `SESSION_HARNESS_MISMATCH`. Returns the session reference. If the new sandbox cannot be set up, the start is refused after the sandbox is released: 503 `SANDBOX_SETUP_TIMEOUT` (retry) or 502 `SANDBOX_SETUP_FAILED`. Disconnecting does not stop the session; an idle sandbox stops after 15 minutes.
+     */
+    launchHelixSession(request: models.HelixLaunchRequest, options?: RequestOptions): Promise<models.HelixLaunchedSession>;
+    /**
+     * List the workspace's sessions (the helix harness)
+     *
+     * @remarks
+     * The workspace's sessions of the helix harness only. Live and ended, in every sandbox, newest activity first. A live row is a session with no terminal frame in a live sandbox, ended rows carry the exit code, a session whose sandbox was stopped for idling is `stopped-for-idling`, and a session in a restored sandbox is `restored`. Each row has `reference`, `sandboxId`, `arm` and `mode` (when known), `caller` and `harness`, `seqHighWater` and activity times, and no Environment values. Requires `sandbox:read`. Paged: pass `nextCursor` back as `?cursor=`. With a filter, one request reads a bounded number of sessions, so a page can hold fewer rows than `limit` (even none) while `nextCursor` is present: keep paging until it is absent.
+     */
+    listHelixSessions(request?: operations.ListHelixSessionsRequest | undefined, options?: RequestOptions): Promise<models.HelixSessionList>;
+    /**
+     * Send a JSON command to a session
+     *
+     * @remarks
+     * `line` is one serialised JSON object. Requires `sandbox:exec` on the session's workspace. The reply arrives on the session stream. A session whose sandbox no longer runs it is ended and, when it can be, restored from its last checkpoint and sent the line (`wake`); otherwise 410 `SESSION_GONE`.
+     */
+    sendHelixSessionInput(request: operations.SendHelixSessionInputRequest, options?: RequestOptions): Promise<models.SessionInputAccepted>;
+    /**
+     * Close a session's input
+     *
+     * @remarks
+     * Sends end-of-file to the session's stdin. Calling it again succeeds. It is not an abort and not a signal. A sandbox image that cannot close input answers 422. The session's remaining output and its exit arrive on the stream. 410 `SESSION_GONE` when the session's sandbox no longer runs it.
+     */
+    closeHelixSessionInput(request: operations.CloseHelixSessionInputRequest, options?: RequestOptions): Promise<operations.CloseHelixSessionInputResponse>;
+    /**
+     * End a session
+     *
+     * @remarks
+     * Ends the session and removes the sandbox that hosts it, with every other session on it. Requires an operator token on the session's workspace (`sandbox:delete`), or the session's OWN sandbox token, which may end its own session only; any other sandbox token is 403 `SESSION_NOT_OWN`. A reference with no live session in the workspace is 404 `SESSION_NOT_FOUND`. Answers name the session reference only.
+     */
+    endHelixSession(request: operations.EndHelixSessionRequest, options?: RequestOptions): Promise<models.HelixSessionEndResponse>;
+    /**
+     * Stop a session's live process
+     *
+     * @remarks
+     * Signals this session's process. The sandbox keeps running. Omitted `signal` sends SIGTERM. 409 when the session has already ended.
      */
     signalHelixSession(request: operations.SignalHelixSessionRequest, options?: RequestOptions): Promise<models.SessionSignalled>;
     /**
-     * Checkpoint a Helix session
+     * Checkpoint a session
      *
      * @remarks
      * Saves the session's transcript and, where supported, its working directory and settings. 409 before the session has finished a turn.
@@ -76,29 +182,15 @@ export declare class HelixSessions extends ClientSDK {
      * Restore a session from a checkpoint
      *
      * @remarks
-     * Rebuilds the session's sandbox from a checkpoint and starts a new session; the response carries the new session reference. The old sandbox does not need to exist. Same body as `POST /api/sandbox/{id}/restore`. A session that ran a managed agent restores with the same revision re-staged and its environment rebuilt. It is refused with 409 `MANAGED_AGENT_REVISION_UNAVAILABLE`, `MANAGED_AGENT_SLOT_UNAVAILABLE`, `MANAGED_AGENT_SLOT_RETIRED` or `MANAGED_AGENT_ARCHIVED`, or 404 `AGENT_NOT_FOUND`, when the revision, the slot or the agent is gone, retired or archived, and with 409 `MANAGED_AGENT_RESTORE_UNSUPPORTED` when its checkpoint predates the agent record.
+     * Rebuilds the session's sandbox from a checkpoint and starts a new session of the same harness; the response carries the new session reference. The old sandbox does not need to exist. Same body as `POST /api/sandbox/{id}/restore`. A session that ran a managed agent restores with the same revision re-staged and its environment rebuilt. It is refused with 409 `MANAGED_AGENT_REVISION_UNAVAILABLE`, `MANAGED_AGENT_SLOT_UNAVAILABLE`, `MANAGED_AGENT_SLOT_RETIRED` or `MANAGED_AGENT_ARCHIVED`, or 404 `AGENT_NOT_FOUND`, when the revision, the slot or the agent is gone, retired or archived, and with 409 `MANAGED_AGENT_RESTORE_UNSUPPORTED` when its checkpoint predates the agent record.
      */
     restoreHelixSession(request: operations.RestoreHelixSessionRequest, options?: RequestOptions): Promise<models.HelixSessionRestoreResult>;
     /**
      * Stream a session's output
      *
      * @remarks
-     * Server-sent events for this session only; pass `?since=<seq>` to resume. The stream ends when the session exits. `rpc` events carry Helix's JSON lines unchanged; the event name refers to the JSON-lines RPC protocol Helix speaks, not to the session mode. Disconnecting does not stop the session. After an API restart the stream can open with `live: false` and replay stored events only.
+     * Server-sent events for this session only; pass `?since=<seq>` to resume. The stream ends when the session exits. `rpc` events carry the harness's JSON lines unchanged; the event name refers to the JSON-lines RPC protocol, not to the session mode. Disconnecting does not stop the session. After an API restart the stream can open with `live: false` and replay stored events only.
      */
     streamHelixSession(request: operations.StreamHelixSessionRequest, options?: RequestOptions): Promise<string>;
-    /**
-     * List the workspace's Helix Cloud models and its default
-     *
-     * @remarks
-     * The platform model catalog restricted to the workspace's active LLM providers, each as `provider/model` as Helix names it, plus the stored ordered defaults and the model a run that names none uses now. LLM providers whose keys Helix cannot load are listed in `unmapped`. Requires `sandbox:read`.
-     */
-    getHelixModels(options?: RequestOptions): Promise<models.HelixModelList>;
-    /**
-     * Set the workspace's default Helix Cloud models
-     *
-     * @remarks
-     * Replaces the ordered list; the first entry becomes the default for session starts and agent runs that name no model. Every entry must be in the workspace’s list (422 names the list). `[]` clears the defaults, after which such runs answer 428 NO_PROVIDER_CONFIGURED. Operator tokens only. 409 `HELIX_DEFAULTS_UNAVAILABLE` when this server has no Helix Cloud model source configured.
-     */
-    setHelixDefaultModels(request: models.HelixDefaultModelsRequest, options?: RequestOptions): Promise<models.HelixModelList>;
 }
 //# sourceMappingURL=helix-sessions.d.ts.map

package/dist/commonjs/sdk/helix-sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helix-sessions.d.ts","sourceRoot":"","sources":["../../../src/sdk/helix-sessions.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAG5D,qBAAa,aAAc,SAAQ,SAAS;IAC1C;;;;;OAKG;IACG,kBAAkB,CACtB,OAAO,EAAE,MAAM,CAAC,kBAAkB,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAQvC;;;;;OAKG;IACG,iBAAiB,CACrB,OAAO,CAAC,EAAE,UAAU,CAAC,wBAAwB,GAAG,SAAS,EACzD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAQnC;;;;;OAKG;IACG,qBAAqB,CACzB,OAAO,EAAE,UAAU,CAAC,4BAA4B,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAQvC;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,UAAU,CAAC,6BAA6B,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC;IAQrD;;;;;OAKG;IACG,eAAe,CACnB,OAAO,EAAE,UAAU,CAAC,sBAAsB,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAQ1C;;;;;OAKG;IACG,wBAAwB,CAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAOpC;;;;;OAKG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;IAOhC;;;;;OAKG;IACG,kBAAkB,CACtB,OAAO,EAAE,UAAU,CAAC,yBAAyB,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAQnC;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,UAAU,CAAC,6BAA6B,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IAQ7B;;;;;OAKG;IACG,2BAA2B,CAC/B,OAAO,EAAE,UAAU,CAAC,kCAAkC,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAQjC;;;;;OAKG;IACG,mBAAmB,CACvB,OAAO,EAAE,UAAU,CAAC,0BAA0B,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC;IAQ5C;;;;;OAKG;IACG,kBAAkB,CACtB,OAAO,EAAE,UAAU,CAAC,yBAAyB,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;;OAKG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAOjC;;;;;OAKG;IACG,qBAAqB,CACzB,OAAO,EAAE,MAAM,CAAC,yBAAyB,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;CAOlC"}
+{"version":3,"file":"helix-sessions.d.ts","sourceRoot":"","sources":["../../../src/sdk/helix-sessions.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/sdk/helix-sessions.js

@@ -4,73 +4,150 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HelixSessions = void 0;
+const helix_sessions_checkpoint_helix_session_deprecated_js_1 = require("../funcs/helix-sessions-checkpoint-helix-session-deprecated.js");
 const helix_sessions_checkpoint_helix_session_js_1 = require("../funcs/helix-sessions-checkpoint-helix-session.js");
+const helix_sessions_close_helix_session_input_deprecated_js_1 = require("../funcs/helix-sessions-close-helix-session-input-deprecated.js");
 const helix_sessions_close_helix_session_input_js_1 = require("../funcs/helix-sessions-close-helix-session-input.js");
+const helix_sessions_end_helix_session_deprecated_js_1 = require("../funcs/helix-sessions-end-helix-session-deprecated.js");
 const helix_sessions_end_helix_session_js_1 = require("../funcs/helix-sessions-end-helix-session.js");
 const helix_sessions_get_helix_access_js_1 = require("../funcs/helix-sessions-get-helix-access.js");
 const helix_sessions_get_helix_models_js_1 = require("../funcs/helix-sessions-get-helix-models.js");
+const helix_sessions_launch_helix_session_deprecated_js_1 = require("../funcs/helix-sessions-launch-helix-session-deprecated.js");
 const helix_sessions_launch_helix_session_js_1 = require("../funcs/helix-sessions-launch-helix-session.js");
+const helix_sessions_list_helix_session_checkpoints_deprecated_js_1 = require("../funcs/helix-sessions-list-helix-session-checkpoints-deprecated.js");
 const helix_sessions_list_helix_session_checkpoints_js_1 = require("../funcs/helix-sessions-list-helix-session-checkpoints.js");
+const helix_sessions_list_helix_sessions_deprecated_js_1 = require("../funcs/helix-sessions-list-helix-sessions-deprecated.js");
 const helix_sessions_list_helix_sessions_js_1 = require("../funcs/helix-sessions-list-helix-sessions.js");
 const helix_sessions_refresh_helix_session_token_js_1 = require("../funcs/helix-sessions-refresh-helix-session-token.js");
+const helix_sessions_restore_helix_session_deprecated_js_1 = require("../funcs/helix-sessions-restore-helix-session-deprecated.js");
 const helix_sessions_restore_helix_session_js_1 = require("../funcs/helix-sessions-restore-helix-session.js");
+const helix_sessions_send_helix_session_input_deprecated_js_1 = require("../funcs/helix-sessions-send-helix-session-input-deprecated.js");
 const helix_sessions_send_helix_session_input_js_1 = require("../funcs/helix-sessions-send-helix-session-input.js");
 const helix_sessions_set_helix_default_models_js_1 = require("../funcs/helix-sessions-set-helix-default-models.js");
+const helix_sessions_signal_helix_session_deprecated_js_1 = require("../funcs/helix-sessions-signal-helix-session-deprecated.js");
 const helix_sessions_signal_helix_session_js_1 = require("../funcs/helix-sessions-signal-helix-session.js");
+const helix_sessions_stream_helix_session_deprecated_js_1 = require("../funcs/helix-sessions-stream-helix-session-deprecated.js");
 const helix_sessions_stream_helix_session_js_1 = require("../funcs/helix-sessions-stream-helix-session.js");
 const sdks_js_1 = require("../lib/sdks.js");
 const fp_js_1 = require("../types/fp.js");
 class HelixSessions extends sdks_js_1.ClientSDK {
     /**
-     * Launch a Helix session
+     * Launch a session (the helix harness)
      *
      * @remarks
-     * Uses the configured Helix preset and sandbox provider. Defaults: arm `classic`, mode `interactive`. With `agent`, runs a managed agent: the slot (agent and `environment`) selects the revision, the revision is copied into the sandbox and started on the `agent` arm, and the response names `agent.slug` and `agent.revision`. Returns the session reference. If the new sandbox cannot be set up, the start is refused after the sandbox is released: 503 `SANDBOX_SETUP_TIMEOUT` when setup ran out of time (retry), 502 `SANDBOX_SETUP_FAILED` when it failed. Disconnecting does not stop the session; an idle sandbox stops after 15 minutes.
+     * Starts a session of the helix harness. With `harness` helix: the configured Helix preset and sandbox provider; defaults: arm `classic`, mode `interactive`; with `agent`, runs a managed agent (the slot, agent and `environment`, selects the revision; the response names `agent.slug` and `agent.revision`). A harness preset (another harness) is a 422 `SESSION_HARNESS_MISMATCH`. Returns the session reference. If the new sandbox cannot be set up, the start is refused after the sandbox is released: 503 `SANDBOX_SETUP_TIMEOUT` (retry) or 502 `SANDBOX_SETUP_FAILED`. Disconnecting does not stop the session; an idle sandbox stops after 15 minutes.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    async launchHelixSession(request, options) {
-        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_launch_helix_session_js_1.helixSessionsLaunchHelixSession)(this, request, options));
+    async launchHelixSessionDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_launch_helix_session_deprecated_js_1.helixSessionsLaunchHelixSessionDeprecated)(this, request, options));
     }
     /**
-     * List the workspace's Helix sessions across all sandboxes
+     * List the workspace's sessions (the helix harness)
      *
      * @remarks
-     * Every Helix session the workspace has, live and ended, in every sandbox, newest activity first. Assembled from the persisted event log and the sandbox records: a live row is a session with no terminal frame in a live sandbox, ended rows carry the exit code, a session whose sandbox was stopped for idling is `stopped-for-idling`, and a session in a restored sandbox is `restored`. Each row has `reference`, `sandboxId`, `arm` and `mode` (when known), `seqHighWater` and activity times, and no Environment values. Requires `sandbox:read`. Paged: pass `nextCursor` back as `?cursor=`.
+     * The workspace's sessions of the helix harness only. Live and ended, in every sandbox, newest activity first. A live row is a session with no terminal frame in a live sandbox, ended rows carry the exit code, a session whose sandbox was stopped for idling is `stopped-for-idling`, and a session in a restored sandbox is `restored`. Each row has `reference`, `sandboxId`, `arm` and `mode` (when known), `caller` and `harness`, `seqHighWater` and activity times, and no Environment values. Requires `sandbox:read`. Paged: pass `nextCursor` back as `?cursor=`. With a filter, one request reads a bounded number of sessions, so a page can hold fewer rows than `limit` (even none) while `nextCursor` is present: keep paging until it is absent.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    async listHelixSessions(request, options) {
-        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_list_helix_sessions_js_1.helixSessionsListHelixSessions)(this, request, options));
+    async listHelixSessionsDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_list_helix_sessions_deprecated_js_1.helixSessionsListHelixSessionsDeprecated)(this, request, options));
     }
     /**
      * Send a JSON command to a session
      *
      * @remarks
-     * `line` is one serialised JSON object. Requires `sandbox:exec` on the session's workspace. Helix's reply arrives on the session stream. A session whose sandbox no longer runs it is ended and, when it can be, restored from its last checkpoint and sent the line (`wake`); otherwise 410 `SESSION_GONE`.
+     * `line` is one serialised JSON object. Requires `sandbox:exec` on the session's workspace. The reply arrives on the session stream. A session whose sandbox no longer runs it is ended and, when it can be, restored from its last checkpoint and sent the line (`wake`); otherwise 410 `SESSION_GONE`.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    async sendHelixSessionInput(request, options) {
-        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_send_helix_session_input_js_1.helixSessionsSendHelixSessionInput)(this, request, options));
+    async sendHelixSessionInputDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_send_helix_session_input_deprecated_js_1.helixSessionsSendHelixSessionInputDeprecated)(this, request, options));
     }
     /**
      * Close a session's input
      *
      * @remarks
      * Sends end-of-file to the session's stdin. Calling it again succeeds. It is not an abort and not a signal. A sandbox image that cannot close input answers 422. The session's remaining output and its exit arrive on the stream. 410 `SESSION_GONE` when the session's sandbox no longer runs it.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    async closeHelixSessionInput(request, options) {
-        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_close_helix_session_input_js_1.helixSessionsCloseHelixSessionInput)(this, request, options));
+    async closeHelixSessionInputDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_close_helix_session_input_deprecated_js_1.helixSessionsCloseHelixSessionInputDeprecated)(this, request, options));
     }
     /**
-     * End a Helix session
+     * End a session
      *
      * @remarks
      * Ends the session and removes the sandbox that hosts it, with every other session on it. Requires an operator token on the session's workspace (`sandbox:delete`), or the session's OWN sandbox token, which may end its own session only; any other sandbox token is 403 `SESSION_NOT_OWN`. A reference with no live session in the workspace is 404 `SESSION_NOT_FOUND`. Answers name the session reference only.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
-    async endHelixSession(request, options) {
-        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_end_helix_session_js_1.helixSessionsEndHelixSession)(this, request, options));
+    async endHelixSessionDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_end_helix_session_deprecated_js_1.helixSessionsEndHelixSessionDeprecated)(this, request, options));
+    }
+    /**
+     * Stop a session's live process
+     *
+     * @remarks
+     * Signals this session's process. The sandbox keeps running. Omitted `signal` sends SIGTERM. 409 when the session has already ended.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    async signalHelixSessionDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_signal_helix_session_deprecated_js_1.helixSessionsSignalHelixSessionDeprecated)(this, request, options));
+    }
+    /**
+     * Checkpoint a session
+     *
+     * @remarks
+     * Saves the session's transcript and, where supported, its working directory and settings. 409 before the session has finished a turn.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    async checkpointHelixSessionDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_checkpoint_helix_session_deprecated_js_1.helixSessionsCheckpointHelixSessionDeprecated)(this, request, options));
     }
     /**
-     * Refresh a running session's sandbox token
+     * List the checkpoints of a session's sandbox
+     *
+     * @remarks
+     * Newest first, without the stored bytes. Covers every session the sandbox has hosted; each row names its session. Requires `sandbox:read`.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    async listHelixSessionCheckpointsDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_list_helix_session_checkpoints_deprecated_js_1.helixSessionsListHelixSessionCheckpointsDeprecated)(this, request, options));
+    }
+    /**
+     * Restore a session from a checkpoint
+     *
+     * @remarks
+     * Rebuilds the session's sandbox from a checkpoint and starts a new session of the same harness; the response carries the new session reference. The old sandbox does not need to exist. Same body as `POST /api/sandbox/{id}/restore`. A session that ran a managed agent restores with the same revision re-staged and its environment rebuilt. It is refused with 409 `MANAGED_AGENT_REVISION_UNAVAILABLE`, `MANAGED_AGENT_SLOT_UNAVAILABLE`, `MANAGED_AGENT_SLOT_RETIRED` or `MANAGED_AGENT_ARCHIVED`, or 404 `AGENT_NOT_FOUND`, when the revision, the slot or the agent is gone, retired or archived, and with 409 `MANAGED_AGENT_RESTORE_UNSUPPORTED` when its checkpoint predates the agent record.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    async restoreHelixSessionDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_restore_helix_session_deprecated_js_1.helixSessionsRestoreHelixSessionDeprecated)(this, request, options));
+    }
+    /**
+     * Stream a session's output
+     *
+     * @remarks
+     * Server-sent events for this session only; pass `?since=<seq>` to resume. The stream ends when the session exits. `rpc` events carry the harness's JSON lines unchanged; the event name refers to the JSON-lines RPC protocol, not to the session mode. Disconnecting does not stop the session. After an API restart the stream can open with `live: false` and replay stored events only.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+     */
+    async streamHelixSessionDeprecated(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_stream_helix_session_deprecated_js_1.helixSessionsStreamHelixSessionDeprecated)(this, request, options));
+    }
+    /**
+     * Refresh a running session's sandbox token (deprecated: POST /api/sandbox/sessions/token)
      *
      * @remarks
      * A session's task token lives one hour. Its Helix process trades its LIVE token for a fresh one before it expires: the same session and scopes, a new expiry. Only a session's own token, while its sandbox exists (404 otherwise); an expired token is 401 and cannot be revived; any other token 403.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async refreshHelixSessionToken(options) {
         return (0, fp_js_1.unwrapAsync)((0, helix_sessions_refresh_helix_session_token_js_1.helixSessionsRefreshHelixSessionToken)(this, options));
@@ -85,16 +162,79 @@ class HelixSessions extends sdks_js_1.ClientSDK {
         return (0, fp_js_1.unwrapAsync)((0, helix_sessions_get_helix_access_js_1.helixSessionsGetHelixAccess)(this, options));
     }
     /**
-     * Stop a live Helix process
+     * List the workspace's Helix Cloud models and its default
+     *
+     * @remarks
+     * The platform model catalog restricted to the workspace's active LLM providers, each as `provider/model` as Helix names it, plus the stored ordered defaults and the model a run that names none uses now. LLM providers whose keys Helix cannot load are listed in `unmapped`. Requires `sandbox:read`.
+     */
+    async getHelixModels(options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_get_helix_models_js_1.helixSessionsGetHelixModels)(this, options));
+    }
+    /**
+     * Set the workspace's default Helix Cloud models
+     *
+     * @remarks
+     * Replaces the ordered list; the first entry becomes the default for session starts and agent runs that name no model. Every entry must be in the workspace’s list (422 names the list). `[]` clears the defaults, after which such runs answer 428 NO_PROVIDER_CONFIGURED. Operator tokens only. 409 `HELIX_DEFAULTS_UNAVAILABLE` when this server has no Helix Cloud model source configured.
+     */
+    async setHelixDefaultModels(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_set_helix_default_models_js_1.helixSessionsSetHelixDefaultModels)(this, request, options));
+    }
+    /**
+     * Launch a session (the helix harness)
+     *
+     * @remarks
+     * Starts a session of the helix harness. With `harness` helix: the configured Helix preset and sandbox provider; defaults: arm `classic`, mode `interactive`; with `agent`, runs a managed agent (the slot, agent and `environment`, selects the revision; the response names `agent.slug` and `agent.revision`). A harness preset (another harness) is a 422 `SESSION_HARNESS_MISMATCH`. Returns the session reference. If the new sandbox cannot be set up, the start is refused after the sandbox is released: 503 `SANDBOX_SETUP_TIMEOUT` (retry) or 502 `SANDBOX_SETUP_FAILED`. Disconnecting does not stop the session; an idle sandbox stops after 15 minutes.
+     */
+    async launchHelixSession(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_launch_helix_session_js_1.helixSessionsLaunchHelixSession)(this, request, options));
+    }
+    /**
+     * List the workspace's sessions (the helix harness)
+     *
+     * @remarks
+     * The workspace's sessions of the helix harness only. Live and ended, in every sandbox, newest activity first. A live row is a session with no terminal frame in a live sandbox, ended rows carry the exit code, a session whose sandbox was stopped for idling is `stopped-for-idling`, and a session in a restored sandbox is `restored`. Each row has `reference`, `sandboxId`, `arm` and `mode` (when known), `caller` and `harness`, `seqHighWater` and activity times, and no Environment values. Requires `sandbox:read`. Paged: pass `nextCursor` back as `?cursor=`. With a filter, one request reads a bounded number of sessions, so a page can hold fewer rows than `limit` (even none) while `nextCursor` is present: keep paging until it is absent.
+     */
+    async listHelixSessions(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_list_helix_sessions_js_1.helixSessionsListHelixSessions)(this, request, options));
+    }
+    /**
+     * Send a JSON command to a session
+     *
+     * @remarks
+     * `line` is one serialised JSON object. Requires `sandbox:exec` on the session's workspace. The reply arrives on the session stream. A session whose sandbox no longer runs it is ended and, when it can be, restored from its last checkpoint and sent the line (`wake`); otherwise 410 `SESSION_GONE`.
+     */
+    async sendHelixSessionInput(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_send_helix_session_input_js_1.helixSessionsSendHelixSessionInput)(this, request, options));
+    }
+    /**
+     * Close a session's input
      *
      * @remarks
-     * Signals this session's Helix process. The sandbox keeps running. Omitted `signal` sends SIGTERM. 409 when the session has already ended.
+     * Sends end-of-file to the session's stdin. Calling it again succeeds. It is not an abort and not a signal. A sandbox image that cannot close input answers 422. The session's remaining output and its exit arrive on the stream. 410 `SESSION_GONE` when the session's sandbox no longer runs it.
+     */
+    async closeHelixSessionInput(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_close_helix_session_input_js_1.helixSessionsCloseHelixSessionInput)(this, request, options));
+    }
+    /**
+     * End a session
+     *
+     * @remarks
+     * Ends the session and removes the sandbox that hosts it, with every other session on it. Requires an operator token on the session's workspace (`sandbox:delete`), or the session's OWN sandbox token, which may end its own session only; any other sandbox token is 403 `SESSION_NOT_OWN`. A reference with no live session in the workspace is 404 `SESSION_NOT_FOUND`. Answers name the session reference only.
+     */
+    async endHelixSession(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_end_helix_session_js_1.helixSessionsEndHelixSession)(this, request, options));
+    }
+    /**
+     * Stop a session's live process
+     *
+     * @remarks
+     * Signals this session's process. The sandbox keeps running. Omitted `signal` sends SIGTERM. 409 when the session has already ended.
      */
     async signalHelixSession(request, options) {
         return (0, fp_js_1.unwrapAsync)((0, helix_sessions_signal_helix_session_js_1.helixSessionsSignalHelixSession)(this, request, options));
     }
     /**
-     * Checkpoint a Helix session
+     * Checkpoint a session
      *
      * @remarks
      * Saves the session's transcript and, where supported, its working directory and settings. 409 before the session has finished a turn.
@@ -115,7 +255,7 @@ class HelixSessions extends sdks_js_1.ClientSDK {
      * Restore a session from a checkpoint
      *
      * @remarks
-     * Rebuilds the session's sandbox from a checkpoint and starts a new session; the response carries the new session reference. The old sandbox does not need to exist. Same body as `POST /api/sandbox/{id}/restore`. A session that ran a managed agent restores with the same revision re-staged and its environment rebuilt. It is refused with 409 `MANAGED_AGENT_REVISION_UNAVAILABLE`, `MANAGED_AGENT_SLOT_UNAVAILABLE`, `MANAGED_AGENT_SLOT_RETIRED` or `MANAGED_AGENT_ARCHIVED`, or 404 `AGENT_NOT_FOUND`, when the revision, the slot or the agent is gone, retired or archived, and with 409 `MANAGED_AGENT_RESTORE_UNSUPPORTED` when its checkpoint predates the agent record.
+     * Rebuilds the session's sandbox from a checkpoint and starts a new session of the same harness; the response carries the new session reference. The old sandbox does not need to exist. Same body as `POST /api/sandbox/{id}/restore`. A session that ran a managed agent restores with the same revision re-staged and its environment rebuilt. It is refused with 409 `MANAGED_AGENT_REVISION_UNAVAILABLE`, `MANAGED_AGENT_SLOT_UNAVAILABLE`, `MANAGED_AGENT_SLOT_RETIRED` or `MANAGED_AGENT_ARCHIVED`, or 404 `AGENT_NOT_FOUND`, when the revision, the slot or the agent is gone, retired or archived, and with 409 `MANAGED_AGENT_RESTORE_UNSUPPORTED` when its checkpoint predates the agent record.
      */
     async restoreHelixSession(request, options) {
         return (0, fp_js_1.unwrapAsync)((0, helix_sessions_restore_helix_session_js_1.helixSessionsRestoreHelixSession)(this, request, options));
@@ -124,29 +264,11 @@ class HelixSessions extends sdks_js_1.ClientSDK {
      * Stream a session's output
      *
      * @remarks
-     * Server-sent events for this session only; pass `?since=<seq>` to resume. The stream ends when the session exits. `rpc` events carry Helix's JSON lines unchanged; the event name refers to the JSON-lines RPC protocol Helix speaks, not to the session mode. Disconnecting does not stop the session. After an API restart the stream can open with `live: false` and replay stored events only.
+     * Server-sent events for this session only; pass `?since=<seq>` to resume. The stream ends when the session exits. `rpc` events carry the harness's JSON lines unchanged; the event name refers to the JSON-lines RPC protocol, not to the session mode. Disconnecting does not stop the session. After an API restart the stream can open with `live: false` and replay stored events only.
      */
     async streamHelixSession(request, options) {
         return (0, fp_js_1.unwrapAsync)((0, helix_sessions_stream_helix_session_js_1.helixSessionsStreamHelixSession)(this, request, options));
     }
-    /**
-     * List the workspace's Helix Cloud models and its default
-     *
-     * @remarks
-     * The platform model catalog restricted to the workspace's active LLM providers, each as `provider/model` as Helix names it, plus the stored ordered defaults and the model a run that names none uses now. LLM providers whose keys Helix cannot load are listed in `unmapped`. Requires `sandbox:read`.
-     */
-    async getHelixModels(options) {
-        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_get_helix_models_js_1.helixSessionsGetHelixModels)(this, options));
-    }
-    /**
-     * Set the workspace's default Helix Cloud models
-     *
-     * @remarks
-     * Replaces the ordered list; the first entry becomes the default for session starts and agent runs that name no model. Every entry must be in the workspace’s list (422 names the list). `[]` clears the defaults, after which such runs answer 428 NO_PROVIDER_CONFIGURED. Operator tokens only. 409 `HELIX_DEFAULTS_UNAVAILABLE` when this server has no Helix Cloud model source configured.
-     */
-    async setHelixDefaultModels(request, options) {
-        return (0, fp_js_1.unwrapAsync)((0, helix_sessions_set_helix_default_models_js_1.helixSessionsSetHelixDefaultModels)(this, request, options));
-    }
 }
 exports.HelixSessions = HelixSessions;
 //# sourceMappingURL=helix-sessions.js.map

package/dist/commonjs/sdk/helix-sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"helix-sessions.js","sourceRoot":"","sources":["../../../src/sdk/helix-sessions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helix-sessions.js","sourceRoot":"","sources":["../../../src/sdk/helix-sessions.ts"],"names":[],"mappings":"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"}