@animalabs/agent-framework 0.22.2 → 0.22.4

package/dist/test/mcpl-tool-lifecycle-script.test.js

@@ -1,288 +0,0 @@
-/**
- * RFC-007 for calls a code_execution script makes (issue #235, finding F4):
- * a real framework, a real python interpreter, real MCPL servers over stdio.
- *
- *   prov         offers `click` (classed `computer`) and `run` (unclassed,
- *                returns an error result); `delay_ms` delays an answer, and
- *                `hold` holds it until a file exists
- *   obs-all      observe, no filter: every call, metadata only
- *   obs-comms    filter `class: comms`
- *   obs-run      filter `serverTool: run`
- *   obs-web      filter `class: web`, which no call has
- *
- * The module tool `test--send` is classed `comms` by the embedding host.
- * Before this, observers saw only the outer code_execution call (`shell`),
- * so obs-comms and obs-run saw nothing at all.
- */
-import { describe, it, before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { tmpdir } from 'node:os';
-import { mkdtempSync, rmSync, readFileSync, existsSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { AgentFramework } from '../src/index.js';
-import { SCRIPT_PARENT_META_KEY } from '../src/mcpl/tool-lifecycle.js';
-import { MockMembrane, createMockResponse } from './helpers/mock-membrane.js';
-const FIXTURE = join(import.meta.dirname, 'fixtures/tool-lifecycle-mcpl-server.mjs');
-class TestModule {
-    name = 'test';
-    async start(_ctx) { }
-    async stop() { }
-    getTools() {
-        return [{
-                name: 'send',
-                description: 'Send a message to a person',
-                inputSchema: { type: 'object', properties: { text: { type: 'string' } } },
-            }];
-    }
-    async handleToolCall() {
-        return { success: true, data: 'RESULT-MARKER sent' };
-    }
-    async onProcess(event, _state) {
-        if (event.type === 'external-message') {
-            return {
-                addMessages: [{ participant: 'User', content: [{ type: 'text', text: 'go' }] }],
-                requestInference: true,
-            };
-        }
-        return {};
-    }
-}
-async function waitFor(cond, what, timeoutMs = 20_000) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        if (cond())
-            return;
-        await new Promise((r) => setTimeout(r, 50));
-    }
-    throw new Error(`timed out waiting for: ${what}`);
-}
-const readLog = (path) => existsSync(path) ? readFileSync(path, 'utf8').split('\n').filter(Boolean).map((l) => JSON.parse(l)) : [];
-const OBSERVERS = {
-    'obs-all': null,
-    'obs-comms': [{ match: { class: 'comms' } }],
-    'obs-run': [{ match: { serverTool: 'run' } }],
-    'obs-web': [{ match: { class: 'web' } }],
-};
-describe('tool lifecycle for script-made calls (RFC-007, #235 F4)', () => {
-    let tempDir;
-    let logs;
-    let membrane;
-    let framework;
-    const lifecycle = (id) => readLog(logs[id]).filter((e) => e.event === 'lifecycle').map((e) => e.params);
-    /** The stream's teardown, which ends (aborts) its open calls, has run. */
-    const streamEnded = () => !framework.activeStreams.has('scout');
-    async function runTurn(blocks) {
-        const callsBefore = membrane.calls.length;
-        membrane.pushResponse(createMockResponse(blocks, 'tool_use'));
-        membrane.pushResponse(createMockResponse([{ type: 'text', text: 'Done.' }]));
-        framework.pushEvent({
-            type: 'external-message',
-            source: 'test',
-            content: [{ type: 'text', text: 'go' }],
-            metadata: {},
-            triggerInference: true,
-        });
-        await waitFor(() => membrane.calls.length > callsBefore && (membrane.lastStream?.receivedToolResults.length ?? 0) >= 1, 'the tool round answered');
-        await waitFor(streamEnded, "the turn's stream ended");
-    }
-    before(async () => {
-        tempDir = mkdtempSync(join(tmpdir(), 'tool-lifecycle-script-'));
-        logs = {
-            prov: join(tempDir, 'prov.jsonl'),
-            'obs-all': join(tempDir, 'obs-all.jsonl'),
-            'obs-comms': join(tempDir, 'obs-comms.jsonl'),
-            'obs-run': join(tempDir, 'obs-run.jsonl'),
-            'obs-web': join(tempDir, 'obs-web.jsonl'),
-        };
-        membrane = new MockMembrane();
-        framework = await AgentFramework.create({
-            storePath: join(tempDir, 'test.chronicle'),
-            membrane: membrane.asMembrane(),
-            agents: [{ name: 'scout', model: 'test-model', systemPrompt: 'You are scout.' }],
-            modules: [new TestModule()],
-            codeExecution: { enabled: true },
-            hostToolClasses: { 'test--send': ['comms'] },
-            mcplServers: [
-                {
-                    id: 'prov',
-                    toolPrefix: 'prov',
-                    command: process.execPath,
-                    args: [FIXTURE],
-                    env: { ROLE: 'provider', LOG_PATH: logs.prov },
-                },
-                ...Object.entries(OBSERVERS).map(([id, filter]) => ({
-                    id,
-                    toolPrefix: id,
-                    command: process.execPath,
-                    args: [FIXTURE],
-                    env: {
-                        ROLE: 'observer',
-                        LOG_PATH: logs[id],
-                        ...(filter ? { FILTER: JSON.stringify(filter) } : {}),
-                    },
-                    toolLifecycle: { observe: {} },
-                })),
-            ],
-        });
-        await framework.start();
-        for (const [id, filter] of Object.entries(OBSERVERS)) {
-            if (filter) {
-                await waitFor(() => readLog(logs[id]).some((e) => e.event === 'observe-applied'), `${id} filter applied`);
-            }
-            else {
-                await waitFor(() => readLog(logs[id]).some((e) => e.event === 'policy'), `${id} granted`);
-            }
-        }
-        await waitFor(() => ['prov--click', 'prov--run', 'test--send'].every((n) => framework.getAllTools().some((t) => t.name === n)), 'tools listed');
-    });
-    after(async () => {
-        await framework?.stop();
-        if (tempDir)
-            rmSync(tempDir, { recursive: true, force: true });
-    });
-    it("reports a script's calls under each inner tool's own name and class; model calls unchanged", async () => {
-        const code = [
-            'await prov__click({"x": 1, "y": 2, "delay_ms": 250})',
-            'await prov__run({"cmd": "make"})',
-            'await test__send({"text": "hello"})',
-            'print("script done")',
-        ].join('\n');
-        await runTurn([
-            { type: 'tool_use', id: 'toolu_01SCRIPTAAAAAAAAAAAAAAAAA', name: 'code_execution', input: { code } },
-            { type: 'tool_use', id: 'toolu_01MODELBBBBBBBBBBBBBBBBBB', name: 'prov--click', input: { x: 5, y: 6 } },
-        ]);
-        // Each observer logs from its own process: wait for every log we read.
-        await waitFor(() => lifecycle('obs-all').length >= 10, 'obs-all: five calls, both phases');
-        await waitFor(() => lifecycle('obs-comms').length >= 2, 'obs-comms: one call, both phases');
-        await waitFor(() => lifecycle('obs-run').length >= 2, 'obs-run: one call, both phases');
-        await new Promise((r) => setTimeout(r, 300)); // a stray or duplicate would land here
-        const script = JSON.stringify(membrane.lastStream?.receivedToolResults ?? []);
-        assert.match(script, /script done/, 'the script ran to the end');
-        const all = lifecycle('obs-all');
-        assert.equal(all.length, 10, all.map((p) => `${p.tool}:${p.phase}`).join(', '));
-        const parent = all.find((p) => p.tool === 'code_execution' && p.phase === 'started');
-        assert.deepEqual(parent.class, ['shell']);
-        const parentMeta = { [SCRIPT_PARENT_META_KEY]: parent.toolCallId };
-        // The model's own calls: as before, no attribution.
-        for (const p of all.filter((p) => p.tool === 'code_execution' || p.toolCallId === 'toolu_01MODELBBBBBBBBBBBBBBBBBB')) {
-            assert.equal(p._meta, undefined, `${p.tool}:${p.phase} carries no _meta`);
-        }
-        const modelClick = all.filter((p) => p.toolCallId === 'toolu_01MODELBBBBBBBBBBBBBBBBBB');
-        assert.deepEqual(modelClick.map((p) => `${p.tool}:${p.phase}`), ['prov--click:started', 'prov--click:completed']);
-        // The script's calls: inner tool, inner class, the parent's inference and call.
-        const inner = all.filter((p) => p._meta !== undefined);
-        assert.equal(inner.length, 6);
-        for (const p of inner) {
-            assert.deepEqual(p._meta, parentMeta);
-            assert.equal(p.inferenceId, parent.inferenceId);
-            assert.equal(p.conversationId, 'scout');
-            assert.notEqual(p.toolCallId, parent.toolCallId);
-        }
-        const phases = (tool) => inner.filter((p) => p.tool === tool);
-        const [clickStart, clickEnd] = phases('prov--click');
-        assert.deepEqual([clickStart.phase, clickEnd.phase], ['started', 'completed']);
-        assert.equal(clickStart.toolCallId, clickEnd.toolCallId);
-        assert.deepEqual(clickStart.class, ['computer']);
-        assert.equal(clickStart.serverId, 'prov');
-        assert.equal(clickStart.serverTool, 'click');
-        assert.equal(clickEnd.isError, false);
-        const duration = clickEnd.durationMs;
-        assert.ok(duration >= 200 && duration < 10_000, `durationMs ${duration} spans the 250ms call`);
-        const [runStart, runEnd] = phases('prov--run');
-        assert.deepEqual(runStart.class, []);
-        assert.equal(runEnd.phase, 'completed', 'an error result is completed, not failed');
-        assert.equal(runEnd.isError, true);
-        const [sendStart, sendEnd] = phases('test--send');
-        assert.deepEqual(sendStart.class, ['comms']);
-        assert.equal(sendStart.serverId, undefined, 'a host-implemented tool');
-        assert.equal(sendEnd.phase, 'completed');
-        // Filters see the inner calls they ask for, by class and by name.
-        assert.deepEqual(lifecycle('obs-comms').map((p) => `${p.tool}:${p.phase}`), ['test--send:started', 'test--send:completed']);
-        assert.deepEqual(lifecycle('obs-comms')[0]._meta, parentMeta);
-        assert.deepEqual(lifecycle('obs-run').map((p) => `${p.tool}:${p.phase}:${p.isError}`), ['prov--run:started:undefined', 'prov--run:completed:true']);
-        assert.equal(lifecycle('obs-web').length, 0, 'a filter no call matches sees nothing');
-        for (const id of Object.keys(OBSERVERS)) {
-            const wire = JSON.stringify(lifecycle(id));
-            for (const secret of ['RESULT-MARKER', 'hello', 'make']) {
-                assert.ok(!wire.includes(secret), `"${secret}" must not reach ${id}`);
-            }
-        }
-        assert.equal(readLog(logs.prov).filter((e) => e.event === 'lifecycle').length, 0, 'the provider holds no grant');
-    });
-    it('a dispatch that throws after doing work is reported started then failed, not dropped', async () => {
-        // Some host tools change state and then throw synchronously (sleep with
-        // a huge `seconds` sets the gate, then fails formatting its reply).
-        // Stand one in for test--send.
-        const internals = framework;
-        const original = internals.dispatchToolCall;
-        let workDone = 0;
-        internals.dispatchToolCall = function (agentName, call) {
-            if (call.name === 'test--send' && call.input.boom) {
-                workDone++;
-                throw new RangeError('Invalid time value');
-            }
-            return original.call(this, agentName, call);
-        };
-        try {
-            const before = { all: lifecycle('obs-all').length, comms: lifecycle('obs-comms').length };
-            await runTurn([{
-                    type: 'tool_use',
-                    id: 'toolu_01THROWSDDDDDDDDDDDDDDDDDD',
-                    name: 'code_execution',
-                    input: { code: 'r = await test__send({"text": "x", "boom": True})\nprint("got:", r)' },
-                }]);
-            await waitFor(() => lifecycle('obs-all').length >= before.all + 4, 'obs-all: both calls ended');
-            await waitFor(() => lifecycle('obs-comms').length >= before.comms + 2, 'obs-comms: the call ended');
-            await new Promise((r) => setTimeout(r, 300)); // a stray or duplicate would land here
-            assert.equal(workDone, 1);
-            assert.match(JSON.stringify(membrane.lastStream.receivedToolResults), /got: Error: Invalid time value/);
-            const events = lifecycle('obs-all').slice(before.all);
-            assert.deepEqual(events.map((p) => `${p.tool}:${p.phase}`), [
-                'code_execution:started',
-                'test--send:started',
-                'test--send:failed',
-                'code_execution:completed',
-            ]);
-            assert.deepEqual(events[2]._meta, { [SCRIPT_PARENT_META_KEY]: events[0].toolCallId });
-            assert.deepEqual(lifecycle('obs-comms').slice(before.comms).map((p) => `${p.tool}:${p.phase}`), ['test--send:started', 'test--send:failed']);
-        }
-        finally {
-            delete internals.dispatchToolCall;
-        }
-    });
-    it('a call still running when its script is killed is reported completed when it finishes', async () => {
-        const before = lifecycle('obs-all').length;
-        const release = join(tempDir, 'release-orphan');
-        await runTurn([{
-                type: 'tool_use',
-                id: 'toolu_01ORPHANCCCCCCCCCCCCCCCCCC',
-                name: 'code_execution',
-                input: { code: `await prov__click({"x": 1, "y": 1, "hold": ${JSON.stringify(release)}})`, time_limit_ms: 1000 },
-            }]);
-        // The script was stopped and the turn's stream has ended (ending its open
-        // calls), while the provider still holds the inner call's reply.
-        await waitFor(() => lifecycle('obs-all').length >= before + 3, 'the held call was reported');
-        const whileHeld = lifecycle('obs-all').slice(before);
-        assert.deepEqual(whileHeld.map((p) => `${p.tool}:${p.phase}`), [
-            'code_execution:started',
-            'prov--click:started',
-            'code_execution:completed',
-        ]);
-        // Held for at least 200ms more, after the call had already started.
-        await new Promise((r) => setTimeout(r, 200));
-        writeFileSync(release, '');
-        await waitFor(() => lifecycle('obs-all').length >= before + 4, 'the orphaned call finished');
-        await new Promise((r) => setTimeout(r, 300)); // a stray or duplicate would land here
-        const events = lifecycle('obs-all').slice(before);
-        assert.deepEqual(events.map((p) => `${p.tool}:${p.phase}`), [
-            'code_execution:started',
-            'prov--click:started',
-            'code_execution:completed',
-            'prov--click:completed',
-        ]);
-        const end = events[3];
-        assert.equal(end.isError, false);
-        assert.ok(end.durationMs >= 200, `durationMs ${String(end.durationMs)} covers the hold`);
-    });
-});
-//# sourceMappingURL=mcpl-tool-lifecycle-script.test.js.map

