@vibe-agent-toolkit/utils 0.1.39-rc.1 → 0.1.39-rc.10

package/dist/skill-test/spawn-claude.js

@@ -0,0 +1,92 @@
+import { spawn } from 'node:child_process';
+import { createReadStream } from 'node:fs';
+import which from 'which';
+/**
+ * Pure assembly of the headless `claude -p` argv (spec §9). The prompt is never
+ * inlined as an argv string (Windows cmd-quoting safety) and claude 2.x has no
+ * `--prompt-file` flag — the prompt is fed to the child's stdin by
+ * {@link spawnHeadlessClaude} instead. `--setting-sources ""` suppresses
+ * user/project settings; built-in skills remain (§5).
+ */
+export function assembleClaudeArgs(opts) {
+    const args = [
+        '-p',
+        // claude 2.x rejects `-p --output-format stream-json` unless --verbose is
+        // also passed ("--output-format=stream-json requires --verbose"). The
+        // streamed JSON is piped to stderr for progress visibility.
+        '--output-format', 'stream-json',
+        '--verbose',
+        '--setting-sources', '',
+        '--permission-mode', 'bypassPermissions',
+        '--add-dir', opts.sandboxDir,
+    ];
+    for (const dir of opts.pluginDirs) {
+        args.push('--plugin-dir', dir);
+    }
+    if (opts.model !== undefined)
+        args.push('--model', opts.model);
+    if (opts.maxTurns !== undefined)
+        args.push('--max-turns', String(opts.maxTurns));
+    if (opts.maxBudgetUsd !== undefined)
+        args.push('--max-budget-usd', String(opts.maxBudgetUsd));
+    return args;
+}
+/**
+ * Spawn the headless `claude`. The prompt file is streamed to the child's stdin
+ * so the session reads its prompt and then sees EOF (it cannot block on input,
+ * §16). Wall-clock kill on timeout. If `stallMs` is set, a resettable stall
+ * watchdog kills the child when no output is received for that duration
+ * (stalled: true in result).
+ */
+export async function spawnHeadlessClaude(opts) {
+    const bin = which.sync('claude');
+    const args = assembleClaudeArgs(opts);
+    return await new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { cwd: opts.cwd, env: opts.env, stdio: ['pipe', 'pipe', 'pipe'] });
+        let timedOut = false;
+        let stalled = false;
+        const wallTimer = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGKILL');
+        }, opts.timeoutMs);
+        // Stall watchdog: reset on every stdout/stderr chunk; fire if silent for stallMs.
+        let stallTimer;
+        if (opts.stallMs !== undefined) {
+            const stallMs = opts.stallMs;
+            const resetStallTimer = () => {
+                if (stallTimer !== undefined)
+                    clearTimeout(stallTimer);
+                stallTimer = setTimeout(() => {
+                    stalled = true;
+                    child.kill('SIGKILL');
+                }, stallMs);
+            };
+            resetStallTimer();
+            child.stdout.on('data', () => { resetStallTimer(); });
+            child.stderr.on('data', () => { resetStallTimer(); });
+        }
+        const clearAllTimers = () => {
+            clearTimeout(wallTimer);
+            if (stallTimer !== undefined)
+                clearTimeout(stallTimer);
+        };
+        // Feed the prompt to the child via stdin (claude 2.x has no --prompt-file).
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- our own derived prompt path
+        const promptStream = createReadStream(opts.promptFile);
+        promptStream.on('error', err => {
+            clearAllTimers();
+            child.kill('SIGKILL');
+            reject(err);
+        });
+        // Swallow EPIPE: if the child exits before consuming all stdin, the write
+        // end errors — that is not a harness failure (the close handler reports the
+        // child's real exit status).
+        child.stdin.on('error', () => { });
+        promptStream.pipe(child.stdin);
+        child.stdout.on('data', (d) => { opts.onStdout?.(d.toString()); });
+        child.stderr.on('data', (d) => { opts.onStderr?.(d.toString()); });
+        child.on('error', err => { clearAllTimers(); reject(err); });
+        child.on('close', code => { clearAllTimers(); resolve({ status: code ?? -1, timedOut, stalled }); });
+    });
+}
+//# sourceMappingURL=spawn-claude.js.map

package/dist/skill-test/spawn-claude.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/utils",
-  "version": "0.1.39-rc.1",
+  "version": "0.1.39-rc.10",
   "type": "module",
   "description": "Core utility functions with no external dependencies",
   "keywords": [
@@ -23,7 +23,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && tsx ../dev-tools/src/copy-yaml-assets.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
@@ -33,7 +33,8 @@
     "handlebars": "^4.7.8",
     "ignore": "^7.0.5",
     "picomatch": "^4.0.3",
-    "which": "^5.0.0"
+    "which": "^5.0.0",
+    "yaml": "^2.6.1"
   },
   "peerDependencies": {
     "zod": "^3.25.0 || ^4.0.0"