@animalabs/agent-framework 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/src/framework.d.ts.map +1 -1
  2. package/dist/src/framework.js +6 -0
  3. package/dist/src/framework.js.map +1 -1
  4. package/dist/src/mcpl/conversation-router.d.ts +8 -6
  5. package/dist/src/mcpl/conversation-router.d.ts.map +1 -1
  6. package/dist/src/mcpl/conversation-router.js +12 -6
  7. package/dist/src/mcpl/conversation-router.js.map +1 -1
  8. package/dist/src/mcpl/references.d.ts.map +1 -1
  9. package/dist/src/mcpl/references.js +9 -4
  10. package/dist/src/mcpl/references.js.map +1 -1
  11. package/dist/src/mcpl/tool-lifecycle.d.ts +1 -1
  12. package/dist/src/mcpl/tool-lifecycle.d.ts.map +1 -1
  13. package/dist/src/mcpl/tool-lifecycle.js +19 -4
  14. package/dist/src/mcpl/tool-lifecycle.js.map +1 -1
  15. package/dist/src/mcpl/transport.d.ts +7 -4
  16. package/dist/src/mcpl/transport.d.ts.map +1 -1
  17. package/dist/src/mcpl/transport.js +45 -13
  18. package/dist/src/mcpl/transport.js.map +1 -1
  19. package/dist/src/mcpl/types.d.ts +3 -1
  20. package/dist/src/mcpl/types.d.ts.map +1 -1
  21. package/dist/src/mcpl/types.js.map +1 -1
  22. package/dist/test/conversation-router.test.js +33 -19
  23. package/dist/test/conversation-router.test.js.map +1 -1
  24. package/dist/test/conversation-routing.test.js +89 -0
  25. package/dist/test/conversation-routing.test.js.map +1 -1
  26. package/dist/test/mcpl-child-env.test.js +89 -0
  27. package/dist/test/mcpl-child-env.test.js.map +1 -1
  28. package/dist/test/mcpl-reference-fields.test.d.ts +2 -0
  29. package/dist/test/mcpl-reference-fields.test.d.ts.map +1 -0
  30. package/dist/test/mcpl-reference-fields.test.js +82 -0
  31. package/dist/test/mcpl-reference-fields.test.js.map +1 -0
  32. package/dist/test/tools-observe-parser-conformance.test.d.ts +2 -0
  33. package/dist/test/tools-observe-parser-conformance.test.d.ts.map +1 -0
  34. package/dist/test/tools-observe-parser-conformance.test.js +129 -0
  35. package/dist/test/tools-observe-parser-conformance.test.js.map +1 -0
  36. package/dist/tsconfig.tsbuildinfo +1 -1
  37. package/package.json +2 -2
  38. package/src/framework.ts +6 -0
  39. package/src/mcpl/conversation-router.ts +12 -8
  40. package/src/mcpl/references.ts +11 -3
  41. package/src/mcpl/tool-lifecycle.ts +19 -4
  42. package/src/mcpl/transport.ts +41 -9
  43. package/src/mcpl/types.ts +3 -1
