@animalabs/agent-framework 0.6.0 → 0.6.3

package/dist/test/mcpl-runtime-lifecycle.test.js

@@ -0,0 +1,142 @@
+/**
+ * Runtime MCPL server lifecycle — connectMcplServer / disconnectMcplServer /
+ * restartMcplServer on a live framework, including lazy MCPL subsystem
+ * initialization when the framework started with zero configured servers.
+ */
+import { test } from 'node:test';
+import assert from 'node:assert';
+import { tmpdir } from 'node:os';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { WebSocketServer } from 'ws';
+import { AgentFramework } from '../src/index.js';
+import { MockMembrane } from './helpers/mock-membrane.js';
+// A tiny stdio MCPL server (same shape as mcpl-ws-transport.test.ts): reads
+// NDJSON on stdin, answers initialize / tools/list / tools/call on stdout.
+const STDIO_SERVER = `
+let buf = '';
+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) || '') }] });
+  }
+});
+`;
+function serverConfig(id, extra) {
+    return { id, command: process.execPath, args: ['-e', STDIO_SERVER], ...extra };
+}
+async function withFramework(withServer, fn) {
+    const tempDir = mkdtempSync(join(tmpdir(), 'mcpl-lifecycle-'));
+    const membrane = new MockMembrane();
+    const framework = await AgentFramework.create({
+        storePath: join(tempDir, 'test.chronicle'),
+        membrane: membrane.asMembrane(),
+        agents: [{ name: 'assistant', model: 'test-model', systemPrompt: 'test' }],
+        modules: [],
+        ...(withServer ? { mcplServers: [serverConfig('first')] } : {}),
+    });
+    try {
+        await fn(framework);
+    }
+    finally {
+        await framework.stop();
+        rmSync(tempDir, { recursive: true, force: true });
+    }
+}
+test('connectMcplServer lazily initializes MCPL on a zero-server framework and exposes tools', async () => {
+    await withFramework(false, async (framework) => {
+        assert.deepEqual(framework.listMcplServers(), [], 'no servers configured at start');
+        await framework.connectMcplServer(serverConfig('dyn'));
+        const servers = framework.listMcplServers();
+        assert.equal(servers.length, 1);
+        assert.equal(servers[0].id, 'dyn');
+        assert.equal(servers[0].connected, true);
+        assert.equal(servers[0].toolCount, 1);
+        const toolNames = framework.getAllTools().map(t => t.name);
+        assert.ok(toolNames.includes('mcpl--dyn--echo'), `expected mcpl--dyn--echo in ${toolNames}`);
+    });
+});
+test('disconnectMcplServer removes the server and its tools', async () => {
+    await withFramework(true, async (framework) => {
+        assert.ok(framework.getAllTools().some(t => t.name === 'mcpl--first--echo'), 'startup server tools present');
+        await framework.disconnectMcplServer('first');
+        assert.deepEqual(framework.listMcplServers(), [], 'server gone from list');
+        assert.ok(!framework.getAllTools().some(t => t.name.startsWith('mcpl--first--')), 'tools removed after disconnect');
+    });
+});
+test('restartMcplServer respawns the server and keeps tools available', async () => {
+    await withFramework(true, async (framework) => {
+        await framework.restartMcplServer('first');
+        const servers = framework.listMcplServers();
+        assert.equal(servers.length, 1);
+        assert.equal(servers[0].connected, true);
+        assert.equal(servers[0].toolCount, 1);
+        assert.ok(framework.getAllTools().some(t => t.name === 'mcpl--first--echo'));
+    });
+});
+test('restartMcplServer accepts an updated config (new toolPrefix)', async () => {
+    await withFramework(true, async (framework) => {
+        await framework.restartMcplServer('first', serverConfig('first', { toolPrefix: 'renamed' }));
+        const toolNames = framework.getAllTools().map(t => t.name);
+        assert.ok(toolNames.includes('renamed--echo'), `expected renamed--echo in ${toolNames}`);
+        assert.ok(!toolNames.some(n => n.startsWith('mcpl--first--')), 'old prefix gone');
+    });
+});
+test('connectMcplServer rejects a duplicate id and a colliding prefix', async () => {
+    await withFramework(true, async (framework) => {
+        await assert.rejects(framework.connectMcplServer(serverConfig('first')), /already registered/);
+        await assert.rejects(framework.connectMcplServer(serverConfig('second', { toolPrefix: 'mcpl--first' })), /collides with server "first"/);
+    });
+});
+test('connectMcplServer hot-connects a network-only (WebSocket) MCPL server', async () => {
+    // Minimal in-process MCPL server over WebSocket (same shape as
+    // mcpl-ws-transport.test.ts) — no child process involved.
+    const wss = new WebSocketServer({ port: 0, host: '127.0.0.1' });
+    wss.on('connection', (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 }));
+            if (msg.method === 'initialize')
+                reply({ capabilities: { experimental: { mcpl: { version: '0.4', pushEvents: true } } } });
+            else if (msg.method === 'tools/list')
+                reply({ tools: [{ name: 'echo', description: 'e', inputSchema: { type: 'object' } }] });
+        });
+    });
+    await new Promise((resolve) => (wss.address() ? resolve() : wss.once('listening', () => resolve())));
+    const url = `ws://127.0.0.1:${wss.address().port}/mcpl`;
+    try {
+        await withFramework(false, async (framework) => {
+            await framework.connectMcplServer({ id: 'netsrv', url });
+            const servers = framework.listMcplServers();
+            assert.equal(servers.length, 1);
+            assert.equal(servers[0].connected, true);
+            assert.equal(servers[0].url, url);
+            assert.ok(framework.getAllTools().some(t => t.name === 'mcpl--netsrv--echo'));
+            await framework.disconnectMcplServer('netsrv');
+            assert.ok(!framework.getAllTools().some(t => t.name.startsWith('mcpl--netsrv--')));
+        });
+    }
+    finally {
+        wss.close();
+    }
+});
+test('disconnecting an unknown server is a no-op (routing state cleared, no throw)', async () => {
+    await withFramework(true, async (framework) => {
+        await framework.disconnectMcplServer('nope');
+        assert.equal(framework.listMcplServers().length, 1, 'existing server untouched');
+    });
+});
+//# sourceMappingURL=mcpl-runtime-lifecycle.test.js.map

