@substrate-ai/factory 0.19.54

package/dist/handlers/__tests__/tool-scenario.test.js

@@ -0,0 +1,222 @@
+/**
+ * Unit tests for the tool handler — scenario result detection (story 44-5).
+ *
+ * Covers:
+ *   AC2 — tool handler detects ScenarioRunResult JSON via duck-typing
+ *   AC3 — 3/4 pass → satisfaction_score 0.75, no {node.id}.output key
+ *   AC4 — 0/2 pass → satisfaction_score 0.0, status SUCCESS
+ *   Non-scenario JSON / plain text → falls through to {node.id}.output path
+ *   Non-zero exit → FAILURE (existing behavior unchanged)
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { EventEmitter } from 'events';
+import { computeSatisfactionScore } from '../../scenarios/scorer.js';
+// vi.mock is hoisted automatically by Vitest.
+vi.mock('child_process', () => ({
+    spawn: vi.fn(),
+}));
+import { spawn } from 'child_process';
+import { GraphContext } from '../../graph/context.js';
+import { createToolHandler } from '../tool.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const mockSpawn = vi.mocked(spawn);
+/** Minimal GraphNode factory for tool nodes. */
+function makeNode(overrides = {}) {
+    return {
+        id: 'validate',
+        label: 'Validate Scenarios',
+        shape: 'parallelogram',
+        type: 'tool',
+        prompt: '',
+        maxRetries: 0,
+        goalGate: false,
+        retryTarget: '',
+        fallbackRetryTarget: '',
+        fidelity: '',
+        threadId: '',
+        class: '',
+        timeout: 0,
+        llmModel: '',
+        llmProvider: '',
+        reasoningEffort: '',
+        autoStatus: false,
+        allowPartial: false,
+        toolCommand: 'substrate scenarios run --format json',
+        backend: '',
+        ...overrides,
+    };
+}
+/** Minimal Graph stub — not needed by tool handler. */
+const stubGraph = {};
+/**
+ * Create a mock child process that emits stdout/stderr and closes with exitCode.
+ * Events fire asynchronously via setImmediate (matching the story test spec).
+ */
+function createMockProcess(options) {
+    const stdoutEmitter = new EventEmitter();
+    const stderrEmitter = new EventEmitter();
+    const procEmitter = new EventEmitter();
+    const mockProc = {
+        stdout: stdoutEmitter,
+        stderr: stderrEmitter,
+        on: procEmitter.on.bind(procEmitter),
+    };
+    setImmediate(() => {
+        if (options.stdout) {
+            stdoutEmitter.emit('data', Buffer.from(options.stdout));
+        }
+        if (options.stderr) {
+            stderrEmitter.emit('data', Buffer.from(options.stderr));
+        }
+        procEmitter.emit('close', options.exitCode ?? 0);
+    });
+    return mockProc;
+}
+/** Build a ScenarioRunResult stub for testing. */
+function makeScenarioRunResult(total, passed) {
+    return {
+        scenarios: [],
+        summary: { total, passed, failed: total - passed },
+        durationMs: 10,
+    };
+}
+// ---------------------------------------------------------------------------
+// Test setup / teardown
+// ---------------------------------------------------------------------------
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+afterEach(() => {
+    vi.clearAllMocks();
+});
+// ---------------------------------------------------------------------------
+// AC2 / AC3 — ScenarioRunResult JSON → satisfaction_score in context
+// ---------------------------------------------------------------------------
+describe('tool handler — scenario JSON detection (AC2, AC3)', () => {
+    it('writes satisfaction_score to context when stdout is valid ScenarioRunResult JSON', async () => {
+        const resultJson = JSON.stringify(makeScenarioRunResult(4, 3));
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: resultJson, exitCode: 0 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode(), ctx, stubGraph);
+        expect(outcome.status).toBe('SUCCESS');
+        expect(outcome.contextUpdates?.['satisfaction_score']).toBe(0.75);
+    });
+    it('does NOT set {node.id}.output when scenario JSON is detected (AC3)', async () => {
+        const resultJson = JSON.stringify(makeScenarioRunResult(4, 3));
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: resultJson, exitCode: 0 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode({ id: 'validate' }), ctx, stubGraph);
+        expect(outcome.contextUpdates?.['validate.output']).toBeUndefined();
+    });
+    it('writes satisfaction_score 0.0 when 0 of 2 scenarios pass (AC4)', async () => {
+        const resultJson = JSON.stringify(makeScenarioRunResult(2, 0));
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: resultJson, exitCode: 0 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode(), ctx, stubGraph);
+        expect(outcome.status).toBe('SUCCESS');
+        expect(outcome.contextUpdates?.['satisfaction_score']).toBe(0.0);
+    });
+    it('status is SUCCESS even when satisfaction_score is 0.0 (AC4 — downstream conditional routes)', async () => {
+        const resultJson = JSON.stringify(makeScenarioRunResult(2, 0));
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: resultJson, exitCode: 0 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode(), ctx, stubGraph);
+        expect(outcome.status).toBe('SUCCESS');
+        expect(outcome.failureReason).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// Non-scenario stdout → falls through to {node.id}.output
+// ---------------------------------------------------------------------------
+describe('tool handler — non-scenario stdout falls through to default path', () => {
+    it('stores plain text stdout as {node.id}.output when not ScenarioRunResult JSON', async () => {
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: 'deployment done\n', exitCode: 0 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode({ id: 'deploy' }), ctx, stubGraph);
+        expect(outcome.status).toBe('SUCCESS');
+        expect(outcome.contextUpdates?.['deploy.output']).toBe('deployment done');
+        expect(outcome.contextUpdates?.['satisfaction_score']).toBeUndefined();
+    });
+    it('stores non-ScenarioRunResult JSON as {node.id}.output', async () => {
+        const otherJson = JSON.stringify({ result: 'ok', count: 5 });
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: otherJson, exitCode: 0 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode({ id: 'other_tool' }), ctx, stubGraph);
+        expect(outcome.status).toBe('SUCCESS');
+        expect(outcome.contextUpdates?.['other_tool.output']).toBe(otherJson);
+        expect(outcome.contextUpdates?.['satisfaction_score']).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// Non-zero exit code — existing FAILURE behavior unchanged
+// ---------------------------------------------------------------------------
+describe('tool handler — non-zero exit code → FAILURE (existing behavior)', () => {
+    it('returns FAILURE with stderr as failureReason on non-zero exit code', async () => {
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stderr: 'command not found', exitCode: 1 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode(), ctx, stubGraph);
+        expect(outcome.status).toBe('FAILURE');
+        expect(outcome.failureReason).toBe('command not found');
+    });
+    it('does not set contextUpdates on non-zero exit code', async () => {
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stderr: 'error', exitCode: 2 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode(), ctx, stubGraph);
+        expect(outcome.contextUpdates).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// ToolHandlerOptions.satisfactionThreshold (story 46-2)
+// ---------------------------------------------------------------------------
+describe('ToolHandlerOptions.satisfactionThreshold (story 46-2)', () => {
+    // AC5a: threshold=0.5, 3/5 pass (score=0.6) → passes=true, satisfaction_score=0.6 in context
+    it('AC5a: satisfactionThreshold=0.5 with 3/5 passing (score=0.6) → passes=true, satisfaction_score=0.6', async () => {
+        const result = makeScenarioRunResult(5, 3);
+        const resultJson = JSON.stringify(result);
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: resultJson, exitCode: 0 }));
+        const handler = createToolHandler({ satisfactionThreshold: 0.5 });
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode(), ctx, stubGraph);
+        expect(outcome.status).toBe('SUCCESS');
+        expect(outcome.contextUpdates?.['satisfaction_score']).toBe(0.6);
+        // Verify computeSatisfactionScore with threshold 0.5 returns passes=true for score 0.6
+        const scored = computeSatisfactionScore(result, 0.5);
+        expect(scored.passes).toBe(true);
+        expect(scored.score).toBe(0.6);
+    });
+    // AC5b: threshold=0.8, 3/5 pass (score=0.6) → score is still written; passes=false internally
+    it('AC5b: satisfactionThreshold=0.8 with 3/5 passing → satisfaction_score=0.6 written to context', async () => {
+        const result = makeScenarioRunResult(5, 3);
+        const resultJson = JSON.stringify(result);
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: resultJson, exitCode: 0 }));
+        const handler = createToolHandler({ satisfactionThreshold: 0.8 });
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode(), ctx, stubGraph);
+        expect(outcome.status).toBe('SUCCESS');
+        expect(outcome.contextUpdates?.['satisfaction_score']).toBe(0.6);
+        // Verify internally passes=false at threshold 0.8
+        const scored = computeSatisfactionScore(result, 0.8);
+        expect(scored.passes).toBe(false);
+    });
+    // AC5c: no satisfactionThreshold in options → default 0.8 used by scorer, score still written
+    it('AC5c: no satisfactionThreshold in options → same behavior as existing tests (default 0.8, satisfaction_score written)', async () => {
+        const resultJson = JSON.stringify(makeScenarioRunResult(5, 3));
+        mockSpawn.mockReturnValueOnce(createMockProcess({ stdout: resultJson, exitCode: 0 }));
+        const handler = createToolHandler();
+        const ctx = new GraphContext();
+        const outcome = await handler(makeNode(), ctx, stubGraph);
+        expect(outcome.status).toBe('SUCCESS');
+        expect(outcome.contextUpdates?.['satisfaction_score']).toBe(0.6);
+    });
+});
+//# sourceMappingURL=tool-scenario.test.js.map