package/dist/test/mcpl-tool-lifecycle-script.test.js.map

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

package/dist/test/mcpl-tool-lifecycle.test.d.ts

@@ -1,11 +0,0 @@
-/**
- * MCPL RFC-007 tool lifecycle — the host-side decision (grant, narrowing,
- * class exclusions, the server's tools/observe filter, field selection and
- * bounding) and the emitter's pairing (started → one terminal, to exactly the
- * connections opened to, unless their grant no longer covers the call).
- *
- * Test names cite RFC-007 sections; conformance-vector numbers follow the
- * RFC's own list where one applies.
- */
-export {};
-//# sourceMappingURL=mcpl-tool-lifecycle.test.d.ts.map

package/dist/test/mcpl-tool-lifecycle.test.d.ts.map

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

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

@@ -1,270 +0,0 @@
-/**
- * MCPL RFC-007 tool lifecycle — the host-side decision (grant, narrowing,
- * class exclusions, the server's tools/observe filter, field selection and
- * bounding) and the emitter's pairing (started → one terminal, to exactly the
- * connections opened to, unless their grant no longer covers the call).
- *
- * Test names cite RFC-007 sections; conformance-vector numbers follow the
- * RFC's own list where one applies.
- */
-import { test, describe } from 'node:test';
-import assert from 'node:assert/strict';
-import { CapabilityGrant } from '../src/mcpl/capability-grant.js';
-import { parseToolObserveParams, selectFields, boundInput, openingFor, TOOL_OBSERVE_LIMITS, } from '../src/mcpl/tool-lifecycle.js';
-const OBSERVE = 'toolLifecycle.observe';
-const INPUTS = 'toolLifecycle.inputs';
-function observer(id, paths, filter = null) {
-    const sent = [];
-    return {
-        id,
-        grant: new CapabilityGrant(new Set(paths), []),
-        toolObserveFilter: filter,
-        sendToolLifecycle: (p) => { sent.push(p); },
-        sent,
-    };
-}
-function rules(raw) {
-    const parsed = parseToolObserveParams({ rules: raw });
-    assert.ok(parsed.ok, `rules should parse: ${JSON.stringify(raw)}`);
-    return parsed.rules;
-}
-function call(over = {}) {
-    return {
-        toolCallId: 'toolu_0123456789abcdefghij',
-        inferenceId: 'inf_1',
-        conversationId: 'scout',
-        tool: 'computer--click',
-        class: ['computer'],
-        serverId: 'computer',
-        serverTool: 'click',
-        input: { x: 812, y: 440, button: 'left', target: { window_id: 3312, title: 'Invoice.pdf' } },
-        ...over,
-    };
-}
-const DEFAULT_INPUTS = { observe: {}, inputs: { classes: 'default' } };
-// ── RFC §6.4 steps 1–5, per connection ──────────────────────────────────────
-describe('openingFor: grant, narrowing, filter, arguments', () => {
-    test('no observe grant → nothing (§4.1)', () => {
-        const o = observer('obs', [INPUTS], rules([{ match: {}, input: true }]));
-        assert.equal(openingFor(o, DEFAULT_INPUTS, call(), 'started'), null);
-    });
-    test('vector 1 — observe only, no filter: metadata, no input, no inputWithheld', () => {
-        const p = openingFor(observer('obs', [OBSERVE]), undefined, call(), 'started');
-        assert.deepEqual(Object.keys(p).sort(), [
-            'class', 'conversationId', 'inferenceId', 'phase', 'serverId', 'serverTool', 'tool', 'toolCallId',
-        ]);
-        assert.equal(p.phase, 'started');
-        assert.deepEqual(p.class, ['computer']);
-    });
-    test('vector 2 — both leaves granted, NO filter: still metadata only (§5.1, rev 2)', () => {
-        const p = openingFor(observer('obs', [OBSERVE, INPUTS]), DEFAULT_INPUTS, call(), 'started');
-        assert.equal(p.input, undefined);
-        assert.equal(p.inputWithheld, undefined);
-    });
-    test('vector 3 — filter requests fields, grant allows: projected input, no inputAltered', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([{ match: { serverTool: 'click' }, input: ['x', 'y', 'target.window_id'] }]));
-        const p = openingFor(o, DEFAULT_INPUTS, call(), 'started');
-        assert.deepEqual(p.input, { x: 812, y: 440, target: { window_id: 3312 } });
-        assert.equal(p.inputAltered, undefined);
-    });
-    test('inputs narrowed by tool away from the call → inputWithheld (§4.3)', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([{ match: {}, input: true }]));
-        const p = openingFor(o, { observe: {}, inputs: { tools: ['y--*'] } }, call(), 'started');
-        assert.equal(p.input, undefined);
-        assert.equal(p.inputWithheld, true);
-    });
-    test('observe narrowed away from the call → nothing', () => {
-        const o = observer('obs', [OBSERVE]);
-        assert.equal(openingFor(o, { observe: { tools: ['y--*'] } }, call(), 'started'), null);
-        assert.equal(openingFor(o, { observe: { classes: ['shell'] } }, call(), 'started'), null);
-        assert.ok(openingFor(o, { observe: { classes: ['shell', 'computer'] } }, call(), 'started'));
-    });
-    test('conversation narrowing is host-side (§4.3, §7.1)', () => {
-        const o = observer('obs', [OBSERVE]);
-        const cfg = { observe: { conversations: ['scout'] } };
-        assert.ok(openingFor(o, cfg, call({ conversationId: 'scout' }), 'started'));
-        assert.equal(openingFor(o, cfg, call({ conversationId: 'other' }), 'started'), null);
-    });
-    test('inputs is never unconditional: no tools/classes term → withheld (§4.3)', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([{ match: {}, input: true }]));
-        for (const cfg of [{ observe: {} }, { observe: {}, inputs: {} }, { observe: {}, inputs: { conversations: ['*'] } }]) {
-            const p = openingFor(o, cfg, call(), 'started');
-            assert.equal(p.input, undefined, JSON.stringify(cfg));
-            assert.equal(p.inputWithheld, true, JSON.stringify(cfg));
-        }
-    });
-    test('comms never carries input, whatever the narrowing says (§4.3, §5.4)', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([{ match: {}, input: true }]));
-        const cfg = { observe: {}, inputs: { classes: ['comms', 'files'], tools: ['*'] } };
-        const send = call({ tool: 'disc--send', class: ['comms'], serverId: 'disc', serverTool: 'send', input: { text: 'hi Alice' } });
-        const p = openingFor(o, cfg, send, 'started');
-        assert.equal(p.input, undefined);
-        assert.equal(p.inputWithheld, true);
-        // Multi-class tools get the union of restrictions (RFC-008 §5.3).
-        const sendFile = call({ tool: 'disc--send_file', class: ['files', 'comms'], input: { path: '/x' } });
-        assert.equal(openingFor(o, cfg, sendFile, 'started').input, undefined);
-    });
-    test('unclassed never carries input (RFC-008 §5.2)', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([{ match: {}, input: true }]));
-        const p = openingFor(o, { observe: {}, inputs: { tools: ['*'] } }, call({ class: [] }), 'started');
-        assert.deepEqual(p.class, []);
-        assert.equal(p.input, undefined);
-        assert.equal(p.inputWithheld, true);
-    });
-    test('requested without the inputs grant → no input AND no inputWithheld (§5.1)', () => {
-        const o = observer('obs', [OBSERVE], rules([{ match: {}, input: true }]));
-        const p = openingFor(o, DEFAULT_INPUTS, call(), 'started');
-        assert.equal(p.input, undefined);
-        assert.equal(p.inputWithheld, undefined);
-    });
-    test('not requested → no input, no inputWithheld', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([{ match: {} }]));
-        const p = openingFor(o, DEFAULT_INPUTS, call(), 'started');
-        assert.equal(p.input, undefined);
-        assert.equal(p.inputWithheld, undefined);
-    });
-    test('own tools are excluded (§7.1)', () => {
-        const o = observer('computer', [OBSERVE]);
-        assert.equal(openingFor(o, undefined, call(), 'started'), null);
-    });
-    test('host-implemented tools have no serverId/serverTool', () => {
-        const p = openingFor(observer('obs', [OBSERVE]), undefined, call({ tool: 'code_execution', class: ['shell'], serverId: undefined, serverTool: undefined }), 'started');
-        assert.equal('serverId' in p, false);
-        assert.equal('serverTool' in p, false);
-    });
-    test('pending never carries input', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([{ match: {}, input: true }]));
-        const p = openingFor(o, DEFAULT_INPUTS, call(), 'pending');
-        assert.equal(p.phase, 'pending');
-        assert.equal(p.input, undefined);
-        assert.equal(p.inputWithheld, undefined);
-    });
-});
-// ── RFC §6 filter semantics ─────────────────────────────────────────────────
-describe('tools/observe filter', () => {
-    const shell = call({ tool: 'workbench--bash', class: ['shell'], serverId: 'workbench', serverTool: 'bash', input: { command: 'make' } });
-    const blender = call({ tool: 'blender--execute', class: [], serverId: 'blender', serverTool: 'execute', input: { code: 'x' } });
-    const say = call({ tool: 'channel_publish', class: ['comms'], serverId: undefined, serverTool: undefined, input: { text: 'hi' } });
-    test('a call matching no rule is not reported', () => {
-        const o = observer('obs', [OBSERVE], rules([{ match: { tool: 'y--*' } }]));
-        assert.equal(openingFor(o, undefined, call(), 'started'), null);
-        assert.ok(openingFor(o, undefined, call({ tool: 'y--go' }), 'started'));
-    });
-    test('first match wins', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([
-            { match: { tool: 'computer--*' }, input: ['x'] },
-            { match: {}, input: true },
-        ]));
-        assert.deepEqual(openingFor(o, DEFAULT_INPUTS, call(), 'started').input, { x: 812 });
-    });
-    test('report:false carves an exception out of a later catch-all', () => {
-        const o = observer('obs', [OBSERVE], rules([{ match: { class: 'comms' }, report: false }, { match: {} }]));
-        assert.equal(openingFor(o, undefined, say, 'started'), null);
-        assert.ok(openingFor(o, undefined, shell, 'started'));
-    });
-    test('class rule: matches by effective class; never matches an unclassed tool', () => {
-        const o = observer('obs', [OBSERVE], rules([{ match: { class: 'shell' } }]));
-        assert.ok(openingFor(o, undefined, shell, 'started'));
-        assert.equal(openingFor(o, undefined, blender, 'started'), null);
-    });
-    test('serverTool / serverId rules never match a host-implemented tool', () => {
-        const o = observer('obs', [OBSERVE], rules([{ match: { serverTool: '*' } }]));
-        assert.equal(openingFor(o, undefined, say, 'started'), null);
-        const o2 = observer('obs', [OBSERVE], rules([{ match: { serverId: '*' } }]));
-        assert.equal(openingFor(o2, undefined, say, 'started'), null);
-    });
-    test('conversationId is a match member (interest, not the boundary)', () => {
-        const o = observer('obs', [OBSERVE], rules([{ match: { conversationId: 'scout' } }]));
-        assert.ok(openingFor(o, undefined, call(), 'started'));
-        assert.equal(openingFor(o, undefined, call({ conversationId: 'x' }), 'started'), null);
-    });
-    test('rules: [] pauses; null clears back to metadata-only default', () => {
-        assert.deepEqual(parseToolObserveParams({ rules: [] }), { ok: true, rules: [] });
-        assert.equal(openingFor(observer('obs', [OBSERVE], []), undefined, call(), 'started'), null);
-        assert.deepEqual(parseToolObserveParams({ rules: null }), { ok: true, rules: null });
-        assert.deepEqual(parseToolObserveParams({}), { ok: true, rules: null });
-        assert.deepEqual(parseToolObserveParams(undefined), { ok: true, rules: null });
-    });
-    test('defaults: report true, input false', () => {
-        assert.deepEqual(rules([{ match: {} }]), [{ match: {}, report: true, input: false }]);
-    });
-    test('malformed requests fail with a reason (§6.6)', () => {
-        const bad = [
-            'nope',
-            { rules: 'x' },
-            { rules: [1] },
-            { rules: [{}] },
-            { rules: [{ match: { module: 'x' } }] },
-            { rules: [{ match: {}, extra: 1 }] },
-            { rules: [{ match: { class: 'quantum' } }] },
-            { rules: [{ match: { tool: 3 } }] },
-            { rules: [{ match: {}, report: 'yes' }] },
-            { rules: [{ match: {}, input: 'x' }] },
-            { rules: [{ match: {}, input: [''] }] },
-            { rules: [{ match: {}, input: [1] }] },
-        ];
-        for (const params of bad) {
-            const r = parseToolObserveParams(params);
-            assert.equal(r.ok, false, JSON.stringify(params));
-        }
-    });
-    test('limits report which limit (§6.6)', () => {
-        const many = Array.from({ length: TOOL_OBSERVE_LIMITS.rules + 1 }, () => ({ match: {} }));
-        const r1 = parseToolObserveParams({ rules: many });
-        assert.equal(r1.ok, false);
-        assert.deepEqual(!r1.ok && r1.data, { limit: 'rules' });
-        const long = 'x'.repeat(TOOL_OBSERVE_LIMITS.stringLength + 1);
-        const r2 = parseToolObserveParams({ rules: [{ match: { tool: long } }] });
-        assert.deepEqual(!r2.ok && r2.data, { limit: 'stringLength' });
-        const paths = Array.from({ length: TOOL_OBSERVE_LIMITS.pathsPerRule + 1 }, (_, i) => `f${i}`);
-        const r3 = parseToolObserveParams({ rules: [{ match: {}, input: paths }] });
-        assert.deepEqual(!r3.ok && r3.data, { limit: 'pathsPerRule' });
-        // The floor the RFC asks for is accepted.
-        assert.equal(parseToolObserveParams({ rules: Array.from({ length: 64 }, () => ({ match: {} })) }).ok, true);
-    });
-});
-// ── RFC §6.3 field paths, §5.2 bounds ───────────────────────────────────────
-describe('field selection and bounding', () => {
-    test('nested path keeps structure; whole object/array; missing selects nothing', () => {
-        const input = { target: { window_id: 3, kind: 'w' }, x: 1, list: [1, 2], s: 'str' };
-        assert.deepEqual(selectFields(input, ['target.window_id']), { target: { window_id: 3 } });
-        assert.deepEqual(selectFields(input, ['target', 'list']), { target: { window_id: 3, kind: 'w' }, list: [1, 2] });
-        assert.deepEqual(selectFields(input, ['z']), {});
-        assert.deepEqual(selectFields(input, ['s.length']), {}); // through a non-object
-        assert.deepEqual(selectFields(input, ['target.window_id', 'target']), { target: { window_id: 3, kind: 'w' } });
-    });
-    test('field paths cannot reach or write prototypes', () => {
-        const out = selectFields({ a: 1 }, ['__proto__.polluted', 'constructor', 'toString']);
-        assert.deepEqual(out, {});
-        assert.equal({}.polluted, undefined);
-    });
-    test('within bound → untouched', () => {
-        const v = { a: 'x'.repeat(100) };
-        assert.deepEqual(boundInput(v, 16 * 1024), { value: v, altered: false });
-    });
-    test('vector 15 — a 200 KiB argument is cut to fit, still an object, altered', () => {
-        const big = { content: 'y'.repeat(200 * 1024), path: '/tmp/out.txt' };
-        const r = boundInput(big, 16 * 1024);
-        assert.ok(r.altered);
-        assert.ok(Buffer.byteLength(JSON.stringify(r.value)) <= 16 * 1024);
-        assert.equal(r.value.path, '/tmp/out.txt');
-        assert.ok(typeof r.value.content === 'string' && big.content.startsWith(r.value.content));
-    });
-    test('many small members: dropped until it fits', () => {
-        const wide = Object.fromEntries(Array.from({ length: 5000 }, (_, i) => [`k${i}`, i]));
-        const r = boundInput(wide, 2048);
-        assert.ok(r.altered);
-        assert.ok(Buffer.byteLength(JSON.stringify(r.value)) <= 2048);
-    });
-    test('configured bound applies after selection; selection alone never sets inputAltered', () => {
-        const o = observer('obs', [OBSERVE, INPUTS], rules([{ match: {}, input: ['content'] }]));
-        const writeCall = call({ tool: 'files--write', class: ['files'], input: { content: 'z'.repeat(5000), path: '/p' } });
-        const tight = openingFor(o, { ...DEFAULT_INPUTS, maxInputBytes: 1024 }, writeCall, 'started');
-        assert.equal(tight.inputAltered, true);
-        assert.ok(Buffer.byteLength(JSON.stringify(tight.input)) <= 1024);
-        const loose = openingFor(o, DEFAULT_INPUTS, writeCall, 'started');
-        assert.equal(loose.inputAltered, undefined);
-        assert.deepEqual(Object.keys(loose.input), ['content']);
-    });
-});
-//# sourceMappingURL=mcpl-tool-lifecycle.test.js.map