@cavelang/cli 0.35.0 → 0.36.0

package/dist/internal/loop/llm.js

@@ -11,7 +11,7 @@
  *   model twice per step (select, then "are we done?"). Both decisions fit
  *   one prompt: the model replies with the next cue to expand *or* `STOP`,
  *   and the loop already treats an `undefined` selection as the stop
- *   signal. `done` then only enforces the hard budgets, for free.
+ *   signal. `done` then only checks the stopping budgets, for free.
  * - **Scoring stays local.** Models are better spent on select/stop than
  *   on per-edge arithmetic; `score` is the same parent × confidence ×
  *   decay the heuristic uses, so the scores shown in the prompt mean the
@@ -34,11 +34,25 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { emitClaim } from '@cavelang/canonical';
 import { runProcess, shellCommand } from "./process.js";
+import { validateBudgets } from "./budgets.js";
+import { propagatedScore, validateScoreSetting } from "./score-settings.js";
+import { completionTimeoutMs } from "./timeout.js";
 /** The reply that ends the reconstruction. */
 export const stopToken = 'STOP';
 const defaultMaxCues = 16;
+const cueLimit = (maxCues = defaultMaxCues) => {
+    if (!Number.isSafeInteger(maxCues) || maxCues < 1) {
+        throw new TypeError('maxCues must be a positive safe integer');
+    }
+    return maxCues;
+};
 /** Strongest first; stable sort keeps FIFO order on ties, like the heuristic. */
 const strongestFirst = (frontier) => [...frontier].sort((a, b) => b.score - a.score);
