@animalabs/agent-framework 0.22.1 → 0.22.3

package/dist/test/usage-tracker.test.js

@@ -1,129 +0,0 @@
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { UsageTracker } from '../src/usage/usage-tracker.js';
-describe('UsageTracker', () => {
-    function createTracker() {
-        const traces = [];
-        const tracker = new UsageTracker({ emitTrace: (e) => traces.push(e) });
-        return { tracker, traces };
-    }
-    it('accumulates tokens across multiple inferences', () => {
-        const { tracker } = createTracker();
-        tracker.onInferenceCompleted('agent', { inputTokens: 100, outputTokens: 50 });
-        tracker.onInferenceCompleted('agent', { inputTokens: 200, outputTokens: 75, cacheCreationTokens: 10, cacheReadTokens: 30 });
-        const snap = tracker.getSnapshot();
-        assert.equal(snap.totals.inputTokens, 300);
-        assert.equal(snap.totals.outputTokens, 125);
-        assert.equal(snap.totals.cacheCreationTokens, 10);
-        assert.equal(snap.totals.cacheReadTokens, 30);
-        assert.equal(snap.inferenceCount, 2);
-    });
-    it('tracks per-agent breakdown', () => {
-        const { tracker } = createTracker();
-        tracker.onInferenceCompleted('alice', { inputTokens: 100, outputTokens: 50 });
-        tracker.onInferenceCompleted('bob', { inputTokens: 200, outputTokens: 75 });
-        tracker.onInferenceCompleted('alice', { inputTokens: 150, outputTokens: 60 });
-        const snap = tracker.getSnapshot();
-        assert.equal(snap.byAgent.length, 2);
-        const alice = snap.byAgent.find(a => a.agentName === 'alice');
-        assert.equal(alice.usage.inputTokens, 250);
-        assert.equal(alice.inferenceCount, 2);
-        const bob = snap.byAgent.find(a => a.agentName === 'bob');
-        assert.equal(bob.usage.inputTokens, 200);
-        assert.equal(bob.inferenceCount, 1);
-    });
-    it('accumulates estimated cost', () => {
-        const { tracker } = createTracker();
-        tracker.onInferenceCompleted('agent', { inputTokens: 100, outputTokens: 50 }, { total: 0.01, currency: 'USD' });
-        tracker.onInferenceCompleted('agent', { inputTokens: 200, outputTokens: 75 }, { total: 0.02, currency: 'USD' });
-        const snap = tracker.getSnapshot();
-        assert.ok(snap.totals.estimatedCost);
-        assert.ok(Math.abs(snap.totals.estimatedCost.total - 0.03) < 1e-10);
-        assert.equal(snap.totals.estimatedCost.currency, 'USD');
-    });
-    it('drops cost on currency mismatch', () => {
-        const { tracker } = createTracker();
-        tracker.onInferenceCompleted('agent', { inputTokens: 100, outputTokens: 50 }, { total: 0.01, currency: 'USD' });
-        tracker.onInferenceCompleted('agent', { inputTokens: 200, outputTokens: 75 }, { total: 0.02, currency: 'EUR' });
-        const snap = tracker.getSnapshot();
-        assert.equal(snap.totals.estimatedCost, undefined);
-    });
-    it('leaves estimatedCost undefined when no cost data provided', () => {
-        const { tracker } = createTracker();
-        tracker.onInferenceCompleted('agent', { inputTokens: 100, outputTokens: 50 });
-        const snap = tracker.getSnapshot();
-        assert.equal(snap.totals.estimatedCost, undefined);
-    });
-    it('returns deep-copied snapshots', () => {
-        const { tracker } = createTracker();
-        tracker.onInferenceCompleted('agent', { inputTokens: 100, outputTokens: 50 }, { total: 0.01, currency: 'USD' });
-        const snap1 = tracker.getSnapshot();
-        tracker.onInferenceCompleted('agent', { inputTokens: 200, outputTokens: 75 }, { total: 0.02, currency: 'USD' });
-        // snap1 should not have been mutated
-        assert.equal(snap1.totals.inputTokens, 100);
-        assert.ok(snap1.totals.estimatedCost);
-        assert.ok(Math.abs(snap1.totals.estimatedCost.total - 0.01) < 1e-10);
-        assert.equal(snap1.inferenceCount, 1);
-    });
-    it('emits deep-copied trace events', () => {
-        const { tracker, traces } = createTracker();
-        tracker.onInferenceCompleted('agent', { inputTokens: 100, outputTokens: 50 }, { total: 0.01, currency: 'USD' });
-        tracker.onInferenceCompleted('agent', { inputTokens: 200, outputTokens: 75 }, { total: 0.02, currency: 'USD' });
-        // First trace should not have been mutated by the second inference
-        assert.equal(traces[0].totals.inputTokens, 100);
-        assert.ok(traces[0].totals.estimatedCost);
-        assert.ok(Math.abs(traces[0].totals.estimatedCost.total - 0.01) < 1e-10);
-    });
-    it('emits usage:updated trace on each inference', () => {
-        const { tracker, traces } = createTracker();
-        tracker.onInferenceCompleted('agent', { inputTokens: 100, outputTokens: 50 });
-        assert.equal(traces.length, 1);
-        assert.equal(traces[0].type, 'usage:updated');
-        assert.equal(traces[0].agentName, 'agent');
-        assert.equal(traces[0].inferenceCount, 1);
-    });
-    it('round-trips through toJSON/restore', () => {
-        const { tracker } = createTracker();
-        tracker.onInferenceCompleted('alice', { inputTokens: 100, outputTokens: 50, cacheCreationTokens: 5, cacheReadTokens: 20 }, { total: 0.01, currency: 'USD' });
-        tracker.onInferenceCompleted('bob', { inputTokens: 200, outputTokens: 75 }, { total: 0.02, currency: 'USD' });
-        tracker.onInferenceCompleted('alice', { inputTokens: 150, outputTokens: 60 }, { total: 0.015, currency: 'USD' });
-        const persisted = tracker.toJSON();
-        // Simulate JSON round-trip (as Chronicle does)
-        const restored = new UsageTracker({
-            emitTrace: () => { },
-            restored: JSON.parse(JSON.stringify(persisted)),
-        });
-        const snap = restored.getSnapshot();
-        assert.equal(snap.totals.inputTokens, 450);
-        assert.equal(snap.totals.outputTokens, 185);
-        assert.equal(snap.totals.cacheCreationTokens, 5);
-        assert.equal(snap.totals.cacheReadTokens, 20);
-        assert.equal(snap.inferenceCount, 3);
-        assert.ok(snap.totals.estimatedCost);
-        assert.ok(Math.abs(snap.totals.estimatedCost.total - 0.045) < 1e-10);
-        assert.equal(snap.totals.estimatedCost.currency, 'USD');
-        assert.equal(snap.byAgent.length, 2);
-        const alice = snap.byAgent.find(a => a.agentName === 'alice');
-        assert.equal(alice.usage.inputTokens, 250);
-        assert.equal(alice.inferenceCount, 2);
-        const bob = snap.byAgent.find(a => a.agentName === 'bob');
-        assert.equal(bob.usage.inputTokens, 200);
-        assert.equal(bob.inferenceCount, 1);
-    });
-    it('continues accumulating after restore', () => {
-        const { tracker } = createTracker();
-        tracker.onInferenceCompleted('agent', { inputTokens: 100, outputTokens: 50 }, { total: 0.01, currency: 'USD' });
-        const restored = new UsageTracker({
-            emitTrace: () => { },
-            restored: JSON.parse(JSON.stringify(tracker.toJSON())),
-        });
-        restored.onInferenceCompleted('agent', { inputTokens: 200, outputTokens: 75 }, { total: 0.02, currency: 'USD' });
-        const snap = restored.getSnapshot();
-        assert.equal(snap.totals.inputTokens, 300);
-        assert.equal(snap.totals.outputTokens, 125);
-        assert.equal(snap.inferenceCount, 2);
-        assert.ok(snap.totals.estimatedCost);
-        assert.ok(Math.abs(snap.totals.estimatedCost.total - 0.03) < 1e-10);
-    });
-});
-//# sourceMappingURL=usage-tracker.test.js.map

