@esankhan3/anvil-agent-core 0.3.0 → 0.4.0

package/dist/turn-recorder/__tests__/turn-recorder.test.js

@@ -0,0 +1,282 @@
+/**
+ * Unit tests for TurnRecorder — v2 ADR §2.1 / §2.5.
+ *
+ * Covers:
+ *   a) startTurn records `assistant-start` WITHOUT an input-hash guard, so
+ *      a resume whose prompt drifted (live-requeried KB/memory, cross-vendor
+ *      continuation) replays the recorded transcript instead of aborting.
+ *   b) Concurrent recorder instances do not cross-pollinate turn counters.
+ *   c) runTool records `tool_use:N` AND `tool_result:N`, executes the
+ *      exec callback exactly once on live, returns its NeutralToolResult.
+ *   d) Replay path — when the underlying runtime returns recorded
+ *      payloads, runTool short-circuits the executor (exec never fires).
+ *   e) endTurn records `assistant-end` with provenance + usage.
+ *   f) flushPartial emits an AssistantPartial through the sink with the
+ *      same turnUuid that startTurn minted; idempotent across calls.
+ *   g) NullTurnRecorder factory produces a recorder whose calls all
+ *      complete cleanly with no persisted side effects.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { TurnRecorder, createNullTurnRecorder, createNullEffectRuntime, } from '../index.js';
+/** Test-double EffectRuntime that records every call and supports
+ *  pre-seeding replay payloads keyed by effect name. */
+function buildFakeRuntime(seed = {}) {
+    const log = [];
+    const runtime = {
+        async effect(name, fn, opts) {
+            if (name in seed) {
+                log.push({ name, opts, fnRan: false, payload: seed[name] });
+                return seed[name];
+            }
+            const payload = await fn();
+            log.push({ name, opts, fnRan: true, payload });
+            return payload;
+        },
+    };
+    return { runtime, log };
+}
+describe('TurnRecorder', () => {
+    it('records assistant-start WITHOUT an input-hash guard (resume tolerates prompt drift)', async () => {
+        const { runtime, log } = buildFakeRuntime();
+        const sink = [];
+        const recorder = new TurnRecorder({
+            runtime,
+            partialSink: (p) => { sink.push(p); },
+            runId: 'r1', stepId: 'step-a',
+            uuid: (() => { let n = 0; return () => `uuid-${n++}`; })(),
+        });
+        const { turn, turnUuid } = await recorder.startTurn({
+            model: 'openrouter/qwen3',
+            provider: 'openrouter',
+            system: 'sys',
+            messages: [{ role: 'user', content: 'hi' }],
+        });
+        assert.equal(turn, 0);
+        assert.equal(turnUuid, 'uuid-0');
+        assert.equal(log.length, 1);
+        assert.equal(log[0].name, 'turn:0:assistant-start');
+        // The turn's input (system + messages) embeds live-queried KB/memory that
+        // is rebuilt in a fresh process on resume, so it is NOT byte-stable. The
+        // assistant-start effect must NOT carry a fatal input-hash guard — else
+        // benign prompt drift aborts replay with a DeterminismViolationError and
+        // breaks resume. On replay the recorded transcript (assistant-end) is
+        // authoritative; the rebuilt prompt is never re-sent.
+        assert.equal(log[0].opts?.idempotencyKey, undefined, 'assistant-start must not be guarded by an input hash');
+    });
+    it('seeds the turn counter from deps.initialTurn (§2.5.1 resume)', async () => {
+        const { runtime, log } = buildFakeRuntime();
+        const recorder = new TurnRecorder({
+            runtime, partialSink: () => { }, runId: 'r', stepId: 's',
+            initialTurn: 3, // prior adapter recorded turns 0..2
+        });
+        const { turn } = await recorder.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        assert.equal(turn, 3, 'resumed recorder continues past the prior adapter, not from 0');
+        assert.equal(log[0].name, 'turn:3:assistant-start');
+    });
+    it('keeps per-recorder turn counters isolated', async () => {
+        const a = new TurnRecorder({
+            runtime: buildFakeRuntime().runtime,
+            partialSink: () => { },
+            runId: 'r', stepId: 's',
+        });
+        const b = new TurnRecorder({
+            runtime: buildFakeRuntime().runtime,
+            partialSink: () => { },
+            runId: 'r', stepId: 's',
+        });
+        await a.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        await a.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        const { turn: bTurn } = await b.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        assert.equal(bTurn, 0, 'second recorder starts at turn 0, ignoring first recorder');
+    });
+    it('runTool records tool_use AND tool_result, exec runs exactly once', async () => {
+        const { runtime, log } = buildFakeRuntime();
+        const recorder = new TurnRecorder({
+            runtime, partialSink: () => { }, runId: 'r', stepId: 's',
+        });
+        const { turn } = await recorder.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        let execCalls = 0;
+        const result = await recorder.runTool(turn, 'write_file', { path: 'x' }, 'idem-1', async () => {
+            execCalls += 1;
+            return { toolUseId: 'tc-1', toolName: 'write_file', ok: true, content: 'ok' };
+        });
+        assert.equal(execCalls, 1);
+        assert.equal(result.content, 'ok');
+        const names = log.map((e) => e.name);
+        assert.deepEqual(names, [
+            'turn:0:assistant-start',
+            'turn:0:tool_use:0',
+            'turn:0:tool_result:0',
+        ]);
+        assert.equal(log[1].opts?.idempotencyKey, 'idem-1');
+    });
+    it('replay short-circuits the executor — recorded tool_result wins', async () => {
+        const recordedResult = {
+            toolUseId: 'tc-1', toolName: 'write_file', ok: true, content: 'recorded-output',
+        };
+        const { runtime, log } = buildFakeRuntime({
+            'turn:0:tool_result:0': recordedResult,
+        });
+        const recorder = new TurnRecorder({
+            runtime, partialSink: () => { }, runId: 'r', stepId: 's',
+        });
+        const { turn } = await recorder.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        let execCalls = 0;
+        const result = await recorder.runTool(turn, 'write_file', { path: 'x' }, 'idem-1', async () => {
+            execCalls += 1;
+            return { toolUseId: 'tc-1', toolName: 'write_file', ok: true, content: 'LIVE-VALUE' };
+        });
+        assert.equal(execCalls, 0, 'exec must NOT fire when tool_result is replayed');
+        assert.equal(result.content, 'recorded-output');
+        // tool_use was still recorded structurally; only tool_result was replayed.
+        assert.equal(log.find((e) => e.name === 'turn:0:tool_result:0')?.fnRan, false);
+    });
+    it('endTurn records assistant-end with provenance + usage', async () => {
+        const { runtime, log } = buildFakeRuntime();
+        const recorder = new TurnRecorder({
+            runtime, partialSink: () => { }, runId: 'r', stepId: 's',
+        });
+        const { turn } = await recorder.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        await recorder.endTurn(turn, 'completed text', 'end_turn', { inputTokens: 12, outputTokens: 34 }, { segments: [{ model: 'm', provider: 'openrouter', range: [0, 14], source: 'live' }] });
+        const end = log.find((e) => e.name === 'turn:0:assistant-end');
+        assert.ok(end, 'assistant-end must be recorded');
+        assert.deepEqual(end.payload.usage, { inputTokens: 12, outputTokens: 34 });
+        assert.equal(end.payload.stopReason, 'end_turn');
+    });
+    it('flushPartial emits to sink with the turn\'s minted turnUuid', async () => {
+        const { runtime } = buildFakeRuntime();
+        const sink = [];
+        const recorder = new TurnRecorder({
+            runtime,
+            partialSink: (p) => { sink.push(p); },
+            runId: 'run-x', stepId: 'step-y',
+            uuid: () => 'fixed-uuid',
+            nowIso: () => '2026-05-25T00:00:00Z',
+        });
+        const { turn } = await recorder.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        recorder.flushPartial(turn, 'partial text here', 2, 'upstream');
+        assert.equal(sink.length, 1);
+        assert.deepEqual(sink[0], {
+            runId: 'run-x',
+            stepId: 'step-y',
+            turnUuid: 'fixed-uuid',
+            turn: 0,
+            text: 'partial text here',
+            toolUsesEmitted: 2,
+            reason: 'upstream',
+            recordedAt: '2026-05-25T00:00:00Z',
+        });
+    });
+    it('flushPartial is a no-op when startTurn was never called', () => {
+        const sink = [];
+        const recorder = new TurnRecorder({
+            runtime: createNullEffectRuntime(),
+            partialSink: (p) => { sink.push(p); },
+            runId: 'r', stepId: 's',
+        });
+        recorder.flushPartial(0, 'stale', 0, 'abort');
+        assert.equal(sink.length, 0);
+    });
+    it('startTurn reconstructs `replayed` from a recorded assistant-end via peekRecorded (§H3)', async () => {
+        // Simulate a turn already in the durable log: assistant-end + one
+        // completed tool. peekRecorded returns these; the recorder must
+        // reconstruct the full AssistantTurn so the adapter skips the network.
+        const recorded = {
+            'turn:0:assistant-start': { turnUuid: 'u', model: 'm', provider: 'openrouter' },
+            'turn:0:tool_use:0': { name: 'write_file', arguments: { path: 'a.txt' }, idempotencyKey: 'k0' },
+            'turn:0:tool_result:0': { toolUseId: 'tc0', toolName: 'write_file', ok: true, content: 'wrote' },
+            'turn:0:assistant-end': {
+                text: 'all done',
+                stopReason: 'end_turn',
+                usage: { inputTokens: 11, outputTokens: 7 },
+                provenance: { segments: [{ model: 'm', provider: 'openrouter', range: [0, 8], source: 'live' }] },
+                historyDelta: [{ role: 'assistant', content: 'all done' }],
+                model: 'm',
+                provider: 'openrouter',
+            },
+        };
+        const runtime = {
+            async effect(name, fn) {
+                return (name in recorded ? recorded[name] : await fn());
+            },
+            peekRecorded(name) {
+                return (name in recorded ? recorded[name] : undefined);
+            },
+        };
+        const recorder = new TurnRecorder({
+            runtime, partialSink: () => { }, runId: 'r', stepId: 's', uuid: () => 'u',
+        });
+        const { turn, turnUuid, replayed } = await recorder.startTurn({
+            model: 'm', provider: 'openrouter', messages: [{ role: 'user', content: 'hi' }],
+        });
+        assert.equal(turn, 0);
+        assert.equal(turnUuid, 'u');
+        assert.ok(replayed, 'assistant-end present → replayed reconstructed');
+        assert.equal(replayed.text, 'all done');
+        assert.equal(replayed.stopReason, 'end_turn');
+        assert.deepEqual(replayed.usage, { inputTokens: 11, outputTokens: 7 });
+        assert.equal(replayed.toolUses.length, 1);
+        assert.deepEqual(replayed.toolUses[0], {
+            id: 'tc0', name: 'write_file', arguments: { path: 'a.txt' }, idempotencyKey: 'k0',
+        });
+        assert.equal(replayed.toolResults.length, 1);
+        assert.equal(replayed.toolResults[0].content, 'wrote');
+        assert.deepEqual(replayed.historyDelta, [{ role: 'assistant', content: 'all done' }]);
+    });
+    it('startTurn does NOT reconstruct when assistant-end is absent (live path)', async () => {
+        // Only assistant-start recorded — the turn never finished. No replay.
+        const recorded = {
+            'turn:0:assistant-start': { turnUuid: 'u', model: 'm', provider: 'openrouter' },
+        };
+        const runtime = {
+            async effect(name, fn) {
+                return (name in recorded ? recorded[name] : await fn());
+            },
+            peekRecorded(name) {
+                return (name in recorded ? recorded[name] : undefined);
+            },
+        };
+        const recorder = new TurnRecorder({
+            runtime, partialSink: () => { }, runId: 'r', stepId: 's', uuid: () => 'u',
+        });
+        const { replayed } = await recorder.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        assert.equal(replayed, undefined, 'no assistant-end → no replay, adapter runs live');
+    });
+    it('endTurn records historyDelta + model/provider into the assistant-end payload (§H3)', async () => {
+        const recorded = new Map();
+        const runtime = {
+            async effect(name, fn) {
+                const v = await fn();
+                recorded.set(name, v);
+                return v;
+            },
+        };
+        const recorder = new TurnRecorder({
+            runtime, partialSink: () => { }, runId: 'r', stepId: 's', uuid: () => 'u',
+        });
+        const { turn } = await recorder.startTurn({ model: 'qwen/q', provider: 'openrouter', messages: [] });
+        const delta = [{ role: 'assistant', content: 'x', tool_calls: [{ id: 'tc' }] }];
+        await recorder.endTurn(turn, 'x', 'tool_use', { inputTokens: 3, outputTokens: 1 }, { segments: [] }, delta);
+        const end = recorded.get('turn:0:assistant-end');
+        assert.deepEqual(end.historyDelta, delta);
+        assert.equal(end.model, 'qwen/q');
+        assert.equal(end.provider, 'openrouter');
+    });
+    it('NullTurnRecorder factory yields a working recorder that persists nothing', async () => {
+        const recorder = createNullTurnRecorder();
+        const { turn } = await recorder.startTurn({ model: 'm', provider: 'openrouter', messages: [] });
+        let execCalls = 0;
+        const result = await recorder.runTool(turn, 'noop', {}, 'idem', async () => {
+            execCalls += 1;
+            return { toolUseId: 't', toolName: 'noop', ok: true, content: 'ran' };
+        });
+        await recorder.endTurn(turn, 'text', 'end_turn', { inputTokens: 1, outputTokens: 1 }, { segments: [] });
+        recorder.flushPartial(turn, '', 0, 'abort');
+        // All structural calls succeed; exec ran live because there's no
+        // replay log; no persistence side-effect we can observe.
+        assert.equal(execCalls, 1);
+        assert.equal(result.content, 'ran');
+    });
+});
+//# sourceMappingURL=turn-recorder.test.js.map

