@shardflux/sdk 0.14.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,7 +1,8 @@
-import type { CellClientOptions } from './cell.js';
+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';
-import type { Workspace } from './workspace.js';
+import type { HintOptions, HintResult } from './workspace.js';
 /**
  * The JSON Schema subset of the tool definitions. A type alias rather than an interface (0.8.0+), so a schema is
  * assignable to the providers' open schema types (`{ [key: string]: unknown }`) without a cast, and an object literal
@@ -48,7 +49,24 @@ export declare class ToolArgumentError extends Error {
 }
 /** Validates the JSON-Schema subset used by the tool definitions. Returns problems (empty = valid). */
 export declare function validateArgs(schema: JsonSchema, value: unknown, path?: string): string[];
+/**
+ * What workspace tools act on: an opened `Workspace`, or a `WorkspaceRef` (0.15.0+) whose first tool call opens the key.
+ * `cell()` may return a promise (a ref opens first); `mode` and `grantedTools` are read when the tools are built.
+ */
+export interface ToolTarget {
+    readonly mode: WorkspaceMode;
+    readonly grantedTools: ToolName[] | null;
+    cell(opts?: {
+        agentLabel?: string;
+        tools?: ToolName[];
+    } & CellClientOptions): CellClient | Promise<CellClient>;
+    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
@@ -102,7 +120,7 @@ export interface WorkspaceToolsOptions {
     burst?: boolean;
 }
 /** Builds the tool list for a workspace. Synchronous: tokens are fetched on first use. */
-export declare function workspaceTools(workspace: Workspace, opts?: WorkspaceToolsOptions): WorkspaceTool[];
+export declare function workspaceTools(workspace: ToolTarget, opts?: WorkspaceToolsOptions): WorkspaceTool[];
 /** Anthropic Messages API tool definition; assignable to `Anthropic.Tool` (0.8.0+). */
 export type AnthropicToolDefinition = {
     name: string;