@procedures/node 0.0.0-stage → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/procedures/node/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAKlE;;GAEG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,GACzC,OAAO,CAAC,aAAa,CAAC,CAgCxB"}

package/dist/procedures/node/run.js

@@ -0,0 +1,48 @@
+/**
+ * node.run procedure
+ *
+ * Runs a Node.js script and waits for completion.
+ *
+ * The script runs with the Node.js of the host (`process.execPath`), through `runCommand` of
+ * client-shell: the output has a limit, and the timeout and the signal kill the script and the
+ * processes that it started (deep dive WRP-10). Before, the output had no limit, and the timeout
+ * killed only the direct child.
+ */
+import { runCommand } from "@procedures/shell/command";
+/** The end of the output that a timeout error shows. */
+const ERROR_OUTPUT_CHARS = 2000;
+/**
+ * Run a Node.js script and wait for completion
+ */
+export async function nodeRun(input, ctx) {
+    const { script, args = [], cwd, env, timeout, maxOutputBytes } = input;
+    const result = await runCommand(process.execPath, {
+        args: [script, ...args],
+        cwd,
+        env,
+        timeout,
+        signal: ctx?.signal,
+        maxOutputBytes,
+    });
+    if (result.error) {
+        throw new Error(`node did not start: ${result.error}`);
+    }
+    if (result.timedOut) {
+        const output = `${result.stdout}${result.stderr}`.slice(-ERROR_OUTPUT_CHARS);
+        throw new Error(`Process timed out after ${timeout}ms${output ? `. Output:\n${output}` : ""}`);
+    }
+    if (result.aborted) {
+        const error = new Error("node.run was aborted");
+        error.name = "AbortError";
+        throw error;
+    }
+    const output = {
+        exitCode: result.exitCode,
+        stdout: result.stdout,
+        stderr: result.stderr,
+    };
+    if (result.truncated)
+        output.truncated = true;
+    return output;
+}
+//# sourceMappingURL=run.js.map

package/dist/procedures/node/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/procedures/node/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGvD,wDAAwD;AACxD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,KAAmB,EACnB,GAA0C;IAE1C,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAEvE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE;QAChD,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;QACvB,GAAG;QACH,GAAG;QACH,OAAO;QACP,MAAM,EAAE,GAAG,EAAE,MAAM;QACnB,cAAc;KACf,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;QAC1B,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAkB;QAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;IACF,IAAI,MAAM,CAAC,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/procedures/node/spawn.d.ts

@@ -0,0 +1,14 @@
+/**
+ * node.spawn procedure
+ *
+ * Spawns a long-running Node.js process.
+ *
+ * The process is a record of the process registry of client-shell: node.status shows it,
+ * node.kill ends its whole tree, and it ends with the host (deep dive WRP-4, WRP-10).
+ */
+import type { NodeSpawnInput, NodeSpawnOutput } from "../../types.js";
+/**
+ * Spawn a long-running Node.js process
+ */
+export declare function nodeSpawn(input: NodeSpawnInput): Promise<NodeSpawnOutput>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/procedures/node/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/procedures/node/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtE;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAuB/E"}

package/dist/procedures/node/spawn.js

@@ -0,0 +1,35 @@
+/**
+ * node.spawn procedure
+ *
+ * Spawns a long-running Node.js process.
+ *
+ * The process is a record of the process registry of client-shell: node.status shows it,
+ * node.kill ends its whole tree, and it ends with the host (deep dive WRP-4, WRP-10).
+ */
+import { processManager } from "../../process-manager.js";
+/**
+ * Spawn a long-running Node.js process
+ */
+export async function nodeSpawn(input) {
+    const { script, args = [], cwd, env, ready } = input;
+    const started = processManager.start(script, { args, cwd, env });
+    if (started.status === "error") {
+        throw new Error(`node did not start for ${script}`);
+    }
+    // Wait for ready pattern if specified
+    if (ready) {
+        try {
+            await processManager.waitForReady(started.processId, ready.pattern, ready.timeout ?? 30000);
+        }
+        catch (error) {
+            // A process that is not ready is of no use to the caller: stop it
+            await processManager.kill(started.processId);
+            throw error;
+        }
+    }
+    return {
+        processId: started.processId,
+        pid: started.pid,
+    };
+}
+//# sourceMappingURL=spawn.js.map

