@animalabs/agent-framework 0.5.7 → 0.6.2

package/dist/test/state-scaling.test.js

@@ -0,0 +1,243 @@
+/**
+ * Regression gates for the set-rewrite quadratic-states fixes (2026-07-08
+ * scaling campaign, Finding 2): persisted record size must be independent of
+ * accumulated content.
+ *
+ * Families covered:
+ *   - framework/inference-log        — appended, not Set-rewritten
+ *   - framework/turn-checkpoints/*   — per-agent slots, not one global map
+ *   - modules/<name>/<log>           — ModuleContext log-state API
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { tmpdir } from 'node:os';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { JsStore } from '@animalabs/chronicle';
+import { AgentFramework } from '../src/index.js';
+import { MockMembrane } from './helpers/mock-membrane.js';
+const INFERENCE_LOG_ID = 'framework/inference-log';
+const TURN_CHECKPOINTS_ID = 'framework/turn-checkpoints';
+const TURN_CHECKPOINTS_TREE_ID = 'framework/turn-checkpoints/tree';
+/**
+ * Payload sizes of all state_update records for states matching `match`,
+ * in append order.
+ */
+function stateUpdateSizes(store, match) {
+    const sizes = [];
+    for (const id of store.getRecordIdsByType('state_update')) {
+        const record = store.getRecord(id);
+        if (!record)
+            continue;
+        const update = JSON.parse(record.payload.toString());
+        if (match(update.state_id))
+            sizes.push(record.payload.length);
+    }
+    return sizes;
+}
+/** Assert the record family isn't growing: last record ≈ first record. */
+function assertFlat(sizes, label, tolerance = 1.5) {
+    assert.ok(sizes.length >= 2, `${label}: expected ≥2 records, got ${sizes.length}`);
+    const first = sizes[0];
+    const last = sizes[sizes.length - 1];
+    assert.ok(last <= first * tolerance, `${label}: record size grew ${first} → ${last} bytes over ${sizes.length} records — ` +
+        `looks like accumulated content is being rewritten per update`);
+}
+describe('state scaling regression gates', () => {
+    let tempDir;
+    let membrane;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'af-state-scaling-'));
+        membrane = new MockMembrane();
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    async function createFramework(storePath) {
+        return AgentFramework.create({
+            storePath,
+            membrane: membrane.asMembrane(),
+            agents: [{ name: 'assistant', model: 'test-model', systemPrompt: 'test' }],
+            modules: [],
+        });
+    }
+    it('inference log: Nth record size is independent of N', async () => {
+        const storePath = join(tempDir, 'inference.chronicle');
+        const framework = await createFramework(storePath);
+        const store = framework.getStore();
+        const N = 30;
+        for (let i = 0; i < N; i++) {
+            framework.logInference({
+                timestamp: Date.now(),
+                agentName: 'assistant',
+                requestId: `req-${i}`,
+                success: true,
+                durationMs: 100,
+                request: { i },
+                response: { ok: true },
+            });
+        }
+        const entries = store.getStateJson(INFERENCE_LOG_ID);
+        assert.strictEqual(entries.length, N, 'all entries readable back');
+        const sizes = stateUpdateSizes(store, (id) => id === INFERENCE_LOG_ID);
+        assertFlat(sizes, INFERENCE_LOG_ID);
+        await framework.stop();
+    });
+    it('inference log: appends compose with a legacy Set-written array', async () => {
+        const storePath = join(tempDir, 'legacy-log.chronicle');
+        // Write the state the old way: whole-array Set, as pre-fix stores did.
+        {
+            const store = JsStore.openOrCreate({ path: storePath });
+            store.registerState({
+                id: INFERENCE_LOG_ID,
+                strategy: 'append_log',
+                deltaSnapshotEvery: 100,
+                fullSnapshotEvery: 20,
+            });
+            store.setStateJson(INFERENCE_LOG_ID, [
+                { timestamp: 1, agentName: 'old', requestId: 'legacy-0', success: true },
+                { timestamp: 2, agentName: 'old', requestId: 'legacy-1', success: false },
+            ]);
+            store.close();
+        }
+        const framework = await createFramework(storePath);
+        framework.logInference({
+            timestamp: 3,
+            agentName: 'assistant',
+            requestId: 'new-0',
+            success: true,
+            durationMs: 5,
+        });
+        const entries = framework.getStore().getStateJson(INFERENCE_LOG_ID);
+        assert.strictEqual(entries.length, 3);
+        assert.strictEqual(entries[0].requestId, 'legacy-0');
+        assert.strictEqual(entries[2].requestId, 'new-0');
+        await framework.stop();
+    });
+    it('turn checkpoints: record size and state count independent of agents-ever-spawned', async () => {
+        const storePath = join(tempDir, 'checkpoints.chronicle');
+        const framework = await createFramework(storePath);
+        const store = framework.getStore();
+        // M spawn-and-dispose subagents, several turns each.
+        const M = 25;
+        for (let m = 0; m < M; m++) {
+            const name = `spawn-task-d1-${1000 + m}`;
+            for (let turn = 0; turn < 3; turn++) {
+                framework.recordTurnCheckpoint(name);
+            }
+            framework.evictTurnCheckpoints(name);
+        }
+        // A persistent agent keeps taking turns throughout.
+        for (let turn = 0; turn < 5; turn++) {
+            framework.recordTurnCheckpoint('assistant');
+        }
+        // Every write is one tree op (path + blob hash): flat across the whole
+        // run even though M unique agents came and went.
+        const sizes = stateUpdateSizes(store, (id) => id === TURN_CHECKPOINTS_TREE_ID);
+        assertFlat(sizes, TURN_CHECKPOINTS_TREE_ID, 4);
+        // Disposal removed the key outright — the tree holds only live agents...
+        for (let m = 0; m < M; m++) {
+            assert.strictEqual(store.treeGet(TURN_CHECKPOINTS_TREE_ID, `spawn-task-d1-${1000 + m}`), null, 'disposed agent key removed from checkpoint tree');
+        }
+        assert.strictEqual(framework.getTurnCheckpoints('assistant').length, 5);
+        // ...and no per-agent state registration leaked into the state index —
+        // chronicle has no deregistration and rewrites + fsyncs the index on
+        // every sync tick, so index entries must not scale with spawns-ever.
+        const checkpointStates = store.listStates().filter((s) => s.id.startsWith(TURN_CHECKPOINTS_ID));
+        assert.strictEqual(checkpointStates.length, 1, 'exactly one checkpoint state registered');
+        await framework.stop();
+    });
+    it('turn checkpoints: legacy single-map stores are readable, migrate on save, and evict without ghosts', async () => {
+        const storePath = join(tempDir, 'legacy-checkpoints.chronicle');
+        {
+            const store = JsStore.openOrCreate({ path: storePath });
+            store.registerState({ id: TURN_CHECKPOINTS_ID, strategy: 'snapshot' });
+            store.setStateJson(TURN_CHECKPOINTS_ID, {
+                assistant: [
+                    { agentName: 'assistant', turnIndex: 0, sequenceBefore: 1, branchName: 'main', timestamp: 1 },
+                ],
+                'spawn-ghost-d1-1234': [
+                    { agentName: 'spawn-ghost-d1-1234', turnIndex: 3, sequenceBefore: 9, branchName: 'main', timestamp: 2 },
+                ],
+            });
+            store.close();
+        }
+        const framework = await createFramework(storePath);
+        const store = framework.getStore();
+        // Legacy entry visible through the fallback read...
+        const before = framework.getTurnCheckpoints('assistant');
+        assert.strictEqual(before.length, 1);
+        assert.strictEqual(before[0].turnIndex, 0);
+        // ...and the first new turn migrates the list into the tree.
+        framework.recordTurnCheckpoint('assistant');
+        const entry = store.treeGet(TURN_CHECKPOINTS_TREE_ID, 'assistant');
+        assert.ok(entry, 'tree entry created on first save');
+        const migrated = framework.getTurnCheckpoints('assistant');
+        assert.strictEqual(migrated.length, 2);
+        assert.strictEqual(migrated[0].turnIndex, 0);
+        // Evicting an agent whose checkpoints live only in the legacy map writes
+        // an empty tombstone — a later agent reusing the name must NOT inherit
+        // the dead agent's checkpoints through the fallback.
+        framework.evictTurnCheckpoints('spawn-ghost-d1-1234');
+        assert.deepStrictEqual(framework.getTurnCheckpoints('spawn-ghost-d1-1234'), []);
+        // Idempotent: a second evict doesn't rewrite the tombstone (blob "[]" is
+        // content-addressed, but the tree op record would still be new).
+        const recordsBefore = store.getRecordIdsByType('state_update').length;
+        framework.evictTurnCheckpoints('spawn-ghost-d1-1234');
+        assert.strictEqual(store.getRecordIdsByType('state_update').length, recordsBefore);
+        await framework.stop();
+    });
+    it('module log states: append/edit records are O(item), state is reconstructable', async () => {
+        const storePath = join(tempDir, 'module-log.chronicle');
+        let capturedCtx = null;
+        const logModule = {
+            name: 'logtest',
+            async start(ctx) {
+                capturedCtx = ctx;
+                ctx.registerLogState('log');
+            },
+            async stop() { },
+            getTools() { return []; },
+            async handleToolCall(_call) {
+                return { success: true };
+            },
+            async onProcess(_event, _state) {
+                return {};
+            },
+        };
+        const framework = await AgentFramework.create({
+            storePath,
+            membrane: membrane.asMembrane(),
+            agents: [{ name: 'assistant', model: 'test-model', systemPrompt: 'test' }],
+            modules: [logModule],
+        });
+        const ctx = capturedCtx;
+        const store = framework.getStore();
+        const N = 30;
+        for (let i = 0; i < N; i++) {
+            ctx.appendToLog('log', { id: `item-${i}`, content: 'x'.repeat(50) });
+        }
+        assert.strictEqual(ctx.getLogLength('log'), N);
+        // Point-edit keeps the record O(item), not O(log).
+        ctx.editLogItem('log', 3, { id: 'item-3', content: 'edited' });
+        const items = ctx.getLog('log');
+        assert.strictEqual(items.length, N);
+        assert.strictEqual(items[3].content, 'edited');
+        assert.strictEqual(items[4].id, 'item-4');
+        const sizes = stateUpdateSizes(store, (id) => id === 'modules/logtest/log');
+        assertFlat(sizes, 'modules/logtest/log');
+        // Idempotent re-registration must not throw (restart path).
+        ctx.registerLogState('log');
+        // Reserved / invalid names are rejected.
+        assert.throws(() => ctx.registerLogState('state'));
+        assert.throws(() => ctx.appendToLog('nested/name', {}));
+        // Writes to a never-registered name fail immediately — chronicle would
+        // accept the append but never snapshot the state, turning a typo into a
+        // silent full-chain-replay-on-restore trap.
+        assert.throws(() => ctx.appendToLog('lgo', { oops: true }), /not registered/);
+        assert.throws(() => ctx.editLogItem('lgo', 0, {}), /not registered/);
+        assert.strictEqual(ctx.getLogLength('log'), N, 'registered log still intact');
+        await framework.stop();
+    });
+});
+//# sourceMappingURL=state-scaling.test.js.map

