@tagma/core 0.1.1

package/README.md

@@ -0,0 +1,22 @@
+# @tagma/core
+
+Runtime-independent orchestration core for Tagma pipelines.
+
+This package owns pipeline DAG execution, plugin registries, approval gateways, lifecycle events, logging abstractions, dataflow helpers, prompt document helpers, and the `TagmaRuntime` interface. It does not provide a concrete process runner or file watcher; hosts must pass a runtime implementation to `runPipeline()`.
+
+```ts
+import { PluginRegistry, runPipeline } from '@tagma/core';
+import { bunRuntime } from '@tagma/runtime-bun';
+
+const registry = new PluginRegistry();
+const result = await runPipeline(config, process.cwd(), {
+  registry,
+  runtime: bunRuntime(),
+});
+```
+
+Use `@tagma/sdk` for the Bun-first convenience API with built-ins registered by default.
+
+## Publishing
+
+`@tagma/core` is a public npm dependency of `@tagma/runtime-bun` and `@tagma/sdk`. Publish it after `@tagma/types` and before runtime or SDK packages.

package/dist/approval.d.ts

@@ -0,0 +1,13 @@
+import type { ApprovalRequest, ApprovalDecision, ApprovalListener, ApprovalGateway } from './types';
+export type { ApprovalRequest, ApprovalDecision, ApprovalOutcome, ApprovalEvent, ApprovalListener, ApprovalGateway, } from './types';
+export declare class InMemoryApprovalGateway implements ApprovalGateway {
+    private readonly pendingMap;
+    private readonly listeners;
+    request(req: Omit<ApprovalRequest, 'id' | 'createdAt'>): Promise<ApprovalDecision>;
+    resolve(approvalId: string, decision: Omit<ApprovalDecision, 'approvalId' | 'decidedAt'>): boolean;
+    pending(): readonly ApprovalRequest[];
+    subscribe(listener: ApprovalListener): () => void;
+    abortAll(reason: string): void;
+    private emit;
+}
+//# sourceMappingURL=approval.d.ts.map

package/dist/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../src/approval.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAEhB,gBAAgB,EAChB,eAAe,EAChB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,SAAS,CAAC;AAUjB,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkClF,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,WAAW,CAAC,GAC3D,OAAO;IAkBV,OAAO,IAAI,SAAS,eAAe,EAAE;IAIrC,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAOjD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAe9B,OAAO,CAAC,IAAI;CASb"}

package/dist/approval.js

@@ -0,0 +1,91 @@
+import { randomUUID } from 'crypto';
+import { nowISO } from './utils';
+export class InMemoryApprovalGateway {
+    pendingMap = new Map();
+    listeners = new Set();
+    request(req) {
+        const full = {
+            id: randomUUID(),
+            createdAt: nowISO(),
+            taskId: req.taskId,
+            trackId: req.trackId,
+            message: req.message,
+            timeoutMs: req.timeoutMs,
+            metadata: req.metadata,
+        };
+        return new Promise((resolvePromise) => {
+            let timer = null;
+            if (full.timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    const entry = this.pendingMap.get(full.id);
+                    if (!entry)
+                        return;
+                    this.pendingMap.delete(full.id);
+                    const decision = {
+                        approvalId: full.id,
+                        outcome: 'timeout',
+                        reason: `Approval timed out after ${full.timeoutMs}ms`,
+                        decidedAt: nowISO(),
+                    };
+                    this.emit({ type: 'expired', request: full });
+                    resolvePromise(decision);
+                }, full.timeoutMs);
+            }
+            this.pendingMap.set(full.id, { request: full, settle: resolvePromise, timer });
+            this.emit({ type: 'requested', request: full });
+        });
+    }
+    resolve(approvalId, decision) {
+        const entry = this.pendingMap.get(approvalId);
+        if (!entry)
+            return false;
+        this.pendingMap.delete(approvalId);
+        if (entry.timer)
+            clearTimeout(entry.timer);
+        const full = {
+            approvalId,
+            outcome: decision.outcome,
+            actor: decision.actor,
+            reason: decision.reason,
+            decidedAt: nowISO(),
+        };
+        this.emit({ type: 'resolved', request: entry.request, decision: full });
+        entry.settle(full);
+        return true;
+    }
+    pending() {
+        return Array.from(this.pendingMap.values()).map((e) => e.request);
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    abortAll(reason) {
+        const entries = Array.from(this.pendingMap.entries());
+        this.pendingMap.clear();
+        for (const [id, entry] of entries) {
+            if (entry.timer)
+                clearTimeout(entry.timer);
+            this.emit({ type: 'aborted', request: entry.request, reason });
+            entry.settle({
+                approvalId: id,
+                outcome: 'aborted',
+                reason,
+                decidedAt: nowISO(),
+            });
+        }
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                console.error('[approval gateway] listener error:', err);
+            }
+        }
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/approval.js.map

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