package/dist/procedures/node/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/procedures/node/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAErD,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,sCAAsC;IACtC,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;QAC9F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kEAAkE;YAClE,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7C,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;AACJ,CAAC"}

package/dist/procedures/node/status.d.ts

@@ -0,0 +1,11 @@
+/**
+ * node.status procedure
+ *
+ * Gets status of spawned Node.js processes.
+ */
+import type { NodeStatusInput, NodeStatusOutput } from "../../types.js";
+/**
+ * Get status of running processes (and the recent exits)
+ */
+export declare function nodeStatus(input: NodeStatusInput): Promise<NodeStatusOutput>;
+//# sourceMappingURL=status.d.ts.map

package/dist/procedures/node/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/procedures/node/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGxE;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAUlF"}

package/dist/procedures/node/status.js

@@ -0,0 +1,17 @@
+/**
+ * node.status procedure
+ *
+ * Gets status of spawned Node.js processes.
+ */
+import { processManager } from "../../process-manager.js";
+/**
+ * Get status of running processes (and the recent exits)
+ */
+export async function nodeStatus(input) {
+    const { processId } = input;
+    const processes = processManager.getStatus(processId).map((info) => input.output ? { ...info, output: processManager.output(info.processId) } : info);
+    return {
+        processes,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/procedures/node/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/procedures/node/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAE5B,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CACjF,CAAC;IAEF,OAAO;QACL,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/process-manager.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Process Manager - Manages spawned Node.js processes
+ *
+ * The manager is a view of the process registry of client-shell, for the group "node"
+ * (deep dive WRP-4, WRP-10):
+ * - `kill` ends the whole process tree, not only the direct child;
+ * - the registry reads the output of each process, so a full pipe does not stop it;
+ * - the processes end when the host ends (before, they were detached and kept running);
+ * - the registry removes old exit records, and `cleanup` removes the rest.
+ */
+import type { ProcessInfo } from "./types.js";
+/** The group of the node processes in the process registry. */
+export declare const NODE_GROUP = "node";
+declare class ProcessManager {
+    /**
+     * Start a Node.js script and record it
+     */
+    start(script: string, options: {
+        args?: string[] | undefined;
+        cwd?: string | undefined;
+        env?: Record<string, string> | undefined;
+    }): ProcessInfo;
+    /**
+     * Get a managed process by ID
+     */
+    get(processId: string): ProcessInfo | undefined;
+    /**
+     * Kill a process (and the processes that it started) by ID, and wait for its end
+     */
+    kill(processId: string, signal?: NodeJS.Signals): Promise<boolean>;
+    /**
+     * Wait for a ready pattern in the output
+     */
+    waitForReady(processId: string, pattern: string, timeout?: number): Promise<void>;
+    /**
+     * The end of the output of a process (the last 64 KiB)
+     */
+    output(processId: string): string;
+    /**
+     * Get status of all or specific processes
+     */
+    getStatus(processId?: string): ProcessInfo[];
+    /**
+     * Cleanup exited processes
+     */
+    cleanup(): number;
+}
+export declare const processManager: ProcessManager;
+export {};
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../src/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,+DAA+D;AAC/D,eAAO,MAAM,UAAU,SAAS,CAAC;AAejC,cAAM,cAAc;IAClB;;OAEG;IACH,KAAK,CACH,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KAAE,GAC3G,WAAW,CASb;IAED;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAG9C;IAED;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAGlF;IAED;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7F;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhC;IAED;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAK3C;IAED;;OAEG;IACH,OAAO,IAAI,MAAM,CAMhB;CACF;AAGD,eAAO,MAAM,cAAc,EAAE,cAAqC,CAAC"}

package/dist/process-manager.js

@@ -0,0 +1,92 @@
+/**
+ * Process Manager - Manages spawned Node.js processes
+ *
+ * The manager is a view of the process registry of client-shell, for the group "node"
+ * (deep dive WRP-4, WRP-10):
+ * - `kill` ends the whole process tree, not only the direct child;
+ * - the registry reads the output of each process, so a full pipe does not stop it;
+ * - the processes end when the host ends (before, they were detached and kept running);
+ * - the registry removes old exit records, and `cleanup` removes the rest.
+ */
+import { processes } from "@procedures/shell/command";
+/** The group of the node processes in the process registry. */
+export const NODE_GROUP = "node";
+function toProcessInfo(info) {
+    const result = {
+        processId: info.id,
+        pid: info.pid,
+        script: info.label ?? info.args[0] ?? "",
+        status: info.status,
+        startedAt: info.startedAt,
+    };
+    if (info.exitCode !== undefined)
+        result.exitCode = info.exitCode;
+    if (info.exitedAt !== undefined)
+        result.exitedAt = info.exitedAt;
+    return result;
+}
+class ProcessManager {
+    /**
+     * Start a Node.js script and record it
+     */
+    start(script, options) {
+        const info = processes.start(process.execPath, {
+            args: [script, ...(options.args ?? [])],
+            cwd: options.cwd,
+            env: options.env,
+            group: NODE_GROUP,
+            label: script,
+        });
+        return toProcessInfo(info);
+    }
+    /**
+     * Get a managed process by ID
+     */
+    get(processId) {
+        const info = processes.get(processId);
+        return info && info.group === NODE_GROUP ? toProcessInfo(info) : undefined;
+    }
+    /**
+     * Kill a process (and the processes that it started) by ID, and wait for its end
+     */
+    async kill(processId, signal = "SIGTERM") {
+        if (!this.get(processId))
+            return false;
+        return (await processes.stop(processId, signal)).stopped;
+    }
+    /**
+     * Wait for a ready pattern in the output
+     */
+    async waitForReady(processId, pattern, timeout = 30000) {
+        await processes.waitFor(processId, new RegExp(pattern), timeout);
+    }
+    /**
+     * The end of the output of a process (the last 64 KiB)
+     */
+    output(processId) {
+        return this.get(processId) ? processes.output(processId) : "";
+    }
+    /**
+     * Get status of all or specific processes
+     */
+    getStatus(processId) {
+        return processes
+            .list({ group: NODE_GROUP })
+            .filter((info) => processId === undefined || info.id === processId)
+            .map(toProcessInfo);
+    }
+    /**
+     * Cleanup exited processes
+     */
+    cleanup() {
+        let cleaned = 0;
+        for (const info of processes.list({ group: NODE_GROUP })) {
+            if (info.exitedAt && processes.forget(info.id))
+                cleaned++;
+        }
+        return cleaned;
+    }
+}
+// Singleton instance
+export const processManager = new ProcessManager();
+//# sourceMappingURL=process-manager.js.map

package/dist/process-manager.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Importing this file registers the procedures of @procedures/node in the global registry
+ * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
+ * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ */
+export * from "./module.js";
+export declare function registerNodeProcedures(): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,cAAc,aAAa,CAAC;AAE5B,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/register.js

@@ -0,0 +1,14 @@
+/**
+ * Importing this file registers the procedures of @procedures/node in the global registry
+ * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
+ * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ */
+import { registerProcedures } from "@procedures/client";
+import { nodeModule } from "./module.js";
+export * from "./module.js";
+export function registerNodeProcedures() {
+    registerProcedures(nodeModule.procedures);
+}
+// Auto-register when this module is loaded
+registerNodeProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,cAAc,aAAa,CAAC;AAE5B,MAAM,UAAU,sBAAsB;IACpC,kBAAkB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,2CAA2C;AAC3C,sBAAsB,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Type definitions for client-node procedures
+ */
+import { z } from "zod";
+export declare const NodeRunInputSchema: z.ZodObject<{
+    script: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+}>;
+export type NodeRunInput = z.infer<typeof NodeRunInputSchema>;
+export interface NodeRunOutput {
+    /** Exit code of the process */
+    exitCode: number;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+    /** True when an output stream was longer than `maxOutputBytes` */
+    truncated?: boolean | undefined;
+}
+export declare const NodeSpawnInputSchema: z.ZodObject<{
+    script: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    ready: z.ZodOptional<z.ZodObject<{
+        pattern: z.ZodString;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }>>;
+}>;
+export type NodeSpawnInput = z.infer<typeof NodeSpawnInputSchema>;
+export interface NodeSpawnOutput {
+    /** Unique process identifier for management */
+    processId: string;
+    /** OS process ID */
+    pid: number;
+}
+export declare const NodeKillInputSchema: z.ZodObject<{
+    processId: z.ZodString;
+    signal: z.ZodOptional<z.ZodString>;
+}>;
+export type NodeKillInput = z.infer<typeof NodeKillInputSchema>;
+export interface NodeKillOutput {
+    /** Whether the kill was successful */
+    success: boolean;
+    /** Exit code if process exited */
+    exitCode?: number | undefined;
+}
+export declare const NodeStatusInputSchema: z.ZodObject<{
+    processId: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodBoolean>;
+}>;
+export type NodeStatusInput = z.infer<typeof NodeStatusInputSchema>;
+export interface ProcessInfo {
+    /** Process identifier */
+    processId: string;
+    /** OS process ID */
+    pid: number;
+    /** Script path */
+    script: string;
+    /** Current status */
+    status: "running" | "exited" | "error";
+    /** Exit code if exited */
+    exitCode?: number | undefined;
+    /** Start time */
+    startedAt: string;
+    /** Exit time if exited */
+    exitedAt?: string | undefined;
+    /** With `output: true`, the end of the output */
+    output?: string | undefined;
+}
+export interface NodeStatusOutput {
+    /** List of processes */
+    processes: ProcessInfo[];
+}
+export declare const NodeRunOutputSchema: z.ZodType<NodeRunOutput>;
+export declare const NodeSpawnOutputSchema: z.ZodType<NodeSpawnOutput>;
+export declare const NodeKillOutputSchema: z.ZodType<NodeKillOutput>;
+export declare const NodeStatusOutputSchema: z.ZodType<NodeStatusOutput>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,90 @@
+/**
+ * Type definitions for client-node procedures
+ */
+import { z } from "zod";
+// ============================================================================
+// node.run - Run script and wait for completion
+// ============================================================================
+export const NodeRunInputSchema = z.object({
+    /** Script path to run */
+    script: z.string().describe("Script path to run"),
+    /** Arguments to pass to the script */
+    args: z.array(z.string()).optional().describe("Arguments to pass to the script"),
+    /** Working directory */
+    cwd: z.string().optional().describe("Working directory"),
+    /** Environment variables */
+    env: z.record(z.string(), z.string()).optional().describe("Environment variables"),
+    /** Timeout in milliseconds. At the timeout, the script and its child processes are killed. */
+    timeout: z.number().optional().describe("Timeout in milliseconds. At the timeout, the script and its child processes are killed."),
+    /** The most bytes kept of each output stream (default: 64 MiB). The procedure keeps the first bytes. */
+    maxOutputBytes: z.number().int().positive().optional().describe("The most bytes kept of each output stream (default: 64 MiB). The procedure keeps the first bytes."),
+});
+// ============================================================================
+// node.spawn - Spawn long-running process
+// ============================================================================
+export const NodeSpawnInputSchema = z.object({
+    /** Script path to run */
+    script: z.string().describe("Script path to run"),
+    /** Arguments to pass to the script */
+    args: z.array(z.string()).optional().describe("Arguments to pass to the script"),
+    /** Working directory */
+    cwd: z.string().optional().describe("Working directory"),
+    /** Environment variables */
+    env: z.record(z.string(), z.string()).optional().describe("Environment variables"),
+    /** Ready pattern - wait for this in stdout before returning */
+    ready: z
+        .object({
+        pattern: z.string(),
+        timeout: z.number().optional(),
+    })
+        .optional().describe("Ready pattern - wait for this in stdout before returning"),
+});
+// ============================================================================
+// node.kill - Kill a spawned process
+// ============================================================================
+export const NodeKillInputSchema = z.object({
+    /** Process ID returned from node.spawn */
+    processId: z.string().describe("Process ID returned from node.spawn"),
+    /** Signal to send (default: SIGTERM) */
+    signal: z.string().optional().describe("Signal to send (default: SIGTERM)"),
+});
+// ============================================================================
+// node.status - Get status of running processes
+// ============================================================================
+export const NodeStatusInputSchema = z.object({
+    /** Optional process ID to filter by */
+    processId: z.string().optional().describe("Optional process ID to filter by"),
+    /** Also give the end of the output of each process (the last 64 KiB) */
+    output: z.boolean().optional().describe("Also give the end of the output of each process (the last 64 KiB)"),
+});
+// Output schemas (roadmap 2.1). Loose objects: a field that a schema does not name stays in the
+// result (a strict schema would remove it when the output is validated).
+export const NodeRunOutputSchema = z.looseObject({
+    exitCode: z.number().describe("The exit code of the script"),
+    stdout: z.string().describe("The standard output"),
+    stderr: z.string().describe("The standard error"),
+    truncated: z.boolean().optional().describe("True when an output stream was longer than maxOutputBytes"),
+});
+export const NodeSpawnOutputSchema = z.looseObject({
+    processId: z.string().describe("The id of the process: node.kill and node.status take it"),
+    pid: z.number().describe("The process id of the operating system"),
+});
+export const NodeKillOutputSchema = z.looseObject({
+    success: z.boolean().describe("True when the process ended"),
+    exitCode: z.number().optional().describe("The exit code, when the process exited"),
+});
+export const NodeStatusOutputSchema = z.looseObject({
+    processes: z
+        .array(z.looseObject({
+        processId: z.string().describe("The id of the process"),
+        pid: z.number().describe("The process id of the operating system"),
+        script: z.string().describe("The script"),
+        status: z.enum(["running", "exited", "error"]).describe("The state of the process"),
+        exitCode: z.number().optional().describe("The exit code, when the process exited"),
+        startedAt: z.string().describe("The start time (ISO 8601)"),
+        exitedAt: z.string().optional().describe("The end time (ISO 8601), when the process ended"),
+        output: z.string().optional().describe("With output: true, the end of the output"),
+    }))
+        .describe("The processes of this host"),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,81 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/node",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Node.js process procedures: run scripts, spawn and manage long-running processes, with output caps and process-tree cleanup.",
+  "keywords": [
+    "node",
+    "process",
+    "spawn",
+    "process-manager",
+    "procedures"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/client-node"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@procedures/client": "0.1.0",
+    "@procedures/shell": "0.1.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3"
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }

package/src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * client-node - Node.js process management procedures
+ */
+
+// Importing the package registers its procedures, as in the other client packages (BUGS-2026-07 H18)
+import "./register.js";
+
+// Export types
+export * from "./types.js";
+
+// Export procedures
+export { nodeRun } from "./procedures/node/run.js";
+export { nodeSpawn } from "./procedures/node/spawn.js";
+export { nodeKill } from "./procedures/node/kill.js";
+export { nodeStatus } from "./procedures/node/status.js";
+
+// Export process manager
+export { processManager } from "./process-manager.js";