@viewportai/daemon 0.1.0 → 0.2.1

package/dist/workflows/runner-scheduler.js

@@ -0,0 +1,211 @@
+import { buildExpressionContext, evaluateConditionExpression, WorkflowExpressionError, } from './expression.js';
+import { executeWorkflowNode } from './node-executor.js';
+import { preflightWorkflow } from './preflight.js';
+import { addEvent } from './runtime-helpers.js';
+import { captureNodeStructuredOutputs } from './structured-outputs.js';
+import { evaluateTriggerRule, isTriggerSkipReason, } from './trigger-rule.js';
+import { findReadyNodeIds } from './runner-shared.js';
+/**
+ * Runs the layer-by-layer scheduling loop for an active workflow run. Within
+ * a layer, every node whose `needs` are all terminal runs in parallel via
+ * `Promise.allSettled`. The scheduler is responsible for run-level status
+ * decisions; the executor only mutates per-node state.
+ */
+export class WorkflowLayerScheduler {
+    daemon;
+    sessionLinks;
+    shellAbortRegistry;
+    activeRunIds;
+    ops;
+    constructor(daemon, sessionLinks, shellAbortRegistry, activeRunIds, ops) {
+        this.daemon = daemon;
+        this.sessionLinks = sessionLinks;
+        this.shellAbortRegistry = shellAbortRegistry;
+        this.activeRunIds = activeRunIds;
+        this.ops = ops;
+    }
+    async run(runId, parsed, options = {}) {
+        this.activeRunIds.add(runId);
+        try {
+            const run = await this.ops.requireRun(runId);
+            const startedAt = Date.now();
+            run.status = 'running';
+            run.startedAt ??= startedAt;
+            run.updatedAt = startedAt;
+            addEvent(run, 'run-started', options.resumed ? 'Workflow run resumed' : 'Workflow run started');
+            run.preflight = await preflightWorkflow(parsed.definition, {
+                availableAgents: () => this.daemon.getAvailableAgents(),
+                availableModels: () => this.daemon.getAvailableModels(),
+                directoryPath: run.directoryPath,
+            });
+            if (!run.preflight.ok) {
+                run.status = 'blocked';
+                run.completedAt = Date.now();
+                run.updatedAt = run.completedAt;
+                addEvent(run, 'run-blocked', 'Workflow blocked by preflight', {
+                    issues: run.preflight.issues,
+                });
+                await this.ops.saveAndEmit(run);
+                return;
+            }
+            await this.ops.saveAndEmit(run);
+            let safety = 0;
+            while (true) {
+                if (++safety > 10_000) {
+                    throw new Error('Workflow runner aborted: scheduling loop exceeded safety bound');
+                }
+                const freshRun = await this.ops.requireRun(runId);
+                if (freshRun.status !== 'running')
+                    return;
+                const ready = findReadyNodeIds(freshRun, parsed);
+                if (ready.length === 0) {
+                    // No more ready nodes. Either everything is terminal (run completes)
+                    // or some nodes are blocked / orphaned (run pauses or fails).
+                    break;
+                }
+                const layer = await this.classifyLayer(freshRun, parsed, ready);
+                // Apply the skips synchronously before launching the executable subset.
+                for (const skip of layer.skipped) {
+                    this.markSkipped(freshRun, skip.nodeId, skip.reason);
+                }
+                if (layer.skipped.length > 0)
+                    await this.ops.saveAndEmit(freshRun);
+                if (layer.toExecute.length === 0) {
+                    // Nothing executable in this layer. Loop and try the next.
+                    continue;
+                }
+                const results = await Promise.allSettled(layer.toExecute.map(async (nodeId) => {
+                    const node = parsed.definition.nodes[nodeId];
+                    if (!node)
+                        return { nodeId, status: 'noop' };
+                    const state = freshRun.nodes[nodeId];
+                    if (!state || state.status === 'completed' || state.status === 'skipped') {
+                        return { nodeId, status: 'noop' };
+                    }
+                    const outcome = await executeWorkflowNode({
+                        daemon: this.daemon,
+                        sessionLinks: this.sessionLinks,
+                        shellAbortRegistry: this.shellAbortRegistry,
+                        saveAndEmit: (nextRun) => this.ops.saveAndEmit(nextRun),
+                    }, freshRun, nodeId, node);
+                    return { nodeId, status: outcome };
+                }));
+                const updated = await this.ops.requireRun(runId);
+                for (const result of results) {
+                    if (result.status === 'rejected') {
+                        // executeWorkflowNode rejects after writing the failure on the
+                        // node state — but if anything ever rejects without that path
+                        // running first, we still want a trace on the timeline.
+                        const reason = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                        addEvent(updated, 'run-failed', `Layer task rejected without node-level handling: ${reason}`, { reason });
+                        continue;
+                    }
+                    const nodeId = result.value.nodeId;
+                    const node = parsed.definition.nodes[nodeId];
+                    const state = updated.nodes[nodeId];
+                    if (state?.status === 'completed' && node) {
+                        await captureNodeStructuredOutputs(state, node);
+                    }
+                }
+                await this.ops.saveAndEmit(updated);
+                // Decide run-level status based on the layer's outcome.
+                const refreshed = await this.ops.requireRun(runId);
+                const layerFailures = layer.toExecute
+                    .map((nodeId) => ({ nodeId, state: refreshed.nodes[nodeId] }))
+                    .filter(({ state }) => state?.status === 'failed');
+                const layerBlocked = layer.toExecute.some((nodeId) => refreshed.nodes[nodeId]?.status === 'blocked');
+                if (layerFailures.length > 0) {
+                    const haltOn = layerFailures.find(({ nodeId }) => {
+                        const policy = parsed.definition.nodes[nodeId]?.policy?.onFailure ?? 'halt';
+                        return policy === 'halt';
+                    });
+                    if (haltOn) {
+                        const message = haltOn.state?.error ?? `Node ${haltOn.nodeId} failed`;
+                        refreshed.status = 'failed';
+                        refreshed.error = message;
+                        refreshed.completedAt = Date.now();
+                        refreshed.updatedAt = refreshed.completedAt;
+                        addEvent(refreshed, 'run-failed', `Workflow run failed: ${message}`);
+                        await this.ops.saveAndEmit(refreshed);
+                        return;
+                    }
+                }
+                if (layerBlocked) {
+                    // Approval / schedule gate is pending. The run record's status was
+                    // already set to 'blocked' by the executor; we just stop scheduling.
+                    return;
+                }
+            }
+            const complete = await this.ops.requireRun(runId);
+            if (complete.status !== 'running')
+                return;
+            complete.status = 'completed';
+            complete.completedAt = Date.now();
+            complete.updatedAt = complete.completedAt;
+            addEvent(complete, 'run-completed', 'Workflow run completed');
+            await this.ops.saveAndEmit(complete);
+        }
+        finally {
+            this.activeRunIds.delete(runId);
+        }
+    }
+    /**
+     * Decide which of the given ready node ids should actually run vs. be
+     * skipped. Returns the partition; the runner applies each side.
+     */
+    async classifyLayer(run, parsed, nodeIds) {
+        const toExecute = [];
+        const skipped = [];
+        for (const nodeId of nodeIds) {
+            const node = parsed.definition.nodes[nodeId];
+            if (!node)
+                continue;
+            const reason = await this.evaluateNodeGuards(run, nodeId, node);
+            if (reason)
+                skipped.push({ nodeId, reason });
+            else
+                toExecute.push(nodeId);
+        }
+        return { toExecute, skipped };
+    }
+    /**
+     * Decide whether this node should be skipped based on its `when:` expression
+     * and `triggerRule`. Returns a reason string if the node must be skipped, or
+     * null if the node should run.
+     */
+    async evaluateNodeGuards(run, nodeId, node) {
+        const parents = (node.needs ?? [])
+            .map((parentId) => run.nodes[parentId])
+            .filter((parent) => Boolean(parent));
+        const trigger = evaluateTriggerRule(node.triggerRule, parents);
+        if (!trigger.ready && trigger.reason && isTriggerSkipReason(trigger.reason)) {
+            return trigger.reason;
+        }
+        if (node.when) {
+            const context = buildExpressionContext(run);
+            try {
+                const truthy = await evaluateConditionExpression(node.when, context);
+                if (!truthy)
+                    return `when: ${node.when} → false`;
+            }
+            catch (error) {
+                if (error instanceof WorkflowExpressionError) {
+                    throw new Error(`Invalid when expression on ${nodeId}: ${error.message}`);
+                }
+                throw error;
+            }
+        }
+        return null;
+    }
+    markSkipped(run, nodeId, reason) {
+        const state = run.nodes[nodeId];
+        if (!state)
+            return;
+        state.status = 'skipped';
+        state.skipReason = reason;
+        state.completedAt = Date.now();
+        run.updatedAt = state.completedAt;
+        addEvent(run, 'node-skipped', `Node ${nodeId} skipped: ${reason}`, { reason }, nodeId);
+    }
+}
+//# sourceMappingURL=runner-scheduler.js.map

