@animalabs/agent-framework 0.22.2 → 0.23.0

package/dist/test/busy-agent-scheduler.test.js

@@ -1,92 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { AgentFramework } from '../src/framework.js';
-function busyAgentHarness() {
-    const framework = Object.create(AgentFramework.prototype);
-    framework.queue = { tryPop: () => null };
-    framework.pendingRequests = [{
-            agentName: 'Sol',
-            reason: 'discord-message',
-            source: 'discord',
-            timestamp: Date.now(),
-        }];
-    framework.agents = new Map([['Sol', { state: { status: 'waiting_for_tools' } }]]);
-    framework.activeStreams = new Map();
-    framework.activeTurnTokens = new Map();
-    framework.staleWarnAt = new Map();
-    framework.sweepExpiredConversations = () => { };
-    framework.createFrameworkState = () => ({});
-    framework.emitTrace = () => { };
-    framework.handleProcessEvent = async () => { };
-    framework.inferencePolicy = { shouldInfer: () => true };
-    framework.startAgentStream = async () => { };
-    return framework;
-}
-test('busy-agent inference requests yield to timers when no active stream is registered', async () => {
-    const framework = busyAgentHarness();
-    let timerRan = false;
-    setTimeout(() => {
-        timerRan = true;
-    }, 0);
-    await framework.processNextEvent();
-    assert.equal(timerRan, true, 'scheduler must yield a macrotask before polling the busy agent again');
-    assert.equal(framework.pendingRequests.length, 1, 'the deferred wake remains queued');
-});
-test('continuous queue traffic still yields when a busy-agent wake remains deferred', async () => {
-    const framework = busyAgentHarness();
-    framework.queue = { tryPop: () => ({ type: 'diagnostic-event' }) };
-    let timerRan = false;
-    setTimeout(() => {
-        timerRan = true;
-    }, 0);
-    await framework.processNextEvent();
-    assert.equal(timerRan, true, 'queue traffic must not starve tool-result or HTTP I/O');
-    assert.equal(framework.pendingRequests.length, 1, 'the busy-agent wake remains deferred');
-});
-test('stale busy-agent diagnostics are throttled with the warning', async () => {
-    const framework = busyAgentHarness();
-    framework.pendingRequests[0].timestamp = Date.now() - 31_000;
-    let traceCount = 0;
-    framework.emitTrace = () => {
-        traceCount++;
-    };
-    const originalError = console.error;
-    console.error = () => { };
-    try {
-        await framework.processInferenceRequests();
-        await framework.processInferenceRequests();
-    }
-    finally {
-        console.error = originalError;
-    }
-    assert.equal(traceCount, 1, 'the stale trace shares the once-per-minute warning throttle');
-    assert.equal(framework.pendingRequests.length, 1, 'diagnostics do not consume the deferred wake');
-});
-test('a budget restart defines turn semantics when batched behind an ordinary wake', async () => {
-    const framework = busyAgentHarness();
-    const now = Date.now();
-    framework.pendingRequests = [
-        {
-            agentName: 'Sol',
-            reason: 'mcpl:channel-incoming',
-            source: 'discord',
-            timestamp: now - 1,
-        },
-        {
-            agentName: 'Sol',
-            reason: 'context_budget_restart',
-            source: 'framework',
-            timestamp: now,
-        },
-    ];
-    framework.agents = new Map([['Sol', { state: { status: 'idle' } }]]);
-    framework.activeTurnTokens.set('Sol', 1);
-    let selectedTrigger;
-    framework.startAgentStream = async (_agent, trigger) => {
-        selectedTrigger = trigger;
-    };
-    await framework.processInferenceRequests();
-    assert.equal(selectedTrigger?.reason, 'context_budget_restart', 'the request that bypasses the turn-alive lock must preserve continuation semantics');
-    assert.equal(framework.pendingRequests.length, 0, 'the mixed wake batch is consumed once');
-});
-//# sourceMappingURL=busy-agent-scheduler.test.js.map