@@ -0,0 +1,82 @@
1
+ import { test } from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import { buildReferenceStub, classifyBlock, isReferenceExpired, REFERENCE_LIMITS, referenceRegistry, referenceStubOrNull, } from '../src/mcpl/references.js';
4
+ const fields = ['name', 'mimeType', 'expiresAt'];
5
+ const types = ['resource', 'image', 'audio'];
6
+ function reference(type, extra = {}) {
7
+ const block = { type, uri: 'https://example.test/optional-fields', disposition: 'never', ...extra };
8
+ const parsed = classifyBlock(block);
9
+ assert.equal(parsed.kind, 'reference');
10
+ if (parsed.kind !== 'reference')
11
+ throw new Error('expected reference');
12
+ return { block, testimony: parsed.testimony };
13
+ }
14
+ for (const field of fields) {
15
+ test('drops overlong optional ' + field + ' while preserving each reference block and disposition', () => {
16
+ for (const type of types) {
17
+ const { block, testimony } = reference(type, { [field]: 'x'.repeat(REFERENCE_LIMITS[field] + 1) });
18
+ assert.equal(testimony[field], undefined, 'invalid optional metadata is absent, not repaired');
19
+ assert.deepEqual(testimony.rejectedFields, [field]);
20
+ assert.deepEqual(testimony.truncatedFields, []);
21
+ assert.equal(testimony.uri, block.uri);
22
+ assert.equal(testimony.disposition, 'never');
23
+ assert.ok(referenceStubOrNull(block)?.startsWith('[ref_'));
24
+ assert.ok(!referenceStubOrNull(block)?.includes(block.uri));
25
+ }
26
+ });
27
+ test('admits ' + field + ' exactly at its JSON Schema code-point limit without changing it', () => {
28
+ for (const value of ['', 'x'.repeat(REFERENCE_LIMITS[field]), 'ðŸŠķ'.repeat(REFERENCE_LIMITS[field])]) {
29
+ const { testimony } = reference('resource', { [field]: value });
30
+ assert.equal(testimony[field], value);
31
+ assert.deepEqual(testimony.rejectedFields, []);
32
+ assert.deepEqual(testimony.truncatedFields, []);
33
+ }
34
+ const { testimony } = reference('resource', { [field]: 'ðŸŠķ'.repeat(REFERENCE_LIMITS[field]) + 'x' });
35
+ assert.equal(testimony[field], undefined);
36
+ assert.deepEqual(testimony.rejectedFields, [field]);
37
+ });
38
+ }
39
+ test('wrong-type optional fields are dropped while a bad required URI rejects the block', () => {
40
+ const { testimony } = reference('resource', { name: 123, mimeType: null, expiresAt: [] });
41
+ assert.equal(testimony.name, undefined);
42
+ assert.equal(testimony.mimeType, undefined);
43
+ assert.equal(testimony.expiresAt, undefined);
44
+ assert.deepEqual(testimony.rejectedFields.sort(), ['expiresAt', 'mimeType', 'name']);
45
+ assert.equal(testimony.disposition, 'never');
46
+ for (const uri of [undefined, null, '', 'x'.repeat(REFERENCE_LIMITS.uri + 1)]) {
47
+ assert.equal(classifyBlock({ type: 'resource', uri, disposition: 'never' }).kind, 'invalid');
48
+ }
49
+ });
50
+ test('schema-admitted metadata still uses independent sanitized and bounded display labels', () => {
51
+ const name = 'A'.repeat(REFERENCE_LIMITS.name - 2) + '\u202E\n';
52
+ const mimeType = 'B'.repeat(REFERENCE_LIMITS.mimeType);
53
+ const { testimony } = reference('resource', { name, mimeType });
54
+ const stub = buildReferenceStub(testimony);
55
+ const record = referenceRegistry.findByUri(testimony.uri);
56
+ assert.equal(record.testimony.name, name, 'display bounds do not alter admitted testimony');
57
+ assert.equal(record.testimony.mimeType, mimeType);
58
+ assert.ok(stub.includes('A'.repeat(119) + 'â€Ķ'));
59
+ assert.ok(stub.includes('B'.repeat(119) + 'â€Ķ'));
60
+ assert.ok(!stub.includes('\u202E') && !stub.includes('\n'));
61
+ assert.ok(!stub.includes(testimony.uri));
62
+ assert.ok(stub.length < 350);
63
+ });
64
+ test('an admitted but unparseable expiry still fails closed; schema-invalid expiry is absent', () => {
65
+ const validShape = reference('resource', { expiresAt: 'not-a-date' }).testimony;
66
+ assert.equal(isReferenceExpired(validShape), true);
67
+ const invalidShape = reference('resource', { expiresAt: 'x'.repeat(REFERENCE_LIMITS.expiresAt + 1) }).testimony;
68
+ assert.equal(invalidShape.expiresAt, undefined);
69
+ assert.deepEqual(invalidShape.rejectedFields, ['expiresAt']);
70
+ });
71
+ test('large invalid labels cannot change the bounded model-visible stub', () => {
72
+ const { testimony } = reference('audio', {
73
+ name: 'x'.repeat(1024 * 1024), mimeType: 'y'.repeat(1024 * 1024), sizeBytes: 1024,
74
+ });
75
+ assert.equal(testimony.name, undefined);
76
+ assert.equal(testimony.mimeType, undefined);
77
+ const stub = buildReferenceStub(testimony, 'server');
78
+ assert.ok(stub.length < 150);
79
+ assert.ok(stub.includes('claimed'));
80
+ assert.ok(!stub.includes(testimony.uri));
81
+ });
82
+ //# sourceMappingURL=mcpl-reference-fields.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcpl-reference-fields.test.js","sourceRoot":"","sources":["../../test/mcpl-reference-fields.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=tools-observe-parser-conformance.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools-observe-parser-conformance.test.d.ts","sourceRoot":"","sources":["../../test/tools-observe-parser-conformance.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,129 @@
1
+ /**
2
+ * RFC-007 §6.1/6.6 and §13: strict object admission, Unicode code-point
3
+ * bounds, and filter preservation through the real connection responder.
4
+ */
5
+ import { test } from 'node:test';
6
+ import assert from 'node:assert/strict';
7
+ import { AgentFramework } from '../src/framework.js';
8
+ import { McplServerConnection } from '../src/mcpl/server-connection.js';
9
+ import { McplTransport } from '../src/mcpl/transport.js';
10
+ import { CapabilityGrant } from '../src/mcpl/capability-grant.js';
11
+ import { parseToolObserveParams, TOOL_OBSERVE_LIMITS } from '../src/mcpl/tool-lifecycle.js';
12
+ const LIMIT = TOOL_OBSERVE_LIMITS.stringLength;
13
+ const PATTERN_KEYS = ['tool', 'serverTool', 'serverId', 'conversationId'];
14
+ test('explicit null params are invalid; omitted params and rules:null retain clear semantics', () => {
15
+ assert.equal(parseToolObserveParams(null).ok, false);
16
+ for (const params of [undefined, {}, { rules: null }, { _meta: {} }]) {
17
+ assert.deepEqual(parseToolObserveParams(params), { ok: true, rules: null });
18
+ }
19
+ assert.deepEqual(parseToolObserveParams({ rules: [] }), { ok: true, rules: [] });
20
+ });
21
+ test('_meta must be an object before clearing, pausing, or replacing a filter', () => {
22
+ for (const _meta of [null, [], 'scalar', 7, false]) {
23
+ for (const params of [
24
+ { _meta },
25
+ { _meta, rules: null },
26
+ { _meta, rules: [] },
27
+ { _meta, rules: [{ match: {} }] },
28
+ ]) {
29
+ assert.equal(parseToolObserveParams(params).ok, false, JSON.stringify(params));
30
+ }
31
+ }
32
+ assert.deepEqual(parseToolObserveParams({
33
+ _meta: { 'trace/example': { nested: [null, 'valid metadata'] } }, rules: [],
34
+ }), { ok: true, rules: [] });
35
+ });
36
+ for (const key of PATTERN_KEYS) {
37
+ test(key + ' uses the RFC schema code-point limit, preserving exact pattern text', () => {
38
+ for (const value of ['🙂'.repeat(LIMIT), 'x'.repeat(LIMIT - 2) + 'e\u0301']) {
39
+ const parsed = parseToolObserveParams({ rules: [{ match: { [key]: value } }] });
40
+ assert.ok(parsed.ok);
41
+ assert.equal(parsed.rules?.[0]?.match[key], value);
42
+ const over = parseToolObserveParams({ rules: [{ match: { [key]: value + '🙂' } }] });
43
+ assert.equal(over.ok, false);
44
+ assert.deepEqual(!over.ok && over.data, { limit: 'stringLength' });
45
+ }
46
+ });
47
+ }
48
+ test('input paths use code points and preserve content while rejecting empty/over-limit paths', () => {
49
+ for (const path of ['🙂'.repeat(LIMIT), 'e\u0301'.repeat(LIMIT / 2)]) {
50
+ const parsed = parseToolObserveParams({ rules: [{ match: {}, input: [path] }] });
51
+ assert.ok(parsed.ok);
52
+ assert.deepEqual(parsed.rules?.[0]?.input, [path]);
53
+ const over = parseToolObserveParams({ rules: [{ match: {}, input: [path + 'x'] }] });
54
+ assert.equal(over.ok, false);
55
+ assert.deepEqual(!over.ok && over.data, { limit: 'stringLength' });
56
+ }
57
+ assert.equal(parseToolObserveParams({ rules: [{ match: {}, input: [''] }] }).ok, false);
58
+ });
59
+ class RecordingTransport extends McplTransport {
60
+ constructor() { super(); }
61
+ kind = 'stdio';
62
+ lines = [];
63
+ writeLine(line) { this.lines.push(line); }
64
+ async close() { }
65
+ }
66
+ function wireHarness() {
67
+ const transport = new RecordingTransport();
68
+ // The public connection factory needs a live peer. Here the real connection
69
+ // routes JSON requests and serializes responses on a recording transport.
70
+ const Connection = McplServerConnection;
71
+ const connection = new Connection('observer', null, transport);
72
+ const framework = Object.create(AgentFramework.prototype);
73
+ framework.wireMcplEvents(connection);
74
+ connection.establishGrant(new CapabilityGrant(new Set(['toolLifecycle.observe']), []));
75
+ connection.ready();
76
+ let nextId = 1;
77
+ return {
78
+ connection,
79
+ request(params) {
80
+ const id = nextId++;
81
+ const before = transport.lines.length;
82
+ transport.emit('line', JSON.stringify({
83
+ jsonrpc: '2.0', id, method: 'tools/observe',
84
+ ...(params === undefined ? {} : { params }),
85
+ }));
86
+ assert.equal(transport.lines.length, before + 1, 'exactly one reply per request');
87
+ const response = JSON.parse(transport.lines.at(-1));
88
+ assert.equal(response.id, id);
89
+ return response;
90
+ },
91
+ };
92
+ }
93
+ test('wire rejection leaves a restrictive filter in force; valid omitted/null-rules clears still work', () => {
94
+ const { connection, request } = wireHarness();
95
+ const restrictive = { rules: [{ match: { tool: 'allowed--*' }, report: false }] };
96
+ assert.deepEqual(request(restrictive).result, {});
97
+ const prior = connection.toolObserveFilter;
98
+ for (const params of [null, { _meta: null }, { _meta: [], rules: null }, { _meta: 'bad', rules: [] }]) {
99
+ assert.equal(request(params).error.code, -32602);
100
+ assert.equal(connection.toolObserveFilter, prior, 'invalid params cannot clear or replace the filter');
101
+ }
102
+ for (const params of [undefined, {}, { rules: null }, { _meta: { source: 'test' }, rules: null }]) {
103
+ assert.deepEqual(request(params).result, {});
104
+ assert.equal(connection.toolObserveFilter, null);
105
+ assert.deepEqual(request(restrictive).result, {});
106
+ }
107
+ assert.deepEqual(request({ rules: [], _meta: {} }).result, {});
108
+ assert.deepEqual(connection.toolObserveFilter, []);
109
+ });
110
+ test('wire accepts the Unicode boundary and rejects over-limit replacement without changing the filter', () => {
111
+ const { connection, request } = wireHarness();
112
+ const value = '🙂'.repeat(LIMIT);
113
+ const match = Object.fromEntries(PATTERN_KEYS.map((key) => [key, value]));
114
+ assert.deepEqual(request({ rules: [{ match, input: [value] }] }).result, {});
115
+ const prior = connection.toolObserveFilter;
116
+ assert.deepEqual(prior, [{ match, report: true, input: [value] }]);
117
+ const rejected = request({ rules: [{ match: {}, input: [value + '🙂'] }] });
118
+ assert.equal(rejected.error.code, -32602);
119
+ assert.deepEqual(rejected.error.data, { limit: 'stringLength' });
120
+ assert.equal(connection.toolObserveFilter, prior);
121
+ });
122
+ test('wire capability denial remains ahead of malformed params admission', () => {
123
+ const { connection, request } = wireHarness();
124
+ connection.establishGrant(new CapabilityGrant(new Set(), []));
125
+ const result = request(null);
126
+ assert.equal(result.error.code, -32002);
127
+ assert.equal(connection.toolObserveFilter, null);
128
+ });
129
+ //# sourceMappingURL=tools-observe-parser-conformance.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools-observe-parser-conformance.test.js","sourceRoot":"","sources":["../../test/tools-observe-parser-conformance.test.ts"],"names":[],"mappings":"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"}