package/dist/test/state-scaling.test.js.map

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

package/dist/test/tool-result-content.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-result-content.test.d.ts.map

package/dist/test/tool-result-content.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-content.test.d.ts","sourceRoot":"","sources":["../../test/tool-result-content.test.ts"],"names":[],"mappings":""}

package/dist/test/tool-result-content.test.js

@@ -0,0 +1,37 @@
+/**
+ * toMembraneToolResult (6.6): JSON.stringify(undefined) returns the VALUE
+ * undefined, not a string — a tool returning `{ success: true }` with no data
+ * plus a configured maxChars cap used to throw a TypeError on content.length
+ * mid-turn. It must degrade to a safe empty string instead.
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { AgentFramework } from '../src/framework.js';
+function makeFw() {
+    return Object.create(AgentFramework.prototype);
+}
+test('undefined data + maxChars cap: no throw, content is a safe string', () => {
+    const fw = makeFw();
+    const result = fw.toMembraneToolResult('call-1', { success: true }, 1000);
+    assert.equal(result.toolUseId, 'call-1');
+    assert.equal(result.isError, false);
+    assert.equal(result.content, '');
+});
+test('undefined data without a cap also yields a string (never the value undefined)', () => {
+    const fw = makeFw();
+    const result = fw.toMembraneToolResult('call-2', { success: true, data: undefined });
+    assert.equal(typeof result.content, 'string');
+});
+test('normal data is still stringified and truncated by the cap', () => {
+    const fw = makeFw();
+    const result = fw.toMembraneToolResult('call-3', { success: true, data: { v: 'y'.repeat(500) } }, 100);
+    assert.equal(typeof result.content, 'string');
+    assert.match(result.content, /\[truncated — original was \d+ chars\]/);
+});
+test('error results pass through unchanged', () => {
+    const fw = makeFw();
+    const result = fw.toMembraneToolResult('call-4', { success: false, error: 'boom', isError: true }, 100);
+    assert.equal(result.isError, true);
+    assert.equal(result.content, 'boom');
+});
+//# sourceMappingURL=tool-result-content.test.js.map

package/dist/test/tool-result-content.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-content.test.js","sourceRoot":"","sources":["../../test/tool-result-content.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,SAAS,MAAM;IACb,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAQ,CAAC;AACxD,CAAC;AAED,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC7E,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+EAA+E,EAAE,GAAG,EAAE;IACzF,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACrF,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACvG,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAChD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IACxG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}

package/dist/test/trunk-channel-routing.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Item-3 redux: single-TRUNK output routing.
+ *
+ * These tests cover the FRAMEWORK-side plumbing that feeds the ChannelRegistry's
+ * `activeChannelResolver` (the routing DECISION itself is covered in
+ * channel-registry-routing.test.ts):
+ *   - derivePushEventChannel() reconstructs the MCPL composite channel for a
+ *     push event (Discord DMs arrive this way), preferring an explicit
+ *     origin.mcplChannelId.
+ *   - a channel-incoming turn records its triggering channel per-agent.
+ *   - a DM push-event turn records the reconstructed DM channel per-agent.
+ *   - a batched wake picks the MOST-RECENT triggering channel.
+ *
+ * connectome-host runs every agent as a single trunk (it never sets
+ * `conversations`), so no fork/home exists — the active triggering channel is
+ * the only thing that keeps a reply in the channel it is answering.
+ */
+export {};
+//# sourceMappingURL=trunk-channel-routing.test.d.ts.map