package/dist/test/mcpl-runtime-lifecycle.test.js.map

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

package/dist/test/ops-alert.test.d.ts

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

package/dist/test/ops-alert.test.d.ts.map

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

package/dist/test/ops-alert.test.js

@@ -0,0 +1,152 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { AgentFramework } from '../src/framework.js';
+/**
+ * opsAlert() is the single escalation path for "a human should hear about
+ * this": failures.log record + ops:alert trace + cooldown-throttled Discord
+ * webhook. It and noteRefusal() are private and the full framework is heavy
+ * to construct, so — like inference-failure-observability.test.ts — we
+ * exercise them on a prototype instance with just the touched fields stubbed.
+ */
+function makeHarness() {
+    const fw = Object.create(AgentFramework.prototype);
+    fw.opsAlertLastSent = new Map();
+    fw.opsAlertCooldownMs = 15 * 60_000;
+    fw.refusalStats = new Map();
+    fw.refusalStreak = new Map();
+    fw.consecutiveInferenceFailures = new Map();
+    fw.inferenceFailureEscalationThreshold = 3;
+    fw.exhaustionRewinds = new Map();
+    fw.lastInferenceAt = new Map();
+    fw.pendingRequests = [];
+    fw.activeStreams = new Map(); // healthSnapshot reads its keys
+    fw.agents = new Map([['cairn', {
+                state: { status: 'idle' },
+                getContextManager: () => ({ addMessage: () => { } }),
+            }]]);
+    // Capture instead of touching the filesystem — logFailure's file mechanics
+    // are trivial and shared with the legacy exhaustion path.
+    const logged = [];
+    fw.logFailure = (r) => logged.push(r);
+    // Capture traces.
+    const traces = [];
+    fw.traceListeners = [(e) => traces.push(e)];
+    // Capture webhook posts.
+    const posts = [];
+    const origFetch = globalThis.fetch;
+    globalThis.fetch = ((url, init) => {
+        posts.push({ url: String(url), body: JSON.parse(init?.body ?? 'null') });
+        return Promise.resolve(new Response('ok'));
+    });
+    // Silence + capture stderr.
+    const errs = [];
+    const origErr = console.error;
+    console.error = (...a) => { errs.push(a.join(' ')); };
+    const restore = () => {
+        globalThis.fetch = origFetch;
+        console.error = origErr;
+        delete process.env.CONNECTOME_OPS_WEBHOOK;
+    };
+    return { fw, logged, traces, posts, errs, restore };
+}
+test('opsAlert: one webhook post per (agent,kind) per cooldown; trace + log always', () => {
+    const { fw, logged, traces, posts, restore } = makeHarness();
+    process.env.CONNECTOME_OPS_WEBHOOK = 'https://discord.example/hook';
+    try {
+        fw.opsAlert('hard-down', 'cairn', 'reason A');
+        fw.opsAlert('hard-down', 'cairn', 'reason B'); // same key → suppressed
+        assert.equal(posts.length, 1, 'second post within cooldown is suppressed');
+        assert.match(posts[0].body.content, /\*\*cairn\*\* hard-down: reason A/);
+        fw.opsAlert('refusal', 'cairn', 'different kind'); // different key → posts
+        assert.equal(posts.length, 2);
+        fw.opsAlert('hard-down', 'lena', 'different agent'); // different key → posts
+        assert.equal(posts.length, 3);
+        // Cooldown expiry re-arms the key.
+        fw.opsAlertLastSent.set('cairn:hard-down', Date.now() - 16 * 60_000);
+        fw.opsAlert('hard-down', 'cairn', 'reason C');
+        assert.equal(posts.length, 4, 'posts again after the cooldown window');
+        // The durable + wire records are NOT throttled: every call logs + traces
+        // (5 calls — including the webhook-suppressed one).
+        assert.equal(traces.filter(t => t.type === 'ops:alert').length, 5);
+        assert.equal(logged.length, 5, 'failures.log record on every call (no skipLog)');
+        assert.equal(logged[0].kind, 'hard-down');
+    }
+    finally {
+        restore();
+    }
+});
+test('opsAlert: no webhook env → no fetch, still logs and traces', () => {
+    const { fw, logged, traces, posts, restore } = makeHarness();
+    try {
+        fw.opsAlert('mcpl-down', 'discord', 'unreachable');
+        assert.equal(posts.length, 0);
+        assert.equal(logged.length, 1);
+        assert.equal(traces.filter(t => t.type === 'ops:alert').length, 1);
+    }
+    finally {
+        restore();
+    }
+});
+test('hard-down routes through opsAlert: one post at threshold, retries suppressed', () => {
+    const { fw, posts, restore } = makeHarness();
+    process.env.CONNECTOME_OPS_WEBHOOK = 'https://discord.example/hook';
+    try {
+        for (let i = 0; i < 5; i++)
+            fw.noteInferenceExhausted('cairn', 'boom');
+        assert.equal(posts.length, 1, 'streaks 3,4,5 within cooldown → exactly one post');
+        assert.match(posts[0].body.content, /hard-down: 3 consecutive inference failures/);
+    }
+    finally {
+        restore();
+    }
+});
+test('noteRefusal: stats + streak + per-refusal log; alert only from streak 2', () => {
+    const { fw, logged, posts, restore } = makeHarness();
+    process.env.CONNECTOME_OPS_WEBHOOK = 'https://discord.example/hook';
+    try {
+        const s1 = fw.noteRefusal('cairn', 'cyber', { input: 200_000, output: 12 });
+        assert.equal(s1, 1);
+        assert.equal(posts.length, 0, 'a single refusal does not page anyone');
+        const s2 = fw.noteRefusal('cairn', 'bio');
+        assert.equal(s2, 2);
+        assert.equal(posts.length, 1, 'second consecutive refusal alerts');
+        assert.match(posts[0].body.content, /refusal streak 2, category=bio/);
+        // Every refusal gets a durable record (kind, category, streak, tokens).
+        assert.equal(logged.length, 2);
+        assert.equal(logged[0].kind, 'refusal');
+        assert.equal(logged[0].category, 'cyber');
+        assert.equal(logged[0].streak, 1);
+        assert.deepEqual(logged[0].tokens, { input: 200_000, output: 12 });
+        assert.equal(logged[1].streak, 2);
+        // Stats accumulate per category and are exposed via healthSnapshot.
+        const snap = fw.healthSnapshot();
+        const cairn = snap.agents.find((a) => a.name === 'cairn');
+        assert.equal(cairn.refusalStats.total, 2);
+        assert.deepEqual(cairn.refusalStats.byCategory, { cyber: 1, bio: 1 });
+        assert.equal(cairn.refusalStats.lastCategory, 'bio');
+        // Agents that never refused expose null (mixed-fleet compat: consumers
+        // treat missing/null as "n/a").
+        fw.agents.set('lena', { state: { status: 'idle' } });
+        const lena = fw.healthSnapshot().agents.find((a) => a.name === 'lena');
+        assert.equal(lena.refusalStats, null);
+    }
+    finally {
+        restore();
+    }
+});
+test('refusal streak resets independently of stats (driver clears it on any clean turn)', () => {
+    const { fw, posts, restore } = makeHarness();
+    process.env.CONNECTOME_OPS_WEBHOOK = 'https://discord.example/hook';
+    try {
+        fw.noteRefusal('cairn', 'cyber');
+        // The stream driver's non-refusal branch does exactly this:
+        fw.refusalStreak.delete('cairn');
+        fw.noteRefusal('cairn', 'cyber');
+        assert.equal(posts.length, 0, 'streak restarted at 1 — no alert');
+        assert.equal(fw.refusalStats.get('cairn').total, 2, 'lifetime stats keep counting');
+    }
+    finally {
+        restore();
+    }
+});
+//# sourceMappingURL=ops-alert.test.js.map