package/dist/turn-recorder/__tests__/turn-recorder.test.js.map

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

package/dist/turn-recorder/hash.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Content hashing for replay idempotency keys.
+ *
+ * Stable JSON-stringify with sorted object keys → sha256 hex. Mirrors
+ * core-pipeline's `effect-helpers.ts:contentHash` semantics so an
+ * idempotency key computed inside agent-core round-trips against the
+ * durable engine's own checks.
+ */
+export declare function contentHashFromArgs(value: unknown): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/turn-recorder/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/turn-recorder/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D"}

package/dist/turn-recorder/hash.js

@@ -0,0 +1,35 @@
+/**
+ * Content hashing for replay idempotency keys.
+ *
+ * Stable JSON-stringify with sorted object keys → sha256 hex. Mirrors
+ * core-pipeline's `effect-helpers.ts:contentHash` semantics so an
+ * idempotency key computed inside agent-core round-trips against the
+ * durable engine's own checks.
+ */
+import { createHash } from 'node:crypto';
+export function contentHashFromArgs(value) {
+    return createHash('sha256').update(stableStringify(value)).digest('hex');
+}
+function stableStringify(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? String(value) : 'null';
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(',')}]`;
+    }
+    if (typeof value === 'object') {
+        const keys = Object.keys(value).sort();
+        const entries = keys.map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`);
+        return `{${entries.join(',')}}`;
+    }
+    // Symbols, functions, bigints fall through as their string form.
+    return JSON.stringify(String(value));
+}
+//# sourceMappingURL=hash.js.map