package/dist/test/busy-agent-scheduler.test.js.map

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

package/dist/test/channel-incoming-targeting.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=channel-incoming-targeting.test.d.ts.map

package/dist/test/channel-incoming-targeting.test.d.ts.map

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

package/dist/test/channel-incoming-targeting.test.js

@@ -1,81 +0,0 @@
-/**
- * targetAgents on the channel-incoming path (issue #77 plumbing).
- *
- * McplChannelIncomingEvent declared `targetAgents` from the start, but the
- * fan-out ignored it and woke every registered agent. Now it mirrors the
- * push-event path: a targeted event wakes exactly the named agents (unknown
- * names skipped), an untargeted event keeps the historical broadcast.
- * Tune-out's wake routing is the first setter.
- *
- * Asserted at the pendingRequests seam (the fan-out's output), not by
- * running turns: MockMembrane hands its whole response queue to the first
- * stream, so two agents' concurrent turns starve one stream and the
- * framework restart-loops it — a harness limitation, not product behavior.
- */
-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 } from './helpers/mock-membrane.js';
-function internals(framework) {
-    return framework;
-}
-function channelIncoming(text, targetAgents) {
-    return {
-        type: 'mcpl:channel-incoming',
-        serverId: 'discord',
-        channelId: 'discord:guild:chanA',
-        messageId: `m-${Math.random().toString(36).slice(2)}`,
-        author: { id: 'U1', name: 'antra' },
-        content: [{ type: 'text', text }],
-        timestamp: new Date().toISOString(),
-        metadata: {},
-        triggerInference: true,
-        ...(targetAgents ? { targetAgents } : {}),
-    };
-}
-describe('channel-incoming targetAgents', () => {
-    let tempDir;
-    let framework;
-    beforeEach(async () => {
-        tempDir = mkdtempSync(join(tmpdir(), 'channel-targeting-test-'));
-        framework = await AgentFramework.create({
-            storePath: join(tempDir, 'test.chronicle'),
-            membrane: new MockMembrane().asMembrane(),
-            agents: [
-                { name: 'scout', model: 'test-model', systemPrompt: 'You are scout.' },
-                { name: 'shade', model: 'test-model', systemPrompt: 'You are shade.' },
-            ],
-            modules: [],
-        });
-    });
-    afterEach(async () => {
-        await framework.stop();
-        rmSync(tempDir, { recursive: true, force: true });
-    });
-    it('untargeted events keep the historical broadcast (both agents queued)', async () => {
-        const i = internals(framework);
-        await i.handleMcplChannelIncoming(channelIncoming('hello everyone'));
-        assert.deepEqual(i.pendingRequests.map((r) => r.agentName).sort(), ['scout', 'shade']);
-    });
-    it('a targeted event queues exactly the named agent', async () => {
-        const i = internals(framework);
-        await i.handleMcplChannelIncoming(channelIncoming('for shade only', ['shade']));
-        assert.deepEqual(i.pendingRequests.map((r) => r.agentName), ['shade']);
-    });
-    it('unknown names in targetAgents are skipped, not crashed on', async () => {
-        const i = internals(framework);
-        await i.handleMcplChannelIncoming(channelIncoming('mixed', ['nobody-home', 'scout']));
-        assert.deepEqual(i.pendingRequests.map((r) => r.agentName), ['scout']);
-    });
-    it('non-triggering events queue nobody', async () => {
-        const i = internals(framework);
-        const event = channelIncoming('ambient, gate said no');
-        event.triggerInference = false;
-        await i.handleMcplChannelIncoming(event);
-        assert.equal(i.pendingRequests.length, 0);
-    });
-});
-//# sourceMappingURL=channel-incoming-targeting.test.js.map

package/dist/test/channel-incoming-targeting.test.js.map

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

package/dist/test/channel-label-history.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=channel-label-history.test.d.ts.map

package/dist/test/channel-label-history.test.d.ts.map

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

package/dist/test/channel-label-history.test.js

