clinkx 0.2.2 → 0.2.3

package/clinkx-workflows/dist/index.js

@@ -11,32 +11,280 @@
  * for in-process integration (Option C).
  */
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { serializeMessage } from "@modelcontextprotocol/sdk/shared/stdio.js";
+import { realpathSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { createWorkflowServer } from "./server.js";
 import { logger, assertStderrLogger } from "./logger.js";
+import { shutdownCoordinator } from "./shutdown.js";
 export { registerWorkflowTools, getWorkflowToolDefinitions, handleWorkflowToolCall, WORKFLOW_TOOL_NAMES, } from "./workflow-tools.js";
 export { createWorkflowServer } from "./server.js";
+const SHUTDOWN_DEADLINE_MS = 10_000;
+const SEND_TIMEOUT_MS = 30_000;
+const patchedTransports = new WeakSet();
+function serializeError(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function toError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+function extractRpcMeta(msg) {
+    if ("method" in msg) {
+        return "id" in msg && msg.id !== undefined ? { id: msg.id, method: msg.method } : { method: msg.method };
+    }
+    if ("id" in msg && msg.id !== undefined)
+        return { id: msg.id };
+    return {};
+}
+export function patchTransportSend(transport, stdout = process.stdout, onBrokenStdout) {
+    if (patchedTransports.has(transport))
+        return;
+    patchedTransports.add(transport);
+    let brokenError;
+    let sendChain = Promise.resolve();
+    const pendingRejects = [];
+    let shuttingDown = false;
+    function markBroken(err) {
+        brokenError ??= err;
+        const rejects = pendingRejects.splice(0);
+        for (const reject of rejects) {
+            reject(brokenError);
+        }
+        if (!shuttingDown) {
+            shuttingDown = true;
+            stdout.off("error", onError);
+            onBrokenStdout?.();
+        }
+    }
+    function onError(err) {
+        markBroken(err);
+    }
+    stdout.on("error", onError);
+    function sendOne(message) {
+        if (brokenError !== undefined) {
+            return Promise.reject(brokenError);
+        }
+        const json = serializeMessage(message);
+        const payloadBytes = Buffer.byteLength(json, "utf8");
+        const { id: rpcId, method: rpcMethod } = extractRpcMeta(message);
+        return new Promise((resolve, reject) => {
+            if (brokenError !== undefined) {
+                reject(brokenError);
+                return;
+            }
+            let settled = false;
+            let drainAttached = false;
+            let drainStartedAt = 0;
+            const timeout = setTimeout(() => {
+                logger.error({ rpcId, rpcMethod, payloadBytes }, "transport:send:timeout");
+                markBroken(new Error(`stdout write timed out after ${SEND_TIMEOUT_MS}ms`));
+            }, SEND_TIMEOUT_MS);
+            timeout.unref();
+            function cleanup() {
+                clearTimeout(timeout);
+                const index = pendingRejects.indexOf(onStdoutError);
+                if (index !== -1) {
+                    pendingRejects.splice(index, 1);
+                }
+                if (drainAttached) {
+                    stdout.off("drain", onDrain);
+                }
+            }
+            function settleResolve() {
+                if (settled)
+                    return;
+                settled = true;
+                const drainMs = drainStartedAt === 0 ? 0 : Date.now() - drainStartedAt;
+                cleanup();
+                logger.debug({ rpcId, rpcMethod, payloadBytes, drainMs }, "transport:send:ok");
+                resolve();
+            }
+            function settleReject(err) {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(err);
+            }
+            function onStdoutError(err) {
+                settleReject(err);
+            }
+            function onDrain() {
+                settleResolve();
+            }
+            pendingRejects.push(onStdoutError);
+            try {
+                logger.debug({ rpcId, rpcMethod, payloadBytes, writableLength: stdout.writableLength }, "transport:send:start");
+                if (stdout.write(json)) {
+                    settleResolve();
+                }
+                else {
+                    drainAttached = true;
+                    drainStartedAt = Date.now();
+                    stdout.once("drain", onDrain);
+                }
+            }
+            catch (err) {
+                const error = toError(err);
+                const nodeError = error;
+                logger.error({
+                    rpcId,
+                    rpcMethod,
+                    payloadBytes,
+                    errCode: nodeError.code,
+                    errSyscall: nodeError.syscall,
+                }, "transport:send:error");
+                markBroken(error);
+                settleReject(error);
+            }
+        });
+    }
+    transport.send = (message) => {
+        const send = sendChain.then(() => sendOne(message), () => sendOne(message));
+        sendChain = send.catch(() => undefined);
+        return send;
+    };
+}
+export function createShutdownOnce(server, options = {}) {
+    let shutdownStarted = false;
+    const cleanup = options.cleanup ?? (() => Promise.resolve());
+    const exit = options.exit ?? process.exit.bind(process);
+    return async function shutdownOnce(reason, exitCode) {
+        if (shutdownStarted) {
+            logger.warn({ reason }, "duplicate shutdown event ignored");
+            return;
+        }
+        shutdownStarted = true;
+        logger.info({ reason, exit_code: exitCode, pid: process.pid, writableLength: process.stdout.writableLength }, "clinkx-workflows:shutdown");
+        const deadline = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error("shutdown deadline exceeded")), SHUTDOWN_DEADLINE_MS).unref();
+        });
+        try {
+            await Promise.race([
+                (async () => {
+                    let effectiveExitCode = exitCode;
+                    logger.info({ reason, exit_code: exitCode }, "shutdown requested");
+                    try {
+                        await cleanup(reason);
+                    }
+                    catch (err) {
+                        effectiveExitCode = 1;
+                        logger.error({ reason, err: serializeError(err) }, "shutdown cleanup failed");
+                    }
+                    try {
+                        await server.close();
+                    }
+                    catch (err) {
+                        effectiveExitCode = 1;
+                        logger.error({ reason, err: serializeError(err) }, "server close failed during shutdown");
+                    }
+                    if (process.stdout.writableLength > 0 && process.stdout.writable) {
+                        await new Promise((resolve) => {
+                            const onDrain = () => {
+                                clearTimeout(timer);
+                                resolve();
+                            };
+                            const timer = setTimeout(() => {
+                                process.stdout.off("drain", onDrain);
+                                resolve();
+                            }, 2_000);
+                            timer.unref();
+                            process.stdout.once("drain", onDrain);
+                        });
+                    }
+                    exit(effectiveExitCode);
+                })(),
+                deadline,
+            ]);
+        }
+        catch {
+            try {
+                logger.error({ reason }, "shutdown deadline exceeded, forcing exit");
+            }
+            catch {
+                // Logger may be unavailable during stream failures.
+            }
+            process.exit(1);
+        }
+    };
+}
+export function installShutdownHandlers(shutdownOnce, targetProcess = process) {
+    const runShutdown = (reason, exitCode) => {
+        void shutdownOnce(reason, exitCode).catch((err) => {
+            try {
+                logger.fatal({ reason, err: serializeError(err) }, "shutdown failed");
+            }
+            catch {
+                // Logger may be unavailable during stream failures.
+            }
+            targetProcess.exit(1);
+        });
+    };
+    targetProcess.once("SIGTERM", () => runShutdown("SIGTERM", 0));
+    targetProcess.once("SIGINT", () => runShutdown("SIGINT", 0));
+    targetProcess.once("SIGHUP", () => runShutdown("SIGHUP", 0));
+    targetProcess.stdin.once("end", () => runShutdown("stdin:end", 0));
+    targetProcess.stdin.once("close", () => runShutdown("stdin:close", 0));
+    targetProcess.stdin.once("error", () => runShutdown("stdin:error", 1));
+    targetProcess.stderr.on("error", () => runShutdown("stderr:error", 0));
+    targetProcess.on("uncaughtException", (err) => {
+        try {
+            logger.fatal({ err }, "uncaught exception");
+        }
+        catch {
+            // Logger may be unavailable during fatal shutdown.
+        }
+        runShutdown("uncaughtException", 1);
+    });
+    targetProcess.on("unhandledRejection", (reason) => {
+        try {
+            logger.fatal({ err: reason }, "unhandled rejection");
+        }
+        catch {
+            // Logger may be unavailable during fatal shutdown.
+        }
+        runShutdown("unhandledRejection", 1);
+    });
+}
 async function main() {
     assertStderrLogger();
     const server = createWorkflowServer();
     const transport = new StdioServerTransport();
     logger.info("clinkx-workflows MCP server starting (STDIO transport)");
+    logger.info({ pid: process.pid, ppid: process.ppid }, "clinkx-workflows:startup");
+    const shutdownOnce = createShutdownOnce(server, {
+        cleanup: (reason) => shutdownCoordinator.shutdown(reason),
+    });
+    patchTransportSend(transport, process.stdout, () => {
+        void shutdownOnce("stdout:error", 1).catch((err) => {
+            try {
+                logger.fatal({ reason: "stdout:error", err: serializeError(err) }, "shutdown failed");
+            }
+            catch {
+                // Logger may be unavailable during stream failures.
+            }
+            process.exit(1);
+        });
+    });
+    installShutdownHandlers(shutdownOnce);
     await server.connect(transport);
-    // Graceful shutdown: coordinate with any in-flight workflow,
-    // then close the server and exit.
-    const shutdown = async (signal) => {
-        logger.info({ signal }, "shutdown signal received");
-        // ShutdownCoordinator handles in-flight workflow cancellation,
-        // state persistence, and child termination via its own signal handlers.
-        // We just need to close the MCP server transport cleanly.
-        await server.close();
-        process.exit(0);
-    };
-    process.once("SIGTERM", () => void shutdown("SIGTERM").catch(() => process.exit(1)));
-    process.once("SIGINT", () => void shutdown("SIGINT").catch(() => process.exit(1)));
     logger.info("clinkx-workflows MCP server connected and ready");
 }
