@chatcode/chatcode-cli 3.0.4-rc.7 → 3.0.5-rc.1

package/runtime/node_modules/@deepseek-ai/dsh-workspace-changes/lib/index.js

@@ -1,9 +1,146 @@
 import { homedir, tmpdir } from "node:os";
-import z from "@deepseek-ai/schemastery";
-import { copyFile, mkdir, mkdtemp, open, readFile, realpath, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import z from "@deepseek-ai/schemastery";
+import { chatCodeCliHomePath } from "@deepseek-ai/dsh-home-paths";
 import { createHash } from "node:crypto";
+import { copyFile, mkdir, mkdtemp, open, readFile, realpath, rename, rm, writeFile } from "node:fs/promises";
+import { promisify } from "node:util";
+import { gunzip, gzip } from "node:zlib";
 import { structuredPatch } from "diff";
+//#region lib/types/archive.js
+/** Durable change summaries and compressed file comparisons, independent of temporary git snapshots. */
+const compress = promisify(gzip);
+const decompress = promisify(gunzip);
+/** Stores completed turn records until their Session is permanently deleted. */
+var ChangesArchive = class {
+	directory;
+	constructor(directory) {
+		this.directory = directory;
+	}
+	sessionDirectory(sessionId) {
+		return join(this.directory, createHash("sha256").update(sessionId).digest("hex"));
+	}
+	/**
+	* Save the summary and each listed comparison before publishing its event.
+	* @param sessionId - owning Session.
+	* @param summary - complete summary, including the Host working directory.
+	* @param diff - resolves one comparison from the turn's immutable snapshots.
+	* @param signal - cancels staging before the event is appended.
+	* @returns a staged record to commit with the event's sequence and then dispose.
+	*/
+	async stage(sessionId, summary, diff, signal) {
+		const parent = this.sessionDirectory(sessionId);
+		await mkdir(parent, {
+			recursive: true,
+			mode: 448
+		});
+		const staging = await mkdtemp(join(parent, ".pending-"));
+		try {
+			await writeFile(join(staging, "summary.json"), JSON.stringify({
+				version: 1,
+				summary
+			}), {
+				mode: 384,
+				signal
+			});
+			for (let index = 0; index < summary.files.length; index += 1) {
+				signal.throwIfAborted();
+				const bytes = await compress(JSON.stringify(await diff(index)));
+				await writeFile(join(staging, `${index}.json.gz`), bytes, {
+					mode: 384,
+					signal
+				});
+			}
+			signal.throwIfAborted();
+			return {
+				commit: (seq) => rename(staging, join(parent, String(seq))),
+				dispose: () => rm(staging, {
+					recursive: true,
+					force: true
+				})
+			};
+		} catch (error) {
+			await rm(staging, {
+				recursive: true,
+				force: true
+			});
+			throw error;
+		}
+	}
+	/**
+	* Read an archived summary without opening a live Session or its repository.
+	* @param sessionId - owning Session.
+	* @param seq - announcing event sequence.
+	* @returns the validated summary, or undefined when no archive exists.
+	*/
+	async summary(sessionId, seq) {
+		const bytes = await readMissing(join(this.sessionDirectory(sessionId), String(seq), "summary.json"));
+		if (bytes === void 0) return void 0;
+		const value = JSON.parse(bytes.toString("utf8"));
+		if (!record(value) || value.version !== 1 || !isSummary(value.summary)) throw new Error("Invalid workspace change archive summary");
+		return value.summary;
+	}
+	/**
+	* Read a stored comparison independently of later workspace edits or git cleanup.
+	* @param sessionId - owning Session.
+	* @param seq - announcing event sequence.
+	* @param index - listed file index.
+	* @param signal - cancellation.
+	* @returns the validated comparison, or undefined for a missing record or index.
+	*/
+	async diff(sessionId, seq, index, signal) {
+		const bytes = await readMissing(join(this.sessionDirectory(sessionId), String(seq), `${index}.json.gz`), signal);
+		if (bytes === void 0) return void 0;
+		const value = JSON.parse((await decompress(bytes)).toString("utf8"));
+		signal.throwIfAborted();
+		if (!isDiff(value)) throw new Error("Invalid workspace change archive comparison");
+		return value;
+	}
+	/**
+	* Remove secondary records when the Session is permanently deleted.
+	* @param sessionId - deleted Session.
+	* @returns after its archive directory has been removed.
+	*/
+	remove(sessionId) {
+		return rm(this.sessionDirectory(sessionId), {
+			recursive: true,
+			force: true
+		});
+	}
+};
+async function readMissing(file, signal) {
+	try {
+		return await readFile(file, signal === void 0 ? {} : { signal });
+	} catch (error) {
+		if (record(error) && error.code === "ENOENT") return void 0;
+		throw error;
+	}
+}
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function count(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function pathFields(value) {
+	return typeof value.path === "string" && value.path.length > 0 && typeof value.display === "string" && value.display.length > 0;
+}
+function isSummary(value) {
+	if (!record(value)) return false;
+	const { turn, cwd, files, total, added, deleted, snapshot } = value;
+	return count(turn) && turn > 0 && typeof cwd === "string" && isAbsolute(cwd) && count(total) && count(added) && count(deleted) && Array.isArray(files) && files.length <= total && files.every((file) => record(file) && pathFields(file) && count(file.added) && count(file.deleted) && (file.binary === void 0 || file.binary === true) && (file.oversized === void 0 || file.oversized === true)) && (snapshot === void 0 || record(snapshot) && typeof snapshot.before === "string" && typeof snapshot.after === "string");
+}
+function isDiff(value) {
+	if (!record(value) || !pathFields(value)) return false;
+	if (value.kind === "binary" || value.kind === "oversized") return true;
+	return value.kind === "text" && typeof value.before === "boolean" && typeof value.after === "boolean" && typeof value.coarse === "boolean" && Array.isArray(value.hunks) && value.hunks.every((hunk) => record(hunk) && [
+		hunk.oldStart,
+		hunk.oldLines,
+		hunk.newStart,
+		hunk.newLines
+	].every(count) && Array.isArray(hunk.lines) && hunk.lines.every((line) => typeof line === "string" && /^[+ -]/.test(line)));
+}
+//#endregion
 //#region lib/types/numstat.js
 /** Parsing of `git diff-tree --numstat -z` output. */
 /**
@@ -620,8 +757,9 @@ const OVERSIZED = Symbol("oversized");
 * with its diff, and the appended `workspace/changes` event whose summary and
 * comparisons this recorder keeps. Snapshot objects and captured copies live in
 * a temporary directory owned by the recorder; disposal removes it together
-* with the summaries. Tool execution waits for pending work so a snapshot or
-* capture never races a mutation. A working directory outside any repository,
+* with the live records; the durable archive retains the summaries and comparisons.
+* Tool execution waits for pending work so a snapshot or capture never races a mutation.
+* A working directory outside any repository,
 * or a Host without git, gets no snapshot; its summary lists the files the file
 * tools changed.
 */
@@ -742,9 +880,17 @@ var TurnRecorder = class {
 	*/
 	async diff(seq, index, signal) {
 		const record = this.records.get(seq);
-		const file = record?.summary.files[index];
-		const sources = record?.sources[index];
-		if (file === void 0 || sources === void 0) return void 0;
+		if (record === void 0 || record.summary.files[index] === void 0) return void 0;
+		try {
+			return await this.compare(record, index, signal);
+		} catch (error) {
+			if (this.lifetime.signal.aborted) return void 0;
+			throw error;
+		}
+	}
+	async compare(record, index, signal) {
+		const file = record.summary.files[index];
+		const sources = record.sources[index];
 		const { path, display } = file;
 		if (sources.refusal !== void 0) return {
 			kind: sources.refusal,
@@ -752,27 +898,22 @@ var TurnRecorder = class {
 			display
 		};
 		const combined = AbortSignal.any([signal, this.lifetime.signal]);
-		try {
-			const [before, after] = await Promise.all([this.readSide(sources.before, combined), this.readSide(sources.after, combined)]);
-			if (before === OVERSIZED || after === OVERSIZED) return {
-				kind: "oversized",
-				path,
-				display
-			};
-			const { hunks, coarse } = compareText(before, after, this.env.diffTimeoutMs);
-			return {
-				kind: "text",
-				path,
-				display,
-				before: before !== null,
-				after: after !== null,
-				hunks,
-				coarse
-			};
-		} catch (error) {
-			if (this.lifetime.signal.aborted) return void 0;
-			throw error;
-		}
+		const [before, after] = await Promise.all([this.readSide(sources.before, combined), this.readSide(sources.after, combined)]);
+		if (before === OVERSIZED || after === OVERSIZED) return {
+			kind: "oversized",
+			path,
+			display
+		};
+		const { hunks, coarse } = compareText(before, after, this.env.diffTimeoutMs);
+		return {
+			kind: "text",
+			path,
+			display,
+			before: before !== null,
+			after: after !== null,
+			hunks,
+			coarse
+		};
 	}
 	/**
 	* Abort queued work, forget every record, and remove the temporary directory.
@@ -815,6 +956,8 @@ var TurnRecorder = class {
 		if (git === null) return null;
 		const workspace = await locateGitWorkspace(git, cwd, () => this.scratchDir(), signal);
 		if (workspace === null) return null;
+		const archive = await canonicalPath(this.env.archive.directory);
+		if (isInside(workspace.root, archive)) workspace.excludes = [...workspace.excludes, toPosix(relative(workspace.root, archive))];
 		this.repository = {
 			git,
 			workspace
@@ -894,9 +1037,8 @@ var TurnRecorder = class {
 		}
 		const sorted = [...listed.values()].sort((a, b) => compareDisplay(a.file, b.file));
 		if (sorted.length === 0 && state.recordedAfterSeq < 0) return;
-		const event = this.session.append("workspace/changes", { turn: state.turn });
 		const kept = sorted.slice(0, this.env.maxFiles);
-		this.records.set(event.seq, {
+		const record = {
 			summary: {
 				turn: state.turn,
 				cwd: this.cwd,
@@ -907,8 +1049,17 @@ var TurnRecorder = class {
 				...snapshot === void 0 ? {} : { snapshot }
 			},
 			sources: kept.map((entry) => entry.sources)
-		});
-		state.recordedAfterSeq = event.seq;
+		};
+		const staged = await this.env.archive.stage(this.session.id, record.summary, (index) => this.compare(record, index, signal), signal);
+		try {
+			signal.throwIfAborted();
+			const event = this.session.append("workspace/changes", { turn: state.turn });
+			this.records.set(event.seq, record);
+			state.recordedAfterSeq = event.seq;
+			await staged.commit(event.seq);
+		} finally {
+			await staged.dispose();
+		}
 	}
 	/**
 	* The listing of a captured pair: an oversized side lists the file without
@@ -966,8 +1117,8 @@ function changedFile({ cwd, home }, root, absolute, counts) {
 * listed file's before-and-after comparison on demand. Each summary is
 * announced by a `workspace/changes` Session event that carries only the turn
 * number; summaries and comparisons are served through the `workspaceChanges`
-* service until the Session is disposed. Outside a git repository, or without
-* git, the summary lists file-tool edits only.
+* service across Host restarts until the Session is permanently deleted.
+* Outside a git repository, or without git, the summary lists file-tool edits only.
 */
 /** Stable Loader identity. */
 const name = "workspace-changes";
@@ -975,6 +1126,7 @@ const name = "workspace-changes";
 const inject = ["subprocess"];
 /** Schemastery validation for {@link Config}. */
 const Config = z.object({
+	directory: z.string().default(chatCodeCliHomePath("workspace-changes")),
 	timeoutMs: z.number().default(3e4),
 	outputMaxBytes: z.number().default(8 * 1024 * 1024),
 	maxFiles: z.number().default(500),
@@ -1021,6 +1173,7 @@ async function resolveGit(ctx, signal) {
 * @param config - validated bounds.
 */
 function apply(ctx, config) {
+	if (!isAbsolute(config.directory)) throw new Error("workspace-changes requires an absolute directory");
 	for (const [field, value] of [
 		["timeoutMs", config.timeoutMs],
 		["outputMaxBytes", config.outputMaxBytes],
@@ -1029,21 +1182,27 @@ function apply(ctx, config) {
 		["diffTimeoutMs", config.diffTimeoutMs]
 	]) if (!Number.isSafeInteger(value) || value < 1) throw new Error(`workspace-changes requires a positive integer ${field}`);
 	const lifetime = new AbortController();
+	const archive = new ChangesArchive(config.directory);
 	const recorders = /* @__PURE__ */ new Map();
 	const byId = /* @__PURE__ */ new Map();
+	const retiring = /* @__PURE__ */ new Set();
 	const forget = (session) => {
 		const recorder = recorders.get(session);
 		recorders.delete(session);
 		byId.delete(session.id);
-		return recorder?.dispose() ?? Promise.resolve();
+		if (recorder === void 0) return Promise.resolve();
+		const disposal = recorder.dispose();
+		retiring.add(disposal);
+		disposal.then(() => retiring.delete(disposal), () => retiring.delete(disposal));
+		return disposal;
 	};
 	ctx.effect(() => async () => {
 		lifetime.abort();
-		await Promise.all([...recorders.keys()].map(forget));
+		await Promise.all([...recorders.keys()].map(forget).concat([...retiring]));
 	});
 	ctx.provide("workspaceChanges", {
-		summary: (sessionId, seq) => byId.get(sessionId)?.summary(seq),
-		diff: (sessionId, seq, index, signal) => byId.get(sessionId)?.diff(seq, index, signal) ?? Promise.resolve(void 0)
+		summary: async (sessionId, seq) => byId.get(sessionId)?.summary(seq) ?? archive.summary(sessionId, seq),
+		diff: async (sessionId, seq, index, signal) => await archive.diff(sessionId, seq, index, signal) ?? byId.get(sessionId)?.diff(seq, index, signal)
 	});
 	let runner;
 	const gitRunner = () => {
@@ -1063,6 +1222,7 @@ function apply(ctx, config) {
 		let recorder = recorders.get(session);
 		if (recorder === void 0) {
 			recorder = new TurnRecorder(session, cwd, {
+				archive,
 				git: gitRunner(),
 				tempRoot: tmpdir(),
 				maxFiles: config.maxFiles,
@@ -1087,7 +1247,16 @@ function apply(ctx, config) {
 		else if (event.type === "turn/end") recorders.get(session)?.end(event.data.turn);
 	});
 	ctx.on("session/disposed", (session) => {
-		forget(session);
+		forget(session).catch((error) => {
+			ctx.logger.warn(`workspace-changes: ${String(error)}`);
+		});
+	});
+	ctx.on("session/deleting", async ({ sessionIds }) => {
+		for (const sessionId of sessionIds) {
+			const session = [...recorders.keys()].find((candidate) => candidate.id === sessionId);
+			if (session !== void 0) await forget(session);
+			await archive.remove(sessionId);
+		}
 	});
 	ctx.on("agent/turn-stopping", async ({ agent, turn }) => {
 		await recorders.get(agent.session)?.stopping(turn);

package/runtime/node_modules/@deepseek-ai/dsh-workspace-changes/lib/types/archive.d.ts

@@ -0,0 +1,47 @@
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { WorkspaceChangesSummary, WorkspaceFileDiff } from './types.ts';
+/** A complete comparison set awaiting its announcing event's sequence. */
+export interface StagedChanges {
+    /** Publish the directory atomically under the announcing event's sequence. */
+    commit(seq: number): Promise<void>;
+    /** Remove any unpublished staging directory. */
+    dispose(): Promise<void>;
+}
+/** Stores completed turn records until their Session is permanently deleted. */
+export declare class ChangesArchive {
+    readonly directory: string;
+    constructor(directory: string);
+    private sessionDirectory;
+    /**
+     * Save the summary and each listed comparison before publishing its event.
+     * @param sessionId - owning Session.
+     * @param summary - complete summary, including the Host working directory.
+     * @param diff - resolves one comparison from the turn's immutable snapshots.
+     * @param signal - cancels staging before the event is appended.
+     * @returns a staged record to commit with the event's sequence and then dispose.
+     */
+    stage(sessionId: SessionId, summary: WorkspaceChangesSummary, diff: (index: number) => Promise<WorkspaceFileDiff>, signal: AbortSignal): Promise<StagedChanges>;
+    /**
+     * Read an archived summary without opening a live Session or its repository.
+     * @param sessionId - owning Session.
+     * @param seq - announcing event sequence.
+     * @returns the validated summary, or undefined when no archive exists.
+     */
+    summary(sessionId: SessionId, seq: number): Promise<WorkspaceChangesSummary | undefined>;
+    /**
+     * Read a stored comparison independently of later workspace edits or git cleanup.
+     * @param sessionId - owning Session.
+     * @param seq - announcing event sequence.
+     * @param index - listed file index.
+     * @param signal - cancellation.
+     * @returns the validated comparison, or undefined for a missing record or index.
+     */
+    diff(sessionId: SessionId, seq: number, index: number, signal: AbortSignal): Promise<WorkspaceFileDiff | undefined>;
+    /**
+     * Remove secondary records when the Session is permanently deleted.
+     * @param sessionId - deleted Session.
+     * @returns after its archive directory has been removed.
+     */
+    remove(sessionId: SessionId): Promise<void>;
+}
+//# sourceMappingURL=archive.d.ts.map

package/runtime/node_modules/@deepseek-ai/dsh-workspace-changes/lib/types/archive.js

@@ -0,0 +1,129 @@
+/** Durable change summaries and compressed file comparisons, independent of temporary git snapshots. */
+import { createHash } from 'node:crypto';
+import { mkdir, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { promisify } from 'node:util';
+import { gzip, gunzip } from 'node:zlib';
+const compress = promisify(gzip);
+const decompress = promisify(gunzip);
+/** Stores completed turn records until their Session is permanently deleted. */
+export class ChangesArchive {
+    directory;
+    constructor(directory) {
+        this.directory = directory;
+    }
+    sessionDirectory(sessionId) {
+        return join(this.directory, createHash('sha256').update(sessionId).digest('hex'));
+    }
+    /**
+     * Save the summary and each listed comparison before publishing its event.
+     * @param sessionId - owning Session.
+     * @param summary - complete summary, including the Host working directory.
+     * @param diff - resolves one comparison from the turn's immutable snapshots.
+     * @param signal - cancels staging before the event is appended.
+     * @returns a staged record to commit with the event's sequence and then dispose.
+     */
+    async stage(sessionId, summary, diff, signal) {
+        const parent = this.sessionDirectory(sessionId);
+        await mkdir(parent, { recursive: true, mode: 0o700 });
+        const staging = await mkdtemp(join(parent, '.pending-'));
+        try {
+            await writeFile(join(staging, 'summary.json'), JSON.stringify({ version: 1, summary }), { mode: 0o600, signal });
+            for (let index = 0; index < summary.files.length; index += 1) {
+                signal.throwIfAborted();
+                const bytes = await compress(JSON.stringify(await diff(index)));
+                await writeFile(join(staging, `${index}.json.gz`), bytes, { mode: 0o600, signal });
+            }
+            signal.throwIfAborted();
+            return {
+                commit: seq => rename(staging, join(parent, String(seq))),
+                dispose: () => rm(staging, { recursive: true, force: true }),
+            };
+        }
+        catch (error) {
+            await rm(staging, { recursive: true, force: true });
+            throw error;
+        }
+    }
+    /**
+     * Read an archived summary without opening a live Session or its repository.
+     * @param sessionId - owning Session.
+     * @param seq - announcing event sequence.
+     * @returns the validated summary, or undefined when no archive exists.
+     */
+    async summary(sessionId, seq) {
+        const bytes = await readMissing(join(this.sessionDirectory(sessionId), String(seq), 'summary.json'));
+        if (bytes === undefined)
+            return undefined;
+        const value = JSON.parse(bytes.toString('utf8'));
+        if (!record(value) || value.version !== 1 || !isSummary(value.summary))
+            throw new Error('Invalid workspace change archive summary');
+        return value.summary;
+    }
+    /**
+     * Read a stored comparison independently of later workspace edits or git cleanup.
+     * @param sessionId - owning Session.
+     * @param seq - announcing event sequence.
+     * @param index - listed file index.
+     * @param signal - cancellation.
+     * @returns the validated comparison, or undefined for a missing record or index.
+     */
+    async diff(sessionId, seq, index, signal) {
+        const bytes = await readMissing(join(this.sessionDirectory(sessionId), String(seq), `${index}.json.gz`), signal);
+        if (bytes === undefined)
+            return undefined;
+        const value = JSON.parse((await decompress(bytes)).toString('utf8'));
+        signal.throwIfAborted();
+        if (!isDiff(value))
+            throw new Error('Invalid workspace change archive comparison');
+        return value;
+    }
+    /**
+     * Remove secondary records when the Session is permanently deleted.
+     * @param sessionId - deleted Session.
+     * @returns after its archive directory has been removed.
+     */
+    remove(sessionId) {
+        return rm(this.sessionDirectory(sessionId), { recursive: true, force: true });
+    }
+}
+async function readMissing(file, signal) {
+    try {
+        return await readFile(file, signal === undefined ? {} : { signal });
+    }
+    catch (error) {
+        if (record(error) && error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function count(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+}
+function pathFields(value) {
+    return typeof value.path === 'string' && value.path.length > 0 && typeof value.display === 'string' && value.display.length > 0;
+}
+function isSummary(value) {
+    if (!record(value))
+        return false;
+    const { turn, cwd, files, total, added, deleted, snapshot } = value;
+    return count(turn) && turn > 0 && typeof cwd === 'string' && isAbsolute(cwd) && count(total) && count(added) && count(deleted)
+        && Array.isArray(files) && files.length <= total && files.every(file => record(file) && pathFields(file)
+        && count(file.added) && count(file.deleted) && (file.binary === undefined || file.binary === true)
+        && (file.oversized === undefined || file.oversized === true))
+        && (snapshot === undefined || (record(snapshot) && typeof snapshot.before === 'string' && typeof snapshot.after === 'string'));
+}
+function isDiff(value) {
+    if (!record(value) || !pathFields(value))
+        return false;
+    if (value.kind === 'binary' || value.kind === 'oversized')
+        return true;
+    return value.kind === 'text' && typeof value.before === 'boolean' && typeof value.after === 'boolean'
+        && typeof value.coarse === 'boolean' && Array.isArray(value.hunks) && value.hunks.every(hunk => record(hunk)
+        && [hunk.oldStart, hunk.oldLines, hunk.newStart, hunk.newLines].every(count)
+        && Array.isArray(hunk.lines) && hunk.lines.every(line => typeof line === 'string' && /^[+ -]/.test(line)));
+}
+//# sourceMappingURL=archive.js.map

package/runtime/node_modules/@deepseek-ai/dsh-workspace-changes/lib/types/index.d.ts

@@ -7,6 +7,8 @@ export declare const name = "workspace-changes";
 export declare const inject: string[];
 /** Snapshot, capture, and comparison bounds. Invalid values fail plugin load. */
 export interface Config {
+    /** Absolute directory retaining summaries and comparisons across Host restarts. */
+    directory: string;
     /** Milliseconds one git command may run before the turn's record is abandoned. */
     timeoutMs: number;
     /** Bytes of git output retained per command; a larger diff listing abandons the record. */

package/runtime/node_modules/@deepseek-ai/dsh-workspace-changes/lib/types/index.js

@@ -5,11 +5,14 @@
  * listed file's before-and-after comparison on demand. Each summary is
  * announced by a `workspace/changes` Session event that carries only the turn
  * number; summaries and comparisons are served through the `workspaceChanges`
- * service until the Session is disposed. Outside a git repository, or without
- * git, the summary lists file-tool edits only.
+ * service across Host restarts until the Session is permanently deleted.
+ * Outside a git repository, or without git, the summary lists file-tool edits only.
  */
 import { homedir, tmpdir } from 'node:os';
+import { isAbsolute } from 'node:path';
 import z from '@deepseek-ai/schemastery';
+import { chatCodeCliHomePath } from '@deepseek-ai/dsh-home-paths';
+import { ChangesArchive } from "./archive.js";
 import { GitRunner } from "./git.js";
 import { TurnRecorder } from "./recorder.js";
 /** Stable Loader identity. */
@@ -18,6 +21,7 @@ export const name = 'workspace-changes';
 export const inject = ['subprocess'];
 /** Schemastery validation for {@link Config}. */
 export const Config = z.object({
+    directory: z.string().default(chatCodeCliHomePath('workspace-changes')),
     timeoutMs: z.number().default(30_000),
     outputMaxBytes: z.number().default(8 * 1024 * 1024),
     maxFiles: z.number().default(500),
@@ -61,6 +65,8 @@ async function resolveGit(ctx, signal) {
  * @param config - validated bounds.
  */
 export function apply(ctx, config) {
+    if (!isAbsolute(config.directory))
+        throw new Error('workspace-changes requires an absolute directory');
     for (const [field, value] of [
         ['timeoutMs', config.timeoutMs], ['outputMaxBytes', config.outputMaxBytes], ['maxFiles', config.maxFiles],
         ['maxFileBytes', config.maxFileBytes], ['diffTimeoutMs', config.diffTimeoutMs],
@@ -69,21 +75,28 @@ export function apply(ctx, config) {
             throw new Error(`workspace-changes requires a positive integer ${field}`);
     }
     const lifetime = new AbortController();
+    const archive = new ChangesArchive(config.directory);
     const recorders = new Map();
     const byId = new Map();
+    const retiring = new Set();
     const forget = (session) => {
         const recorder = recorders.get(session);
         recorders.delete(session);
         byId.delete(session.id);
-        return recorder?.dispose() ?? Promise.resolve();
+        if (recorder === undefined)
+            return Promise.resolve();
+        const disposal = recorder.dispose();
+        retiring.add(disposal);
+        void disposal.then(() => retiring.delete(disposal), () => retiring.delete(disposal));
+        return disposal;
     };
     ctx.effect(() => async () => {
         lifetime.abort();
-        await Promise.all([...recorders.keys()].map(forget));
+        await Promise.all([...recorders.keys()].map(forget).concat([...retiring]));
     });
     const service = {
-        summary: (sessionId, seq) => byId.get(sessionId)?.summary(seq),
-        diff: (sessionId, seq, index, signal) => byId.get(sessionId)?.diff(seq, index, signal) ?? Promise.resolve(undefined),
+        summary: async (sessionId, seq) => byId.get(sessionId)?.summary(seq) ?? archive.summary(sessionId, seq),
+        diff: async (sessionId, seq, index, signal) => await archive.diff(sessionId, seq, index, signal) ?? byId.get(sessionId)?.diff(seq, index, signal),
     };
     ctx.provide('workspaceChanges', service);
     let runner;
@@ -101,7 +114,7 @@ export function apply(ctx, config) {
         let recorder = recorders.get(session);
         if (recorder === undefined) {
             recorder = new TurnRecorder(session, cwd, {
-                git: gitRunner(), tempRoot: tmpdir(), maxFiles: config.maxFiles,
+                archive, git: gitRunner(), tempRoot: tmpdir(), maxFiles: config.maxFiles,
                 maxFileBytes: config.maxFileBytes, diffTimeoutMs: config.diffTimeoutMs,
                 warn: (message) => { ctx.logger.warn(message); },
             });
@@ -122,7 +135,17 @@ export function apply(ctx, config) {
         else if (event.type === 'turn/end')
             recorders.get(session)?.end(event.data.turn);
     });
-    ctx.on('session/disposed', (session) => { void forget(session); });
+    ctx.on('session/disposed', (session) => {
+        void forget(session).catch((error) => { ctx.logger.warn(`workspace-changes: ${String(error)}`); });
+    });
+    ctx.on('session/deleting', async ({ sessionIds }) => {
+        for (const sessionId of sessionIds) {
+            const session = [...recorders.keys()].find(candidate => candidate.id === sessionId);
+            if (session !== undefined)
+                await forget(session);
+            await archive.remove(sessionId);
+        }
+    });
     ctx.on('agent/turn-stopping', async ({ agent, turn }) => {
         await recorders.get(agent.session)?.stopping(turn);
     });

package/runtime/node_modules/@deepseek-ai/dsh-workspace-changes/lib/types/recorder.d.ts

@@ -1,8 +1,11 @@
 import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
+import type { ChangesArchive } from './archive.ts';
 import { type GitRunner } from './git.ts';
 import type { WorkspaceChangesSummary, WorkspaceFileDiff } from './types.ts';
 /** Facts shared by every recorder of one plugin instance. */
 export interface RecorderEnvironment {
+    /** Durable summaries and comparisons, retained after recorder disposal. */
+    archive: ChangesArchive;
     /** Resolves to the runner, or null when git is unavailable and no snapshot is taken. */
     git: Promise<GitRunner | null>;
     /** Directory that receives each Session's temporary directory. */
@@ -22,8 +25,9 @@ export interface RecorderEnvironment {
  * with its diff, and the appended `workspace/changes` event whose summary and
  * comparisons this recorder keeps. Snapshot objects and captured copies live in
  * a temporary directory owned by the recorder; disposal removes it together
- * with the summaries. Tool execution waits for pending work so a snapshot or
- * capture never races a mutation. A working directory outside any repository,
+ * with the live records; the durable archive retains the summaries and comparisons.
+ * Tool execution waits for pending work so a snapshot or capture never races a mutation.
+ * A working directory outside any repository,
  * or a Host without git, gets no snapshot; its summary lists the files the file
  * tools changed.
  */
@@ -90,6 +94,7 @@ export declare class TurnRecorder {
      * @throws when a read fails while the recorder lives.
      */
     diff(seq: number, index: number, signal: AbortSignal): Promise<WorkspaceFileDiff | undefined>;
+    private compare;
     /**
      * Abort queued work, forget every record, and remove the temporary directory.
      * @returns once the temporary directory is gone.