@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/adapters/process/executable.js

@@ -0,0 +1,54 @@
+// Resolve commands before spawning so probes and execution share PATH policy.
+// Windows environment keys are case-insensitive, including invocation overrides.
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+export function mergeEnvironment(base, overrides = {}, platform = process.platform) {
+    if (platform !== 'win32')
+        return { ...base, ...overrides };
+    const result = {};
+    for (const [key, value] of [...Object.entries(base), ...Object.entries(overrides)]) {
+        const previous = Object.keys(result).find((name) => name.toLowerCase() === key.toLowerCase());
+        if (previous)
+            delete result[previous];
+        result[key] = value;
+    }
+    return result;
+}
+export function executableCandidates(binary, options = {}, platform = process.platform) {
+    const windows = platform === 'win32';
+    const paths = windows ? path.win32 : path.posix;
+    const env = options.env ?? process.env;
+    const lookup = (key) => {
+        const name = Object.keys(env).find((name) => windows ? name.toLowerCase() === key.toLowerCase() : name === key);
+        return name === undefined ? undefined : env[name];
+    };
+    const cwd = options.cwd ?? process.cwd();
+    const explicit = paths.isAbsolute(binary) || binary.includes('/') || (windows && binary.includes('\\'));
+    const dirs = explicit ? [''] : (lookup('PATH') ?? '').split(windows ? ';' : ':').filter(Boolean);
+    const extensions = windows
+        ? (lookup('PATHEXT') ?? '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)
+        : [];
+    const suffixes = windowsSuffixes(windows, binary, extensions);
+    return dirs.flatMap((dir) => suffixes.map((suffix) => paths.resolve(cwd, dir.replace(/^"(.*)"$/, '$1'), binary + suffix)));
+}
+function windowsSuffixes(windows, binary, extensions) {
+    if (!windows)
+        return [''];
+    if (extensions.some((extension) => extension.toLowerCase() === path.win32.extname(binary).toLowerCase()))
+        return [''];
+    return path.win32.extname(binary) ? ['', ...extensions] : [...extensions, ''];
+}
+export async function findExecutable(binary, options = {}) {
+    for (const candidate of executableCandidates(binary, options)) {
+        try {
+            await fs.access(candidate, process.platform === 'win32' ? fs.constants.F_OK : fs.constants.X_OK);
+            if ((await fs.stat(candidate)).isFile())
+                return candidate;
+        }
+        catch {
+            // A missing or inaccessible PATH entry does not hide later candidates.
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=executable.js.map

package/dist/adapters/process/executable.js.map

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

package/dist/adapters/process/hook-tasks.js

@@ -0,0 +1,32 @@
+// A detached supervisor owns the background worker. It inherits no host IO
+// handles, and its entry point is supplied by composition rather than a manifest.
+import { spawn } from 'node:child_process';
+import { hookRequestArgs } from '../../domain/harness/request.js';
+import { unsupervised } from './supervision.js';
+export class NodeHookTasks {
+    executable;
+    constructor(executable) {
+        this.executable = executable;
+    }
+    start(request) {
+        return new Promise((resolve) => {
+            const [binary, ...args] = this.executable;
+            if (!binary) {
+                resolve();
+                return;
+            }
+            const child = spawn(binary, [...args, '__hook-background', ...hookRequestArgs(request)], {
+                detached: true,
+                windowsHide: true,
+                stdio: 'ignore',
+                env: { ...process.env, ...unsupervised() },
+            });
+            child.once('error', () => resolve());
+            child.once('spawn', () => {
+                child.unref();
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=hook-tasks.js.map

package/dist/adapters/process/hook-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-tasks.js","sourceRoot":"","sources":["../../../src/adapters/process/hook-tasks.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,kFAAkF;AAElF,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAoB,MAAM,iCAAiC,CAAC;AAGpF,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,UAA6B;QAA7B,eAAU,GAAV,UAAU,CAAmB;IAAG,CAAC;IAC9D,KAAK,CAAC,OAAoB;QACxB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,mBAAmB,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE;gBACvF,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,IAAI;gBACjB,KAAK,EAAE,QAAQ;gBACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,EAAE,EAAE;aAC3C,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapters/process/launch.js

@@ -0,0 +1,55 @@
+// Start an executable that findExecutable resolved. A batch file runs under cmd.exe,
+// which reads the command line first. The batch then reads each argument itself
+// (`%~1`, as mvn.cmd does) or hands them all on (`%*`, as the shims npm, Scoop and
+// Chocolatey install do), and cmd reads that line again. Caret escaping throughout,
+// as cross-spawn applies it, suits only one of those readers, so fx starts every batch
+// file itself and leaves everything else to cross-spawn.
+import { spawn as spawnNode } from 'node:child_process';
+import path from 'node:path';
+import spawn from 'cross-spawn';
+const BATCH = /\.(?:bat|cmd)$/i;
+// What cmd acts on outside quotes.
+const SPECIAL = /[&|<>^()!]/;
+export function launch(executable, args, options) {
+    if (process.platform !== 'win32' || !BATCH.test(executable))
+        return spawn(executable, [...args], options);
+    // /v:off keeps !name! literal whatever delayed expansion the registry turns on.
+    return spawnNode(process.env['comspec'] ?? 'cmd.exe', ['/d', '/v:off', '/s', '/c', `"${batchLine([path.normalize(executable), ...args])}"`], { ...options, windowsVerbatimArguments: true });
+}
+// Every argument is quoted for the program at the end of the chain, and cmd leaves
+// whatever sits inside quotes alone, so an argument without a quote of its own reaches
+// `%~1` unchanged. A quote inside an argument turns cmd's quoting off until the next
+// one; there, cmd's special characters are escaped for both of its reads. Each percent
+// sign is followed by an empty expansion, so no %name% survives to expand.
+function batchLine(vector) {
+    let line = '';
+    let quoted = false;
+    for (const char of vector.map(programArgument).join(' ')) {
+        if (char === '"')
+            quoted = !quoted;
+        if (char === '%')
+            line += '%%cd:~,%';
+        else if (!quoted && SPECIAL.test(char))
+            line += '^^^' + char;
+        else
+            line += char;
+    }
+    return line;
+}
+// The program's own reading of its command line: backslashes are literal except in
+// a run before a quote, so such a run is doubled, before an inner quote and before
+// the closing one.
+function programArgument(arg) {
+    let text = '"';
+    let slashes = 0;
+    for (const char of arg) {
+        if (char === '\\') {
+            slashes += 1;
+            continue;
+        }
+        text += '\\'.repeat(char === '"' ? slashes * 2 + 1 : slashes) + char;
+        slashes = 0;
+    }
+    return text + '\\'.repeat(slashes * 2) + '"';
+}
+//# sourceMappingURL=launch.js.map

package/dist/adapters/process/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../src/adapters/process/launch.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,gFAAgF;AAChF,mFAAmF;AACnF,oFAAoF;AACpF,uFAAuF;AACvF,yDAAyD;AAEzD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAwC,MAAM,oBAAoB,CAAC;AAC9F,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,KAAK,MAAM,aAAa,CAAC;AAEhC,MAAM,KAAK,GAAG,iBAAiB,CAAC;AAChC,mCAAmC;AACnC,MAAM,OAAO,GAAG,YAAY,CAAC;AAE7B,MAAM,UAAU,MAAM,CACpB,UAAkB,EAClB,IAAuB,EACvB,OAAqB;IAErB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;QACzD,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/C,gFAAgF;IAChF,OAAO,SAAS,CACd,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,SAAS,EACnC,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,EACrF,EAAE,GAAG,OAAO,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAC/C,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,uFAAuF;AACvF,qFAAqF;AACrF,uFAAuF;AACvF,2EAA2E;AAC3E,SAAS,SAAS,CAAC,MAAyB;IAC1C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,GAAG,CAAC,MAAM,CAAC;QACnC,IAAI,IAAI,KAAK,GAAG;YAAE,IAAI,IAAI,UAAU,CAAC;aAChC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC;;YACxD,IAAI,IAAI,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,mFAAmF;AACnF,mBAAmB;AACnB,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,IAAI,GAAG,GAAG,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QACrE,OAAO,GAAG,CAAC,CAAC;IACd,CAAC;IACD,OAAO,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AAC/C,CAAC"}

package/dist/adapters/process/lifecycle-runner.js

@@ -0,0 +1,110 @@
+// The supervisor never loads worker application code. Its timer stays live
+// when the worker blocks synchronously; termination of the supervisor also
+// reaps the worker group before returning an empty lifecycle result.
+import { spawn } from 'node:child_process';
+import { mergeEnvironment } from './executable.js';
+import { supervisedBy } from './supervision.js';
+import { terminateChild } from './terminate.js';
+export class NodeLifecycleRunner {
+    failed;
+    constructor(failed) {
+        this.failed = failed;
+    }
+    run(input) {
+        return new Promise((resolve) => {
+            let child;
+            let text = '';
+            let done = false;
+            const finish = (value, reason) => {
+                if (done)
+                    return;
+                done = true;
+                if (reason !== undefined)
+                    this.failed?.(reason);
+                releaseSignals();
+                clearTimeout(timer);
+                if (child)
+                    dispose(child);
+                resolve(value);
+            };
+            const releaseSignals = listenForTermination(() => finish(''));
+            const timer = setTimeout(() => finish('', 'HOOK_TIMEOUT'), input.timeoutMs);
+            try {
+                child = startWorker(input);
+            }
+            catch {
+                finish('', 'HOOK_START_FAILED');
+                return;
+            }
+            if (!child) {
+                finish('');
+                return;
+            }
+            observeWorker({
+                child,
+                input,
+                finish,
+                isDone: () => done,
+                receive: (chunk) => {
+                    text += chunk;
+                    if (Buffer.byteLength(text) > 8192)
+                        finish('', 'HOOK_OUTPUT_LIMIT');
+                },
+                complete: (code) => finish(code === 0 ? text : '', code === 0 ? undefined : 'HOOK_WORKER_FAILED'),
+            });
+        });
+    }
+}
+function startWorker(input) {
+    const [binary, ...args] = input.vector;
+    if (!binary)
+        return undefined;
+    return spawn(binary, args, {
+        stdio: ['pipe', 'pipe', 'ignore', 'ipc'],
+        detached: process.platform !== 'win32',
+        windowsHide: true,
+        env: mergeEnvironment(process.env, { ...input.env, ...supervisedBy(input.role) }),
+    });
+}
+function observeWorker(scope) {
+    const { child, input, finish } = scope;
+    child.stdout.setEncoding('utf8');
+    child.stdout.on('data', scope.receive);
+    child.on('message', (message) => {
+        if (typeof message === 'object' &&
+            message !== null &&
+            'kind' in message &&
+            (message.kind === 'abort' || message.kind === 'failure'))
+            finish('', message.kind === 'failure' ? 'HOOK_WORKER_FAILED' : 'HOOK_ABORTED');
+    });
+    child.on('error', () => finish('', 'HOOK_START_FAILED'));
+    child.on('close', scope.complete);
+    child.stdin.on('error', () => { });
+    void input.input.then((text) => {
+        if (scope.isDone())
+            return;
+        if (Buffer.byteLength(text) > 65536) {
+            finish('');
+            return;
+        }
+        child.stdin.end(text);
+    }, () => finish(''));
+}
+function listenForTermination(abort) {
+    const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+    for (const signal of signals)
+        process.once(signal, abort);
+    return () => {
+        for (const signal of signals)
+            process.off(signal, abort);
+    };
+}
+function dispose(child) {
+    terminateChild(child, true);
+    child.stdin?.destroy();
+    child.stdout?.destroy();
+    if (child.connected)
+        child.disconnect();
+    child.unref();
+}
+//# sourceMappingURL=lifecycle-runner.js.map

package/dist/adapters/process/lifecycle-runner.js.map

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

package/dist/adapters/process/node-process.js

@@ -0,0 +1,193 @@
+// Execute process vectors through the Process port. Missing executables return
+// exit 127; bounded piped calls reject on timeout or cancellation and reap children.
+import { DevkitError } from '../../domain/errors.js';
+import { findExecutable, mergeEnvironment } from './executable.js';
+import { launch } from './launch.js';
+import { supervisedRole } from './supervision.js';
+import { terminateChild } from './terminate.js';
+const ABORTED = 'PROCESS_ABORTED';
+const GIVEN_UP = 'was given up on';
+const CLOSE_GRACE_MS = 500;
+const SIGNALS = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+const running = new Set();
+const handlers = new Map();
+function adopt(entry) {
+    if (handlers.size === 0)
+        arm();
+    running.add(entry);
+    return () => {
+        running.delete(entry);
+        if (running.size === 0)
+            disarm();
+    };
+}
+function arm() {
+    for (const signal of SIGNALS) {
+        const handler = () => {
+            const interrupted = [...running];
+            running.clear();
+            for (const entry of interrupted) {
+                try {
+                    entry.interrupt();
+                }
+                catch {
+                    continue;
+                }
+            }
+            const owned = process.listeners(signal).some((l) => l !== handler);
+            disarm();
+            if (!owned)
+                process.kill(process.pid, signal);
+        };
+        handlers.set(signal, handler);
+        process.prependListener(signal, handler);
+    }
+}
+function disarm() {
+    for (const [signal, handler] of handlers)
+        process.off(signal, handler);
+    handlers.clear();
+}
+function isBounded(options) {
+    return options.timeoutMs !== undefined || options.signal !== undefined;
+}
+// A bounded piped child leads a process group and session of its own, so giving up on it
+// reaches whatever it started, and it has no terminal to write to. The lifecycle
+// supervisor owns the group when this is one of its workers, and Windows has no such
+// separation.
+export function leavesSession(options) {
+    return isBounded(options) && process.platform !== 'win32' && supervisedRole() === undefined;
+}
+export class NodeProcess {
+    async run(vector, options = {}) {
+        const [binary, ...args] = vector;
+        if (binary === undefined)
+            return Promise.resolve({ code: 2, stdout: '', stderr: 'empty command' });
+        if (options.signal?.aborted)
+            throw hung(vector, ABORTED, GIVEN_UP);
+        const env = mergeEnvironment(process.env, options.env);
+        const resolved = await findExecutable(binary, { cwd: options.cwd, env });
+        if (!resolved)
+            return notStarted(binary);
+        const runOptions = { ...options, env };
+        return options.interactive === true
+            ? this.runInteractive(resolved, args, runOptions)
+            : this.runPiped(resolved, args, runOptions);
+    }
+    runPiped(binary, args, options) {
+        const vector = [binary, ...args];
+        return new Promise((resolve, reject) => {
+            const bounded = isBounded(options);
+            const ownGroup = leavesSession(options);
+            const child = launch(binary, args, {
+                cwd: options.cwd,
+                env: options.env,
+                windowsHide: true,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                detached: ownGroup,
+            });
+            const release = bounded
+                ? adopt({ interrupt: () => giveUp(ABORTED, 'was given up on when fx was interrupted') })
+                : () => undefined;
+            const out = [];
+            const err = [];
+            let settled = false;
+            let failure;
+            let closing;
+            const finish = (answer) => {
+                if (settled)
+                    return;
+                settled = true;
+                release();
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                if (closing !== undefined)
+                    clearTimeout(closing);
+                options.signal?.removeEventListener('abort', onAbort);
+                answer();
+            };
+            // A surviving helper may retain the pipes after its parent is killed.
+            const giveUp = (code, message) => {
+                if (settled || failure !== undefined)
+                    return;
+                failure = hung(vector, code, message);
+                killTree(child, ownGroup);
+                closing = setTimeout(() => {
+                    child.stdout.destroy();
+                    child.stderr.destroy();
+                    finish(() => reject(failure));
+                }, CLOSE_GRACE_MS);
+            };
+            const timer = timeoutOf(options.timeoutMs, giveUp);
+            const onAbort = () => giveUp(ABORTED, GIVEN_UP);
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+            child.stdout.on('data', (chunk) => out.push(chunk));
+            child.stderr.on('data', (chunk) => err.push(chunk));
+            child.on('error', (error) => {
+                if (error.code === 'ENOENT')
+                    finish(() => resolve(notStarted(binary)));
+                else
+                    finish(() => reject(error));
+            });
+            child.on('close', (code) => {
+                if (failure !== undefined)
+                    finish(() => reject(failure));
+                else
+                    finish(() => resolve(resultOf(code, out, err)));
+            });
+            if (options.signal?.aborted === true)
+                onAbort();
+            child.stdin.on('error', () => undefined);
+            child.stdin.end(options.input);
+        });
+    }
+    runInteractive(binary, args, options) {
+        return new Promise((resolve, reject) => {
+            const child = launch(binary, args, {
+                cwd: options.cwd,
+                env: options.env,
+                stdio: 'inherit',
+            });
+            child.on('error', (error) => {
+                if (error.code === 'ENOENT')
+                    resolve(notStarted(binary));
+                else
+                    reject(error);
+            });
+            child.on('close', (code) => resolve({ code: code ?? -1, stdout: '', stderr: '' }));
+        });
+    }
+    which(binary, options = {}) {
+        return findExecutable(binary, { ...options, env: mergeEnvironment(process.env, options.env) });
+    }
+}
+function notStarted(binary) {
+    return { code: 127, stdout: '', stderr: `command not found: ${binary}\n`, notStarted: true };
+}
+function hung(vector, code, message) {
+    return new DevkitError('internal', code, `${vector[0] ?? ''} ${message}`, {
+        hint: 'The tool hung or is waiting for input it cannot get.',
+        nextSteps: [`Run \`${vector.join(' ')}\` by hand to see what it is waiting for.`],
+    });
+}
+// Only a run a host waits on has nothing left to do once a companion command
+// is given up on. A background run keeps its later phases, and whatever the
+// killed child left in the worker's own group is reaped with that group.
+function killTree(child, ownGroup) {
+    if (supervisedRole() === 'foreground' && process.connected)
+        process.send?.({ kind: 'abort' });
+    terminateChild(child, ownGroup);
+}
+function timeoutOf(ms, giveUp) {
+    if (ms === undefined)
+        return undefined;
+    return setTimeout(() => giveUp('PROCESS_TIMEOUT', `did not finish within ${ms}ms`), ms);
+}
+function resultOf(code, out, err) {
+    return {
+        code: code ?? -1,
+        stdout: Buffer.concat(out).toString('utf8'),
+        stderr: Buffer.concat(err).toString('utf8'),
+    };
+}
+//# sourceMappingURL=node-process.js.map

package/dist/adapters/process/node-process.js.map

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

package/dist/adapters/process/powershell.js

@@ -0,0 +1,63 @@
+// Encoded PowerShell scripts have a fixed program body; values are quoted as
+// literals, never interpolated into executable expressions by a caller's shell.
+import { powershellQuote } from '../../domain/shell.js';
+export function powershellVector(script) {
+    return [
+        'powershell.exe',
+        '-NoLogo',
+        '-NoProfile',
+        '-NonInteractive',
+        '-EncodedCommand',
+        Buffer.from(script, 'utf16le').toString('base64'),
+    ];
+}
+export function windowsHookCommand(vector, owner) {
+    const [binary = '', ...args] = vector;
+    const commandLine = args.map(nativeQuote).join(' ');
+    // A progress record (PowerShell's first-use module preparation, say) would reach
+    // stderr serialized as CLIXML.
+    const script = `# fx-owner:${owner}
+$ProgressPreference = 'SilentlyContinue'
+$ErrorActionPreference = 'Stop'
+try {
+  # On a UTF-8 console, Windows PowerShell starts a child's redirected input with a
+  # byte order mark; the same code page without the mark changes nothing else.
+  try {
+    if ([Console]::InputEncoding.CodePage -eq 65001) {
+      [Console]::InputEncoding = New-Object System.Text.UTF8Encoding $false
+    }
+  } catch {}
+  $s = New-Object System.Diagnostics.ProcessStartInfo
+  $s.FileName = ${powershellQuote(binary)}
+  $s.Arguments = ${powershellQuote(commandLine)}
+  $s.UseShellExecute = $false
+  $s.CreateNoWindow = $true
+  $s.RedirectStandardInput = $true
+  $s.RedirectStandardOutput = $true
+  $s.RedirectStandardError = $true
+  $p = [System.Diagnostics.Process]::Start($s)
+  $o = $p.StandardOutput.BaseStream.CopyToAsync([Console]::OpenStandardOutput())
+  $e = $p.StandardError.BaseStream.CopyToAsync([System.IO.Stream]::Null)
+  [Console]::OpenStandardInput().CopyTo($p.StandardInput.BaseStream)
+  $p.StandardInput.Close()
+  $p.WaitForExit()
+  # A finished copy yields a value that PowerShell would print to the agent.
+  $null = $o.GetAwaiter().GetResult()
+  $null = $e.GetAwaiter().GetResult()
+} catch {}
+exit 0`;
+    return powershellVector(script).join(' ');
+}
+export function ownsWindowsHook(command, owner) {
+    const prefix = powershellVector('').slice(0, -1).join(' ') + ' ';
+    if (!command.startsWith(prefix))
+        return false;
+    const encoded = command.slice(prefix.length);
+    if (!/^[A-Za-z0-9+/]+={0,2}$/.test(encoded))
+        return false;
+    return Buffer.from(encoded, 'base64').toString('utf16le').startsWith(`# fx-owner:${owner}\n`);
+}
+function nativeQuote(value) {
+    return '"' + value.replace(/(\\*)"/g, '$1$1\\"').replace(/(\\+)$/, '$1$1') + '"';
+}
+//# sourceMappingURL=powershell.js.map

package/dist/adapters/process/powershell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powershell.js","sourceRoot":"","sources":["../../../src/adapters/process/powershell.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO;QACL,gBAAgB;QAChB,SAAS;QACT,YAAY;QACZ,iBAAiB;QACjB,iBAAiB;QACjB,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAyB,EAAE,KAAa;IACzE,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC;IACtC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,iFAAiF;IACjF,+BAA+B;IAC/B,MAAM,MAAM,GAAG,cAAc,KAAK;;;;;;;;;;;;kBAYlB,eAAe,CAAC,MAAM,CAAC;mBACtB,eAAe,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;OAgBxC,CAAC;IACN,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,KAAa;IAC5D,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACjE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC;AACnF,CAAC"}

package/dist/adapters/process/stdio-bridge.js

@@ -0,0 +1,31 @@
+// Host-owned MCP processes need byte streams, not the CLI's buffered results
+// or notices. The projected vector has already passed workspace trust. The
+// bridge reports the status it observed; landing it on the process is the
+// entry point's job.
+import { findExecutable, mergeEnvironment } from './executable.js';
+import { launch } from './launch.js';
+import { terminateChild } from './terminate.js';
+// A shell reports a command it could not find as 127, and MCP hosts read that
+// status the same way.
+const COMMAND_NOT_FOUND = 127;
+export async function runStdioBridge(vector) {
+    const [binary, ...args] = vector;
+    if (!binary)
+        return { exitCode: 2 };
+    const env = mergeEnvironment(process.env);
+    const executable = await findExecutable(binary, { env });
+    if (!executable)
+        return { exitCode: COMMAND_NOT_FOUND };
+    const child = launch(executable, args, { env, stdio: 'inherit', windowsHide: true });
+    const stop = () => terminateChild(child);
+    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP'])
+        process.once(signal, stop);
+    const exitCode = await new Promise((resolve) => {
+        child.once('error', () => resolve(1));
+        child.once('close', (code) => resolve(code ?? 1));
+    });
+    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP'])
+        process.off(signal, stop);
+    return { exitCode };
+}
+//# sourceMappingURL=stdio-bridge.js.map

package/dist/adapters/process/stdio-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-bridge.js","sourceRoot":"","sources":["../../../src/adapters/process/stdio-bridge.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,qBAAqB;AAErB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,8EAA8E;AAC9E,uBAAuB;AACvB,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAyB;IAC5D,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1F,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzF,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/dist/adapters/process/supervision.js

@@ -0,0 +1,19 @@
+// A supervised worker is timed and reaped by its supervisor, so it never owns
+// the process group of a companion command. Its role names who is waiting on
+// the run.
+const VARIABLE = 'FX_LIFECYCLE_WORKER';
+export function supervisedRole() {
+    if (process.send === undefined)
+        return undefined;
+    const value = process.env[VARIABLE];
+    return value === 'foreground' || value === 'background' ? value : undefined;
+}
+export function supervisedBy(role) {
+    return { [VARIABLE]: role };
+}
+// The background supervisor is started by a foreground worker and supervises
+// rather than serves; it must not inherit that worker's role.
+export function unsupervised() {
+    return { [VARIABLE]: '' };
+}
+//# sourceMappingURL=supervision.js.map

package/dist/adapters/process/supervision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervision.js","sourceRoot":"","sources":["../../../src/adapters/process/supervision.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,WAAW;AAIX,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAEvC,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,6EAA6E;AAC7E,8DAA8D;AAC9D,MAAM,UAAU,YAAY;IAC1B,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;AAC5B,CAAC"}