package/dist/workflows/runner-scheduler.js.map

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

package/dist/workflows/runner-shared.d.ts

@@ -0,0 +1,21 @@
+import type { ParsedWorkflow, WorkflowRunRecord } from './types.js';
+export declare const TERMINAL_NODE_STATUSES: Set<string>;
+/**
+ * Find every queued node whose `needs` set has fully terminated. The runner
+ * launches these as the next layer; classification (when/triggerRule) decides
+ * whether each one actually executes or gets skipped.
+ */
+export declare function findReadyNodeIds(run: WorkflowRunRecord, parsed: ParsedWorkflow): string[];
+export declare function workflowNodeMetadata(node: ParsedWorkflow['definition']['nodes'][string]): Record<string, unknown>;
+export declare function formatExecutionPolicy(policy: NonNullable<WorkflowRunRecord['executionPolicy']>): string;
+/**
+ * Callbacks the internal helpers need from the orchestrating WorkflowRunner.
+ * Passed via constructor to avoid circular imports between the helper modules
+ * and WorkflowRunner.
+ */
+export interface RunnerOps {
+    requireRun(runId: string): Promise<WorkflowRunRecord>;
+    saveAndEmit(run: WorkflowRunRecord): Promise<void>;
+    failRun(runId: string, message: string): Promise<void>;
+}
+//# sourceMappingURL=runner-shared.d.ts.map

