@capsule-run/sdk 0.8.4 → 0.8.6

package/dist/run.js

@@ -5,9 +5,12 @@
  * from third party applications.
  */
 import { execFile } from 'child_process';
-import { resolve, extname } from 'path';
-import { existsSync } from 'fs';
+import { resolve, extname, join } from 'path';
+import { existsSync, writeFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { randomUUID } from 'crypto';
 const WASM_EXTENSIONS = new Set(['.wasm']);
+const ARGS_FILE_THRESHOLD = 8 * 1024;
 /**
  * Get the appropriate capsule command for the current platform
  */
@@ -17,6 +20,15 @@ function getCapsuleCommand(capsulePath) {
     }
     return capsulePath;
 }
+/**
+ * Write args to a temp file and return its path.
+ * Caller is responsible for deleting it.
+ */
+function writeArgsFile(args) {
+    const path = join(tmpdir(), `capsule-args-${randomUUID()}.json`);
+    writeFileSync(path, JSON.stringify(args), 'utf-8');
+    return path;
+}
 /**
  * Run a Capsule task from a third-party application
  *
@@ -36,16 +48,33 @@ export function run(options) {
         return Promise.reject(new Error(`File not found: ${resolvedFile}.${hint}`));
     }
     const subcommand = isWasm ? 'exec' : 'run';
+    const mountFlags = mounts.flatMap(m => ['--mount', m]);
+    const serializedArgs = JSON.stringify(args);
+    const useArgsFile = Buffer.byteLength(serializedArgs, 'utf-8') > ARGS_FILE_THRESHOLD;
+    let argsFilePath = null;
+    let argsFlags;
+    if (useArgsFile) {
+        argsFilePath = writeArgsFile(args);
+        argsFlags = ['--args-file', argsFilePath];
+    }
+    else {
+        argsFlags = args;
+    }
+    const cmdArgs = [subcommand, resolvedFile, '--json', ...mountFlags, ...argsFlags];
+    let executable = command;
+    let executionArgs = cmdArgs;
+    if (process.platform === 'win32') {
+        executable = process.env.comspec || 'cmd.exe';
+        executionArgs = ['/d', '/s', '/c', command, ...cmdArgs];
+    }
     return new Promise((resolve, reject) => {
-        const mountFlags = mounts.flatMap(m => ['--mount', m]);
-        const cmdArgs = [subcommand, resolvedFile, '--json', ...mountFlags, ...args];
-        let executable = command;
-        let executionArgs = cmdArgs;
-        if (process.platform === 'win32') {
-            executable = process.env.comspec || 'cmd.exe';
-            executionArgs = ['/d', '/s', '/c', command, ...cmdArgs];
-        }
         execFile(executable, executionArgs, { cwd, encoding: 'utf-8' }, (error, stdout, stderr) => {
+            if (argsFilePath) {
+                try {
+                    unlinkSync(argsFilePath);
+                }
+                catch { }
+            }
             if (error && !stdout) {
                 if (error.code === 'ENOENT') {
                     reject(new Error(`Capsule CLI not found. Use 'npm install -g @capsule-run/cli' to install it.`));

package/dist/run.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capsule-run/sdk",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "Capsule JavaScript SDK - run AI agent tasks in secure WASM sandboxes",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,7 +30,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/copy-unenv-polyfills.mjs",
     "clean": "rm -rf dist"
   },
   "keywords": [

package/src/polyfills/fs.ts

@@ -107,9 +107,11 @@ function resolvePath(path: string): { dir: Descriptor; relativePath: string } |
             continue;
         }
 
-        if (normalizedPath.startsWith(normalizedGuest + '/')) {
-            const relativePath = normalizedPath.slice(normalizedGuest.length + 1);
-            return { dir: descriptor, relativePath };
+        const guestPrefix = normalizedGuest.endsWith('/') ? normalizedGuest : normalizedGuest + '/';
+
+        if (normalizedPath.startsWith(guestPrefix)) {
+            const relativePath = normalizedPath.slice(guestPrefix.length);
+            return { dir: descriptor, relativePath: relativePath || '.' };
         }
 
         if (normalizedPath === normalizedGuest) {

package/src/polyfills/process.ts

@@ -70,20 +70,23 @@ function getArgv(): string[] {
 }
 
 /**
- * Initialized from wasi:cli/environment initialCwd(), falls back to '.'.
+ * Initialized from wasi:cli/environment initialCwd(), falls back to '/'.
  */
 let _virtualCwd: string = (() => {
     try {
         const env = (globalThis as any)['wasi:cli/environment'];
         if (env && typeof env.initialCwd === 'function') {
-            return env.initialCwd() ?? '.';
+            const initial = env.initialCwd();
+            if (initial) {
+                 return initial.startsWith('/') ? initial : '/' + initial;
+            }
         }
     } catch {}
-    return '.';
+    return '/';
 })();
 
 /**
- * Internal setter for virtual CWD — handles relative and absolute paths.
+ * Internal setter for virtual CWD — handles relative and absolute paths safely via absolute resolution.
  */
 function setCwd(directory: string): void {
     if (!directory) return;
@@ -92,11 +95,10 @@ function setCwd(directory: string): void {
     } else if (directory === '..') {
         const parts = _virtualCwd.split('/').filter(Boolean);
         parts.pop();
-        _virtualCwd = parts.join('/') || '.';
+        _virtualCwd = '/' + parts.join('/');
     } else {
-        _virtualCwd = (_virtualCwd === '.' || _virtualCwd === '')
-            ? directory.replace(/\/+$/, '')
-            : _virtualCwd.replace(/\/+$/, '') + '/' + directory.replace(/\/+$/, '');
+        const base = _virtualCwd.endsWith('/') ? _virtualCwd : _virtualCwd + '/';
+        _virtualCwd = (base + directory).replace(/\/+$/, '');
     }
 }
 

