@animalabs/agent-framework 0.19.0 → 0.21.0

package/dist/test/history-semantic-sync-converges.test.js

@@ -0,0 +1,109 @@
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import { createServer } from 'node:http';
+import { HistoryModule } from '../src/modules/history/index.js';
+/** Minimal embed-service: dedup by id, cursor-aware stats, counts requests. */
+class FakeService {
+    items = new Map();
+    calls = [];
+    server;
+    url = '';
+    async start() {
+        this.server = createServer((req, res) => {
+            let body = '';
+            req.on('data', (c) => { body += c; });
+            req.on('end', () => {
+                const m = /^\/v1\/index\/([^/]+)\/(stats|upsert|search)$/.exec(req.url ?? '');
+                this.calls.push(m?.[2] ?? '?');
+                const json = (code, o) => { res.writeHead(code, { 'content-type': 'application/json' }); res.end(JSON.stringify(o)); };
+                if (!m)
+                    return json(404, {});
+                if (m[2] === 'stats') {
+                    if (this.items.size === 0)
+                        return json(404, { error: { message: 'no such namespace' } });
+                    const by = {};
+                    for (const it of this.items.values()) {
+                        const d = by[it.kind] ??= { count: 0, max_ts: null, min_ts: null, max_cursor: null };
+                        d.count++;
+                        if (it.cursor !== undefined)
+                            d.max_cursor = d.max_cursor === null ? it.cursor : Math.max(d.max_cursor, it.cursor);
+                    }
+                    return json(200, { namespace: 'n', model: 'fake', dim: 1, count: this.items.size, by_kind: by });
+                }
+                if (m[2] === 'upsert') {
+                    const items = JSON.parse(body).items;
+                    let inserted = 0, unchanged = 0;
+                    for (const it of items) {
+                        if (this.items.has(it.id))
+                            unchanged++;
+                        else
+                            inserted++;
+                        this.items.set(it.id, it);
+                    }
+                    return json(200, { inserted, updated: 0, unchanged, count: this.items.size });
+                }
+                return json(200, { namespace: 'n', hits: [], count_indexed: this.items.size, timing_ms: { embed: 0, search: 0 } });
+            });
+        });
+        await new Promise((r) => this.server.listen(0, '127.0.0.1', r));
+        const a = this.server.address();
+        this.url = `http://127.0.0.1:${typeof a === 'object' && a ? a.port : 0}`;
+    }
+    stop() {
+        this.server.closeAllConnections();
+        return new Promise((r) => this.server.close(() => r()));
+    }
+}
+function msg(id, ms, text) {
+    return {
+        id, sequence: Number(id.replace(/\D/g, '')), participant: 'Linn',
+        content: [{ type: 'text', text }], timestamp: new Date(ms), metadata: undefined,
+    };
+}
+/** Stub CM with the real queryByTime contract: inclusive bounds, oldest first, `limit` = first N. */
+function stubCm(messages) {
+    return {
+        queryMessagesByTime(o) {
+            const all = messages
+                .filter((m) => (o.fromMs === undefined || m.timestamp.getTime() >= o.fromMs) && (o.toMs === undefined || m.timestamp.getTime() <= o.toMs))
+                .sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+            return { messages: all.slice(0, o.limit ?? all.length), totalCount: all.length };
+        },
+        getSummariesInRange() { return []; },
+    };
+}
+const T0 = Date.UTC(2026, 8, 22);
+describe('semantic sync converges', () => {
+    const svc = new FakeService();
+    before(() => svc.start());
+    after(() => svc.stop());
+    it('a store denser than the tick budget is fully indexed after enough ticks (overlap re-sends do not eat the budget)', async () => {
+        // 700 messages one second apart: the default 10-minute overlap window
+        // holds 600 of them, more than a 300-item tick.
+        const store = Array.from({ length: 700 }, (_, i) => msg(`m${i}`, T0 + i * 1000, `message number ${i} with enough text to index`));
+        const mod = new HistoryModule({ semantic: { url: svc.url, namespace: 'n', syncIntervalMs: 0 } });
+        mod.bind(stubCm(store));
+        try {
+            const reports = [];
+            for (let tick = 0; tick < 12 && svc.items.size < 700; tick++) {
+                const r = await mod.syncSemanticIndex(300);
+                reports.push([r.pushed, r.more]);
+            }
+            assert.equal(svc.items.size, 700, `index froze at ${svc.items.size}; ticks (pushed, more): ${JSON.stringify(reports)}`);
+            const last = await mod.syncSemanticIndex(300);
+            assert.equal(last.more, false, 'a caught-up store reports more: false');
+        }
+        finally {
+            await mod.stop();
+        }
+    });
+    it('stop() cancels the first-tick timer: nothing reaches the service after a stopped module', async () => {
+        const mod = new HistoryModule({ semantic: { url: svc.url, namespace: 'n', syncIntervalMs: 60_000 } });
+        mod.bind(stubCm([msg('z1', T0, 'a message that would be pushed by the first tick')]));
+        await mod.stop();
+        svc.calls.length = 0;
+        await new Promise((r) => setTimeout(r, 5_300));
+        assert.deepEqual(svc.calls, [], `stopped module still called the service: ${JSON.stringify(svc.calls)}`);
+    });
+});
+//# sourceMappingURL=history-semantic-sync-converges.test.js.map