package/dist/test/ops-alert.test.js.map

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

package/dist/test/refusal-rewind.test.d.ts

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

package/dist/test/refusal-rewind.test.d.ts.map

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

package/dist/test/refusal-rewind.test.js

@@ -0,0 +1,108 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { AgentFramework } from '../src/framework.js';
+/**
+ * The refusal auto-rewind sheds the newest turn (in sequence, newest first,
+ * INCLUDING the agent's own turns) as a COMPLETE exchange — a tool_result is
+ * removed together with its paired tool_use turn, so no orphaned tool_use /
+ * signed thinking block is left behind. It maintains exactly ONE consolidated
+ * marker per episode. These exercise the private primitives on a prototype
+ * instance with a minimal in-memory ContextManager stub.
+ */
+function makeAgentHarness(messages) {
+    const removed = [];
+    const added = [];
+    const edited = [];
+    const cm = {
+        getAllMessages: () => messages,
+        removeMessage: (id) => {
+            removed.push(id);
+            const i = messages.findIndex((m) => m.id === id);
+            if (i >= 0)
+                messages.splice(i, 1);
+        },
+        addMessage: (participant, content, meta) => {
+            const id = `marker-${added.length}`;
+            added.push({ participant, content, meta });
+            messages.push({ id, participant, content, metadata: meta });
+            return id;
+        },
+        editMessage: (id, content) => {
+            edited.push({ id, content });
+            const m = messages.find((x) => x.id === id);
+            if (m)
+                m.content = content;
+        },
+    };
+    const fw = Object.create(AgentFramework.prototype);
+    fw.rewindEpisode = new Map();
+    const agent = { name: 'labclaude', getContextManager: () => cm };
+    return { fw, agent, removed, added, edited, messages };
+}
+test('shed: tool_result removes its paired tool_use turn too (complete exchange)', () => {
+    const msgs = [
+        { id: 'u1', participant: 'simulect', content: [{ type: 'text', text: 'do it' }], metadata: { messageId: '1' } },
+        { id: 'a1', participant: 'labclaude', content: [{ type: 'thinking', thinking: '…' }, { type: 'tool_use', name: 'shell', id: 't1' }] },
+        { id: 'r1', participant: 'user', content: [{ type: 'tool_result', toolUseId: 't1', content: 'X'.repeat(320 * 1024) }] },
+    ];
+    const { fw, agent, removed, added } = makeAgentHarness(msgs);
+    const rec = fw.shedNewestTurn(agent);
+    assert.equal(rec.kind, 'tool');
+    assert.deepEqual([...removed].sort(), ['a1', 'r1'], 'removes the tool_result AND its tool_use turn — no orphan');
+    assert.deepEqual([...rec.removedIds].sort(), ['a1', 'r1']);
+    assert.equal(added.length, 0, 'shedNewestTurn must not add a marker');
+});
+test('shed: human message → kind=human + discordRef, single removal', () => {
+    const msgs = [
+        { id: 'a0', participant: 'labclaude', content: [{ type: 'text', text: 'hi' }] },
+        { id: 'm2', participant: 'simulect', content: [{ type: 'text', text: 'sketchy' }], metadata: { messageId: '999', channelId: 'discord:g:c' } },
+    ];
+    const { fw, agent, removed } = makeAgentHarness(msgs);
+    const rec = fw.shedNewestTurn(agent);
+    assert.equal(rec.kind, 'human');
+    assert.deepEqual(removed, ['m2']);
+    assert.deepEqual(rec.discordRef, { channelId: 'discord:g:c', messageId: '999' });
+});
+test('shed: agent turns ARE shed too (newest-first includes the agent own turns)', () => {
+    const msgs = [
+        { id: 'u1', participant: 'simulect', content: [{ type: 'text', text: 'q' }], metadata: { messageId: '1' } },
+        { id: 'a1', participant: 'labclaude', content: [{ type: 'text', text: 'my narration' }] },
+    ];
+    const { fw, agent, removed } = makeAgentHarness(msgs);
+    const rec = fw.shedNewestTurn(agent);
+    assert.ok(rec, 'sheds the agent turn (no longer skipped)');
+    assert.deepEqual(removed, ['a1']);
+});
+test('shed: skips the episode marker and sheds the real turn beneath it', () => {
+    const msgs = [
+        { id: 'm1', participant: 'simulect', content: [{ type: 'text', text: 'real msg' }], metadata: { messageId: '1' } },
+        { id: 'mk', participant: 'user', content: [{ type: 'text', text: '[refusal-rewind] ...' }], metadata: { system: true, kind: 'refusal-rewind' } },
+    ];
+    const { fw, agent, removed } = makeAgentHarness(msgs);
+    const rec = fw.shedNewestTurn(agent);
+    assert.ok(rec);
+    assert.deepEqual(removed, ['m1']);
+});
+test('shed: null when only the episode marker remains', () => {
+    const msgs = [{ id: 'mk', participant: 'user', content: [{ type: 'text', text: 'x' }], metadata: { system: true } }];
+    const { fw, agent } = makeAgentHarness(msgs);
+    assert.equal(fw.shedNewestTurn(agent), null);
+});
+test('marker: six rewinds produce ONE marker, updated in place (not six)', () => {
+    const msgs = [{ id: 'm1', participant: 'labclaude', content: [{ type: 'text', text: 'a' }] }];
+    const { fw, agent, added, edited } = makeAgentHarness(msgs);
+    const c1 = fw.updateRewindMarker(agent, 'cyber');
+    const c2 = fw.updateRewindMarker(agent, 'cyber');
+    fw.updateRewindMarker(agent, 'cyber');
+    fw.updateRewindMarker(agent, 'cyber');
+    fw.updateRewindMarker(agent, 'cyber');
+    const c6 = fw.updateRewindMarker(agent, 'cyber');
+    assert.equal(c1, 1);
+    assert.equal(c2, 2);
+    assert.equal(c6, 6);
+    assert.equal(added.length, 1, 'exactly ONE marker message added for the whole episode');
+    assert.equal(edited.length, 5, 'subsequent rewinds edit that one marker in place');
+    assert.match(edited[edited.length - 1].content[0].text, /6 most recent turn/, 'marker reflects the running total');
+    assert.equal(added[0].meta.kind, 'refusal-rewind');
+});
+//# sourceMappingURL=refusal-rewind.test.js.map