package/src/run.ts

@@ -6,8 +6,10 @@
  */
 
 import { execFile } from 'child_process';
-import { resolve, extname } from 'path';
-import { existsSync } from 'fs';
+import { resolve, extname, join } from 'path';
+import { existsSync, writeFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { randomUUID } from 'crypto';
 import { HostRequest } from './task';
 
 export interface RunnerOptions {
@@ -33,6 +35,7 @@ export interface RunnerResult {
 }
 
 const WASM_EXTENSIONS = new Set(['.wasm']);
+const ARGS_FILE_THRESHOLD = 8 * 1024;
 
 /**
  * Get the appropriate capsule command for the current platform
@@ -44,6 +47,16 @@ function getCapsuleCommand(capsulePath: string): string {
   return capsulePath;
 }
 
+/**
+ * Write args to a temp file and return its path.
+ * Caller is responsible for deleting it.
+ */
+function writeArgsFile(args: string[]): string {
+  const path = join(tmpdir(), `capsule-args-${randomUUID()}.json`);
+  writeFileSync(path, JSON.stringify(args), 'utf-8');
+  return path;
+}
+
 /**
  * Run a Capsule task from a third-party application
  *
@@ -66,20 +79,37 @@ export function run(options: RunnerOptions): Promise<RunnerResult> {
   }
 
   const subcommand = isWasm ? 'exec' : 'run';
+  const mountFlags = mounts.flatMap(m => ['--mount', m]);
 
-  return new Promise((resolve, reject) => {
-    const mountFlags = mounts.flatMap(m => ['--mount', m]);
-    const cmdArgs = [subcommand, resolvedFile, '--json', ...mountFlags, ...args];
+  const serializedArgs = JSON.stringify(args);
+  const useArgsFile = Buffer.byteLength(serializedArgs, 'utf-8') > ARGS_FILE_THRESHOLD;
+
+  let argsFilePath: string | null = null;
+  let argsFlags: string[];
 
-    let executable = command;
-    let executionArgs = cmdArgs;
+  if (useArgsFile) {
+    argsFilePath = writeArgsFile(args);
+    argsFlags = ['--args-file', argsFilePath];
+  } else {
+    argsFlags = args;
+  }
 
-    if (process.platform === 'win32') {
-      executable = process.env.comspec || 'cmd.exe';
-      executionArgs = ['/d', '/s', '/c', command, ...cmdArgs];
-    }
+  const cmdArgs = [subcommand, resolvedFile, '--json', ...mountFlags, ...argsFlags];
 
+  let executable = command;
+  let executionArgs = cmdArgs;
+
+  if (process.platform === 'win32') {
+    executable = process.env.comspec || 'cmd.exe';
+    executionArgs = ['/d', '/s', '/c', command, ...cmdArgs];
+  }
+
+  return new Promise((resolve, reject) => {
     execFile(executable, executionArgs, { cwd, encoding: 'utf-8' }, (error, stdout, stderr) => {
+      if (argsFilePath) {
+        try { unlinkSync(argsFilePath); } catch { }
+      }
+
       if (error && !stdout) {
         if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
           reject(new Error(