package/dist/test/usage-tracker.test.js.map

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

package/dist/test/utils-surface.test.d.ts

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

package/dist/test/utils-surface.test.d.ts.map

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

package/dist/test/utils-surface.test.js

@@ -1,145 +0,0 @@
-// The utils meta-tool: rarely-used capabilities live behind ONE slot
-// (Module.getUtilities) instead of each taxing every inference with a schema.
-// list/describe/run, arg validation that teaches by bounce, and dispatch that
-// arrives at the module's ordinary handleToolCall.
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { mkdtempSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { AutobiographicalStrategy } from '@animalabs/context-manager';
-import { AgentFramework } from '../src/index.js';
-const membrane = {};
-function strategy() {
-    return new AutobiographicalStrategy({
-        adaptiveResolution: true,
-        foldingStrategy: 'kv-stable',
-        recentWindowTokens: 30_000,
-        kvStableReachTokens: 8_000,
-    });
-}
-/** A module with one first-class tool and two utilities, sharing a handler. */
-class StubModule {
-    name = 'stub';
-    calls = [];
-    async start(_ctx) { }
-    async stop() { }
-    getTools() {
-        return [{ name: 'frontline', description: 'Always-on tool.', inputSchema: { type: 'object' } }];
-    }
-    getUtilities() {
-        return [
-            {
-                name: 'rare_op',
-                description: 'A rarely-used operation. Second sentence with detail.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        mode: { type: 'string', enum: ['soft', 'hard'] },
-                        count: { type: 'number' },
-                    },
-                    required: ['mode'],
-                },
-            },
-            { name: 'other_op', description: 'Another one.', inputSchema: { type: 'object' } },
-        ];
-    }
-    async handleToolCall(call) {
-        this.calls.push(call);
-        return { success: true, data: { handled: call.name, input: call.input } };
-    }
-    async onProcess() {
-        return {};
-    }
-}
-async function makeFramework(modules) {
-    const dir = mkdtempSync(join(tmpdir(), 'utils-surface-'));
-    const framework = await AgentFramework.create({
-        storePath: join(dir, 'store'),
-        membrane,
-        agents: [{
-                name: 'agent',
-                model: 'test-model',
-                systemPrompt: 'test',
-                strategy: strategy(),
-                contextBudgetTokens: 100_000,
-                maxTokens: 10_000,
-            }],
-        modules,
-    });
-    return { framework, dir };
-}
-describe('utils surface', () => {
-    it('utils tool appears only when a module contributes utilities', async () => {
-        const bare = await makeFramework([]);
-        try {
-            assert.ok(!bare.framework.getAllTools().some((t) => t.name === 'utils'), 'no utilities → no utils tool, surface unchanged');
-        }
-        finally {
-            await bare.framework.stop();
-            rmSync(bare.dir, { recursive: true, force: true });
-        }
-        const stub = new StubModule();
-        const { framework, dir } = await makeFramework([stub]);
-        try {
-            const tools = framework.getAllTools();
-            assert.ok(tools.some((t) => t.name === 'utils'), 'utilities present → utils tool exposed');
-            assert.ok(tools.some((t) => t.name === 'stub--frontline'), 'first-class tools unaffected');
-            assert.ok(!tools.some((t) => t.name === 'stub--rare_op'), 'utilities do NOT appear as first-class tools');
-        }
-        finally {
-            await framework.stop();
-            rmSync(dir, { recursive: true, force: true });
-        }
-    });
-    it('list / describe / run round-trip through the ordinary module handler', async () => {
-        const stub = new StubModule();
-        const { framework, dir } = await makeFramework([stub]);
-        try {
-            const call = (input) => framework.executeToolCall({ id: 'c1', name: 'utils', input, callerAgentName: 'agent' });
-            const list = await call({ action: 'list' });
-            assert.ok(list.success);
-            assert.deepEqual(list.data, [
-                { name: 'stub--rare_op', description: 'A rarely-used operation.' },
-                { name: 'stub--other_op', description: 'Another one.' },
-            ]);
-            const desc = await call({ action: 'describe', name: 'stub--rare_op' });
-            assert.ok(desc.success);
-            assert.equal(desc.data.inputSchema.required?.[0], 'mode');
-            const run = await call({ action: 'run', name: 'stub--rare_op', args: { mode: 'soft', count: 2 } });
-            assert.ok(run.success, run.error);
-            assert.deepEqual(run.data, { handled: 'rare_op', input: { mode: 'soft', count: 2 } });
-            assert.equal(stub.calls[0].name, 'rare_op', 'module sees the un-prefixed name, as with tools');
-            assert.equal(stub.calls[0].callerAgentName, 'agent');
-        }
-        finally {
-            await framework.stop();
-            rmSync(dir, { recursive: true, force: true });
-        }
-    });
-    it('arg misses teach by bounce: schema rides the error', async () => {
-        const stub = new StubModule();
-        const { framework, dir } = await makeFramework([stub]);
-        try {
-            const call = (input) => framework.executeToolCall({ id: 'c2', name: 'utils', input, callerAgentName: 'agent' });
-            const missing = await call({ action: 'run', name: 'stub--rare_op', args: {} });
-            assert.ok(!missing.success && missing.isError);
-            assert.match(missing.error, /missing required "mode"/);
-            assert.match(missing.error, /"enum":\["soft","hard"\]/, 'schema included for the retry');
-            const badEnum = await call({ action: 'run', name: 'stub--rare_op', args: { mode: 'loud' } });
-            assert.match(badEnum.error, /"mode" must be one of \["soft","hard"\]/);
-            const badType = await call({ action: 'run', name: 'stub--rare_op', args: { mode: 'soft', count: 'three' } });
-            assert.match(badType.error, /"count" must be number, got string/);
-            assert.equal(stub.calls.length, 0, 'handler never reached on a validation miss');
-            const unknown = await call({ action: 'run', name: 'stub--nope', args: {} });
-            assert.match(unknown.error, /No utility "stub--nope"\. Available: stub--rare_op, stub--other_op/);
-            const badAction = await call({ action: 'zap' });
-            assert.match(badAction.error, /action must be "list", "describe", or "run"/);
-        }
-        finally {
-            await framework.stop();
-            rmSync(dir, { recursive: true, force: true });
-        }
-    });
-});
-//# sourceMappingURL=utils-surface.test.js.map

