anyclaude-sdk 0.4.0 → 0.4.1

package/README.md

@@ -1,5 +1,11 @@
 # anyclaude-sdk
 
+[![npm version](https://img.shields.io/npm/v/anyclaude-sdk.svg)](https://www.npmjs.com/package/anyclaude-sdk)
+[![anyclaude-react](https://img.shields.io/npm/v/anyclaude-react.svg?label=anyclaude-react)](https://www.npmjs.com/package/anyclaude-react)
+[![license](https://img.shields.io/npm/l/anyclaude-sdk.svg)](LICENSE)
+[![docs](https://img.shields.io/badge/docs-anyclaude--docs.puter.site-4dd0e1.svg)](https://anyclaude-docs.puter.site)
+[![live demo](https://img.shields.io/badge/live%20demo-browser%20IDE-4dd0e1.svg)](https://anyclaude-docs.puter.site/demo/)
+
 Claude Code agent capabilities — tools, the tool loop, multi-turn conversations,
 MCP, sub-agents, sessions — against **any OpenAI- or Anthropic-compatible LLM
 endpoint**, running in the **browser** ([WebContainer](https://webcontainers.io)),

package/dist/agent.js

@@ -797,7 +797,19 @@ export async function* runAgent(options) {
                                 isError = !!r.isError;
                             }
                             catch (err) {
-                                content = `Error executing ${name}: ${err instanceof Error ? err.message : String(err)}`;
+                                const detail = err instanceof Error
+                                    ? err.message
+                                    : typeof err === 'string'
+                                        ? err
+                                        : (() => {
+                                            try {
+                                                return JSON.stringify(err);
+                                            }
+                                            catch {
+                                                return String(err);
+                                            }
+                                        })();
+                                content = `Error executing ${name}: ${detail}`;
                                 isError = true;
                             }
                             if (isError) {

package/dist/tools/bash.js

@@ -32,7 +32,15 @@ export const bash = {
             return { content: 'Error: `command` is required.', isError: true };
         }
         const timeout = typeof input.timeout_ms === 'number' ? input.timeout_ms : undefined;
-        const { output, exitCode } = await ctx.exec.exec(command, timeout);
+        let result;
+        try {
+            result = await ctx.exec.exec(command, timeout);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : typeof e === 'string' ? e : JSON.stringify(e);
+            return { content: `Failed to run command: ${msg}`, isError: true };
+        }
+        const { output, exitCode } = result;
         if (exitCode !== 0) {
             const body = output || '(no output)';
             return {

package/dist/workspace/webcontainer.d.ts

@@ -39,7 +39,11 @@ export interface WebContainerProcess {
 export declare class WebContainerWorkspace implements FileSystem, CommandExecutor {
     readonly wc: WebContainerLike;
     readonly cwd: string;
+    private cwdReady;
     constructor(wc: WebContainerLike, cwd?: string);
+    /** Ensure the working directory exists before spawning into it (memoized).
+     *  A fresh WebContainer has only `/`, so spawning with a missing cwd rejects. */
+    private ensureCwd;
     /** Resolve a possibly-relative path against the workspace cwd. */
     resolve(path: string): string;
     readFile(path: string): Promise<string | null>;

package/dist/workspace/webcontainer.js

@@ -8,9 +8,20 @@ const textDecoder = new TextDecoder();
  */
 export class WebContainerWorkspace {
     constructor(wc, cwd) {
+        this.cwdReady = null;
         this.wc = wc;
         this.cwd = cwd ?? wc.workdir ?? '/home/projects';
     }
+    /** Ensure the working directory exists before spawning into it (memoized).
+     *  A fresh WebContainer has only `/`, so spawning with a missing cwd rejects. */
+    ensureCwd() {
+        if (!this.cwdReady) {
+            this.cwdReady = Promise.resolve(this.wc.fs.mkdir(this.cwd, { recursive: true }))
+                .then(() => undefined)
+                .catch(() => undefined);
+        }
+        return this.cwdReady;
+    }
     /** Resolve a possibly-relative path against the workspace cwd. */
     resolve(path) {
         if (path.startsWith('/'))
@@ -80,10 +91,21 @@ export class WebContainerWorkspace {
     // ---- CommandExecutor ----
     async exec(command, timeoutMs = 120_000, env) {
         const sanitized = sanitizeCommand(command);
-        const proc = await this.wc.spawn('jsh', ['-c', sanitized], {
-            env,
-            cwd: this.cwd,
-        });
+        await this.ensureCwd();
+        let proc;
+        try {
+            proc = await this.wc.spawn('jsh', ['-c', sanitized], { env, cwd: this.cwd });
+        }
+        catch (e) {
+            // Last-resort: spawn without an explicit cwd (defaults to /) so a bad cwd
+            // never hard-fails the tool; surface a real message if even that fails.
+            try {
+                proc = await this.wc.spawn('jsh', ['-c', sanitized], { env });
+            }
+            catch {
+                throw new Error(`failed to start shell (jsh): ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
         let output = '';
         const reader = proc.output.getReader();
         const collect = (async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anyclaude-sdk",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "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",