package/dist/test/trunk-channel-routing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trunk-channel-routing.test.d.ts","sourceRoot":"","sources":["../../test/trunk-channel-routing.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/test/trunk-channel-routing.test.js

@@ -0,0 +1,175 @@
+/**
+ * Item-3 redux: single-TRUNK output routing.
+ *
+ * These tests cover the FRAMEWORK-side plumbing that feeds the ChannelRegistry's
+ * `activeChannelResolver` (the routing DECISION itself is covered in
+ * channel-registry-routing.test.ts):
+ *   - derivePushEventChannel() reconstructs the MCPL composite channel for a
+ *     push event (Discord DMs arrive this way), preferring an explicit
+ *     origin.mcplChannelId.
+ *   - a channel-incoming turn records its triggering channel per-agent.
+ *   - a DM push-event turn records the reconstructed DM channel per-agent.
+ *   - a batched wake picks the MOST-RECENT triggering channel.
+ *
+ * connectome-host runs every agent as a single trunk (it never sets
+ * `conversations`), so no fork/home exists — the active triggering channel is
+ * the only thing that keeps a reply in the channel it is answering.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { tmpdir } from 'node:os';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { AgentFramework } from '../src/index.js';
+import { MockMembrane, createMockResponse } from './helpers/mock-membrane.js';
+/** Reach the private per-turn triggering-channel map + the pure channel-deriver. */
+function internals(framework) {
+    return framework;
+}
+function channelIncoming(channelId, text) {
+    return {
+        type: 'mcpl:channel-incoming',
+        serverId: 'discord',
+        channelId,
+        messageId: `m-${Math.random().toString(36).slice(2)}`,
+        author: { id: 'U1', name: 'antra' },
+        content: [{ type: 'text', text }],
+        timestamp: new Date().toISOString(),
+        metadata: {},
+        triggerInference: true,
+    };
+}
+/** A Discord DM as discord-mcpl forwards it: a push/event whose origin carries
+ *  the raw channel (guildId null) — no channels/incoming, no open channel. */
+function dmPushEvent(rawChannelId, text) {
+    return {
+        type: 'mcpl:push-event',
+        serverId: 'discord',
+        featureSet: 'discord.messaging',
+        eventId: `discord_msg_${Math.random().toString(36).slice(2)}`,
+        content: [{ type: 'text', text }],
+        origin: {
+            source: 'discord',
+            channelId: rawChannelId,
+            guildId: null,
+            channelName: undefined,
+            isDM: true,
+        },
+        timestamp: new Date().toISOString(),
+        inferenceId: `inf-${Math.random().toString(36).slice(2)}`,
+        triggerInference: true,
+    };
+}
+describe('Trunk channel routing (item-3 redux)', () => {
+    let tempDir;
+    let membrane;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'trunk-routing-test-'));
+        membrane = new MockMembrane();
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    async function makeFramework() {
+        // NO `conversations` — this is connectome-host's single-trunk mode.
+        return AgentFramework.create({
+            storePath: join(tempDir, 'test.chronicle'),
+            membrane: membrane.asMembrane(),
+            agents: [{ name: 'scout', model: 'test-model', systemPrompt: 'You are scout.' }],
+            modules: [],
+        });
+    }
+    it('derivePushEventChannel prefers an explicit origin.mcplChannelId', async () => {
+        const framework = await makeFramework();
+        const got = internals(framework).derivePushEventChannel({
+            source: 'discord',
+            mcplChannelId: 'discord:dm:999',
+            channelName: 'DM with Antra',
+            channelId: '999',
+        });
+        assert.deepEqual(got, { channelId: 'discord:dm:999', label: 'DM with Antra' });
+        await framework.stop();
+    });
+    it('derivePushEventChannel reconstructs a Discord DM composite (guildId null -> dm)', async () => {
+        const framework = await makeFramework();
+        const got = internals(framework).derivePushEventChannel({
+            source: 'discord',
+            channelId: '42',
+            guildId: null,
+            isDM: true,
+        });
+        assert.deepEqual(got, { channelId: 'discord:dm:42', label: undefined });
+        await framework.stop();
+    });
+    it('derivePushEventChannel reconstructs a non-open guild channel composite', async () => {
+        const framework = await makeFramework();
+        const got = internals(framework).derivePushEventChannel({
+            source: 'discord',
+            channelId: 'C7',
+            guildId: 'G1',
+        });
+        assert.deepEqual(got, { channelId: 'discord:G1:C7', label: undefined });
+        await framework.stop();
+    });
+    it('derivePushEventChannel returns undefined for a channel-less push (heartbeat)', async () => {
+        const framework = await makeFramework();
+        const i = internals(framework);
+        assert.equal(i.derivePushEventChannel(undefined), undefined);
+        assert.equal(i.derivePushEventChannel({ source: 'heartbeat', kind: 'tick' }), undefined);
+        await framework.stop();
+    });
+    it('a channel-incoming trunk turn records its triggering channel', async () => {
+        membrane.pushResponse(createMockResponse([{ type: 'text', text: 'the date is ...' }]));
+        const framework = await makeFramework();
+        framework.pushEvent(channelIncoming('discord:guild:chanA', 'A: sleep && date'));
+        await framework.runUntilIdle();
+        assert.equal(membrane.calls.length, 1, 'the trunk should have run one turn');
+        assert.equal(internals(framework).activeTriggerChannels.get('scout'), 'discord:guild:chanA', 'the turn must be routed to the channel that triggered it');
+        await framework.stop();
+    });
+    it('a DM push-event turn records the reconstructed DM channel (item-3 redux DM sub-case)', async () => {
+        membrane.pushResponse(createMockResponse([{ type: 'text', text: 'hi in the DM' }]));
+        const framework = await makeFramework();
+        framework.pushEvent(dmPushEvent('42', 'hey scout, ping'));
+        await framework.runUntilIdle();
+        assert.equal(membrane.calls.length, 1, 'the trunk should wake for the DM');
+        assert.equal(internals(framework).activeTriggerChannels.get('scout'), 'discord:dm:42', 'the DM reply must route to the DM channel, not the global locus');
+        await framework.stop();
+    });
+    it('the triggering channel tracks the CURRENT turn, never a stale one', async () => {
+        const framework = await makeFramework();
+        const i = internals(framework);
+        // A channel-A turn sets the active channel... (push the response right before
+        // each turn: MockMembrane's stream consumes ALL queued responses at once.)
+        membrane.pushResponse(createMockResponse([{ type: 'text', text: 'ans A' }]));
+        framework.pushEvent(channelIncoming('discord:guild:chanA', 'A: hi'));
+        await framework.runUntilIdle();
+        assert.equal(i.activeTriggerChannels.get('scout'), 'discord:guild:chanA');
+        // ...then a DM turn OVERWRITES it — the next turn's reply must never inherit
+        // the previous turn's channel (the concurrency hazard this fix removes).
+        membrane.pushResponse(createMockResponse([{ type: 'text', text: 'ans DM' }]));
+        framework.pushEvent(dmPushEvent('42', 'now in a DM'));
+        await framework.runUntilIdle();
+        assert.equal(membrane.calls.length, 2, 'both turns should have run');
+        assert.equal(i.activeTriggerChannels.get('scout'), 'discord:dm:42', 'the map must reflect the CURRENT turn’s channel, not chanA');
+        await framework.stop();
+    });
+    it('startAgentStream clears the triggering channel for a no-channel (heartbeat) turn', async () => {
+        membrane.pushResponse(createMockResponse([{ type: 'text', text: 'tick' }]));
+        const framework = await makeFramework();
+        const i = internals(framework);
+        // Simulate a stale channel left by a prior turn, then run a heartbeat/timer
+        // turn (an InferenceRequest with no channelId). startAgentStream must clear
+        // the entry up front so routeSpeech falls back to the global locus rather
+        // than replaying the stale channel.
+        i.activeTriggerChannels.set('scout', 'discord:guild:stale');
+        const scout = framework.getAgent('scout');
+        await framework.startAgentStream(scout, {
+            agentName: 'scout', reason: 'heartbeat', source: 'timer', timestamp: Date.now(),
+        });
+        await framework.runUntilIdle();
+        assert.equal(i.activeTriggerChannels.has('scout'), false, 'a no-trigger turn must clear any stale triggering channel');
+        await framework.stop();
+    });
+});
+//# sourceMappingURL=trunk-channel-routing.test.js.map

package/dist/test/trunk-channel-routing.test.js.map

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