@animalabs/agent-framework 0.18.0 → 0.20.0

package/dist/test/helpers/coalescing-fixture.js

@@ -0,0 +1,145 @@
+/**
+ * Shared RFC-006 wire fixture: a loopback WebSocket MCPL server, a mock model
+ * provider, and the framework under test. Used by test/mcpl-coalescing.test.ts
+ * and by the subprocess-kill child (coalescing-kill-child.ts).
+ */
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { once } from 'node:events';
+import { WebSocketServer } from 'ws';
+import { AgentFramework } from '../../src/framework.js';
+import { MockMembrane, MockYieldingStream, createMockResponse } from './mock-membrane.js';
+export const TS = '2026-09-30T00:00:00Z';
+export const ok = () => createMockResponse([{ type: 'text', text: 'ok' }]);
+export async function fixture(options = {}) {
+    const wss = new WebSocketServer({ port: options.port ?? 0, host: '127.0.0.1' });
+    await once(wss, 'listening');
+    let online = true;
+    let socket;
+    let next = 1000;
+    const replies = new Map();
+    const renders = [];
+    const hostCaps = [];
+    const published = [];
+    let renderer = async () => ({ content: [{ type: 'text', text: 'document_diff' }] });
+    wss.on('connection', (ws) => {
+        if (!online) {
+            ws.close();
+            return;
+        }
+        socket = ws;
+        ws.on('message', async (bytes) => {
+            const m = JSON.parse(String(bytes));
+            if (!m.method) {
+                replies.get(m.id)?.(m);
+                replies.delete(m.id);
+                return;
+            }
+            const reply = (result) => ws.send(JSON.stringify({ jsonrpc: '2.0', id: m.id, result }));
+            if (m.method === 'initialize') {
+                hostCaps.push(m.params.capabilities.experimental.mcpl);
+                reply({ protocolVersion: '2024-11-05', capabilities: { tools: {}, experimental: { mcpl: {
+                                version: '0.5', pushEvents: true, inferenceRequest: true,
+                                channels: { incoming: true, register: true, lifecycle: true, publish: true },
+                                featureSets: { doc: { description: 'doc', uses: ['pushEvents'] } },
+                            } } }, serverInfo: { name: 'editor', version: '1' } });
+            }
+            else if (m.method === 'featureSets/update')
+                reply({ accepted: true });
+            else if (m.method === 'tools/list')
+                reply({ tools: [] });
+            else if (m.method === 'channels/publish') {
+                published.push(m.params);
+                if (m.id !== undefined)
+                    reply({ delivered: true });
+            }
+            else if (m.method === 'channels/close')
+                reply({ closed: true });
+            else if (m.method === 'channels/open')
+                reply({ channel: { id: m.params.channelId, type: 'discord', label: m.params.channelId } });
+            else if (m.method === 'push/render') {
+                renders.push(m.params);
+                reply(await renderer(m.params));
+            }
+            else if (m.id !== undefined)
+                reply({});
+        });
+    });
+    const dir = options.dir ?? mkdtempSync(join(tmpdir(), 'coalescing-'));
+    let framework;
+    const membrane = new MockMembrane();
+    membrane.pushResponse(ok());
+    const create = async (grantPush = true) => {
+        framework = await AgentFramework.create({
+            storePath: join(dir, 'store'), membrane: membrane.asMembrane(),
+            agents: (options.agents ?? [{ name: 'agent', model: 'test', systemPrompt: 'test' }]),
+            modules: [], ...options.framework,
+            mcplServers: [{ id: 'editor', url: `ws://127.0.0.1:${wss.address().port}`, enabledFeatureSets: ['doc'],
+                    ...options.server, ...(grantPush ? {} : { disabledCapabilities: ['pushEvents'] }) }],
+        });
+        return framework;
+    };
+    const send = (method, params) => new Promise((resolve, reject) => {
+        const id = next++;
+        const timer = setTimeout(() => reject(new Error(`no reply to ${method}`)), 3000);
+        replies.set(id, (value) => { clearTimeout(timer); resolve(value); });
+        socket.send(JSON.stringify({ jsonrpc: '2.0', id, method, params }));
+    });
+    await create();
+    return {
+        get framework() { return framework; }, membrane, renders, hostCaps, published, create, send, dir,
+        port: wss.address().port,
+        disconnect: () => socket.terminate(),
+        online: (value) => { online = value; },
+        register: (id = 'chat') => send('channels/register', { channels: [{ id, type: 'discord', label: id, metadata: { channelType: 'guild_text' } }] }),
+        /** A coalesced channels/incoming message for platform message `m`. */
+        channel: (eventId, text, flags = {}, channelId = 'chat', messageId = 'm') => ({
+            channelId, messageId, eventId, timestamp: TS, author: { id: 'u', name: 'User' }, tags: ['chat:mention'],
+            content: text ? [{ type: 'text', text }] : [], coalesce: { key: `message:${messageId}`, ...flags },
+        }),
+        /** A coalesced feature-set push. */
+        params: (eventId, text, flags = {}) => ({
+            featureSet: 'doc', eventId, timestamp: TS, coalesce: { key: 'document', ...flags },
+            payload: { content: text ? [{ type: 'text', text }] : [] },
+        }),
+        renderer: (fn) => { renderer = fn; },
+        /** Serialized context of the primary agent. */
+        context: (agent = 'agent') => JSON.stringify(framework.getAgent(agent).getContextManager().getAllMessages()),
+        /** Serialized messages of the last model request (tool descriptions excluded). */
+        lastRequest: () => JSON.stringify(membrane.calls.at(-1)?.messages),
+        turn: async () => { membrane.pushResponse(ok()); await framework.runUntilIdle(); },
+        /** Every subsequent model call gets a complete 'ok' response (multi-turn tests). */
+        alwaysRespond: () => {
+            membrane.streamYielding = (request) => {
+                membrane.calls.push(request);
+                return new MockYieldingStream([ok()]);
+            };
+        },
+        close: async () => {
+            await framework.stop();
+            for (const client of wss.clients)
+                client.terminate();
+            await new Promise((r) => wss.close(() => r()));
+            rmSync(dir, { recursive: true, force: true });
+        },
+    };
+}
+export async function eventually(predicate, what = 'condition') {
+    const deadline = Date.now() + 3000;
+    while (!predicate()) {
+        assert(Date.now() < deadline, `${what} did not settle`);
+        await new Promise((r) => setTimeout(r, 10));
+    }
+}
+/** Simulate a crash: stop without the snapshot flush a clean stop performs. */
+export async function crash(f) {
+    const internals = f.framework;
+    if (internals.coalescingSaveTimer)
+        clearTimeout(internals.coalescingSaveTimer);
+    internals.coalescingSaveTimer = null;
+    internals.flushCoalescingSnapshot = () => { };
+    await f.framework.stop();
+}
+//# sourceMappingURL=coalescing-fixture.js.map

