@animalabs/agent-framework 0.22.2 → 0.23.0

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

@@ -1,259 +0,0 @@
-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`;
-}
-/** Bound an event wait so a missing emission fails the test instead of hanging it. */
-function withDeadline(p, ms, what) {
-    let timer;
-    const deadline = new Promise((_, reject) => {
-        timer = setTimeout(() => reject(new Error(`timed out after ${ms}ms waiting for ${what}`)), ms);
-    });
-    return Promise.race([p, deadline]).finally(() => clearTimeout(timer));
-}
-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();
-    }
-});
-test("a server-side close with code 4001 surfaces on the connection 'close' event before the reconnect", async () => {
-    const sockets = [];
-    const wss = startMockMcplWsServer((ws) => sockets.push(ws));
-    await waitListening(wss);
-    let conn;
-    try {
-        // The provider hands out whatever the host currently holds. A host that
-        // caches its credential swaps it in the 4001 listener; the dial that the
-        // reconnect makes must then see the replacement — that ordering is the
-        // point of surfacing the close before scheduling the reconnect.
-        let token = 'token-1';
-        const dialed = [];
-        conn = await McplServerConnection.connect({
-            id: 'editor',
-            url: wsUrl(wss),
-            reconnect: true,
-            reconnectIntervalMs: 100,
-            accessProvider: async () => { dialed.push(token); return token; },
-        }, HOST_CAPS);
-        const closes = [];
-        conn.on('close', (code, signal, info) => {
-            closes.push({ code: code ?? null, signal: signal ?? null, info });
-            if (info?.code === 4001)
-                token = 'token-2';
-        });
-        const reconnected = new Promise((resolve) => conn.once('reconnect', () => resolve()));
-        conn.ready();
-        assert.deepEqual(dialed, ['token-1']);
-        // The server refuses/expires the credential: an application close code.
-        assert.equal(sockets.length, 1);
-        sockets[0].close(4001, 'token expired');
-        await withDeadline(reconnected, 5_000, "'reconnect' after a 4001 close");
-        // Positional (code, signal) unchanged for existing listeners; the third
-        // argument carries the full close info.
-        assert.equal(closes.length, 1);
-        assert.equal(closes[0].code, 4001);
-        assert.equal(closes[0].signal, null);
-        assert.deepEqual(closes[0].info, {
-            transport: 'websocket',
-            code: 4001,
-            signal: null,
-            reason: 'token expired',
-            reasonFromPeer: true,
-            byHost: false,
-        });
-        // The reconnect dialed with the credential the close listener installed.
-        assert.deepEqual(dialed, ['token-1', 'token-2']);
-        assert.equal(sockets.length, 2);
-        const result = await conn.sendToolsCall('echo', { text: 'after 4001' });
-        const block = result.content[0];
-        assert.equal(block.text, 'after 4001');
-        // A host-initiated close reports byHost with no transport code.
-        const hostClose = new Promise((resolve) => conn.once('close', (_code, _signal, info) => resolve(info)));
-        await conn.close();
-        const info = await withDeadline(hostClose, 5_000, "'close' after conn.close()");
-        assert.equal(info?.byHost, true);
-        assert.equal(info?.code, null);
-        assert.equal(info?.transport, 'websocket');
-    }
-    finally {
-        await conn?.close().catch(() => { });
-        wss.close();
-    }
-});
-test("reconnectAfterFailure() on a live transport reports byHost: true and still reconnects", async () => {
-    const sockets = [];
-    const wss = startMockMcplWsServer((ws) => sockets.push(ws));
-    await waitListening(wss);
-    let conn;
-    try {
-        conn = await McplServerConnection.connect({ id: 'editor', url: wsUrl(wss), reconnect: true, reconnectIntervalMs: 100 }, HOST_CAPS);
-        conn.ready();
-        const closed = new Promise((resolve) => conn.once('close', (_code, _signal, info) => resolve(info)));
-        const reconnected = new Promise((resolve) => conn.once('reconnect', () => resolve()));
-        await conn.reconnectAfterFailure();
-        const info = await withDeadline(closed, 5_000, "'close' after reconnectAfterFailure()");
-        assert.equal(info?.byHost, true);
-        assert.equal(info?.transport, 'websocket');
-        await withDeadline(reconnected, 5_000, "'reconnect' after reconnectAfterFailure()");
-        assert.equal(sockets.length, 2);
-        const result = await conn.sendToolsCall('echo', { text: 'after recovery' });
-        assert.equal(result.content[0].text, 'after recovery');
-        // The flag does not leak: a later remote drop is still reported as remote.
-        const remote = new Promise((resolve) => conn.once('close', (_code, _signal, info) => resolve(info)));
-        const reconnectedAgain = new Promise((resolve) => conn.once('reconnect', () => resolve()));
-        sockets[1].close(4001, 'token expired');
-        const remoteInfo = await withDeadline(remote, 5_000, "'close' after a remote 4001");
-        assert.equal(remoteInfo?.byHost, false);
-        assert.equal(remoteInfo?.code, 4001);
-        await withDeadline(reconnectedAgain, 5_000, "'reconnect' after a remote 4001");
-    }
-    finally {
-        await conn?.close().catch(() => { });
-        wss.close();
-    }
-});
-//# sourceMappingURL=mcpl-ws-transport.test.js.map

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

@@ -1 +0,0 @@
-{"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/module-context-integration.test.d.ts

@@ -1,18 +0,0 @@
-/**
- * Integration tests for the module-facing framework seams added for issue #5,
- * run through the REAL ModuleContextImpl (not hand-written mocks — a detached
- * or mis-bound method must fail here the way it would in production):
- *
- *  - ModuleContext.notifyOps reaches the framework ops channel (ops:alert
- *    trace) when invoked as a method on the context object;
- *  - ctx.callTool routes synthesized channel_* tools to the ChannelRegistry
- *    with trusted module origin (the route was missing entirely — module
- *    closes failed as "Invalid tool name format" since subscription-GC moved
- *    onto the generic channel_close);
- *  - the PUBLIC executeToolCall (the promise-based entry shared with
- *    ephemeral/model callers) stamps agent origin no matter what machine
- *    fields the input claims — module provenance is conferred by which
- *    internal path was used, never by which public method.
- */
-export {};
-//# sourceMappingURL=module-context-integration.test.d.ts.map

package/dist/test/module-context-integration.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"module-context-integration.test.d.ts","sourceRoot":"","sources":["../../test/module-context-integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/test/module-context-integration.test.js

@@ -1,181 +0,0 @@
-/**
- * Integration tests for the module-facing framework seams added for issue #5,
- * run through the REAL ModuleContextImpl (not hand-written mocks — a detached
- * or mis-bound method must fail here the way it would in production):
- *
- *  - ModuleContext.notifyOps reaches the framework ops channel (ops:alert
- *    trace) when invoked as a method on the context object;
- *  - ctx.callTool routes synthesized channel_* tools to the ChannelRegistry
- *    with trusted module origin (the route was missing entirely — module
- *    closes failed as "Invalid tool name format" since subscription-GC moved
- *    onto the generic channel_close);
- *  - the PUBLIC executeToolCall (the promise-based entry shared with
- *    ephemeral/model callers) stamps agent origin no matter what machine
- *    fields the input claims — module provenance is conferred by which
- *    internal path was used, never by which public method.
- */
-import { test } 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';
-class CtxCaptureModule {
-    name = 'ctx-capture';
-    ctx = null;
-    async start(ctx) {
-        this.ctx = ctx;
-    }
-    async stop() {
-        this.ctx = null;
-    }
-    getTools() {
-        return [];
-    }
-    async handleToolCall() {
-        return { success: false, error: 'no tools', isError: true };
-    }
-    async onProcess() {
-        return {};
-    }
-}
-function minimalMembrane() {
-    return {
-        complete: async (_req) => {
-            throw new Error('not used');
-        },
-    };
-}
-async function makeFramework(module) {
-    const tempDir = mkdtempSync(join(tmpdir(), 'af-ctx-integration-'));
-    const framework = await AgentFramework.create({
-        storePath: join(tempDir, 'test.chronicle'),
-        membrane: minimalMembrane(),
-        agents: [{ name: 'assistant', model: 'test-model', systemPrompt: 'test' }],
-        modules: [module],
-    });
-    return {
-        framework,
-        cleanup: async () => {
-            await framework.stop();
-            rmSync(tempDir, { recursive: true, force: true });
-        },
-    };
-}
-test('ctx.notifyOps reaches the ops channel through the real ModuleContextImpl', async () => {
-    const mod = new CtxCaptureModule();
-    const { framework, cleanup } = await makeFramework(mod);
-    try {
-        const alerts = [];
-        framework.onTrace((e) => {
-            if (e.type === 'ops:alert')
-                alerts.push(e);
-        });
-        assert.ok(mod.ctx, 'module received its context');
-        // Called as a METHOD on the context — the shape hosts must use. A
-        // detached `const f = ctx.notifyOps; f(...)` would lose `this` and is
-        // exactly the bug class this test exists to catch on the provider side.
-        mod.ctx.notifyOps?.('test-kind', 'assistant', 'receipt message', { channelId: 'c1' });
-        assert.equal(alerts.length, 1);
-        assert.equal(alerts[0].kind, 'test-kind');
-        assert.equal(alerts[0].agentName, 'assistant');
-        assert.equal(alerts[0].message, 'receipt message');
-    }
-    finally {
-        await cleanup();
-    }
-});
-test('ctx.callTool routes channel_* to the ChannelRegistry with module origin', async () => {
-    const mod = new CtxCaptureModule();
-    const { framework, cleanup } = await makeFramework(mod);
-    try {
-        // No MCPL servers in this harness, so no live ChannelRegistry — inject a
-        // capture in the private slot (test-only cast, same pattern as the
-        // registry tests' private access) to observe exactly what executeToolCall
-        // forwards.
-        const routed = [];
-        framework.channelRegistry = {
-            handleChannelToolCall: async (name, input, origin) => {
-                routed.push({ name, input, origin });
-                return { success: true, data: { channelId: 'c1', status: 'closed' } };
-            },
-            // framework.stop() walks the registry lifecycle.
-            stopAll: () => { },
-        };
-        const result = await mod.ctx.callTool({
-            id: 'gc-test-1',
-            name: 'channel_close',
-            input: { channelId: 'c1', serverId: 'discord', source: 'subscription-gc' },
-        });
-        assert.equal(result.success, true);
-        assert.equal(routed.length, 1);
-        assert.equal(routed[0].name, 'channel_close');
-        // Trusted dispatch context, not caller-asserted input.
-        assert.deepEqual(routed[0].origin, { kind: 'module' });
-    }
-    finally {
-        await cleanup();
-    }
-});
-test('public executeToolCall stamps agent origin even when input forges machine fields', async () => {
-    const mod = new CtxCaptureModule();
-    const { framework, cleanup } = await makeFramework(mod);
-    try {
-        const routed = [];
-        framework.channelRegistry = {
-            handleChannelToolCall: async (name, input, origin) => {
-                routed.push({ name, input, origin });
-                return { success: true, data: { channelId: 'c1', status: 'closed' } };
-            },
-            stopAll: () => { },
-        };
-        // The exact spoof from review: an ephemeral/model caller entering
-        // through the shared public method, claiming GC provenance in input.
-        const result = await framework.executeToolCall({
-            id: 'ephemeral-spoof-1',
-            name: 'channel_close',
-            callerAgentName: 'ephemeral-worker',
-            input: {
-                channelId: 'c1',
-                serverId: 'discord',
-                source: 'subscription-gc',
-                overrideExplicitOpen: true,
-            },
-        });
-        assert.equal(result.success, true);
-        assert.equal(routed.length, 1);
-        // Agent origin from dispatch context; the forged fields ride along in
-        // input where handleToolClose ignores them for non-module origin and
-        // records 'agent-tool'.
-        assert.deepEqual(routed[0].origin, { kind: 'agent', agentName: 'ephemeral-worker' });
-    }
-    finally {
-        await cleanup();
-    }
-});
-test('public executeToolCall without callerAgentName fails safe to agent semantics', async () => {
-    const mod = new CtxCaptureModule();
-    const { framework, cleanup } = await makeFramework(mod);
-    try {
-        const routed = [];
-        framework.channelRegistry = {
-            handleChannelToolCall: async (_name, _input, origin) => {
-                routed.push({ origin });
-                return { success: true, data: { channelId: 'c1', status: 'closed' } };
-            },
-            stopAll: () => { },
-        };
-        await framework.executeToolCall({
-            id: 'legacy-caller-1',
-            name: 'channel_close',
-            input: { channelId: 'c1', serverId: 'discord', source: 'housekeeping' },
-        });
-        assert.equal(routed.length, 1);
-        // An unidentified legacy caller is still not a module.
-        assert.deepEqual(routed[0].origin, { kind: 'agent', agentName: '__ephemeral__' });
-    }
-    finally {
-        await cleanup();
-    }
-});
-//# sourceMappingURL=module-context-integration.test.js.map

package/dist/test/module-context-integration.test.js.map

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

package/dist/test/offline-recovery-branch.test.d.ts

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

package/dist/test/offline-recovery-branch.test.d.ts.map

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