@@ -1,424 +0,0 @@
-/**
- * Durable channel-label history (mcpl/channel-label-history append log).
- *
- * `resolveProseTarget()` resolves a label to a channel id only against the
- * live `channels` map, which is empty for anything the bot has disconnected
- * from or that hasn't re-registered since a restart. `appendLabelSighting()`
- * durably records "this channelId had this label" on every descriptor
- * observation, and `resolveProseTargetDurable()` falls back to that history
- * when the live path misses — the case that matters for browsing message
- * history on an old/quiet/disconnected channel.
- */
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { mkdtempSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { JsStore } from '@animalabs/chronicle';
-import { ChannelRegistry } from '../src/mcpl/channel-registry.js';
-const CHANNEL_LABEL_HISTORY_LOG_ID = 'mcpl/channel-label-history';
-function makeRegistry(store) {
-    const serverRegistry = {
-        getServer: (_id) => null,
-    };
-    return new ChannelRegistry(serverRegistry, {}, () => { }, () => { }, store ? { store: store } : undefined);
-}
-/** In-memory Chronicle-store stand-in, keyed by state id (unlike a single
- *  flat array) so the lifecycle log and the label-history log don't bleed
- *  into each other's getStateJson()/appendToStateJson() results. */
-function memoryStore() {
-    const registered = new Set();
-    const events = new Map();
-    const store = {
-        registerState: (opts) => {
-            if (registered.has(opts.id))
-                throw new Error('State already exists');
-            registered.add(opts.id);
-            if (!events.has(opts.id))
-                events.set(opts.id, []);
-        },
-        getStateJson: (id) => events.get(id) ?? null,
-        appendToStateJson: (id, event) => {
-            if (!events.has(id))
-                events.set(id, []);
-            events.get(id).push(event);
-        },
-    };
-    return { store, events };
-}
-function descriptor(id, label) {
-    return { id, type: 'discord', label, direction: 'bidirectional' };
-}
-function dmDescriptor(id, label, opts = {}) {
-    return {
-        id,
-        type: 'discord',
-        label,
-        direction: 'bidirectional',
-        metadata: {
-            channelType: opts.channelType ?? 'dm',
-            ...(opts.recipientId ? { recipientId: opts.recipientId } : {}),
-            ...(opts.recipientName ? { recipientName: opts.recipientName } : {}),
-        },
-    };
-}
-test('a label sighting persists across a simulated restart', async () => {
-    const dir = mkdtempSync(join(tmpdir(), 'channel-label-history-'));
-    try {
-        const store = JsStore.openOrCreate({ path: join(dir, 'store') });
-        const first = makeRegistry(store);
-        await first.handleRegister('discord', {
-            channels: [descriptor('discord:g1:c1', "#general (Antra's Guild)")],
-        });
-        // Fresh registry over the SAME store, like a real restart — its live
-        // `channels` map starts empty (no handleRegister call this time), so
-        // resolveProseTarget() alone cannot see this channel at all.
-        const second = makeRegistry(store);
-        const liveMiss = second.resolveProseTarget("#general (Antra's Guild)");
-        assert.ok('error' in liveMiss, 'expected a live-path miss on a fresh registry');
-        // resolveProseTargetDurable() falls back to replayed history and finds it.
-        assert.deepEqual(second.resolveProseTargetDurable("#general (Antra's Guild)"), { channelId: 'discord:g1:c1', label: "#general (Antra's Guild)" });
-        // Name-segment match (bare name, parenthetical guild suffix omitted)
-        // mirrors resolveProseTarget()'s own byName normalization.
-        assert.deepEqual(second.resolveProseTargetDurable('#general'), { channelId: 'discord:g1:c1', label: "#general (Antra's Guild)" });
-        // Raw channelId also resolves, like resolveProseTarget()'s raw-id path.
-        assert.deepEqual(second.resolveProseTargetDurable('discord:g1:c1'), { channelId: 'discord:g1:c1', label: "#general (Antra's Guild)" });
-    }
-    finally {
-        rmSync(dir, { recursive: true, force: true });
-    }
-});
-test('repeated identical label sightings do not bloat the log', async () => {
-    const { store, events } = memoryStore();
-    const registry = makeRegistry(store);
-    for (let i = 0; i < 3; i++) {
-        await registry.handleRegister('discord', {
-            channels: [descriptor('discord:g1:c1', '#general')],
-        });
-    }
-    const log = events.get(CHANNEL_LABEL_HISTORY_LOG_ID) ?? [];
-    assert.equal(log.length, 1, 'unchanged sightings must not append new records');
-});
-test('a genuinely new label sighting does append a new record', async () => {
-    const { store, events } = memoryStore();
-    const registry = makeRegistry(store);
-    await registry.handleRegister('discord', { channels: [descriptor('discord:g1:c1', '#general')] });
-    await registry.handleRegister('discord', { channels: [descriptor('discord:g1:c1', '#general-renamed')] });
-    const log = events.get(CHANNEL_LABEL_HISTORY_LOG_ID) ?? [];
-    assert.equal(log.length, 2);
-    // Later sighting wins on replay.
-    const second = makeRegistry(store);
-    assert.deepEqual(second.resolveProseTargetDurable('#general-renamed'), {
-        channelId: 'discord:g1:c1',
-        label: '#general-renamed',
-    });
-});
-test('resolveProseTargetDurable prefers the live path and only falls back to history on a live miss', async () => {
-    const { store, events } = memoryStore();
-    // Pre-seed history: a DIFFERENT (now-disconnected) channel historically
-    // held the same label text that a currently-live channel holds now.
-    events.set(CHANNEL_LABEL_HISTORY_LOG_ID, [
-        { channelId: 'discord:g1:ghost', label: 'shared-label', ts: 1 },
-    ]);
-    const registry = makeRegistry(store);
-    await registry.handleRegister('discord', {
-        channels: [descriptor('discord:g1:live', 'shared-label')],
-    });
-    // Live path resolves uniquely against the live channel — must win over
-    // the (stale) history entry for the ghost channel.
-    const live = registry.resolveProseTarget('shared-label');
-    assert.deepEqual(live, { channelId: 'discord:g1:live', label: 'shared-label' });
-    assert.deepEqual(registry.resolveProseTargetDurable('shared-label'), live);
-});
-test('a channel with no history at all still returns the original resolveProseTarget error/candidates unchanged', async () => {
-    const registry = makeRegistry(); // no chronicle store at all — appendLabelSighting must no-op safely
-    await registry.handleRegister('discord', { channels: [descriptor('discord:g1:c1', '#other')] });
-    const live = registry.resolveProseTarget('#nonexistent');
-    assert.ok('error' in live);
-    const durable = registry.resolveProseTargetDurable('#nonexistent');
-    assert.deepEqual(durable, live);
-    // Also true for an entirely empty registry (no channels ever seen).
-    const empty = makeRegistry();
-    const liveEmpty = empty.resolveProseTarget('#anything');
-    assert.deepEqual(empty.resolveProseTargetDurable('#anything'), liveEmpty);
-});
-test('ensureChannelRegistered and handleChanged updates also feed label history', async () => {
-    const { store, events } = memoryStore();
-    const registry = makeRegistry(store);
-    // ensureChannelRegistered: lazy registration with NO label at all (e.g. a
-    // DM push missing both channelName and an author name). This must NOT be
-    // durably recorded as if the bare channelId were a real label (finding
-    // #3) — only the in-memory descriptor gets the placeholder, for live
-    // routing purposes.
-    registry.ensureChannelRegistered('discord', 'discord:dm:1', undefined);
-    // ...then a later message reveals a real label — the backfill path.
-    registry.ensureChannelRegistered('discord', 'discord:dm:1', 'DM: Antra');
-    // handleChanged: an "added" channel, then an "updated" descriptor for it.
-    await registry.handleChanged('discord', {
-        added: [descriptor('discord:g1:c2', '#dev')],
-    });
-    await registry.handleChanged('discord', {
-        updated: [descriptor('discord:g1:c2', '#dev-renamed')],
-    });
-    const restarted = makeRegistry(store);
-    assert.deepEqual(restarted.resolveProseTargetDurable('DM: Antra'), {
-        channelId: 'discord:dm:1',
-        label: 'DM: Antra',
-    });
-    assert.deepEqual(restarted.resolveProseTargetDurable('#dev-renamed'), {
-        channelId: 'discord:g1:c2',
-        label: '#dev-renamed',
-    });
-    const log = events.get(CHANNEL_LABEL_HISTORY_LOG_ID) ?? [];
-    // discord:dm:1: the label-less lazy registration records NOTHING (fix
-    // #3), only the backfill ('DM: Antra') does = 1 record; discord:g1:c2
-    // added ('#dev') then updated ('#dev-renamed') = 2 records. Total 3, not
-    // the 4 a placeholder-recording implementation would produce.
-    assert.equal(log.length, 3);
-});
-test('a label-less lazy registration alone (no later backfill) records nothing durably (finding #3)', async () => {
-    const { store, events } = memoryStore();
-    const registry = makeRegistry(store);
-    registry.ensureChannelRegistered('discord', 'discord:dm:2', undefined);
-    const log = events.get(CHANNEL_LABEL_HISTORY_LOG_ID) ?? [];
-    assert.equal(log.length, 0, 'a placeholder label (bare channelId) must never be durably recorded');
-});
-test('a label-less lazy re-registration after restart does not clobber an already-durable real label (finding #3)', async () => {
-    const { store, events } = memoryStore();
-    const first = makeRegistry(store);
-    // Boot 1: a real label lands on file (e.g. a DM push that DID carry a
-    // display name).
-    first.ensureChannelRegistered('discord', 'discord:dm:3', 'DM: Antra');
-    assert.equal((events.get(CHANNEL_LABEL_HISTORY_LOG_ID) ?? []).length, 1);
-    // Simulated restart: fresh registry, live `channels` map starts empty —
-    // this is exactly the state that makes the NEXT event take the
-    // fresh-registration branch of ensureChannelRegistered again, even
-    // though the channel already has a real label on file.
-    const second = makeRegistry(store);
-    assert.deepEqual(second.resolveProseTargetDurable('DM: Antra'), {
-        channelId: 'discord:dm:3',
-        label: 'DM: Antra',
-    });
-    // A label-less push arrives post-restart. This used to durably overwrite
-    // the real label with the bare-id placeholder, and the dedup guard would
-    // then append a SECOND record the moment a later event restored the real
-    // label — degrading the log forever on every boot that hit this path.
-    second.ensureChannelRegistered('discord', 'discord:dm:3', undefined);
-    assert.deepEqual(second.resolveProseTargetDurable('DM: Antra'), {
-        channelId: 'discord:dm:3',
-        label: 'DM: Antra',
-    });
-    assert.equal((events.get(CHANNEL_LABEL_HISTORY_LOG_ID) ?? []).length, 1, 'a label-less event must not durably record a placeholder over an already-known real label');
-});
-test('a label-less descriptor from handleRegister does not crash and does not poison labelHistory (finding #2)', async () => {
-    const { store } = memoryStore();
-    const registry = makeRegistry(store);
-    // ChannelDescriptor.label: string is a compile-time-only assertion over
-    // untrusted wire data — handleRegister only runtime-validates `id`. Build
-    // a descriptor with a missing label the way a misbehaving MCPL server
-    // could actually send one.
-    const labelless = { id: 'discord:g1:broken', type: 'discord', direction: 'bidirectional' };
-    await registry.handleRegister('discord', { channels: [labelless] });
-    // A subsequent, UNRELATED resolution call must still work — before the
-    // fix, an undefined label silently written into labelHistory threw a
-    // TypeError inside normalizeChannelLabel's `.replace()` on every future
-    // resolveProseTargetDurable call with a channelId, not just this one
-    // (this is what made it crash all four HistoryModule tools process-wide).
-    await registry.handleRegister('discord', { channels: [descriptor('discord:g1:c2', '#general')] });
-    assert.deepEqual(registry.resolveProseTargetDurable('#general'), {
-        channelId: 'discord:g1:c2',
-        label: '#general',
-    });
-    assert.doesNotThrow(() => registry.resolveProseTargetDurable('#anything-else'));
-});
-test('a channel renamed A -> B -> A is still resolvable by a name from BEFORE the most recent rename (finding #9)', async () => {
-    const { store } = memoryStore();
-    const registry = makeRegistry(store);
-    await registry.handleRegister('discord', { channels: [descriptor('discord:g1:c1', '#alpha')] });
-    await registry.handleChanged('discord', { updated: [descriptor('discord:g1:c1', '#beta')] });
-    await registry.handleChanged('discord', { updated: [descriptor('discord:g1:c1', '#alpha')] });
-    // Live-path check: '#alpha' is current again, so it resolves live.
-    assert.deepEqual(registry.resolveProseTarget('#alpha'), { channelId: 'discord:g1:c1', label: '#alpha' });
-    // The interesting case: '#beta' is a name from BEFORE the most recent
-    // rename (A -> B -> A), not the current OR immediately-previous label —
-    // labelHistory alone (latest-only) could never answer this; it needs
-    // allLabelsSeen's full per-channel history.
-    const restarted = makeRegistry(store);
-    assert.deepEqual(restarted.resolveProseTargetDurable('#beta'), {
-        channelId: 'discord:g1:c1',
-        label: '#alpha', // reported label is always the CURRENT/latest one
-    });
-});
-test('a genuine label collision across two different channels reports ambiguity, not a silent pick (finding #9)', async () => {
-    const { store } = memoryStore();
-    const registry = makeRegistry(store);
-    // Two DIFFERENT channels each historically held the label '#shared' —
-    // channel a's label has since moved on, channel b's has not.
-    await registry.handleRegister('discord', { channels: [descriptor('discord:g1:a', '#shared')] });
-    await registry.handleChanged('discord', { updated: [descriptor('discord:g1:a', '#a-current')] });
-    await registry.handleRegister('discord', { channels: [descriptor('discord:g1:b', '#shared')] });
-    // A fresh (post-restart) registry — live path can't shortcut this to a
-    // unique live match, so resolution goes through the historical-label
-    // scan that must detect the collision across the two distinct channelIds.
-    const restarted = makeRegistry(store);
-    const result = restarted.resolveProseTargetDurable('#shared');
-    assert.ok('error' in result, `expected an ambiguity error, got ${JSON.stringify(result)}`);
-});
-test("durable DM resolution keeps the live resolver's recipientName-over-label precedence, not a flat equal-priority pool (finding: false ambiguity across two channels)", async () => {
-    // Two fully-recorded DMs whose identity data happens to cross-reference:
-    // A's actual username is 'alpha_user', but its stale/leftover display
-    // label is 'DM: beta_user'; B's actual username IS 'beta_user', with an
-    // unrelated display label. Live, '@beta_user' resolves uniquely to B —
-    // the live resolver prefers recipientName outright and never considers
-    // A's label a candidate at all. A flat "equal priority" pool of
-    // recipientName+label candidates made this falsely ambiguous after a
-    // restart (both A's label and B's recipientName satisfied the same
-    // query), even though the persisted recipientName data was sufficient on
-    // its own to resolve it uniquely, exactly like the live path does.
-    const { store } = memoryStore();
-    const registry = makeRegistry(store);
-    await registry.handleRegister('discord', {
-        channels: [
-            dmDescriptor('discord:dm:A', 'DM: beta_user', { recipientId: 'a', recipientName: 'alpha_user' }),
-            dmDescriptor('discord:dm:B', 'DM: unrelated-label', { recipientId: 'b', recipientName: 'beta_user' }),
-        ],
-    });
-    const restarted = makeRegistry(store);
-    const resolved = restarted.resolveProseTargetDurable('@beta_user');
-    assert.ok('channelId' in resolved, `expected a unique resolution, got ${JSON.stringify(resolved)}`);
-    assert.equal(resolved.channelId, 'discord:dm:B');
-    // The label-derived fallback for a channel WITHOUT a competing
-    // recipientName match still works (recipientName tier only blocks the
-    // label tier when it actually resolves the query, not unconditionally) —
-    // '@unrelated-label' isn't anyone's recipientName, so it should still
-    // resolve to B via B's own label.
-    const byLabel = restarted.resolveProseTargetDurable('@unrelated-label');
-    assert.ok('channelId' in byLabel, `expected B's own label to still resolve it, got ${JSON.stringify(byLabel)}`);
-    assert.equal(byLabel.channelId, 'discord:dm:B');
-});
-test('a DM registered live resolves after a restart via @name, not just the literal stored label (DM-addressing regression)', async () => {
-    const { store } = memoryStore();
-    const first = makeRegistry(store);
-    await first.handleRegister('discord', {
-        channels: [dmDescriptor('discord:dm:antra', 'DM: antra', { recipientId: '123456789' })],
-    });
-    // Live check: '@antra' already resolves live, before any restart —
-    // establishes this is real DM-shaped addressing, not a coincidence.
-    assert.deepEqual(first.resolveProseTarget('@antra'), {
-        channelId: 'discord:dm:antra',
-        label: 'DM: antra',
-    });
-    // Simulated restart: fresh registry, live `channels` map starts empty —
-    // resolveProseTarget() alone can no longer see this DM at all.
-    const restarted = makeRegistry(store);
-    const liveMiss = restarted.resolveProseTarget('@antra');
-    assert.ok('error' in liveMiss, 'expected a live-path miss on a fresh registry');
-    // The durable fallback must still resolve '@antra' — normalizeChannelLabel
-    // alone (its previous only tool) has no '@'-handling at all, so this used
-    // to fail silently before falling through to resolveProseTarget's
-    // original (post-#8-fix: now HARD-thrown from HistoryModule) error.
-    assert.deepEqual(restarted.resolveProseTargetDurable('@antra'), {
-        channelId: 'discord:dm:antra',
-        label: 'DM: antra',
-    });
-});
-test('a DM registered live resolves after a restart via the <@id> mention form (recipientId persisted durably)', async () => {
-    const { store } = memoryStore();
-    const first = makeRegistry(store);
-    await first.handleRegister('discord', {
-        channels: [dmDescriptor('discord:dm:antra', 'DM: antra', { recipientId: '123456789' })],
-    });
-    const restarted = makeRegistry(store);
-    assert.ok('error' in restarted.resolveProseTarget('<@123456789>'), 'expected a live-path miss on a fresh registry');
-    assert.deepEqual(restarted.resolveProseTargetDurable('<@123456789>'), {
-        channelId: 'discord:dm:antra',
-        label: 'DM: antra',
-    });
-});
-test('a bare (non-DM-metadata) channel whose id merely contains ":dm:" is still DM-matched by @name after a restart', async () => {
-    // Exercises the id-shape half of isDmChannelId() independently of the
-    // 'DM: ' label-prefix half — a descriptor with no metadata.channelType
-    // at all, the way ensureChannelRegistered's lazy DM path (no server
-    // metadata yet) actually looks.
-    const { store } = memoryStore();
-    const first = makeRegistry(store);
-    first.ensureChannelRegistered('discord', 'discord:dm:5', 'DM: ghost');
-    const restarted = makeRegistry(store);
-    assert.deepEqual(restarted.resolveProseTargetDurable('@ghost'), {
-        channelId: 'discord:dm:5',
-        label: 'DM: ghost',
-    });
-});
-test('a DM whose live username differs from its display label resolves by USERNAME after a restart (finding: recipientName persistence)', async () => {
-    // id `discord:dm:42`, label "DM: Tess" — but the actual live resolver
-    // prefers metadata.recipientName ("antra_tessera") over the label for
-    // DM name-matching, so '@antra_tessera' must resolve live, and the
-    // durable fallback (which previously only had the label "Tess" to
-    // search) needs recipientName persisted to answer it too.
-    const { store } = memoryStore();
-    const first = makeRegistry(store);
-    await first.handleRegister('discord', {
-        channels: [dmDescriptor('discord:dm:42', 'DM: Tess', { recipientName: 'antra_tessera' })],
-    });
-    // Live check: the live resolver already prefers recipientName over the
-    // label for DM matching — establishes this is real behavior to mirror,
-    // not an invented requirement.
-    assert.deepEqual(first.resolveProseTarget('@antra_tessera'), {
-        channelId: 'discord:dm:42',
-        label: 'DM: Tess',
-    });
-    const restarted = makeRegistry(store);
-    const liveMiss = restarted.resolveProseTarget('@antra_tessera');
-    assert.ok('error' in liveMiss, 'expected a live-path miss on a fresh registry');
-    // Durable fallback must resolve it by USERNAME, not just by the label text.
-    assert.deepEqual(restarted.resolveProseTargetDurable('@antra_tessera'), {
-        channelId: 'discord:dm:42',
-        label: 'DM: Tess',
-    });
-    // The label-derived name ("tess") must still work too — recipientName is
-    // additive, not a replacement for the label fallback.
-    assert.deepEqual(restarted.resolveProseTargetDurable('@tess'), {
-        channelId: 'discord:dm:42',
-        label: 'DM: Tess',
-    });
-});
-test('a DM classified only via metadata.channelType (non-conventional id/label) is still recognized and resolvable after a restart (finding: isDm persistence)', async () => {
-    // id `private-room-42` (no ":dm:"), label "Tess" (no "DM: " prefix) — the
-    // ONLY signal this is a DM at all is metadata.channelType === 'dm',
-    // which the live resolver checks FIRST. Without persisting that
-    // classification, the durable fallback's DM classifier has no way to
-    // even consider this channel a DM once disconnected, let alone resolve
-    // a <@id> mention against it.
-    const { store } = memoryStore();
-    const first = makeRegistry(store);
-    await first.handleRegister('discord', {
-        channels: [dmDescriptor('private-room-42', 'Tess', { recipientId: '42', channelType: 'dm' })],
-    });
-    // Live check: classified as a DM live via metadata alone.
-    assert.deepEqual(first.resolveProseTarget('<@42>'), {
-        channelId: 'private-room-42',
-        label: 'Tess',
-    });
-    const restarted = makeRegistry(store);
-    const liveMiss = restarted.resolveProseTarget('<@42>');
-    assert.ok('error' in liveMiss, 'expected a live-path miss on a fresh registry');
-    // Durable fallback must still recognize it as a DM (via the persisted
-    // isDm classification, not id/label shape) and resolve the mention.
-    assert.deepEqual(restarted.resolveProseTargetDurable('<@42>'), {
-        channelId: 'private-room-42',
-        label: 'Tess',
-    });
-    assert.deepEqual(restarted.resolveProseTargetDurable('@tess'), {
-        channelId: 'private-room-42',
-        label: 'Tess',
-    });
-});
-test('a non-DM channel sighting never durably asserts isDm:false (only positive classification is ever persisted)', async () => {
-    const { store, events } = memoryStore();
-    const registry = makeRegistry(store);
-    await registry.handleRegister('discord', { channels: [descriptor('discord:g1:c1', '#general')] });
-    const log = events.get(CHANNEL_LABEL_HISTORY_LOG_ID) ?? [];
-    assert.equal(log.length, 1);
-    assert.equal(log[0].isDm, undefined, 'a plain guild channel must not record isDm at all');
-});
-//# sourceMappingURL=channel-label-history.test.js.map