package/dist/core/dataflow.d.ts

@@ -0,0 +1,23 @@
+import type { TaskConfig, TaskPorts, TaskResult } from '../types';
+import type { RunContext } from './run-context';
+export type EffectivePortsResult = {
+    readonly kind: 'ready';
+    readonly isPromptTask: boolean;
+    readonly effectivePorts: TaskPorts | undefined;
+} | {
+    readonly kind: 'blocked';
+    readonly reason: string;
+};
+export declare function inferEffectivePorts(ctx: RunContext, taskId: string): EffectivePortsResult;
+export interface ExtractSuccessfulOutputsOptions {
+    readonly task: TaskConfig;
+    readonly effectivePorts: TaskPorts | undefined;
+    readonly result: TaskResult;
+}
+export interface ExtractSuccessfulOutputsResult {
+    readonly outputs: Readonly<Record<string, unknown>> | null;
+    readonly bindingDiagnostic: string | null;
+    readonly portDiagnostic: string | null;
+}
+export declare function extractSuccessfulOutputs(options: ExtractSuccessfulOutputsOptions): ExtractSuccessfulOutputsResult;
+//# sourceMappingURL=dataflow.d.ts.map

package/dist/core/dataflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataflow.d.ts","sourceRoot":"","sources":["../../src/core/dataflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EAGV,SAAS,EACT,UAAU,EACX,MAAM,UAAU,CAAC;AAMlB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAgDhD,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,SAAS,GAAG,SAAS,CAAC;CAChD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,GACb,oBAAoB,CAoCtB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAiChC"}

package/dist/core/dataflow.js