-main().catch((err) => {
-    logger.fatal({ err }, "clinkx-workflows failed to start");
-    process.exitCode = 1;
-});
+function isCliEntrypoint() {
+    const entry = process.argv[1];
+    if (entry == null)
+        return false;
+    try {
+        return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return import.meta.url === pathToFileURL(entry).href;
+    }
+}
+if (isCliEntrypoint()) {
+    main().catch((err) => {
+        logger.fatal({ err }, "clinkx-workflows failed to start");
+        process.exitCode = 1;
+    });
+}
 //# sourceMappingURL=index.js.map

package/clinkx-workflows/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKzD,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,KAAK,UAAU,IAAI;IACjB,kBAAkB,EAAE,CAAC;IAErB,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IAEtE,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,6DAA6D;IAC7D,kCAAkC;IAClC,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACxC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;QACpD,+DAA+D;QAC/D,wEAAwE;QACxE,0DAA0D;QAC1D,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnF,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;AACjE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,kCAAkC,CAAC,CAAC;IAC1D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/clinkx-workflows/dist/server.d.ts

@@ -12,5 +12,12 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
  * Registers three tools: run_workflow, resume_workflow, list_workflows.
  * Uses ClinkSession (child process) as the backend.
  * Does NOT connect transport — caller is responsible.