package/dist/test/utils-surface.test.js.map

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

package/dist/test/workspace-branch-continuation.test.d.ts

@@ -1,15 +0,0 @@
-/**
- * Materialize branch guard: lineage, not identity.
- *
- * An out-of-band repair/treatment branches the store and leaves it on a child
- * branch forked at the parent's head. That child is a linear continuation of
- * exactly the history that was materialized — writing from it can never
- * clobber divergent disk state, so the guard must pass (and heal the pin at
- * boot). Genuine divergence — a branch forked BEFORE the last materialized
- * sequence — must still refuse, with `force: true` as the deliberate
- * override. One mount's stale pin must never block another mount.
- *
- * Regression tests for the Sill 08-24..26 stuck-materialize incident.
- */
-export {};
-//# sourceMappingURL=workspace-branch-continuation.test.d.ts.map

package/dist/test/workspace-branch-continuation.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace-branch-continuation.test.d.ts","sourceRoot":"","sources":["../../test/workspace-branch-continuation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/test/workspace-branch-continuation.test.js

@@ -1,183 +0,0 @@
-/**
- * Materialize branch guard: lineage, not identity.
- *
- * An out-of-band repair/treatment branches the store and leaves it on a child
- * branch forked at the parent's head. That child is a linear continuation of
- * exactly the history that was materialized — writing from it can never
- * clobber divergent disk state, so the guard must pass (and heal the pin at
- * boot). Genuine divergence — a branch forked BEFORE the last materialized
- * sequence — must still refuse, with `force: true` as the deliberate
- * override. One mount's stale pin must never block another mount.
- *
- * Regression tests for the Sill 08-24..26 stuck-materialize incident.
- */
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { JsStore } from '@animalabs/chronicle';
-import { WorkspaceModule } from '../src/modules/workspace/index.js';
-function makeCtx(opts) {
-    return {
-        isRestart: opts.isRestart,
-        getState: () => (opts.saved ?? null),
-        setState: () => { },
-        pushEvent: () => { },
-    };
-}
-function setup(t, mountNames = ['work']) {
-    const root = mkdtempSync(join(tmpdir(), 'af-ws-branch-'));
-    const dirs = {};
-    for (const name of mountNames) {
-        dirs[name] = join(root, name);
-        mkdirSync(dirs[name], { recursive: true });
-    }
-    const store = JsStore.openOrCreate({ path: join(root, 'ws.chronicle') });
-    t.after(() => {
-        store.close();
-        rmSync(root, { recursive: true, force: true });
-    });
-    const makeModule = () => new WorkspaceModule({
-        mounts: mountNames.map((name) => ({
-            name, path: dirs[name], mode: 'read-write', watch: 'never',
-        })),
-    });
-    return { store, dirs, makeModule };
-}
-async function statusOf(module, mount = 'work') {
-    const res = await module.handleToolCall({ id: 't', name: 'status', input: {} });
-    assert.equal(res.success, true, `status failed: ${res.error}`);
-    return res.data[mount];
-}
-/** Write a file + materialize on the current branch; returns saved state. */
-async function materializeBaseline(module) {
-    let res = await module.handleToolCall({
-        id: 'w1', name: 'write', input: { path: 'work/base.txt', content: 'baseline' },
-    });
-    assert.equal(res.success, true, `write failed: ${res.error}`);
-    res = await module.handleToolCall({ id: 'm1', name: 'materialize', input: {} });
-    assert.equal(res.success, true, `materialize failed: ${res.error}`);
-    const status = await statusOf(module);
-    return {
-        mounts: {
-            work: {
-                lastMaterializedSeq: status.lastMaterializedSeq,
-                lastMaterializedBranchId: status.lastMaterializedBranch ?? undefined,
-            },
-        },
-    };
-}
-test('descendant branch (fork at head) materializes without force and re-pins', async (t) => {
-    const { store, dirs, makeModule } = setup(t);
-    const module = makeModule();
-    module.initStore(store);
-    await module.start(makeCtx({ isRestart: false }));
-    await materializeBaseline(module);
-    // Out-of-band-style switch: child forked at the parent's head.
-    store.createBranch('repair/test', store.currentBranch().name);
-    store.switchBranch('repair/test');
-    const childId = store.currentBranch().id;
-    let res = await module.handleToolCall({
-        id: 'w2', name: 'write', input: { path: 'work/repair.txt', content: 'on child' },
-    });
-    assert.equal(res.success, true, `write failed: ${res.error}`);
-    const before = await statusOf(module);
-    assert.equal(before.canMaterialize, true, 'linear continuation must be materializable');
-    res = await module.handleToolCall({ id: 'm2', name: 'materialize', input: {} });
-    assert.equal(res.success, true, `materialize must pass on descendant branch: ${res.error}`);
-    assert.equal(readFileSync(join(dirs.work, 'repair.txt'), 'utf8'), 'on child');
-    const after = await statusOf(module);
-    assert.equal(after.lastMaterializedBranch, childId, 're-pinned to current branch');
-});
-test('restart after out-of-band branch switch heals the pin at boot (both orders)', async (t) => {
-    const { store, makeModule } = setup(t);
-    const first = makeModule();
-    first.initStore(store);
-    await first.start(makeCtx({ isRestart: false }));
-    const saved = await materializeBaseline(first);
-    const parentId = saved.mounts.work.lastMaterializedBranchId;
-    assert.ok(parentId, 'baseline pinned a branch');
-    // Offline repair: branch at head, leave the store on the child.
-    store.createBranch('repair/offline', store.currentBranch().name);
-    store.switchBranch('repair/offline');
-    const childId = store.currentBranch().id;
-    assert.notEqual(childId, parentId);
-    for (const order of ['host', 'reverse']) {
-        const module = makeModule();
-        if (order === 'host') {
-            await module.start(makeCtx({ isRestart: true, saved }));
-            module.initStore(store);
-        }
-        else {
-            module.initStore(store);
-            await module.start(makeCtx({ isRestart: true, saved }));
-        }
-        const status = await statusOf(module);
-        assert.equal(status.lastMaterializedBranch, childId, `${order}: pin healed to current branch`);
-        assert.equal(status.canMaterialize, true, `${order}: materializable after heal`);
-        const res = await module.handleToolCall({ id: 'm', name: 'materialize', input: {} });
-        assert.equal(res.success, true, `${order}: materialize passes after heal: ${res.error}`);
-    }
-});
-test('genuinely divergent branch refuses without force, materializes with force', async (t) => {
-    const { store, dirs, makeModule } = setup(t);
-    const module = makeModule();
-    module.initStore(store);
-    await module.start(makeCtx({ isRestart: false }));
-    // Two materialized generations on main, so a fork between them diverges.
-    await materializeBaseline(module);
-    const forkAt = store.currentSequence();
-    let res = await module.handleToolCall({
-        id: 'w2', name: 'write', input: { path: 'work/newer.txt', content: 'newer on main' },
-    });
-    assert.equal(res.success, true);
-    res = await module.handleToolCall({ id: 'm2', name: 'materialize', input: {} });
-    assert.equal(res.success, true);
-    // Fork BEFORE the last materialized sequence: disk now holds records the
-    // child branch never had.
-    store.createBranchAt('divergent', store.currentBranch().name, forkAt);
-    store.switchBranch('divergent');
-    res = await module.handleToolCall({
-        id: 'w3', name: 'write', input: { path: 'work/div.txt', content: 'divergent' },
-    });
-    assert.equal(res.success, true);
-    const status = await statusOf(module);
-    assert.equal(status.canMaterialize, false, 'divergent branch must not be materializable');
-    res = await module.handleToolCall({ id: 'm3', name: 'materialize', input: {} });
-    assert.equal(res.success, false, 'divergent branch must refuse without force');
-    assert.match(String(res.error), /diverged/);
-    assert.match(String(res.error), /force: true/, 'error names the reachable remedy');
-    assert.equal(existsSync(join(dirs.work, 'div.txt')), false, 'nothing written on refusal');
-    res = await module.handleToolCall({ id: 'm4', name: 'materialize', input: { force: true } });
-    assert.equal(res.success, true, `force must override: ${res.error}`);
-    assert.equal(readFileSync(join(dirs.work, 'div.txt'), 'utf8'), 'divergent');
-    const after = await statusOf(module);
-    assert.equal(after.lastMaterializedBranch, store.currentBranch().id, 'force re-pins');
-    assert.equal(after.canMaterialize, true, 'materializable again after force');
-});
-test('one mount\'s stale pin does not block other mounts', async (t) => {
-    const { store, dirs, makeModule } = setup(t, ['work', 'notes']);
-    // Saved state: `work` pinned to a branch that no longer exists (unprovable
-    // ancestry → blocked); `notes` never materialized (unpinned → free).
-    const saved = {
-        mounts: { work: { lastMaterializedSeq: 1, lastMaterializedBranchId: 'branch-gone' } },
-    };
-    const module = makeModule();
-    module.initStore(store);
-    await module.start(makeCtx({ isRestart: true, saved }));
-    let res = await module.handleToolCall({
-        id: 'w1', name: 'write', input: { path: 'notes/note.txt', content: 'note' },
-    });
-    assert.equal(res.success, true, `write failed: ${res.error}`);
-    // Materialize-all: notes must land on disk; work is reported skipped.
-    res = await module.handleToolCall({ id: 'm1', name: 'materialize', input: {} });
-    assert.equal(res.success, true, `unblocked mount must materialize: ${res.error}`);
-    assert.equal(readFileSync(join(dirs.notes, 'note.txt'), 'utf8'), 'note');
-    const skipped = res.data.skipped ?? [];
-    assert.deepEqual(skipped.map((s) => s.mount), ['work'], 'blocked mount reported as skipped');
-    // Targeting the blocked mount alone still refuses.
-    res = await module.handleToolCall({ id: 'm2', name: 'materialize', input: { mount: 'work' } });
-    assert.equal(res.success, false, 'blocked mount alone must refuse');
-});
-//# sourceMappingURL=workspace-branch-continuation.test.js.map

package/dist/test/workspace-branch-continuation.test.js.map

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

package/dist/test/workspace-materialize-freshness.test.d.ts

@@ -1,16 +0,0 @@
-/**
- * Materialize freshness guard (#109): files get modified by two hands — the
- * workspace layer AND direct shell/tool edits. `materialize` used to assume
- * it was the only writer: a bulk materialize overwrote 217 shell-edited
- * files with stale workspace copies (2026-08-11 production incident; second
- * single-file occurrence in the issue thread, stopped only by an incidental
- * branch-guard refusal).
- *
- * The guard compares disk with the evidence of what disk last agreed with
- * (workspace/disk-agreement, recorded as the layer writes and syncs): a
- * mismatch means another writer changed the file, and the path is refused
- * LOUDLY — listed in the result, not resolved silently in either direction —
- * unless `force: true`.
- */
-export {};
-//# sourceMappingURL=workspace-materialize-freshness.test.d.ts.map

package/dist/test/workspace-materialize-freshness.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace-materialize-freshness.test.d.ts","sourceRoot":"","sources":["../../test/workspace-materialize-freshness.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}