condukt 0.1.0

package/dist/src/agent.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Agent node factory — wraps an AgentRuntime session as a NodeFn.
+ *
+ * Lifecycle: delete stale artifact → setup → build prompt → create session →
+ * wire events → send prompt → await idle/error → read artifact → teardown.
+ *
+ * Implements GT-3 dual-condition crash recovery: if a session errors out but
+ * both a completion indicator was seen in output AND the artifact file exists
+ * on disk with real content, treat the run as successful.
+ */
+import type { AgentConfig, NodeFn } from './types';
+/**
+ * Checks both conditions required to treat a crashed session as successful:
+ * 1. At least one completion indicator string appears in the output lines
+ * 2. The artifact file exists on disk with non-trivial content (> 10 chars)
+ *
+ * Both conditions must hold. Either alone produces false positives (GT-3).
+ */
+export declare function wasCompletedBeforeCrash(dir: string, outputFile: string, outputLines: readonly string[], indicators?: readonly string[]): boolean;
+/**
+ * Creates a NodeFn that manages a full agent session lifecycle.
+ *
+ * The returned function:
+ * 1. Deletes any stale artifact from a prior run
+ * 2. Calls config.setup(input) if provided (R5, R10)
+ * 3. Builds the prompt via config.promptBuilder(input)
+ * 4. Creates a session via ctx.runtime.createSession()
+ * 5. Wires session events to ctx.emitOutput for streaming
+ * 6. Sends the prompt and awaits completion (idle) or error
+ * 7. On error: attempts GT-3 crash recovery
+ * 8. On success: reads artifact, parses action
+ * 9. Calls config.teardown(input) in finally block
+ */
+export declare function agent(config: AgentConfig): NodeFn;
+//# sourceMappingURL=agent.d.ts.map

package/dist/src/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,WAAW,EAGX,MAAM,EAIP,MAAM,SAAS,CAAC;AAcjB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAsBT;AAkBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAoKjD"}

