@viewportai/daemon 0.2.0 → 0.3.0

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

package/dist/workflows/runner.js.map

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

package/dist/workflows/runtime-helpers.d.ts

@@ -0,0 +1,40 @@
+import type { ParsedWorkflow, WorkflowInputValue, WorkflowRunEvent, WorkflowRunRecord } from './types.js';
+export interface ShellNodeResult {
+    output: string;
+    exitCode: number;
+}
+export declare class ShellNodeError extends Error {
+    readonly output: string;
+    readonly exitCode: number | null;
+    constructor(message: string, output: string, exitCode: number | null);
+}
+export declare function normalizeInputs(parsed: ParsedWorkflow, provided: Record<string, WorkflowInputValue>): Record<string, WorkflowInputValue>;
+export declare function addEvent(run: WorkflowRunRecord, type: WorkflowRunEvent['type'], message: string, data?: Record<string, unknown>, nodeId?: string): void;
+export declare function resolveNodeCwd(directoryPath: string, cwd?: string): string;
+export declare function renderOptionalTemplate(template: string | undefined, run: WorkflowRunRecord, extras?: Record<string, unknown>): Promise<string | undefined>;
+/**
+ * Render a workflow template by replacing `{{ <jsonata> }}` placeholders. The
+ * legacy patterns (`{{ inputs.X }}`, `{{ nodes.X.output }}`, `{{ outputs.X }}`,
+ * `{{ artifacts.X.Y }}`) all evaluate as JSONata path expressions over the run
+ * context, so existing workflows keep working while authors gain the full
+ * JSONata expression language for new templates.
+ *
+ * Backwards-compat shims:
+ *   - `outputs.X` → rewritten to `nodes.X.output` (legacy alias).
+ *   - `artifacts.X.Y` → rewritten to a synthetic accessor that maps the run's
+ *     artifact list back into `<nodeId>.<artifactName>` shape.
+ */
+export declare function renderTemplate(template: string, run: WorkflowRunRecord, extras?: Record<string, unknown>): Promise<string>;
+export declare function runShellNode(command: string, options: {
+    cwd: string;
+    timeoutSeconds?: number;
+    /** Extra environment variables merged with process.env for this child. */
+    env?: Record<string, string>;
+    signal?: AbortSignal;
+    onOutput?: (event: {
+        source: 'stdout' | 'stderr';
+        chunk: string;
+        output: string;
+    }) => void;
+}): Promise<ShellNodeResult>;
+//# sourceMappingURL=runtime-helpers.d.ts.map

package/dist/workflows/runtime-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-helpers.d.ts","sourceRoot":"","sources":["../../src/workflows/runtime-helpers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;gBAFhC,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI;CAKnC;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC3C,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAgBpC;AAED,wBAAgB,QAAQ,CACtB,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAUN;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,iBAAiB,EACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,iBAAiB,EACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAWjB;AA4BD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5F,GACA,OAAO,CAAC,eAAe,CAAC,CAqF1B"}