@animalabs/agent-framework 0.6.0 → 0.6.3

package/dist/test/state-scaling-e2e.test.js

@@ -0,0 +1,200 @@
+/**
+ * Whole-store scaling sweep (scaling campaign Finding 2, end-to-end gate).
+ *
+ * The unit gates in state-scaling.test.ts pin the four known writers by
+ * calling them directly. This test validates the REGIME instead: it drives a
+ * synthetic workload through the framework's public surface — external
+ * messages with tool rounds, ephemeral spawn-and-dispose cycles, process
+ * logging on — then sweeps EVERY state family the store accumulated and
+ * asserts none of them grows superlinearly. A quadratic writer added anywhere
+ * (the way logProcessEvent silently duplicated logInference's bug) fails this
+ * test the day it's introduced, without anyone having to know to test it.
+ *
+ * Family classification:
+ *   - capped families (per-agent turn-checkpoint slots) legitimately ramp to
+ *     a fixed cap and plateau — small-N slope fits are noisy on that shape
+ *     (a ramp-heavy window fits as "rising"), so they get a hard max-record-
+ *     size bound instead, which is the stronger invariant anyway.
+ *   - everything else with enough records gets a log-log slope fit of
+ *     bytes-per-record vs index; flat ≈ healthy, ≈1 ≈ quadratic aggregate.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { tmpdir } from 'node:os';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { AgentFramework } from '../src/index.js';
+import { MockMembrane, createMockResponse } from './helpers/mock-membrane.js';
+const SLOPE_LIMIT = 0.3;
+const MIN_RECORDS_FOR_FIT = 8;
+/** Bounded-by-design families get a hard per-record ceiling instead of a
+ *  slope fit: the checkpoint tree's ops are O(key) and its periodic
+ *  consolidation snapshots are O(live keys) — both far under this, while a
+ *  whole-map rewrite under fleet load blows past it. */
+const CAPPED_MAX_RECORD_BYTES = 16 * 1024;
+const CAPPED_FAMILIES = [/^framework\/turn-checkpoints\//];
+/** OLS slope of ln(bytes) on ln(index) — same fit latency.mjs uses. */
+function logLogSlope(sizes) {
+    const pts = sizes.map((y, i) => ({ x: i + 1, y })).filter((p) => p.y > 0);
+    const lx = pts.map((p) => Math.log(p.x));
+    const ly = pts.map((p) => Math.log(p.y));
+    const mx = lx.reduce((a, b) => a + b, 0) / lx.length;
+    const my = ly.reduce((a, b) => a + b, 0) / ly.length;
+    let num = 0, den = 0;
+    for (let i = 0; i < lx.length; i++) {
+        num += (lx[i] - mx) * (ly[i] - my);
+        den += (lx[i] - mx) ** 2;
+    }
+    return den === 0 ? 0 : num / den;
+}
+/** All state_update payload sizes in append order, grouped by state id. */
+function sweepStateFamilies(store) {
+    const families = new Map();
+    for (const id of store.getRecordIdsByType('state_update')) {
+        const record = store.getRecord(id);
+        if (!record)
+            continue;
+        const update = JSON.parse(record.payload.toString());
+        let sizes = families.get(update.state_id);
+        if (!sizes)
+            families.set(update.state_id, (sizes = []));
+        sizes.push(record.payload.length);
+    }
+    return families;
+}
+/** Minimal module providing one tool, so turns exercise real tool rounds. */
+class EchoModule {
+    name = 'echo';
+    async start(_ctx) { }
+    async stop() { }
+    getTools() {
+        return [{
+                name: 'echo',
+                description: 'Echo the input back',
+                inputSchema: { type: 'object', properties: { message: { type: 'string' } } },
+            }];
+    }
+    async handleToolCall(call) {
+        return { success: true, data: call.input.message ?? '' };
+    }
+    async onProcess(event, _state) {
+        if (event.type === 'external-message') {
+            return {
+                addMessages: [{
+                        participant: 'User',
+                        content: [{ type: 'text', text: String(event.content) }],
+                    }],
+                requestInference: true,
+            };
+        }
+        return {};
+    }
+}
+describe('whole-store scaling sweep (e2e)', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'af-scaling-e2e-'));
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('no state family grows superlinearly under a synthetic fleet workload', async () => {
+        const membrane = new MockMembrane();
+        const framework = await AgentFramework.create({
+            storePath: join(tempDir, 'e2e.chronicle'),
+            membrane: membrane.asMembrane(),
+            agents: [{ name: 'assistant', model: 'test-model', systemPrompt: 'You are a test assistant.' }],
+            modules: [new EchoModule()],
+            // Exercise the process log — it's registered append_log and had the
+            // same Set-rewrite bug as the inference log.
+            processLogging: { persist: true },
+        });
+        // Phase 1: persistent-agent turns, each with one tool round. Every turn
+        // writes: turn checkpoint, process log entries, inference log entry,
+        // message appends — the production write set.
+        const TURNS = 40;
+        for (let t = 0; t < TURNS; t++) {
+            membrane.pushResponse(createMockResponse([
+                { type: 'text', text: `Working on request ${t}.` },
+                { type: 'tool_use', id: `call-${t}`, name: 'echo--echo', input: { message: `payload ${t}` } },
+            ], 'tool_use'));
+            membrane.pushResponse(createMockResponse([
+                { type: 'text', text: `Done with request ${t}.` },
+            ]));
+            framework.pushEvent({
+                type: 'external-message',
+                source: 'e2e',
+                content: `Request number ${t}, please handle it.`,
+                metadata: {},
+            });
+            await framework.runUntilIdle();
+        }
+        // Phase 2: spawn-and-dispose ephemeral agents — the fleet regime that
+        // grew the old checkpoint map without bound.
+        const SPAWNS = 12;
+        for (let s = 0; s < SPAWNS; s++) {
+            membrane.pushResponse(createMockResponse([
+                { type: 'text', text: `Scout ${s} reporting: nothing to see.` },
+            ]));
+            const { agent, contextManager, cleanup } = await framework.createEphemeralAgent({
+                name: `e2e-scout-${s}`,
+                model: 'test-model',
+                systemPrompt: 'You are a scout.',
+            });
+            contextManager.addMessage('user', [{ type: 'text', text: `Scout task ${s}` }]);
+            const run = framework.runEphemeralToCompletion(agent, contextManager);
+            await framework.runUntilIdle();
+            await run;
+            cleanup();
+        }
+        const store = framework.getStore();
+        const families = sweepStateFamilies(store);
+        // The workload must actually have exercised the families this test
+        // exists to watch — otherwise a routing change could green-wash it.
+        const inferenceLog = families.get('framework/inference-log') ?? [];
+        const processLog = families.get('framework/process-log') ?? [];
+        assert.ok(inferenceLog.length >= TURNS, `inference log exercised (${inferenceLog.length} records)`);
+        assert.ok(processLog.length >= TURNS, `process log exercised (${processLog.length} records)`);
+        const checkpointTree = families.get('framework/turn-checkpoints/tree') ?? [];
+        assert.ok(checkpointTree.length >= TURNS + SPAWNS, `checkpoint tree exercised (${checkpointTree.length} records)`);
+        // Disposal actually removed the scouts' keys — the tree stays O(live
+        // agents), and no per-agent state registration leaked into chronicle's
+        // state index (which is rewritten + fsynced on every sync tick).
+        for (let s = 0; s < SPAWNS; s++) {
+            assert.strictEqual(store.treeGet('framework/turn-checkpoints/tree', `e2e-scout-${s}`), null, `disposed scout ${s} evicted from checkpoint tree`);
+        }
+        assert.ok(store.treeGet('framework/turn-checkpoints/tree', 'assistant'), 'persistent agent keeps its checkpoints');
+        const stateCount = store.listStates().length;
+        const checkpointStates = store.listStates().filter((s) => s.id.startsWith('framework/turn-checkpoints')).length;
+        assert.strictEqual(checkpointStates, 1, `exactly one checkpoint state registered (index has ${stateCount} states total)`);
+        // The sweep: every family, classified, no exemptions beyond the rules —
+        // and no silent caps: families too small for a slope fit are listed.
+        const violations = [];
+        const skipped = [];
+        for (const [stateId, sizes] of families) {
+            if (CAPPED_FAMILIES.some((re) => re.test(stateId))) {
+                const max = Math.max(...sizes);
+                if (max > CAPPED_MAX_RECORD_BYTES) {
+                    violations.push(`${stateId}: capped family record hit ${max} B (limit ${CAPPED_MAX_RECORD_BYTES})`);
+                }
+                continue;
+            }
+            if (sizes.length < MIN_RECORDS_FOR_FIT) {
+                skipped.push(`${stateId} (${sizes.length})`);
+                continue;
+            }
+            const slope = logLogSlope(sizes);
+            if (slope >= SLOPE_LIMIT) {
+                violations.push(`${stateId}: bytes/record slope ${slope.toFixed(2)} over ${sizes.length} records ` +
+                    `(${sizes[0]} B → ${sizes[sizes.length - 1]} B) — superlinear growth`);
+            }
+        }
+        if (skipped.length > 0) {
+            console.log(`[state-scaling-e2e] ${skipped.length} families below the ${MIN_RECORDS_FOR_FIT}-record fit threshold ` +
+                `(unaudited by the slope gate): ${skipped.join(', ')}`);
+        }
+        assert.deepStrictEqual(violations, [], `superlinear state families:\n  ${violations.join('\n  ')}`);
+        await framework.stop();
+    });
+});
+//# sourceMappingURL=state-scaling-e2e.test.js.map