package/dist/workflows/runner-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-shared.d.ts","sourceRoot":"","sources":["../../src/workflows/runner-shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpE,eAAO,MAAM,sBAAsB,aAA0D,CAAC;AAE9F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAazF;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAClD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,GACxD,MAAM,CAMR;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtD,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD"}

package/dist/workflows/runner-shared.js

@@ -0,0 +1,59 @@
+export const TERMINAL_NODE_STATUSES = new Set(['completed', 'failed', 'skipped', 'canceled']);
+/**
+ * Find every queued node whose `needs` set has fully terminated. The runner
+ * launches these as the next layer; classification (when/triggerRule) decides
+ * whether each one actually executes or gets skipped.
+ */
+export function findReadyNodeIds(run, parsed) {
+    const ready = [];
+    for (const [nodeId, node] of Object.entries(parsed.definition.nodes)) {
+        const state = run.nodes[nodeId];
+        if (!state || state.status !== 'queued')
+            continue;
+        const needs = node.needs ?? [];
+        const allParentsTerminal = needs.every((parentId) => {
+            const parent = run.nodes[parentId];
+            return parent ? TERMINAL_NODE_STATUSES.has(parent.status) : true;
+        });
+        if (allParentsTerminal)
+            ready.push(nodeId);
+    }
+    return ready;
+}
+export function workflowNodeMetadata(node) {
+    return {
+        needs: node.needs ?? [],
+        outputs: node.outputs ?? {},
+        artifacts: node.artifacts ?? {},
+        retry: node.retry ?? null,
+        policy: node.policy ?? null,
+        timeoutSeconds: node.timeoutSeconds ?? null,
+        ...(node.type === 'prompt'
+            ? {
+                agent: node.agent ?? null,
+                provider: node.provider ?? null,
+                model: node.model ?? null,
+                hooks: node.hooks ?? null,
+                agents: node.agents ?? null,
+            }
+            : {}),
+        ...(node.type === 'gate' ? { gate: node.gate } : {}),
+        ...(node.type === 'plan'
+            ? {
+                title: node.title,
+                summary: node.summary ?? null,
+                source: node.source ?? 'workflow',
+                waitForApproval: node.waitForApproval ?? true,
+            }
+            : {}),
+    };
+}
+export function formatExecutionPolicy(policy) {
+    if (policy.mode === 'named_branch') {
+        return `named branch${policy.branch ? ` ${policy.branch}` : ''}`;
+    }
+    if (policy.mode === 'current_tree')
+        return 'selected working tree';
+    return 'isolated agent worktree';
+}
+//# sourceMappingURL=runner-shared.js.map