+ *
+ * When `availableCliNames` is not explicitly provided, attempts to
+ * discover adapter names from the child config path. This gives the
+ * standalone server schema enum injection and parse-time validation
+ * without requiring the caller to wire discovery manually.
  */
-export declare function createWorkflowServer(): Server;
+export declare function createWorkflowServer(options?: {
+    availableCliNames?: readonly string[];
+}): Server;

package/clinkx-workflows/dist/server.js

@@ -5,10 +5,84 @@
  * ClinkSession child process. For in-process integration, use
  * registerWorkflowTools() from workflow-tools.ts directly.
  */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, extname } from "node:path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { getChildConfigPath } from "./config.js";
+import { logger } from "./logger.js";
 import { ClinkSession } from "./transport.js";
 import { registerWorkflowTools } from "./workflow-tools.js";
 // ---------------------------------------------------------------------------
+// Adapter name discovery
+// ---------------------------------------------------------------------------
+/**
+ * Best-effort adapter name discovery from child config path.
+ *
+ * Reads CLINKX_WORKFLOWS_CHILD_CONFIG_PATH — supports both directory
+ * (scan for .json files) and single-file paths, mirroring the path-
+ * resolution behavior of AdapterRegistry.loadFromPath.
+ *
+ * This performs lightweight structural validation (requires `name` +
+ * `command` fields) rather than full CliAdapterConfigSchema parsing,
+ * which lives in the root package and cannot be imported without
+ * creating a circular dependency. Runtime validation in the child
+ * process remains the authoritative gate. Returns undefined when no
+ * config path is set or no valid adapters are found.
+ */
+function discoverChildAdapterNames() {
+    const configPath = getChildConfigPath();
+    if (configPath == null)
+        return undefined;
+    try {
+        const stat = statSync(configPath);
+        const names = [];
+        if (stat.isFile()) {
+            // Single-file config path
+            const name = extractAdapterName(configPath);
+            if (name != null)
+                names.push(name);
+        }
+        else if (stat.isDirectory()) {
+            // Directory config path — scan for .json files
+            const files = readdirSync(configPath).filter((f) => extname(f) === ".json");
+            for (const file of files) {
+                const name = extractAdapterName(join(configPath, file));
+                if (name != null)
+                    names.push(name);
+            }
+        }
+        if (names.length > 0) {
+            logger.debug({ names, configPath }, "discovered child adapter names for standalone server");
+            return names;
+        }
+    }
+    catch (err) {
+        logger.debug({ configPath, err }, "could not enumerate child config path");
+    }
+    return undefined;
+}
+/**
+ * Extract the adapter name from a config JSON file.
+ *
+ * Requires both `name` (string) and `command` (string) fields to be
+ * present — the two mandatory fields in any valid adapter config.
+ * Skips files that don't meet this minimum bar.
+ */
+function extractAdapterName(filePath) {
+    try {
+        const raw = readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed["name"] === "string" && parsed["name"] !== "" &&
+            typeof parsed["command"] === "string" && parsed["command"] !== "") {
+            return parsed["name"];
+        }
+    }
+    catch {
+        // Malformed config file — non-fatal
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
 // Server factory
 // ---------------------------------------------------------------------------
 /**
@@ -17,16 +91,28 @@ import { registerWorkflowTools } from "./workflow-tools.js";
  * Registers three tools: run_workflow, resume_workflow, list_workflows.
  * Uses ClinkSession (child process) as the backend.
  * Does NOT connect transport — caller is responsible.
+ *
+ * When `availableCliNames` is not explicitly provided, attempts to
+ * discover adapter names from the child config path. This gives the
+ * standalone server schema enum injection and parse-time validation
+ * without requiring the caller to wire discovery manually.
  */
-export function createWorkflowServer() {
+export function createWorkflowServer(options) {
     const server = new Server({ name: "clinkx-workflows", version: "0.1.0" }, {
         capabilities: { tools: {} },
         instructions: "Orchestrates multi-stage workflows by delegating calls to CLI subagents via ClinkX. " +
             "Use run_workflow to start a new workflow, resume_workflow to continue a failed run, " +
             "or list_workflows to see available workflows.",
     });
+    // Normalize empty arrays to undefined — an empty list would suppress schema
+    // hints while still enabling validation (rejecting all adapter names).
+    const explicit = options?.availableCliNames;
+    const cliNames = (explicit != null && explicit.length > 0)
+        ? explicit
+        : discoverChildAdapterNames();
     registerWorkflowTools(server, {
         createBackend: (runId) => new ClinkSession({ runId }),
+        ...(cliNames != null ? { availableCliNames: cliNames } : {}),
     });
     return server;
 }

package/clinkx-workflows/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,YAAY,EACV,sFAAsF;YACtF,sFAAsF;YACtF,+CAA+C;KAClD,CACF,CAAC;IAEF,qBAAqB,CAAC,MAAM,EAAE;QAC5B,aAAa,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;KAC9D,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/clinkx-workflows/dist/shutdown.d.ts

@@ -2,8 +2,8 @@
  * Shutdown coordinator for clinkx-workflows.
  *
  * Handles:
- * - SIGTERM/SIGINT: cancel in-flight calls, persist state (best-effort),
- *   terminate child, exit
+ * - process shutdown: cancel in-flight calls, persist state (best-effort),
+ *   terminate child
  * - MCP cancellation: propagate AbortSignal, cancel calls, persist cancelled,
  *   no response
  *
@@ -17,9 +17,6 @@ type StatePersister = () => Promise<void>;
 export declare class ShutdownCoordinator {
     private state;
     private shuttingDown;
-    private signalHandlersInstalled;
-    private readonly boundHandleSignal;
-    constructor();
     /**
      * Register the active session and abort controller for this run.
      * Call at the start of each workflow run.
@@ -41,13 +38,12 @@ export declare class ShutdownCoordinator {
      */
     cancelRun(): Promise<void>;
     /**
-     * Handle SIGTERM/SIGINT.
-     * Cancel, persist, terminate, exit.
+     * Handle process shutdown.
+     * Cancel, persist, and terminate. The entrypoint owns process.exit.
      */
-    private handleSignalShutdown;
+    shutdown(signal: string): Promise<void>;
     private safePersistState;
     private safeTerminateSession;
-    private installSignalHandlers;
 }
 /** Singleton shutdown coordinator. */
 export declare const shutdownCoordinator: ShutdownCoordinator;

package/clinkx-workflows/dist/shutdown.js

@@ -2,8 +2,8 @@
  * Shutdown coordinator for clinkx-workflows.
  *
  * Handles:
- * - SIGTERM/SIGINT: cancel in-flight calls, persist state (best-effort),
- *   terminate child, exit
+ * - process shutdown: cancel in-flight calls, persist state (best-effort),
+ *   terminate child
  * - MCP cancellation: propagate AbortSignal, cancel calls, persist cancelled,
  *   no response
  *
@@ -20,13 +20,6 @@ export class ShutdownCoordinator {
         persistState: null,
     };
     shuttingDown = false;
-    signalHandlersInstalled = false;
-    boundHandleSignal;
-    constructor() {
-        this.boundHandleSignal = (signal) => {
-            void this.handleSignalShutdown(signal);
-        };
-    }
     /**
      * Register the active session and abort controller for this run.
      * Call at the start of each workflow run.
@@ -34,7 +27,6 @@ export class ShutdownCoordinator {
     register(session, controller, persistState) {
         this.state = { session, controller, persistState };
         this.shuttingDown = false;
-        this.installSignalHandlers();
     }
     /**
      * Unregister the current run (on normal completion).
@@ -67,10 +59,10 @@ export class ShutdownCoordinator {
         await this.safeTerminateSession();
     }
     /**
-     * Handle SIGTERM/SIGINT.
-     * Cancel, persist, terminate, exit.
+     * Handle process shutdown.
+     * Cancel, persist, and terminate. The entrypoint owns process.exit.
      */
-    async handleSignalShutdown(signal) {
+    async shutdown(signal) {
         if (this.shuttingDown) {
             logger.warn({ signal }, "duplicate shutdown signal ignored");
             return;
@@ -83,9 +75,7 @@ export class ShutdownCoordinator {
         await this.safePersistState();
         // 3. Terminate child session
         await this.safeTerminateSession();
-        // 4. Exit
-        logger.info({ signal }, "shutdown complete, exiting");
-        process.exit(0);
+        logger.info({ signal }, "shutdown cleanup complete");
     }
     async safePersistState() {
         if (this.state.persistState == null)
@@ -107,13 +97,6 @@ export class ShutdownCoordinator {
             logger.error({ err: err instanceof Error ? err.message : String(err) }, "failed to terminate child session during shutdown");
         }
     }
-    installSignalHandlers() {
-        if (this.signalHandlersInstalled)
-            return;
-        this.signalHandlersInstalled = true;
-        process.on("SIGTERM", () => this.boundHandleSignal("SIGTERM"));
-        process.on("SIGINT", () => this.boundHandleSignal("SIGINT"));
-    }
 }
 /** Singleton shutdown coordinator. */
 export const shutdownCoordinator = new ShutdownCoordinator();

package/clinkx-workflows/dist/shutdown.js.map

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

package/clinkx-workflows/dist/state.d.ts

@@ -1,6 +1,17 @@
 import type { EngineHooks, EngineResumeState } from "./engine.js";
 import type { NormalizedWorkflowDefinition } from "./definition-normalizer.js";
 import type { RunState } from "./state-schema.js";
+export type RunDirectoryClassification = "failed" | "cancelled" | "debug_kept" | "active_locked" | "running_or_pending" | "unknown";
+export interface PruneRunDirectoriesOptions {
+    readonly retainFailedDays?: number | undefined;
+    readonly retainCancelledDays?: number | undefined;
+    readonly retainDebugDays?: number | undefined;
+}
+export interface PruneRunDirectoriesResult {
+    readonly pruned: number;
+    readonly skipped: number;
+    readonly errors: number;
+}
 export interface CreateWorkflowStateOptions {
     readonly runId: string;
     readonly definition: NormalizedWorkflowDefinition;
@@ -13,6 +24,8 @@ export interface ResumeWorkflowStateOptions {
     readonly runDir?: string | undefined;
     readonly debugKeepArtifacts?: boolean | undefined;
 }
+export declare function classifyRunDirectory(runDirPath: string): RunDirectoryClassification;
+export declare function pruneRunDirectories(runsRootDir: string, options?: PruneRunDirectoriesOptions): Promise<PruneRunDirectoriesResult>;
 export declare class WorkflowStateStore {
     readonly runDir: string;
     readonly definition: NormalizedWorkflowDefinition;