@specship/specship 0.11.0

package/dist/workflows/runners/prompt.js

@@ -0,0 +1,306 @@
+"use strict";
+/**
+ * PromptNode runner — invokes Claude Code in headless mode.
+ *
+ * Why shell out instead of embedding the Claude Agent SDK:
+ *   - This fork is Claude-Code-only; users have `claude` on PATH already.
+ *   - The SDK pulls in real auth complexity + ~MB of deps. The CLI's
+ *     headless `--print` mode is purpose-built for non-interactive use.
+ *   - Per-node `allowed_tools` / `denied_tools` / `model` map cleanly to
+ *     CLI flags.
+ *
+ * The agent runs with `--output-format stream-json`, so its activity streams
+ * out line-by-line. Each line is parsed and surfaced as a workflow event via
+ * `ctx.emitEvent` (WF-STREAM-DOC): a `tool_called` event per tool the agent
+ * invokes (name + short input) and an `agent_message` event per assistant text
+ * turn. The step's text output is the stream's terminal `result` — identical to
+ * what the old `--output-format json` produced. If the output isn't a parseable
+ * stream, we fall back to treating stdout as the result, so a run never breaks.
+ *
+ * Limitations (acceptable for v1):
+ *   - Per-node MCP server config is NOT plumbed — prompt nodes inherit the host
+ *     Claude Code session's MCP servers. v2 candidate.
+ *   - Per-node hooks likewise inherit host-level hooks.
+ *
+ * Raw output also streams to `<logsDir>/<runId>-<nodeId>.jsonl`.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptRunner = void 0;
+exports.newStreamState = newStreamState;
+exports.summarizeToolInput = summarizeToolInput;
+exports.handleStreamLine = handleStreamLine;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const TRANSIENT_PATTERNS = [
+    /rate.?limit/i,
+    /timeout/i,
+    /network/i,
+    /connection.?reset/i,
+    /econn/i,
+    /etimedout/i,
+];
+function newStreamState() {
+    return { sawStream: false, resultText: null, assistantText: '' };
+}
+/** A short, single-line summary of a tool's input for the `tool_called` event. */
+function summarizeToolInput(input) {
+    if (input == null)
+        return '';
+    let s;
+    if (typeof input === 'string') {
+        s = input;
+    }
+    else if (typeof input === 'object') {
+        const o = input;
+        const pick = o.file_path ?? o.path ?? o.command ?? o.pattern ?? o.query ?? o.url ?? o.prompt;
+        s = typeof pick === 'string' ? pick : JSON.stringify(o);
+    }
+    else {
+        s = String(input);
+    }
+    s = s.replace(/\s+/g, ' ').trim();
+    return s.length > 140 ? `${s.slice(0, 140)}…` : s;
+}
+/**
+ * Parse one stream-json line, emit any activity events, and fold the result
+ * into `state`. Pure aside from the `emit` callback. Unknown / non-JSON lines
+ * are ignored. Extended-thinking blocks are intentionally NOT emitted.
+ */
+function handleStreamLine(line, emit, state) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    let ev;
+    try {
+        ev = JSON.parse(trimmed);
+    }
+    catch {
+        return; // not JSON — ignore (keeps the fallback path intact)
+    }
+    if (!ev || typeof ev !== 'object')
+        return;
+    const e = ev;
+    if (e.type === 'assistant' && e.message && typeof e.message === 'object') {
+        state.sawStream = true;
+        const content = e.message.content;
+        if (Array.isArray(content)) {
+            for (const raw of content) {
+                const b = raw;
+                if (b?.type === 'tool_use') {
+                    emit('tool_called', { name: b.name, input: summarizeToolInput(b.input) });
+                }
+                else if (b?.type === 'text' && typeof b.text === 'string' && b.text.trim()) {
+                    state.assistantText += (state.assistantText ? '\n' : '') + b.text;
+                    emit('agent_message', { text: b.text });
+                }
+                // 'thinking' blocks: deliberately skipped.
+            }
+        }
+    }
+    else if (e.type === 'result') {
+        state.sawStream = true;
+        if (typeof e.result === 'string')
+            state.resultText = e.result;
+    }
+    else if (e.type === 'system') {
+        state.sawStream = true; // init/system frame — confirms we're on the stream path
+    }
+}
+class PromptRunner {
+    kind = 'prompt';
+    async run(rawNode, ctx) {
+        if (rawNode.kind !== 'prompt') {
+            return { status: 'failed', error: `PromptRunner received ${rawNode.kind} node` };
+        }
+        const node = rawNode;
+        const claudeBin = process.env.SPECSHIP_CLAUDE_BIN ?? 'claude';
+        const args = [];
+        args.push('--print');
+        // Stream the agent's activity as JSONL so we can surface tool calls and
+        // messages live. `--print` + `--output-format stream-json` requires
+        // `--verbose` (the CLI rejects the combination otherwise).
+        args.push('--output-format', 'stream-json', '--verbose');
+        if (node.model)
+            args.push('--model', node.model);
+        if (node.allowed_tools && node.allowed_tools.length > 0) {
+            args.push('--allowed-tools', node.allowed_tools.join(','));
+        }
+        if (node.denied_tools && node.denied_tools.length > 0) {
+            args.push('--disallowed-tools', node.denied_tools.join(','));
+        }
+        if (node.systemPromptAppend) {
+            args.push('--append-system-prompt', node.systemPromptAppend);
+        }
+        const logPath = path.join(ctx.logsDir, `${ctx.runId}-${node.id}.jsonl`);
+        return new Promise((resolve) => {
+            let child;
+            try {
+                child = (0, child_process_1.spawn)(claudeBin, args, {
+                    cwd: ctx.cwd,
+                    env: process.env,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    windowsHide: true,
+                });
+            }
+            catch (err) {
+                resolve({
+                    status: 'failed',
+                    error: `failed to spawn ${claudeBin}: ${err instanceof Error ? err.message : String(err)}`,
+                });
+                return;
+            }
+            let stdout = '';
+            let stderr = '';
+            let lineBuf = '';
+            const state = newStreamState();
+            let logStream = null;
+            try {
+                logStream = fs.createWriteStream(logPath, { flags: 'a' });
+                logStream.write(`${JSON.stringify({ event: 'spawn', cwd: ctx.cwd, args, ts: Date.now() })}\n`);
+            }
+            catch {
+                logStream = null;
+            }
+            child.stdout?.on('data', (chunk) => {
+                const s = chunk.toString();
+                stdout += s;
+                logStream?.write(`${JSON.stringify({ event: 'stdout', chunk: s, ts: Date.now() })}\n`);
+                // Parse complete lines as they arrive; emit events live.
+                lineBuf += s;
+                let idx;
+                while ((idx = lineBuf.indexOf('\n')) !== -1) {
+                    const line = lineBuf.slice(0, idx);
+                    lineBuf = lineBuf.slice(idx + 1);
+                    if (ctx.emitEvent)
+                        handleStreamLine(line, ctx.emitEvent, state);
+                }
+            });
+            child.stderr?.on('data', (chunk) => {
+                stderr += chunk.toString();
+                logStream?.write(`${JSON.stringify({ event: 'stderr', chunk: chunk.toString(), ts: Date.now() })}\n`);
+            });
+            const timeoutMs = node.idle_timeout ?? 0;
+            const killer = timeoutMs > 0
+                ? setTimeout(() => {
+                    try {
+                        child.kill('SIGTERM');
+                    }
+                    catch { /* ignore */ }
+                }, timeoutMs)
+                : null;
+            child.on('error', (err) => {
+                if (killer)
+                    clearTimeout(killer);
+                logStream?.end();
+                resolve({
+                    status: 'failed',
+                    error: `spawn error: ${err.message}`,
+                    transient: isTransient(err.message),
+                });
+            });
+            child.on('close', (code) => {
+                if (killer)
+                    clearTimeout(killer);
+                // Flush any trailing partial line.
+                if (lineBuf.trim() && ctx.emitEvent)
+                    handleStreamLine(lineBuf, ctx.emitEvent, state);
+                logStream?.end();
+                if (code !== 0) {
+                    const errMsg = (stderr || stdout || '').slice(0, 4000);
+                    resolve({
+                        status: 'failed',
+                        error: `claude exited with code ${code}: ${errMsg}`,
+                        transient: isTransient(errMsg),
+                    });
+                    return;
+                }
+                // Stream path: the terminal `result` is the node's output — identical
+                // to what `--output-format json` produced.
+                if (state.sawStream) {
+                    const text = state.resultText ?? state.assistantText ?? stdout;
+                    resolve({
+                        status: 'completed',
+                        output: { text, structured: state.resultText !== null ? { result: state.resultText } : undefined },
+                    });
+                    return;
+                }
+                // Fallback: output wasn't a parseable stream (e.g. a single JSON blob or
+                // plain text). Preserve the pre-stream behavior so a run never breaks.
+                let text = stdout;
+                let structured;
+                try {
+                    const parsed = JSON.parse(stdout);
+                    if (parsed && typeof parsed === 'object') {
+                        structured = parsed;
+                        if (typeof structured.result === 'string') {
+                            text = structured.result;
+                        }
+                        else if (Array.isArray(structured.content)) {
+                            text = structured.content.map((c) => c.text ?? '').join('');
+                        }
+                        else {
+                            text = stdout;
+                        }
+                    }
+                }
+                catch {
+                    // Not JSON — keep raw stdout as text.
+                }
+                resolve({ status: 'completed', output: { text, structured } });
+            });
+            // Send the prompt on stdin.
+            try {
+                child.stdin?.write(node.prompt);
+                child.stdin?.end();
+            }
+            catch (err) {
+                if (killer)
+                    clearTimeout(killer);
+                logStream?.end();
+                resolve({
+                    status: 'failed',
+                    error: `stdin write failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        });
+    }
+}
+exports.PromptRunner = PromptRunner;
+function isTransient(msg) {
+    return TRANSIENT_PATTERNS.some((p) => p.test(msg));
+}
+//# sourceMappingURL=prompt.js.map

package/dist/workflows/runners/prompt.js.map

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

package/dist/workflows/runners/script.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ScriptNode runner — executes a TypeScript/Python script via `bun` or `uv`.
+ *
+ * The script source is written to a temp file under
+ * `<artifactsDir>/scripts/<nodeId>.{ts,py}` and invoked by the chosen runtime.
+ * Optional `deps` are installed first (`bun install <pkg>` / `uv add <pkg>`).
+ *
+ * The runtime binary is resolved from `SPECSHIP_BUN_BIN` / `SPECSHIP_UV_BIN`
+ * env vars if set, else `bun` / `uv` on PATH.
+ */
+import { DagNode } from '../schemas/workflow';
+import { NodeRunner, NodeRunResult, RunnerContext } from './types';
+export declare class ScriptRunner implements NodeRunner {
+    readonly kind: "script";
+    run(rawNode: DagNode, ctx: RunnerContext): Promise<NodeRunResult>;
+}
+//# sourceMappingURL=script.d.ts.map

package/dist/workflows/runners/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../src/workflows/runners/script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,OAAO,EAAc,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAInE,qBAAa,YAAa,YAAW,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAqGxE"}

package/dist/workflows/runners/script.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * ScriptNode runner — executes a TypeScript/Python script via `bun` or `uv`.
+ *
+ * The script source is written to a temp file under
+ * `<artifactsDir>/scripts/<nodeId>.{ts,py}` and invoked by the chosen runtime.
+ * Optional `deps` are installed first (`bun install <pkg>` / `uv add <pkg>`).
+ *
+ * The runtime binary is resolved from `SPECSHIP_BUN_BIN` / `SPECSHIP_UV_BIN`
+ * env vars if set, else `bun` / `uv` on PATH.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScriptRunner = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_TIMEOUT_MS = 120_000;
+class ScriptRunner {
+    kind = 'script';
+    async run(rawNode, ctx) {
+        if (rawNode.kind !== 'script') {
+            return { status: 'failed', error: `ScriptRunner received ${rawNode.kind} node` };
+        }
+        const node = rawNode;
+        const cwd = node.cwd ?? ctx.cwd;
+        const timeout = node.timeout ?? DEFAULT_TIMEOUT_MS;
+        const env = { ...process.env, ...(node.env ?? {}) };
+        const bin = node.runtime === 'bun'
+            ? process.env.SPECSHIP_BUN_BIN ?? 'bun'
+            : process.env.SPECSHIP_UV_BIN ?? 'uv';
+        // Sanity-check the runtime exists before writing the script.
+        const which = (0, child_process_1.spawnSync)(bin, ['--version'], { encoding: 'utf-8', windowsHide: true });
+        if (which.status !== 0) {
+            return {
+                status: 'failed',
+                error: `${node.runtime} runtime not available (${bin} --version exited ${which.status})`,
+            };
+        }
+        // Write the script.
+        const ext = node.runtime === 'bun' ? 'ts' : 'py';
+        const scriptDir = path.join(ctx.artifactsDir, '..', 'scripts');
+        try {
+            fs.mkdirSync(scriptDir, { recursive: true });
+        }
+        catch { /* ignore */ }
+        const scriptPath = path.join(scriptDir, `${sanitizeFilename(node.id)}.${ext}`);
+        try {
+            fs.writeFileSync(scriptPath, node.script);
+        }
+        catch (err) {
+            return {
+                status: 'failed',
+                error: `failed to write script: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        // Install deps if declared.
+        if (node.deps && node.deps.length > 0) {
+            const installArgs = node.runtime === 'bun'
+                ? ['install', '--cwd', cwd, ...node.deps]
+                : ['add', ...node.deps];
+            const install = (0, child_process_1.spawnSync)(bin, installArgs, {
+                cwd,
+                env,
+                encoding: 'utf-8',
+                windowsHide: true,
+            });
+            if (install.status !== 0) {
+                return {
+                    status: 'failed',
+                    error: `dependency install failed: ${install.stderr?.slice(0, 2000) ?? 'unknown'}`,
+                };
+            }
+        }
+        const runArgs = node.runtime === 'bun' ? ['run', scriptPath] : ['run', scriptPath];
+        return new Promise((resolve) => {
+            const child = (0, child_process_1.spawn)(bin, runArgs, {
+                cwd,
+                env,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                windowsHide: true,
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', (c) => { stdout += c.toString(); });
+            child.stderr?.on('data', (c) => { stderr += c.toString(); });
+            const killer = setTimeout(() => {
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch { /* ignore */ }
+            }, timeout);
+            child.on('error', (err) => {
+                clearTimeout(killer);
+                resolve({ status: 'failed', error: `spawn error: ${err.message}` });
+            });
+            child.on('close', (code, signal) => {
+                clearTimeout(killer);
+                if (code === 0) {
+                    resolve({ status: 'completed', output: { text: stdout } });
+                    return;
+                }
+                if (signal === 'SIGTERM') {
+                    resolve({
+                        status: 'failed',
+                        error: `script node timed out after ${timeout}ms`,
+                        transient: true,
+                    });
+                    return;
+                }
+                resolve({
+                    status: 'failed',
+                    error: `script exited with code ${code}: ${(stderr || stdout).slice(0, 4000)}`,
+                });
+            });
+        });
+    }
+}
+exports.ScriptRunner = ScriptRunner;
+function sanitizeFilename(s) {
+    return s.replace(/[^a-zA-Z0-9._-]/g, '-').substring(0, 80);
+}
+//# sourceMappingURL=script.js.map

package/dist/workflows/runners/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../../src/workflows/runners/script.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAAiD;AACjD,uCAAyB;AACzB,2CAA6B;AAI7B,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC,MAAa,YAAY;IACd,IAAI,GAAG,QAAiB,CAAC;IAElC,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAE,GAAkB;QAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,yBAAyB,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;QACnF,CAAC;QACD,MAAM,IAAI,GAAG,OAAqB,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,kBAAkB,CAAC;QACnD,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QAEpD,MAAM,GAAG,GACP,IAAI,CAAC,OAAO,KAAK,KAAK;YACpB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK;YACvC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC;QAE1C,6DAA6D;QAC7D,MAAM,KAAK,GAAG,IAAA,yBAAS,EAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,2BAA2B,GAAG,qBAAqB,KAAK,CAAC,MAAM,GAAG;aACzF,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/D,IAAI,CAAC;YAAC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;aACrF,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK;gBACxC,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;gBACzC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAA,yBAAS,EAAC,GAAG,EAAE,WAAW,EAAE;gBAC1C,GAAG;gBACH,GAAG;gBACH,QAAQ,EAAE,OAAO;gBACjB,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,8BAA8B,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE;iBACnF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAEnF,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,GAAG,EAAE,OAAO,EAAE;gBAChC,GAAG;gBACH,GAAG;gBACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACrE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAErE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC7B,IAAI,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACvD,CAAC,EAAE,OAAO,CAAC,CAAC;YAEZ,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,YAAY,CAAC,MAAM,CAAC,CAAC;gBACrB,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBACjC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACrB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC3D,OAAO;gBACT,CAAC;gBACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,OAAO,CAAC;wBACN,MAAM,EAAE,QAAQ;wBAChB,KAAK,EAAE,+BAA+B,OAAO,IAAI;wBACjD,SAAS,EAAE,IAAI;qBAChB,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC;oBACN,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,2BAA2B,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;iBAC/E,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAxGD,oCAwGC;AAED,SAAS,gBAAgB,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/workflows/runners/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Node runner interface — one implementation per DagNode kind.
+ *
+ * Runners are pure functions over a RunnerContext + the typed node.
+ * They produce a NodeRunResult discriminated on outcome:
+ *   - 'completed' → success; emit `output` for downstream substitution
+ *   - 'failed'    → error message + (optional) `transient` flag for retry
+ *   - 'paused'    → approval gate; executor stops here, persists state
+ *   - 'cancelled' → CancelNode fired; executor terminates the whole run
+ */
+import { DagNode } from '../schemas/workflow';
+import { ApprovalContext, WorkflowEventType } from '../../types';
+import { NodeOutput } from '../condition-evaluator';
+export interface RunnerContext {
+    /** Working directory for shell/script nodes (worktree path when isolated). */
+    cwd: string;
+    /** Directory for artifact files (`<runRoot>/nodes/<id>.md`, etc.). */
+    artifactsDir: string;
+    /** Logs directory for verbose JSONL output. */
+    logsDir: string;
+    /** Workflow run ID (used as the per-node log filename prefix). */
+    runId: string;
+    /** Inputs and variables for `$INPUT.X` / `$VAR` substitution. */
+    inputs?: Record<string, string>;
+    variables?: Record<string, string>;
+    /** Outputs of completed upstream nodes (for `$nodeId.output` substitution). */
+    outputs: Map<string, NodeOutput>;
+    /** Verbose logging flag. */
+    verbose?: boolean;
+    /**
+     * Emit a workflow event mid-step — used by the agent runner to stream its
+     * live activity (tool calls, message turns) into the run view. No-op when
+     * unset. The executor stamps the step id/kind; callers pass type + data.
+     */
+    emitEvent?: (type: WorkflowEventType, data?: Record<string, unknown>) => void;
+}
+export type NodeRunResult = {
+    status: 'completed';
+    output: NodeOutput;
+} | {
+    status: 'failed';
+    error: string;
+    transient?: boolean;
+} | {
+    status: 'paused';
+    approval: ApprovalContext;
+} | {
+    status: 'cancelled';
+    reason: string;
+};
+export interface NodeRunner {
+    /** The node kinds this runner handles (one per file in practice). */
+    readonly kind: DagNode['kind'];
+    /** Execute the node and return a result. Should not throw — wrap errors in `{ status: 'failed' }`. */
+    run(node: DagNode, ctx: RunnerContext): Promise<NodeRunResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflows/runners/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflows/runners/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,+EAA+E;IAC/E,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC/E;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,sGAAsG;IACtG,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAChE"}

package/dist/workflows/runners/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Node runner interface — one implementation per DagNode kind.
+ *
+ * Runners are pure functions over a RunnerContext + the typed node.
+ * They produce a NodeRunResult discriminated on outcome:
+ *   - 'completed' → success; emit `output` for downstream substitution
+ *   - 'failed'    → error message + (optional) `transient` flag for retry
+ *   - 'paused'    → approval gate; executor stops here, persists state
+ *   - 'cancelled' → CancelNode fired; executor terminates the whole run
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/workflows/runners/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/workflows/runners/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}