package/dist/handlers/__tests__/tool-scenario.test.js.map

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

package/dist/handlers/__tests__/wait-human-handler.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for the wait.human handler (story 42-11).
+ *
+ * Covers:
+ *   AC4 – Accelerator key parsing from edge labels
+ *   AC5 – Returns preferredLabel matching human selection
+ *   AC6 – Handler registration in createDefaultRegistry()
+ *   AC7 – All unit tests pass
+ */
+export {};
+//# sourceMappingURL=wait-human-handler.test.d.ts.map

package/dist/handlers/__tests__/wait-human-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-human-handler.test.d.ts","sourceRoot":"","sources":["../../../src/handlers/__tests__/wait-human-handler.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/handlers/__tests__/wait-human-handler.test.js

@@ -0,0 +1,251 @@
+/**
+ * Unit tests for the wait.human handler (story 42-11).
+ *
+ * Covers:
+ *   AC4 – Accelerator key parsing from edge labels
+ *   AC5 – Returns preferredLabel matching human selection
+ *   AC6 – Handler registration in createDefaultRegistry()
+ *   AC7 – All unit tests pass
+ */
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { GraphContext } from '../../graph/context.js';
+import { parseAcceleratorKey, deriveChoices, createWaitHumanHandler, } from '../wait-human.js';
+import { createDefaultRegistry } from '../registry.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Minimal GraphNode factory for wait.human nodes. */
+function makeNode(overrides = {}) {
+    return {
+        id: 'gate',
+        label: 'Approve this change?',
+        shape: 'box',
+        type: 'wait.human',
+        prompt: '',
+        maxRetries: 0,
+        goalGate: false,
+        retryTarget: '',
+        fallbackRetryTarget: '',
+        fidelity: '',
+        threadId: '',
+        class: '',
+        timeout: 0,
+        llmModel: '',
+        llmProvider: '',
+        reasoningEffort: '',
+        autoStatus: false,
+        allowPartial: false,
+        toolCommand: '',
+        backend: '',
+        ...overrides,
+    };
+}
+/** Build a minimal GraphEdge stub. */
+function makeEdge(fromNode, toNode, label) {
+    return {
+        fromNode,
+        toNode,
+        label,
+        condition: '',
+        weight: 0,
+        fidelity: '',
+        threadId: '',
+        loopRestart: false,
+    };
+}
+/** Build a minimal Graph stub with given edges. */
+function makeGraph(edges) {
+    return {
+        id: '',
+        goal: '',
+        label: '',
+        modelStylesheet: '',
+        defaultMaxRetries: 0,
+        retryTarget: '',
+        fallbackRetryTarget: '',
+        defaultFidelity: '',
+        nodes: new Map(),
+        edges,
+        outgoingEdges: (nodeId) => edges.filter((e) => e.fromNode === nodeId),
+        startNode: () => { throw new Error('not implemented'); },
+        exitNode: () => { throw new Error('not implemented'); },
+    };
+}
+// ---------------------------------------------------------------------------
+// Test teardown
+// ---------------------------------------------------------------------------
+afterEach(() => {
+    vi.clearAllMocks();
+});
+// ---------------------------------------------------------------------------
+// AC4 – Accelerator key parsing from edge labels
+// ---------------------------------------------------------------------------
+describe('parseAcceleratorKey (AC4)', () => {
+    it('parses [Y] Yes → { key: "Y", label: "Yes" }', () => {
+        expect(parseAcceleratorKey('[Y] Yes')).toEqual({ key: 'Y', label: 'Yes' });
+    });
+    it('parses [N] No → { key: "N", label: "No" }', () => {
+        expect(parseAcceleratorKey('[N] No')).toEqual({ key: 'N', label: 'No' });
+    });
+    it('parses lowercase accelerator and uppercases key: [y] yes → { key: "Y", label: "yes" }', () => {
+        expect(parseAcceleratorKey('[y] yes')).toEqual({ key: 'Y', label: 'yes' });
+    });
+    it('falls back to first char of label when no [X] prefix: Continue → { key: "C", label: "Continue" }', () => {
+        expect(parseAcceleratorKey('Continue')).toEqual({ key: 'C', label: 'Continue' });
+    });
+    it('falls back to first char (uppercased) for labels without prefix', () => {
+        expect(parseAcceleratorKey('abort')).toEqual({ key: 'A', label: 'abort' });
+    });
+    it('handles numeric accelerators: [1] Option One', () => {
+        expect(parseAcceleratorKey('[1] Option One')).toEqual({ key: '1', label: 'Option One' });
+    });
+    it('trims extra whitespace from the label portion', () => {
+        expect(parseAcceleratorKey('[Y]   Yes  ')).toEqual({ key: 'Y', label: 'Yes' });
+    });
+});
+// ---------------------------------------------------------------------------
+// AC4 – deriveChoices from graph edges
+// ---------------------------------------------------------------------------
+describe('deriveChoices (AC4)', () => {
+    it('returns choices from outgoing edges of the node', () => {
+        const node = makeNode({ id: 'my_gate' });
+        const edges = [
+            makeEdge('my_gate', 'approve_node', '[Y] Yes'),
+            makeEdge('my_gate', 'reject_node', '[N] No'),
+        ];
+        const graph = makeGraph(edges);
+        const choices = deriveChoices(node, graph);
+        expect(choices).toEqual([
+            { key: 'Y', label: 'Yes' },
+            { key: 'N', label: 'No' },
+        ]);
+    });
+    it('excludes edges from other nodes', () => {
+        const node = makeNode({ id: 'my_gate' });
+        const edges = [
+            makeEdge('my_gate', 'approve_node', '[Y] Yes'),
+            makeEdge('other_gate', 'some_node', '[X] Other'),
+        ];
+        const graph = makeGraph(edges);
+        const choices = deriveChoices(node, graph);
+        expect(choices).toHaveLength(1);
+        expect(choices[0]).toEqual({ key: 'Y', label: 'Yes' });
+    });
+    it('excludes edges with empty labels', () => {
+        const node = makeNode({ id: 'my_gate' });
+        const edges = [
+            makeEdge('my_gate', 'approve_node', '[Y] Yes'),
+            makeEdge('my_gate', 'no_label_node', ''),
+        ];
+        const graph = makeGraph(edges);
+        const choices = deriveChoices(node, graph);
+        expect(choices).toHaveLength(1);
+    });
+    it('returns empty array when no outgoing edges exist', () => {
+        const node = makeNode({ id: 'isolated' });
+        const graph = makeGraph([]);
+        expect(deriveChoices(node, graph)).toEqual([]);
+    });
+});
+// ---------------------------------------------------------------------------
+// AC5 – wait.human handler returns preferredLabel matching selection
+// ---------------------------------------------------------------------------
+describe('createWaitHumanHandler (AC5)', () => {
+    it('returns SUCCESS when promptFn resolves', async () => {
+        const promptFn = vi.fn().mockResolvedValue('[Y] Yes');
+        const handler = createWaitHumanHandler({ promptFn });
+        const node = makeNode({ id: 'my_node' });
+        const edges = [
+            makeEdge('my_node', 'yes_node', '[Y] Yes'),
+            makeEdge('my_node', 'no_node', '[N] No'),
+        ];
+        const graph = makeGraph(edges);
+        const ctx = new GraphContext();
+        const result = await handler(node, ctx, graph);
+        expect(result.status).toBe('SUCCESS');
+    });
+    it('sets preferredLabel to the selected edge label', async () => {
+        const promptFn = vi.fn().mockResolvedValue('[Y] Yes');
+        const handler = createWaitHumanHandler({ promptFn });
+        const node = makeNode({ id: 'my_node' });
+        const edges = [
+            makeEdge('my_node', 'yes_node', '[Y] Yes'),
+            makeEdge('my_node', 'no_node', '[N] No'),
+        ];
+        const graph = makeGraph(edges);
+        const ctx = new GraphContext();
+        const result = await handler(node, ctx, graph);
+        expect(result.preferredLabel).toBe('[Y] Yes');
+    });
+    it('stores the selected label as {node.id}.choice in contextUpdates', async () => {
+        const promptFn = vi.fn().mockResolvedValue('[Y] Yes');
+        const handler = createWaitHumanHandler({ promptFn });
+        const node = makeNode({ id: 'my_node' });
+        const edges = [
+            makeEdge('my_node', 'yes_node', '[Y] Yes'),
+            makeEdge('my_node', 'no_node', '[N] No'),
+        ];
+        const graph = makeGraph(edges);
+        const ctx = new GraphContext();
+        const result = await handler(node, ctx, graph);
+        expect(result.contextUpdates?.['my_node.choice']).toBe('[Y] Yes');
+    });
+    it('passes node.label and choices to promptFn', async () => {
+        const promptFn = vi.fn().mockResolvedValue('[Y] Yes');
+        const handler = createWaitHumanHandler({ promptFn });
+        const node = makeNode({ id: 'my_node', label: 'Approve this change?' });
+        const edges = [
+            makeEdge('my_node', 'yes_node', '[Y] Yes'),
+            makeEdge('my_node', 'no_node', '[N] No'),
+        ];
+        const graph = makeGraph(edges);
+        const ctx = new GraphContext();
+        await handler(node, ctx, graph);
+        expect(promptFn).toHaveBeenCalledWith('Approve this change?', [
+            { key: 'Y', label: 'Yes' },
+            { key: 'N', label: 'No' },
+        ]);
+    });
+    it('handles the [N] No selection correctly', async () => {
+        const promptFn = vi.fn().mockResolvedValue('[N] No');
+        const handler = createWaitHumanHandler({ promptFn });
+        const node = makeNode({ id: 'my_node' });
+        const edges = [
+            makeEdge('my_node', 'yes_node', '[Y] Yes'),
+            makeEdge('my_node', 'no_node', '[N] No'),
+        ];
+        const graph = makeGraph(edges);
+        const ctx = new GraphContext();
+        const result = await handler(node, ctx, graph);
+        expect(result.preferredLabel).toBe('[N] No');
+        expect(result.contextUpdates?.['my_node.choice']).toBe('[N] No');
+    });
+});
+// ---------------------------------------------------------------------------
+// AC6 – Handler registration in createDefaultRegistry()
+// ---------------------------------------------------------------------------
+describe('createDefaultRegistry() – tool and wait.human (AC6)', () => {
+    it('resolves type="tool" to a function (tool handler is registered)', () => {
+        const registry = createDefaultRegistry();
+        const node = makeNode({ type: 'tool' });
+        const handler = registry.resolve(node);
+        expect(typeof handler).toBe('function');
+    });
+    it('resolves type="wait.human" to a function (wait.human handler is registered)', () => {
+        const registry = createDefaultRegistry();
+        const node = makeNode({ type: 'wait.human' });
+        const handler = registry.resolve(node);
+        expect(typeof handler).toBe('function');
+    });
+    it('tool handler resolves via explicit type (step 1)', () => {
+        const registry = createDefaultRegistry();
+        const node = makeNode({ type: 'tool', shape: '' });
+        expect(() => registry.resolve(node)).not.toThrow();
+    });
+    it('wait.human handler resolves via explicit type (step 1)', () => {
+        const registry = createDefaultRegistry();
+        const node = makeNode({ type: 'wait.human', shape: '' });
+        expect(() => registry.resolve(node)).not.toThrow();
+    });
+});
+//# sourceMappingURL=wait-human-handler.test.js.map