+/** Keep familiar hundredths when exact without erasing distinctions used by selection. */
+const scoreText = (score) => {
+    const rounded = score.toFixed(2);
+    return Number(rounded) === score ? rounded : String(score);
+};
 /**
  * The single per-step prompt: the query, the claims collected so far as
  * canonical CAVE lines, the strongest frontier cues with their scores, and
@@ -46,17 +60,20 @@ const strongestFirst = (frontier) => [...frontier].sort((a, b) => b.score - a.sc
  * the same rendering under a different transport.
  */
 export const selectPrompt = (state, options = {}) => {
-    const cues = strongestFirst(state.frontier).slice(0, options.maxCues ?? defaultMaxCues);
+    const maxCues = cueLimit(options.maxCues);
+    const query = options.query;
+    const instructions = options.instructions;
+    const cues = strongestFirst(state.frontier).slice(0, maxCues);
     return [
         'You are driving memory reconstruction over a CAVE claim graph, one step at a time.',
-        ...options.query === undefined ? [] : ['', `Query: ${options.query}`],
+        ...query === undefined ? [] : ['', `Query: ${query}`],
         '',
         'Claims collected so far (canonical CAVE):',
         ...state.collected.length === 0 ? ['(none yet)'] : state.collected.map(claim => emitClaim(claim)),
         '',
         'Frontier cues (entity @ score); expanding a cue collects its claims and its neighbors:',
-        ...cues.map(cue => `${cue.entity} @ ${cue.score.toFixed(2)}`),
-        ...options.instructions === undefined ? [] : ['', options.instructions],
+        ...cues.map(cue => `${cue.entity} @ ${scoreText(cue.score)}`),
+        ...instructions === undefined ? [] : ['', instructions],
         '',
         'Reply with exactly one line: the name of the single frontier cue to expand next, ' +
             `or ${stopToken} when the collected claims already answer the query ` +
@@ -64,22 +81,39 @@ export const selectPrompt = (state, options = {}) => {
     ].join('\n');
 };
 /** List markers, punctuation, quotes and backticks around a model's answer. */
-const stripped = (line) => line.trim()
-    .replace(/^[-*\d.)\s]+/, '')
+const unlisted = (line) => line.trim().replace(/^(?:[-*]|\d+[.)])\s+/, '');
+const stripped = (line) => unlisted(line)
     .replace(/[.!,;:]+$/, '')
     .replace(/^[`'"]+|[`'"]+$/g, '')
     .trim();
-const wordChar = /[A-Za-z0-9_/-]/;
+const wordChars = String.raw `[\p{L}\p{M}\p{N}_/-]`;
+const startsWithWord = new RegExp(`^${wordChars}`, 'u');
+// Dots and colons connect name segments only when another word character
+// follows on that side; sentence punctuation such as `api. ` stays a boundary.
+const continuesName = (reply, boundary, direction) => {
+    let index = boundary;
+    while (/[.:]/.test(reply[direction === -1 ? index - 1 : index] ?? '')) {
+        index += direction;
+    }
+    // Two code units preserve an adjacent astral code point on either side.
+    const adjacent = direction === -1
+        ? [...reply.slice(Math.max(0, index - 2), index)].at(-1) ?? ''
+        : reply.slice(index, index + 2);
+    return startsWithWord.test(adjacent);
+};
 /** First occurrence of `entity` in `reply` not embedded in a larger word. */
 const mentionAt = (reply, entity) => {
+    // Empty names can match exact replies, but cannot be mentioned in prose.
+    // indexOf('', from) clamps to reply.length, so advancing from never ends.
+    if (entity === '')
+        return -1;
     for (let from = 0;;) {
         const index = reply.indexOf(entity, from);
         if (index === -1) {
             return -1;
         }
-        const before = index === 0 ? undefined : reply[index - 1];
-        const after = index + entity.length >= reply.length ? undefined : reply[index + entity.length];
-        if ((before === undefined || !wordChar.test(before)) && (after === undefined || !wordChar.test(after))) {
+        const end = index + entity.length;
+        if (!continuesName(reply, index, -1) && !continuesName(reply, end, 1)) {
             return index;
         }
         from = index + 1;
@@ -90,6 +124,7 @@ const mentionAt = (reply, entity) => {
  *
  * 1. the trimmed reply, its last non-empty line, or either with list
  *    markers/quotes stripped, is exactly a frontier entity → that cue;
+ *    trailing sentence punctuation prefers the longest matching literal name;
  * 2. the reply's first word is the stop token (any case) → stop;
  * 3. the earliest frontier entity mentioned anywhere in the reply → that
  *    cue (ties at one position go to the longer name; occurrences inside
@@ -104,13 +139,23 @@ export const parseSelection = (reply, frontier) => {
     }
     const byEntity = new Map(frontier.map(cue => [cue.entity, cue]));
     const lastLine = reply.split('\n').map(line => line.trim()).filter(line => line !== '').at(-1) ?? '';
-    for (const candidate of [reply.trim(), lastLine, stripped(lastLine), stripped(reply)]) {
-        const exact = byEntity.get(candidate);
+    for (const candidate of [reply.trim(), lastLine, unlisted(lastLine), unlisted(reply), stripped(lastLine), stripped(reply)]) {
+        let exact = byEntity.get(candidate);
+        if (exact === undefined) {
+            // Prefer a complete literal name before treating its suffix as punctuation.
+            for (const cue of frontier) {
+                if (candidate.startsWith(cue.entity) && /^[.!,;:]+$/.test(candidate.slice(cue.entity.length)) &&
+                    (exact === undefined || cue.entity.length > exact.entity.length))
+                    exact = cue;
+            }
+        }
         if (exact !== undefined) {
             return exact;
         }
     }
-    if (new RegExp(`^${stopToken}\\b`, 'i').test(reply.trim())) {
+    // Normalize only ASCII STOP spellings so case folding cannot move offsets.
+    const stopAt = mentionAt(reply.trim().replace(/stop/gi, stopToken), stopToken);
+    if (stopAt === 0) {
         return undefined;
     }
     let mentioned;
@@ -127,7 +172,7 @@ export const parseSelection = (reply, frontier) => {
     if (mentioned !== undefined) {
         return mentioned.cue;
     }
-    if (new RegExp(`\\b${stopToken}\\b`, 'i').test(reply)) {
+    if (stopAt !== -1) {
         return undefined;
     }
     return strongestFirst(frontier)[0];
@@ -143,15 +188,23 @@ export const llmPolicy = (complete, options = {}) => {
     const decay = options.decay ?? 0.8;
     const maxSteps = options.maxSteps ?? 16;
     const maxClaims = options.maxClaims ?? Number.POSITIVE_INFINITY;
+    validateBudgets(maxSteps, maxClaims);
+    validateScoreSetting('decay', decay);
+    const promptOptions = {
+        query: options.query,
+        instructions: options.instructions,
+        maxCues: cueLimit(options.maxCues)
+    };
     return {
         async select(state) {
-            if (state.frontier.length === 0) {
+            const frontier = state.frontier.map(({ entity, score, depth }) => ({ entity, score, depth }));
+            if (frontier.length === 0) {
                 return undefined;
             }
-            return parseSelection(await complete(selectPrompt(state, options)), state.frontier);
+            return parseSelection(await complete(selectPrompt({ ...state, frontier }, promptOptions)), frontier);
         },
         async score(edge, from) {
-            return from.score * edge.conf * decay;
+            return propagatedScore(from.score, edge.conf, decay);
         },
         async done(state) {
             return state.steps >= maxSteps || state.collected.length >= maxClaims;
@@ -171,33 +224,63 @@ export const llmPolicy = (complete, options = {}) => {
  * ```
  */
 export const shellComplete = (template, options = {}) => {
-    const timeoutSeconds = options.timeoutSeconds ?? 120;
+    const timeoutMs = completionTimeoutMs(options.timeoutSeconds ?? 120);
+    const cwd = options.cwd;
+    const signal = options.signal;
+    const maxStdoutBytes = options.maxStdoutBytes;
+    const maxStderrBytes = options.maxStderrBytes;
     return async (prompt) => {
+        signal?.throwIfAborted();
+        if (/[\uD800-\uDFFF]/u.test(prompt)) {
+            throw new TypeError('agent prompt must contain well-formed Unicode');
+        }
         let dir;
+        const failures = [];
         const substitutions = {};
-        if (template.includes('{prompt-file}')) {
-            dir = mkdtempSync(join(tmpdir(), 'cave-loop-'));
-            const file = join(dir, 'prompt.md');
-            writeFileSync(file, prompt);
-            substitutions['prompt-file'] = file;
-        }
         try {
+            if (template.includes('{prompt-file}')) {
+                dir = mkdtempSync(join(tmpdir(), 'cave-loop-'));
+                const file = join(dir, 'prompt.md');
+                writeFileSync(file, prompt);
+                substitutions['prompt-file'] = file;
+            }
             const result = await runProcess(shellCommand(template, substitutions), {
+                strictStdoutUtf8: true,
                 input: prompt,
-                timeoutMs: timeoutSeconds * 1000,
-                ...options.cwd === undefined ? {} : { cwd: options.cwd },
-                ...options.signal === undefined ? {} : { signal: options.signal },
-                ...options.maxStdoutBytes === undefined ? {} : { maxStdoutBytes: options.maxStdoutBytes },
-                ...options.maxStderrBytes === undefined ? {} : { maxStderrBytes: options.maxStderrBytes }
+                timeoutMs,
+                ...cwd === undefined ? {} : { cwd },
+                ...signal === undefined ? {} : { signal },
+                ...maxStdoutBytes === undefined ? {} : { maxStdoutBytes },
+                ...maxStderrBytes === undefined ? {} : { maxStderrBytes }
             });
             if (result.code !== 0) {
                 throw new Error(`agent exited with ${result.code ?? `signal ${result.signal}`}`);
             }
             return result.stdout;
         }
+        catch (error) {
+            failures.push(error);
+            throw error;
+        }
         finally {
-            if (dir !== undefined)
-                rmSync(dir, { recursive: true, force: true });
+            if (dir !== undefined) {
+                try {
+                    rmSync(dir, { recursive: true, force: true });
+                }
+                catch (error) {
+                    if (failures.length === 0)
+                        throw error;
+                    const describe = (value) => {
+                        try {
+                            return value instanceof Error ? String(value.message) : String(value);
+                        }
+                        catch {
+                            return '[unprintable thrown value]';
+                        }
+                    };
+                    throw new AggregateError([failures[0], error], `${describe(failures[0])}; prompt cleanup also failed: ${describe(error)}`, { cause: failures[0] });
+                }
+            }
         }
     };
 };

package/dist/internal/loop/llm.js.map

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

package/dist/internal/loop/process.d.ts

@@ -10,7 +10,7 @@ export type ProcessResult = {
     readonly stdout: string;
     readonly stderr: string;
 };
-export type ProcessFailureKind = 'spawn' | 'timeout' | 'aborted' | 'stdout-limit' | 'stderr-limit';
+export type ProcessFailureKind = 'spawn' | 'timeout' | 'aborted' | 'stdout-limit' | 'stderr-limit' | 'stdout-encoding';
 export type ProcessFailureRecord = {
     readonly kind: ProcessFailureKind;
     readonly message: string;
@@ -36,6 +36,8 @@ export type ProcessOptions = {
     readonly signal?: AbortSignal;
     readonly maxStdoutBytes?: number;
     readonly maxStderrBytes?: number;
+    /** Reject malformed UTF-8 stdout before structured consumers interpret it. */
+    readonly strictStdoutUtf8?: boolean;
 };
 export type SyncProcessOptions = Omit<ProcessOptions, 'signal'>;
 export declare const defaultMaxStdoutBytes: number;

package/dist/internal/loop/process.d.ts.map

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

package/dist/internal/loop/process.js

@@ -1,5 +1,6 @@
 /** Portable, bounded external-process execution for CAVE integrations. */
 import { spawn, spawnSync } from 'node:child_process';
+import { isUtf8 } from 'node:buffer';
 import { fileURLToPath } from 'node:url';
 /** Typed, command-redacted failure for resource and lifecycle errors. */
 export class ProcessFailure extends Error {
@@ -62,12 +63,29 @@ export const shellCommand = (template, substitutions = {}, platform = process.pl
 };
 const emptyResult = () => ({ code: null, signal: null, stdout: '', stderr: '' });
 const positiveLimit = (value, fallback, name) => {
-    const result = value ?? fallback;
+    const result = value === undefined ? fallback : value;
     if (!Number.isSafeInteger(result) || result < 0) {
         throw new TypeError(`${name} must be a non-negative safe integer`);
     }
     return result;
 };
+const stdoutUtf8Mode = (value) => {
+    if (value !== undefined && typeof value !== 'boolean')
+        throw new TypeError('strictStdoutUtf8 must be a boolean');
+    return value === true;
+};
+const processInput = (value) => {
+    if (value !== undefined && typeof value !== 'string')
+        throw new TypeError('input must be a string');
+    return value;
+};
+const timeoutLimit = (value) => {
+    const timeoutMs = positiveLimit(value, 0, 'timeoutMs');
+    if (timeoutMs > 2147483647) {
+        throw new TypeError('timeoutMs must be in 0..2147483647');
+    }
+    return timeoutMs;
+};
 const killTree = (child) => {
     const pid = child.pid;
     if (pid === undefined)
@@ -107,14 +125,18 @@ const failureMessage = (kind, timeoutMs, limit) => {
         case 'aborted': return 'process was cancelled';
         case 'stdout-limit': return `process stdout exceeded ${limit} bytes`;
         case 'stderr-limit': return `process stderr exceeded ${limit} bytes`;
+        case 'stdout-encoding': return 'process stdout contains invalid UTF-8';
     }
 };
 /** Run an executable plus argument array with bounded output and tree cleanup. */
 export const runProcess = (command, options = {}) => {
     const stdoutLimit = positiveLimit(options.maxStdoutBytes, defaultMaxStdoutBytes, 'maxStdoutBytes');
     const stderrLimit = positiveLimit(options.maxStderrBytes, defaultMaxStderrBytes, 'maxStderrBytes');
-    const timeoutMs = positiveLimit(options.timeoutMs, 0, 'timeoutMs');
-    if (options.signal?.aborted === true) {
+    const timeoutMs = timeoutLimit(options.timeoutMs);
+    const strictStdoutUtf8 = stdoutUtf8Mode(options.strictStdoutUtf8);
+    const input = processInput(options.input);
+    const signal = options.signal;
+    if (signal?.aborted === true) {
         return Promise.reject(new ProcessFailure({
             kind: 'aborted', message: failureMessage('aborted', timeoutMs), result: emptyResult()
         }));
@@ -130,33 +152,66 @@ export const runProcess = (command, options = {}) => {
         let terminating = false;
         let timer;
         let spawnErrorCode;
-        const child = spawn(command.executable, [...command.args], {
-            shell: false,
-            detached: process.platform !== 'win32',
-            windowsHide: true,
-            stdio: ['pipe', 'pipe', 'pipe'],
-            ...options.cwd === undefined ? {} : { cwd: options.cwd },
-            ...options.env === undefined ? {} : { env: options.env }
-        });
+        let child;
+        try {
+            const cwd = options.cwd;
+            const env = options.env;
+            child = spawn(command.executable, [...command.args], {
+                shell: false,
+                detached: process.platform !== 'win32',
+                windowsHide: true,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                ...cwd === undefined ? {} : { cwd },
+                ...env === undefined ? {} : { env }
+            });
+        }
+        catch {
+            reject(new ProcessFailure({
+                kind: 'spawn',
+                message: failureMessage('spawn', timeoutMs),
+                result: emptyResult()
+            }));
+            return;
+        }
         const result = () => ({
             code,
             signal: exitSignal,
             stdout: Buffer.concat(stdout).toString('utf8'),
             stderr: Buffer.concat(stderr).toString('utf8')
         });
-        const cleanup = () => {
-            if (timer !== undefined)
-                clearTimeout(timer);
-            options.signal?.removeEventListener('abort', abort);
-        };
-        const finish = (failure) => {
+        const finish = (failure, cleanupErrors = []) => {
             if (settled)
                 return;
             settled = true;
-            cleanup();
-            child.stdin?.destroy();
-            child.stdout?.destroy();
-            child.stderr?.destroy();
+            if (failure === undefined && strictStdoutUtf8 && !isUtf8(Buffer.concat(stdout))) {
+                failure = new ProcessFailure({ kind: 'stdout-encoding', message: failureMessage('stdout-encoding', timeoutMs), result: result() });
+            }
+            for (const cleanup of [
+                () => { if (timer !== undefined)
+                    clearTimeout(timer); },
+                () => signal?.removeEventListener('abort', abort),
+                () => child.stdin?.destroy(),
+                () => child.stdout?.destroy(),
+                () => child.stderr?.destroy()
+            ]) {
+                try {
+                    cleanup();
+                }
+                catch (error) {
+                    cleanupErrors.push(error);
+                }
+            }
+            if (cleanupErrors.length > 0) {
+                const cleanup = new AggregateError(cleanupErrors, 'process cleanup failed', { cause: cleanupErrors[0] });
+                if (failure === undefined) {
+                    reject(cleanup);
+                    return;
+                }
+                // Preserve the typed process outcome and captured output for callers.
+                // Raw cleanup details stay in cause, outside command-redacted messages.
+                failure.cause = cleanup;
+                failure.message += '; process cleanup also failed';
+            }
             if (failure === undefined)
                 resolve(result());
             else
@@ -166,12 +221,13 @@ export const runProcess = (command, options = {}) => {
             if (settled || terminating)
                 return;
             terminating = true;
-            void killTree(child).finally(() => finish(new ProcessFailure({
+            const complete = (errors = []) => finish(new ProcessFailure({
                 kind,
                 message: failureMessage(kind, timeoutMs, limit),
                 result: result(),
                 ...limit === undefined ? {} : { limit }
-            })));
+            }), errors);
+            void killTree(child).then(() => complete(), error => complete([error]));
         };
         const abort = () => terminate('aborted');
         const collect = (stream, chunk) => {
@@ -190,42 +246,74 @@ export const runProcess = (command, options = {}) => {
             if (bytes.length > remaining)
                 terminate(stream === 'stdout' ? 'stdout-limit' : 'stderr-limit', limit);
         };
-        child.stdout?.on('data', chunk => collect('stdout', chunk));
-        child.stderr?.on('data', chunk => collect('stderr', chunk));
-        child.on('error', (error) => {
-            if (terminating)
-                return;
-            spawnErrorCode = error.code;
-            finish(new ProcessFailure({
-                kind: 'spawn',
-                message: failureMessage('spawn', timeoutMs),
-                result: result(),
-                ...spawnErrorCode === undefined ? {} : { errorCode: spawnErrorCode }
-            }));
-        });
-        child.on('exit', (observedCode, observedSignal) => {
-            code = observedCode;
-            exitSignal = observedSignal;
-        });
-        child.on('close', (observedCode, observedSignal) => {
-            code = observedCode;
-            exitSignal = observedSignal;
-            if (!terminating)
-                finish();
-        });
-        child.stdin?.on('error', () => { });
-        if (options.input !== undefined)
-            child.stdin?.end(options.input);
-        else
-            child.stdin?.end();
-        if (timeoutMs > 0)
-            timer = setTimeout(() => terminate('timeout'), timeoutMs);
-        options.signal?.addEventListener('abort', abort, { once: true });
-        // Close the check/listener race if cancellation landed during spawn setup.
-        if (options.signal?.aborted === true)
-            abort();
+        try {
+            child.stdout?.on('data', chunk => collect('stdout', chunk));
+            child.stderr?.on('data', chunk => collect('stderr', chunk));
+            child.on('error', (error) => {
+                if (terminating)
+                    return;
+                spawnErrorCode = error.code;
+                finish(new ProcessFailure({
+                    kind: 'spawn',
+                    message: failureMessage('spawn', timeoutMs),
+                    result: result(),
+                    ...spawnErrorCode === undefined ? {} : { errorCode: spawnErrorCode }
+                }));
+            });
+            child.on('exit', (observedCode, observedSignal) => {
+                code = observedCode;
+                exitSignal = observedSignal;
+            });
+            child.on('close', (observedCode, observedSignal) => {
+                code = observedCode;
+                exitSignal = observedSignal;
+                if (!terminating)
+                    finish();
+            });
+            child.stdin?.on('error', () => { });
+            if (input !== undefined)
+                child.stdin?.end(input);
+            else
+                child.stdin?.end();
+            if (timeoutMs > 0)
+                timer = setTimeout(() => terminate('timeout'), timeoutMs);
+            signal?.addEventListener('abort', abort, { once: true });
+            // Close the check/listener race if cancellation landed during spawn setup.
+            if (signal?.aborted === true)
+                abort();
+        }
+        catch {
+            // Startup owns the child as soon as spawn returns, including partial
+            // listener registration and stdin setup. Keep startup diagnostics redacted.
+            terminate('spawn');
+        }
     });
 };
+/** Capture Node's enumerable environment entries without JSON object hooks. */
+const workerEnvironment = (env) => {
+    if (env == null)
+        return undefined;
+    let keys = [];
+    for (const key in env)
+        keys.push(key);
+    if (process.platform === 'win32') {
+        const seen = new Set();
+        keys = keys.sort().filter(key => {
+            const upper = key.toUpperCase();
+            if (seen.has(upper))
+                return false;
+            seen.add(upper);
+            return true;
+        });
+    }
+    const captured = Object.create(null);
+    for (const key of keys) {
+        const value = env[key];
+        if (value !== undefined)
+            captured[key] = `${value}`;
+    }
+    return captured;
+};
 /**
  * Synchronous bridge for compatibility-sensitive APIs. A short-lived Node
  * worker owns the asynchronous tree cleanup, then returns one bounded result.
@@ -233,14 +321,26 @@ export const runProcess = (command, options = {}) => {
 export const runProcessSync = (command, options = {}) => {
     const stdoutLimit = positiveLimit(options.maxStdoutBytes, defaultMaxStdoutBytes, 'maxStdoutBytes');
     const stderrLimit = positiveLimit(options.maxStderrBytes, defaultMaxStderrBytes, 'maxStderrBytes');
-    const timeoutMs = positiveLimit(options.timeoutMs, 0, 'timeoutMs');
+    const timeoutMs = timeoutLimit(options.timeoutMs);
+    const strictStdoutUtf8 = stdoutUtf8Mode(options.strictStdoutUtf8);
+    const input = processInput(options.input);
+    let request;
+    try {
+        const cwd = options.cwd;
+        const env = workerEnvironment(options.env);
+        const capturedCommand = { executable: command.executable, args: [...command.args] };
+        request = JSON.stringify({ command: capturedCommand, options: { timeoutMs, input, cwd, env, maxStdoutBytes: stdoutLimit, maxStderrBytes: stderrLimit, strictStdoutUtf8 } });
+    }
+    catch {
+        throw new ProcessFailure({ kind: 'spawn', message: failureMessage('spawn', timeoutMs), result: emptyResult() });
+    }
     const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';
     const worker = fileURLToPath(new URL(`./process-worker.${extension}`, import.meta.url));
     const result = spawnSync(process.execPath, ['--disable-warning=ExperimentalWarning', worker], {
         shell: false,
         windowsHide: true,
         encoding: 'utf8',
-        input: JSON.stringify({ command, options: { ...options, maxStdoutBytes: stdoutLimit, maxStderrBytes: stderrLimit } }),
+        input: request,
         // JSON can expand a captured control byte to a six-byte `\\u00xx` escape.
         maxBuffer: Math.max(1024 * 1024, (stdoutLimit + stderrLimit) * 7 + 1024 * 1024),
         timeout: timeoutMs > 0 ? timeoutMs + 5_000 : undefined