@@ -0,0 +1,99 @@
+import { extractTaskBindingOutputs, extractTaskOutputs, inferPromptPorts, } from '../ports';
+function isPromptTaskConfig(task) {
+    return task.prompt !== undefined && task.command === undefined;
+}
+function isCommandTaskConfig(task) {
+    return task.command !== undefined && task.prompt === undefined;
+}
+function inputBindingsToPorts(bindings) {
+    if (!bindings || Object.keys(bindings).length === 0)
+        return undefined;
+    return Object.entries(bindings).map(([name, binding]) => ({
+        name,
+        type: binding.type ?? 'json',
+        ...(binding.description ? { description: binding.description } : {}),
+        ...(binding.required !== undefined ? { required: binding.required } : {}),
+        ...(binding.default !== undefined ? { default: binding.default } : {}),
+        ...(binding.enum ? { enum: [...binding.enum] } : {}),
+        ...(binding.from ? { from: binding.from } : {}),
+    }));
+}
+function outputBindingsToPorts(bindings) {
+    if (!bindings || Object.keys(bindings).length === 0)
+        return undefined;
+    return Object.entries(bindings).map(([name, binding]) => ({
+        name,
+        type: binding.type ?? 'json',
+        ...(binding.description ? { description: binding.description } : {}),
+        ...(binding.default !== undefined ? { default: binding.default } : {}),
+        ...(binding.enum ? { enum: [...binding.enum] } : {}),
+    }));
+}
+function taskBindingsAsPorts(task) {
+    const inputs = inputBindingsToPorts(task.inputs);
+    const outputs = outputBindingsToPorts(task.outputs);
+    if (!inputs && !outputs)
+        return undefined;
+    return {
+        ...(inputs ? { inputs } : {}),
+        ...(outputs ? { outputs } : {}),
+    };
+}
+export function inferEffectivePorts(ctx, taskId) {
+    const node = ctx.dag.nodes.get(taskId);
+    const task = node.task;
+    const isPromptTask = isPromptTaskConfig(task);
+    if (!isPromptTask) {
+        return { kind: 'ready', isPromptTask: false, effectivePorts: taskBindingsAsPorts(task) };
+    }
+    const inference = inferPromptPorts({
+        upstreams: node.dependsOn.map((upstreamId) => {
+            const upstream = ctx.dag.nodes.get(upstreamId);
+            const isUpstreamCommand = upstream ? isCommandTaskConfig(upstream.task) : false;
+            return {
+                taskId: upstreamId,
+                outputs: isUpstreamCommand ? outputBindingsToPorts(upstream?.task.outputs) : undefined,
+            };
+        }),
+        downstreams: (ctx.directDownstreams.get(taskId) ?? []).map((downstreamId) => {
+            const downstream = ctx.dag.nodes.get(downstreamId);
+            const isDownstreamCommand = downstream ? isCommandTaskConfig(downstream.task) : false;
+            return {
+                taskId: downstreamId,
+                inputs: isDownstreamCommand ? inputBindingsToPorts(downstream?.task.inputs) : undefined,
+            };
+        }),
+    });
+    if (inference.inputConflicts.length > 0 || inference.outputConflicts.length > 0) {
+        const lines = [];
+        for (const conflict of inference.inputConflicts)
+            lines.push(conflict.reason);
+        for (const conflict of inference.outputConflicts)
+            lines.push(conflict.reason);
+        return { kind: 'blocked', reason: lines.join('\n') };
+    }
+    return { kind: 'ready', isPromptTask: true, effectivePorts: inference.ports };
+}
+export function extractSuccessfulOutputs(options) {
+    const { task, effectivePorts, result } = options;
+    let extractedOutputs = null;
+    const bindingExtraction = extractTaskBindingOutputs(task.outputs, result.stdout, result.stderr, result.normalizedOutput);
+    if (task.outputs && Object.keys(task.outputs).length > 0) {
+        extractedOutputs = bindingExtraction.outputs;
+    }
+    if ((!task.outputs || Object.keys(task.outputs).length === 0) && effectivePorts?.outputs?.length) {
+        const portExtraction = extractTaskOutputs(effectivePorts, result.stdout, result.normalizedOutput);
+        extractedOutputs = portExtraction.outputs;
+        return {
+            outputs: extractedOutputs,
+            bindingDiagnostic: bindingExtraction.diagnostic,
+            portDiagnostic: portExtraction.diagnostic,
+        };
+    }
+    return {
+        outputs: extractedOutputs,
+        bindingDiagnostic: bindingExtraction.diagnostic,
+        portDiagnostic: null,
+    };
+}
+//# sourceMappingURL=dataflow.js.map

package/dist/core/dataflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataflow.js","sourceRoot":"","sources":["../../src/core/dataflow.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,SAAS,kBAAkB,CACzB,IAAgB;IAEhB,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;AACjE,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAgB;IAEhB,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;AACjE,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAuC;IACnE,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACtE,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QAC5B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAwC;IACrE,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACtE,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QAC5B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAgB;IAC3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAaD,MAAM,UAAU,mBAAmB,CACjC,GAAe,EACf,MAAc;IAEd,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAE9C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3F,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;YAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC/C,MAAM,iBAAiB,GAAG,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAChF,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;aACvF,CAAC;QACJ,CAAC,CAAC;QACF,WAAW,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;YAC1E,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACnD,MAAM,mBAAmB,GAAG,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACtF,OAAO;gBACL,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;aACxF,CAAC;QACJ,CAAC,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,cAAc;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7E,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,eAAe;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;AAChF,CAAC;AAcD,MAAM,UAAU,wBAAwB,CACtC,OAAwC;IAExC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACjD,IAAI,gBAAgB,GAA6C,IAAI,CAAC;IAEtE,MAAM,iBAAiB,GAAG,yBAAyB,CACjD,IAAI,CAAC,OAAO,EACZ,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,gBAAgB,CACxB,CAAC;IACF,IAAI,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACjG,MAAM,cAAc,GAAG,kBAAkB,CACvC,cAAc,EACd,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,gBAAgB,CACxB,CAAC;QACF,gBAAgB,GAAG,cAAc,CAAC,OAAO,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE,gBAAgB;YACzB,iBAAiB,EAAE,iBAAiB,CAAC,UAAU;YAC/C,cAAc,EAAE,cAAc,CAAC,UAAU;SAC1C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,gBAAgB;QACzB,iBAAiB,EAAE,iBAAiB,CAAC,UAAU;QAC/C,cAAc,EAAE,IAAI;KACrB,CAAC;AACJ,CAAC"}