package/dist/test/state-scaling-e2e.test.js.map

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

package/dist/test/state-scaling.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Regression gates for the set-rewrite quadratic-states fixes (2026-07-08
+ * scaling campaign, Finding 2): persisted record size must be independent of
+ * accumulated content.
+ *
+ * Families covered:
+ *   - framework/inference-log        — appended, not Set-rewritten
+ *   - framework/turn-checkpoints/*   — per-agent slots, not one global map
+ *   - modules/<name>/<log>           — ModuleContext log-state API
+ */
+export {};
+//# sourceMappingURL=state-scaling.test.d.ts.map

package/dist/test/state-scaling.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-scaling.test.d.ts","sourceRoot":"","sources":["../../test/state-scaling.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/test/state-scaling.test.js

@@ -0,0 +1,243 @@
+/**
+ * Regression gates for the set-rewrite quadratic-states fixes (2026-07-08
+ * scaling campaign, Finding 2): persisted record size must be independent of
+ * accumulated content.
+ *
+ * Families covered:
+ *   - framework/inference-log        — appended, not Set-rewritten
+ *   - framework/turn-checkpoints/*   — per-agent slots, not one global map
+ *   - modules/<name>/<log>           — ModuleContext log-state API
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { tmpdir } from 'node:os';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { JsStore } from '@animalabs/chronicle';
+import { AgentFramework } from '../src/index.js';
+import { MockMembrane } from './helpers/mock-membrane.js';
+const INFERENCE_LOG_ID = 'framework/inference-log';
+const TURN_CHECKPOINTS_ID = 'framework/turn-checkpoints';
+const TURN_CHECKPOINTS_TREE_ID = 'framework/turn-checkpoints/tree';
+/**
+ * Payload sizes of all state_update records for states matching `match`,
+ * in append order.
+ */
+function stateUpdateSizes(store, match) {
+    const sizes = [];
+    for (const id of store.getRecordIdsByType('state_update')) {
+        const record = store.getRecord(id);
+        if (!record)
+            continue;
+        const update = JSON.parse(record.payload.toString());
+        if (match(update.state_id))
+            sizes.push(record.payload.length);
+    }
+    return sizes;
+}
+/** Assert the record family isn't growing: last record ≈ first record. */
+function assertFlat(sizes, label, tolerance = 1.5) {
+    assert.ok(sizes.length >= 2, `${label}: expected ≥2 records, got ${sizes.length}`);
+    const first = sizes[0];
+    const last = sizes[sizes.length - 1];
+    assert.ok(last <= first * tolerance, `${label}: record size grew ${first} → ${last} bytes over ${sizes.length} records — ` +
+        `looks like accumulated content is being rewritten per update`);
+}
+describe('state scaling regression gates', () => {
+    let tempDir;
+    let membrane;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'af-state-scaling-'));
+        membrane = new MockMembrane();
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    async function createFramework(storePath) {
+        return AgentFramework.create({
+            storePath,
+            membrane: membrane.asMembrane(),
+            agents: [{ name: 'assistant', model: 'test-model', systemPrompt: 'test' }],
+            modules: [],
+        });
+    }
+    it('inference log: Nth record size is independent of N', async () => {
+        const storePath = join(tempDir, 'inference.chronicle');
+        const framework = await createFramework(storePath);
+        const store = framework.getStore();
+        const N = 30;
+        for (let i = 0; i < N; i++) {
+            framework.logInference({
+                timestamp: Date.now(),
+                agentName: 'assistant',
+                requestId: `req-${i}`,
+                success: true,
+                durationMs: 100,
+                request: { i },
+                response: { ok: true },
+            });
+        }
+        const entries = store.getStateJson(INFERENCE_LOG_ID);
+        assert.strictEqual(entries.length, N, 'all entries readable back');
+        const sizes = stateUpdateSizes(store, (id) => id === INFERENCE_LOG_ID);
+        assertFlat(sizes, INFERENCE_LOG_ID);
+        await framework.stop();
+    });
+    it('inference log: appends compose with a legacy Set-written array', async () => {
+        const storePath = join(tempDir, 'legacy-log.chronicle');
+        // Write the state the old way: whole-array Set, as pre-fix stores did.
+        {
+            const store = JsStore.openOrCreate({ path: storePath });
+            store.registerState({
+                id: INFERENCE_LOG_ID,
+                strategy: 'append_log',
+                deltaSnapshotEvery: 100,
+                fullSnapshotEvery: 20,
+            });
+            store.setStateJson(INFERENCE_LOG_ID, [
+                { timestamp: 1, agentName: 'old', requestId: 'legacy-0', success: true },
+                { timestamp: 2, agentName: 'old', requestId: 'legacy-1', success: false },
+            ]);
+            store.close();
+        }
+        const framework = await createFramework(storePath);
+        framework.logInference({
+            timestamp: 3,
+            agentName: 'assistant',
+            requestId: 'new-0',
+            success: true,
+            durationMs: 5,
+        });
+        const entries = framework.getStore().getStateJson(INFERENCE_LOG_ID);
+        assert.strictEqual(entries.length, 3);
+        assert.strictEqual(entries[0].requestId, 'legacy-0');
+        assert.strictEqual(entries[2].requestId, 'new-0');
+        await framework.stop();
+    });
+    it('turn checkpoints: record size and state count independent of agents-ever-spawned', async () => {
+        const storePath = join(tempDir, 'checkpoints.chronicle');
+        const framework = await createFramework(storePath);
+        const store = framework.getStore();
+        // M spawn-and-dispose subagents, several turns each.
+        const M = 25;
+        for (let m = 0; m < M; m++) {
+            const name = `spawn-task-d1-${1000 + m}`;
+            for (let turn = 0; turn < 3; turn++) {
+                framework.recordTurnCheckpoint(name);
+            }
+            framework.evictTurnCheckpoints(name);
+        }
+        // A persistent agent keeps taking turns throughout.
+        for (let turn = 0; turn < 5; turn++) {
+            framework.recordTurnCheckpoint('assistant');
+        }
+        // Every write is one tree op (path + blob hash): flat across the whole
+        // run even though M unique agents came and went.
+        const sizes = stateUpdateSizes(store, (id) => id === TURN_CHECKPOINTS_TREE_ID);
+        assertFlat(sizes, TURN_CHECKPOINTS_TREE_ID, 4);
+        // Disposal removed the key outright — the tree holds only live agents...
+        for (let m = 0; m < M; m++) {
+            assert.strictEqual(store.treeGet(TURN_CHECKPOINTS_TREE_ID, `spawn-task-d1-${1000 + m}`), null, 'disposed agent key removed from checkpoint tree');
+        }
+        assert.strictEqual(framework.getTurnCheckpoints('assistant').length, 5);
+        // ...and no per-agent state registration leaked into the state index —
+        // chronicle has no deregistration and rewrites + fsyncs the index on
+        // every sync tick, so index entries must not scale with spawns-ever.
+        const checkpointStates = store.listStates().filter((s) => s.id.startsWith(TURN_CHECKPOINTS_ID));
+        assert.strictEqual(checkpointStates.length, 1, 'exactly one checkpoint state registered');
+        await framework.stop();
+    });
+    it('turn checkpoints: legacy single-map stores are readable, migrate on save, and evict without ghosts', async () => {
+        const storePath = join(tempDir, 'legacy-checkpoints.chronicle');
+        {
+            const store = JsStore.openOrCreate({ path: storePath });
+            store.registerState({ id: TURN_CHECKPOINTS_ID, strategy: 'snapshot' });
+            store.setStateJson(TURN_CHECKPOINTS_ID, {
+                assistant: [
+                    { agentName: 'assistant', turnIndex: 0, sequenceBefore: 1, branchName: 'main', timestamp: 1 },
+                ],
+                'spawn-ghost-d1-1234': [
+                    { agentName: 'spawn-ghost-d1-1234', turnIndex: 3, sequenceBefore: 9, branchName: 'main', timestamp: 2 },
+                ],
+            });
+            store.close();
+        }
+        const framework = await createFramework(storePath);
+        const store = framework.getStore();
+        // Legacy entry visible through the fallback read...
+        const before = framework.getTurnCheckpoints('assistant');
+        assert.strictEqual(before.length, 1);
+        assert.strictEqual(before[0].turnIndex, 0);
+        // ...and the first new turn migrates the list into the tree.
+        framework.recordTurnCheckpoint('assistant');
+        const entry = store.treeGet(TURN_CHECKPOINTS_TREE_ID, 'assistant');
+        assert.ok(entry, 'tree entry created on first save');
+        const migrated = framework.getTurnCheckpoints('assistant');
+        assert.strictEqual(migrated.length, 2);
+        assert.strictEqual(migrated[0].turnIndex, 0);
+        // Evicting an agent whose checkpoints live only in the legacy map writes
+        // an empty tombstone — a later agent reusing the name must NOT inherit
+        // the dead agent's checkpoints through the fallback.
+        framework.evictTurnCheckpoints('spawn-ghost-d1-1234');
+        assert.deepStrictEqual(framework.getTurnCheckpoints('spawn-ghost-d1-1234'), []);
+        // Idempotent: a second evict doesn't rewrite the tombstone (blob "[]" is
+        // content-addressed, but the tree op record would still be new).
+        const recordsBefore = store.getRecordIdsByType('state_update').length;
+        framework.evictTurnCheckpoints('spawn-ghost-d1-1234');
+        assert.strictEqual(store.getRecordIdsByType('state_update').length, recordsBefore);
+        await framework.stop();
+    });
+    it('module log states: append/edit records are O(item), state is reconstructable', async () => {
+        const storePath = join(tempDir, 'module-log.chronicle');
+        let capturedCtx = null;
+        const logModule = {
+            name: 'logtest',
+            async start(ctx) {
+                capturedCtx = ctx;
+                ctx.registerLogState('log');
+            },
+            async stop() { },
+            getTools() { return []; },
+            async handleToolCall(_call) {
+                return { success: true };
+            },
+            async onProcess(_event, _state) {
+                return {};
+            },
+        };
+        const framework = await AgentFramework.create({
+            storePath,
+            membrane: membrane.asMembrane(),
+            agents: [{ name: 'assistant', model: 'test-model', systemPrompt: 'test' }],
+            modules: [logModule],
+        });
+        const ctx = capturedCtx;
+        const store = framework.getStore();
+        const N = 30;
+        for (let i = 0; i < N; i++) {
+            ctx.appendToLog('log', { id: `item-${i}`, content: 'x'.repeat(50) });
+        }
+        assert.strictEqual(ctx.getLogLength('log'), N);
+        // Point-edit keeps the record O(item), not O(log).
+        ctx.editLogItem('log', 3, { id: 'item-3', content: 'edited' });
+        const items = ctx.getLog('log');
+        assert.strictEqual(items.length, N);
+        assert.strictEqual(items[3].content, 'edited');
+        assert.strictEqual(items[4].id, 'item-4');
+        const sizes = stateUpdateSizes(store, (id) => id === 'modules/logtest/log');
+        assertFlat(sizes, 'modules/logtest/log');
+        // Idempotent re-registration must not throw (restart path).
+        ctx.registerLogState('log');
+        // Reserved / invalid names are rejected.
+        assert.throws(() => ctx.registerLogState('state'));
+        assert.throws(() => ctx.appendToLog('nested/name', {}));
+        // Writes to a never-registered name fail immediately — chronicle would
+        // accept the append but never snapshot the state, turning a typo into a
+        // silent full-chain-replay-on-restore trap.
+        assert.throws(() => ctx.appendToLog('lgo', { oops: true }), /not registered/);
+        assert.throws(() => ctx.editLogItem('lgo', 0, {}), /not registered/);
+        assert.strictEqual(ctx.getLogLength('log'), N, 'registered log still intact');
+        await framework.stop();
+    });
+});
+//# sourceMappingURL=state-scaling.test.js.map