package/dist/workflows/runner-shared.js.map

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

package/dist/workflows/runner.d.ts

@@ -0,0 +1,36 @@
+import type { Daemon } from '../core/daemon.js';
+import { type WorkflowCancelOptions } from './runner-canceler.js';
+import type { ParsedWorkflow, WorkflowApprovalDecision, WorkflowRunRecord, WorkflowRunRequest } from './types.js';
+export declare class WorkflowRunner {
+    private readonly daemon;
+    private readonly store;
+    private readonly sessionLinks;
+    private readonly platformSync;
+    private readonly activeRunIds;
+    private readonly shellAbortRegistry;
+    private readonly scheduler;
+    private readonly resumer;
+    private readonly reconciler;
+    private readonly canceler;
+    private readonly platformCommandApplier;
+    constructor(daemon: Daemon);
+    validateFile(filePath: string): Promise<ParsedWorkflow>;
+    validateText(sourceText: string, sourceRef?: string): ParsedWorkflow;
+    listRuns(limit?: number): Promise<WorkflowRunRecord[]>;
+    resumePendingRuns(): Promise<{
+        resumed: number;
+        failed: number;
+        platformSyncScheduled: number;
+    }>;
+    getRun(runId: string): Promise<WorkflowRunRecord | null>;
+    startRun(request: WorkflowRunRequest): Promise<WorkflowRunRecord>;
+    rerunRun(sourceRunId: string): Promise<WorkflowRunRecord>;
+    decideApproval(runId: string, nodeId: string, decision: WorkflowApprovalDecision): Promise<WorkflowRunRecord>;
+    cancelRun(runId: string, options?: WorkflowCancelOptions): Promise<WorkflowRunRecord>;
+    private recordWorkflowHookEvent;
+    private failRun;
+    private requireRun;
+    private saveAndEmit;
+    private schedulePlatformLinkedRuns;
+}
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/workflows/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAWhD,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMvF,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EAExB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IAYb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoC;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAgC;gBAE1C,MAAM,EAAE,MAAM;IAwCrC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,SAA+B,GAAG,cAAc;IAIpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAMtD,iBAAiB,IAAI,OAAO,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IAMI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKxD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2FjE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiBzD,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,wBAAwB,GACjC,OAAO,CAAC,iBAAiB,CAAC;IAuGvB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAIjF,uBAAuB;YA+BvB,OAAO;YAkBP,UAAU;YAQV,WAAW;YAMX,0BAA0B;CASzC"}

package/dist/workflows/runner.js

