@office-kit/pptx-dev 0.7.0 → 0.8.2

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { a as createDeckBuilder, i as initProject, n as exportDeck, r as inspectTemplate } from "./src-CdlqA8pS.mjs";
 import { createRequire } from "node:module";
-import { chmod, mkdir, readFile, realpath, stat, writeFile } from "node:fs/promises";
+import { chmod, lstat, mkdir, readFile, readdir, realpath, stat, unlink, writeFile } from "node:fs/promises";
 import { dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { watch } from "node:fs";
 import ts from "typescript";
@@ -10,87 +10,248 @@ import { chromium } from "playwright";
 import { createServer } from "node:http";
 import MarkdownIt from "markdown-it";
 import { spawn } from "node:child_process";
+//#region src/history.ts
+const SNAPSHOT_LIMIT = 64 * 1024 * 1024;
+const HISTORY_LIMIT = 128 * 1024 * 1024;
+const ENTRY_LIMIT = 50;
+const ignored = new Set([
+	"node_modules",
+	".git",
+	"dist",
+	".office-kit"
+]);
+const historyFile = (name) => !name.split(sep).some((part) => ignored.has(part)) && /\.([cm]?[jt]sx?|json|css|md|ya?ml|pptx|png|jpe?g|gif|bmp|tiff?|emf|wmf|svg)$/i.test(name);
+const equal = (a, b) => a === b || !!a && !!b && a.equals(b);
+/** Session-local project history. Overlapping agent turns form one transaction. */
+async function createHistory(directory, notify = () => {}) {
+	const root = await realpath(directory);
+	let baseline = /* @__PURE__ */ new Map();
+	let initialized = false;
+	const past = [], future = [];
+	const active = /* @__PURE__ */ new Set();
+	let label = "";
+	let error = null;
+	let queue = Promise.resolve();
+	let restoring = false;
+	function serial(action) {
+		const result = queue.then(action);
+		queue = result.then(() => {}, () => {});
+		return result.catch((cause) => {
+			error = cause instanceof Error ? cause.message : String(cause);
+			throw cause;
+		}).finally(notify);
+	}
+	async function snapshot() {
+		const files = /* @__PURE__ */ new Map();
+		let bytes = 0;
+		async function visit(dir) {
+			const entries = await readdir(dir, { withFileTypes: true });
+			await Promise.all(entries.map(async (item) => {
+				if (ignored.has(item.name) || item.isSymbolicLink()) return;
+				const file = join(dir, item.name);
+				if (item.isDirectory()) return visit(file);
+				if (!item.isFile() || !historyFile(file)) return;
+				const info = await lstat(file);
+				bytes += info.size;
+				if (bytes > SNAPSHOT_LIMIT) throw new Error("Undo history exceeds 64 MiB of project source/assets. Move unused assets outside the deck folder.");
+				if (info.isSymbolicLink() || await realpath(file) !== file) throw new Error("Project paths changed while recording history. Try again.");
+				const content = await readFile(file);
+				files.set(relative(root, file), content);
+			}));
+		}
+		await visit(root);
+		return files;
+	}
+	function record(next, description) {
+		if (!initialized) {
+			baseline = next;
+			initialized = true;
+			error = null;
+			return;
+		}
+		const changes = [];
+		for (const file of new Set([...baseline.keys(), ...next.keys()])) {
+			const before = baseline.get(file), after = next.get(file);
+			if (!equal(before, after)) changes.push({
+				file,
+				before,
+				after
+			});
+		}
+		if (changes.length) {
+			past.push({
+				label: description,
+				changes
+			});
+			future.length = 0;
+			const size = () => past.reduce((sum, item) => sum + item.changes.reduce((n, change) => n + (change.before?.length ?? 0) + (change.after?.length ?? 0), 0), 0);
+			while (past.length > ENTRY_LIMIT || past.length > 1 && size() > HISTORY_LIMIT) past.shift();
+		}
+		baseline = next;
+		error = null;
+	}
+	async function contents(file) {
+		const path = join(root, file);
+		let parent = dirname(path);
+		while (true) try {
+			if (await realpath(parent) !== parent) throw new Error("Undo refused: a project directory is now a symbolic link.");
+			break;
+		} catch (cause) {
+			if (cause.code !== "ENOENT") throw cause;
+			parent = dirname(parent);
+		}
+		try {
+			const info = await lstat(path);
+			if (!info.isFile() || info.isSymbolicLink()) throw new Error("Undo refused: a project file changed type.");
+			return await readFile(path);
+		} catch (cause) {
+			if (cause.code === "ENOENT") return void 0;
+			throw cause;
+		}
+	}
+	async function replace(change, expected, next) {
+		if (!equal(await contents(change.file), expected)) throw new Error(`History conflict in ${change.file}. Newer changes were preserved.`);
+		const file = join(root, change.file);
+		if (next) {
+			await mkdir(dirname(file), { recursive: true });
+			await writeFile(file, next);
+		} else await unlink(file);
+	}
+	try {
+		record(await snapshot(), "Initial state");
+	} catch (cause) {
+		error = cause instanceof Error ? cause.message : String(cause);
+	}
+	return {
+		state: () => ({
+			undo: past.at(-1)?.label ?? null,
+			redo: future.at(-1)?.label ?? null,
+			busy: active.size > 0 || restoring,
+			error
+		}),
+		capture: () => serial(async () => {
+			if (!active.size && !restoring) record(await snapshot(), "Source edit");
+		}),
+		begin: (id, description) => serial(async () => {
+			if (active.has(id)) return;
+			if (!active.size) {
+				record(await snapshot(), "Source edit");
+				label = description;
+			} else label = "Concurrent edits";
+			active.add(id);
+		}),
+		end: (id) => serial(async () => {
+			if (!active.delete(id) || active.size) return;
+			record(await snapshot(), label);
+		}),
+		move: (direction) => serial(async () => {
+			if (active.size) throw new Error("Wait for all agents and text edits to finish before using Undo or Redo.");
+			record(await snapshot(), "Source edit");
+			const from = direction === "undo" ? past : future;
+			const to = direction === "undo" ? future : past;
+			const item = from.at(-1);
+			if (!item) throw new Error(`Nothing to ${direction}.`);
+			const before = (c) => direction === "undo" ? c.after : c.before;
+			const after = (c) => direction === "undo" ? c.before : c.after;
+			const applied = [];
+			restoring = true;
+			try {
+				await Promise.all(item.changes.map(async (change) => {
+					if (!equal(await contents(change.file), before(change))) throw new Error(`History conflict in ${change.file}. Newer changes were preserved.`);
+				}));
+				for (const change of item.changes) {
+					await replace(change, before(change), after(change));
+					applied.push(change);
+				}
+				for (const change of item.changes) {
+					const content = after(change);
+					if (content) baseline.set(change.file, content);
+					else baseline.delete(change.file);
+				}
+				from.pop();
+				to.push(item);
+				error = null;
+			} catch (cause) {
+				const failures = [];
+				for (const change of applied.reverse()) try {
+					await replace(change, after(change), before(change));
+				} catch (rollback) {
+					failures.push(String(rollback));
+				}
+				if (failures.length) throw new Error(`${String(cause)}; rollback incomplete: ${failures.join("; ")}`);
+				throw cause;
+			} finally {
+				restoring = false;
+			}
+		})
+	};
+}
+//#endregion
 //#region src/text-edit.ts
 /** Literal edits are deliberately conservative: computed and ambiguous text goes to the agent. */
 function createTextEditor(entry, preview, verify) {
 	let busy = false;
-	let undo;
 	async function restore(change) {
 		if (await realpath(change.file) !== change.file || await readFile(change.file, "utf8") !== change.after) throw new Error("Source changed during editing. Your newer changes were preserved.");
 		await writeFile(change.file, change.before);
 	}
-	return {
-		async edit(value) {
-			if (busy) throw new Error("A text edit is already running.");
-			busy = true;
-			try {
-				const current = preview();
-				if (value.revision !== current.revision) throw new Error("Preview changed. Select the text again.");
-				if (!Number.isInteger(value.slide) || !current.slides[value.slide] || typeof value.before !== "string" || !value.before.trim() || value.before.length > 12e3 || typeof value.after !== "string" || value.after.length > 12e3 || value.after === value.before) throw new Error("Invalid text edit.");
-				if (current.slideTexts[value.slide].split(value.before).length !== 2) throw new Error("Text cannot be located uniquely on this slide. Use Apply with AI.");
-				const root = await realpath(dirname(entry));
-				const files = await Promise.all([...new Set(current.dependencies)].filter((file) => /\.[cm]?[jt]sx?$/.test(file)).map(async (file) => {
-					const path = await realpath(file), local = relative(root, path);
-					if (local.startsWith("..") || isAbsolute(local) || local.split(/[\\/]/).includes("node_modules")) return null;
-					return {
-						file: path,
-						before: await readFile(path, "utf8")
-					};
-				}));
-				const candidates = [];
-				for (const item of files) {
-					if (!item) continue;
-					const source = ts.createSourceFile(item.file, item.before, ts.ScriptTarget.Latest, true, /[jt]sx$/.test(extname(item.file)) ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
-					const visit = (node) => {
-						if ((ts.isJsxText(node) ? node.text.split(/\r\n|\n|\r/).map((line, index, lines) => {
-							let value = line.replaceAll("	", " ");
-							if (index) value = value.trimStart();
-							if (index < lines.length - 1) value = value.trimEnd();
-							return value;
-						}).filter(Boolean).join(" ") : ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node) ? node.text : void 0) === value.before) {
-							const replacement = ts.isJsxText(node) || ts.isJsxAttribute(node.parent) ? "{" + JSON.stringify(value.after) + "}" : JSON.stringify(value.after);
-							const start = ts.isJsxText(node) ? node.pos : node.getStart(source);
-							candidates.push({
-								...item,
-								after: item.before.slice(0, start) + replacement + item.before.slice(node.end)
-							});
-						}
-						ts.forEachChild(node, visit);
-					};
-					visit(source);
-				}
-				if (candidates.length !== 1) throw new Error("Text is computed or has multiple source matches. Use Apply with AI.");
-				const change = candidates[0];
-				if (preview().revision !== current.revision || await realpath(change.file) !== change.file || await readFile(change.file, "utf8") !== change.before) throw new Error("Source changed. Select the text again.");
-				await writeFile(change.file, change.after);
-				try {
-					if (await verify()) throw new Error("The text change did not build.");
-					const next = preview();
-					if (next.slides.length !== current.slides.length || next.slides.some((svg, index) => index !== value.slide && svg !== current.slides[index]) || next.slideTexts[value.slide] !== current.slideTexts[value.slide].replace(value.before, value.after)) throw new Error("This source affects other text or slides. Use Apply with AI for a local edit.");
-					if (await realpath(change.file) !== change.file || await readFile(change.file, "utf8") !== change.after) throw new Error("Source changed during editing.");
-					undo = change;
-				} catch (error) {
-					await restore(change);
-					await verify();
-					throw error;
-				}
-			} finally {
-				busy = false;
+	return { async edit(value) {
+		if (busy) throw new Error("A text edit is already running.");
+		busy = true;
+		try {
+			const current = preview();
+			if (value.revision !== current.revision) throw new Error("Preview changed. Select the text again.");
+			if (!Number.isInteger(value.slide) || !current.slides[value.slide] || typeof value.before !== "string" || !value.before.trim() || value.before.length > 12e3 || typeof value.after !== "string" || value.after.length > 12e3 || value.after === value.before) throw new Error("Invalid text edit.");
+			if (current.slideTexts[value.slide].split(value.before).length !== 2) throw new Error("Text cannot be located uniquely on this slide. Use Apply with AI.");
+			const root = await realpath(dirname(entry));
+			const files = await Promise.all([...new Set(current.dependencies)].filter((file) => /\.[cm]?[jt]sx?$/.test(file)).map(async (file) => {
+				const path = await realpath(file), local = relative(root, path);
+				if (local.startsWith("..") || isAbsolute(local) || local.split(/[\\/]/).includes("node_modules")) return null;
+				return {
+					file: path,
+					before: await readFile(path, "utf8")
+				};
+			}));
+			const candidates = [];
+			for (const item of files) {
+				if (!item) continue;
+				const source = ts.createSourceFile(item.file, item.before, ts.ScriptTarget.Latest, true, /[jt]sx$/.test(extname(item.file)) ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+				const visit = (node) => {
+					if ((ts.isJsxText(node) ? node.text.split(/\r\n|\n|\r/).map((line, index, lines) => {
+						let value = line.replaceAll("	", " ");
+						if (index) value = value.trimStart();
+						if (index < lines.length - 1) value = value.trimEnd();
+						return value;
+					}).filter(Boolean).join(" ") : ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node) ? node.text : void 0) === value.before) {
+						const replacement = ts.isJsxText(node) || ts.isJsxAttribute(node.parent) ? "{" + JSON.stringify(value.after) + "}" : JSON.stringify(value.after);
+						const start = ts.isJsxText(node) ? node.pos : node.getStart(source);
+						candidates.push({
+							...item,
+							after: item.before.slice(0, start) + replacement + item.before.slice(node.end)
+						});
+					}
+					ts.forEachChild(node, visit);
+				};
+				visit(source);
 			}
-		},
-		async undo() {
-			if (busy) throw new Error("A text edit is already running.");
-			if (!undo) throw new Error("No direct text edit to undo.");
-			busy = true;
+			if (candidates.length !== 1) throw new Error("Text is computed or has multiple source matches. Use Apply with AI.");
+			const change = candidates[0];
+			if (preview().revision !== current.revision || await realpath(change.file) !== change.file || await readFile(change.file, "utf8") !== change.before) throw new Error("Source changed. Select the text again.");
+			await writeFile(change.file, change.after);
 			try {
-				await restore(undo);
-				undo = void 0;
-				if (await verify()) throw new Error("Text restored, but the project has build errors.");
-			} finally {
-				busy = false;
+				if (await verify()) throw new Error("The text change did not build.");
+				const next = preview();
+				if (next.slides.length !== current.slides.length || next.slides.some((svg, index) => index !== value.slide && svg !== current.slides[index]) || next.slideTexts[value.slide] !== current.slideTexts[value.slide].replace(value.before, value.after)) throw new Error("This source affects other text or slides. Use Apply with AI for a local edit.");
+				if (await realpath(change.file) !== change.file || await readFile(change.file, "utf8") !== change.after) throw new Error("Source changed during editing.");
+			} catch (error) {
+				await restore(change);
+				await verify();
+				throw error;
 			}
+		} finally {
+			busy = false;
 		}
-	};
+	} };
 }
 //#endregion
 //#region src/visual-review.ts
@@ -231,7 +392,7 @@ const page = `<!doctype html>
 <link rel="stylesheet" href="/terminal.css">
 <style>
 ${previewStyles}
-.slide-edit-tools{display:flex;gap:6px;padding:8px 14px;flex-shrink:0}.slide-edit-tools button[aria-pressed=true]{background:#6850b8;border-color:#b8a1ff}.slide-selection{position:fixed;border:2px solid #b094ff;background:#a080ff18;pointer-events:none;z-index:20;box-shadow:0 0 0 1px #201632}.slide-edit-panel{position:fixed;z-index:21;width:min(380px,calc(100vw - 16px));padding:14px;background:#202438;border:1px solid #776591;border-radius:14px;box-shadow:0 16px 50px #0008;display:flex;flex-direction:column;gap:12px}.slide-edit-panel[hidden],.slide-selection[hidden]{display:none}.selection-heading,.selection-actions{display:flex;align-items:center;gap:8px}.selection-heading strong{flex:1}.slide-edit-panel textarea{width:100%;min-height:90px;max-height:35vh;resize:vertical;background:#141a2b;color:#f4efff;border:1px solid #514969;border-radius:8px;padding:10px;font:inherit}.selection-actions{flex-wrap:wrap}.selection-actions select{min-width:80px;flex:1}.slide-edit-panel small{color:#d1c9e3;line-height:1.5}.presenting .slide-edit-tools{display:none}
+.slide-edit-tools{display:flex;gap:6px;padding:8px 14px;flex-shrink:0}.slide-edit-tools{align-items:center;flex-wrap:wrap}.slide-edit-tools span{font-size:11px;color:#625873;flex:1}.slide-edit-tools small{font-size:11px;color:#634396}.slide-hover{position:fixed;border:1px solid #b094ff;pointer-events:none;z-index:19;border-radius:2px}.slide-text-input{position:fixed;z-index:22;resize:none;background:#202438;color:#fff;border:2px solid #b094ff;border-radius:3px;padding:0;box-shadow:0 0 0 3px #b094ff30;line-height:1.15}.slide-text-input[hidden],.slide-hover[hidden]{display:none}.slide-selection{position:fixed;border:2px solid #b094ff;background:#a080ff18;pointer-events:none;z-index:20;box-shadow:0 0 0 1px #201632}.slide-edit-panel{position:fixed;z-index:21;width:min(380px,calc(100vw - 16px));padding:14px;background:#202438;border:1px solid #776591;border-radius:14px;box-shadow:0 16px 50px #0008;display:flex;flex-direction:column;gap:12px}.slide-edit-panel[hidden],.slide-selection[hidden]{display:none}.selection-heading,.selection-actions{display:flex;align-items:center;gap:8px}.selection-heading strong{flex:1}.slide-edit-panel textarea{width:100%;min-height:90px;max-height:35vh;resize:vertical;background:#141a2b;color:#f4efff;border:1px solid #514969;border-radius:8px;padding:10px;font:inherit}.selection-actions{flex-wrap:wrap}.selection-actions select{min-width:80px;flex:1}.slide-edit-panel small{color:#d1c9e3;line-height:1.5}.presenting .slide-edit-tools{display:none}
 
 #agent-workspace{position:relative;flex:1;min-height:0;min-width:0;display:flex;overflow:auto}.agent-pane{position:absolute;padding:3px 5px;display:flex;flex-direction:column;flex:1;min-width:0;min-height:0;overflow:hidden}.agent-pane iframe{border:0;width:100%;flex:1;min-height:0;border-radius:0 0 9px 9px}.agent-tools{display:flex;gap:4px;align-items:center;flex-wrap:wrap;padding:6px;background:#20253a;border:1px solid #34334e;border-radius:9px 9px 0 0}.agent-tools span{flex:1;font-size:10px;letter-spacing:.04em;color:#b3abc9}.agent-tools svg{width:14px;height:14px}.agent-pane:focus-within .agent-tools{border-color:#8b6ed577;background:#29243e}.agent-tools button{font-size:11px;padding:5px;background:transparent;border:0;display:grid;place-items:center}.agent-divider{position:absolute;z-index:2;background:#101422;cursor:col-resize;touch-action:none}.agent-divider.vertical{cursor:row-resize}.agent-divider:hover,.agent-divider:focus-visible{background:#9b87ff}.splitting-agents iframe,.resizing-chat iframe{pointer-events:none}
 </style>
@@ -392,7 +553,7 @@ async function refresh(){
   catch{if(id===refreshId)byId('status').textContent='Reconnecting…';}
 }
 byId('toggle-chat').onclick=()=>{const hidden=document.body.classList.toggle('chat-hidden');byId('toggle-chat').setAttribute('aria-expanded',String(!hidden));resize();};
-const events=new EventSource('/events');events.onmessage=event=>{if(event.data==='chat'){window.dispatchEvent(new Event('agent-chat'));return;}if(event.data==='ready'){delete state.revision;}void refresh();};events.onerror=()=>{byId('status').textContent='Reconnecting…'};refresh();
+const events=new EventSource('/events');events.onmessage=event=>{if(event.data==='history'){window.dispatchEvent(new Event('agent-history'));return;}if(event.data==='chat'){window.dispatchEvent(new Event('agent-chat'));return;}if(event.data==='ready'){delete state.revision;}void refresh();};events.onerror=()=>{byId('status').textContent='Reconnecting…'};refresh();
 <\/script><script type="module" src="/terminal.js"><\/script></html>`;
 //#endregion
 //#region src/agent-page.ts
@@ -476,7 +637,7 @@ Choose foreground and actual background colors together. Explicitly set readable
 //#region src/terminal.ts
 const REQUEST_LIMIT = 128e3;
 /** A real interactive Claude session, shared across reloads of its owning tab. */
-function createTerminal(entry, busy = () => false, base = "", verify = async () => null, review) {
+function createTerminal(entry, busy = () => false, base = "", verify = async () => null, review, history) {
 	let repairs = 0;
 	let working = false;
 	let process;
@@ -566,6 +727,11 @@ function createTerminal(entry, busy = () => false, base = "", verify = async ()
 					} catch (cause) {
 						error = cause instanceof Error ? cause.message : String(cause);
 					}
+					try {
+						await history?.end();
+					} catch (cause) {
+						error = "History: " + String(cause);
+					}
 					working = false;
 					status = error ? "Preview verification incomplete: " + error : "Preview build verified";
 					json(200, {});
@@ -573,6 +739,12 @@ function createTerminal(entry, busy = () => false, base = "", verify = async ()
 				emit("state", snapshot());
 				return;
 			}
+			try {
+				await history?.begin();
+			} catch (cause) {
+				json(409, { error: String(cause) });
+				return;
+			}
 			repairs = 0;
 			working = true;
 			review?.begin();
@@ -676,11 +848,16 @@ Preview context captured with the latest terminal input: ${JSON.stringify(contex
 						output = (output + data).slice(-2e6);
 						emit("output", data);
 					});
-					completion = new Promise((done) => process.onExit(({ exitCode }) => {
+					completion = new Promise((done) => process.onExit(async ({ exitCode }) => {
 						process = void 0;
 						working = false;
 						stopping = false;
 						status = `Claude Code exited (${exitCode}). Start to open a new session.`;
+						try {
+							await history?.end();
+						} catch (cause) {
+							status += " History: " + String(cause);
+						}
 						emit("state", snapshot());
 						done();
 					}));
@@ -694,6 +871,17 @@ Preview context captured with the latest terminal input: ${JSON.stringify(contex
 				})) throw new Error("Invalid inline prompt");
 				updateFocus();
 				working = true;
+				try {
+					await history?.begin();
+				} catch (cause) {
+					working = false;
+					throw cause;
+				}
+				if (!process || closing || stopping) {
+					await history?.end();
+					working = false;
+					throw new Error("Claude Code stopped before submitting.");
+				}
 				process.write("\x1B[200~" + value.message + "\x1B[201~");
 				await new Promise((done) => setTimeout(done, 100));
 				if (!process || stopping) throw new Error("Claude Code stopped before submitting.");
@@ -702,8 +890,11 @@ Preview context captured with the latest terminal input: ${JSON.stringify(contex
 				if (!process) throw new Error("Start Claude Code first");
 				if (typeof value.data !== "string" || value.data.length > 32e3) throw new Error("Invalid terminal input");
 				updateFocus();
-				if (value.data.includes("")) working = false;
 				process.write(value.data);
+				if (value.data.includes("")) {
+					working = false;
+					await history?.end();
+				}
 			} else if (request.url === "/terminal/resize") {
 				size();
 				process?.resize(value.cols, value.rows);
@@ -737,7 +928,9 @@ const markdown = new MarkdownIt({
 });
 markdown.renderer.rules.image = (tokens, index) => markdown.utils.escapeHtml(tokens[index]?.content ?? "");
 /** One shared conversation and one editing process per dev server. */
-function createChat(entry, notify, busy = () => false, verify = async () => null, review, reviewImages = () => []) {
+function createChat(entry, notify, busy = () => false, verify = async () => null, review, reviewImages = () => [], history) {
+	let starting = false;
+	let closing = false;
 	let messages = [];
 	let provider = "codex";
 	let child;
@@ -751,7 +944,7 @@ function createChat(entry, notify, busy = () => false, verify = async () => null
 			...message.role === "assistant" ? { html: markdown.render(message.text) } : {}
 		})),
 		provider,
-		running: !!child,
+		running: starting || !!child,
 		status
 	});
 	function stop() {
@@ -781,7 +974,7 @@ function createChat(entry, notify, busy = () => false, verify = async () => null
 			text,
 			context
 		};
-		const history = messages.slice(-12).map((message) => ({
+		const conversation = messages.slice(-12).map((message) => ({
 			...message,
 			text: message.text.slice(-12e3)
 		}));
@@ -792,7 +985,7 @@ ${authoringGuidance}
 The attached focus is context, NOT a restriction: use it for references such as "this slide". For other slides or deck-wide requests, find the relevant source or shared theme instead. Do not rewrite the whole deck for a local edit.
 Slide numbers are 1-based and refer to the last successful preview at send time. Source may have changed since then; verify it before editing. Files are dependency candidates, not an exact slide-to-source mapping.
 Respond in the user's language, briefly describing edits or answering their question. If permissions prevent an action, explain that instead of claiming success.
-Recent conversation (JSON): ${JSON.stringify(history)}
+Recent conversation (JSON): ${JSON.stringify(conversation)}
 Current request and preview context (JSON): ${JSON.stringify(user)}`;
 		messages.push(user);
 		const answer = {
@@ -904,6 +1097,11 @@ Current request and preview context (JSON): ${JSON.stringify(user)}`;
 					}
 					status = stopping ? "Stopped. Saved edits remain in the preview." : buildError ? "Preview still has errors after 3 repair attempts.\n" + buildError.slice(0, 16e3) : reviewFailure || "Done";
 				}
+				try {
+					await history?.end();
+				} catch (cause) {
+					status = "History: " + String(cause);
+				}
 				if (status !== "Done") append(status);
 				child = void 0;
 				notify();
@@ -945,7 +1143,7 @@ Current request and preview context (JSON): ${JSON.stringify(user)}`;
 				json(200, snapshot());
 				return;
 			}
-			if (child) {
+			if (child || starting || closing) {
 				json(409, { error: "An edit is already running" });
 				return;
 			}
@@ -969,7 +1167,17 @@ Current request and preview context (JSON): ${JSON.stringify(user)}`;
 				return;
 			}
 			const context = focus(value.slide, value.revision);
-			start(value.message.trim(), value.provider, context, 0, reviewImages(value.message.trim()));
+			starting = true;
+			try {
+				await history?.begin();
+				if (closing) {
+					await history?.end();
+					throw new Error("Agent is closing");
+				}
+				start(value.message.trim(), value.provider, context, 0, reviewImages(value.message.trim()));
+			} finally {
+				starting = false;
+			}
 			json(202, snapshot());
 		} catch (cause) {
 			json(400, { error: cause instanceof Error ? cause.message : "Invalid request" });
@@ -977,8 +1185,9 @@ Current request and preview context (JSON): ${JSON.stringify(user)}`;
 	}
 	return {
 		handle,
-		isRunning: () => !!child,
+		isRunning: () => starting || !!child,
 		async close() {
+			closing = true;
 			stop();
 			await completion;
 		}
@@ -997,15 +1206,23 @@ async function serveDeck(entry, port = 4173) {
 	let closed = false;
 	const clients = /* @__PURE__ */ new Set();
 	const sessions = /* @__PURE__ */ new Map();
+	const history = await createHistory(dirname(resolve(entry)), () => {
+		for (const client of clients) client.write("data: history\n\n");
+	});
+	let textEdits = 0;
 	const capturedReviews = /* @__PURE__ */ new Map();
 	function session(id) {
 		let result = sessions.get(id);
 		if (!result) {
 			const review = createVisualReviewer(resolve(entry), () => latest?.slides ?? []);
+			const turnHistory = {
+				begin: () => history.begin("agent:" + id, "AI edit"),
+				end: () => history.end("agent:" + id)
+			};
 			const chat = createChat(entry, () => {
 				for (const client of clients) client.write("data: chat\n\n");
-			}, () => terminal.isRunning(), verify, review, (prompt) => capturedReviews.get(prompt) ?? []);
-			const terminal = createTerminal(entry, () => chat.isRunning(), id ? "/agents/" + id : "", verify, review);
+			}, () => terminal.isRunning(), verify, review, (prompt) => capturedReviews.get(prompt) ?? [], turnHistory);
+			const terminal = createTerminal(entry, () => chat.isRunning(), id ? "/agents/" + id : "", verify, review, turnHistory);
 			result = {
 				chat,
 				terminal,
@@ -1034,7 +1251,11 @@ async function serveDeck(entry, port = 4173) {
 			response.writeHead(404).end();
 			return;
 		}
-		if (request.url === "/text-edit" || request.url === "/text-edit/undo") {
+		if (request.url === "/history" && request.method === "GET") {
+			response.writeHead(200, { "Content-Type": "application/json" }).end(JSON.stringify(history.state()));
+			return;
+		}
+		if (request.url === "/text-edit" || request.url === "/history/undo" || request.url === "/history/redo") {
 			if (request.method !== "POST" || request.headers.origin !== `http://${host}` || request.headers["content-type"] !== "application/json") {
 				response.writeHead(403).end();
 				return;
@@ -1046,10 +1267,24 @@ async function serveDeck(entry, port = 4173) {
 					body += chunk;
 					if (Buffer.byteLength(body) > 1e5) throw new Error("Request too large");
 				}
+				if (request.url !== "/text-edit") {
+					await history.move(request.url === "/history/undo" ? "undo" : "redo");
+					const buildError = await verify();
+					response.writeHead(200, { "Content-Type": "application/json" }).end(JSON.stringify({
+						...history.state(),
+						buildError
+					}));
+					return;
+				}
 				const manualReview = createVisualReviewer(resolve(entry), () => latest?.slides ?? []);
 				manualReview.begin();
-				if (request.url === "/text-edit/undo") await textEditor.undo();
-				else await textEditor.edit(JSON.parse(body));
+				const editId = "text:" + ++textEdits;
+				await history.begin(editId, "Text edit");
+				try {
+					await textEditor.edit(JSON.parse(body));
+				} finally {
+					await history.end(editId);
+				}
 				let review;
 				let reviewError;
 				try {
@@ -1200,6 +1435,7 @@ async function serveDeck(entry, port = 4173) {
 			if (started === generation) error = cause instanceof Error ? cause.stack ?? cause.message : String(cause);
 		} finally {
 			building = false;
+			history.capture().catch(() => {});
 			for (const client of clients) client.write("data: updated\n\n");
 			if (pending && !timer) {
 				pending = false;
@@ -1215,7 +1451,7 @@ async function serveDeck(entry, port = 4173) {
 			"dist",
 			".office-kit"
 		].includes(part))) return;
-		if (!/\.([cm]?[jt]sx?|json|pptx|png|jpe?g|gif|bmp|tiff?|emf|wmf|svg)$/i.test(filename)) return;
+		if (!historyFile(filename)) return;
 		generation++;
 		builder.cancel();
 		clearTimeout(timer);