@mutagent/sdk 0.11.5 → 0.12.0

package/dist/esm/sdk/architech-sessions.d.ts

@@ -0,0 +1,76 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+export declare class ArchitechSessions extends ClientSDK {
+    /**
+     * Launch a session (the architech harness)
+     *
+     * @remarks
+     * Starts a session of the architech harness. Another harness runs its own preset when `preset` is omitted; a preset of another harness, or `agent`, 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.
+     */
+    launchArchitechSession(request: models.HelixLaunchRequest, options?: RequestOptions): Promise<models.HelixLaunchedSession>;
+    /**
+     * List the workspace's sessions (the architech harness)
+     *
+     * @remarks
+     * The workspace's sessions of the architech 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.
+     */
+    listArchitechSessions(request?: operations.ListArchitechSessionsRequest | 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`.
+     */
+    sendArchitechSessionInput(request: operations.SendArchitechSessionInputRequest, 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.
+     */
+    closeArchitechSessionInput(request: operations.CloseArchitechSessionInputRequest, options?: RequestOptions): Promise<operations.CloseArchitechSessionInputResponse>;
+    /**
+     * 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.
+     */
+    endArchitechSession(request: operations.EndArchitechSessionRequest, 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.
+     */
+    signalArchitechSession(request: operations.SignalArchitechSessionRequest, 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.
+     */
+    checkpointArchitechSession(request: operations.CheckpointArchitechSessionRequest, 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`.
+     */
+    listArchitechSessionCheckpoints(request: operations.ListArchitechSessionCheckpointsRequest, 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.
+     */
+    restoreArchitechSession(request: operations.RestoreArchitechSessionRequest, 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.
+     */
+    streamArchitechSession(request: operations.StreamArchitechSessionRequest, options?: RequestOptions): Promise<string>;
+}
+//# sourceMappingURL=architech-sessions.d.ts.map

package/dist/esm/sdk/architech-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architech-sessions.d.ts","sourceRoot":"","sources":["../../../src/sdk/architech-sessions.ts"],"names":[],"mappings":"AAcA,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,iBAAkB,SAAQ,SAAS;IAC9C;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,CAAC,kBAAkB,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAQvC;;;;;OAKG;IACG,qBAAqB,CACzB,OAAO,CAAC,EAAE,UAAU,CAAC,4BAA4B,GAAG,SAAS,EAC7D,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAQnC;;;;;OAKG;IACG,yBAAyB,CAC7B,OAAO,EAAE,UAAU,CAAC,gCAAgC,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAQvC;;;;;OAKG;IACG,0BAA0B,CAC9B,OAAO,EAAE,UAAU,CAAC,iCAAiC,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,kCAAkC,CAAC;IAQzD;;;;;OAKG;IACG,mBAAmB,CACvB,OAAO,EAAE,UAAU,CAAC,0BAA0B,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAQ1C;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,UAAU,CAAC,6BAA6B,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAQnC;;;;;OAKG;IACG,0BAA0B,CAC9B,OAAO,EAAE,UAAU,CAAC,iCAAiC,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IAQ7B;;;;;OAKG;IACG,+BAA+B,CACnC,OAAO,EAAE,UAAU,CAAC,sCAAsC,EAC1D,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAQjC;;;;;OAKG;IACG,uBAAuB,CAC3B,OAAO,EAAE,UAAU,CAAC,8BAA8B,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC;IAQ5C;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,UAAU,CAAC,6BAA6B,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;CAOnB"}

package/dist/esm/sdk/architech-sessions.js

@@ -0,0 +1,108 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { architechSessionsCheckpointArchitechSession } from "../funcs/architech-sessions-checkpoint-architech-session.js";
+import { architechSessionsCloseArchitechSessionInput } from "../funcs/architech-sessions-close-architech-session-input.js";
+import { architechSessionsEndArchitechSession } from "../funcs/architech-sessions-end-architech-session.js";
+import { architechSessionsLaunchArchitechSession } from "../funcs/architech-sessions-launch-architech-session.js";
+import { architechSessionsListArchitechSessionCheckpoints } from "../funcs/architech-sessions-list-architech-session-checkpoints.js";
+import { architechSessionsListArchitechSessions } from "../funcs/architech-sessions-list-architech-sessions.js";
+import { architechSessionsRestoreArchitechSession } from "../funcs/architech-sessions-restore-architech-session.js";
+import { architechSessionsSendArchitechSessionInput } from "../funcs/architech-sessions-send-architech-session-input.js";
+import { architechSessionsSignalArchitechSession } from "../funcs/architech-sessions-signal-architech-session.js";
+import { architechSessionsStreamArchitechSession } from "../funcs/architech-sessions-stream-architech-session.js";
+import { ClientSDK } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+export class ArchitechSessions extends ClientSDK {
+    /**
+     * Launch a session (the architech harness)
+     *
+     * @remarks
+     * Starts a session of the architech harness. Another harness runs its own preset when `preset` is omitted; a preset of another harness, or `agent`, 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 launchArchitechSession(request, options) {
+        return unwrapAsync(architechSessionsLaunchArchitechSession(this, request, options));
+    }
+    /**
+     * List the workspace's sessions (the architech harness)
+     *
+     * @remarks
+     * The workspace's sessions of the architech 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 listArchitechSessions(request, options) {
+        return unwrapAsync(architechSessionsListArchitechSessions(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 sendArchitechSessionInput(request, options) {
+        return unwrapAsync(architechSessionsSendArchitechSessionInput(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.
+     */
+    async closeArchitechSessionInput(request, options) {
+        return unwrapAsync(architechSessionsCloseArchitechSessionInput(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 endArchitechSession(request, options) {
+        return unwrapAsync(architechSessionsEndArchitechSession(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 signalArchitechSession(request, options) {
+        return unwrapAsync(architechSessionsSignalArchitechSession(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.
+     */
+    async checkpointArchitechSession(request, options) {
+        return unwrapAsync(architechSessionsCheckpointArchitechSession(this, request, options));
+    }
+    /**
+     * 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`.
+     */
+    async listArchitechSessionCheckpoints(request, options) {
+        return unwrapAsync(architechSessionsListArchitechSessionCheckpoints(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.
+     */
+    async restoreArchitechSession(request, options) {
+        return unwrapAsync(architechSessionsRestoreArchitechSession(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.
+     */
+    async streamArchitechSession(request, options) {
+        return unwrapAsync(architechSessionsStreamArchitechSession(this, request, options));
+    }
+}
+//# sourceMappingURL=architech-sessions.js.map

package/dist/esm/sdk/architech-sessions.js.map

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

package/dist/esm/sdk/helix-cloud.d.ts

@@ -7,6 +7,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * The same data as `GET /api/sandbox/helix/defaults`, for a signed-in workspace member.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     getHelixCloudDefaults(options?: RequestOptions): Promise<models.HelixModelList>;
     /**
@@ -14,6 +16,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * `canRun` is true when nothing is missing. `missing` lists, in order: `llm-provider` (no LLM provider Helix can use), `default-model` (no default model), `sandbox-provider` (no reachable sandbox provider, or cloud sandboxes are not enabled for the workspace), `sandbox-preset` (this backend has no sandbox preset configured, so a start would fail; set by the server administrator). `advisory` lists what is worth setting up but does not stop a run: `repository` (no linked repository; a session starts without a checkout).
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     getHelixCloudReadiness(options?: RequestOptions): Promise<models.HelixCloudReadiness>;
     /**
@@ -21,6 +25,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Every Helix Cloud session in the workspace, newest activity first, with its title, goal, repository, model, thinking and status. Archived sessions are left out unless `archived=true`; a page can then hold fewer rows than `limit`, and `nextCursor` still pages on.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     listHelixCloudSessions(request?: operations.ListHelixCloudSessionsRequest | undefined, options?: RequestOptions): Promise<models.HelixCloudSessionList>;
     /**
@@ -28,6 +34,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Starts a Helix Cloud session on the platform preset and sends `goal` as its first prompt, in one call. 422 for a model outside the workspace list; 428 `NO_PROVIDER_CONFIGURED` when no model is named and the workspace has no default. `environment` names a workspace Environment to load; omitted, none is loaded; 404 when the workspace has none by that name, before any sandbox starts. `repository` (`owner/name`, any repository the GitHub installation of the workspace can reach; one not linked yet is linked to the workspace first, as the caller) is checked out in the new sandbox at `branch` (else its default branch) through the workspace GitHub installation, and the session starts in that checkout; the branch checked out is recorded on the session. The refusals are one table (`code`): 400 `BRANCH_WITHOUT_REPOSITORY` / `INVALID_BRANCH_NAME`; 409 `github_not_connected` / `installation_suspended` / `installation_revoked`; 422 `repository_inaccessible` (the Mutagent GitHub App cannot reach the repository: give it access on GitHub) / `BRANCH_NOT_FOUND`; 503 `BRANCH_CHECK_UNAVAILABLE` (GitHub unreachable) / `REPOSITORY_CHECKOUT_UNAVAILABLE` (this server cannot check out), all before any sandbox starts; 502 `CHECKOUT_FAILED` when the checkout fails, and its sandbox is released. `subject` (F20) opens the session for a Factory entry with no stage: bound to the entry, no stage run opened, `goal` is its hidden `/<stage> …` first message; refused before any sandbox with 404 `ENTRY_NOT_FOUND`, 409 `ENTRY_ARCHIVED`, or 403 `PERMISSION_DENIED` when the caller may launch none of its stages. Setting up the new sandbox can also refuse the start, after releasing it: 503 `SANDBOX_SETUP_TIMEOUT` when setup ran out of time (retry), 502 `SANDBOX_SETUP_FAILED` when it failed. If the goal cannot be sent, the new sandbox is released.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     startHelixCloudSession(request: models.HelixCloudStartRequest, options?: RequestOptions): Promise<models.HelixCloudStarted>;
     /**
@@ -35,6 +43,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * The row the list shows for this session. 404 for a session outside the caller workspace.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     getHelixCloudSession(request: operations.GetHelixCloudSessionRequest, options?: RequestOptions): Promise<models.HelixCloudSession>;
     /**
@@ -42,6 +52,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Sets the session's title and answers its row as the list shows it. `title` is trimmed; blank, or over 200 characters, is 422. A session restored from another (a wake included) is one thread with it: renaming any member of that chain renames all of them. Works for a session started outside the web too. Nothing else changes: an archived session stays archived. 404 for a session outside the caller workspace.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     renameHelixCloudSession(request: operations.RenameHelixCloudSessionRequest, options?: RequestOptions): Promise<models.HelixCloudSession>;
     /**
@@ -49,6 +61,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Read from the session's sandbox: the checked-out branch, the changes against HEAD (per file, lines classified) and the file index. The root is the session's home directory when it is a git work tree, else the first repository directly under it. Capped at 5000 files and 1 MiB of diff (`truncated` says which). 502 when the sandbox cannot answer.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     getHelixCloudSessionWorkspace(request: operations.GetHelixCloudSessionWorkspaceRequest, options?: RequestOptions): Promise<models.HelixCloudSessionWorkspace>;
     /**
@@ -56,6 +70,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * The questions the session asked and is waiting on a human to answer (a confirm, a choice, or text). While any is open the session is `needs-input`.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     listHelixCloudApprovals(request: operations.ListHelixCloudApprovalsRequest, options?: RequestOptions): Promise<models.HelixCloudApprovalList>;
     /**
@@ -63,6 +79,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Sends the answer to the session. 404 when the question is not open any more (answered elsewhere or timed out); 400 when the answer does not fit it (a value missing, or not one of the options).
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     answerHelixCloudApproval(request: operations.AnswerHelixCloudApprovalRequest, options?: RequestOptions): Promise<void>;
     /**
@@ -70,6 +88,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Uploads one file into the session's sandbox at `$HOME/uploads/<name>` and answers the path, which a message can then name. The name is reduced to a safe base name. 413 over 10 MiB.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     attachHelixCloudFile(request: operations.AttachHelixCloudFileRequest, options?: RequestOptions): Promise<models.HelixCloudAttached>;
     /**
@@ -77,6 +97,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Takes the session out of the default list. It keeps running if it is running; archiving is a list fact, not a stop. 404 for a session outside the caller workspace.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     archiveHelixCloudSession(request: operations.ArchiveHelixCloudSessionRequest, options?: RequestOptions): Promise<void>;
     /**
@@ -84,6 +106,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Sends `text` to the session as one prompt. The reply arrives on the session's stream. 404 for a session outside the caller's workspace. A session stopped for idling is woken: it is restored from its last checkpoint onto a new sandbox generation and the message is delivered once Helix is up; `wake` then carries the restored session's `reference` (`delivered`), or says the restore is still running (`waking`) and the message is delivered when it finishes. Messages sent meanwhile are delivered in order, each once. A session whose sandbox no longer runs it (its sandbox instance was replaced) is woken the same way when it can be; otherwise 410 `SESSION_GONE`, whose message says how to get it back.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     sendHelixCloudSessionInput(request: operations.SendHelixCloudSessionInputRequest, options?: RequestOptions): Promise<models.HelixCloudAccepted>;
     /**
@@ -91,6 +115,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Sends Helix's `abort` to the session: the reply it is writing ends, and the session stays running with its context, so the next message is answered at once. Between replies it changes nothing. 409 when the session is not running (it ended, or it is asleep after idling); nothing is woken. To end the session's process instead, use `POST /helix-cloud/sessions/{reference}/signal`.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     interruptHelixCloudSession(request: operations.InterruptHelixCloudSessionRequest, options?: RequestOptions): Promise<models.HelixCloudInterrupted>;
     /**
@@ -98,6 +124,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Signals the session's Helix 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.
      */
     signalHelixCloudSession(request: operations.SignalHelixCloudSessionRequest, options?: RequestOptions): Promise<models.HelixCloudSignalled>;
     /**
@@ -105,6 +133,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Server-sent events for this session; pass `?since=<seq>` to resume. The same stream `GET /api/sandbox/helix/sessions/{reference}/stream` serves.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     streamHelixCloudSession(request: operations.StreamHelixCloudSessionRequest, options?: RequestOptions): Promise<string>;
     /**
@@ -112,6 +142,8 @@ export declare class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Recreates the session's committed work (its checkout's HEAD against the commit it started from) as one commit on `helix/session-…` of the session's repository, and opens a pull request into the branch the session started from, as the MutagenT GitHub App. The sandbox never holds the write token: the platform reads the change out of it and writes it through GitHub's Git Data API. The branch is created, or fast-forwarded over this session's own last publish only; it is never forced and never the default branch. Symlinks and any path git refuses are refused. A second publish returns the open pull request (200). The commit and the pull request name the session (`Helix-Session: hs1_…`). The platform also publishes when a session ends. The base is the commit the platform recorded when the session started; the sandbox's claim must equal it. Refusals: 404 SESSION_NOT_FOUND; 409 SESSION_HAS_NO_REPOSITORY, SESSION_ENDED, NO_NEW_COMMITS, CHECKOUT_UNKNOWN, BASE_UNRECORDED, BASE_MISMATCH, BASE_NOT_IN_REPOSITORY, BASE_NOT_ON_BRANCH, BRANCH_DIVERGED, BRANCH_NOT_OURS, SANDBOX_UNSUPPORTED, PULL_REQUEST_REFUSED, REPOSITORY_ACCESS_DENIED, GITHUB_INSTALLATION_SUSPENDED; 422 UNSAFE_PATH, UNSUPPORTED_CHANGE, CHANGE_TOO_LARGE; 424 GITHUB_APP_PERMISSIONS_MISSING (the App installation must grant contents:write and pull_requests:write); 429 GITHUB_RATE_LIMITED; 502 HELPER_FAILED (the sandbox's helper crashed after it said it could export); 503 PUBLISH_UNAVAILABLE. SANDBOX_UNSUPPORTED means the sandbox's helper does not list both `export_changes` and `read_blob` in its probe. A sandbox token is refused with 403.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     publishHelixCloudSession(request: operations.PublishHelixCloudSessionRequest, options?: RequestOptions): Promise<models.HelixCloudPublished>;
 }

package/dist/esm/sdk/helix-cloud.d.ts.map

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

package/dist/esm/sdk/helix-cloud.js

@@ -25,6 +25,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * The same data as `GET /api/sandbox/helix/defaults`, for a signed-in workspace member.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async getHelixCloudDefaults(options) {
         return unwrapAsync(helixCloudGetHelixCloudDefaults(this, options));
@@ -34,6 +36,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * `canRun` is true when nothing is missing. `missing` lists, in order: `llm-provider` (no LLM provider Helix can use), `default-model` (no default model), `sandbox-provider` (no reachable sandbox provider, or cloud sandboxes are not enabled for the workspace), `sandbox-preset` (this backend has no sandbox preset configured, so a start would fail; set by the server administrator). `advisory` lists what is worth setting up but does not stop a run: `repository` (no linked repository; a session starts without a checkout).
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async getHelixCloudReadiness(options) {
         return unwrapAsync(helixCloudGetHelixCloudReadiness(this, options));
@@ -43,6 +47,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Every Helix Cloud session in the workspace, newest activity first, with its title, goal, repository, model, thinking and status. Archived sessions are left out unless `archived=true`; a page can then hold fewer rows than `limit`, and `nextCursor` still pages on.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async listHelixCloudSessions(request, options) {
         return unwrapAsync(helixCloudListHelixCloudSessions(this, request, options));
@@ -52,6 +58,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Starts a Helix Cloud session on the platform preset and sends `goal` as its first prompt, in one call. 422 for a model outside the workspace list; 428 `NO_PROVIDER_CONFIGURED` when no model is named and the workspace has no default. `environment` names a workspace Environment to load; omitted, none is loaded; 404 when the workspace has none by that name, before any sandbox starts. `repository` (`owner/name`, any repository the GitHub installation of the workspace can reach; one not linked yet is linked to the workspace first, as the caller) is checked out in the new sandbox at `branch` (else its default branch) through the workspace GitHub installation, and the session starts in that checkout; the branch checked out is recorded on the session. The refusals are one table (`code`): 400 `BRANCH_WITHOUT_REPOSITORY` / `INVALID_BRANCH_NAME`; 409 `github_not_connected` / `installation_suspended` / `installation_revoked`; 422 `repository_inaccessible` (the Mutagent GitHub App cannot reach the repository: give it access on GitHub) / `BRANCH_NOT_FOUND`; 503 `BRANCH_CHECK_UNAVAILABLE` (GitHub unreachable) / `REPOSITORY_CHECKOUT_UNAVAILABLE` (this server cannot check out), all before any sandbox starts; 502 `CHECKOUT_FAILED` when the checkout fails, and its sandbox is released. `subject` (F20) opens the session for a Factory entry with no stage: bound to the entry, no stage run opened, `goal` is its hidden `/<stage> …` first message; refused before any sandbox with 404 `ENTRY_NOT_FOUND`, 409 `ENTRY_ARCHIVED`, or 403 `PERMISSION_DENIED` when the caller may launch none of its stages. Setting up the new sandbox can also refuse the start, after releasing it: 503 `SANDBOX_SETUP_TIMEOUT` when setup ran out of time (retry), 502 `SANDBOX_SETUP_FAILED` when it failed. If the goal cannot be sent, the new sandbox is released.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async startHelixCloudSession(request, options) {
         return unwrapAsync(helixCloudStartHelixCloudSession(this, request, options));
@@ -61,6 +69,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * The row the list shows for this session. 404 for a session outside the caller workspace.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async getHelixCloudSession(request, options) {
         return unwrapAsync(helixCloudGetHelixCloudSession(this, request, options));
@@ -70,6 +80,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Sets the session's title and answers its row as the list shows it. `title` is trimmed; blank, or over 200 characters, is 422. A session restored from another (a wake included) is one thread with it: renaming any member of that chain renames all of them. Works for a session started outside the web too. Nothing else changes: an archived session stays archived. 404 for a session outside the caller workspace.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async renameHelixCloudSession(request, options) {
         return unwrapAsync(helixCloudRenameHelixCloudSession(this, request, options));
@@ -79,6 +91,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Read from the session's sandbox: the checked-out branch, the changes against HEAD (per file, lines classified) and the file index. The root is the session's home directory when it is a git work tree, else the first repository directly under it. Capped at 5000 files and 1 MiB of diff (`truncated` says which). 502 when the sandbox cannot answer.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async getHelixCloudSessionWorkspace(request, options) {
         return unwrapAsync(helixCloudGetHelixCloudSessionWorkspace(this, request, options));
@@ -88,6 +102,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * The questions the session asked and is waiting on a human to answer (a confirm, a choice, or text). While any is open the session is `needs-input`.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async listHelixCloudApprovals(request, options) {
         return unwrapAsync(helixCloudListHelixCloudApprovals(this, request, options));
@@ -97,6 +113,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Sends the answer to the session. 404 when the question is not open any more (answered elsewhere or timed out); 400 when the answer does not fit it (a value missing, or not one of the options).
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async answerHelixCloudApproval(request, options) {
         return unwrapAsync(helixCloudAnswerHelixCloudApproval(this, request, options));
@@ -106,6 +124,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Uploads one file into the session's sandbox at `$HOME/uploads/<name>` and answers the path, which a message can then name. The name is reduced to a safe base name. 413 over 10 MiB.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async attachHelixCloudFile(request, options) {
         return unwrapAsync(helixCloudAttachHelixCloudFile(this, request, options));
@@ -115,6 +135,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Takes the session out of the default list. It keeps running if it is running; archiving is a list fact, not a stop. 404 for a session outside the caller workspace.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async archiveHelixCloudSession(request, options) {
         return unwrapAsync(helixCloudArchiveHelixCloudSession(this, request, options));
@@ -124,6 +146,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Sends `text` to the session as one prompt. The reply arrives on the session's stream. 404 for a session outside the caller's workspace. A session stopped for idling is woken: it is restored from its last checkpoint onto a new sandbox generation and the message is delivered once Helix is up; `wake` then carries the restored session's `reference` (`delivered`), or says the restore is still running (`waking`) and the message is delivered when it finishes. Messages sent meanwhile are delivered in order, each once. A session whose sandbox no longer runs it (its sandbox instance was replaced) is woken the same way when it can be; otherwise 410 `SESSION_GONE`, whose message says how to get it back.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async sendHelixCloudSessionInput(request, options) {
         return unwrapAsync(helixCloudSendHelixCloudSessionInput(this, request, options));
@@ -133,6 +157,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Sends Helix's `abort` to the session: the reply it is writing ends, and the session stays running with its context, so the next message is answered at once. Between replies it changes nothing. 409 when the session is not running (it ended, or it is asleep after idling); nothing is woken. To end the session's process instead, use `POST /helix-cloud/sessions/{reference}/signal`.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async interruptHelixCloudSession(request, options) {
         return unwrapAsync(helixCloudInterruptHelixCloudSession(this, request, options));
@@ -142,6 +168,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Signals the session's Helix 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 signalHelixCloudSession(request, options) {
         return unwrapAsync(helixCloudSignalHelixCloudSession(this, request, options));
@@ -151,6 +179,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Server-sent events for this session; pass `?since=<seq>` to resume. The same stream `GET /api/sandbox/helix/sessions/{reference}/stream` serves.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async streamHelixCloudSession(request, options) {
         return unwrapAsync(helixCloudStreamHelixCloudSession(this, request, options));
@@ -160,6 +190,8 @@ export class HelixCloud extends ClientSDK {
      *
      * @remarks
      * Recreates the session's committed work (its checkout's HEAD against the commit it started from) as one commit on `helix/session-…` of the session's repository, and opens a pull request into the branch the session started from, as the MutagenT GitHub App. The sandbox never holds the write token: the platform reads the change out of it and writes it through GitHub's Git Data API. The branch is created, or fast-forwarded over this session's own last publish only; it is never forced and never the default branch. Symlinks and any path git refuses are refused. A second publish returns the open pull request (200). The commit and the pull request name the session (`Helix-Session: hs1_…`). The platform also publishes when a session ends. The base is the commit the platform recorded when the session started; the sandbox's claim must equal it. Refusals: 404 SESSION_NOT_FOUND; 409 SESSION_HAS_NO_REPOSITORY, SESSION_ENDED, NO_NEW_COMMITS, CHECKOUT_UNKNOWN, BASE_UNRECORDED, BASE_MISMATCH, BASE_NOT_IN_REPOSITORY, BASE_NOT_ON_BRANCH, BRANCH_DIVERGED, BRANCH_NOT_OURS, SANDBOX_UNSUPPORTED, PULL_REQUEST_REFUSED, REPOSITORY_ACCESS_DENIED, GITHUB_INSTALLATION_SUSPENDED; 422 UNSAFE_PATH, UNSUPPORTED_CHANGE, CHANGE_TOO_LARGE; 424 GITHUB_APP_PERMISSIONS_MISSING (the App installation must grant contents:write and pull_requests:write); 429 GITHUB_RATE_LIMITED; 502 HELPER_FAILED (the sandbox's helper crashed after it said it could export); 503 PUBLISH_UNAVAILABLE. SANDBOX_UNSUPPORTED means the sandbox's helper does not list both `export_changes` and `read_blob` in its probe. A sandbox token is refused with 403.
+     *
+     * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     async publishHelixCloudSession(request, options) {
         return unwrapAsync(helixCloudPublishHelixCloudSession(this, request, options));

package/dist/esm/sdk/helix-cloud.js.map

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