@shardflux/sdk 0.15.0 → 0.16.0

package/dist/testing/seed.js

@@ -0,0 +1,449 @@
+// Captured response shapes; regenerate with node packages/sdk/scripts/generate-testing-fixtures.mjs.
+export const seed = {
+    "_captured": "Production session workspaces, 2026-10-04T22:06:24.279Z; credentials omitted, IDs and cell hostname replaced. Canonical capture: packages/sdk/test/fixtures/testing-api-capture.json. Supplemental captures carry their original provenance.",
+    "defaultWorkspace": {
+        "id": "00000000-0000-7000-8000-00000000001e",
+        "organization_id": "00000000-0000-7000-8000-000000000018",
+        "project_id": "00000000-0000-7000-8000-000000000019",
+        "workspace_key": "qmfx/testing/default-1791151583295",
+        "labels": {},
+        "template_version_id": "00000000-0000-7000-8000-00000000001a",
+        "template": {
+            "version_id": "00000000-0000-7000-8000-00000000001a",
+            "template_id": "00000000-0000-7000-8000-00000000001b",
+            "slug": "python-node-browser",
+            "version": 15,
+            "immutable_version": null
+        },
+        "desired_state": "running",
+        "observed_state": "running",
+        "cell_id": "c1",
+        "cell_endpoint": "https://cell.fake.invalid",
+        "ownership_epoch": 1,
+        "caps": {
+            "cpu_millis": null,
+            "memory_mib": null,
+            "disk_gib": null,
+            "allocation_mode": "elastic",
+            "memory_mib_held": 1024
+        },
+        "memory": {
+            "allocation_mode": "elastic",
+            "promised_mib": 8192,
+            "held_mib": 1024,
+            "plugged_mib": 0
+        },
+        "ceilings": {
+            "cpu_millis": 4000,
+            "memory_mib": 8192,
+            "disk_gib": 20,
+            "sources": {
+                "cpu_millis": "plan",
+                "memory_mib": "plan",
+                "disk_gib": "plan"
+            },
+            "resolved_at": "2026-10-04T22:06:23.533Z"
+        },
+        "grants": {
+            "disk_gib": 20,
+            "cpu_millis": 4000,
+            "memory_mib": 1024,
+            "memory_layout": 2,
+            "memory_mib_max": 8192,
+            "allocation_mode": "elastic",
+            "memory_mib_base": 1024,
+            "memory_mib_held": 1024,
+            "memory_mib_ceiling": 32768
+        },
+        "active_operation": null,
+        "pending_reason": null,
+        "forked_from_workspace_id": null,
+        "disk_layout": "layered",
+        "lifetime": "session",
+        "purpose": "standard",
+        "idle_timeout_seconds": 600,
+        "idle": null,
+        "origin": null,
+        "ended_reason": null,
+        "dev_template_id": null,
+        "startup": null,
+        "mode": "processful",
+        "tree_revision": 0,
+        "computer_use": {
+            "enabled": false,
+            "workspace": null,
+            "template": false,
+            "available": true
+        },
+        "created_at": "2026-10-04T22:06:23.533Z",
+        "updated_at": "2026-10-04T22:06:23.706Z",
+        "deleted_at": null
+    },
+    "workspace": {
+        "id": "00000000-0000-7000-8000-000000000001",
+        "organization_id": "00000000-0000-7000-8000-000000000002",
+        "project_id": "00000000-0000-7000-8000-000000000003",
+        "workspace_key": "qmfx/testing/seed",
+        "labels": {},
+        "template_version_id": "00000000-0000-7000-8000-000000000004",
+        "template": {
+            "version_id": "00000000-0000-7000-8000-000000000004",
+            "template_id": "00000000-0000-7000-8000-000000000005",
+            "slug": "python-node-browser",
+            "version": 15,
+            "immutable_version": null
+        },
+        "desired_state": "running",
+        "observed_state": "running",
+        "cell_id": "c1",
+        "cell_endpoint": "https://cell.fake.invalid",
+        "ownership_epoch": 1,
+        "caps": {
+            "cpu_millis": null,
+            "memory_mib": 2048,
+            "disk_gib": null,
+            "allocation_mode": "fixed"
+        },
+        "memory": {
+            "allocation_mode": "fixed",
+            "promised_mib": 2048,
+            "held_mib": 2048,
+            "plugged_mib": null
+        },
+        "ceilings": {
+            "cpu_millis": 4000,
+            "memory_mib": 2048,
+            "disk_gib": 20,
+            "sources": {
+                "cpu_millis": "plan",
+                "memory_mib": "user",
+                "disk_gib": "plan"
+            },
+            "resolved_at": "2026-10-04T21:43:52.608Z"
+        },
+        "grants": {
+            "disk_gib": 20,
+            "cpu_millis": 4000,
+            "memory_mib": 2048,
+            "memory_layout": 2,
+            "allocation_mode": "fixed",
+            "memory_mib_base": 1024,
+            "memory_mib_ceiling": 32768
+        },
+        "active_operation": null,
+        "pending_reason": null,
+        "forked_from_workspace_id": null,
+        "disk_layout": "layered",
+        "lifetime": "session",
+        "purpose": "standard",
+        "idle_timeout_seconds": 600,
+        "idle": null,
+        "origin": null,
+        "ended_reason": null,
+        "dev_template_id": null,
+        "startup": null,
+        "mode": "processful",
+        "tree_revision": 0,
+        "computer_use": {
+            "enabled": false,
+            "workspace": null,
+            "template": false,
+            "available": true
+        },
+        "created_at": "2026-10-04T21:43:52.608Z",
+        "updated_at": "2026-10-04T21:43:52.731Z",
+        "deleted_at": null
+    },
+    "idle": {
+        "auto_suspend": {
+            "backoff_until": null,
+            "disabled_reason": null,
+            "enabled": true,
+            "failures": 0,
+            "last_error": null,
+            "last_operation_id": null
+        },
+        "idle_since": "2026-10-04T21:43:52.731942Z",
+        "keepalive_until": null,
+        "last_attach_at": null,
+        "last_tool_at": null,
+        "observed_state": "running",
+        "policy": {
+            "idle_minutes": null,
+            "mode": "adaptive",
+            "source": "default"
+        },
+        "running_since": "2026-10-04T21:43:52.731942Z",
+        "suspend_at": null,
+        "suspend_request": null
+    },
+    "busyIdle": {
+        "auto_suspend": {
+            "backoff_until": null,
+            "disabled_reason": null,
+            "enabled": true,
+            "failures": 0,
+            "last_error": null,
+            "last_operation_id": null
+        },
+        "idle_since": "2026-10-04T21:45:01.862826Z",
+        "keepalive_until": null,
+        "last_attach_at": null,
+        "last_tool_at": "2026-10-04T21:44:21.839643Z",
+        "observed_state": "running",
+        "policy": {
+            "idle_minutes": null,
+            "mode": "adaptive",
+            "source": "default"
+        },
+        "running_since": "2026-10-04T21:44:21.620863Z",
+        "suspend_at": null,
+        "suspend_request": null
+    },
+    "resize": {
+        "workspace_id": "00000000-0000-7000-8000-000000000001",
+        "operation_id": "00000000-0000-7000-8000-000000000009",
+        "state": "running",
+        "caps": {
+            "cpu_millis": null,
+            "memory_mib": 3072,
+            "disk_gib": null,
+            "allocation_mode": "fixed"
+        },
+        "memory": {
+            "applies_at": "now",
+            "allocation_mode": "fixed",
+            "requested_mib": 3072,
+            "target_mib": 3072,
+            "previous_mib": 2048,
+            "applied_mib": 3072,
+            "held_mib": null,
+            "converged": true,
+            "limit_reason": null,
+            "reason": null
+        }
+    },
+    "missing": {
+        "error": {
+            "code": "not_found",
+            "message": "open /home/user/qmfx-missing: no such file or directory",
+            "request_id": "00000000-0000-7000-8000-000000000008",
+            "retryable": false,
+            "details": {
+                "reason": "path_not_found"
+            }
+        }
+    },
+    "sessionLifetime": {
+        "error": {
+            "code": "conflict",
+            "message": "A session workspace cannot be suspended; close it, or fork it to keep its state.",
+            "request_id": "req-d294f3f70dde403a8423a3f2",
+            "retryable": false,
+            "details": {
+                "reason": "session_lifetime"
+            }
+        }
+    },
+    "gone": {
+        "error": {
+            "code": "conflict",
+            "message": "The workspace was deleted.",
+            "request_id": "req-f98733e54db546848e558390",
+            "retryable": false,
+            "details": {
+                "reason": "workspace_deleted"
+            }
+        }
+    },
+    "computerUnavailable": {
+        "error": {
+            "code": "conflict",
+            "message": "This workspace’s template version cannot run a desktop; open a workspace of a version whose guest agent has desktop.v1.",
+            "request_id": "req-ea53380457d24c63ac8313f8",
+            "retryable": false,
+            "details": {
+                "reason": "computer_use_unavailable"
+            }
+        }
+    },
+    "templateViews": {
+        "python-node-browser": {
+            "version_id": "00000000-0000-7000-8000-00000000001a",
+            "template_id": "00000000-0000-7000-8000-00000000001b",
+            "slug": "python-node-browser",
+            "version": 15,
+            "immutable_version": null
+        },
+        "ubuntu-24.04": {
+            "version_id": "00000000-0000-7000-8000-00000000000e",
+            "template_id": "00000000-0000-7000-8000-00000000000f",
+            "slug": "ubuntu-24.04",
+            "version": 5,
+            "immutable_version": null
+        }
+    },
+    "_supplemental": {
+        "token": "Captured 2026-09-26 from the Shardflux API (local build, same code as the service); hostnames replaced.",
+        "computerStopped": "Captured 2026-10-04 from the Shardflux cell gateway (local build, same code as the service) by services/cell/internal/gateway/computer_test.go.",
+        "me": "Captured 2026-10-04 from the Shardflux API (local build, same code as the service) by apps/api/test/clients-workspace-by-key.test.ts."
+    },
+    "token": {
+        "token": "fake-tool-token",
+        "token_type": "Bearer",
+        "expires_at": "9999-12-31T00:00:00.000Z",
+        "issued_at": "2026-09-26T19:36:04.000Z",
+        "kid": "local-dev.z4kHk7UK",
+        "audience": "cell-1.example",
+        "workspace_id": "01a0df37-b3a1-7303-aba8-8953543f16f2",
+        "agent_session_id": "01a0df37-b41e-7f39-a9f6-d38b2963083d",
+        "ownership_epoch": 1,
+        "tools": [
+            "exec",
+            "files"
+        ],
+        "cell_endpoint": "https://cell.example.test"
+    },
+    "computerStopped": {
+        "running": false,
+        "streams": {
+            "interactive": false,
+            "view": false
+        }
+    },
+    "me": {
+        "type": "api_key",
+        "user": null,
+        "memberships": [],
+        "api_key": {
+            "id": "01a10572-208c-7593-9cf6-6c8053d7db7a",
+            "key_id": "tbxqkfu5dn7wpycd",
+            "organization_id": "01a10572-2083-7c10-bdc7-fab17b3fe4c0",
+            "project_id": "01a10572-2088-7d5c-acf5-6a1d9fe016b7",
+            "tool_permissions": [
+                "exec",
+                "files",
+                "processes",
+                "computer"
+            ]
+        }
+    },
+    "fileInfo": {
+        "gid": 1000,
+        "mode": "0644",
+        "modified_at": "2026-10-04T21:56:05.210721792Z",
+        "name": "a.txt",
+        "path": "/home/user/qmfx/a.txt",
+        "revision": "fe9c2dadb34bee2ae03fc8fe25e26c64ce2f572a53a127db5d6e73899b64fc11",
+        "size": 12,
+        "type": "file",
+        "uid": 1000
+    },
+    "fileWrite": {
+        "bytes_written": 12,
+        "durable": true,
+        "file": {
+            "gid": 1000,
+            "mode": "0644",
+            "modified_at": "2026-10-04T21:56:05.210721792Z",
+            "name": "a.txt",
+            "path": "/home/user/qmfx/a.txt",
+            "revision": "fe9c2dadb34bee2ae03fc8fe25e26c64ce2f572a53a127db5d6e73899b64fc11",
+            "size": 12,
+            "type": "file",
+            "uid": 1000
+        },
+        "path": "/home/user/qmfx/a.txt",
+        "revision": "fe9c2dadb34bee2ae03fc8fe25e26c64ce2f572a53a127db5d6e73899b64fc11",
+        "sha256": "fe9c2dadb34bee2ae03fc8fe25e26c64ce2f572a53a127db5d6e73899b64fc11"
+    },
+    "fileList": {
+        "entries": [
+            {
+                "gid": 1000,
+                "mode": "0644",
+                "modified_at": "2026-10-04T21:56:05.210721792Z",
+                "name": "a.txt",
+                "path": "/home/user/qmfx/a.txt",
+                "size": 12,
+                "type": "file",
+                "uid": 1000
+            }
+        ],
+        "truncated": false
+    },
+    "filePatch": {
+        "bytes_written": 13,
+        "durable": true,
+        "file": {
+            "gid": 1000,
+            "mode": "0644",
+            "modified_at": "2026-10-04T21:56:05.3747218Z",
+            "name": "a.txt",
+            "path": "/home/user/qmfx/a.txt",
+            "revision": "0d7a3fcb331d2c4ef08fb4f733f5f1435b31cd77d73c4cc0fb64a7364ad50e51",
+            "size": 13,
+            "type": "file",
+            "uid": 1000
+        },
+        "path": "/home/user/qmfx/a.txt",
+        "previous_revision": "fe9c2dadb34bee2ae03fc8fe25e26c64ce2f572a53a127db5d6e73899b64fc11",
+        "replacements": 1,
+        "revision": "0d7a3fcb331d2c4ef08fb4f733f5f1435b31cd77d73c4cc0fb64a7364ad50e51"
+    },
+    "fileSearch": {
+        "files_scanned": 1,
+        "matches": [
+            {
+                "column": 1,
+                "line": 1,
+                "path": "/home/user/qmfx/a.txt",
+                "text": "a = 10"
+            }
+        ],
+        "truncated": false
+    },
+    "computerStatus": {
+        "display": ":1",
+        "height": 800,
+        "running": true,
+        "session": "/etc/shardflux/desktop/session",
+        "started_at": "2026-10-04T21:56:05.601Z",
+        "streams": {
+            "interactive": false,
+            "view": false
+        },
+        "width": 1280
+    },
+    "computerActions": {
+        "results": [],
+        "screenshot": {
+            "format": "png",
+            "width": 1280,
+            "height": 800,
+            "data": "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"
+        },
+        "cursor": [
+            640,
+            400
+        ],
+        "display": {
+            "width": 1280,
+            "height": 800
+        }
+    },
+    "execSession": {
+        "canceled": false,
+        "created": false,
+        "created_at": "2026-10-04T21:43:53.15828654Z",
+        "ended_at": "2026-10-04T21:43:53.192347995Z",
+        "exit_code": 7,
+        "pid": 699,
+        "session_id": "run-943621b9fdd74017a300920c",
+        "started_at": "2026-10-04T21:43:53.182710241Z",
+        "state": "exited",
+        "stderr_size": 0,
+        "stdout_size": 7,
+        "timed_out": false
+    }
+};