package/dist/test/helpers/coalescing-fixture.js.map

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

package/dist/test/helpers/coalescing-kill-child.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=coalescing-kill-child.d.ts.map

package/dist/test/helpers/coalescing-kill-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalescing-kill-child.d.ts","sourceRoot":"","sources":["../../../test/helpers/coalescing-kill-child.ts"],"names":[],"mappings":""}

package/dist/test/helpers/coalescing-kill-child.js

@@ -0,0 +1,24 @@
+/**
+ * Subprocess for the SIGKILL durability tests (test/mcpl-coalescing.test.ts,
+ * round 5): runs the fixture on the given store directory, reaches the
+ * requested boundary, reports over IPC, and then waits to be killed. No
+ * stop(), no close(), no sync() of its own.
+ */
+import { fixture } from './coalescing-fixture.js';
+const [dir, mode] = process.argv.slice(2);
+const f = await fixture({ dir });
+if (mode === 'accept') {
+    const r = await f.send('push/event', f.params('1', 'killed_fallback', { deferred: true, data: { k: 'v' } }));
+    process.send({ port: f.port, receipt: r.result });
+}
+else {
+    let reached;
+    const started = new Promise((resolve) => { reached = resolve; });
+    f.renderer(() => { reached(); return new Promise(() => { }); });
+    await f.send('push/event', f.params('1', 'render_fallback', { deferred: true }));
+    void f.framework.runUntilIdle();
+    await started;
+    process.send({ port: f.port, receipt: null });
+}
+await new Promise(() => { });
+//# sourceMappingURL=coalescing-kill-child.js.map

