@animalabs/agent-framework 0.5.4 → 0.5.7

package/dist/test/tool-result-history.test.js

@@ -0,0 +1,77 @@
+/**
+ * Unit tests for the tool-result history serializer.
+ *
+ * Run: node --import tsx --test test/tool-result-history.test.ts
+ */
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { toolResultDataToHistoryString } from '../src/tool-result-history.js';
+test('text-only MCP content array: blocks join with newlines', () => {
+    const data = [
+        { type: 'text', text: 'first' },
+        { type: 'text', text: 'second' },
+    ];
+    assert.equal(toolResultDataToHistoryString(data), 'first\nsecond');
+});
+test('image block becomes placeholder, not base64', () => {
+    // 1MB of base64 = ~750KB of decoded bytes
+    const fakeBase64 = 'A'.repeat(1024 * 1024);
+    const data = [
+        { type: 'text', text: 'Fetched x.png:' },
+        { type: 'image', data: fakeBase64, mimeType: 'image/png' },
+    ];
+    const out = toolResultDataToHistoryString(data);
+    assert.ok(out.includes('Fetched x.png:'));
+    assert.ok(out.includes('[image: image/png,'));
+    assert.ok(!out.includes(fakeBase64), 'base64 payload must NOT appear in history string');
+    assert.ok(out.length < 200, `expected small string, got ${out.length} chars`);
+});
+test('size formatter: bytes / KB / MB', () => {
+    const tiny = toolResultDataToHistoryString([{ type: 'image', data: 'A'.repeat(16), mimeType: 'image/png' }]);
+    assert.match(tiny, /\[image: image\/png, \d+B\]/);
+    const kb = toolResultDataToHistoryString([{ type: 'image', data: 'A'.repeat(10 * 1024), mimeType: 'image/png' }]);
+    assert.match(kb, /\[image: image\/png, ~\d+KB\]/);
+    const mb = toolResultDataToHistoryString([{ type: 'image', data: 'A'.repeat(2 * 1024 * 1024), mimeType: 'image/png' }]);
+    assert.match(mb, /\[image: image\/png, ~\d+\.\d+MB\]/);
+});
+test('unknown block shape falls back to JSON', () => {
+    const data = [{ type: 'mystery', payload: 42 }];
+    assert.equal(toolResultDataToHistoryString(data), JSON.stringify(data));
+});
+test('mixed known + unknown block shape falls back to JSON (all-or-nothing)', () => {
+    const data = [
+        { type: 'text', text: 'fine' },
+        { type: 'audio', data: 'XX', mimeType: 'audio/mpeg' },
+    ];
+    assert.equal(toolResultDataToHistoryString(data), JSON.stringify(data));
+});
+test('non-array data: JSON stringify', () => {
+    assert.equal(toolResultDataToHistoryString({ ok: true }), '{"ok":true}');
+    assert.equal(toolResultDataToHistoryString('hello'), '"hello"');
+    assert.equal(toolResultDataToHistoryString(42), '42');
+    assert.equal(toolResultDataToHistoryString(undefined), undefined); // JSON.stringify(undefined) === undefined
+});
+test('maxChars truncates the resulting string with a marker', () => {
+    const data = [{ type: 'text', text: 'a'.repeat(1000) }];
+    const out = toolResultDataToHistoryString(data, 100);
+    assert.ok(out.length < 1000);
+    assert.match(out, /\[truncated — original was \d+ chars\]/);
+});
+test('maxChars does NOT truncate the placeholder itself (image is summarized, not chopped)', () => {
+    // 4MB of base64 → ~3MB decoded, comfortably across the MB threshold.
+    const fakeBase64 = 'A'.repeat(4 * 1024 * 1024);
+    const data = [{ type: 'image', data: fakeBase64, mimeType: 'image/png' }];
+    const out = toolResultDataToHistoryString(data, 50_000);
+    // The placeholder is ~30 chars regardless of input size; maxChars=50_000 leaves it untouched.
+    assert.match(out, /\[image: image\/png, ~\d+\.\d+MB\]/);
+    assert.ok(!out.includes('truncated'));
+    assert.ok(out.length < 100);
+});
+test('null entry in array falls back to JSON', () => {
+    const data = [{ type: 'text', text: 'x' }, null];
+    assert.equal(toolResultDataToHistoryString(data), JSON.stringify(data));
+});
+test('empty array: empty string', () => {
+    assert.equal(toolResultDataToHistoryString([]), '');
+});
+//# sourceMappingURL=tool-result-history.test.js.map

package/dist/test/tool-result-history.test.js.map

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