package/dist/tools.d.ts

@@ -1,3 +1,4 @@
+import type { BeforeComputerAction } from './computer.js';
 import type { CellClient, CellClientOptions } from './cell.js';
 import type { WorkspaceMode } from './errors.js';
 import type { ToolName } from './tokens.js';
@@ -62,6 +63,10 @@ export interface ToolTarget {
     hint(opts?: HintOptions): Promise<HintResult>;
 }
 export interface WorkspaceToolsOptions {
+    /** Per-action desktop policy; refusal stops the remaining actions. */
+    computer?: {
+        beforeAction?: BeforeComputerAction;
+    };
     /**
      * Tool permissions to expose (default: the tools of the workspace's last token, else all). A file-first workspace
      * (`workspace.mode`) gets only the `exec` and `files` tools: `exec` runs each command as an execution

package/dist/tools.js

@@ -10,6 +10,7 @@
  * application; toOpenAITools/toAnthropicTools export the definitions in those
  * providers' formats and executeToolCall dispatches a model's tool call.
  */
+import { runComputerActions } from "./computer.js";
 import { CAPTURE_BARRIER, burstFailure } from "./cell.js";
 import { ExecStartError, ShardfluxApiError } from "./errors.js";
 import { newExecutionId } from "./executions.js";
@@ -724,7 +725,7 @@ export function workspaceTools(workspace, opts = {}) {
             parameters: obj({ ...COMPUTER_ACTION, ...COMPUTER_LOOK }, ['action']),
             run: async (a, o) => {
                 const look = a.action === 'screenshot' || a.action === 'zoom' || a.action === 'cursor_position';
-                const r = await (await cell()).computer.act({ actions: [computerAction(a)], screenshot: !look && a.screenshot !== false, ...computerImage(a) }, o.signal);
+                const r = await runComputerActions(async (actions, options) => (await cell()).computer.act({ actions, screenshot: options.screenshot, ...computerImage(a) }, o.signal), [computerAction(a)], { screenshot: !look && a.screenshot !== false }, opts.computer?.beforeAction);
                 const res = r.results[0];
                 const img = res?.image ?? r.screenshot;
                 return {
@@ -747,7 +748,8 @@ export function workspaceTools(workspace, opts = {}) {
             }, ['actions']),
             run: async (a, o) => {
                 const actions = a.actions.map(computerAction);
-                const r = await (await cell()).computer.act({ actions, screenshot: a.screenshot !== false, ...computerImage(a) }, o.signal);
+                const lastLooks = ['screenshot', 'zoom'].includes(actions.at(-1)?.action ?? '');
+                const r = await runComputerActions(async (batch, options) => (await cell()).computer.act({ actions: batch, screenshot: options.screenshot, ...computerImage(a) }, o.signal), actions, { screenshot: !lastLooks && a.screenshot !== false }, opts.computer?.beforeAction);
                 return {
                     ok: r.results.every((x) => x.ok),
                     results: r.results.map((x) => ({

package/dist/tunnel-assets.d.ts

@@ -0,0 +1,10 @@
+export declare const TUNNEL_ASSETS: {
+    readonly x86_64: {
+        readonly file: "linux-amd64.gz";
+        readonly sha256: "e7b8a88b27c36b2605ee9e8182dae7700f816d9058d92bd87d6ae66781303650";
+    };
+    readonly aarch64: {
+        readonly file: "linux-arm64.gz";
+        readonly sha256: "740ce49febb1ab0e614a520d8daff68fa7b4ac32adf18dc93d5ff16b2dc57735";
+    };
+};

package/dist/tunnel-assets.js

@@ -0,0 +1,11 @@
+// Generated by scripts/build-tunnel-helper.py.
+export const TUNNEL_ASSETS = {
+    "x86_64": {
+        "file": "linux-amd64.gz",
+        "sha256": "e7b8a88b27c36b2605ee9e8182dae7700f816d9058d92bd87d6ae66781303650"
+    },
+    "aarch64": {
+        "file": "linux-arm64.gz",
+        "sha256": "740ce49febb1ab0e614a520d8daff68fa7b4ac32adf18dc93d5ff16b2dc57735"
+    }
+};

package/dist/tunnel-packet.d.ts

@@ -0,0 +1,3 @@
+export declare function packetCrc(bytes: Uint8Array): number;
+/** Delimit both ends so a replay discards any truncated preceding packet before decoding. */
+export declare function tunnelPacket(offset: number, bytes: Uint8Array): Buffer;

package/dist/tunnel-packet.js

@@ -0,0 +1,43 @@
+const table = Uint32Array.from({ length: 256 }, (_, value) => {
+    let crc = value;
+    for (let n = 0; n < 8; n++)
+        crc = (crc >>> 1) ^ ((crc & 1) ? 0xedb88320 : 0);
+    return crc >>> 0;
+});
+export function packetCrc(bytes) {
+    let crc = 0xffffffff;
+    for (const b of bytes)
+        crc = (crc >>> 8) ^ table[(crc ^ b) & 255];
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Delimit both ends so a replay discards any truncated preceding packet before decoding. */
+export function tunnelPacket(offset, bytes) {
+    if (!Number.isSafeInteger(offset) || offset < 0 || bytes.length > 65536)
+        throw new Error('invalid tunnel packet');
+    const data = Buffer.alloc(bytes.length + 16);
+    data.write('SFRT');
+    data.writeBigUInt64BE(BigInt(offset), 4);
+    data.set(bytes, 12);
+    data.writeUInt32BE(packetCrc(data.subarray(0, -4)), data.length - 4);
+    const result = Buffer.alloc(data.length + Math.ceil(data.length / 254) + 3);
+    let write = 2, codeAt = 1, code = 1;
+    for (const b of data) {
+        if (b === 0) {
+            result[codeAt] = code;
+            codeAt = write++;
+            code = 1;
+        }
+        else {
+            result[write++] = b;
+            code++;
+            if (code === 255) {
+                result[codeAt] = code;
+                codeAt = write++;
+                code = 1;
+            }
+        }
+    }
+    result[codeAt] = code;
+    result[write++] = 0;
+    return result.subarray(0, write);
+}

package/dist/tunnel-pty.d.ts

@@ -0,0 +1,86 @@
+import { WebSocket } from 'undici';
+import type { CellClient, ExecSession, OutputEvent } from './cell.js';
+import type { TunnelTransport } from './tunnels.js';
+/** Native PTY owns the channel; helper acknowledgements own bytes, independently of an HTTP request outcome. */
+export declare class PtyTunnelTransport implements TunnelTransport {
+    #private;
+    readonly maxInputConcurrency = 64;
+    readonly kind: "pty";
+    constructor(cell: CellClient, open?: (url: string, opts: NonNullable<ConstructorParameters<typeof WebSocket>[1]>) => WebSocket);
+    readonly files: {
+        remove: (path: string, opts?: {
+            recursive?: boolean;
+        }) => Promise<void>;
+    };
+    readonly exec: {
+        start: (req: {
+            session_id?: import("./index.js").CellComponents["schemas"]["SessionIdValue"];
+            argv: string[];
+            env?: {
+                [key: string]: string;
+            };
+            cwd?: string;
+            user?: string;
+            stdin_open?: boolean;
+            stdin?: string;
+            timeout_ms?: number;
+            kill_grace_ms?: number;
+            secret_refs?: import("./index.js").CellComponents["schemas"]["SecretRefs"];
+            execution_id?: import("./index.js").CellComponents["schemas"]["ExecutionIdValue"];
+            output_limit_bytes?: number;
+            burst?: "never" | "always";
+            burst_vcpus?: number;
+            burst_memory_mib?: number;
+            resource_hint?: "auto" | "light" | "heavy";
+        }, signal?: AbortSignal | undefined) => Promise<{
+            session_id: string;
+            state: import("./index.js").CellComponents["schemas"]["SessionState"];
+            created: boolean;
+            pid?: number;
+            exit_code?: number | null;
+            term_signal?: number | null;
+            timed_out?: boolean;
+            canceled?: boolean;
+            stdout_size: number;
+            stderr_size: number;
+            created_at?: string;
+            started_at?: string | null;
+            ended_at?: string | null;
+            error?: string;
+            memory_grow?: import("./index.js").CellComponents["schemas"]["MemoryGrow"];
+            burst?: import("./index.js").CellComponents["schemas"]["BurstSummary"];
+        }>;
+        input: (id: string, bytes: string | Uint8Array, opts: {
+            offset: number;
+            close?: boolean;
+            signal?: AbortSignal;
+        }) => Promise<{
+            offset: number;
+            closed: false;
+        }>;
+        output: (id: string, opts?: {
+            stdoutOffset?: number;
+            stderrOffset?: number;
+            follow?: boolean;
+            signal?: AbortSignal;
+        }) => Promise<AsyncGenerator<{
+            type: "output" | "exit" | "heartbeat" | "error";
+            stream?: "stdout" | "stderr";
+            offset?: number;
+            data?: string;
+            session?: import("./index.js").CellComponents["schemas"]["ExecSession"];
+            error?: import("./index.js").CellComponents["schemas"]["ErrorBody"];
+        }, any, any>>;
+        cancel: (id: string) => Promise<ExecSession>;
+    };
+    input(id: string, value: string | Uint8Array, opts: {
+        offset: number;
+        signal?: AbortSignal;
+    }): Promise<{
+        offset: number;
+        closed: false;
+    }>;
+    output(id: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<AsyncGenerator<OutputEvent>>;
+}