package/dist/test/helpers/coalescing-kill-child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalescing-kill-child.js","sourceRoot":"","sources":["../../../test/helpers/coalescing-kill-child.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1C,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AACjC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;IACtB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7G,OAAO,CAAC,IAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACrD,CAAC;KAAM,CAAC;IACN,IAAI,OAAoB,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,GAA6B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjF,KAAK,CAAC,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;IAChC,MAAM,OAAO,CAAC;IACd,OAAO,CAAC,IAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AACD,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAA0B,CAAC,CAAC,CAAC"}

package/dist/test/history-module-realstore.test.d.ts

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

package/dist/test/history-module-realstore.test.d.ts.map

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

package/dist/test/history-module-realstore.test.js

@@ -0,0 +1,363 @@
+import { describe, it, after } 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 { MessageStore } from '@animalabs/context-manager';
+import { HistoryModule } from '../src/modules/history/index.js';
+/**
+ * PR #174 review repros on a REAL chronicle-backed MessageStore (not a stub):
+ * messages are appended in one order and their timestamps rewritten after
+ * append (the way context-manager's own history-index tests do it), so
+ * append order and timestamp order genuinely disagree — Discord catch-up
+ * backfill. Channel-scoped native queries come back in APPEND order here.
+ */
+const dirs = [];
+after(() => {
+    for (const d of dirs)
+        rmSync(d, { recursive: true, force: true });
+});
+function build(rows) {
+    const dir = mkdtempSync(join(tmpdir(), 'af-history-real-'));
+    dirs.push(dir);
+    const store = JsStore.openOrCreate({ path: join(dir, 'store') });
+    try {
+        MessageStore.register(store);
+    }
+    catch { }
+    const ms = new MessageStore(store);
+    const ids = new Map();
+    // Live position of the next append: removals splice state items out.
+    let live = 0;
+    const append = (r) => {
+        const meta = { channelId: r.channel };
+        if (r.author)
+            meta.author = { id: r.authorId ?? `id-${r.author}`, name: r.author };
+        const m = ms.append('user', [{ type: 'text', text: r.text }], meta);
+        ids.set(r.text, String(m.id));
+        const item = store.getStateItemJson('messages', live);
+        store.editStateItem('messages', live, Buffer.from(JSON.stringify({ ...item, timestamp: r.ms })));
+        live++;
+    };
+    const remove = (text) => {
+        ms.remove(ids.get(text));
+        live--;
+    };
+    rows.forEach(append);
+    const cm = {
+        queryMessagesByTime: (o) => ms.queryByTime(o),
+        queryMessagesByTimeAndChannel: (o) => ms.queryByTimeAndChannel(o),
+        getMessage: (id) => ms.get(id),
+        getMessageCount: () => ms.length(),
+        getMessageWindow: (offset, limit) => ms.getWindow(offset, limit),
+    };
+    const mod = new HistoryModule();
+    mod.bind(cm);
+    return { mod, ids, append, remove };
+}
+async function call(mod, name, input) {
+    const r = await mod.handleToolCall({ id: 't', name, input });
+    assert.equal(r.success, true, r.error);
+    return r.data;
+}
+const texts = (ms) => ms.map((m) => String(m.text ?? m.content).replace(/^.*?:\s*/, ''));
+const MIN = 60_000;
+describe('HistoryModule on a real store (PR #174 review)', () => {
+    it('finding 1: extract author+channel continuation reaches late-appended older messages', async () => {
+        const now = Date.now();
+        const rows = [60, 50, 40, 30, 20].map((m, i) => ({ text: `a${i + 1}`, channel: 'diary', author: 'antra', ms: now - m * MIN }));
+        rows.push({ text: 'b1', channel: 'diary', author: 'antra', ms: now - 55 * MIN });
+        rows.push({ text: 'b2', channel: 'diary', author: 'antra', ms: now - 25 * MIN });
+        const { mod } = build(rows);
+        const seen = [];
+        let d = await call(mod, 'extract', { author: 'antra', channelId: 'diary', maxScan: 5 });
+        seen.push(...d.messages.map((m) => m.id));
+        for (let guard = 0; d.truncated && guard < 10; guard++) {
+            assert.ok(d.resume, `truncated response must carry a resume object, got ${JSON.stringify(d)}`);
+            d = await call(mod, 'extract', { author: 'antra', channelId: 'diary', maxScan: 5, ...d.resume });
+            seen.push(...d.messages.map((m) => m.id));
+        }
+        assert.equal(new Set(seen).size, 7, `continuation must reach all 7 messages, saw ${seen.length} (${new Set(seen).size} distinct)`);
+    });
+    it('finding 1: pageFull continuation also resumes by position', async () => {
+        const now = Date.now();
+        const rows = [60, 50, 40, 30, 20].map((m, i) => ({ text: `a${i + 1}`, channel: 'diary', author: 'antra', ms: now - m * MIN }));
+        rows.push({ text: 'b1', channel: 'diary', author: 'antra', ms: now - 55 * MIN });
+        const { mod } = build(rows);
+        const seen = [];
+        let d = await call(mod, 'extract', { author: 'antra', channelId: 'diary', limit: 2 });
+        seen.push(...d.messages.map((m) => m.id));
+        for (let guard = 0; d.truncated && guard < 10; guard++) {
+            d = await call(mod, 'extract', { author: 'antra', channelId: 'diary', limit: 2, ...d.resume });
+            seen.push(...d.messages.map((m) => m.id));
+        }
+        assert.equal(new Set(seen).size, 6);
+        assert.equal(seen.length, 6, 'no repeats');
+    });
+    it('finding 2: newest edge window is the timestamp tail even when it overshoots fetchCap', async () => {
+        const now = Date.now();
+        const rows = [{ text: 'elsewhere', channel: 'x', ms: now - 30 * 24 * 60 * MIN }];
+        const dense0 = now - 3 * 24 * 60 * MIN;
+        for (let i = 0; i < 2000; i++)
+            rows.push({ text: `dense${i}`, channel: 'd', ms: dense0 + i * 1000 });
+        [55, 45, 35, 25, 15].forEach((m, i) => rows.push({ text: `q${i + 1}`, channel: 'd', ms: now - m * MIN }));
+        rows.push({ text: 'OLD-backfill', channel: 'd', ms: now - 4 * 24 * 60 * MIN });
+        const { mod, ids } = build(rows);
+        const s = await call(mod, 'search', { query: 'e', channelId: 'd', order: 'newest', maxScan: 10 });
+        // every dense* contains "e"; q* don't — check the pool edge via scannedThrough
+        assert.equal(s.truncated, true);
+        assert.equal(s.scannedThrough, new Date(dense0 + 1995 * 1000).toISOString());
+        assert.ok(!s.matches.some((m) => m.id === ids.get('OLD-backfill')));
+        const a = await call(mod, 'extract', { aroundId: ids.get('q1'), before: 5, after: 2 });
+        assert.deepEqual(a.messages.map((m) => m.id), ['dense1995', 'dense1996', 'dense1997', 'dense1998', 'dense1999', 'q1', 'q2', 'q3'].map((t) => ids.get(t)));
+    });
+    it('finding 2: a single millisecond larger than fetchCap still yields the exact (timestamp, sequence) tail', async () => {
+        const now = Date.now();
+        const T = now - 60 * MIN;
+        const rows = [{ text: 'm-old', channel: 'x', ms: now - 30 * 24 * 60 * MIN }];
+        for (let i = 0; i < 1100; i++)
+            rows.push({ text: `m-tie${i}`, channel: 'd', ms: T });
+        [30, 20, 10].forEach((m, i) => rows.push({ text: `m-late${i}`, channel: 'd', ms: now - m * MIN }));
+        rows.push({ text: 'm-backfill', channel: 'd', ms: T - 1000 });
+        const { mod, ids } = build(rows);
+        const s = await call(mod, 'search', { query: 'm-', channelId: 'd', order: 'newest', maxScan: 10, limit: 50 });
+        assert.deepEqual(s.matches.map((m) => m.id), ['m-late2', 'm-late1', 'm-late0', ...[1099, 1098, 1097, 1096, 1095, 1094, 1093].map((i) => `m-tie${i}`)].map((t) => ids.get(t)));
+    });
+    it('note 6: author "user" does not match every MCPL-ingested message', async () => {
+        const { mod } = build([{ text: 'hello', channel: 'z', ms: Date.now() - MIN, author: 'antra' }]);
+        assert.equal((await call(mod, 'search', { query: 'hello', author: 'user' })).matches.length, 0);
+    });
+    it('note 5: channel newest window is not capped at Date.now()', async () => {
+        const now = Date.now();
+        const rows = [{ text: 'old', channel: 'x', ms: now - 60 * 24 * 60 * MIN }];
+        for (let i = 0; i < 20; i++)
+            rows.push({ text: `c${i}`, channel: 'c', ms: now - 5 * MIN + i * 10_000 });
+        rows.push({ text: 'future', channel: 'c', ms: now + 60_000 });
+        const { mod, ids } = build(rows);
+        const s = await call(mod, 'search', { query: 'c', channelId: 'c', order: 'newest', maxScan: 5, limit: 50 });
+        const noCh = await call(mod, 'search', { query: 'u', order: 'newest', maxScan: 5, limit: 50 });
+        assert.equal(noCh.matches[0].id, ids.get('future'));
+        assert.equal(s.scannedThrough, new Date(now - 5 * MIN + 16 * 10_000).toISOString());
+        // pool = future c19 c18 c17 c16 — "future" contains no "c", so first match is c19
+        assert.equal(s.matches[0].id, ids.get('c19'));
+        assert.equal(s.matches.length, 4);
+    });
+    it('note 3: author id with uppercase letters matches', async () => {
+        const { mod, ids } = build([{ text: 'hi', channel: 'z', ms: Date.now() - MIN, author: 'Ann', authorId: 'U0ABC' }]);
+        const d = await call(mod, 'search', { query: 'hi', author: 'U0ABC' });
+        assert.deepEqual(d.matches.map((m) => m.id), [ids.get('hi')]);
+    });
+    it('note 4: wholeWord treats combining marks as word characters', async () => {
+        const { mod } = build([
+            { text: 'café au lait', channel: 'z', ms: Date.now() - 2 * MIN },
+            { text: 'नमस्ते', channel: 'z', ms: Date.now() - MIN },
+        ]);
+        assert.equal((await call(mod, 'search', { query: 'cafe', wholeWord: true })).matches.length, 0);
+        assert.equal((await call(mod, 'search', { query: 'नम', wholeWord: true })).matches.length, 0);
+    });
+});
+describe('Greptile review on 62b57f0 (real store)', () => {
+    const ids = (d, key = 'messages') => d[key].map((m) => m.id);
+    it('G1: search limit continuation makes progress (distinct times and a same-ms group)', async () => {
+        const now = Date.now();
+        const rows = [1, 2, 3].map((i) => ({ text: `x${i}`, channel: 'c', ms: now - (10 - i) * MIN }));
+        for (let i = 0; i < 5; i++)
+            rows.push({ text: `x-tie${i}`, channel: 'c', ms: now - MIN });
+        const { mod } = build(rows);
+        for (const [order, extra] of [['oldest', { limit: 1 }], ['newest', { limit: 1 }], ['oldest', { maxScan: 2 }], ['newest', { maxScan: 2 }]]) {
+            const seen = [];
+            let d = await call(mod, 'search', { query: 'x', order, ...extra });
+            seen.push(...ids(d, 'matches'));
+            for (let guard = 0; (d.resume || d.scannedThrough) && guard < 12; guard++) {
+                const cont = d.resume ?? { [order === 'oldest' ? 'from' : 'to']: d.scannedThrough };
+                d = await call(mod, 'search', { query: 'x', order, ...extra, ...cont });
+                seen.push(...ids(d, 'matches'));
+            }
+            assert.equal(new Set(seen).size, 8, `${order} ${JSON.stringify(extra)}: reached ${new Set(seen).size}/8`);
+            assert.equal(seen.length, 8, `${order} ${JSON.stringify(extra)}: no repeats`);
+        }
+    });
+    it('G2: a resumed, exhausted author extract does not claim the whole-window matchedCount', async () => {
+        const now = Date.now();
+        const { mod } = build([1, 2, 3, 4].map((i) => ({ text: `a${i}`, channel: 'd', author: 'antra', ms: now - (10 - i) * MIN })));
+        const first = await call(mod, 'extract', { author: 'antra', channelId: 'd', maxScan: 3 });
+        const second = await call(mod, 'extract', { author: 'antra', channelId: 'd', maxScan: 3, ...first.resume });
+        assert.equal(second.truncated, false);
+        assert.equal(second.matchedCount, undefined, 'resumed scan saw only part of the window');
+        assert.equal(first.matchedCountAtLeast + second.matchedSinceWindowOffset, 4);
+    });
+    it('G3: aroundId rejects limit instead of silently ignoring it', async () => {
+        const { mod, ids: m } = build([{ text: 'a', channel: 'd', ms: Date.now() - MIN }]);
+        const r = await mod.handleToolCall({ id: 't', name: 'extract', input: { aroundId: m.get('a'), limit: 1 } });
+        assert.equal(r.success, false);
+    });
+    it('G4: aroundId inside a same-millisecond group larger than the tie cap returns true neighbours', async () => {
+        const now = Date.now();
+        const rows = [];
+        for (let i = 0; i < 1100; i++)
+            rows.push({ text: `t${i}`, channel: 'd', ms: now - MIN });
+        const { mod, ids: m } = build(rows);
+        const d = await call(mod, 'extract', { aroundId: m.get('t590'), before: 3, after: 2 });
+        assert.deepEqual(ids(d), [587, 588, 589, 590, 591, 592].map((i) => m.get(`t${i}`)));
+    });
+    it('G5: <@id> mention form works for alphanumeric ids', async () => {
+        const { mod, ids: m } = build([{ text: 'hi', channel: 'z', ms: Date.now() - MIN, author: 'Ann', authorId: 'U0ABC' }]);
+        assert.deepEqual(ids(await call(mod, 'search', { query: 'hi', author: '<@U0ABC>' }), 'matches'), [m.get('hi')]);
+        assert.equal((await call(mod, 'search', { query: 'hi', excludeAuthor: '<@U0ABC>' })).matches.length, 0);
+    });
+    it('G6: wholeWord sees astral-plane letters beside the match', async () => {
+        const { mod } = build([{ text: '\u{1D504}a b\u{1D504}', channel: 'z', ms: Date.now() - MIN }]);
+        assert.equal((await call(mod, 'search', { query: 'a', wholeWord: true })).matches.length, 0);
+        assert.equal((await call(mod, 'search', { query: 'b', wholeWord: true })).matches.length, 0);
+    });
+    it('G7: author schema does not advertise a form its declared type rejects', () => {
+        const tools = new HistoryModule().getTools();
+        for (const t of tools) {
+            for (const k of ['author', 'excludeAuthor']) {
+                const p = t.inputSchema.properties?.[k];
+                if (!p)
+                    continue;
+                const allowsString = p.type === 'string' || (Array.isArray(p.type) && p.type.includes('string'));
+                assert.ok(allowsString || !/single string/i.test(p.description), `${t.name}.${k}`);
+            }
+        }
+    });
+    it('G8: limit:0 author extract resume advances; maxScan:0 is rejected', async () => {
+        const now = Date.now();
+        const { mod } = build([1, 2, 3].map((i) => ({ text: `a${i}`, channel: 'd', author: 'antra', ms: now - (10 - i) * MIN })));
+        const d = await call(mod, 'extract', { author: 'antra', channelId: 'd', limit: 0 });
+        assert.ok(!d.truncated || d.resume.windowOffset > 0, JSON.stringify(d));
+        const r = await mod.handleToolCall({ id: 't', name: 'extract', input: { author: 'antra', maxScan: 0 } });
+        assert.equal(r.success, false);
+    });
+});
+describe('HistoryModule on a real store: window changes between resume calls (PR #174 re-review)', () => {
+    const rowsN = (n, channel = 'd') => {
+        const now = Date.now();
+        return Array.from({ length: n }, (_, i) => ({ text: `m${i}`, channel, author: 'antra', ms: now - (100 - i) * MIN }));
+    };
+    const texts2 = (d) => d.messages.map((m) => String(m.content).replace(/^.*?:\s*/, ''));
+    for (const channelId of ['d', undefined]) {
+        it(`extract author resume after a removal before the cursor skips nothing (${channelId ? 'channel' : 'no channel'})`, async () => {
+            const { mod, remove } = build(rowsN(9));
+            const q = { author: 'antra', limit: 4, ...(channelId ? { channelId } : {}) };
+            const first = await call(mod, 'extract', q);
+            assert.deepEqual(texts2(first), ['m0', 'm1', 'm2', 'm3']);
+            remove('m1');
+            const second = await call(mod, 'extract', { ...q, ...first.resume });
+            assert.deepEqual(texts2(second), ['m4', 'm5', 'm6', 'm7']);
+            assert.equal(second.windowChanged?.shift, -1);
+        });
+    }
+    it('extract author resume after an older-stamped insertion before the cursor repeats nothing, and says so', async () => {
+        const { mod, append } = build(rowsN(9));
+        const first = await call(mod, 'extract', { author: 'antra', limit: 4 });
+        assert.deepEqual(texts2(first), ['m0', 'm1', 'm2', 'm3']);
+        // catch-up backfill: appended now, stamped between m0 and m1 → lands before the cursor in the time-ordered window
+        append({ text: 'late', channel: 'd', author: 'antra', ms: Date.now() - 99.5 * MIN });
+        const second = await call(mod, 'extract', { author: 'antra', limit: 4, ...first.resume });
+        assert.deepEqual(texts2(second), ['m4', 'm5', 'm6', 'm7']);
+        assert.equal(second.windowChanged?.shift, 1);
+        assert.match(second.windowChanged.note, /did not see/);
+    });
+    it('extract author resume notices a BALANCED change (one removal + one older-stamped insertion before the cursor)', async () => {
+        const { mod, append, remove, ids: m } = build(rowsN(9));
+        const first = await call(mod, 'extract', { author: 'antra', limit: 4 });
+        assert.deepEqual(texts2(first), ['m0', 'm1', 'm2', 'm3']);
+        remove('m1');
+        append({ text: 'late', channel: 'd', author: 'antra', ms: Date.now() - 99.5 * MIN });
+        const second = await call(mod, 'extract', { author: 'antra', limit: 4, ...first.resume });
+        assert.deepEqual(texts2(second), ['m4', 'm5', 'm6', 'm7']);
+        assert.ok(second.windowChanged, 'a message landed behind the cursor; the response must say so');
+        assert.deepEqual(second.windowChanged.missedIds, [m.get('late')]);
+    });
+    it('extract author resume (no channel) is not broken by many unrelated appends since seqMark', async () => {
+        const { mod, append } = build(rowsN(9));
+        const first = await call(mod, 'extract', { author: 'antra', limit: 4 });
+        for (let i = 0; i < 1500; i++)
+            append({ text: `busy${i}`, channel: 'other', author: 'bob', ms: Date.now() });
+        const second = await call(mod, 'extract', { author: 'antra', limit: 4, ...first.resume });
+        assert.deepEqual(texts2(second), ['m4', 'm5', 'm6', 'm7']);
+        assert.equal(second.windowChanged, undefined);
+    });
+    it('extract author resume in a channel window: a late append lands after the cursor and is simply returned', async () => {
+        const { mod, append, remove } = build(rowsN(9));
+        const q = { author: 'antra', limit: 4, channelId: 'd' };
+        const first = await call(mod, 'extract', q);
+        remove('m1');
+        append({ text: 'late', channel: 'd', author: 'antra', ms: Date.now() - 99.5 * MIN });
+        const second = await call(mod, 'extract', { ...q, limit: 10, ...first.resume });
+        assert.deepEqual(texts2(second), ['m4', 'm5', 'm6', 'm7', 'm8', 'late']);
+    });
+    it('extract resume fails loudly when the anchor message itself was removed, or afterId is missing', async () => {
+        const { mod, remove } = build(rowsN(9));
+        const first = await call(mod, 'extract', { author: 'antra', channelId: 'd', limit: 4 });
+        remove('m3');
+        const r = await mod.handleToolCall({ id: 't', name: 'extract', input: { author: 'antra', channelId: 'd', limit: 4, ...first.resume } });
+        assert.equal(r.success, false);
+        assert.match(r.error, /window changed/);
+        const noId = await mod.handleToolCall({ id: 't', name: 'extract', input: { author: 'antra', channelId: 'd', windowOffset: 4 } });
+        assert.equal(noId.success, false);
+        assert.match(noId.error, /afterId/);
+    });
+    const chain = async (mod, base, between) => {
+        const seen = [];
+        let d = await call(mod, 'search', base);
+        seen.push(...d.matches.map((m) => m.id));
+        for (let step = 0; d.resume && step < 20; step++) {
+            between?.(step);
+            d = await call(mod, 'search', { ...base, ...d.resume });
+            seen.push(...d.matches.map((m) => m.id));
+        }
+        return seen;
+    };
+    for (const channelId of ['c', undefined]) {
+        it(`search newest: a message appended at the resume instant between calls is not lost (${channelId ? 'channel' : 'no channel'})`, async () => {
+            const now = Date.now();
+            const tieMs = now - MIN;
+            const rows = [1, 2].map((i) => ({ text: `x-old${i}`, channel: 'c', ms: now - (10 - i) * MIN }));
+            for (let i = 0; i < 6; i++)
+                rows.push({ text: `x-tie${i}`, channel: 'c', ms: tieMs });
+            const { mod, append, ids: m } = build(rows);
+            const base = { query: 'x', order: 'newest', limit: 3, ...(channelId ? { channelId } : {}) };
+            const seen = await chain(mod, base, (step) => {
+                if (step === 0)
+                    append({ text: 'x-tie-new', channel: 'c', ms: tieMs });
+            });
+            assert.ok(seen.includes(m.get('x-tie-new')), 'appended tie reached');
+            assert.equal(new Set(seen).size, 9);
+            assert.equal(seen.length, 9, 'no repeats');
+        });
+    }
+    it('search oldest: removing an already-scanned message at the resume instant does not skip an unscanned one', async () => {
+        const now = Date.now();
+        const tieMs = now - MIN;
+        const rows = [];
+        for (let i = 0; i < 6; i++)
+            rows.push({ text: `x-tie${i}`, channel: 'c', ms: tieMs });
+        rows.push({ text: 'x-after', channel: 'c', ms: now - 0.5 * MIN });
+        const { mod, remove, ids: m } = build(rows);
+        const seen = await chain(mod, { query: 'x', limit: 2 }, (step) => {
+            if (step === 0)
+                remove('x-tie0');
+        });
+        const expected = ['x-tie0', 'x-tie1', 'x-tie2', 'x-tie3', 'x-tie4', 'x-tie5', 'x-after'].map((t) => m.get(t));
+        assert.deepEqual(seen, expected);
+    });
+    it('search rejects maxScan:0 (it could never make progress)', async () => {
+        const { mod } = build(rowsN(2));
+        const r = await mod.handleToolCall({ id: 't', name: 'search', input: { query: 'm', maxScan: 0 } });
+        assert.equal(r.success, false);
+        assert.match(r.error, /maxScan/);
+    });
+    it('aroundId accepts a semantic_search "msg:<id>" hit and explains a "sum:<id>" one', async () => {
+        const { mod, ids: m } = build(rowsN(5));
+        const d = await call(mod, 'extract', { aroundId: `msg:${m.get('m2')}`, before: 1, after: 1 });
+        assert.deepEqual(texts2(d), ['m1', 'm2', 'm3']);
+        const r = await mod.handleToolCall({ id: 't', name: 'extract', input: { aroundId: 'sum:42' } });
+        assert.equal(r.success, false);
+        assert.match(r.error, /summary/);
+    });
+});
+//# sourceMappingURL=history-module-realstore.test.js.map