package/dist/test/refusal-rewind.test.js.map

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

package/dist/test/state-scaling-e2e.test.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Whole-store scaling sweep (scaling campaign Finding 2, end-to-end gate).
+ *
+ * The unit gates in state-scaling.test.ts pin the four known writers by
+ * calling them directly. This test validates the REGIME instead: it drives a
+ * synthetic workload through the framework's public surface — external
+ * messages with tool rounds, ephemeral spawn-and-dispose cycles, process
+ * logging on — then sweeps EVERY state family the store accumulated and
+ * asserts none of them grows superlinearly. A quadratic writer added anywhere
+ * (the way logProcessEvent silently duplicated logInference's bug) fails this
+ * test the day it's introduced, without anyone having to know to test it.
+ *
+ * Family classification:
+ *   - capped families (per-agent turn-checkpoint slots) legitimately ramp to
+ *     a fixed cap and plateau — small-N slope fits are noisy on that shape
+ *     (a ramp-heavy window fits as "rising"), so they get a hard max-record-
+ *     size bound instead, which is the stronger invariant anyway.
+ *   - everything else with enough records gets a log-log slope fit of
+ *     bytes-per-record vs index; flat ≈ healthy, ≈1 ≈ quadratic aggregate.
+ */
+export {};
+//# sourceMappingURL=state-scaling-e2e.test.d.ts.map

package/dist/test/state-scaling-e2e.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-scaling-e2e.test.d.ts","sourceRoot":"","sources":["../../test/state-scaling-e2e.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}