package/dist/core/log-prune.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Delete the oldest subdirectories under `logsDir`, keeping only the
+ * most recent `keep` total runs (including the currently-live run
+ * identified by `excludeRunId`). Directories are sorted
+ * lexicographically; because runIds are prefixed with a base-36
+ * timestamp, lexicographic order equals chronological order.
+ *
+ * `excludeRunId` is always skipped from deletion even if it would
+ * otherwise be pruned — this prevents a concurrent run from removing a
+ * live log directory that is still in use.
+ *
+ * The live run occupies one slot out of `keep`, so the maximum number
+ * of *historical* dirs to retain is `keep - 1`.
+ */
+export declare function pruneLogDirs(logsDir: string, keep: number, excludeRunId: string): Promise<void>;
+//# sourceMappingURL=log-prune.d.ts.map

package/dist/core/log-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-prune.d.ts","sourceRoot":"","sources":["../../src/core/log-prune.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/core/log-prune.js

@@ -0,0 +1,34 @@
+import { readdir, rm } from 'node:fs/promises';
+import { resolve } from 'node:path';
+/**
+ * Delete the oldest subdirectories under `logsDir`, keeping only the
+ * most recent `keep` total runs (including the currently-live run
+ * identified by `excludeRunId`). Directories are sorted
+ * lexicographically; because runIds are prefixed with a base-36
+ * timestamp, lexicographic order equals chronological order.
+ *
+ * `excludeRunId` is always skipped from deletion even if it would
+ * otherwise be pruned — this prevents a concurrent run from removing a
+ * live log directory that is still in use.
+ *
+ * The live run occupies one slot out of `keep`, so the maximum number
+ * of *historical* dirs to retain is `keep - 1`.
+ */
+export async function pruneLogDirs(logsDir, keep, excludeRunId) {
+    let entries;
+    try {
+        entries = await readdir(logsDir);
+    }
+    catch {
+        return; // logsDir doesn't exist yet
+    }
+    const runDirs = entries
+        .filter((e) => e.startsWith('run_') && e !== excludeRunId)
+        .sort();
+    const historyKeep = Math.max(0, keep - 1);
+    const toDelete = runDirs.slice(0, Math.max(0, runDirs.length - historyKeep));
+    await Promise.all(toDelete.map((dir) => rm(resolve(logsDir, dir), { recursive: true, force: true }).catch(() => {
+        // Ignore deletion errors — stale dirs are better than a crash
+    })));
+}
+//# sourceMappingURL=log-prune.js.map

package/dist/core/log-prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-prune.js","sourceRoot":"","sources":["../../src/core/log-prune.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,IAAY,EACZ,YAAoB;IAEpB,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,4BAA4B;IACtC,CAAC;IAED,MAAM,OAAO,GAAG,OAAO;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC;SACzD,IAAI,EAAE,CAAC;IACV,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;IAE7E,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACnB,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACrE,8DAA8D;IAChE,CAAC,CAAC,CACH,CACF,CAAC;AACJ,CAAC"}

package/dist/core/preflight.d.ts

@@ -0,0 +1,13 @@
+import type { PipelineConfig } from '../types';
+import type { Dag } from '../dag';
+import type { PluginRegistry } from '../registry';
+/**
+ * Validate that every plugin referenced by the pipeline (drivers,
+ * triggers, completions, middlewares) is registered, and that
+ * `continue_from` is only used between drivers that can hand off via
+ * sessionResume or text-injection. Throws with all errors aggregated
+ * into one message so the caller sees every misconfiguration in a
+ * single pass.
+ */
+export declare function preflight(config: PipelineConfig, dag: Dag, registry: PluginRegistry): void;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/core/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/core/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,UAAU,CAAC;AACzE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,cAAc,GACvB,IAAI,CAkEN"}

package/dist/core/preflight.js

