anyclaude-sdk 0.4.3 → 0.4.5

package/README.md

@@ -317,10 +317,19 @@ Pluggable `SessionStore` adapters (all implement `SessionStoreLike`): `SessionSt
 Declare tools the **host** executes — e.g. run `bash` in the user's browser WebContainer while the agent loop runs on your server. The run pauses with a `client_tool_request`; the client executes it and you resume with the result:
 
 ```ts
-query({ prompt, llm, workspace, sessionId, clientTools: ['bash'] })   // → emits client_tool_request + pauses
+import { WORKSPACE_TOOL_NAMES } from 'anyclaude-sdk'
+query({ prompt, llm, workspace, sessionId, clientTools: WORKSPACE_TOOL_NAMES })  // → emits client_tool_request + pauses
 query({ llm, workspace, sessionId, resume: true, continueRun: true, clientToolResults })  // → continues
 ```
 
+On the browser side, `anyclaude-react` turns those into a ready executor map backed by **any** workspace — a WebContainer (real shell + files), the user's **IndexedDB** (`DexieFileSystem`), OPFS, or memory:
+
+```tsx
+import { createWebContainerClientTools, createWorkspaceClientTools } from 'anyclaude-react'
+useAgent({ endpoint: '/api/agent', clientTools: createWebContainerClientTools(wc) })           // files + bash
+useAgent({ endpoint: '/api/agent', clientTools: createWorkspaceClientTools(new DexieFileSystem('my-db')) }) // IndexedDB
+```
+
 ## Interactive — `ask_user_question`
 
 Provide `onAskUser` and the agent gains an `ask_user_question` tool to put a multiple-choice decision to the user:

package/dist/fs/dexie.d.ts

@@ -22,11 +22,16 @@ export interface DexieFileSystemOptions {
     cwd?: string;
     /** Wipe all nodes on first open (fresh filesystem). */
     resetOnInit?: boolean;
+    /** Use an existing Dexie instance instead of opening one by name — lets the
+     *  filesystem share a database your app already owns. It must declare a
+     *  `nodes` table keyed by `path` (or be a fresh Dexie this FS can version). */
+    db?: unknown;
 }
 export declare class DexieFileSystem implements FileSystem {
     readonly cwd: string;
     private readonly dbName;
     private readonly resetOnInit;
+    private readonly injectedDb;
     private db;
     private opening;
     constructor(dbName?: string, options?: DexieFileSystemOptions);

package/dist/fs/dexie.js

@@ -20,6 +20,7 @@ export class DexieFileSystem {
         this.dbName = dbName;
         this.cwd = options.cwd ?? '/';
         this.resetOnInit = options.resetOnInit ?? false;
+        this.injectedDb = options.db ?? null;
     }
     // ---- lifecycle ----
     async open() {
@@ -28,14 +29,25 @@ export class DexieFileSystem {
         if (this.opening)
             return this.opening;
         this.opening = (async () => {
-            // @ts-ignore optional peer dependency, resolved at runtime
-            const mod = await import('dexie');
-            const Dexie = mod.default ?? mod;
-            const db = new Dexie(this.dbName);
-            db.version(1).stores({
-                // primary key `path`, secondary index `parent`
-                nodes: 'path, parent',
-            });
+            let db;
+            if (this.injectedDb) {
+                // Use the caller's Dexie instance. Declare our schema if it isn't open
+                // yet; an already-open db is assumed to carry a compatible `nodes` table.
+                db = this.injectedDb;
+                if (!db.isOpen?.()) {
+                    db.version(1).stores({ nodes: 'path, parent' });
+                }
+            }
+            else {
+                // @ts-ignore optional peer dependency, resolved at runtime
+                const mod = await import('dexie');
+                const Dexie = mod.default ?? mod;
+                db = new Dexie(this.dbName);
+                db.version(1).stores({
+                    // primary key `path`, secondary index `parent`
+                    nodes: 'path, parent',
+                });
+            }
             this.db = db;
             if (this.resetOnInit)
                 await db.nodes.clear();

package/dist/tools/index.d.ts

@@ -23,6 +23,11 @@ export { defineTool, type DefineToolSpec } from './define.js';
 export { askUserQuestion } from './ask_user.js';
 /** Every built-in Claude Code tool, ready to pass to `query()`. */
 export declare const ALL_CLAUDE_CODE_TOOLS: Tool[];
+/** Built-in tools that operate on the workspace (filesystem + shell). Pass as
+ *  `query({ clientTools: WORKSPACE_TOOL_NAMES })` to execute them on the HOST
+ *  (e.g. a browser WebContainer or IndexedDB FS) instead of server-side. Pair
+ *  with anyclaude-react's `createWorkspaceClientTools(workspace)`. */
+export declare const WORKSPACE_TOOL_NAMES: readonly ["bash", "write_file", "read_file", "edit_file", "multi_edit", "delete_file", "list_files", "glob", "grep"];
 /** Extract the OpenAI-shape definitions to send to the LLM. */
 export declare function toolDefs(tools: Tool[]): ToolDef[];
 /** Build a name→tool lookup for dispatching tool calls. */

package/dist/tools/index.js

@@ -36,6 +36,21 @@ export const ALL_CLAUDE_CODE_TOOLS = [
     toolSearch,
     config,
 ];
+/** Built-in tools that operate on the workspace (filesystem + shell). Pass as
+ *  `query({ clientTools: WORKSPACE_TOOL_NAMES })` to execute them on the HOST
+ *  (e.g. a browser WebContainer or IndexedDB FS) instead of server-side. Pair
+ *  with anyclaude-react's `createWorkspaceClientTools(workspace)`. */
+export const WORKSPACE_TOOL_NAMES = [
+    'bash',
+    'write_file',
+    'read_file',
+    'edit_file',
+    'multi_edit',
+    'delete_file',
+    'list_files',
+    'glob',
+    'grep',
+];
 /** Extract the OpenAI-shape definitions to send to the LLM. */
 export function toolDefs(tools) {
     return tools.map((t) => t.def);

package/package.json

@@ -1,22 +1,53 @@
 {
   "name": "anyclaude-sdk",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Standalone, browser-compatible SDK providing Claude Code agent capabilities (tools, tool loop, multi-turn, MCP, sub-agents, sessions) against any OpenAI/Anthropic-compatible LLM endpoint. Runs in the browser (WebContainer), Node, and Bun — no backend required.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
-    "./query": { "types": "./dist/query.d.ts", "import": "./dist/query.js" },
-    "./workspace": { "types": "./dist/workspace/index.d.ts", "import": "./dist/workspace/index.js" },
-    "./sandbox": { "types": "./dist/sandbox/index.d.ts", "import": "./dist/sandbox/index.js" },
-    "./fs": { "types": "./dist/fs/index.d.ts", "import": "./dist/fs/index.js" },
-    "./llm": { "types": "./dist/llm/index.d.ts", "import": "./dist/llm/index.js" },
-    "./tools": { "types": "./dist/tools/index.d.ts", "import": "./dist/tools/index.js" },
-    "./session": { "types": "./dist/session/index.d.ts", "import": "./dist/session/index.js" },
-    "./memory": { "types": "./dist/memory/index.d.ts", "import": "./dist/memory/index.js" },
-    "./package.json": "./package.json"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./query": {
+      "types": "./dist/query.d.ts",
+      "import": "./dist/query.js"
+    },
+    "./workspace": {
+      "types": "./dist/workspace/index.d.ts",
+      "import": "./dist/workspace/index.js"
+    },
+    "./sandbox": {
+      "types": "./dist/sandbox/index.d.ts",
+      "import": "./dist/sandbox/index.js"
+    },
+    "./fs": {
+      "types": "./dist/fs/index.d.ts",
+      "import": "./dist/fs/index.js"
+    },
+    "./llm": {
+      "types": "./dist/llm/index.d.ts",
+      "import": "./dist/llm/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js"
+    },
+    "./session": {
+      "types": "./dist/session/index.d.ts",
+      "import": "./dist/session/index.js"
+    },
+    "./memory": {
+      "types": "./dist/memory/index.d.ts",
+      "import": "./dist/memory/index.js"
+    },
+    "./package.json": "./package.json",
+    "./compact": {
+      "types": "./dist/compact.d.ts",
+      "import": "./dist/compact.js"
+    }
   },
   "sideEffects": false,
   "files": [
@@ -64,12 +95,24 @@
     "e2b": "*"
   },
   "peerDependenciesMeta": {
-    "@webcontainer/api": { "optional": true },
-    "dexie": { "optional": true },
-    "e2b": { "optional": true },
-    "@vercel/sandbox": { "optional": true },
-    "@daytonaio/sdk": { "optional": true },
-    "@cloudflare/sandbox": { "optional": true }
+    "@webcontainer/api": {
+      "optional": true
+    },
+    "dexie": {
+      "optional": true
+    },
+    "e2b": {
+      "optional": true
+    },
+    "@vercel/sandbox": {
+      "optional": true
+    },
+    "@daytonaio/sdk": {
+      "optional": true
+    },
+    "@cloudflare/sandbox": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^26.0.0",