@animalabs/agent-framework 0.21.1 → 0.22.1

package/dist/test/record-journal.test.js

@@ -0,0 +1,269 @@
+/**
+ * RecordJournal — typed chronicle records that don't follow branch switches,
+ * replayed from the latest checkpoint, with the two durability barriers named.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { JsStore } from '@animalabs/chronicle';
+import { RecordJournal } from '../src/record-journal.js';
+const KILL_FIXTURE = join(import.meta.dirname, 'fixtures/record-journal-kill.mjs');
+function withStore(fn) {
+    const dir = mkdtempSync(join(tmpdir(), 'record-journal-'));
+    const path = join(dir, 'store');
+    const store = JsStore.openOrCreate({ path });
+    try {
+        return fn(store, path);
+    }
+    finally {
+        if (!store.isClosed())
+            store.close();
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+const entriesOf = (journal) => journal.load().entries.map((e) => e.entry.n);
+describe('RecordJournal', () => {
+    it('an empty journal loads nothing', () => {
+        withStore((store) => {
+            const journal = new RecordJournal(store, { type: 'journal-test/entry' });
+            assert.deepStrictEqual(journal.load(), { snapshot: null, entries: [] });
+            assert.strictEqual(journal.entriesSinceCheckpoint, 0);
+        });
+    });
+    it('append returns where the record landed; a fresh load replays entries in append order', () => {
+        withStore((store) => {
+            const journal = new RecordJournal(store, { type: 'journal-test/entry' });
+            const a = journal.append({ n: 'a' });
+            const b = journal.append({ n: 'b' });
+            assert.match(a.id, /^\d+$/);
+            assert.ok(BigInt(b.id) > BigInt(a.id), 'ids increase in append order');
+            assert.strictEqual(typeof a.sequence, 'number');
+            const loaded = new RecordJournal(store, { type: 'journal-test/entry' }).load();
+            assert.deepStrictEqual(loaded.entries, [
+                { id: a.id, sequence: a.sequence, entry: { n: 'a' } },
+                { id: b.id, sequence: b.sequence, entry: { n: 'b' } },
+            ]);
+        });
+    });
+    it('entries from every branch load from any branch, in global order, through deleteBranch and reopen', () => {
+        withStore((store, path) => {
+            const journal = new RecordJournal(store, { type: 'journal-test/entry' });
+            journal.append({ n: 'main-0' });
+            const fork = store.currentSequence();
+            journal.append({ n: 'main-1' });
+            const main = store.currentBranch().name;
+            store.createBranchAt('rollback', main, fork);
+            store.switchBranch('rollback');
+            journal.append({ n: 'rollback-2' });
+            assert.deepStrictEqual(entriesOf(journal), ['main-0', 'main-1', 'rollback-2'], 'the rolled-back branch still sees what main appended after the fork');
+            store.switchBranch(main);
+            journal.append({ n: 'main-3' });
+            store.deleteBranch('rollback');
+            assert.deepStrictEqual(entriesOf(journal), ['main-0', 'main-1', 'rollback-2', 'main-3']);
+            store.close();
+            const reopened = JsStore.openOrCreate({ path });
+            try {
+                assert.deepStrictEqual(entriesOf(new RecordJournal(reopened, { type: 'journal-test/entry' })), ['main-0', 'main-1', 'rollback-2', 'main-3']);
+            }
+            finally {
+                reopened.close();
+            }
+        });
+    });
+    it('load returns the latest checkpoint and only the entries after it; other records do not disturb it', () => {
+        withStore((store) => {
+            store.registerState({ id: 'journal-test/tree', strategy: 'tree' });
+            const journal = new RecordJournal(store, { type: 'journal-test/entry' });
+            const other = new RecordJournal(store, { type: 'journal-test/other' });
+            journal.append({ n: 'a' });
+            other.append({ n: 'x' });
+            journal.append({ n: 'b' });
+            journal.checkpoint({ seen: ['a', 'b'] });
+            assert.strictEqual(journal.entriesSinceCheckpoint, 0);
+            store.treeSet('journal-test/tree', 'f.txt', { blobHash: 'f'.repeat(64), size: 1, mode: 0o644 });
+            journal.append({ n: 'c' });
+            other.append({ n: 'y' });
+            assert.strictEqual(journal.entriesSinceCheckpoint, 1);
+            const reader = new RecordJournal(store, { type: 'journal-test/entry' });
+            const first = reader.load();
+            assert.deepStrictEqual(first.snapshot, { seen: ['a', 'b'] });
+            assert.deepStrictEqual(first.entries.map((e) => e.entry.n), ['c']);
+            assert.strictEqual(reader.entriesSinceCheckpoint, 1);
+            // A checkpoint after load covers what was loaded; the newest one wins.
+            reader.checkpoint({ seen: ['a', 'b', 'c'] });
+            const second = new RecordJournal(store, { type: 'journal-test/entry' }).load();
+            assert.deepStrictEqual(second, { snapshot: { seen: ['a', 'b', 'c'] }, entries: [] });
+            assert.deepStrictEqual(entriesOf(new RecordJournal(store, { type: 'journal-test/other' })), ['x', 'y']);
+        });
+    });
+    it('names its two barriers: afterCommittedState syncs before the append, durable after it, neither by default', () => {
+        withStore((store) => {
+            const calls = [];
+            const recording = {
+                getRecordIdsByType: (type) => store.getRecordIdsByType(type),
+                getRecord: (id) => store.getRecord(id),
+                appendJson: (type, data) => { calls.push('append'); return store.appendJson(type, data); },
+                sync: () => { calls.push('sync'); store.sync(); },
+            };
+            const journal = new RecordJournal(recording, { type: 'journal-test/entry' });
+            journal.append({ n: 'plain' });
+            assert.deepStrictEqual(calls.splice(0), ['append'], 'a plain append does not sync');
+            journal.append({ n: 'asserting' }, { afterCommittedState: true });
+            assert.deepStrictEqual(calls.splice(0), ['sync', 'append']);
+            journal.append({ n: 'durable' }, { durable: true });
+            assert.deepStrictEqual(calls.splice(0), ['append', 'sync']);
+            journal.append({ n: 'both' }, { afterCommittedState: true, durable: true });
+            assert.deepStrictEqual(calls.splice(0), ['sync', 'append', 'sync']);
+            journal.checkpoint({ n: 1 }, { durable: true });
+            assert.deepStrictEqual(calls.splice(0), ['append', 'sync']);
+        });
+    });
+    it('after a hard kill, an afterCommittedState entry never survives without the state it asserts', () => {
+        withStore((store, path) => {
+            store.registerState({ id: 'journal-test/tree', strategy: 'tree' });
+            store.sync();
+            store.close();
+            const child = spawnSync(process.execPath, [KILL_FIXTURE, path, 'asserting'], { encoding: 'utf-8' });
+            assert.strictEqual(child.signal, 'SIGKILL', `the child died by SIGKILL (stderr: ${child.stderr})`);
+            const reopened = JsStore.openOrCreate({ path });
+            try {
+                try {
+                    reopened.registerState({ id: 'journal-test/tree', strategy: 'tree' });
+                }
+                catch { /* exists */ }
+                const entries = new RecordJournal(reopened, { type: 'journal-test/entry' }).load().entries;
+                assert.strictEqual(entries.length, 1, 'the appended entry survived the kill');
+                assert.notStrictEqual(reopened.treeGet('journal-test/tree', 'committed.txt'), null, 'the state it asserts survived with it');
+            }
+            finally {
+                reopened.close();
+            }
+        });
+    });
+    it('a write that fails after reaching the store blocks further writes until load() replays it', () => {
+        withStore((store) => {
+            let failNextSync = false;
+            const flaky = {
+                getRecordIdsByType: (type) => store.getRecordIdsByType(type),
+                getRecord: (id) => store.getRecord(id),
+                appendJson: (type, data) => store.appendJson(type, data),
+                sync: () => {
+                    if (failNextSync) {
+                        failNextSync = false;
+                        throw new Error('disk full');
+                    }
+                    store.sync();
+                },
+            };
+            const journal = new RecordJournal(flaky, { type: 'journal-test/entry' });
+            // The durable barrier fails after A reached the store: the caller never reduces A.
+            failNextSync = true;
+            assert.throws(() => journal.append({ n: 'A' }, { durable: true }), /disk full/);
+            assert.strictEqual(journal.needsReconcile, true);
+            // Without reconciliation, a later write and checkpoint would cover A unreduced.
+            assert.throws(() => journal.append({ n: 'B' }), /load\(\) and reduce its tail before writing again/);
+            assert.throws(() => journal.checkpoint({ seen: ['B'] }), /load\(\) and reduce its tail/);
+            const reconciled = journal.load();
+            assert.deepStrictEqual(reconciled.entries.map((e) => e.entry.n), ['A'], 'load replays the ambiguous record');
+            assert.strictEqual(journal.needsReconcile, false);
+            journal.append({ n: 'B' });
+            journal.checkpoint({ seen: ['A', 'B'] });
+            assert.deepStrictEqual(new RecordJournal(store, { type: 'journal-test/entry' }).load(), { snapshot: { seen: ['A', 'B'] }, entries: [] });
+            // A failure BEFORE the record reaches the store wrote nothing and leaves the journal usable.
+            failNextSync = true;
+            assert.throws(() => journal.append({ n: 'C' }, { afterCommittedState: true }), /disk full/);
+            assert.strictEqual(journal.needsReconcile, false);
+            journal.append({ n: 'D' });
+            assert.deepStrictEqual(new RecordJournal(store, { type: 'journal-test/entry' }).load().entries.map((e) => e.entry.n), ['D']);
+        });
+    });
+    it('an append that throws inside the store blocks writes for the life of the journal; a journal on the reopened store loads its record', () => {
+        withStore((store) => {
+            // As Chronicle's append can fail: the record is written to the log, the
+            // periodic sync then fails, and the record never reaches the index this
+            // process reads. Reopening the store indexes it from the log. `hidden`
+            // is this process's view of the store.
+            let failAppend = null;
+            const hidden = new Set();
+            const live = {
+                getRecordIdsByType: (type) => store.getRecordIdsByType(type).filter((id) => !hidden.has(id)),
+                getRecord: (id) => (hidden.has(id) ? null : store.getRecord(id)),
+                appendJson: (type, data) => {
+                    if (failAppend === 'before-writing') {
+                        failAppend = null;
+                        throw new Error('EIO: write failed');
+                    }
+                    const record = store.appendJson(type, data);
+                    if (failAppend === 'after-writing') {
+                        failAppend = null;
+                        hidden.add(record.id);
+                        throw new Error('EIO: fsync failed');
+                    }
+                    return record;
+                },
+                sync: () => store.sync(),
+            };
+            const journal = new RecordJournal(live, { type: 'journal-test/entry' });
+            journal.append({ n: 'A' });
+            failAppend = 'after-writing';
+            assert.throws(() => journal.append({ n: 'B' }), /EIO: fsync failed/);
+            assert.strictEqual(journal.needsReconcile, false, 'no load() on this store can read B back');
+            assert.strictEqual(journal.needsReopen, true, 'what this view holds may lack B until a reopen');
+            assert.deepStrictEqual(journal.load().entries.map((e) => e.entry.n), ['A'], 'B is outside this view of the store');
+            // A checkpoint now would cover B, unreduced, so nothing more is written.
+            const blocked = /append failed inside the store \(EIO: fsync failed\).*until the store is reopened/;
+            assert.throws(() => journal.append({ n: 'C' }), blocked);
+            assert.throws(() => journal.checkpoint({ seen: ['A'] }), blocked);
+            assert.throws(() => journal.append({ n: 'C' }), blocked, 'load() does not lift it');
+            // A journal on the reopened store loads B with its tail, and writes again.
+            const reopened = new RecordJournal(store, { type: 'journal-test/entry' });
+            assert.deepStrictEqual(reopened.load().entries.map((e) => e.entry.n), ['A', 'B']);
+            reopened.append({ n: 'C' });
+            reopened.checkpoint({ seen: ['A', 'B', 'C'] });
+            assert.deepStrictEqual(new RecordJournal(store, { type: 'journal-test/entry' }).load(), { snapshot: { seen: ['A', 'B', 'C'] }, entries: [] });
+            // An append that fails before writing anything looks the same from
+            // here, so it blocks the same way; the reopened store has nothing new.
+            const second = new RecordJournal(live, { type: 'journal-test/entry' });
+            second.load();
+            failAppend = 'before-writing';
+            assert.throws(() => second.append({ n: 'X' }), /EIO: write failed/);
+            assert.throws(() => second.append({ n: 'D' }), /until the store is reopened/);
+            assert.deepStrictEqual(new RecordJournal(store, { type: 'journal-test/entry' }).load(), { snapshot: { seen: ['A', 'B', 'C'] }, entries: [] });
+        });
+    });
+    it('a durable checkpoint whose barrier throws blocks writes until load() replays it', () => {
+        withStore((store) => {
+            let failNextSync = false;
+            const flaky = {
+                getRecordIdsByType: (type) => store.getRecordIdsByType(type),
+                getRecord: (id) => store.getRecord(id),
+                appendJson: (type, data) => store.appendJson(type, data),
+                sync: () => {
+                    if (failNextSync) {
+                        failNextSync = false;
+                        throw new Error('disk full');
+                    }
+                    store.sync();
+                },
+            };
+            const journal = new RecordJournal(flaky, { type: 'journal-test/entry' });
+            journal.append({ n: 'A' });
+            failNextSync = true;
+            assert.throws(() => journal.checkpoint({ seen: ['A'] }, { durable: true }), /disk full/);
+            assert.strictEqual(journal.needsReconcile, true);
+            assert.strictEqual(journal.needsReopen, false, 'the checkpoint is in this view of the store');
+            assert.throws(() => journal.append({ n: 'C' }), /load\(\) and reduce its tail/);
+            assert.deepStrictEqual(journal.load(), { snapshot: { seen: ['A'] }, entries: [] }, 'the checkpoint landed');
+            journal.append({ n: 'C' });
+        });
+    });
+    it('refuses a checkpoint type equal to the entry type', () => {
+        withStore((store) => {
+            assert.throws(() => new RecordJournal(store, { type: 't', checkpointType: 't' }), /distinct record types/);
+        });
+    });
+});
+//# sourceMappingURL=record-journal.test.js.map