package/dist/handlers/__tests__/wait-human-handler.test.js.map

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

package/dist/handlers/codergen-handler.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Codergen handler — invokes an LLM with a prompt derived from node attributes
+ * and GraphContext, storing the response in context so downstream nodes can
+ * reference it via `{{nodeId_output}}` in their own prompts.
+ *
+ * Story 42-10.
+ */
+import type { GraphNode, IGraphContext, ParsedStylesheet } from '../graph/types.js';
+import type { NodeHandler } from './types.js';
+import type { ICodergenBackend } from '../backend/types.js';
+/**
+ * Configuration options for the codergen handler factory.
+ */
+export interface CodergenHandlerOptions {
+    /** Optional model stylesheet used to resolve per-node LLM routing properties. */
+    stylesheet?: ParsedStylesheet;
+    /** Default LLM model when neither node attributes nor stylesheet specify one. */
+    defaultModel?: string;
+    /** Default LLM provider when neither node attributes nor stylesheet specify one. */
+    defaultProvider?: string;
+    /** Default reasoning effort when neither node attributes nor stylesheet specify one. */
+    defaultReasoningEffort?: string;
+    /**
+     * Optional injectable backend for testing.
+     * When provided, `backend.run()` is invoked instead of `callLLM()`, and its
+     * Outcome is returned directly. The `callLLM` path, model resolution, and error
+     * classification are all bypassed. Story 42-18.
+     */
+    backend?: ICodergenBackend;
+    /**
+     * Backend instance used when `node.backend === 'direct'`.
+     * Takes precedence over the global `backend` option and `callLLM` for nodes
+     * that explicitly opt-in via the `backend` DOT attribute. Story 48-10.
+     */
+    directBackend?: ICodergenBackend;
+}
+/**
+ * Replace all `{{key}}` placeholders in `template` with the corresponding
+ * values from `context`.  Missing keys resolve to empty string `""` without
+ * throwing.
+ *
+ * @param template - The prompt template string (may contain `{{variable}}` tokens).
+ * @param context  - The graph context to read values from.
+ * @returns The fully-interpolated prompt string.
+ */
+export declare function interpolatePrompt(template: string, context: IGraphContext): string;
+/**
+ * Resolve the LLM routing properties for a graph node.
+ *
+ * Priority (highest wins):
+ *   1. Node-level attributes (`node.llmModel`, `node.llmProvider`, `node.reasoningEffort`)
+ *   2. Stylesheet-resolved values via `resolveNodeStyles`
+ *   3. Per-option defaults (`options.defaultModel`, etc.)
+ *   4. System defaults (`claude-sonnet-4-5`, `anthropic`, `medium`)
+ */
+export declare function resolveModel(node: GraphNode, stylesheet?: ParsedStylesheet, options?: CodergenHandlerOptions): {
+    llm_model: string;
+    llm_provider: string;
+    reasoning_effort: string;
+};
+/**
+ * Returns `true` for errors that are transient and should trigger a
+ * `NEEDS_RETRY` outcome:
+ *   - HTTP status 429 (rate limit)
+ *   - Errors whose message contains `"timeout"`, `"ETIMEDOUT"`,
+ *     `"ECONNRESET"`, or `"ECONNREFUSED"`
+ *
+ * All other errors are non-transient and map to `FAILURE`.
+ */
+export declare function isTransientError(error: unknown): boolean;
+/**
+ * Create a codergen node handler configured with the given options.
+ *
+ * @param options - Optional configuration (stylesheet, default model/provider/effort).
+ * @returns A `NodeHandler` that:
+ *   1. Interpolates the node's prompt (or label) against GraphContext.
+ *   2. Resolves LLM routing properties.
+ *   3. Calls the LLM client from `\@substrate-ai/core`.
+ *   4. Returns a `SUCCESS` outcome with the response in `contextUpdates`,
+ *      `NEEDS_RETRY` for transient errors, or `FAILURE` for others.
+ */
+export declare function createCodergenHandler(options?: CodergenHandlerOptions): NodeHandler;
+//# sourceMappingURL=codergen-handler.d.ts.map

package/dist/handlers/codergen-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codergen-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/codergen-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAS,aAAa,EAAW,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACnG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAgB3D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wFAAwF;IACxF,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,gBAAgB,CAAA;CACjC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAIlF;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC/B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAsBvE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAuBxD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,WAAW,CAqDnF"}