package/dist/test/history-semantic-sync-converges.test.js.map

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

package/dist/test/mcpl-capability-grant.test.js

@@ -11,7 +11,7 @@ import assert from 'node:assert/strict';
 import { advertisedPaths, capabilityPatternMatches, computeGrant, ALL_CAPABILITY_PATHS, isKnownCapabilityPath, CapabilityGrant, } from '../src/mcpl/capability-grant.js';
 const caps = (o) => ({ version: '0.5', ...o });
 // ── §6.2 vocabulary ─────────────────────────────────────────────────────────
-test('vocabulary is exactly the 17 §6.2 paths', () => {
+test('vocabulary is exactly the 19 §6.2 paths (17 + RFC-007\'s two toolLifecycle leaves)', () => {
     assert.deepEqual([...ALL_CAPABILITY_PATHS].sort(), [
         'channels.acknowledge',
         'channels.incoming',
@@ -29,6 +29,8 @@ test('vocabulary is exactly the 17 §6.2 paths', () => {
         'inferenceRequest.streaming',
         'modelInfo',
         'pushEvents',
+        'toolLifecycle.inputs',
+        'toolLifecycle.observe',
         'tools',
     ]);
     assert.equal(isKnownCapabilityPath('channels'), false); // namespace, not a path

package/dist/test/mcpl-capability-grant.test.js.map

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

package/dist/test/mcpl-child-env.test.d.ts

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

package/dist/test/mcpl-child-env.test.d.ts.map

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

package/dist/test/mcpl-child-env.test.js

@@ -0,0 +1,158 @@
+/**
+ * Stdio MCPL children must not inherit the host's secrets. They get a small
+ * operating allowlist (PATH, HOME, LC_*, ...) plus their declared `env`;
+ * `inheritEnv: true` restores full inheritance.
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { buildChildEnv, StdioTransport } from '../src/mcpl/transport.js';
+const HOST_ENV = {
+    PATH: '/usr/bin:/bin',
+    HOME: '/home/resident',
+    LANG: 'en_US.UTF-8',
+    LC_CTYPE: 'UTF-8',
+    TMPDIR: '/tmp/x',
+    ANTHROPIC_AUTH_TOKEN: 'host-anthropic-secret',
+    DISCORD_TOKEN: 'host-discord-secret',
+    OPENAI_API_KEY: 'host-openai-secret',
+};
+test('drops host secrets, keeps operating vars and LC_*', () => {
+    const env = buildChildEnv({}, HOST_ENV);
+    assert.deepEqual(env, {
+        PATH: '/usr/bin:/bin',
+        HOME: '/home/resident',
+        LANG: 'en_US.UTF-8',
+        LC_CTYPE: 'UTF-8',
+        TMPDIR: '/tmp/x',
+    });
+});
+test('keeps CA bundles and uppercase/lowercase proxy configuration', () => {
+    const networkEnv = {
+        REQUESTS_CA_BUNDLE: '/etc/ssl/certs/internal.pem',
+        CURL_CA_BUNDLE: '/etc/ssl/certs/curl.pem',
+        HTTP_PROXY: 'http://user:password@proxy.example:8080',
+        HTTPS_PROXY: 'http://proxy.example:8443',
+        NO_PROXY: 'localhost,127.0.0.1,.internal',
+        http_proxy: 'http://lowercase.example:8080',
+        https_proxy: 'http://lowercase.example:8443',
+        no_proxy: 'localhost,.lowercase.internal',
+    };
+    const env = buildChildEnv({}, { ...HOST_ENV, ...networkEnv }, 'linux');
+    for (const [key, value] of Object.entries(networkEnv)) {
+        assert.equal(env[key], value, key);
+    }
+    assert.equal(env.OPENAI_API_KEY, undefined);
+    assert.equal(env.DISCORD_TOKEN, undefined);
+    assert.equal(env.ANTHROPIC_AUTH_TOKEN, undefined);
+});
+test('declared network settings override the host and empty values are preserved', () => {
+    const env = buildChildEnv({ env: { REQUESTS_CA_BUNDLE: '/server/ca.pem', HTTPS_PROXY: '', NO_PROXY: '*' } }, { REQUESTS_CA_BUNDLE: '/host/ca.pem', HTTPS_PROXY: 'http://proxy.example', NO_PROXY: '', http_proxy: '', CURL_CA_BUNDLE: undefined });
+    assert.deepEqual(env, {
+        REQUESTS_CA_BUNDLE: '/server/ca.pem',
+        HTTPS_PROXY: '',
+        NO_PROXY: '*',
+        http_proxy: '',
+    });
+});
+test('declared env is passed through and wins over allowlisted host vars', () => {
+    const env = buildChildEnv({ env: { DISCORD_TOKEN: 'declared-token', PATH: '/opt/bin' } }, HOST_ENV);
+    assert.equal(env.DISCORD_TOKEN, 'declared-token');
+    assert.equal(env.PATH, '/opt/bin');
+    assert.equal(env.HOME, '/home/resident');
+    assert.equal(env.ANTHROPIC_AUTH_TOKEN, undefined);
+    assert.equal(env.OPENAI_API_KEY, undefined);
+});
+test('inheritEnv: true passes the whole host env, declared env on top', () => {
+    const env = buildChildEnv({ inheritEnv: true, env: { EXTRA: '1' } }, HOST_ENV);
+    assert.equal(env.ANTHROPIC_AUTH_TOKEN, 'host-anthropic-secret');
+    assert.equal(env.EXTRA, '1');
+});
+test('a real spawned stdio child sees only allowlist + declared env', async () => {
+    const secretKey = 'MCPL_ENV_TEST_HOST_SECRET';
+    const previousCaBundle = process.env.REQUESTS_CA_BUNDLE;
+    const previousProxy = process.env.HTTPS_PROXY;
+    process.env[secretKey] = 'must-not-leak';
+    process.env.REQUESTS_CA_BUNDLE = '/host/internal-ca.pem';
+    process.env.HTTPS_PROXY = 'http://proxy.example:8443';
+    try {
+        const transport = StdioTransport.spawn({
+            id: 'env-probe',
+            command: process.execPath,
+            args: ['-e', 'console.log(JSON.stringify(process.env))'],
+            env: { DECLARED_VAR: 'declared-value' },
+        });
+        const line = await new Promise((resolve, reject) => {
+            transport.once('line', resolve);
+            transport.once('error', reject);
+        });
+        await transport.close();
+        const childEnv = JSON.parse(line);
+        assert.equal(childEnv[secretKey], undefined);
+        assert.equal(childEnv.DECLARED_VAR, 'declared-value');
+        assert.equal(childEnv.REQUESTS_CA_BUNDLE, '/host/internal-ca.pem');
+        assert.equal(childEnv.HTTPS_PROXY, 'http://proxy.example:8443');
+        if (process.env.PATH)
+            assert.equal(childEnv.PATH, process.env.PATH);
+        if (process.env.HOME)
+            assert.equal(childEnv.HOME, process.env.HOME);
+    }
+    finally {
+        delete process.env[secretKey];
+        if (previousCaBundle === undefined)
+            delete process.env.REQUESTS_CA_BUNDLE;
+        else
+            process.env.REQUESTS_CA_BUNDLE = previousCaBundle;
+        if (previousProxy === undefined)
+            delete process.env.HTTPS_PROXY;
+        else
+            process.env.HTTPS_PROXY = previousProxy;
+    }
+});
+for (const inheritEnv of [false, true]) {
+    test(`win32: declared proxy/CA overrides win across case variants (inheritEnv=${inheritEnv})`, () => {
+        for (const name of ['HTTP_PROXY', 'HTTPS_PROXY', 'NO_PROXY', 'REQUESTS_CA_BUNDLE', 'CURL_CA_BUNDLE']) {
+            for (const [hostKey, declaredKey] of [[name, name.toLowerCase()], [name.toLowerCase(), name]]) {
+                const env = buildChildEnv({ inheritEnv, env: { [declaredKey]: '' } }, { [hostKey]: 'http://user:password@host-proxy.example', OPENAI_API_KEY: 'host-secret' }, 'win32');
+                assert.deepEqual(Object.keys(env).filter((key) => key.toUpperCase() === name), [declaredKey], 'only the declared spelling may reach Windows spawn');
+                assert.equal(env[declaredKey], '', name + ' must remain explicitly disabled');
+                assert.equal(env.OPENAI_API_KEY, inheritEnv ? 'host-secret' : undefined);
+            }
+        }
+    });
+}
+test('win32: operating allowlist matches native mixed-case spellings', () => {
+    const env = buildChildEnv({}, {
+        Path: 'C:\\Windows', SystemRoot: 'C:\\Windows', ComSpec: 'C:\\Windows\\System32\\cmd.exe',
+        Https_Proxy: 'http://proxy.example', Requests_CA_Bundle: 'C:\\internal.pem',
+        lc_ctype: 'UTF-8', OpenAI_Api_Key: 'host-secret',
+    }, 'win32');
+    assert.deepEqual(env, {
+        Path: 'C:\\Windows', SystemRoot: 'C:\\Windows', ComSpec: 'C:\\Windows\\System32\\cmd.exe',
+        Https_Proxy: 'http://proxy.example', Requests_CA_Bundle: 'C:\\internal.pem', lc_ctype: 'UTF-8',
+    });
+});
+test('win32: sorted-first spelling wins within each source regardless of insertion order', () => {
+    for (const reverse of [false, true]) {
+        const hostEntries = [['https_proxy', 'http://lower-host.example'], ['HTTPS_PROXY', 'http://upper-host.example']];
+        const declaredEntries = [['https_proxy', 'http://lower-declared.example'], ['HTTPS_PROXY', '']];
+        const host = Object.fromEntries(reverse ? hostEntries.reverse() : hostEntries);
+        const declared = Object.fromEntries(reverse ? declaredEntries.reverse() : declaredEntries);
+        for (const inheritEnv of [false, true]) {
+            assert.deepEqual(buildChildEnv({ inheritEnv }, host, 'win32'), { HTTPS_PROXY: 'http://upper-host.example' });
+            assert.deepEqual(buildChildEnv({ inheritEnv, env: declared }, host, 'win32'), { HTTPS_PROXY: '' });
+            assert.deepEqual(buildChildEnv({ inheritEnv, env: { https_proxy: '' } }, host, 'win32'), { https_proxy: '' }, 'declared source still outranks every host spelling');
+        }
+    }
+});
+test('posix: differently cased host and declared keys remain distinct', () => {
+    for (const inheritEnv of [false, true]) {
+        const env = buildChildEnv({ inheritEnv, env: { https_proxy: '' } }, {
+            HTTPS_PROXY: 'http://host.example', Path: '/mixed-case', PATH: '/usr/bin',
+        }, 'linux');
+        assert.equal(env.HTTPS_PROXY, 'http://host.example');
+        assert.equal(env.https_proxy, '');
+        assert.equal(env.PATH, '/usr/bin');
+        assert.equal(env.Path, inheritEnv ? '/mixed-case' : undefined);
+    }
+});
+//# sourceMappingURL=mcpl-child-env.test.js.map

package/dist/test/mcpl-child-env.test.js.map

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

package/dist/test/mcpl-coalescing.test.d.ts

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

package/dist/test/mcpl-coalescing.test.d.ts.map

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