@animalabs/agent-framework 0.5.6 → 0.6.0

package/dist/test/helpers/mock-membrane.js.map

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

package/dist/test/inference-failure-observability.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inference-failure-observability.test.d.ts.map

package/dist/test/inference-failure-observability.test.d.ts.map

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

package/dist/test/inference-failure-observability.test.js

@@ -0,0 +1,75 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { AgentFramework } from '../src/framework.js';
+/**
+ * noteInferenceExhausted is the central observability hook for a fully-failed
+ * inference. It's private and the full framework is heavy to construct, so we
+ * exercise it on a prototype instance with just the fields it touches stubbed.
+ */
+function makeHarness() {
+    const fw = Object.create(AgentFramework.prototype);
+    fw.consecutiveInferenceFailures = new Map();
+    fw.inferenceFailureEscalationThreshold = 3;
+    const markers = [];
+    fw.agents = new Map([['cairn', {
+                getContextManager: () => ({
+                    addMessage: (_p, content, meta) => {
+                        markers.push({ text: content[0].text, meta });
+                    },
+                }),
+            }]]);
+    const errs = [];
+    const orig = console.error;
+    console.error = (...a) => { errs.push(a.join(' ')); };
+    const restore = () => { console.error = orig; };
+    return { fw, markers, errs, restore };
+}
+test('exhausted inference: stderr line + [inference-failed] chronicle marker', () => {
+    const { fw, markers, errs, restore } = makeHarness();
+    try {
+        fw.noteInferenceExhausted('cairn', '400 image exceeds 5 MB');
+    }
+    finally {
+        restore();
+    }
+    // (1) stderr, with the underlying reason
+    assert.ok(errs.some(e => e.includes('[inference-failed]') && e.includes('image exceeds 5 MB')), 'should log the failure + reason to stderr');
+    // (2) agent-facing chronicle marker carrying the reason, tagged for filtering
+    assert.equal(markers.length, 1);
+    assert.match(markers[0].text, /\[inference-failed\]/);
+    assert.match(markers[0].text, /image exceeds 5 MB/);
+    assert.equal(markers[0].meta.kind, 'inference-failed');
+    assert.equal(markers[0].meta.consecutive, 1);
+});
+test('consecutive failures escalate to hard-down; success resets the streak', () => {
+    const { fw, errs, restore } = makeHarness();
+    try {
+        fw.noteInferenceExhausted('cairn', 'boom'); // 1
+        fw.noteInferenceExhausted('cairn', 'boom'); // 2
+        assert.ok(!errs.some(e => e.includes('inference-hard-down')), 'no escalation before threshold');
+        fw.noteInferenceExhausted('cairn', 'boom'); // 3 → hard-down
+        assert.ok(errs.some(e => e.includes('[inference-hard-down]') && e.includes('3 consecutive')), 'should escalate at the threshold');
+        assert.equal(fw.consecutiveInferenceFailures.get('cairn'), 3);
+        // A successful inference:completed clears the streak (via emitTrace).
+        fw.traceListeners = [];
+        fw.emitTrace({ type: 'inference:completed', agentName: 'cairn' });
+        assert.equal(fw.consecutiveInferenceFailures.get('cairn'), 0);
+    }
+    finally {
+        restore();
+    }
+});
+test('per-agent isolation: one agent failing does not flag another', () => {
+    const { fw, restore } = makeHarness();
+    fw.agents.set('lena', { getContextManager: () => ({ addMessage: () => { } }) });
+    try {
+        fw.noteInferenceExhausted('cairn', 'x');
+        fw.noteInferenceExhausted('cairn', 'x');
+    }
+    finally {
+        restore();
+    }
+    assert.equal(fw.consecutiveInferenceFailures.get('cairn'), 2);
+    assert.equal(fw.consecutiveInferenceFailures.get('lena') ?? 0, 0);
+});
+//# sourceMappingURL=inference-failure-observability.test.js.map

package/dist/test/inference-failure-observability.test.js.map

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

package/dist/test/liveness-watchdog.test.d.ts

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

package/dist/test/liveness-watchdog.test.d.ts.map

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

package/dist/test/liveness-watchdog.test.js

