@animalabs/agent-framework 0.5.6 → 0.6.0

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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"}