package/dist/test/state-scaling.test.js.map

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

package/dist/test/tool-result-content.test.d.ts

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

package/dist/test/tool-result-content.test.d.ts.map

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

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

@@ -0,0 +1,37 @@
+/**
+ * toMembraneToolResult (6.6): JSON.stringify(undefined) returns the VALUE
+ * undefined, not a string — a tool returning `{ success: true }` with no data
+ * plus a configured maxChars cap used to throw a TypeError on content.length
+ * mid-turn. It must degrade to a safe empty string instead.
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { AgentFramework } from '../src/framework.js';
+function makeFw() {
+    return Object.create(AgentFramework.prototype);
+}
+test('undefined data + maxChars cap: no throw, content is a safe string', () => {
+    const fw = makeFw();
+    const result = fw.toMembraneToolResult('call-1', { success: true }, 1000);
+    assert.equal(result.toolUseId, 'call-1');
+    assert.equal(result.isError, false);
+    assert.equal(result.content, '');
+});
+test('undefined data without a cap also yields a string (never the value undefined)', () => {
+    const fw = makeFw();
+    const result = fw.toMembraneToolResult('call-2', { success: true, data: undefined });
+    assert.equal(typeof result.content, 'string');
+});
+test('normal data is still stringified and truncated by the cap', () => {
+    const fw = makeFw();
+    const result = fw.toMembraneToolResult('call-3', { success: true, data: { v: 'y'.repeat(500) } }, 100);
+    assert.equal(typeof result.content, 'string');
+    assert.match(result.content, /\[truncated — original was \d+ chars\]/);
+});
+test('error results pass through unchanged', () => {
+    const fw = makeFw();
+    const result = fw.toMembraneToolResult('call-4', { success: false, error: 'boom', isError: true }, 100);
+    assert.equal(result.isError, true);
+    assert.equal(result.content, 'boom');
+});
+//# sourceMappingURL=tool-result-content.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-content.test.js","sourceRoot":"","sources":["../../test/tool-result-content.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,SAAS,MAAM;IACb,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAQ,CAAC;AACxD,CAAC;AAED,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC7E,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+EAA+E,EAAE,GAAG,EAAE;IACzF,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACrF,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACvG,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAChD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IACxG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}