@procedures/shell 0.0.0-stage → 0.1.0

package/dist/command/stream.js

@@ -0,0 +1,158 @@
+/**
+ * streamCommand: run a program and give each output line while it runs.
+ *
+ * The queue between the program and the reader has a limit (deep dive WRP-9). When the queue
+ * is full, the helper stops reading the pipes of the program. The pipes fill, and the program
+ * waits in its next write. When the reader takes items again, the helper reads again. Before,
+ * the queue had no limit: a program with a large output filled the memory of the host.
+ */
+import { StringDecoder } from "node:string_decoder";
+import { killTree } from "./tree-kill.js";
+import { startChild } from "./spawn.js";
+const DEFAULT_HIGH_WATER_MARK = 1000;
+const DEFAULT_MAX_LINE_LENGTH = 1024 * 1024;
+/**
+ * This function runs `command` and yields each line of stdout and stderr, then one exit item.
+ * When the reader stops early, or the signal aborts, the process tree is killed. A program that
+ * cannot start makes the generator throw.
+ */
+export async function* streamCommand(command, options = {}) {
+    const started = Date.now();
+    const highWaterMark = Math.max(1, options.highWaterMark ?? DEFAULT_HIGH_WATER_MARK);
+    const lowWaterMark = Math.floor(highWaterMark / 2);
+    const maxLineLength = Math.max(1, options.maxLineLength ?? DEFAULT_MAX_LINE_LENGTH);
+    const encoding = options.encoding ?? "utf8";
+    const items = [];
+    let ended = false;
+    let failure;
+    let wake;
+    const notify = () => {
+        const resume = wake;
+        wake = undefined;
+        resume?.();
+    };
+    if (options.signal?.aborted) {
+        yield { type: "exit", exitCode: 1, duration: 0, aborted: true };
+        return;
+    }
+    const child = startChild(command, options, options.input !== undefined ? "pipe" : "ignore");
+    let paused = false;
+    let timedOut = false;
+    let aborted = false;
+    const pause = () => {
+        if (paused)
+            return;
+        paused = true;
+        child.stdout.pause();
+        child.stderr.pause();
+    };
+    const resume = () => {
+        if (!paused)
+            return;
+        paused = false;
+        child.stdout.resume();
+        child.stderr.resume();
+    };
+    const push = (item) => {
+        items.push(item);
+        if (items.length >= highWaterMark)
+            pause();
+        notify();
+    };
+    // A decoder for each stream keeps a character whose bytes arrive in two chunks (deep dive WRP-2)
+    const partial = { stdout: "", stderr: "" };
+    const decoders = { stdout: new StringDecoder(encoding), stderr: new StringDecoder(encoding) };
+    const emit = (type, text) => {
+        if (text.length <= maxLineLength) {
+            push({ type, line: text });
+            return;
+        }
+        for (let at = 0; at < text.length; at += maxLineLength) {
+            push({ type, line: text.slice(at, at + maxLineLength) });
+        }
+    };
+    const onData = (type) => (data) => {
+        const lines = (partial[type] + decoders[type].write(data)).split(/\r?\n/);
+        let rest = lines.pop() ?? "";
+        for (const line of lines)
+            emit(type, line);
+        // A line without its end yet: give the full parts now, keep the remainder
+        if (rest.length >= maxLineLength) {
+            const whole = rest.length - (rest.length % maxLineLength);
+            emit(type, rest.slice(0, whole));
+            rest = rest.slice(whole);
+        }
+        partial[type] = rest;
+    };
+    child.stdout.on("data", onData("stdout"));
+    child.stderr.on("data", onData("stderr"));
+    if (options.input !== undefined) {
+        child.stdin.on("error", () => { });
+        child.stdin.end(options.input);
+    }
+    const timer = options.timeout !== undefined
+        ? setTimeout(() => {
+            timedOut = true;
+            killTree(child);
+        }, options.timeout)
+        : undefined;
+    const onAbort = () => {
+        aborted = true;
+        killTree(child);
+    };
+    options.signal?.addEventListener("abort", onAbort, { once: true });
+    child.on("error", (error) => {
+        if (child.pid === undefined) {
+            failure = { error };
+            notify();
+        }
+    });
+    child.on("close", (code, signal) => {
+        for (const type of ["stdout", "stderr"]) {
+            const rest = partial[type] + decoders[type].end();
+            if (rest)
+                emit(type, rest);
+        }
+        const exit = { type: "exit", exitCode: code ?? 1, duration: Date.now() - started };
+        const endSignal = signal ?? (timedOut || aborted ? "SIGTERM" : undefined);
+        if (endSignal)
+            exit.signal = endSignal;
+        if (timedOut)
+            exit.timedOut = true;
+        if (aborted)
+            exit.aborted = true;
+        items.push(exit);
+        ended = true;
+        notify();
+    });
+    try {
+        for (;;) {
+            if (items.length > 0) {
+                const item = items.shift();
+                if (items.length <= lowWaterMark)
+                    resume();
+                yield item;
+                continue;
+            }
+            if (failure)
+                throw failure.error;
+            if (ended)
+                return;
+            await new Promise((resolve) => {
+                wake = resolve;
+            });
+        }
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+        options.signal?.removeEventListener("abort", onAbort);
+        // The reader stopped early: end the program and its descendants. The pipes read again, so
+        // they can close.
+        if (!ended) {
+            resume();
+            killTree(child);
+        }
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/command/stream.js.map

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

package/dist/command/tree-kill.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Kill a child process and all the processes that it started (deep dive WRP-10).
+ *
+ * `child.kill()` reaches only the direct child. On Windows it calls `TerminateProcess`, so the
+ * grandchildren keep running (a `pnpm` that starts `node`, a `vite` that starts `esbuild`).
+ * - On Windows, `taskkill /T /F` ends the tree of the process id.
+ * - Elsewhere, the child starts in its own process group (`detached`), and a signal to the
+ *   negative pid reaches every process of the group.
+ *
+ * The module also records each live child. When the host process ends (a normal exit, or
+ * SIGINT, SIGTERM or SIGHUP), it kills each recorded tree, so no child keeps running alone.
+ */
+import { type ChildProcess } from "node:child_process";
+/**
+ * True when a child must start with `detached: true`. On POSIX, `detached` puts the child in a
+ * new process group, which `killTree` needs. On Windows, `detached` opens a new console.
+ */
+export declare const OWN_PROCESS_GROUP: boolean;
+/** This function kills the process tree of `child`. It does nothing when the child has ended. */
+export declare function killTree(child: ChildProcess, signal?: NodeJS.Signals): void;
+/**
+ * This function records a child until it ends. While at least one child is recorded, the hooks
+ * kill the recorded trees when the host ends. With no recorded child, the host has no hooks.
+ */
+export declare function track(child: ChildProcess): void;
+//# sourceMappingURL=tree-kill.d.ts.map

package/dist/command/tree-kill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-kill.d.ts","sourceRoot":"","sources":["../../src/command/tree-kill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI5E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAkB,CAAC;AAMnD,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,IAAI,CAgBtF;AA8DD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAU/C"}

package/dist/command/tree-kill.js

@@ -0,0 +1,122 @@
+/**
+ * Kill a child process and all the processes that it started (deep dive WRP-10).
+ *
+ * `child.kill()` reaches only the direct child. On Windows it calls `TerminateProcess`, so the
+ * grandchildren keep running (a `pnpm` that starts `node`, a `vite` that starts `esbuild`).
+ * - On Windows, `taskkill /T /F` ends the tree of the process id.
+ * - Elsewhere, the child starts in its own process group (`detached`), and a signal to the
+ *   negative pid reaches every process of the group.
+ *
+ * The module also records each live child. When the host process ends (a normal exit, or
+ * SIGINT, SIGTERM or SIGHUP), it kills each recorded tree, so no child keeps running alone.
+ */
+import { execFile, spawnSync } from "node:child_process";
+const WINDOWS = process.platform === "win32";
+/**
+ * True when a child must start with `detached: true`. On POSIX, `detached` puts the child in a
+ * new process group, which `killTree` needs. On Windows, `detached` opens a new console.
+ */
+export const OWN_PROCESS_GROUP = !WINDOWS;
+function running(child) {
+    return child.pid !== undefined && child.exitCode === null && child.signalCode === null;
+}
+/** This function kills the process tree of `child`. It does nothing when the child has ended. */
+export function killTree(child, signal = "SIGTERM") {
+    if (!running(child))
+        return;
+    const pid = child.pid;
+    if (WINDOWS) {
+        execFile("taskkill", ["/T", "/F", "/PID", String(pid)], { windowsHide: true }, (error) => {
+            // taskkill fails when the process ended in the meantime, or when taskkill is missing
+            if (error && running(child))
+                child.kill(signal);
+        });
+        return;
+    }
+    try {
+        process.kill(-pid, signal);
+    }
+    catch {
+        // The child is not a group leader (it did not start detached): kill only the child
+        child.kill(signal);
+    }
+}
+/** The synchronous form, for the exit of the host, when callbacks do not run any more. */
+function killTreeSync(child) {
+    if (!running(child))
+        return;
+    const pid = child.pid;
+    try {
+        if (WINDOWS) {
+            spawnSync("taskkill", ["/T", "/F", "/PID", String(pid)], { windowsHide: true, stdio: "ignore" });
+        }
+        else {
+            process.kill(-pid, "SIGKILL");
+        }
+    }
+    catch {
+        try {
+            child.kill("SIGKILL");
+        }
+        catch {
+            // The process ended
+        }
+    }
+}
+// =============================================================================
+// The live children, and the hooks that kill them when the host ends
+// =============================================================================
+const live = new Set();
+const SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
+let hooked = false;
+function killAll() {
+    for (const child of live)
+        killTreeSync(child);
+    live.clear();
+}
+function onExit() {
+    killAll();
+}
+function onSignal(signal) {
+    killAll();
+    // Without this handler, Node ends the process on the signal. When this handler is the only one,
+    // do the same: remove the hooks and send the signal again.
+    if (process.listenerCount(signal) === 1) {
+        unhook();
+        process.kill(process.pid, signal);
+    }
+}
+function hook() {
+    if (hooked)
+        return;
+    hooked = true;
+    process.on("exit", onExit);
+    for (const signal of SIGNALS)
+        process.on(signal, onSignal);
+}
+function unhook() {
+    if (!hooked)
+        return;
+    hooked = false;
+    process.off("exit", onExit);
+    for (const signal of SIGNALS)
+        process.off(signal, onSignal);
+}
+/**
+ * This function records a child until it ends. While at least one child is recorded, the hooks
+ * kill the recorded trees when the host ends. With no recorded child, the host has no hooks.
+ */
+export function track(child) {
+    if (!running(child))
+        return;
+    live.add(child);
+    hook();
+    const forget = () => {
+        live.delete(child);
+        if (live.size === 0)
+            unhook();
+    };
+    child.once("exit", forget);
+    child.once("error", forget);
+}
+//# sourceMappingURL=tree-kill.js.map

package/dist/command/tree-kill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-kill.js","sourceRoot":"","sources":["../../src/command/tree-kill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAE5E,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAY,CAAC,OAAO,CAAC;AAEnD,SAAS,OAAO,CAAC,KAAmB;IAClC,OAAO,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;AACzF,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,QAAQ,CAAC,KAAmB,EAAE,MAAM,GAAmB,SAAS;IAC9E,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO;IAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAI,CAAC;IACvB,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;YACvF,qFAAqF;YACrF,IAAI,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,mFAAmF;QACnF,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,SAAS,YAAY,CAAC,KAAmB;IACvC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO;IAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAI,CAAC;IACvB,IAAI,CAAC;QACH,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnG,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,qEAAqE;AACrE,gFAAgF;AAEhF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;AACrC,MAAM,OAAO,GAA8B,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC3E,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB,SAAS,OAAO;IACd,KAAK,MAAM,KAAK,IAAI,IAAI;QAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;AACf,CAAC;AAED,SAAS,MAAM;IACb,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,QAAQ,CAAC,MAAsB;IACtC,OAAO,EAAE,CAAC;IACV,gGAAgG;IAChG,2DAA2D;IAC3D,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,SAAS,IAAI;IACX,IAAI,MAAM;QAAE,OAAO;IACnB,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,MAAM;IACb,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,GAAG,KAAK,CAAC;IACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,KAAmB;IACvC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO;IAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,IAAI,EAAE,CAAC;IACP,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,MAAM,EAAE,CAAC;IAChC,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @procedures/shell
+ *
+ * Generic shell command execution procedures.
+ *
+ * Provides procedures for running CLI commands:
+ * - shell.run - Run command with args
+ * - shell.exec - Execute command string via shell
+ * - shell.which - Find command path
+ * - shell.stream - Run command with args and stream each output line
+ *
+ * The command helpers (`runCommand`, `streamCommand`, `processes`) are also available without
+ * the registration of the procedures, from `@procedures/shell/command`.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from "@procedures/client";
+ *
+ * const result = await client.call(["shell", "run"], {
+ *   command: "git",
+ *   args: ["status"],
+ *   cwd: "/path/to/repo"
+ * });
+ * ```
+ */
+export type { ShellRunInput, ShellRunOutput, ShellExecInput, ShellExecOutput, ShellWhichInput, ShellWhichOutput, ShellStreamInput, ShellStreamItem, } from "./types.js";
+export { ShellRunInputSchema, ShellExecInputSchema, ShellWhichInputSchema, ShellStreamInputSchema, } from "./types.js";
+export { shellRun, shellExec, shellWhich, shellStream } from "./procedures/shell/index.js";
+export * from "./command/index.js";
+export { registerShellProcedures } from "./register.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG3F,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * @procedures/shell
+ *
+ * Generic shell command execution procedures.
+ *
+ * Provides procedures for running CLI commands:
+ * - shell.run - Run command with args
+ * - shell.exec - Execute command string via shell
+ * - shell.which - Find command path
+ * - shell.stream - Run command with args and stream each output line
+ *
+ * The command helpers (`runCommand`, `streamCommand`, `processes`) are also available without
+ * the registration of the procedures, from `@procedures/shell/command`.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from "@procedures/client";
+ *
+ * const result = await client.call(["shell", "run"], {
+ *   command: "git",
+ *   args: ["status"],
+ *   cwd: "/path/to/repo"
+ * });
+ * ```
+ */
+export { ShellRunInputSchema, ShellExecInputSchema, ShellWhichInputSchema, ShellStreamInputSchema, } from "./types.js";
+// Procedures
+export { shellRun, shellExec, shellWhich, shellStream } from "./procedures/shell/index.js";
+// Command helpers
+export * from "./command/index.js";
+// Registration
+export { registerShellProcedures } from "./register.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAcH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,aAAa;AACb,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE3F,kBAAkB;AAClB,cAAc,oBAAoB,CAAC;AAEnC,eAAe;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for shell operations
+ */
+import { type ProcedureModule } from "@procedures/client";
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export declare const shellModule: ProcedureModule;
+export default shellModule;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAoFrG;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,eAKtB,CAAC;eAEU,WAAW"}

package/dist/module.js

@@ -0,0 +1,79 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for shell operations
+ */
+import { createProcedure, zodAdapter, defineModule } from "@procedures/client";
+import { shellRun } from "./procedures/shell/run.js";
+import { shellExec } from "./procedures/shell/exec.js";
+import { shellWhich } from "./procedures/shell/which.js";
+import { shellStream } from "./procedures/shell/stream.js";
+import { ShellRunInputSchema, ShellExecInputSchema, ShellWhichInputSchema, ShellStreamInputSchema, ShellRunOutputSchema, ShellExecOutputSchema, ShellWhichOutputSchema, ShellStreamItemSchema, } from "./types.js";
+// Procedure definitions
+const shellRunProcedure = createProcedure()
+    .path(["shell", "run"])
+    .input(zodAdapter(ShellRunInputSchema))
+    .output(zodAdapter(ShellRunOutputSchema))
+    .meta({
+    description: "Run a command with arguments",
+    args: ["command"],
+    shorts: { cwd: "C", timeout: "t" },
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return shellRun(input, ctx);
+})
+    .build();
+const shellExecProcedure = createProcedure()
+    .path(["shell", "exec"])
+    .input(zodAdapter(ShellExecInputSchema))
+    .output(zodAdapter(ShellExecOutputSchema))
+    .meta({
+    description: "Execute command string via shell",
+    args: ["command"],
+    shorts: { cwd: "C", timeout: "t" },
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return shellExec(input, ctx);
+})
+    .build();
+const shellWhichProcedure = createProcedure()
+    .path(["shell", "which"])
+    .input(zodAdapter(ShellWhichInputSchema))
+    .output(zodAdapter(ShellWhichOutputSchema))
+    .meta({
+    description: "Find the path to a command",
+    args: ["command"],
+    shorts: {},
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return shellWhich(input, ctx);
+})
+    .build();
+const shellStreamProcedure = createProcedure()
+    .path(["shell", "stream"])
+    .input(zodAdapter(ShellStreamInputSchema))
+    .output(zodAdapter(ShellStreamItemSchema))
+    .meta({
+    description: "Run a command and stream each output line as it arrives",
+    args: ["command"],
+    shorts: { cwd: "C", timeout: "t" },
+    output: "json",
+    streaming: true,
+})
+    .handler(shellStream)
+    .build();
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export const shellModule = defineModule("@procedures/shell", [
+    shellRunProcedure,
+    shellExecProcedure,
+    shellWhichProcedure,
+    shellStreamProcedure,
+]);
+export default shellModule;
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

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

package/dist/procedures/shell/exec.d.ts

@@ -0,0 +1,21 @@
+/**
+ * shell.exec procedure
+ *
+ * Execute a command string via shell.
+ *
+ * This is the one procedure that runs a shell: the command is a shell command line. It is not an
+ * MCP tool, and a data-driven procedure cannot call it (BUGS-2026-07 H18). The shell runs through
+ * the command helpers, so the timeout and `ctx.signal` kill the shell and every program that it
+ * started (deep dive WRP-10), and the `stdin` input reaches the command.
+ */
+import type { ShellExecInput, ShellExecOutput } from "../../types.js";
+/** The program and the arguments that run `command` in a shell, as Node's `exec` does. */
+export declare function shellCommandLine(command: string, shell: boolean | string): {
+    file: string;
+    args: string[];
+    verbatim: boolean;
+};
+export declare function shellExec(input: ShellExecInput, ctx?: {
+    signal?: AbortSignal | undefined;
+}): Promise<ShellExecOutput>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/procedures/shell/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/procedures/shell/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GAAG,MAAM,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAUrD;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,EACrB,GAAG,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,GACzC,OAAO,CAAC,eAAe,CAAC,CAqB1B"}

package/dist/procedures/shell/exec.js

@@ -0,0 +1,45 @@
+/**
+ * shell.exec procedure
+ *
+ * Execute a command string via shell.
+ *
+ * This is the one procedure that runs a shell: the command is a shell command line. It is not an
+ * MCP tool, and a data-driven procedure cannot call it (BUGS-2026-07 H18). The shell runs through
+ * the command helpers, so the timeout and `ctx.signal` kill the shell and every program that it
+ * started (deep dive WRP-10), and the `stdin` input reaches the command.
+ */
+import { runCommand } from "../../command/run.js";
+/** The program and the arguments that run `command` in a shell, as Node's `exec` does. */
+export function shellCommandLine(command, shell) {
+    if (process.platform === "win32") {
+        const file = typeof shell === "string" ? shell : process.env["ComSpec"] ?? "cmd.exe";
+        if (/(?:^|[\\/])cmd(?:\.exe)?$/i.test(file)) {
+            // cmd.exe reads the rest of its command line as it is, so the arguments get no quotes
+            return { file, args: ["/d", "/s", "/c", `"${command}"`], verbatim: true };
+        }
+        return { file, args: ["-c", command], verbatim: false };
+    }
+    return { file: typeof shell === "string" ? shell : "/bin/sh", args: ["-c", command], verbatim: false };
+}
+export async function shellExec(input, ctx) {
+    const { file, args, verbatim } = shellCommandLine(input.command, input.shell);
+    const result = await runCommand(file, {
+        args,
+        windowsVerbatimArguments: verbatim,
+        cwd: input.cwd,
+        env: input.env,
+        timeout: input.timeout,
+        signal: ctx?.signal,
+        input: input.stdin,
+        maxOutputBytes: input.maxBuffer,
+    });
+    return {
+        exitCode: result.exitCode,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        success: result.success,
+        duration: result.duration,
+        signal: result.signal,
+    };
+}
+//# sourceMappingURL=exec.js.map

package/dist/procedures/shell/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/procedures/shell/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,KAAuB;IAEvB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;QACrF,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,sFAAsF;YACtF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACzG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAqB,EACrB,GAA0C;IAE1C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE;QACpC,IAAI;QACJ,wBAAwB,EAAE,QAAQ;QAClC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,GAAG,EAAE,MAAM;QACnB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,cAAc,EAAE,KAAK,CAAC,SAAS;KAChC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/procedures/shell/index.d.ts

@@ -0,0 +1,5 @@
+export { shellRun } from "./run.js";
+export { shellExec } from "./exec.js";
+export { shellWhich } from "./which.js";
+export { shellStream } from "./stream.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/procedures/shell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/procedures/shell/index.js

@@ -0,0 +1,5 @@
+export { shellRun } from "./run.js";
+export { shellExec } from "./exec.js";
+export { shellWhich } from "./which.js";
+export { shellStream } from "./stream.js";
+//# sourceMappingURL=index.js.map

package/dist/procedures/shell/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/procedures/shell/run.d.ts

@@ -0,0 +1,14 @@
+/**
+ * shell.run procedure
+ *
+ * Run a command with arguments and return output.
+ */
+import type { ShellRunInput, ShellRunOutput } from "../../types.js";
+/**
+ * Run a command with its arguments and no shell. The timeout and `ctx.signal` kill the whole
+ * process tree (deep dive WRP-10).
+ */
+export declare function shellRun(input: ShellRunInput, ctx?: {
+    signal?: AbortSignal | undefined;
+}): Promise<ShellRunOutput>;
+//# sourceMappingURL=run.d.ts.map

package/dist/procedures/shell/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/procedures/shell/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQpE;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,aAAa,EACpB,GAAG,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,GACzC,OAAO,CAAC,cAAc,CAAC,CAwBzB"}