package/dist/src/agent.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * Agent node factory — wraps an AgentRuntime session as a NodeFn.
+ *
+ * Lifecycle: delete stale artifact → setup → build prompt → create session →
+ * wire events → send prompt → await idle/error → read artifact → teardown.
+ *
+ * Implements GT-3 dual-condition crash recovery: if a session errors out but
+ * both a completion indicator was seen in output AND the artifact file exists
+ * on disk with real content, treat the run as successful.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wasCompletedBeforeCrash = wasCompletedBeforeCrash;
+exports.agent = agent;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const types_1 = require("./types");
+// ---------------------------------------------------------------------------
+// GT-3 dual-condition crash recovery helper
+// ---------------------------------------------------------------------------
+const DEFAULT_COMPLETION_INDICATORS = [
+    'Done.',
+    'completed',
+    'CONFIRMED',
+    'finished',
+];
+/**
+ * Checks both conditions required to treat a crashed session as successful:
+ * 1. At least one completion indicator string appears in the output lines
+ * 2. The artifact file exists on disk with non-trivial content (> 10 chars)
+ *
+ * Both conditions must hold. Either alone produces false positives (GT-3).
+ */
+function wasCompletedBeforeCrash(dir, outputFile, outputLines, indicators) {
+    const indicatorList = indicators ?? DEFAULT_COMPLETION_INDICATORS;
+    // Condition 1: any indicator found in any output line
+    const hasIndicator = outputLines.some((line) => indicatorList.some((ind) => line.includes(ind)));
+    // Condition 2: artifact exists with real content
+    let hasArtifact = false;
+    try {
+        const artifactPath = path.join(dir, outputFile);
+        if (fs.existsSync(artifactPath)) {
+            const content = fs.readFileSync(artifactPath, 'utf-8');
+            hasArtifact = content.trim().length > 10;
+        }
+    }
+    catch {
+        // File doesn't exist or can't be read
+        hasArtifact = false;
+    }
+    return hasIndicator && hasArtifact;
+}
+// ---------------------------------------------------------------------------
+// Prompt formatting
+// ---------------------------------------------------------------------------
+function formatPrompt(promptOutput) {
+    if (typeof promptOutput === 'string') {
+        return promptOutput;
+    }
+    // Structured prompt: combine system + user with clear delimiters
+    return `${promptOutput.system}\n\n${promptOutput.user}`;
+}
+// ---------------------------------------------------------------------------
+// Agent factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a NodeFn that manages a full agent session lifecycle.
+ *
+ * The returned function:
+ * 1. Deletes any stale artifact from a prior run
+ * 2. Calls config.setup(input) if provided (R5, R10)
+ * 3. Builds the prompt via config.promptBuilder(input)
+ * 4. Creates a session via ctx.runtime.createSession()
+ * 5. Wires session events to ctx.emitOutput for streaming
+ * 6. Sends the prompt and awaits completion (idle) or error
+ * 7. On error: attempts GT-3 crash recovery
+ * 8. On success: reads artifact, parses action
+ * 9. Calls config.teardown(input) in finally block
+ */
+function agent(config) {
+    return async (input, ctx) => {
+        // Abort check: bail early if already aborted
+        if (ctx.signal.aborted) {
+            throw new types_1.FlowAbortedError('Aborted before agent start');
+        }
+        // Step 1: Delete stale artifact
+        if (config.output) {
+            const artifactPath = path.join(input.dir, config.output);
+            try {
+                if (fs.existsSync(artifactPath)) {
+                    fs.unlinkSync(artifactPath);
+                }
+            }
+            catch {
+                // Ignore — may not exist
+            }
+        }
+        // Step 2: Call setup hook (R5: runs before EVERY agent execution, R10: receives full NodeInput)
+        if (config.setup) {
+            await config.setup(input);
+        }
+        let session = null;
+        const outputLines = [];
+        try {
+            // Step 3: Build prompt
+            const promptOutput = config.promptBuilder(input);
+            const promptStr = formatPrompt(promptOutput);
+            // Step 4: Create session (COMP-3: cwdResolver overrides cwd for repo access)
+            const sessionCwd = config.cwdResolver ? config.cwdResolver(input) : input.dir;
+            session = await ctx.runtime.createSession({
+                model: config.model ?? 'claude-opus-4.6',
+                cwd: sessionCwd,
+                addDirs: config.isolation ? [] : [input.dir],
+                timeout: config.timeout ?? 3600,
+                heartbeatTimeout: config.heartbeatTimeout ?? 120,
+            });
+            // Abort check after session creation
+            if (ctx.signal.aborted) {
+                await session.abort();
+                throw new types_1.FlowAbortedError('Aborted after session creation');
+            }
+            // Step 5: Wire session events to emitOutput
+            session.on('text', (text) => {
+                outputLines.push(text);
+                ctx.emitOutput({
+                    type: 'node:output',
+                    executionId: ctx.executionId,
+                    nodeId: ctx.nodeId,
+                    content: text,
+                    ts: Date.now(),
+                });
+            });
+            session.on('tool_start', (tool, toolInput) => {
+                ctx.emitOutput({
+                    type: 'node:tool',
+                    executionId: ctx.executionId,
+                    nodeId: ctx.nodeId,
+                    tool,
+                    phase: 'start',
+                    summary: toolInput.substring(0, 200),
+                    ts: Date.now(),
+                });
+            });
+            session.on('tool_complete', (tool, output) => {
+                ctx.emitOutput({
+                    type: 'node:tool',
+                    executionId: ctx.executionId,
+                    nodeId: ctx.nodeId,
+                    tool,
+                    phase: 'complete',
+                    summary: output.substring(0, 200),
+                    ts: Date.now(),
+                });
+            });
+            // Step 6: Send prompt
+            session.send(promptStr);
+            // Step 7: Wait for completion — wrap in a Promise that resolves on idle, rejects on error
+            const result = await new Promise((resolve, reject) => {
+                // Listen for abort signal during session execution
+                const onAbort = () => {
+                    session.abort().then(() => reject(new types_1.FlowAbortedError('Aborted during session execution')), () => reject(new types_1.FlowAbortedError('Aborted during session execution')));
+                };
+                ctx.signal.addEventListener('abort', onAbort, { once: true });
+                session.on('idle', () => {
+                    ctx.signal.removeEventListener('abort', onAbort);
+                    resolve('idle');
+                });
+                session.on('error', (err) => {
+                    ctx.signal.removeEventListener('abort', onAbort);
+                    reject(err);
+                });
+            }).catch((err) => {
+                // AI-4: Don't attempt GT-3 recovery on aborted sessions
+                if (ctx.signal.aborted) {
+                    throw err;
+                }
+                // Step 8: GT-3 dual-condition crash recovery
+                if (config.output &&
+                    wasCompletedBeforeCrash(input.dir, config.output, outputLines, config.completionIndicators)) {
+                    // Treat as success — artifact was written before crash
+                    return 'recovered';
+                }
+                throw err;
+            });
+            // Step 9: Handle success (idle or recovered)
+            let content;
+            if (config.output) {
+                const artifactPath = path.join(input.dir, config.output);
+                try {
+                    content = fs.readFileSync(artifactPath, 'utf-8');
+                }
+                catch {
+                    // Artifact not written — that's fine for nodes that don't always produce output
+                    content = undefined;
+                }
+            }
+            const action = config.actionParser && content
+                ? config.actionParser(content)
+                : 'default';
+            return { action, artifact: content };
+        }
+        finally {
+            // AI-1: Close session on all paths (abort is idempotent)
+            if (session) {
+                try {
+                    await session.abort();
+                }
+                catch {
+                    // Session may already be closed — ignore
+                }
+            }
+            // Step 10: Teardown (always runs, R10: receives full NodeInput)
+            if (config.teardown) {
+                try {
+                    await config.teardown(input);
+                }
+                catch {
+                    // Teardown errors should not mask the primary error
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/src/agent.js.map

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

package/dist/src/events.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Flow framework events — the complete event contract.
+ *
+ * 15 execution events (persisted to JSONL event log).
+ * 2 output events (streamed, not persisted in event log).
+ *
+ * All events carry executionId + ts. Zero domain types.
+ */
+export interface GraphNodeSkeleton {
+    readonly id: string;
+    readonly displayName: string;
+    readonly nodeType: string;
+    readonly model?: string;
+    readonly output?: string;
+}
+export interface GraphEdgeSkeleton {
+    readonly source: string;
+    readonly action: string;
+    readonly target: string;
+}
+export interface RunStartedEvent {
+    readonly type: 'run:started';
+    readonly executionId: string;
+    readonly flowId: string;
+    readonly params: Record<string, unknown>;
+    readonly graph: {
+        readonly nodes: readonly GraphNodeSkeleton[];
+        readonly edges: readonly GraphEdgeSkeleton[];
+    };
+    readonly ts: number;
+}
+export interface RunCompletedEvent {
+    readonly type: 'run:completed';
+    readonly executionId: string;
+    readonly status: 'completed' | 'failed' | 'stopped' | 'crashed';
+    readonly ts: number;
+}
+export interface RunResumedEvent {
+    readonly type: 'run:resumed';
+    readonly executionId: string;
+    readonly resumingFrom: readonly string[];
+    readonly ts: number;
+}
+export interface NodeStartedEvent {
+    readonly type: 'node:started';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly ts: number;
+}
+export interface NodeCompletedEvent {
+    readonly type: 'node:completed';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly action: string;
+    readonly elapsedMs: number;
+    readonly ts: number;
+}
+export interface NodeFailedEvent {
+    readonly type: 'node:failed';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly error: string;
+    readonly ts: number;
+}
+export interface NodeKilledEvent {
+    readonly type: 'node:killed';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly ts: number;
+}
+export interface NodeSkippedEvent {
+    readonly type: 'node:skipped';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly ts: number;
+}
+export interface NodeGatedEvent {
+    readonly type: 'node:gated';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly gateType: string;
+    readonly gateData?: Record<string, unknown>;
+    readonly ts: number;
+}
+export interface GateResolvedEvent {
+    readonly type: 'gate:resolved';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly resolution: string;
+    readonly reason?: string;
+    readonly ts: number;
+}
+export interface NodeRetryingEvent {
+    readonly type: 'node:retrying';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly attempt: number;
+    readonly override?: string;
+    readonly ts: number;
+}
+export interface EdgeTraversedEvent {
+    readonly type: 'edge:traversed';
+    readonly executionId: string;
+    readonly source: string;
+    readonly target: string;
+    readonly action: string;
+    readonly ts: number;
+}
+export interface ArtifactWrittenEvent {
+    readonly type: 'artifact:written';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly path: string;
+    readonly size: number;
+    readonly ts: number;
+}
+export interface CostRecordedEvent {
+    readonly type: 'cost:recorded';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly tokens: number;
+    readonly model: string;
+    readonly cost: number;
+    readonly ts: number;
+}
+export interface MetadataEvent {
+    readonly type: 'metadata';
+    readonly executionId: string;
+    readonly key: string;
+    readonly value: unknown;
+    readonly ts: number;
+}
+/** Discriminated union of all execution events (persisted to JSONL). */
+export type ExecutionEvent = RunStartedEvent | RunCompletedEvent | RunResumedEvent | NodeStartedEvent | NodeCompletedEvent | NodeFailedEvent | NodeKilledEvent | NodeSkippedEvent | NodeGatedEvent | GateResolvedEvent | NodeRetryingEvent | EdgeTraversedEvent | ArtifactWrittenEvent | CostRecordedEvent | MetadataEvent;
+export interface NodeOutputEvent {
+    readonly type: 'node:output';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly content: string;
+    readonly ts: number;
+}
+export interface NodeToolEvent {
+    readonly type: 'node:tool';
+    readonly executionId: string;
+    readonly nodeId: string;
+    readonly tool: string;
+    readonly phase: 'start' | 'complete';
+    readonly summary: string;
+    readonly ts: number;
+}
+/** Discriminated union of output events (streamed, not persisted). */
+export type OutputEvent = NodeOutputEvent | NodeToolEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/src/events.d.ts.map

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

package/dist/src/events.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Flow framework events — the complete event contract.
+ *
+ * 15 execution events (persisted to JSONL event log).
+ * 2 output events (streamed, not persisted in event log).
+ *
+ * All events carry executionId + ts. Zero domain types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=events.js.map

package/dist/src/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+export { run, computeFrontier, validateGraph } from './scheduler';
+export { agent, wasCompletedBeforeCrash } from './agent';
+export { deterministic, gate, resolveGate, _getGateRegistryForTesting } from './nodes';
+export { verify, property } from './verify';
+export type { NodeFn, NodeInput, NodeOutput, RetryContext, ExecutionContext, FlowGraph, NodeEntry, RunOptions, RunResult, ResumeState, AgentRuntime, AgentSession, SessionConfig, ToolRef, AgentConfig, PromptOutput, ExecutionProjection, ProjectionNode, ProjectionEdge, StorageEngine, OutputPage, ExecutionId, } from './types';
+export { getParams, FlowAbortedError, FlowValidationError } from './types';
+export type { ExecutionEvent, OutputEvent, RunStartedEvent, RunCompletedEvent, RunResumedEvent, NodeStartedEvent, NodeCompletedEvent, NodeFailedEvent, NodeKilledEvent, NodeSkippedEvent, NodeGatedEvent, GateResolvedEvent, NodeRetryingEvent, EdgeTraversedEvent, ArtifactWrittenEvent, CostRecordedEvent, MetadataEvent, NodeOutputEvent, NodeToolEvent, GraphNodeSkeleton, GraphEdgeSkeleton, } from './events';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAG5C,YAAY,EACV,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAC7D,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,SAAS,EAAE,WAAW,EAClC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAC7E,mBAAmB,EAAE,cAAc,EAAE,cAAc,EACnD,aAAa,EAAE,UAAU,EACzB,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG3E,YAAY,EACV,cAAc,EAAE,WAAW,EAC3B,eAAe,EAAE,iBAAiB,EAAE,eAAe,EACnD,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EACrD,eAAe,EAAE,gBAAgB,EAAE,cAAc,EACjD,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EACxD,oBAAoB,EAAE,iBAAiB,EAAE,aAAa,EACtD,eAAe,EAAE,aAAa,EAC9B,iBAAiB,EAAE,iBAAiB,GACrC,MAAM,UAAU,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowValidationError = exports.FlowAbortedError = exports.getParams = exports.property = exports.verify = exports._getGateRegistryForTesting = exports.resolveGate = exports.gate = exports.deterministic = exports.wasCompletedBeforeCrash = exports.agent = exports.validateGraph = exports.computeFrontier = exports.run = void 0;
+// Execution (scheduler + node factories)
+var scheduler_1 = require("./scheduler");
+Object.defineProperty(exports, "run", { enumerable: true, get: function () { return scheduler_1.run; } });
+Object.defineProperty(exports, "computeFrontier", { enumerable: true, get: function () { return scheduler_1.computeFrontier; } });
+Object.defineProperty(exports, "validateGraph", { enumerable: true, get: function () { return scheduler_1.validateGraph; } });
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "agent", { enumerable: true, get: function () { return agent_1.agent; } });
+Object.defineProperty(exports, "wasCompletedBeforeCrash", { enumerable: true, get: function () { return agent_1.wasCompletedBeforeCrash; } });
+var nodes_1 = require("./nodes");
+Object.defineProperty(exports, "deterministic", { enumerable: true, get: function () { return nodes_1.deterministic; } });
+Object.defineProperty(exports, "gate", { enumerable: true, get: function () { return nodes_1.gate; } });
+Object.defineProperty(exports, "resolveGate", { enumerable: true, get: function () { return nodes_1.resolveGate; } });
+Object.defineProperty(exports, "_getGateRegistryForTesting", { enumerable: true, get: function () { return nodes_1._getGateRegistryForTesting; } });
+var verify_1 = require("./verify");
+Object.defineProperty(exports, "verify", { enumerable: true, get: function () { return verify_1.verify; } });
+Object.defineProperty(exports, "property", { enumerable: true, get: function () { return verify_1.property; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "getParams", { enumerable: true, get: function () { return types_1.getParams; } });
+Object.defineProperty(exports, "FlowAbortedError", { enumerable: true, get: function () { return types_1.FlowAbortedError; } });
+Object.defineProperty(exports, "FlowValidationError", { enumerable: true, get: function () { return types_1.FlowValidationError; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAyC;AACzC,yCAAkE;AAAzD,gGAAA,GAAG,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,0GAAA,aAAa,OAAA;AAC5C,iCAAyD;AAAhD,8FAAA,KAAK,OAAA;AAAE,gHAAA,uBAAuB,OAAA;AACvC,iCAAuF;AAA9E,sGAAA,aAAa,OAAA;AAAE,6FAAA,IAAI,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,mHAAA,0BAA0B,OAAA;AACrE,mCAA4C;AAAnC,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAazB,iCAA2E;AAAlE,kGAAA,SAAS,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAAE,4GAAA,mBAAmB,OAAA"}

package/dist/src/nodes.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Non-agent node factories: deterministic() and gate().
+ *
+ * deterministic() — wraps a pure function as a NodeFn (ignores ExecutionContext).
+ * gate() — returns a blocking NodeFn resolved externally via resolveGate().
+ *
+ * Gate mechanism:
+ *   1. gate() creates a Promise + resolver, stores in module-level gateRegistry
+ *   2. The scheduler dispatches the gate node; it blocks on the Promise
+ *   3. External code (bridge/API) calls resolveGate() to unblock
+ *   4. The scheduler sees the gate complete normally and proceeds
+ *
+ * Gate nodes listen for abort signals so they can be cleanly cancelled.
+ * The gate registry is module-level (survives across requests but not restarts).
+ * Restart recovery: the scheduler re-dispatches gate nodes, creating fresh resolvers (CR4).
+ */
+import type { NodeFn, NodeInput, NodeOutput } from './types';
+/**
+ * Wraps a pure async function as a NodeFn.
+ * The ExecutionContext is available but typically unused — deterministic nodes
+ * don't need runtime services or streaming output.
+ *
+ * @param _name - Display name (used for logging/debugging, not stored here)
+ * @param fn - The computation. Receives NodeInput, returns NodeOutput.
+ */
+export declare function deterministic(_name: string, fn: (input: NodeInput) => Promise<NodeOutput>): NodeFn;
+interface GateEntry {
+    resolve: (output: NodeOutput) => void;
+    reject: (err: Error) => void;
+}
+/**
+ * Expose the registry for testing purposes only.
+ * @internal
+ */
+export declare function _getGateRegistryForTesting(): Map<string, GateEntry>;
+/**
+ * Creates a NodeFn that blocks until externally resolved via resolveGate().
+ *
+ * The gate:
+ * - Registers a Promise resolver in the module-level gateRegistry
+ * - Blocks (awaits the Promise) until resolveGate() is called
+ * - Listens for abort signal to clean up on cancellation
+ * - Returns { action: resolution } when resolved (e.g., 'approved', 'rejected')
+ *
+ * The scheduler emits node:gated after dispatching gate-type nodes.
+ * The bridge emits gate:resolved when calling resolveGate().
+ *
+ * @param name - Optional gate type name (e.g., 'approval', 'quality-review').
+ *               Used by the scheduler for the node:gated event's gateType field.
+ */
+export declare function gate(name?: string): NodeFn;
+/**
+ * Resolves a waiting gate node, unblocking the scheduler.
+ *
+ * @param executionId - The execution containing the gate
+ * @param nodeId - The gate node's ID
+ * @param resolution - The action string (e.g., 'approved', 'rejected')
+ * @param _reason - Optional human-readable reason (for audit, not used in output)
+ * @returns true if the gate was found and resolved, false otherwise
+ */
+export declare function resolveGate(executionId: string, nodeId: string, resolution: string, _reason?: string): boolean;
+export {};
+//# sourceMappingURL=nodes.d.ts.map

package/dist/src/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/nodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAEV,MAAM,EACN,SAAS,EACT,UAAU,EACX,MAAM,SAAS,CAAC;AAOjB;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,GAC5C,MAAM,CAIR;AAMD,UAAU,SAAS;IACjB,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC9B;AAaD;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAEnE;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CA0B1C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAWT"}