@@ -0,0 +1,78 @@
+import { test } from 'node:test';
+import assert from 'node:assert';
+import { spawn } from 'node:child_process';
+import { mkdtempSync, writeFileSync, rmSync, existsSync, readFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+const WATCHDOG = pathToFileURL(join(import.meta.dirname, '../src/runtime/liveness-watchdog.js')).href;
+/** Spawn a child that starts the watchdog then wedges its main thread; resolve
+ *  with how it died. */
+function runWedgedChild(action, reportPath) {
+    const dir = mkdtempSync(join(tmpdir(), 'wd-'));
+    const script = join(dir, 'child.mjs');
+    writeFileSync(script, `
+    import { LivenessWatchdog } from ${JSON.stringify(WATCHDOG)};
+    const w = new LivenessWatchdog({
+      enabled: true, thresholdMs: 400, heartbeatMs: 100,
+      action: ${JSON.stringify(action)},
+      reportPath: ${reportPath ? JSON.stringify(reportPath) : 'undefined'},
+    });
+    w.start();
+    w.setPhase('test-wedge');
+    // Heartbeat a few times, then wedge the main thread synchronously forever.
+    setTimeout(() => { const end = Date.now() + 30000; while (Date.now() < end) {} }, 300);
+    `);
+    return new Promise((resolve) => {
+        const child = spawn(process.execPath, [script], { stdio: 'ignore' });
+        const killTimer = setTimeout(() => child.kill('SIGTERM'), 8000); // safety net
+        child.on('exit', (code, signal) => {
+            clearTimeout(killTimer);
+            rmSync(dir, { recursive: true, force: true });
+            resolve({ code, signal });
+        });
+    });
+}
+test("watchdog kills a wedged process (action: 'exit' → SIGKILL)", async () => {
+    const { signal } = await runWedgedChild('exit', null);
+    assert.strictEqual(signal, 'SIGKILL', `expected SIGKILL, got code/signal ${signal}`);
+});
+test("watchdog aborts a wedged process (action: 'abort' → SIGABRT) and writes a report", async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'wd-rep-'));
+    const reportPath = join(dir, 'wedge.jsonl');
+    try {
+        const { signal } = await runWedgedChild('abort', reportPath);
+        assert.strictEqual(signal, 'SIGABRT', `expected SIGABRT, got ${signal}`);
+        assert.ok(existsSync(reportPath), 'wedge report file should exist');
+        const rep = JSON.parse(readFileSync(reportPath, 'utf8').trim().split('\n')[0]);
+        assert.strictEqual(rep.event, 'main-thread-wedged');
+        assert.strictEqual(rep.phase, 'test-wedge');
+        assert.ok(rep.ageMs >= 400);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('watchdog does NOT kill a healthy (heartbeating) process', async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'wd-ok-'));
+    const script = join(dir, 'ok.mjs');
+    writeFileSync(script, `
+    import { LivenessWatchdog } from ${JSON.stringify(WATCHDOG)};
+    const w = new LivenessWatchdog({ enabled: true, thresholdMs: 400, heartbeatMs: 100, action: 'exit' });
+    w.start();
+    // stay alive and responsive for ~1.5s, never wedging, then exit cleanly
+    setTimeout(() => { w.stop(); process.exit(0); }, 1500);
+    `);
+    try {
+        const result = await new Promise((resolve) => {
+            const child = spawn(process.execPath, [script], { stdio: 'ignore' });
+            child.on('exit', (code, signal) => resolve({ code, signal }));
+        });
+        assert.strictEqual(result.signal, null, 'healthy process should not be signalled');
+        assert.strictEqual(result.code, 0, 'healthy process should exit cleanly');
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=liveness-watchdog.test.js.map

package/dist/test/liveness-watchdog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveness-watchdog.test.js","sourceRoot":"","sources":["../../test/liveness-watchdog.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAC,CAAC,IAAI,CAAC;AAEtG;wBACwB;AACxB,SAAS,cAAc,CAAC,MAAwB,EAAE,UAAyB;IACzE,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACtC,aAAa,CACX,MAAM,EACN;uCACmC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;;;gBAG/C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;oBAClB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW;;;;;;KAMpE,CACF,CAAC;IACF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa;QAC9E,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;IAC5E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,qCAAqC,MAAM,EAAE,CAAC,CAAC;AACvF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;IAClG,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,yBAAyB,MAAM,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,gCAAgC,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;IACzE,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnC,aAAa,CACX,MAAM,EACN;uCACmC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;;;;;KAK1D,CACF,CAAC;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAiD,CAAC,OAAO,EAAE,EAAE;YAC3F,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,yCAAyC,CAAC,CAAC;QACnF,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,qCAAqC,CAAC,CAAC;IAC5E,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/test/mcpl-ws-transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcpl-ws-transport.test.d.ts.map

package/dist/test/mcpl-ws-transport.test.d.ts.map

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

package/dist/test/mcpl-ws-transport.test.js

@@ -0,0 +1,155 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { WebSocketServer } from 'ws';
+import { McplServerConnection } from '../src/mcpl/server-connection.js';
+import { buildWebSocketUrl, isWebSocketTransport } from '../src/mcpl/transport.js';
+const HOST_CAPS = { version: '0.4', pushEvents: true, featureSets: true };
+/**
+ * A minimal in-process MCPL server over WebSocket: answers the initialize
+ * handshake, tools/list, and an `echo` tools/call. One JSON-RPC message per WS
+ * frame (as McplServerConnection sends). `onSocket` lets a test grab the raw
+ * socket to simulate a mid-session drop.
+ */
+function startMockMcplWsServer(onSocket) {
+    const wss = new WebSocketServer({ port: 0, host: '127.0.0.1' });
+    wss.on('connection', (ws) => {
+        onSocket?.(ws);
+        ws.on('message', (data) => {
+            let msg;
+            try {
+                msg = JSON.parse(String(data));
+            }
+            catch {
+                return;
+            }
+            const reply = (result) => ws.send(JSON.stringify({ jsonrpc: '2.0', id: msg.id, result }));
+            switch (msg.method) {
+                case 'initialize':
+                    reply({ capabilities: { experimental: { mcpl: { version: '0.4', pushEvents: true } } } });
+                    break;
+                case 'notifications/initialized':
+                    break; // notification, no reply
+                case 'tools/list':
+                    reply({ tools: [{ name: 'echo', description: 'Echo text back', inputSchema: { type: 'object', properties: { text: { type: 'string' } } } }] });
+                    break;
+                case 'tools/call': {
+                    const text = String(msg.params?.arguments?.text ?? '');
+                    reply({ content: [{ type: 'text', text }] });
+                    break;
+                }
+                default:
+                    break;
+            }
+        });
+    });
+    return wss;
+}
+function wsUrl(wss) {
+    const port = wss.address().port;
+    return `ws://127.0.0.1:${port}/mcpl`;
+}
+function waitListening(wss) {
+    return new Promise((resolve) => (wss.address() ? resolve() : wss.once('listening', () => resolve())));
+}
+test('buildWebSocketUrl validates protocol and appends the token as a query param', () => {
+    assert.equal(buildWebSocketUrl({ id: 's', url: 'wss://example.com/mcpl' }), 'wss://example.com/mcpl');
+    assert.equal(buildWebSocketUrl({ id: 's', url: 'wss://example.com/mcpl', token: 'sekret' }), 'wss://example.com/mcpl?token=sekret');
+    // Preserves an existing query.
+    assert.equal(buildWebSocketUrl({ id: 's', url: 'wss://example.com/mcpl?v=2', token: 'abc' }), 'wss://example.com/mcpl?v=2&token=abc');
+    assert.throws(() => buildWebSocketUrl({ id: 's', url: 'http://example.com' }), /ws:\/\/ or wss:\/\//);
+    assert.throws(() => buildWebSocketUrl({ id: 's', command: 'x' }), /requires "url"/);
+});
+test('isWebSocketTransport selects the transport from config shape', () => {
+    assert.equal(isWebSocketTransport({ id: 's', url: 'wss://x/y' }), true);
+    assert.equal(isWebSocketTransport({ id: 's', url: 'wss://x/y', transport: 'websocket' }), true);
+    assert.equal(isWebSocketTransport({ id: 's', command: 'node' }), false);
+    // Explicit transport wins over shape.
+    assert.equal(isWebSocketTransport({ id: 's', command: 'node', transport: 'stdio' }), false);
+    assert.equal(isWebSocketTransport({ id: 's', url: 'wss://x', command: 'node' }), false); // url+command → stdio unless transport says otherwise
+});
+test('connects over WebSocket, negotiates capabilities, lists tools, and round-trips a call', async () => {
+    const wss = startMockMcplWsServer();
+    await waitListening(wss);
+    try {
+        const conn = await McplServerConnection.connect({ id: 'editor', url: wsUrl(wss) }, HOST_CAPS);
+        conn.ready();
+        // Handshake negotiated MCPL capabilities over WS.
+        assert.ok(conn.capabilities, 'expected MCPL capabilities from the handshake');
+        assert.equal(conn.capabilities?.pushEvents, true);
+        // tools/list round-trips.
+        const list = await conn.sendToolsList();
+        assert.deepEqual(list.tools.map((t) => t.name), ['echo']);
+        // tools/call round-trips.
+        const result = await conn.sendToolsCall('echo', { text: 'hello over wss' });
+        const block = result.content[0];
+        assert.equal(block.text, 'hello over wss');
+        await conn.close();
+    }
+    finally {
+        wss.close();
+    }
+});
+test('a failed WebSocket dial rejects with a clear error (no reconnect)', async () => {
+    // Nothing is listening on this port.
+    await assert.rejects(McplServerConnection.connect({ id: 'dead', url: 'ws://127.0.0.1:1/mcpl' }, HOST_CAPS), /WebSocket connect (failed|timed out)/);
+});
+// A tiny stdio MCPL server: reads NDJSON on stdin, answers the same three
+// methods on stdout, and writes one line to stderr on boot (to prove stderr
+// still surfaces after the transport refactor). Kept inline so the test is
+// self-contained.
+const STDIO_SERVER = `
+let buf = '';
+process.stderr.write('mock stdio server up\\n');
+process.stdin.on('data', (c) => {
+  buf += c.toString('utf8');
+  let i;
+  while ((i = buf.indexOf('\\n')) >= 0) {
+    const line = buf.slice(0, i); buf = buf.slice(i + 1);
+    if (!line.trim()) continue;
+    let m; try { m = JSON.parse(line); } catch { continue; }
+    const reply = (result) => process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id: m.id, result }) + '\\n');
+    if (m.method === 'initialize') reply({ capabilities: { experimental: { mcpl: { version: '0.4', pushEvents: true } } } });
+    else if (m.method === 'tools/list') reply({ tools: [{ name: 'echo', description: 'e', inputSchema: { type: 'object' } }] });
+    else if (m.method === 'tools/call') reply({ content: [{ type: 'text', text: String((m.params && m.params.arguments && m.params.arguments.text) || '') }] });
+  }
+});
+`;
+test('stdio transport still handshakes, lists tools, round-trips a call, and surfaces stderr', async () => {
+    const conn = await McplServerConnection.connect({ id: 'stdiosrv', command: process.execPath, args: ['-e', STDIO_SERVER] }, HOST_CAPS);
+    const stderrLines = [];
+    conn.on('stderr', (p) => stderrLines.push(p.line));
+    conn.ready();
+    assert.ok(conn.capabilities, 'stdio handshake should negotiate capabilities');
+    const list = await conn.sendToolsList();
+    assert.deepEqual(list.tools.map((t) => t.name), ['echo']);
+    const result = await conn.sendToolsCall('echo', { text: 'over stdio' });
+    const block = result.content[0];
+    assert.equal(block.text, 'over stdio');
+    // stderr forwarding preserved (buffered pre-listener, flushed on subscribe).
+    await new Promise((r) => setTimeout(r, 20));
+    assert.ok(stderrLines.some((l) => l.includes('mock stdio server up')), 'stderr line should surface');
+    await conn.close();
+});
+test('reconnect: an unexpected socket drop triggers a background reconnect', async () => {
+    let sockets = [];
+    const wss = startMockMcplWsServer((ws) => sockets.push(ws));
+    await waitListening(wss);
+    try {
+        const conn = await McplServerConnection.connect({ id: 'editor', url: wsUrl(wss), reconnect: true, reconnectIntervalMs: 100 }, HOST_CAPS);
+        conn.ready();
+        const reconnected = new Promise((resolve) => conn.once('reconnect', () => resolve()));
+        // Force-drop the server side of the current socket.
+        assert.equal(sockets.length, 1);
+        sockets[0].terminate();
+        await reconnected; // background reconnect must fire
+        // The new socket works: a call round-trips post-reconnect.
+        const result = await conn.sendToolsCall('echo', { text: 'after reconnect' });
+        const block = result.content[0];
+        assert.equal(block.text, 'after reconnect');
+        await conn.close();
+    }
+    finally {
+        wss.close();
+    }
+});
+//# sourceMappingURL=mcpl-ws-transport.test.js.map

package/dist/test/mcpl-ws-transport.test.js.map

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

package/dist/test/prose-segments.test.d.ts

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

package/dist/test/prose-segments.test.d.ts.map

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

package/dist/test/prose-segments.test.js

@@ -0,0 +1,52 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { splitProseSegments } from '../src/prose-segments.js';
+const textBlock = (text) => ({ type: 'text', text });
+const toolUse = (id) => ({ type: 'tool_use', id, name: 'workspace--write', input: {} });
+const toolResult = (id) => ({ type: 'tool_result', toolUseId: id, content: 'done', isError: false });
+const thinking = () => ({ type: 'thinking', thinking: '', signature: 'x' });
+test('item 4: prose before a tool_use is not dropped or merged — it becomes its own ordered segment', () => {
+    // Shape of the real captured turn (docs/reports/item4-failing-transcript.jsonl),
+    // as the membrane accumulates it into response.content across tool rounds:
+    //   [text FIRST, tool_use, tool_result, thinking, tool_use, tool_result, text SECOND]
+    const content = [
+        textBlock('FIRST_MESSAGE_BEFORE_TOOL.'),
+        toolUse('t1'),
+        toolResult('t1'),
+        thinking(),
+        toolUse('t2'),
+        toolResult('t2'),
+        textBlock('SECOND_MESSAGE_AFTER_TOOL.'),
+    ];
+    const segments = splitProseSegments(content);
+    // Old behaviour joined all text into ONE trailing post
+    // ("FIRST_MESSAGE_BEFORE_TOOL.\nSECOND_MESSAGE_AFTER_TOOL."); the fix keeps
+    // them as two separate messages IN ORDER.
+    assert.deepEqual(segments, ['FIRST_MESSAGE_BEFORE_TOOL.', 'SECOND_MESSAGE_AFTER_TOOL.']);
+});
+test('three interleaved messages (msgA → [tool] → msgB → [tool] → msgC) all survive in order', () => {
+    const content = [
+        textBlock('A'),
+        toolUse('t1'), toolResult('t1'),
+        textBlock('B'),
+        toolUse('t2'), toolResult('t2'),
+        textBlock('C'),
+    ];
+    assert.deepEqual(splitProseSegments(content), ['A', 'B', 'C']);
+});
+test('contiguous text blocks merge into one segment; whitespace-only runs are dropped', () => {
+    const content = [
+        textBlock('line one'),
+        textBlock('line two'),
+        toolUse('t1'), toolResult('t1'),
+        textBlock('   '),
+    ];
+    assert.deepEqual(splitProseSegments(content), ['line one\nline two']);
+});
+test('a plain no-tool turn yields a single segment (unchanged behaviour)', () => {
+    assert.deepEqual(splitProseSegments([textBlock('just a reply')]), ['just a reply']);
+});
+test('a tool-only turn (no prose) yields no segments', () => {
+    assert.deepEqual(splitProseSegments([toolUse('t1'), toolResult('t1')]), []);
+});
+//# sourceMappingURL=prose-segments.test.js.map

package/dist/test/prose-segments.test.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for the tool-result history serializer.
+ *
+ * Run: node --import tsx --test test/tool-result-history.test.ts
+ */
+export {};
+//# sourceMappingURL=tool-result-history.test.d.ts.map

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * Unit tests for the tool-result history serializer.
+ *
+ * Run: node --import tsx --test test/tool-result-history.test.ts
+ */
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { toolResultDataToHistoryString } from '../src/tool-result-history.js';
+test('text-only MCP content array: blocks join with newlines', () => {
+    const data = [
+        { type: 'text', text: 'first' },
+        { type: 'text', text: 'second' },
+    ];
+    assert.equal(toolResultDataToHistoryString(data), 'first\nsecond');
+});
+test('image block becomes placeholder, not base64', () => {
+    // 1MB of base64 = ~750KB of decoded bytes
+    const fakeBase64 = 'A'.repeat(1024 * 1024);
+    const data = [
+        { type: 'text', text: 'Fetched x.png:' },
+        { type: 'image', data: fakeBase64, mimeType: 'image/png' },
+    ];
+    const out = toolResultDataToHistoryString(data);
+    assert.ok(out.includes('Fetched x.png:'));
+    assert.ok(out.includes('[image: image/png,'));
+    assert.ok(!out.includes(fakeBase64), 'base64 payload must NOT appear in history string');
+    assert.ok(out.length < 200, `expected small string, got ${out.length} chars`);
+});
+test('size formatter: bytes / KB / MB', () => {
+    const tiny = toolResultDataToHistoryString([{ type: 'image', data: 'A'.repeat(16), mimeType: 'image/png' }]);
+    assert.match(tiny, /\[image: image\/png, \d+B\]/);
+    const kb = toolResultDataToHistoryString([{ type: 'image', data: 'A'.repeat(10 * 1024), mimeType: 'image/png' }]);
+    assert.match(kb, /\[image: image\/png, ~\d+KB\]/);
+    const mb = toolResultDataToHistoryString([{ type: 'image', data: 'A'.repeat(2 * 1024 * 1024), mimeType: 'image/png' }]);
+    assert.match(mb, /\[image: image\/png, ~\d+\.\d+MB\]/);
+});
+test('unknown block shape falls back to JSON', () => {
+    const data = [{ type: 'mystery', payload: 42 }];
+    assert.equal(toolResultDataToHistoryString(data), JSON.stringify(data));
+});
+test('mixed known + unknown block shape falls back to JSON (all-or-nothing)', () => {
+    const data = [
+        { type: 'text', text: 'fine' },
+        { type: 'audio', data: 'XX', mimeType: 'audio/mpeg' },
+    ];
+    assert.equal(toolResultDataToHistoryString(data), JSON.stringify(data));
+});
+test('non-array data: JSON stringify', () => {
+    assert.equal(toolResultDataToHistoryString({ ok: true }), '{"ok":true}');
+    assert.equal(toolResultDataToHistoryString('hello'), '"hello"');
+    assert.equal(toolResultDataToHistoryString(42), '42');
+    assert.equal(toolResultDataToHistoryString(undefined), undefined); // JSON.stringify(undefined) === undefined
+});
+test('maxChars truncates the resulting string with a marker', () => {
+    const data = [{ type: 'text', text: 'a'.repeat(1000) }];
+    const out = toolResultDataToHistoryString(data, 100);
+    assert.ok(out.length < 1000);
+    assert.match(out, /\[truncated — original was \d+ chars\]/);
+});
+test('maxChars does NOT truncate the placeholder itself (image is summarized, not chopped)', () => {
+    // 4MB of base64 → ~3MB decoded, comfortably across the MB threshold.
+    const fakeBase64 = 'A'.repeat(4 * 1024 * 1024);
+    const data = [{ type: 'image', data: fakeBase64, mimeType: 'image/png' }];
+    const out = toolResultDataToHistoryString(data, 50_000);
+    // The placeholder is ~30 chars regardless of input size; maxChars=50_000 leaves it untouched.
+    assert.match(out, /\[image: image\/png, ~\d+\.\d+MB\]/);
+    assert.ok(!out.includes('truncated'));
+    assert.ok(out.length < 100);
+});
+test('null entry in array falls back to JSON', () => {
+    const data = [{ type: 'text', text: 'x' }, null];
+    assert.equal(toolResultDataToHistoryString(data), JSON.stringify(data));
+});
+test('empty array: empty string', () => {
+    assert.equal(toolResultDataToHistoryString([]), '');
+});
+//# sourceMappingURL=tool-result-history.test.js.map

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

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

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