@@ -0,0 +1,289 @@
+import { resolveSessionResourceManifestSync } from '../config-resolution/index.js';
+import { parseWorkflow, parseWorkflowFile } from './parser.js';
+import { addEvent, normalizeInputs } from './runtime-helpers.js';
+import { WorkflowRunPlatformSync } from './platform-sync.js';
+import { WorkflowSessionLinkStore } from './session-links.js';
+import { WorkflowRunStore } from './store.js';
+import { resolveWorkflowSource } from './workflow-source.js';
+import { WorkflowLayerScheduler } from './runner-scheduler.js';
+import { WorkflowRunResumer } from './runner-resumer.js';
+import { WorkflowRunReconciler } from './runner-reconciler.js';
+import { WorkflowRunCanceler } from './runner-canceler.js';
+import { WorkflowShellAbortRegistry } from './shell-abort-registry.js';
+import { WorkflowRuntimeCommandApplier } from './platform-command-applier.js';
+import { formatExecutionPolicy, workflowNodeMetadata } from './runner-shared.js';
+import { runApprovalOnRejectFollowUp } from './approval-on-reject.js';
+import { buildWorkflowContractBinding } from './contract-binding.js';
+export class WorkflowRunner {
+    daemon;
+    store = new WorkflowRunStore();
+    sessionLinks = new WorkflowSessionLinkStore();
+    platformSync;
+    activeRunIds = new Set();
+    shellAbortRegistry = new WorkflowShellAbortRegistry();
+    scheduler;
+    resumer;
+    reconciler;
+    canceler;
+    platformCommandApplier;
+    constructor(daemon) {
+        this.daemon = daemon;
+        this.platformCommandApplier = new WorkflowRuntimeCommandApplier(this.store, (runId, nodeId, decision) => this.decideApproval(runId, nodeId, decision));
+        this.platformSync = new WorkflowRunPlatformSync(daemon.configManager, undefined, {
+            onRuntimeCommand: (command, run) => this.platformCommandApplier.apply(command, run.id),
+        });
+        const ops = {
+            requireRun: (runId) => this.requireRun(runId),
+            saveAndEmit: (run) => this.saveAndEmit(run),
+            failRun: (runId, message) => this.failRun(runId, message),
+        };
+        this.reconciler = new WorkflowRunReconciler(this.daemon, this.activeRunIds, ops.saveAndEmit);
+        this.canceler = new WorkflowRunCanceler(this.daemon, this.activeRunIds, this.shellAbortRegistry, ops);
+        this.scheduler = new WorkflowLayerScheduler(this.daemon, this.sessionLinks, this.shellAbortRegistry, this.activeRunIds, ops);
+        this.resumer = new WorkflowRunResumer(this.store, (runId, parsed, options) => this.scheduler.run(runId, parsed, options), ops.failRun, (run) => this.reconciler.reconcile(run));
+        this.daemon.on('workflow:hook-fired', (event) => {
+            void this.recordWorkflowHookEvent(event).catch(() => undefined);
+        });
+    }
+    async validateFile(filePath) {
+        return parseWorkflowFile(filePath);
+    }
+    validateText(sourceText, sourceRef = 'viewport://workflow/inline') {
+        return parseWorkflow(sourceText, sourceRef);
+    }
+    async listRuns(limit) {
+        const runs = await this.store.list(limit);
+        const reconciled = await Promise.all(runs.map((run) => this.reconciler.reconcile(run)));
+        return reconciled;
+    }
+    async resumePendingRuns() {
+        const result = await this.resumer.resumePendingRuns();
+        const platformSyncScheduled = await this.schedulePlatformLinkedRuns();
+        return { ...result, platformSyncScheduled };
+    }
+    async getRun(runId) {
+        const run = await this.store.get(runId);
+        return run ? this.reconciler.reconcile(run) : null;
+    }
+    async startRun(request) {
+        const directory = this.daemon.directoryManager.get(request.directoryId);
+        if (!directory) {
+            throw new Error(`Directory not registered: ${request.directoryId}`);
+        }
+        const parsed = await resolveWorkflowSource(request, directory.path);
+        const now = Date.now();
+        const resourceId = request.resourceId;
+        const runtimeTargetId = request.runtimeTargetId;
+        const resourceManifest = resolveSessionResourceManifestSync({
+            workingDirectory: directory.path,
+        });
+        const run = {
+            id: crypto.randomUUID(),
+            workflowName: parsed.definition.name,
+            workflowTitle: parsed.definition.title,
+            sourceType: request.workflowYaml ? 'viewport_snapshot' : 'local_file',
+            sourcePath: request.workflowYaml ? request.workflowSourceRef : parsed.sourcePath,
+            digest: parsed.digest,
+            schema: parsed.definition.schema,
+            yamlSnapshot: parsed.sourceText,
+            directoryId: request.directoryId,
+            directoryPath: directory.path,
+            resourceId,
+            resourceManifest,
+            workflowContract: buildWorkflowContractBinding(request.workflowContract, parsed.digest),
+            runtimeTargetId,
+            platformRunId: request.platformRunId,
+            rerunOfWorkflowRunId: request.rerunOfWorkflowRunId,
+            machineId: this.daemon.configManager.getMachineId(),
+            executionPolicy: request.executionPolicy,
+            dataCapturePolicy: request.dataCapturePolicy ?? {
+                transcripts: 'none',
+                logs: 'metadata',
+                artifacts: 'metadata',
+            },
+            initiation: request.initiation,
+            status: 'queued',
+            inputs: normalizeInputs(parsed, request.inputs ?? {}),
+            preflight: { ok: true, issues: [] },
+            nodes: Object.fromEntries(Object.entries(parsed.definition.nodes).map(([nodeId, node]) => [
+                nodeId,
+                {
+                    id: nodeId,
+                    type: node.type,
+                    title: node.title,
+                    status: 'queued',
+                    metadata: workflowNodeMetadata(node),
+                },
+            ])),
+            artifacts: [],
+            events: [],
+            createdAt: now,
+            updatedAt: now,
+        };
+        addEvent(run, 'run-created', 'Workflow run created');
+        addEvent(run, 'context-manifest-resolved', 'Context manifest resolved for workflow run', {
+            manifestDigest: resourceManifest.manifestDigest,
+            configSourceCount: resourceManifest.configSources.length,
+            providerCount: resourceManifest.contract.contextProviders.length,
+            workflowCount: resourceManifest.contract.workflows.length,
+            warningCount: resourceManifest.warnings.length,
+            conflictCount: resourceManifest.conflicts.length,
+        });
+        if (run.executionPolicy) {
+            addEvent(run, 'execution-policy-selected', `Execution policy selected: ${formatExecutionPolicy(run.executionPolicy)}`, { executionPolicy: run.executionPolicy });
+        }
+        if (run.rerunOfWorkflowRunId) {
+            addEvent(run, 'run-rerun-requested', 'Workflow rerun created from an immutable run snapshot', { sourceRunId: run.rerunOfWorkflowRunId });
+        }
+        await this.store.save(run);
+        void this.scheduler.run(run.id, parsed).catch((error) => {
+            void this.failRun(run.id, error instanceof Error ? error.message : String(error));
+        });
+        return run;
+    }
+    async rerunRun(sourceRunId) {
+        const sourceRun = await this.requireRun(sourceRunId);
+        return this.startRun({
+            workflowYaml: sourceRun.yamlSnapshot,
+            workflowSourceRef: sourceRun.sourcePath ?? `viewport://workflow-runs/${sourceRun.id}`,
+            directoryId: sourceRun.directoryId,
+            inputs: sourceRun.inputs,
+            resourceId: sourceRun.resourceId,
+            runtimeTargetId: sourceRun.runtimeTargetId,
+            executionPolicy: sourceRun.executionPolicy,
+            dataCapturePolicy: sourceRun.dataCapturePolicy,
+            initiation: 'cli',
+            rerunOfWorkflowRunId: sourceRun.id,
+        });
+    }
+    async decideApproval(runId, nodeId, decision) {
+        const run = await this.requireRun(runId);
+        const state = run.nodes[nodeId];
+        if (!state || (state.type !== 'approval' && state.type !== 'gate' && state.type !== 'plan')) {
+            throw new Error(`Workflow approval node not found: ${nodeId}`);
+        }
+        if (run.status !== 'blocked' || state.status !== 'blocked') {
+            throw new Error(`Workflow node is not awaiting approval: ${nodeId}`);
+        }
+        const resolvedAt = Date.now();
+        state.approval = {
+            prompt: state.approval?.prompt ?? 'Approval requested',
+            requestedAt: state.approval?.requestedAt ?? resolvedAt,
+            resolvedAt,
+            approved: decision.approved,
+            ...(decision.message ? { message: decision.message } : {}),
+            ...(decision.actor ? { actor: decision.actor } : {}),
+            ...(decision.feedback ? { feedback: decision.feedback } : {}),
+        };
+        if (!decision.approved) {
+            // Run the approval node's onReject command if declared. Failures here
+            // are recorded but never block the rejection — the run is canceling
+            // anyway. The approver's free-text rejection message is exposed via
+            // VIEWPORT_REJECT_MESSAGE so scripts can react to it.
+            const parsedForReject = parseWorkflow(run.yamlSnapshot, run.sourcePath ?? `viewport://runs/${run.id}`);
+            const rejectingNode = parsedForReject.definition.nodes[nodeId];
+            if (rejectingNode?.type === 'approval' && rejectingNode.onReject) {
+                await runApprovalOnRejectFollowUp({
+                    daemon: this.daemon,
+                    sessionLinks: this.sessionLinks,
+                    shellAbortRegistry: this.shellAbortRegistry,
+                    saveAndEmit: (nextRun) => this.saveAndEmit(nextRun),
+                }, run, nodeId, rejectingNode.onReject, decision.message);
+            }
+            state.status = 'failed';
+            state.error = decision.message ?? 'Approval denied';
+            state.completedAt = resolvedAt;
+            run.status = 'canceled';
+            run.error = state.error;
+            run.completedAt = resolvedAt;
+            run.updatedAt = resolvedAt;
+            addEvent(run, 'approval-resolved', `Approval denied for node ${nodeId}`, { ...decision }, nodeId);
+            addEvent(run, 'run-canceled', `Workflow canceled by approval gate: ${nodeId}`);
+            await this.saveAndEmit(run);
+            return run;
+        }
+        const parsed = parseWorkflow(run.yamlSnapshot, run.sourcePath ?? `viewport://runs/${run.id}`);
+        state.status = 'completed';
+        state.completedAt = resolvedAt;
+        const approvalNode = parsed.definition.nodes[nodeId];
+        // type=approval defaults to constant 'Approved' output so the reviewer's
+        // free-text doesn't accidentally flow into downstream prompts. Authors
+        // opt into message capture via `captureResponse: true`.
+        // type=gate (human_review) keeps the message as output — gate output is
+        // expected to be a free-text payload by design.
+        const isOptInApproval = approvalNode?.type === 'approval' && approvalNode.captureResponse !== true;
+        const planBody = state.type === 'plan' &&
+            state.metadata &&
+            typeof state.metadata['plan'] === 'object' &&
+            state.metadata['plan'] !== null &&
+            'body' in state.metadata['plan'] &&
+            typeof state.metadata['plan'].body === 'string'
+            ? state.metadata['plan'].body
+            : null;
+        state.output = planBody ?? (isOptInApproval ? 'Approved' : (decision.message ?? 'Approved'));
+        run.status = 'running';
+        run.updatedAt = resolvedAt;
+        addEvent(run, 'approval-resolved', `Approval granted for node ${nodeId}`, { ...decision }, nodeId);
+        addEvent(run, 'node-completed', `Node ${nodeId} completed`, undefined, nodeId);
+        await this.saveAndEmit(run);
+        void this.scheduler.run(run.id, parsed, { resumed: true }).catch((error) => {
+            void this.failRun(run.id, error instanceof Error ? error.message : String(error));
+        });
+        return run;
+    }
+    async cancelRun(runId, options = {}) {
+        return this.canceler.cancelRun(runId, options);
+    }
+    async recordWorkflowHookEvent(event) {
+        const run = await this.store.get(event.workflowRunId);
+        if (!run)
+            return;
+        addEvent(run, 'hook-fired', `Workflow hook ${event.kind} fired for node ${event.workflowNodeId}`, {
+            kind: event.kind,
+            adapter: event.adapter,
+            sessionId: event.sessionId,
+            response: event.response ?? null,
+            payload: event.payload,
+        }, event.workflowNodeId);
+        run.updatedAt = Date.now();
+        await this.saveAndEmit(run);
+    }
+    async failRun(runId, message) {
+        const run = await this.getRun(runId);
+        if (!run ||
+            run.status === 'completed' ||
+            run.status === 'failed' ||
+            run.status === 'canceled') {
+            return;
+        }
+        run.status = 'failed';
+        run.error = message;
+        run.completedAt = Date.now();
+        run.updatedAt = run.completedAt;
+        addEvent(run, 'run-failed', `Workflow run failed: ${message}`);
+        await this.saveAndEmit(run);
+    }
+    async requireRun(runId) {
+        const run = await this.store.get(runId);
+        if (!run) {
+            throw new Error(`Workflow run not found: ${runId}`);
+        }
+        return this.reconciler.reconcile(run);
+    }
+    async saveAndEmit(run) {
+        await this.store.save(run);
+        this.daemon.emit('workflow:run-updated', { run });
+        this.platformSync.schedule(run);
+    }
+    async schedulePlatformLinkedRuns() {
+        let scheduled = 0;
+        for (const run of await this.store.list(500)) {
+            if (!run.resourceId || !run.runtimeTargetId || !run.platformRunId)
+                continue;
+            this.platformSync.schedule(run);
+            scheduled += 1;
+        }
+        return scheduled;
+    }
+}
+//# sourceMappingURL=runner.js.map