package/dist/turn-recorder/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/turn-recorder/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACtF,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,eAAe,CAAE,KAAiC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,iEAAiE;IACjE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/turn-recorder/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * TurnRecorder — splits one LLM invocation into per-turn sub-effects so
+ * the durable engine can replay tool results and resume mid-stream after
+ * a chain-fallback model swap.
+ *
+ * Effect-name vocabulary (per the v2 ADR §2.1):
+ *   - `turn:<N>:assistant-start`     — request payload (recorded, NOT input-hash-guarded: see startTurn)
+ *   - `turn:<N>:tool_use:<M>`        — intent (name + parsed args)
+ *   - `turn:<N>:tool_result:<M>`     — neutral result; replay short-circuits the executor
+ *   - `turn:<N>:assistant-end`       — completed assistant text + provenance
+ *
+ * Surface note vs ADR §2.5: the ADR sketches recordToolUse / recordToolResult
+ * as two separate calls. That split has no clean replay-vs-execute boundary
+ * through the `effect(name, fn)` interface — once the runtime accepts a fn
+ * for `tool_result:N`, fn already either ran (live) or didn't (replay), and
+ * the caller can't tell from outside. So the implementation collapses to a
+ * single `runTool(turn, name, args, key, exec)` that owns the
+ * intent-record → execute-or-replay → result-record sequence atomically.
+ * Same on-disk shape; cleaner adapter code; ADR §2.5 to be amended in
+ * follow-up.
+ *
+ * NullTurnRecorder factory: pass a `createNullRuntime()`-built runtime to
+ * make every call a no-op pass-through with live execution. Adapters that
+ * haven't been ported through their own H-phase use this default, so the
+ * recorder calls compile and run today without behavior change.
+ */
+import type { AssistantStartRequest, AssistantTurn, EffectRuntimeLike, NeutralToolResult, PartialReason, PartialSink, Provenance, TurnRecorderDeps, TurnTokenUsage } from './types.js';
+export declare class TurnRecorder {
+    private readonly deps;
+    /** Monotonic turn counter, scoped to this recorder (one per adapter.run).
+     *  Seeded from deps.initialTurn so a sendInput-resume recorder continues
+     *  past the prior adapter's turns (§2.5.1). */
+    private turnCounter;
+    /** Per-turn tool_use index counter — bumped serially per call. */
+    private readonly toolIdxByTurn;
+    /** Per-turn uuid stash so flushPartial can echo the right one. */
+    private readonly turnUuids;
+    /** Per-turn (model, provider) stash from startTurn so endTurn can
+     *  stamp the assistant-end payload — the H3 cost rollup prices each
+     *  turn by its authoring model. */
+    private readonly turnMeta;
+    /** Per-repo effect-name scope (e.g. `service-a:`); '' for single-stage. */
+    private readonly prefix;
+    constructor(deps: TurnRecorderDeps);
+    /** Scoped effect name for a turn sub-effect. */
+    private key;
+    /**
+     * Open a new assistant turn. Records the request payload as an
+     * `assistant-start` effect; on replay, returns the recorded turn's
+     * full transcript so the adapter can skip the upstream call entirely.
+     */
+    startTurn(req: AssistantStartRequest): Promise<{
+        turn: number;
+        turnUuid: string;
+        /** Present iff the matching `assistant-end` is already in the log. */
+        replayed?: AssistantTurn;
+    }>;
+    /**
+     * Peek the durable log for a fully-recorded turn N. Returns the
+     * reconstructed `AssistantTurn` iff `turn:N:assistant-end` exists;
+     * undefined on the live path (peek unsupported, or end not yet
+     * recorded). Pure reads only — no effect cursor is advanced here.
+     */
+    private tryReconstructTurn;
+    /**
+     * Record a tool intent + execute (or replay) the tool. Combines what
+     * the ADR drafted as two calls into one atomic sequence. The
+     * `idempotencyKey` is hashed by the caller (or fed in pre-computed)
+     * and guards against args drift on replay.
+     *
+     * Replay behavior: the inner `tool_result:M` effect is replayed
+     * verbatim — `exec()` is NOT invoked. Side effects (file writes, bash
+     * runs) stay as the prior model left them.
+     */
+    runTool(turn: number, name: string, args: Record<string, unknown>, idempotencyKey: string, exec: () => Promise<NeutralToolResult>): Promise<NeutralToolResult>;
+    /**
+     * Close an assistant turn with the completed text, stop reason, usage,
+     * and provenance. Records `assistant-end`; on replay this is a no-op.
+     */
+    endTurn(turn: number, text: string, stopReason: string, usage: TurnTokenUsage, provenance: Provenance, 
+    /**
+     * Provider-native messages appended to history this turn (assistant
+     * + tool-result messages). Recorded so crash-resume re-appends them
+     * byte-for-byte (§ AssistantTurn.historyDelta). Default [] for the
+     * terminal no-tool turn (nothing appended). Opaque to the recorder.
+     */
+    historyDelta?: unknown[]): Promise<void>;
+    /**
+     * Flush an in-progress assistant text to the partial sink. Called from
+     * an adapter's catch block BEFORE re-throwing UpstreamError. Does NOT
+     * go through `effect()` — partial events are not subject to the
+     * (name, idx) counter; they're durable signals scoped by turnUuid.
+     *
+     * Safe to call when text is empty (sink decides whether to bother).
+     * Safe to call multiple times for the same turn — the sink handles
+     * dedup via turnUuid + recordedAt.
+     */
+    flushPartial(turn: number, text: string, toolUsesEmitted: number, reason: PartialReason): void;
+    private bumpToolIdx;
+    private uuid;
+    private nowIso;
+}
+export declare function createNullEffectRuntime(): EffectRuntimeLike;
+export declare function createNullPartialSink(): PartialSink;
+/**
+ * Convenience factory: a TurnRecorder that does the right structural
+ * thing (records → executes → emits) but persists nothing. Adapters use
+ * this when their caller hasn't supplied a real runtime + sink. Identical
+ * observable behavior to today's adapters; opens the door for the H2+
+ * wiring to inject the real instances without touching adapter code
+ * again.
+ */
+export declare function createNullTurnRecorder(opts?: {
+    runId?: string;
+    stepId?: string;
+}): TurnRecorder;
+export type { TurnRecorderDeps } from './types.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/turn-recorder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/turn-recorder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAEV,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,UAAU,EAEV,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAC;AAsDpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC;;mDAE+C;IAC/C,OAAO,CAAC,WAAW,CAAS;IAC5B,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD;;uCAEmC;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgE;IAEzF,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,IAAI,EAAE,gBAAgB;IAMlC,gDAAgD;IAChD,OAAO,CAAC,GAAG;IAIX;;;;OAIG;IACG,SAAS,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACnD,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,sEAAsE;QACtE,QAAQ,CAAC,EAAE,aAAa,CAAC;KAC1B,CAAC;IAoDF;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IA8C1B;;;;;;;;;OASG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GACrC,OAAO,CAAC,iBAAiB,CAAC;IA2B7B;;;OAGG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,UAAU;IACtB;;;;;OAKG;IACH,YAAY,GAAE,OAAO,EAAO,GAC3B,OAAO,CAAC,IAAI,CAAC;IAmBhB;;;;;;;;;OASG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,aAAa,GACpB,IAAI;IA4BP,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM;CAGf;AAUD,wBAAgB,uBAAuB,IAAI,iBAAiB,CAM3D;AAED,wBAAgB,qBAAqB,IAAI,WAAW,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,YAAY,CAOf;AAED,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,cAAc,YAAY,CAAC"}