@viewportai/daemon 0.2.0 → 0.2.1

package/dist/workflows/store.js

@@ -0,0 +1,160 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { configDir } from '../core/config.js';
+export class WorkflowRunStore {
+    rootDir;
+    saveQueues = new Map();
+    constructor(rootDir = path.join(configDir(), 'runs', 'workflows')) {
+        this.rootDir = rootDir;
+    }
+    async save(run) {
+        const snapshot = JSON.parse(JSON.stringify(run));
+        const previous = this.saveQueues.get(run.id) ?? Promise.resolve();
+        const next = previous.catch(() => undefined).then(() => this.writeRun(run.id, snapshot));
+        this.saveQueues.set(run.id, next);
+        try {
+            await next;
+        }
+        finally {
+            if (this.saveQueues.get(run.id) === next) {
+                this.saveQueues.delete(run.id);
+            }
+        }
+    }
+    async writeRun(runId, snapshot) {
+        await fs.mkdir(this.rootDir, { recursive: true });
+        const finalPath = this.runPath(runId);
+        const tempPath = path.join(this.rootDir, `.${runId}.${process.pid}.${Date.now()}.${crypto.randomUUID()}.tmp`);
+        const merged = await this.mergeExistingRun(snapshot);
+        await fs.writeFile(tempPath, `${JSON.stringify(merged, null, 2)}\n`, {
+            encoding: 'utf-8',
+            mode: 0o600,
+        });
+        await fs.rename(tempPath, finalPath);
+    }
+    async mergeExistingRun(snapshot) {
+        const existing = await this.get(snapshot.id);
+        if (!existing)
+            return snapshot;
+        const events = new Map(snapshot.events.map((event) => [event.id, event]));
+        for (const event of existing.events) {
+            if (!events.has(event.id))
+                events.set(event.id, event);
+        }
+        const nodes = mergeExistingTerminalNodes(snapshot.nodes, existing.nodes);
+        return {
+            ...snapshot,
+            nodes,
+            ...mergeExistingTerminalRun(snapshot, existing),
+            events: [...events.values()].sort((a, b) => a.timestamp - b.timestamp),
+            startedAt: mergeStartedAt(snapshot.startedAt, existing.startedAt),
+            updatedAt: Math.max(snapshot.updatedAt, existing.updatedAt),
+        };
+    }
+    async appendEvent(runId, event) {
+        const run = await this.get(runId);
+        if (!run) {
+            throw new Error(`Workflow run not found: ${runId}`);
+        }
+        run.events.push(event);
+        run.updatedAt = event.timestamp;
+        await this.save(run);
+        return run;
+    }
+    async get(runId) {
+        try {
+            const raw = await fs.readFile(this.runPath(runId), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async list(limit = 50) {
+        try {
+            const entries = await fs.readdir(this.rootDir);
+            const runs = await Promise.all(entries
+                .filter((name) => name.endsWith('.json'))
+                .map(async (name) => {
+                const raw = await fs.readFile(path.join(this.rootDir, name), 'utf-8');
+                return JSON.parse(raw);
+            }));
+            return runs.sort((a, b) => b.createdAt - a.createdAt).slice(0, limit);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    runPath(runId) {
+        return path.join(this.rootDir, `${runId}.json`);
+    }
+}
+function mergeExistingTerminalNodes(snapshot, existing) {
+    const nodes = { ...snapshot };
+    for (const [nodeId, existingNode] of Object.entries(existing)) {
+        const snapshotNode = nodes[nodeId];
+        if (!snapshotNode) {
+            nodes[nodeId] = existingNode;
+            continue;
+        }
+        if (shouldPreserveExistingNode(snapshotNode, existingNode)) {
+            nodes[nodeId] = existingNode;
+        }
+    }
+    return nodes;
+}
+function shouldPreserveExistingNode(snapshotNode, existingNode) {
+    if (!isTerminalNodeStatus(existingNode.status))
+        return false;
+    if (existingNode.status === 'canceled' && snapshotNode.status !== 'canceled')
+        return true;
+    if (!isTerminalNodeStatus(snapshotNode.status))
+        return true;
+    return (existingNode.completedAt ?? 0) > (snapshotNode.completedAt ?? 0);
+}
+function mergeExistingTerminalRun(snapshot, existing) {
+    if (!isTerminalRunStatus(existing.status))
+        return {};
+    if (existing.status === 'canceled' && snapshot.status !== 'canceled') {
+        return {
+            status: existing.status,
+            completedAt: existing.completedAt,
+            error: existing.error,
+        };
+    }
+    if (isTerminalRunStatus(snapshot.status)) {
+        return (existing.completedAt ?? 0) > (snapshot.completedAt ?? 0)
+            ? {
+                status: existing.status,
+                completedAt: existing.completedAt,
+                error: existing.error,
+            }
+            : {};
+    }
+    return {
+        status: existing.status,
+        completedAt: existing.completedAt,
+        error: existing.error,
+    };
+}
+function isTerminalNodeStatus(status) {
+    return (status === 'completed' || status === 'failed' || status === 'skipped' || status === 'canceled');
+}
+function isTerminalRunStatus(status) {
+    return status === 'completed' || status === 'failed' || status === 'canceled';
+}
+function mergeStartedAt(snapshotStartedAt, existingStartedAt) {
+    if (snapshotStartedAt === undefined)
+        return existingStartedAt;
+    if (existingStartedAt === undefined)
+        return snapshotStartedAt;
+    return Math.min(snapshotStartedAt, existingStartedAt);
+}
+//# sourceMappingURL=store.js.map

package/dist/workflows/store.js.map

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

package/dist/workflows/structured-outputs.d.ts

@@ -0,0 +1,19 @@
+import type { WorkflowNode, WorkflowNodeRunState } from './types.js';
+/**
+ * After a node finishes running, populate `state.outputs` based on the node's
+ * declared output schema and the captured `state.output` text.
+ *
+ * Each output can optionally declare `extract: <jsonata>`. Extractors evaluate
+ * against `{ output, json }`, where `output` is the bulk text and `json` is the
+ * parsed bulk output when valid. Without `extract`, the whole bulk text is used.
+ *
+ * Coercion rules per declared `type`:
+ *   - `string` → strings passthrough; objects/arrays stringify as JSON.
+ *   - `json` → extracted values passthrough; otherwise JSON.parse on text.
+ *   - `number` → Number(text); NaN becomes null.
+ *   - `boolean` → loose-truthy parse (`true`, `1`, `yes`, `pass`).
+ *   - `file` / `artifact` → the path the node declared, if any. The artifact
+ *     collector will populate `run.artifacts` for the actual file content.
+ */
+export declare function captureNodeStructuredOutputs(state: WorkflowNodeRunState, node: WorkflowNode): Promise<void>;
+//# sourceMappingURL=structured-outputs.d.ts.map

package/dist/workflows/structured-outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-outputs.d.ts","sourceRoot":"","sources":["../../src/workflows/structured-outputs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAA4B,MAAM,YAAY,CAAC;AAE/F;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/workflows/structured-outputs.js

@@ -0,0 +1,95 @@
+import jsonata from 'jsonata';
+/**
+ * After a node finishes running, populate `state.outputs` based on the node's
+ * declared output schema and the captured `state.output` text.
+ *
+ * Each output can optionally declare `extract: <jsonata>`. Extractors evaluate
+ * against `{ output, json }`, where `output` is the bulk text and `json` is the
+ * parsed bulk output when valid. Without `extract`, the whole bulk text is used.
+ *
+ * Coercion rules per declared `type`:
+ *   - `string` → strings passthrough; objects/arrays stringify as JSON.
+ *   - `json` → extracted values passthrough; otherwise JSON.parse on text.
+ *   - `number` → Number(text); NaN becomes null.
+ *   - `boolean` → loose-truthy parse (`true`, `1`, `yes`, `pass`).
+ *   - `file` / `artifact` → the path the node declared, if any. The artifact
+ *     collector will populate `run.artifacts` for the actual file content.
+ */
+export async function captureNodeStructuredOutputs(state, node) {
+    if (!node.outputs || Object.keys(node.outputs).length === 0)
+        return;
+    const text = state.output ?? '';
+    const parsedJson = parseJson(text);
+    const collected = {};
+    for (const [name, definition] of Object.entries(node.outputs)) {
+        const source = await outputSource(text, parsedJson, definition);
+        collected[name] = coerceOutputValue(source, definition);
+    }
+    state.outputs = collected;
+}
+async function outputSource(text, parsedJson, definition) {
+    if (!definition.extract)
+        return text;
+    try {
+        return await jsonata(definition.extract).evaluate({
+            output: text,
+            json: parsedJson,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+function coerceOutputValue(value, definition) {
+    switch (definition.type) {
+        case 'string':
+            return stringifyValue(value);
+        case 'json': {
+            if (definition.extract)
+                return value ?? null;
+            const parsed = parseJson(stringifyValue(value));
+            return parsed === undefined ? stringifyValue(value) : parsed;
+        }
+        case 'number': {
+            const number = Number(stringifyValue(value).trim());
+            return Number.isFinite(number) ? number : null;
+        }
+        case 'boolean': {
+            const normalized = stringifyValue(value).trim().toLowerCase();
+            return ['true', '1', 'yes', 'y', 'pass', 'passed', 'ok'].includes(normalized);
+        }
+        case 'file':
+        case 'artifact':
+            // The artifact-collector populates run.artifacts with the resolved path;
+            // the structured output here exposes the bulk text for now.
+            return stringifyValue(value) || null;
+        default:
+            return stringifyValue(value);
+    }
+}
+function parseJson(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+}
+function stringifyValue(value) {
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=structured-outputs.js.map

package/dist/workflows/structured-outputs.js.map

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

package/dist/workflows/subflow-executor.d.ts

@@ -0,0 +1,15 @@
+import type { WorkflowNodeExecutorContext } from './node-executor.js';
+import type { WorkflowRunRecord, WorkflowSubflowNode } from './types.js';
+/**
+ * Run a `subflow` node by walking its inline child workflow's topological
+ * order. The first cut supports shell-only children; child nodes can declare
+ * `needs`, `when`, and `outputs` and reference each other via the same
+ * JSONata template surface as the parent — but in a private context where
+ * `inputs` is the resolved subflow input map and `nodes.<id>` is restricted
+ * to children that have already run.
+ *
+ * The aggregate parent output is `{ "<child-id>": "<output>", ... }` encoded
+ * as JSON so downstream parent nodes can read named child outputs.
+ */
+export declare function executeSubflowNode(context: WorkflowNodeExecutorContext, run: WorkflowRunRecord, nodeId: string, node: WorkflowSubflowNode): Promise<void>;
+//# sourceMappingURL=subflow-executor.d.ts.map

package/dist/workflows/subflow-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subflow-executor.d.ts","sourceRoot":"","sources":["../../src/workflows/subflow-executor.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAwB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAS/F;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAgFf"}

package/dist/workflows/subflow-executor.js

@@ -0,0 +1,177 @@
+import { buildExpressionContext, evaluateConditionExpression, evaluateExpression, renderTemplateString, WorkflowExpressionError, } from './expression.js';
+import { addEvent, resolveNodeCwd, runShellNode, ShellNodeError } from './runtime-helpers.js';
+/**
+ * Run a `subflow` node by walking its inline child workflow's topological
+ * order. The first cut supports shell-only children; child nodes can declare
+ * `needs`, `when`, and `outputs` and reference each other via the same
+ * JSONata template surface as the parent — but in a private context where
+ * `inputs` is the resolved subflow input map and `nodes.<id>` is restricted
+ * to children that have already run.
+ *
+ * The aggregate parent output is `{ "<child-id>": "<output>", ... }` encoded
+ * as JSON so downstream parent nodes can read named child outputs.
+ */
+export async function executeSubflowNode(context, run, nodeId, node) {
+    const state = run.nodes[nodeId];
+    if (!state)
+        return;
+    const resolvedInputs = await resolveSubflowInputs(node, run, nodeId);
+    const order = topologicalOrder(node.inline.nodes, nodeId);
+    const childStates = new Map();
+    for (const childId of order) {
+        const child = node.inline.nodes[childId];
+        if (!child)
+            continue;
+        const guards = await evaluateChildGuards(child, resolvedInputs, childStates);
+        if (guards.skip) {
+            childStates.set(childId, { status: 'skipped' });
+            addEvent(run, 'subflow-child-skipped', `Subflow ${nodeId}: child ${childId} skipped — ${guards.reason}`, { childId, reason: guards.reason }, nodeId);
+            continue;
+        }
+        addEvent(run, 'subflow-child-started', `Subflow ${nodeId}: child ${childId} started`, { childId }, nodeId);
+        await context.saveAndEmit(run);
+        const result = await runChild(context, run, nodeId, childId, child, resolvedInputs, childStates);
+        childStates.set(childId, result);
+        if (result.status === 'failed') {
+            addEvent(run, 'subflow-child-failed', `Subflow ${nodeId}: child ${childId} failed: ${result.error}`, { childId, error: result.error }, nodeId);
+            throw new Error(result.error ?? `Subflow ${nodeId}: child ${childId} failed`);
+        }
+        addEvent(run, 'subflow-child-completed', `Subflow ${nodeId}: child ${childId} completed`, { childId, exitCode: result.exitCode, output: result.output }, nodeId);
+        await context.saveAndEmit(run);
+    }
+    const aggregate = {};
+    for (const [childId, childState] of childStates.entries()) {
+        if (childState.status === 'completed' && childState.output !== undefined) {
+            aggregate[childId] = childState.output;
+        }
+    }
+    state.output = JSON.stringify(aggregate);
+    addEvent(run, 'node-output', `Subflow ${nodeId} aggregated ${Object.keys(aggregate).length} child output(s)`, { children: Object.keys(aggregate).length, output: state.output }, nodeId);
+}
+async function resolveSubflowInputs(node, run, nodeId) {
+    if (!node.inputs)
+        return {};
+    const context = buildExpressionContext(run);
+    const resolved = {};
+    for (const [key, expression] of Object.entries(node.inputs)) {
+        try {
+            resolved[key] = await evaluateExpression(expression, context);
+        }
+        catch (error) {
+            if (error instanceof WorkflowExpressionError) {
+                throw new Error(`Subflow ${nodeId} input '${key}' failed: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    return resolved;
+}
+function topologicalOrder(children, nodeId) {
+    const ids = Object.keys(children);
+    const remaining = new Set(ids);
+    const ordered = [];
+    const completed = new Set();
+    while (remaining.size > 0) {
+        const ready = [...remaining].filter((candidate) => {
+            const needs = children[candidate]?.needs ?? [];
+            return needs.every((dep) => completed.has(dep));
+        });
+        if (ready.length === 0) {
+            throw new Error(`Subflow ${nodeId} contains a dependency cycle.`);
+        }
+        ready.sort((a, b) => a.localeCompare(b));
+        for (const id of ready) {
+            remaining.delete(id);
+            completed.add(id);
+            ordered.push(id);
+        }
+    }
+    return ordered;
+}
+async function evaluateChildGuards(child, resolvedInputs, childStates) {
+    for (const need of child.needs ?? []) {
+        const parent = childStates.get(need);
+        if (!parent || parent.status !== 'completed') {
+            return { skip: true, reason: `dependency '${need}' did not complete` };
+        }
+    }
+    if (child.when) {
+        const context = buildSubflowContext(resolvedInputs, childStates);
+        try {
+            const truthy = await evaluateConditionExpression(child.when, context);
+            if (!truthy)
+                return { skip: true, reason: `when: ${child.when} → false` };
+        }
+        catch (error) {
+            if (error instanceof WorkflowExpressionError) {
+                throw new Error(`Subflow child when expression failed: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    // Discard the unused buildExpressionContext import warning when when is
+    // omitted by referencing it in a no-op path above; keep only the used one.
+    void buildExpressionContext;
+    return { skip: false };
+}
+async function runChild(context, run, nodeId, childId, child, resolvedInputs, childStates) {
+    const expressionContext = buildSubflowContext(resolvedInputs, childStates);
+    let command;
+    let cwd;
+    try {
+        command = await renderTemplateString(child.command, expressionContext);
+        const cwdRendered = child.cwd
+            ? await renderTemplateString(child.cwd, expressionContext)
+            : undefined;
+        cwd = resolveNodeCwd(run.directoryPath, cwdRendered);
+    }
+    catch (error) {
+        return {
+            status: 'failed',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    const abort = context.shellAbortRegistry.create(run.id, `subflow:${nodeId}:${childId}`);
+    try {
+        const result = await runShellNode(command, {
+            cwd,
+            timeoutSeconds: child.timeoutSeconds,
+            signal: abort.signal,
+        });
+        return { status: 'completed', output: result.output, exitCode: result.exitCode };
+    }
+    catch (error) {
+        if (error instanceof ShellNodeError) {
+            return {
+                status: 'failed',
+                output: error.output,
+                exitCode: error.exitCode ?? undefined,
+                error: error.message,
+            };
+        }
+        return {
+            status: 'failed',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    finally {
+        abort.dispose();
+    }
+}
+function buildSubflowContext(inputs, childStates) {
+    const nodes = {};
+    for (const [childId, state] of childStates.entries()) {
+        nodes[childId] = {
+            status: state.status,
+            output: state.output ?? null,
+            outputs: {},
+            error: state.error ?? null,
+            sessionId: null,
+            nativeSessionId: null,
+            worktreePath: null,
+            approval: null,
+        };
+    }
+    return { inputs: inputs, nodes };
+}
+//# sourceMappingURL=subflow-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subflow-executor.js","sourceRoot":"","sources":["../../src/workflows/subflow-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW9F;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAoC,EACpC,GAAsB,EACtB,MAAc,EACd,IAAyB;IAEzB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEzD,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;QAC7E,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAChD,QAAQ,CACN,GAAG,EACH,uBAAuB,EACvB,WAAW,MAAM,WAAW,OAAO,cAAc,MAAM,CAAC,MAAM,EAAE,EAChE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAClC,MAAM,CACP,CAAC;YACF,SAAS;QACX,CAAC;QAED,QAAQ,CACN,GAAG,EACH,uBAAuB,EACvB,WAAW,MAAM,WAAW,OAAO,UAAU,EAC7C,EAAE,OAAO,EAAE,EACX,MAAM,CACP,CAAC;QACF,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,OAAO,EACP,GAAG,EACH,MAAM,EACN,OAAO,EACP,KAAK,EACL,cAAc,EACd,WAAW,CACZ,CAAC;QACF,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEjC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,QAAQ,CACN,GAAG,EACH,sBAAsB,EACtB,WAAW,MAAM,WAAW,OAAO,YAAY,MAAM,CAAC,KAAK,EAAE,EAC7D,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAChC,MAAM,CACP,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,WAAW,MAAM,WAAW,OAAO,SAAS,CAAC,CAAC;QAChF,CAAC;QAED,QAAQ,CACN,GAAG,EACH,yBAAyB,EACzB,WAAW,MAAM,WAAW,OAAO,YAAY,EAC/C,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAC7D,MAAM,CACP,CAAC;QACF,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1D,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACzE,SAAS,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;QACzC,CAAC;IACH,CAAC;IACD,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,QAAQ,CACN,GAAG,EACH,aAAa,EACb,WAAW,MAAM,eAAe,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,kBAAkB,EAC/E,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EACjE,MAAM,CACP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,IAAyB,EACzB,GAAsB,EACtB,MAAc;IAEd,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,WAAW,GAAG,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CACvB,QAA8C,EAC9C,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,OAAO,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE;YAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,+BAA+B,CAAC,CAAC;QACpE,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrB,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,KAA2B,EAC3B,cAAuC,EACvC,WAA2C;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,IAAI,oBAAoB,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,mBAAmB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACtE,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,wEAAwE;IACxE,2EAA2E;IAC3E,KAAK,sBAAsB,CAAC;IAC5B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,OAAoC,EACpC,GAAsB,EACtB,MAAc,EACd,OAAe,EACf,KAA2B,EAC3B,cAAuC,EACvC,WAA2C;IAE3C,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC3E,IAAI,OAAe,CAAC;IACpB,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG;YAC3B,CAAC,CAAC,MAAM,oBAAoB,CAAC,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC;YAC1D,CAAC,CAAC,SAAS,CAAC;QACd,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE;YACzC,GAAG;YACH,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACnF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS;gBACrC,KAAK,EAAE,KAAK,CAAC,OAAO;aACrB,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAA+B,EAC/B,WAA2C;IAE3C,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;QACrD,KAAK,CAAC,OAAO,CAAC,GAAG;YACf,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;YAC1B,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAqC,EAAE,KAAK,EAAE,CAAC;AAClE,CAAC"}

package/dist/workflows/trigger-rule.d.ts

@@ -0,0 +1,22 @@
+import type { WorkflowNodeRunState, WorkflowRunRecord, WorkflowTriggerRule } from './types.js';
+export interface TriggerEvaluation {
+    ready: boolean;
+    /** When `ready` is false, why — used for `node-skipped` events. */
+    reason?: string;
+}
+/**
+ * Decide whether a node may run given its parents' current states.
+ *
+ * Rules:
+ *   - `all_success` (default): every parent must be `completed`. If any parent
+ *     is `failed`, `skipped`, or `canceled`, the node is permanently
+ *     unsatisfiable and should be skipped. If parents are still in flight, the
+ *     node is not ready yet (but the runner currently runs in topological
+ *     order, so by the time we evaluate a node every parent is terminal).
+ *   - `all_done`: every parent must be in any terminal state.
+ *   - `one_success`: at least one parent must be `completed`.
+ */
+export declare function evaluateTriggerRule(rule: WorkflowTriggerRule | undefined, parents: WorkflowNodeRunState[]): TriggerEvaluation;
+export declare function isTriggerSkipReason(reason: string | undefined): boolean;
+export declare function getNodeParents(run: WorkflowRunRecord, needs: string[] | undefined): WorkflowNodeRunState[];
+//# sourceMappingURL=trigger-rule.d.ts.map

package/dist/workflows/trigger-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-rule.d.ts","sourceRoot":"","sources":["../../src/workflows/trigger-rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE/F,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,mBAAmB,GAAG,SAAS,EACrC,OAAO,EAAE,oBAAoB,EAAE,GAC9B,iBAAiB,CAqCnB;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEvE;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAC1B,oBAAoB,EAAE,CAKxB"}

package/dist/workflows/trigger-rule.js

@@ -0,0 +1,57 @@
+/**
+ * Decide whether a node may run given its parents' current states.
+ *
+ * Rules:
+ *   - `all_success` (default): every parent must be `completed`. If any parent
+ *     is `failed`, `skipped`, or `canceled`, the node is permanently
+ *     unsatisfiable and should be skipped. If parents are still in flight, the
+ *     node is not ready yet (but the runner currently runs in topological
+ *     order, so by the time we evaluate a node every parent is terminal).
+ *   - `all_done`: every parent must be in any terminal state.
+ *   - `one_success`: at least one parent must be `completed`.
+ */
+export function evaluateTriggerRule(rule, parents) {
+    const effective = rule ?? 'all_success';
+    if (parents.length === 0)
+        return { ready: true };
+    const successes = parents.filter((parent) => parent.status === 'completed').length;
+    const terminals = parents.filter((parent) => ['completed', 'failed', 'skipped', 'canceled'].includes(parent.status)).length;
+    if (effective === 'all_success') {
+        if (successes === parents.length)
+            return { ready: true };
+        const failedParent = parents.find((parent) => parent.status !== 'completed');
+        return {
+            ready: false,
+            reason: `triggerRule=all_success: parent ${failedParent?.id ?? 'unknown'} is ${failedParent?.status ?? 'not completed'}`,
+        };
+    }
+    if (effective === 'all_done') {
+        if (terminals === parents.length)
+            return { ready: true };
+        return {
+            ready: false,
+            reason: 'triggerRule=all_done: not all parents reached a terminal state',
+        };
+    }
+    if (effective === 'one_success') {
+        if (successes >= 1)
+            return { ready: true };
+        return {
+            ready: false,
+            reason: 'triggerRule=one_success: no parent reached completed',
+        };
+    }
+    return { ready: false, reason: `Unknown triggerRule: ${effective}` };
+}
+const TRIGGER_PREFIX = 'triggerRule=';
+export function isTriggerSkipReason(reason) {
+    return Boolean(reason?.startsWith(TRIGGER_PREFIX));
+}
+export function getNodeParents(run, needs) {
+    if (!needs || needs.length === 0)
+        return [];
+    return needs
+        .map((parentId) => run.nodes[parentId])
+        .filter((parent) => Boolean(parent));
+}
+//# sourceMappingURL=trigger-rule.js.map

package/dist/workflows/trigger-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-rule.js","sourceRoot":"","sources":["../../src/workflows/trigger-rule.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAqC,EACrC,OAA+B;IAE/B,MAAM,SAAS,GAAG,IAAI,IAAI,aAAa,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAEjD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IACnF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAC1C,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CACvE,CAAC,MAAM,CAAC;IAET,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAChC,IAAI,SAAS,KAAK,OAAO,CAAC,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;QAC7E,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,mCAAmC,YAAY,EAAE,EAAE,IAAI,SAAS,OACtE,YAAY,EAAE,MAAM,IAAI,eAC1B,EAAE;SACH,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,IAAI,SAAS,KAAK,OAAO,CAAC,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzD,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,gEAAgE;SACzE,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAChC,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC3C,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,sDAAsD;SAC/D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,SAAyB,EAAE,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,cAAc,GAAG,cAAc,CAAC;AAEtC,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,GAAsB,EACtB,KAA2B;IAE3B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SACtC,MAAM,CAAC,CAAC,MAAM,EAAkC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACzE,CAAC"}