@viewportai/daemon 0.1.0 → 0.2.1

package/dist/workflows/node-executor.js

@@ -0,0 +1,179 @@
+import { addEvent, renderTemplate, ShellNodeError } from './runtime-helpers.js';
+import { collectNodeArtifacts } from './artifact-collector.js';
+import { readPromptNodeOutput, readPromptNodeTranscriptExcerpt } from './prompt-output.js';
+import { classifyRetry } from './retry-classifier.js';
+import { NODE_EXECUTORS } from './node-registry.js';
+import { runWorkflowDaemonSession } from './daemon-session.js';
+import { appendInlineAgentResults, runInlineAgents } from './inline-agents.js';
+export async function executeWorkflowNode(context, run, nodeId, node) {
+    const state = run.nodes[nodeId];
+    if (!state)
+        return 'completed';
+    if (state.status === 'completed' || state.status === 'skipped')
+        return 'completed';
+    state.status = 'running';
+    state.startedAt = Date.now();
+    run.updatedAt = state.startedAt;
+    addEvent(run, 'node-started', `Node ${nodeId} started`, undefined, nodeId);
+    await context.saveAndEmit(run);
+    const maxAttempts = node.retry?.maxAttempts ?? 1;
+    const backoffMs = (node.retry?.backoffSeconds ?? 0) * 1000;
+    let attempt = 0;
+    let lastError = null;
+    while (attempt < maxAttempts) {
+        attempt += 1;
+        try {
+            // Look up the per-type executor in the registry. Built-ins are
+            // registered in `node-registry.ts`; the plugin loader will extend the
+            // same map with `defineNode()` registrations from
+            // `~/.viewport/plugins.json` once that integration ships.
+            const executor = NODE_EXECUTORS.get(node.type);
+            if (!executor) {
+                throw new Error(`No executor registered for node type '${node.type}' on node ${nodeId}.`);
+            }
+            const outcome = await executor(context, run, nodeId, node, {
+                executePromptNode,
+                executeGateNode,
+                blockForApproval,
+            });
+            if (outcome.result === 'blocked')
+                return 'blocked';
+            await collectAndRecordArtifacts(context, run, nodeId, node, outcome.artifactCwd ?? run.directoryPath);
+            state.status = 'completed';
+            state.completedAt = Date.now();
+            run.updatedAt = state.completedAt;
+            addEvent(run, 'node-completed', `Node ${nodeId} completed`, undefined, nodeId);
+            await context.saveAndEmit(run);
+            return 'completed';
+        }
+        catch (error) {
+            lastError = error;
+            const message = error instanceof Error ? error.message : String(error);
+            if (error instanceof ShellNodeError) {
+                state.output = error.output || state.output;
+                state.exitCode = error.exitCode ?? undefined;
+            }
+            const decision = classifyRetry(message, node.retry);
+            const remaining = maxAttempts - attempt;
+            if (decision === 'retry' && remaining > 0) {
+                addEvent(run, 'node-retry', `Node ${nodeId} retry ${attempt + 1}/${maxAttempts}: ${message}`, { attempt, message, backoffMs }, nodeId);
+                run.updatedAt = Date.now();
+                await context.saveAndEmit(run);
+                if (backoffMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                continue;
+            }
+            break;
+        }
+    }
+    const message = lastError instanceof Error ? lastError.message : String(lastError);
+    state.status = 'failed';
+    state.error = message;
+    state.completedAt = Date.now();
+    state.attempts = attempt;
+    run.updatedAt = state.completedAt;
+    addEvent(run, 'node-failed', `Node ${nodeId} failed: ${message}`, { attempts: attempt }, nodeId);
+    await context.saveAndEmit(run);
+    throw lastError instanceof Error ? lastError : new Error(message);
+}
+async function executeGateNode(context, run, nodeId, node) {
+    const gate = node.gate;
+    if (gate.type === 'human_review') {
+        await blockForApproval(context, run, nodeId, await renderTemplate(gate.prompt, run));
+        addEvent(run, 'gate-blocked', `Human review gate ${nodeId} is waiting`, { gate }, nodeId);
+        await context.saveAndEmit(run);
+        return 'blocked';
+    }
+    if (gate.type === 'schedule') {
+        const waitUntil = new Date(await renderTemplate(gate.waitUntil, run));
+        if (!Number.isFinite(waitUntil.getTime())) {
+            throw new Error(`Schedule gate ${nodeId} has an invalid waitUntil value`);
+        }
+        if (waitUntil.getTime() > Date.now()) {
+            const state = run.nodes[nodeId];
+            if (state) {
+                state.status = 'blocked';
+                state.output = `Waiting until ${waitUntil.toISOString()}`;
+            }
+            run.status = 'blocked';
+            run.updatedAt = Date.now();
+            addEvent(run, 'gate-blocked', `Schedule gate ${nodeId} is waiting until ${waitUntil.toISOString()}`, { gate, waitUntil: waitUntil.toISOString() }, nodeId);
+            await context.saveAndEmit(run);
+            return 'blocked';
+        }
+        setGateOutput(run, nodeId, `Schedule reached: ${waitUntil.toISOString()}`);
+        addEvent(run, 'gate-passed', `Schedule gate ${nodeId} passed`, { gate, waitUntil: waitUntil.toISOString() }, nodeId);
+        return 'completed';
+    }
+    const rendered = await renderTemplate(gate.expression, run);
+    if (!isTruthyGateValue(rendered)) {
+        throw new Error(`${gate.type} gate ${nodeId} failed: ${rendered || 'false'}`);
+    }
+    setGateOutput(run, nodeId, rendered);
+    addEvent(run, 'gate-passed', `${gate.type} gate ${nodeId} passed`, { gate, result: rendered }, nodeId);
+    return 'completed';
+}
+function setGateOutput(run, nodeId, output) {
+    const state = run.nodes[nodeId];
+    if (state)
+        state.output = output;
+}
+function isTruthyGateValue(value) {
+    const normalized = value.trim().toLowerCase();
+    return ['true', '1', 'yes', 'y', 'pass', 'passed', 'ok'].includes(normalized);
+}
+async function collectAndRecordArtifacts(context, run, nodeId, node, cwd) {
+    if (!node.artifacts || Object.keys(node.artifacts).length === 0)
+        return;
+    const result = await collectNodeArtifacts(run, nodeId, node, cwd);
+    for (const artifact of result.artifacts) {
+        run.artifacts ??= [];
+        run.artifacts = run.artifacts.filter((existing) => existing.nodeId !== artifact.nodeId || existing.name !== artifact.name);
+        run.artifacts.push(artifact);
+        addEvent(run, 'artifact-collected', `Node ${nodeId} collected artifact ${artifact.name}`, { artifact }, nodeId);
+    }
+    for (const missing of result.missing) {
+        addEvent(run, 'artifact-missing', `Node ${nodeId} did not collect artifact ${missing.name}: ${missing.reason}`, missing, nodeId);
+    }
+    if (result.artifacts.length > 0 || result.missing.length > 0) {
+        run.updatedAt = Date.now();
+        await context.saveAndEmit(run);
+    }
+}
+async function executePromptNode(context, run, nodeId, node) {
+    const state = run.nodes[nodeId];
+    if (!state)
+        return;
+    const inlineAgents = await runInlineAgents(context, run, nodeId, node);
+    await runWorkflowDaemonSession(context, {
+        run,
+        nodeId,
+        target: state,
+        prompt: appendInlineAgentResults(await renderTemplate(node.prompt, run), inlineAgents),
+        ...(node.agent ? { agent: node.agent } : {}),
+        ...(node.model ? { model: node.model } : {}),
+        ...(node.hooks ? { hooks: node.hooks } : {}),
+        ...(node.timeoutSeconds ? { timeoutSeconds: node.timeoutSeconds } : {}),
+        outputFallback: () => readPromptNodeOutput(run, state),
+        outputData: async () => {
+            const transcriptExcerpt = await readPromptNodeTranscriptExcerpt(run, state);
+            return transcriptExcerpt.length > 0 ? { transcriptExcerpt } : {};
+        },
+    });
+}
+async function blockForApproval(context, run, nodeId, prompt) {
+    const state = run.nodes[nodeId];
+    if (!state)
+        return;
+    state.status = 'blocked';
+    state.approval = {
+        prompt,
+        requestedAt: Date.now(),
+    };
+    run.status = 'blocked';
+    run.updatedAt = state.approval.requestedAt;
+    addEvent(run, 'approval-requested', `Approval requested for node ${nodeId}`, { prompt }, nodeId);
+    addEvent(run, 'run-blocked', `Workflow blocked by approval gate: ${nodeId}`, undefined, nodeId);
+    await context.saveAndEmit(run);
+}
+//# sourceMappingURL=node-executor.js.map

package/dist/workflows/node-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-executor.js","sourceRoot":"","sources":["../../src/workflows/node-executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAW/E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAoC,EACpC,GAAsB,EACtB,MAAc,EACd,IAAkB;IAElB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,WAAW,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAEnF,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,MAAM,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3E,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAE/B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAS,GAAY,IAAI,CAAC;IAE9B,OAAO,OAAO,GAAG,WAAW,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,CAAC;QACb,IAAI,CAAC;YACH,+DAA+D;YAC/D,sEAAsE;YACtE,kDAAkD;YAClD,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,CAAC,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC;YAC5F,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;gBACzD,iBAAiB;gBACjB,eAAe;gBACf,gBAAgB;aACjB,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAEnD,MAAM,yBAAyB,CAC7B,OAAO,EACP,GAAG,EACH,MAAM,EACN,IAAI,EACJ,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC,aAAa,CACzC,CAAC;YAEF,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;YAC3B,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC;YAClC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,MAAM,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YAC/E,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;gBACpC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;gBAC5C,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC;YAC/C,CAAC;YACD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACpD,MAAM,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;YACxC,IAAI,QAAQ,KAAK,OAAO,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC1C,QAAQ,CACN,GAAG,EACH,YAAY,EACZ,QAAQ,MAAM,UAAU,OAAO,GAAG,CAAC,IAAI,WAAW,KAAK,OAAO,EAAE,EAChE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAC/B,MAAM,CACP,CAAC;gBACF,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3B,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC/B,IAAI,SAAS,GAAG,CAAC;oBAAE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;gBAClF,SAAS;YACX,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnF,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;IACxB,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IACzB,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,MAAM,YAAY,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IACjG,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,OAAoC,EACpC,GAAsB,EACtB,MAAc,EACd,IAA6C;IAE7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACjC,MAAM,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACrF,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,qBAAqB,MAAM,aAAa,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1F,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,iCAAiC,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;gBACzB,KAAK,CAAC,MAAM,GAAG,iBAAiB,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;YAC5D,CAAC;YACD,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;YACvB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,QAAQ,CACN,GAAG,EACH,cAAc,EACd,iBAAiB,MAAM,qBAAqB,SAAS,CAAC,WAAW,EAAE,EAAE,EACrE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE,EAAE,EAC5C,MAAM,CACP,CAAC;YACF,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,qBAAqB,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC3E,QAAQ,CACN,GAAG,EACH,aAAa,EACb,iBAAiB,MAAM,SAAS,EAChC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE,EAAE,EAC5C,MAAM,CACP,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC5D,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,SAAS,MAAM,YAAY,QAAQ,IAAI,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,QAAQ,CACN,GAAG,EACH,aAAa,EACb,GAAG,IAAI,CAAC,IAAI,SAAS,MAAM,SAAS,EACpC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAC1B,MAAM,CACP,CAAC;IACF,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,aAAa,CAAC,GAAsB,EAAE,MAAc,EAAE,MAAc;IAC3E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,KAAK;QAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,OAAoC,EACpC,GAAsB,EACtB,MAAc,EACd,IAAkB,EAClB,GAAW;IAEX,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACxE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAClE,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,GAAG,CAAC,SAAS,KAAK,EAAE,CAAC;QACrB,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,CAClC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CACrF,CAAC;QACF,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,QAAQ,CACN,GAAG,EACH,oBAAoB,EACpB,QAAQ,MAAM,uBAAuB,QAAQ,CAAC,IAAI,EAAE,EACpD,EAAE,QAAQ,EAAE,EACZ,MAAM,CACP,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACrC,QAAQ,CACN,GAAG,EACH,kBAAkB,EAClB,QAAQ,MAAM,6BAA6B,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,EAC5E,OAAO,EACP,MAAM,CACP,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,OAAoC,EACpC,GAAsB,EACtB,MAAc,EACd,IAA+C;IAE/C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAEvE,MAAM,wBAAwB,CAAC,OAAO,EAAE;QACtC,GAAG;QACH,MAAM;QACN,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,wBAAwB,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,CAAC;QACtF,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,cAAc,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC;QACtD,UAAU,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,iBAAiB,GAAG,MAAM,+BAA+B,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5E,OAAO,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,OAAoC,EACpC,GAAsB,EACtB,MAAc,EACd,MAAc;IAEd,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,QAAQ,GAAG;QACf,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;KACxB,CAAC;IACF,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;IACvB,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC3C,QAAQ,CAAC,GAAG,EAAE,oBAAoB,EAAE,+BAA+B,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACjG,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,sCAAsC,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAChG,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/dist/workflows/node-registry.d.ts

@@ -0,0 +1,42 @@
+import type { WorkflowNodeExecutorContext } from './node-executor.js';
+import type { WorkflowNode, WorkflowRunRecord } from './types.js';
+/**
+ * Outcome of a per-type executor handler. The orchestrator in
+ * `executeWorkflowNode` reads this to decide whether to record artifacts and
+ * mark the node complete, or to leave the run in a blocked state waiting on
+ * an external event.
+ */
+export interface NodeExecutorOutcome {
+    /** 'completed' lets the orchestrator finish bookkeeping; 'blocked' returns early. */
+    result: 'completed' | 'blocked';
+    /**
+     * Working directory used for artifact collection. Defaults to the run's
+     * directory; shell nodes override based on their `cwd` field.
+     */
+    artifactCwd?: string;
+}
+export type BuiltinNodeExecutor = (context: WorkflowNodeExecutorContext, run: WorkflowRunRecord, nodeId: string, node: WorkflowNode, helpers: BuiltinExecutorHelpers) => Promise<NodeExecutorOutcome>;
+/**
+ * Helpers the orchestrator hands every executor. Plugins (Phase 5) will
+ * receive an analogous, more constrained surface so they cannot mutate the
+ * run record directly.
+ */
+export interface BuiltinExecutorHelpers {
+    executePromptNode: (context: WorkflowNodeExecutorContext, run: WorkflowRunRecord, nodeId: string, node: Extract<WorkflowNode, {
+        type: 'prompt';
+    }>) => Promise<void>;
+    executeGateNode: (context: WorkflowNodeExecutorContext, run: WorkflowRunRecord, nodeId: string, node: Extract<WorkflowNode, {
+        type: 'gate';
+    }>) => Promise<'completed' | 'blocked'>;
+    blockForApproval: (context: WorkflowNodeExecutorContext, run: WorkflowRunRecord, nodeId: string, prompt: string) => Promise<void>;
+}
+/**
+ * Mutable registry of node executors keyed by `node.type`. Built-ins are
+ * registered at module load (immediately below); the plugin loader extends
+ * this map at daemon boot with `defineNode()` entries from
+ * `~/.viewport/plugins.json`. Keep this table-driven so adding a node type
+ * is one entry, not five files.
+ */
+export declare const NODE_EXECUTORS: Map<string, BuiltinNodeExecutor>;
+export declare function registerNodeExecutor(type: string, executor: BuiltinNodeExecutor): void;
+//# sourceMappingURL=node-registry.d.ts.map

package/dist/workflows/node-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-registry.d.ts","sourceRoot":"","sources":["../../src/workflows/node-registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGlE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,sBAAsB,KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,CACjB,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,KAC5C,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,eAAe,EAAE,CACf,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,KAC1C,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACtC,gBAAgB,EAAE,CAChB,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,kCAAyC,CAAC;AAErE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAEtF"}

package/dist/workflows/node-registry.js

@@ -0,0 +1,124 @@
+import { executeLoopNode } from './loop-executor.js';
+import { addEvent, renderOptionalTemplate, renderTemplate, resolveNodeCwd, runShellNode, } from './runtime-helpers.js';
+import { executeSubflowNode } from './subflow-executor.js';
+import { sanitizePlanProposalMetadata } from '../hooks/plan-extractor.js';
+/**
+ * Mutable registry of node executors keyed by `node.type`. Built-ins are
+ * registered at module load (immediately below); the plugin loader extends
+ * this map at daemon boot with `defineNode()` entries from
+ * `~/.viewport/plugins.json`. Keep this table-driven so adding a node type
+ * is one entry, not five files.
+ */
+export const NODE_EXECUTORS = new Map();
+export function registerNodeExecutor(type, executor) {
+    NODE_EXECUTORS.set(type, executor);
+}
+const BUILTIN_NODE_EXECUTORS = {
+    shell: async (context, run, nodeId, node) => {
+        if (node.type !== 'shell')
+            return { result: 'completed' };
+        const state = run.nodes[nodeId];
+        const artifactCwd = resolveNodeCwd(run.directoryPath, await renderOptionalTemplate(node.cwd, run));
+        const abort = context.shellAbortRegistry.create(run.id, `node:${nodeId}`);
+        let result;
+        try {
+            result = await runShellNode(await renderTemplate(node.command, run), {
+                cwd: artifactCwd,
+                timeoutSeconds: node.timeoutSeconds,
+                signal: abort.signal,
+                onOutput: ({ source, chunk, output }) => {
+                    addEvent(run, 'node-log', `Node ${nodeId} wrote ${source}`, { source, chunk, output }, nodeId);
+                    run.updatedAt = Date.now();
+                    void context.saveAndEmit(run);
+                },
+            });
+        }
+        finally {
+            abort.dispose();
+        }
+        if (state) {
+            state.output = result.output;
+            state.exitCode = result.exitCode;
+        }
+        addEvent(run, 'node-output', `Node ${nodeId} produced shell output`, { output: result.output, exitCode: result.exitCode }, nodeId);
+        return { result: 'completed', artifactCwd };
+    },
+    prompt: async (context, run, nodeId, node, helpers) => {
+        if (node.type !== 'prompt')
+            return { result: 'completed' };
+        await helpers.executePromptNode(context, run, nodeId, node);
+        return { result: 'completed' };
+    },
+    approval: async (context, run, nodeId, node, helpers) => {
+        if (node.type !== 'approval')
+            return { result: 'completed' };
+        await helpers.blockForApproval(context, run, nodeId, await renderTemplate(node.prompt, run));
+        return { result: 'blocked' };
+    },
+    gate: async (context, run, nodeId, node, helpers) => {
+        if (node.type !== 'gate')
+            return { result: 'completed' };
+        const gateResult = await helpers.executeGateNode(context, run, nodeId, node);
+        return { result: gateResult };
+    },
+    loop: async (context, run, nodeId, node) => {
+        if (node.type !== 'loop')
+            return { result: 'completed' };
+        await executeLoopNode(context, run, nodeId, node);
+        return { result: 'completed' };
+    },
+    subflow: async (context, run, nodeId, node) => {
+        if (node.type !== 'subflow')
+            return { result: 'completed' };
+        await executeSubflowNode(context, run, nodeId, node);
+        return { result: 'completed' };
+    },
+    plan: async (context, run, nodeId, node, helpers) => {
+        if (node.type !== 'plan')
+            return { result: 'completed' };
+        const state = run.nodes[nodeId];
+        const title = await renderTemplate(node.title, run);
+        const body = await renderTemplate(node.body, run);
+        const summary = await renderOptionalTemplate(node.summary, run);
+        const sourceRef = await renderOptionalTemplate(node.sourceRef, run);
+        if (state) {
+            state.output = body;
+            state.metadata = {
+                ...(state.metadata ?? {}),
+                plan: {
+                    title,
+                    summary,
+                    body,
+                    source: node.source ?? 'workflow',
+                    sourceRef: sourceRef || `viewport://workflow-runs/${run.id}/nodes/${nodeId}`,
+                },
+            };
+        }
+        context.daemon.emit('hook:plan-proposed', {
+            sessionId: `${run.id}:${nodeId}`,
+            adapter: 'viewport-workflow',
+            cwd: run.directoryPath,
+            title,
+            summary,
+            body,
+            source: node.source ?? 'workflow',
+            sourceRef: sourceRef || `viewport://workflow-runs/${run.id}/nodes/${nodeId}`,
+            metadata: sanitizePlanProposalMetadata({
+                workflowRunId: run.id,
+                workflowNodeId: nodeId,
+                resourceId: run.resourceId ?? null,
+            }),
+        });
+        addEvent(run, 'plan-proposed', `Plan node ${nodeId} proposed ${title}`, { title, summary, sourceRef: sourceRef || null }, nodeId);
+        if (node.waitForApproval === false) {
+            return { result: 'completed' };
+        }
+        await helpers.blockForApproval(context, run, nodeId, `Approve plan: ${title}`);
+        return { result: 'blocked' };
+    },
+};
+// Seed the mutable registry with built-ins. Plugin entries register at boot.
+for (const [type, executor] of Object.entries(BUILTIN_NODE_EXECUTORS)) {
+    NODE_EXECUTORS.set(type, executor);
+}
+//# sourceMappingURL=node-registry.js.map

package/dist/workflows/node-registry.js.map

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

package/dist/workflows/parser.d.ts

@@ -0,0 +1,17 @@
+import { WORKFLOW_SCHEMA_VERSION } from './workflow-schema.js';
+import type { ParsedWorkflow, WorkflowDefinition } from './types.js';
+export { WORKFLOW_SCHEMA_VERSION };
+export interface WorkflowValidationIssue {
+    path: string;
+    message: string;
+}
+export interface WorkflowValidationResult {
+    ok: boolean;
+    workflow?: ParsedWorkflow;
+    issues: WorkflowValidationIssue[];
+}
+export declare function parseWorkflowFile(filePath: string): Promise<ParsedWorkflow>;
+export declare function validateWorkflowText(sourceText: string, sourcePath: string): WorkflowValidationResult;
+export declare function parseWorkflow(sourceText: string, sourcePath: string): ParsedWorkflow;
+export declare function workflowNodeOrder(definition: WorkflowDefinition): string[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/workflows/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/workflows/parser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAA4B,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAIjF;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAY1B;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CA4BpF;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAwB1E"}

package/dist/workflows/parser.js

@@ -0,0 +1,250 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import YAML from 'yaml';
+import { WORKFLOW_SCHEMA_VERSION, WorkflowDefinitionSchema } from './workflow-schema.js';
+export { WORKFLOW_SCHEMA_VERSION };
+export async function parseWorkflowFile(filePath) {
+    const sourcePath = path.resolve(filePath);
+    const sourceText = await fs.readFile(sourcePath, 'utf-8');
+    return parseWorkflow(sourceText, sourcePath);
+}
+export function validateWorkflowText(sourceText, sourcePath) {
+    try {
+        const workflow = parseWorkflow(sourceText, sourcePath);
+        return { ok: true, workflow, issues: [] };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            issues: [
+                { path: sourcePath, message: error instanceof Error ? error.message : String(error) },
+            ],
+        };
+    }
+}
+export function parseWorkflow(sourceText, sourcePath) {
+    let raw;
+    try {
+        raw = YAML.parse(sourceText);
+    }
+    catch (error) {
+        throw new Error(`Invalid workflow YAML: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const parsed = WorkflowDefinitionSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issue = parsed.error.issues[0];
+        const issuePath = issue?.path.join('.') || '<root>';
+        throw new Error(`Invalid workflow at ${issuePath}: ${issue?.message ?? 'schema mismatch'}`);
+    }
+    validateWorkflowGraph(parsed.data);
+    const normalizedJson = stableJson(parsed.data);
+    const digest = crypto.createHash('sha256').update(normalizedJson).digest('hex');
+    return {
+        definition: parsed.data,
+        digest,
+        sourcePath: path.resolve(sourcePath),
+        sourceText,
+        normalizedJson,
+    };
+}
+export function workflowNodeOrder(definition) {
+    const pending = new Set(Object.keys(definition.nodes));
+    const complete = new Set();
+    const ordered = [];
+    while (pending.size > 0) {
+        const ready = [...pending].filter((nodeId) => {
+            const needs = definition.nodes[nodeId]?.needs ?? [];
+            return needs.every((dependency) => complete.has(dependency));
+        });
+        if (ready.length === 0) {
+            throw new Error('Workflow contains a dependency cycle');
+        }
+        ready.sort((a, b) => a.localeCompare(b));
+        for (const nodeId of ready) {
+            pending.delete(nodeId);
+            complete.add(nodeId);
+            ordered.push(nodeId);
+        }
+    }
+    return ordered;
+}
+function validateWorkflowGraph(definition) {
+    const nodeIds = new Set(Object.keys(definition.nodes));
+    if (nodeIds.size === 0) {
+        throw new Error('Workflow must define at least one node');
+    }
+    for (const [nodeId, node] of Object.entries(definition.nodes)) {
+        if (!/^[a-zA-Z0-9._/-]+$/.test(nodeId)) {
+            throw new Error(`Invalid workflow node id: ${nodeId}`);
+        }
+        for (const dependency of node.needs ?? []) {
+            if (!nodeIds.has(dependency)) {
+                throw new Error(`Workflow node ${nodeId} depends on missing node ${dependency}`);
+            }
+        }
+    }
+    workflowNodeOrder(definition);
+    validateTemplateReferences(definition);
+}
+function validateTemplateReferences(definition) {
+    for (const [nodeId, node] of Object.entries(definition.nodes)) {
+        const templates = nodeTemplates(node);
+        if (templates.length === 0)
+            continue;
+        const dependencies = transitiveDependencies(definition, nodeId);
+        for (const template of templates) {
+            for (const reference of nodeReferences(template)) {
+                if (!definition.nodes[reference.nodeId]) {
+                    throw new Error(`Workflow node ${nodeId} references missing node ${reference.nodeId}`);
+                }
+                if (!dependencies.has(reference.nodeId)) {
+                    throw new Error(`Workflow node ${nodeId} references ${reference.nodeId} output but does not depend on it`);
+                }
+                if (reference.kind === 'output') {
+                    const upstream = definition.nodes[reference.nodeId];
+                    if (!upstream?.outputs?.[declaredReferenceName(reference.name, upstream.outputs)]) {
+                        throw new Error(`Workflow node ${nodeId} references undeclared output ${reference.nodeId}.${reference.name}`);
+                    }
+                }
+                if (reference.kind === 'artifact') {
+                    const upstream = definition.nodes[reference.nodeId];
+                    if (!upstream?.artifacts?.[declaredReferenceName(reference.name, upstream.artifacts)]) {
+                        throw new Error(`Workflow node ${nodeId} references undeclared artifact ${reference.nodeId}.${reference.name}`);
+                    }
+                }
+            }
+        }
+    }
+}
+function nodeTemplates(node) {
+    if (node.type === 'prompt') {
+        return [node.prompt, ...Object.values(node.agents ?? {}).map((agent) => agent.prompt)];
+    }
+    if (node.type === 'shell')
+        return [node.command, node.cwd].filter((value) => typeof value === 'string');
+    if (node.type === 'approval') {
+        const templates = [node.prompt];
+        if (node.onReject) {
+            if ('command' in node.onReject) {
+                templates.push(node.onReject.command);
+                if (node.onReject.cwd)
+                    templates.push(node.onReject.cwd);
+            }
+            else {
+                templates.push(node.onReject.prompt);
+            }
+        }
+        return templates;
+    }
+    if (node.type === 'gate') {
+        if (node.gate.type === 'check' || node.gate.type === 'policy')
+            return [node.gate.expression];
+        if (node.gate.type === 'human_review')
+            return [node.gate.prompt];
+        return [node.gate.waitUntil];
+    }
+    if (node.type === 'loop') {
+        const templates = [];
+        if (node.foreach)
+            templates.push(node.foreach);
+        if (node.while)
+            templates.push(node.while);
+        if (node.until)
+            templates.push(node.until);
+        if (node.body.type === 'shell') {
+            templates.push(node.body.command);
+            if (node.body.cwd)
+                templates.push(node.body.cwd);
+        }
+        else {
+            templates.push(node.body.prompt);
+        }
+        return templates;
+    }
+    if (node.type === 'subflow') {
+        const templates = [];
+        for (const value of Object.values(node.inputs ?? {})) {
+            templates.push(value);
+        }
+        // Child node templates reference *child* node ids, not parent ids — they
+        // resolve in a separate scope, so we don't validate their refs against
+        // the parent dependency graph here. The runner enforces child references
+        // at execution time.
+        return templates;
+    }
+    return [];
+}
+function nodeReferences(template) {
+    const references = new Map();
+    const rawPatterns = [
+        /\{\{\s*nodes\.([A-Za-z0-9._/-]+)\.(?:output|status|sessionId|error)\s*\}\}/g,
+        /\{\{\s*outputs\.([A-Za-z0-9._/-]+)\s*\}\}/g,
+    ];
+    for (const pattern of rawPatterns) {
+        for (const match of template.matchAll(pattern)) {
+            if (match[1])
+                references.set(`raw:${match[1]}`, { kind: 'raw', nodeId: match[1] });
+        }
+    }
+    const namedPatterns = [
+        [/\{\{\s*nodes\.([A-Za-z0-9._/-]+)\.outputs\.([A-Za-z0-9._/-]+)\s*\}\}/g, 'output'],
+        [/\{\{\s*nodes\.([A-Za-z0-9._/-]+)\.artifacts\.([A-Za-z0-9._/-]+)\s*\}\}/g, 'artifact'],
+        [/\{\{\s*artifacts\.([A-Za-z0-9._/-]+)\.([A-Za-z0-9._/-]+)\s*\}\}/g, 'artifact'],
+    ];
+    for (const [pattern, kind] of namedPatterns) {
+        for (const match of template.matchAll(pattern)) {
+            if (!match[1] || !match[2])
+                continue;
+            if (kind === 'output') {
+                references.set(`output:${match[1]}:${match[2]}`, {
+                    kind: 'output',
+                    nodeId: match[1],
+                    name: match[2],
+                });
+            }
+            else {
+                references.set(`artifact:${match[1]}:${match[2]}`, {
+                    kind: 'artifact',
+                    nodeId: match[1],
+                    name: match[2],
+                });
+            }
+        }
+    }
+    return [...references.values()];
+}
+function declaredReferenceName(referenceName, declared) {
+    if (!declared)
+        return referenceName;
+    if (Object.hasOwn(declared, referenceName))
+        return referenceName;
+    return referenceName.split('.')[0] ?? referenceName;
+}
+function transitiveDependencies(definition, nodeId) {
+    const result = new Set();
+    const visit = (current) => {
+        const node = definition.nodes[current];
+        for (const dependency of node?.needs ?? []) {
+            if (result.has(dependency))
+                continue;
+            result.add(dependency);
+            visit(dependency);
+        }
+    };
+    visit(nodeId);
+    return result;
+}
+function stableJson(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableJson(item)).join(',')}]`;
+    }
+    if (value && typeof value === 'object') {
+        const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+        return `{${entries
+            .map(([key, entryValue]) => `${JSON.stringify(key)}:${stableJson(entryValue)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=parser.js.map