package/dist/test/record-journal.test.js.map

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

package/dist/test/refusal-reaction-baseline.test.js

@@ -1,9 +1,11 @@
 /**
  * The exported REFUSAL_REACTION_BASELINE must be exactly the set of markers
  * reactToRefusal can emit — every category's emoji plus the unknown-category
- * fallback, nothing more, nothing less. Host composition serializes this
- * export into DISCORD_SUPPRESSED_REACTIONS_BASELINE; if the emitted set and
- * the export could drift, a framework annotation could re-enter a resident's
+ * fallback, nothing more, nothing less. It is the refusal set only: the
+ * protective default the framework injects into DISCORD_SUPPRESSED_REACTIONS_BASELINE
+ * is framework.getPlacedReactionBaseline(), which adds the awareness markers
+ * (test/placed-reaction-baseline.test.ts). If the emitted refusal set and the
+ * export could drift, a framework annotation could re-enter a resident's
  * context as a reaction event (the 8/3 Mythos self-amplifying refusal loop).
  * The implementation shares one constant; these tests pin the contract so a
  * refactor that splits them fails here first.
@@ -59,6 +61,11 @@ describe('refusal-reaction baseline export', () => {
         // names — no stale entries suppressing markers nothing stamps anymore.
         assert.deepEqual(emitted, new Set(REFUSAL_REACTION_BASELINE));
     });
+    it('a category named like an inherited property takes the fallback', async () => {
+        for (const category of ['constructor', 'toString', '__proto__']) {
+            assert.equal(await emittedFor(category), REFUSAL_REACTION_FALLBACK, category);
+        }
+    });
     it('serialized baseline survives the Discord adapter env round-trip (comma-join)', () => {
         // Host composition joins with ','; discord-mcpl's parseSuppressionEnvTokens
         // splits on ',' and trims. Entries therefore must not contain commas or

package/dist/test/refusal-reaction-baseline.test.js.map

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

package/dist/test/save-recent-image.test.js

@@ -32,6 +32,7 @@ import { AgentFramework } from '../src/index.js';
 import { WorkspaceModule } from '../src/modules/workspace/index.js';
 import { FALLBACK_MEDIA_TYPE, TOOL_IMAGE_REF_RE, ToolImageLedger, formatPreservedImageSlots, formatToolImagePlaceholder, normalizeMediaType, parseImagePlaceholders, splitPreservingImageSlots, } from '../src/tool-image-ledger.js';
 import { toolResultDataToHistoryString, truncateForHistory } from '../src/tool-result-history.js';
+import { classifyBlock, referenceRegistry } from '../src/mcpl/references.js';
 import { createMockResponse, MockMembrane } from './helpers/mock-membrane.js';
 const PNG = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR4nGP4////fwAJ+wP9KobjigAAAABJRU5ErkJggg==', 'base64');
 const GIF = Buffer.from('R0lGODdhAQABAIEAAP///wAAAAAAAAAAACwAAAAAAQABAAAIBAABBAQAOw==', 'base64');
@@ -140,6 +141,7 @@ async function startTurn(opts) {
         { type: 'image', source: { type: 'base64', data: GIF.toString('base64'), mediaType: 'image/gif' } },
     ]);
     opts.seedHistory?.(framework);
+    opts.workspace?.(workspace);
     framework.start();
     framework.pushEvent({
         type: 'external-message',
@@ -347,7 +349,142 @@ describe('save_recent_image provenance (issue #104)', () => {
             rmSync(h.tempDir, { recursive: true, force: true });
         }
     });
-    it('an image-typed RFC-005 reference stub occupies a failing slot that points at fetch_reference', async () => {
+    it("a reference whose claimed type carries bidi controls is the image its stub shows, and its refusal shows the type without them", async () => {
+        // The stub shows `Image/PNG`, so after a restart the stub's text alone
+        // makes this a slot (matched without regard to case); the record must
+        // say the same, or the index slides.
+        const c = classifyBlock({ type: 'image', uri: 'https://example.invalid/sri-label.png', mimeType: '\u202EImage/PNG\u061C' });
+        assert.strictEqual(c.kind, 'reference');
+        const record = referenceRegistry.register(c.testimony);
+        const h = await startTurn({
+            prefix: 'sri-reference-label-',
+            responses: [[saveCall('call_save', { path: 'files/label.png', index: 0 })], done],
+            seedHistory: (framework) => {
+                framework.getAgent('prime').getContextManager().addMessage('user', [{
+                        type: 'tool_result',
+                        toolUseId: 'call_cam',
+                        toolName: 'mcpl--vst--camera',
+                        content: `[${record.refId}] label.png — Image/PNG, 1.2MB claimed — from tool result — fetch with fetch_reference`,
+                        isError: false,
+                    }]);
+            },
+        });
+        try {
+            const result = await waitForToolResult(h.framework, 'call_save');
+            assert.strictEqual(result.isError, true, `index 0 is the reference, not the older GIF: ${result.content}`);
+            assert.match(result.content, new RegExp(`index 0 is a reference \\(${record.refId}, image/png, from`));
+            assert.ok(!/[\u061C\u202E]/.test(result.content), result.content);
+            assert.strictEqual(await fileBytes(h, 'files/label.png'), null);
+        }
+        finally {
+            await h.framework.stop();
+            rmSync(h.tempDir, { recursive: true, force: true });
+        }
+    });
+    it('an expired reference refuses with its reason; one with a saved copy still points at fetch_reference', async () => {
+        const register = (name) => {
+            const c = classifyBlock({ type: 'image', uri: `https://example.invalid/${name}`, mimeType: 'image/png', expiresAt: '2001-01-01T00:00:00Z' });
+            assert.strictEqual(c.kind, 'reference');
+            return referenceRegistry.register(c.testimony);
+        };
+        const kept = register('sri-expired-kept.png');
+        kept.fetchedPath = 'files/refs/kept.png'; // saved before its expiry passed: fetch_reference serves it
+        const expired = register('sri-expired.png');
+        const h = await startTurn({
+            prefix: 'sri-reference-expired-',
+            responses: [
+                [saveCall('call_save0', { path: 'files/expired.png', index: 0 })],
+                [saveCall('call_save1', { path: 'files/kept.png', index: 1 })],
+                done,
+            ],
+            seedHistory: (framework) => {
+                framework.getAgent('prime').getContextManager().addMessage('user', [{
+                        type: 'tool_result',
+                        toolUseId: 'call_cam',
+                        toolName: 'mcpl--vst--camera',
+                        content: `[${kept.refId}] kept.png — image/png — from tool result — saved: files/refs/kept.png\n`
+                            + `[${expired.refId}] expired.png — image/png — from tool result — expired: its expiresAt has passed`,
+                        isError: false,
+                    }]);
+            },
+        });
+        try {
+            const refused = await waitForToolResult(h.framework, 'call_save0');
+            assert.strictEqual(refused.isError, true);
+            assert.match(refused.content, new RegExp(`index 0 is a reference \\(${expired.refId}, image/png, from`));
+            assert.match(refused.content, /It can't be fetched either — expired: its expiresAt has passed\./);
+            assert.ok(!refused.content.includes('fetch_reference'), refused.content);
+            const keptRefusal = await waitForToolResult(h.framework, 'call_save1');
+            assert.strictEqual(keptRefusal.isError, true);
+            assert.match(keptRefusal.content, new RegExp(`index 1 is a reference \\(${kept.refId}, image/png, from`));
+            assert.match(keptRefusal.content, /Fetch it with fetch_reference and save the materialized file instead\./);
+        }
+        finally {
+            await h.framework.stop();
+            rmSync(h.tempDir, { recursive: true, force: true });
+        }
+    });
+    it("an attachment's media type is shown and stored as a label, and one with nothing left counts as absent", async () => {
+        // The store keeps a declared type only for bytes it can't sniff as a
+        // raster image, so these aren't images it knows. Oldest first: a type
+        // with controls in it, one that sanitizes to nothing, and a url-source
+        // image with no type at all (index 0: not inline, so not saveable).
+        const bytes = (tag) => Buffer.from(`not a raster image ${tag}`).toString('base64');
+        const h = await startTurn({
+            prefix: 'sri-attachment-type-',
+            responses: [[saveCall('call_save', { path: 'files/sent.bmp', index: 1, count: 2 })], done],
+            seedHistory: (framework) => {
+                framework.getAgent('prime').getContextManager().addMessage('user', [
+                    { type: 'image', source: { type: 'base64', data: bytes('a'), mediaType: 'image/\u202Ebmp\u0085' } },
+                    { type: 'image', source: { type: 'base64', data: bytes('b'), mediaType: '\u202E\u061C' } },
+                    { type: 'image', source: { type: 'url', url: 'https://example.invalid/sri-url.png' } },
+                ]);
+            },
+        });
+        try {
+            const result = await waitForToolResult(h.framework, 'call_save');
+            assert.ok(!/[\u0085\u061C\u202E]/.test(result.content), result.content);
+            const receipts = saved(result);
+            assert.deepStrictEqual(receipts.map((r) => [r.imageIndex, r.mediaType, r.mimeType]), [
+                [1, 'image/png', 'image/png'],
+                [2, 'image/bmp', 'image/bmp'],
+            ]);
+        }
+        finally {
+            await h.framework.stop();
+            rmSync(h.tempDir, { recursive: true, force: true });
+        }
+    });
+    it('a reference with no record shows its type bounded as a stub would, and says to re-run the tool', async () => {
+        // A stub line the registry has no record of (after a restart, or quoted
+        // text), whose type is far longer than a stub would show.
+        const longType = `image/${'x'.repeat(300)}`;
+        const h = await startTurn({
+            prefix: 'sri-reference-unknown-',
+            responses: [[saveCall('call_save', { path: 'files/long.png', index: 0 })], done],
+            seedHistory: (framework) => {
+                framework.getAgent('prime').getContextManager().addMessage('user', [{
+                        type: 'tool_result',
+                        toolUseId: 'call_cam',
+                        toolName: 'mcpl--vst--camera',
+                        content: `[ref_3_cc02] long.png — ${longType} — from tool result — fetch with fetch_reference`,
+                        isError: false,
+                    }]);
+            },
+        });
+        try {
+            const result = await waitForToolResult(h.framework, 'call_save');
+            assert.strictEqual(result.isError, true);
+            assert.ok(result.content.includes(`(ref_3_cc02, image/${'x'.repeat(113)}…, from`), result.content);
+            assert.match(result.content, /holds no record of it .*If its tool can produce it again, re-run that tool for a fresh reference\./);
+            assert.ok(!result.content.includes('Fetch it with fetch_reference'), result.content);
+        }
+        finally {
+            await h.framework.stop();
+            rmSync(h.tempDir, { recursive: true, force: true });
+        }
+    });
+    it('an image-typed RFC-005 reference stub with no record still occupies a failing slot', async () => {
         const h = await startTurn({
             prefix: 'sri-reference-',
             responses: [
@@ -370,7 +507,7 @@ describe('save_recent_image provenance (issue #104)', () => {
             const result = await waitForToolResult(h.framework, 'call_save');
             assert.strictEqual(result.isError, true);
             assert.match(result.content, /index 0 is a reference \(ref_1_ab3d, image\/png, from mcpl--vst--camera \(call call_cam\)\)/);
-            assert.match(result.content, /fetch_reference/);
+            assert.match(result.content, /holds no record of it/, 'no record here: fetch_reference could only call it unknown');
             assert.strictEqual(await fileBytes(h, 'files/cam.png'), null);
             // The text/plain reference is not an image slot: index 1 is the GIF.
             const gif = saved(await waitForToolResult(h.framework, 'call_save_gif'));
@@ -733,4 +870,105 @@ describe('ToolImageLedger', () => {
         ]);
     });
 });
+it('a write that throws before its tree entry names the images already saved', async () => {
+    const h = await startTurn({
+        prefix: 'sri-throw-',
+        responses: [
+            [snapCall('call_snap')],
+            [saveCall('call_save', { path: 'files/images.png', index: 0, count: 2 })],
+            done,
+        ],
+        workspace: (workspace) => {
+            const write = workspace.writeBinary.bind(workspace);
+            let writes = 0;
+            workspace.writeBinary = async (...args) => {
+                if (++writes === 2)
+                    throw new Error('injected tree exception');
+                return write(...args);
+            };
+        },
+    });
+    try {
+        const result = await waitForToolResult(h.framework, 'call_save');
+        assert.equal(result.isError, true);
+        assert.match(result.content, /injected tree exception/);
+        assert.match(result.content, /already saved: files\/images-0.png/);
+    }
+    finally {
+        await h.framework.stop();
+        rmSync(h.tempDir, { recursive: true, force: true });
+    }
+});
+it('a save whose write fails after its tree entry, through the workspace itself, is reported saved with its failure', async () => {
+    const h = await startTurn({
+        prefix: 'sri-tree-real-',
+        responses: [
+            [snapCall('call_snap')],
+            [saveCall('call_save', { path: 'files/images.png', index: 0, count: 1 })],
+            done,
+        ],
+        workspace: (workspace) => {
+            const ws = workspace;
+            const intents = [...ws.intents.values()][0];
+            intents.update = () => { throw new Error('injected intent exception'); };
+        },
+    });
+    try {
+        const result = await waitForToolResult(h.framework, 'call_save');
+        const files = saved(result);
+        assert.equal(files.length, 1);
+        assert.equal(files[0].inChronicle, true);
+        assert.match(String(files[0].diskCopyError), /the rest of the write failed: injected intent exception/);
+        assert.ok((await fileBytes(h, String(files[0].path)))?.equals(PNG));
+    }
+    finally {
+        await h.framework.stop();
+        rmSync(h.tempDir, { recursive: true, force: true });
+    }
+});
+for (const secondFails of [false, true]) {
+    it(`a tree-only image save ${secondFails ? 'appears in a later failure receipt' : 'succeeds with a disk-copy warning'}`, async () => {
+        const h = await startTurn({
+            prefix: 'sri-tree-only-',
+            responses: [
+                [snapCall('call_snap')],
+                [saveCall('call_save', { path: 'files/images.png', index: 0, count: 2 })],
+                done,
+            ],
+            workspace: (workspace) => {
+                const write = workspace.writeBinary.bind(workspace);
+                let writes = 0;
+                workspace.writeBinary = async (...args) => {
+                    if (++writes === 2 && secondFails)
+                        return { success: false, error: 'tree unavailable', isError: true };
+                    const result = await write(...args);
+                    assert.equal(result.success, true);
+                    return { success: false, data: { inChronicle: true }, error: 'injected disk-copy failure', isError: true };
+                };
+            },
+        });
+        try {
+            const result = await waitForToolResult(h.framework, 'call_save');
+            if (secondFails) {
+                assert.equal(result.isError, true);
+                assert.match(result.content, /tree unavailable/);
+                assert.match(result.content, /already saved: files\/images-0.png/);
+            }
+            else {
+                const files = saved(result);
+                assert.equal(files.length, 2);
+                assert.equal(files[0].path, 'files/images-0.png');
+                assert.equal(files[0].inChronicle, true);
+                assert.match(String(files[0].diskCopyError), /injected disk-copy failure/);
+                assert.equal(files[0].size, PNG.byteLength);
+                assert.equal(files[0].mimeType, 'image/png');
+            }
+            assert.ok((await fileBytes(h, 'files/images-0.png'))?.equals(PNG));
+        }
+        finally {
+            await h.framework.stop();
+            rmSync(h.tempDir, { recursive: true, force: true });
+        }
+    });
+}
 //# sourceMappingURL=save-recent-image.test.js.map