@@ -0,0 +1,61 @@
+function isCommandOnly(task) {
+    return task.command !== undefined && task.prompt === undefined;
+}
+/**
+ * Validate that every plugin referenced by the pipeline (drivers,
+ * triggers, completions, middlewares) is registered, and that
+ * `continue_from` is only used between drivers that can hand off via
+ * sessionResume or text-injection. Throws with all errors aggregated
+ * into one message so the caller sees every misconfiguration in a
+ * single pass.
+ */
+export function preflight(config, dag, registry) {
+    const errors = [];
+    for (const [, node] of dag.nodes) {
+        const task = node.task;
+        const track = node.track;
+        const driverName = task.driver ?? track.driver ?? config.driver ?? 'opencode';
+        const isCommand = isCommandOnly(task);
+        if (!isCommand && !registry.hasHandler('drivers', driverName)) {
+            errors.push(`Task "${node.taskId}": driver "${driverName}" not registered`);
+        }
+        if (task.trigger && !registry.hasHandler('triggers', task.trigger.type)) {
+            errors.push(`Task "${node.taskId}": trigger type "${task.trigger.type}" not registered`);
+        }
+        if (task.completion && !registry.hasHandler('completions', task.completion.type)) {
+            errors.push(`Task "${node.taskId}": completion type "${task.completion.type}" not registered`);
+        }
+        const mws = task.middlewares ?? track.middlewares ?? [];
+        for (const mw of mws) {
+            if (!registry.hasHandler('middlewares', mw.type)) {
+                errors.push(`Task "${node.taskId}": middleware type "${mw.type}" not registered`);
+            }
+        }
+        if (task.continue_from && registry.hasHandler('drivers', driverName)) {
+            const driver = registry.getHandler('drivers', driverName);
+            if (!driver.capabilities.sessionResume) {
+                const upstreamId = node.resolvedContinueFrom;
+                if (upstreamId) {
+                    const upstream = dag.nodes.get(upstreamId);
+                    if (upstream) {
+                        const upstreamDriverName = upstream.task.driver ?? upstream.track.driver ?? config.driver ?? 'opencode';
+                        const upstreamDriver = registry.hasHandler('drivers', upstreamDriverName)
+                            ? registry.getHandler('drivers', upstreamDriverName)
+                            : null;
+                        const canNormalize = typeof upstreamDriver?.parseResult === 'function';
+                        if (!canNormalize) {
+                            errors.push(`Task "${node.taskId}" uses continue_from: "${task.continue_from}", ` +
+                                `but upstream task "${upstreamId}" its driver ` +
+                                `does not implement parseResult for text-injection handoff. ` +
+                                `Use a driver with parseResult, or remove continue_from.`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Preflight validation failed:\n  - ${errors.join('\n  - ')}`);
+    }
+}
+//# sourceMappingURL=preflight.js.map

package/dist/core/preflight.js.map

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

package/dist/core/run-context.d.ts

@@ -0,0 +1,55 @@
+import type { AbortReason, OnFailure, PipelineConfig, RunEventPayload, TaskState, TaskStatus } from '../types';
+import type { Dag } from '../dag';
+import type { UpstreamBindingData } from '../ports';
+import { type PipelineInfo, type TaskInfo, type TrackInfo } from '../hooks';
+import type { TagmaRuntime } from '../types';
+export interface RunContextOptions {
+    readonly runId: string;
+    readonly dag: Dag;
+    readonly config: PipelineConfig;
+    readonly workDir: string;
+    readonly pipelineInfo: PipelineInfo;
+    readonly onEvent?: (event: RunEventPayload) => void;
+    readonly runtime: TagmaRuntime;
+}
+/**
+ * Per-run state container. Owns the maps and abort tracking that
+ * `runPipeline` previously held as closure locals, plus the small
+ * methods that read/write that state. Scheduler, dataflow, and
+ * task-executor extractions in later phases pass `ctx` instead of
+ * relying on closure capture.
+ */
+export declare class RunContext {
+    readonly runId: string;
+    readonly dag: Dag;
+    readonly config: PipelineConfig;
+    readonly workDir: string;
+    readonly pipelineInfo: PipelineInfo;
+    readonly onEvent?: (event: RunEventPayload) => void;
+    readonly runtime: TagmaRuntime;
+    readonly states: Map<string, TaskState>;
+    readonly sessionMap: Map<string, string>;
+    readonly normalizedMap: Map<string, string>;
+    readonly outputValuesMap: Map<string, Readonly<Record<string, unknown>>>;
+    readonly bindingDataMap: Map<string, UpstreamBindingData>;
+    readonly resolvedInputsMap: Map<string, Readonly<Record<string, unknown>>>;
+    readonly directDownstreams: Map<string, string[]>;
+    readonly abortController: AbortController;
+    abortReason: AbortReason | null;
+    constructor(options: RunContextOptions);
+    emit(event: RunEventPayload): void;
+    setTaskStatus(taskId: string, newStatus: TaskStatus): void;
+    getOnFailure(taskId: string): OnFailure;
+    isDependencySatisfied(depId: string): 'satisfied' | 'unsatisfied' | 'skip';
+    /**
+     * H3: stop_all marks every still-waiting task across every track as
+     * skipped and aborts in-flight tasks via the shared signal. The
+     * terminal lock in setTaskStatus prevents any later re-transition
+     * should a completed running task try to overwrite the skipped state.
+     */
+    applyStopAll(): void;
+    buildTaskInfoObj(taskId: string): TaskInfo;
+    trackInfoOf(taskId: string): TrackInfo;
+    fireHook(taskId: string, event: 'task_success' | 'task_failure'): Promise<void>;
+}
+//# sourceMappingURL=run-context.d.ts.map

package/dist/core/run-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.d.ts","sourceRoot":"","sources":["../../src/core/run-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EAET,cAAc,EACd,eAAe,EAEf,SAAS,EACT,UAAU,EACX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAU7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAE/B,QAAQ,CAAC,MAAM,yBAAgC;IAC/C,QAAQ,CAAC,UAAU,sBAA6B;IAChD,QAAQ,CAAC,aAAa,sBAA6B;IACnD,QAAQ,CAAC,eAAe,iDAAwD;IAChF,QAAQ,CAAC,cAAc,mCAA0C;IACjE,QAAQ,CAAC,iBAAiB,iDAAwD;IAClF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,eAAe,kBAAyB;IACjD,WAAW,EAAE,WAAW,GAAG,IAAI,CAAQ;gBAE3B,OAAO,EAAE,iBAAiB;IA8BtC,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAIlC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI;IAmC1D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAIvC,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM;IAiB1E;;;;;OAKG;IACH,YAAY,IAAI,IAAI;IAWpB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAgB1C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAKhC,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,GAAG,cAAc,GACrC,OAAO,CAAC,IAAI,CAAC;CAejB"}

package/dist/core/run-context.js

@@ -0,0 +1,158 @@
+import { executeHook, buildTaskContext, } from '../hooks';
+import { isTerminal } from './run-state';
+import { nowISO } from '../utils';
+function isPromptTaskConfig(task) {
+    return task.prompt !== undefined && task.command === undefined;
+}
+/**
+ * Per-run state container. Owns the maps and abort tracking that
+ * `runPipeline` previously held as closure locals, plus the small
+ * methods that read/write that state. Scheduler, dataflow, and
+ * task-executor extractions in later phases pass `ctx` instead of
+ * relying on closure capture.
+ */
+export class RunContext {
+    runId;
+    dag;
+    config;
+    workDir;
+    pipelineInfo;
+    onEvent;
+    runtime;
+    states = new Map();
+    sessionMap = new Map();
+    normalizedMap = new Map();
+    outputValuesMap = new Map();
+    bindingDataMap = new Map();
+    resolvedInputsMap = new Map();
+    directDownstreams;
+    abortController = new AbortController();
+    abortReason = null;
+    constructor(options) {
+        this.runId = options.runId;
+        this.dag = options.dag;
+        this.config = options.config;
+        this.workDir = options.workDir;
+        this.pipelineInfo = options.pipelineInfo;
+        this.onEvent = options.onEvent;
+        this.runtime = options.runtime;
+        for (const [id, node] of this.dag.nodes) {
+            this.states.set(id, {
+                config: node.task,
+                trackConfig: node.track,
+                status: 'idle',
+                result: null,
+                startedAt: null,
+                finishedAt: null,
+            });
+        }
+        this.directDownstreams = new Map();
+        for (const [id] of this.dag.nodes)
+            this.directDownstreams.set(id, []);
+        for (const [id, node] of this.dag.nodes) {
+            for (const upstream of node.dependsOn) {
+                const list = this.directDownstreams.get(upstream);
+                if (list)
+                    list.push(id);
+            }
+        }
+    }
+    emit(event) {
+        this.onEvent?.(event);
+    }
+    setTaskStatus(taskId, newStatus) {
+        const state = this.states.get(taskId);
+        // Terminal lock: once a task reaches a terminal state it must not be
+        // re-transitioned. This prevents stop_all from marking running tasks as
+        // skipped and then having their in-flight processTask promise overwrite
+        // that with success/failed, producing an invalid double transition.
+        if (isTerminal(state.status))
+            return;
+        state.status = newStatus;
+        const result = state.result;
+        const cfg = state.config;
+        this.emit({
+            type: 'task_update',
+            runId: this.runId,
+            taskId,
+            status: newStatus,
+            startedAt: state.startedAt ?? undefined,
+            finishedAt: state.finishedAt ?? undefined,
+            durationMs: result?.durationMs,
+            exitCode: result?.exitCode,
+            stdout: result?.stdout,
+            stderr: result?.stderr,
+            stdoutPath: result?.stdoutPath ?? null,
+            stderrPath: result?.stderrPath ?? null,
+            stdoutBytes: result?.stdoutBytes ?? null,
+            stderrBytes: result?.stderrBytes ?? null,
+            sessionId: result?.sessionId ?? null,
+            normalizedOutput: result?.normalizedOutput ?? null,
+            inputs: this.resolvedInputsMap.get(taskId) ?? null,
+            outputs: this.outputValuesMap.get(taskId) ?? null,
+            resolvedDriver: cfg.driver ?? null,
+            resolvedModel: cfg.model ?? null,
+            resolvedPermissions: cfg.permissions ?? null,
+        });
+    }
+    getOnFailure(taskId) {
+        return this.dag.nodes.get(taskId)?.track.on_failure ?? 'skip_downstream';
+    }
+    isDependencySatisfied(depId) {
+        const depState = this.states.get(depId);
+        if (!depState)
+            return 'skip';
+        switch (depState.status) {
+            case 'success':
+                return 'satisfied';
+            case 'skipped':
+                return 'skip';
+            case 'failed':
+            case 'timeout':
+            case 'blocked':
+                return this.getOnFailure(depId) === 'ignore' ? 'satisfied' : 'skip';
+            default:
+                return 'unsatisfied';
+        }
+    }
+    /**
+     * H3: stop_all marks every still-waiting task across every track as
+     * skipped and aborts in-flight tasks via the shared signal. The
+     * terminal lock in setTaskStatus prevents any later re-transition
+     * should a completed running task try to overwrite the skipped state.
+     */
+    applyStopAll() {
+        if (this.abortReason === null)
+            this.abortReason = 'stop_all';
+        this.abortController.abort();
+        for (const [id, state] of this.states) {
+            if (state.status === 'waiting') {
+                state.finishedAt = nowISO();
+                this.setTaskStatus(id, 'skipped');
+            }
+        }
+    }
+    buildTaskInfoObj(taskId) {
+        const state = this.states.get(taskId);
+        return {
+            id: taskId,
+            name: state.config.name,
+            type: isPromptTaskConfig(state.config) ? 'ai' : 'command',
+            status: state.status,
+            exit_code: state.result?.exitCode ?? null,
+            duration_ms: state.result?.durationMs ?? null,
+            stderr_path: state.result?.stderrPath ?? null,
+            session_id: state.result?.sessionId ?? null,
+            started_at: state.startedAt,
+            finished_at: state.finishedAt,
+        };
+    }
+    trackInfoOf(taskId) {
+        const node = this.dag.nodes.get(taskId);
+        return { id: node.track.id, name: node.track.name };
+    }
+    async fireHook(taskId, event) {
+        await executeHook(this.config.hooks, event, buildTaskContext(event, this.pipelineInfo, this.trackInfoOf(taskId), this.buildTaskInfoObj(taskId)), this.runtime, this.workDir, this.abortController.signal);
+    }
+}
+//# sourceMappingURL=run-context.js.map