@agentconnect.md/daemon 1.0.0-rc.245 → 1.0.0-rc.246

package/dist/{acp-host-iKdfasdN.js → acp-host-Bhc0M4Pn.js}

@@ -1950,6 +1950,14 @@ const MAX_INDEX_INJECT_BYTES = 25e3;
 /** Hard cap on a single memory file. Injected/read every session, so an unbounded
 *  file would swell the prompt and the wire; writes over this are rejected. */
 const MAX_MEMORY_FILE_BYTES = 256e3;
+/** The append-only change log for an agent's memory, a sidecar beside the memory
+*  files (`<agent-root>/memory/.history`). One JSON line per write, for provenance
+*  (who/what/when changed a file). Dotfile so it never surfaces as a topic. */
+const MEMORY_HISTORY_FILENAME = ".history";
+/** Cap on a `before`/`after` snapshot stored in a history line — keeps a single log
+*  entry bounded even for a large file. Over this, the snapshot is truncated (with a
+*  `…` marker) rather than omitted, so the line stays small but still human-readable. */
+const MAX_HISTORY_VALUE_BYTES = 4e3;
 /** Raised when a memory path escapes the memory dir. Surfaces as `BAD_PAYLOAD`. */
 var MemoryPathError = class extends Error {
 	constructor(message) {
@@ -2013,17 +2021,47 @@ async function readMemoryFile(agentDir, relPath) {
 		throw err;
 	}
 }
+/** Truncate a snapshot to the history value cap, on a UTF-8 boundary, flagging it. */
+function clampHistoryValue(text) {
+	if (Buffer.byteLength(text) <= 4e3) return {
+		value: text,
+		truncated: false
+	};
+	return {
+		value: Buffer.from(text, "utf8").subarray(0, MAX_HISTORY_VALUE_BYTES).toString("utf8") + "…",
+		truncated: true
+	};
+}
+/** Append one line to the memory change log (`<agent-root>/memory/.history`). A single
+*  `O_APPEND` write, so concurrent appends never interleave a partial line. Best-effort:
+*  a logging failure must never fail the write it describes, so errors are swallowed. */
+async function appendHistory(agentDir, record) {
+	try {
+		await promises.mkdir(memoryDir(agentDir), { recursive: true });
+		await promises.appendFile(join(memoryDir(agentDir), MEMORY_HISTORY_FILENAME), JSON.stringify(record) + "\n", "utf8");
+	} catch {}
+}
 /** Overwrite a memory file with `content` (creating the dir if needed). Atomic
-*  (tmp + rename) so a concurrent read never sees a partial file.
+*  (tmp + rename) so a concurrent read never sees a partial file. Appends a line to
+*  the change log (`.history`) recording the add/update, its `before`/`after`
+*  snapshot (bounded), and the `source`.
 *
 *  - Rejects content over {@link MAX_MEMORY_FILE_BYTES} ({@link MemoryTooLargeError}).
 *  - `ifMatchMtime` (optimistic concurrency): when given, the current file's mtime
 *    must equal it, else {@link MemoryConflictError} — so a console edit can't
 *    clobber a newer write. A brand-new file (no mtime) matches `ifMatchMtime`
 *    only when the caller passes none (or the empty string). */
-async function writeMemoryFile(agentDir, relPath, content, ifMatchMtime) {
+async function writeMemoryFile(agentDir, relPath, content, ifMatchMtime, source = "tool") {
 	if (Buffer.byteLength(content) > 256e3) throw new MemoryTooLargeError(`memory file exceeds the ${MAX_MEMORY_FILE_BYTES}-byte limit`);
 	const abs = resolveInMemoryDir(agentDir, relPath);
+	let before = "";
+	let existed = false;
+	try {
+		before = await promises.readFile(abs, "utf8");
+		existed = true;
+	} catch (err) {
+		if (err.code !== "ENOENT") throw err;
+	}
 	if (ifMatchMtime) {
 		let current = null;
 		try {
@@ -2038,6 +2076,18 @@ async function writeMemoryFile(agentDir, relPath, content, ifMatchMtime) {
 	await promises.writeFile(tmp, content, "utf8");
 	await promises.rename(tmp, abs);
 	const st = await promises.stat(abs);
+	const beforeClamped = existed ? clampHistoryValue(before) : void 0;
+	const afterClamped = clampHistoryValue(content);
+	await appendHistory(agentDir, {
+		path: relPath,
+		event: existed ? "update" : "add",
+		...beforeClamped ? { before: beforeClamped.value } : {},
+		after: afterClamped.value,
+		at: st.mtime.toISOString(),
+		scope: "agent",
+		source,
+		...afterClamped.truncated || beforeClamped?.truncated ? { truncated: true } : {}
+	});
 	return {
 		size: st.size,
 		mtime: st.mtime.toISOString()
@@ -2056,7 +2106,7 @@ async function listMemory(agentDir) {
 	}
 	const files = [];
 	for (const d of dirents) {
-		if (!d.isFile() || d.name.endsWith(".tmp")) continue;
+		if (!d.isFile() || d.name.endsWith(".tmp") || d.name.startsWith(".")) continue;
 		try {
 			const st = await promises.stat(join(dir, d.name));
 			files.push({
@@ -2263,8 +2313,8 @@ var ManagedMemoryProvider = class {
 			content: await readMemoryFile(this.dirFor(scope.agentId), path)
 		};
 	}
-	async write(scope, path, content, ifMatch) {
-		const { size, mtime } = await writeMemoryFile(this.dirFor(scope.agentId), path, content, ifMatch);
+	async write(scope, path, content, ifMatch, source) {
+		const { size, mtime } = await writeMemoryFile(this.dirFor(scope.agentId), path, content, ifMatch, source);
 		return {
 			ok: true,
 			path,
@@ -2315,7 +2365,7 @@ var NativeMemoryProvider = class {
 	async read(scope, path) {
 		return nativeMemoryRead(this.dirFor(scope.agentId), this.runtimeFor(scope.agentId), path);
 	}
-	async write(scope, path, content, ifMatch) {
+	async write(scope, path, content, ifMatch, _source) {
 		return nativeMemoryWrite(this.dirFor(scope.agentId), this.runtimeFor(scope.agentId), path, content, ifMatch);
 	}
 };
@@ -2370,8 +2420,8 @@ var DispatchingMemoryProvider = class {
 	read(scope, path) {
 		return this.forAgent(scope.agentId).read(scope, path);
 	}
-	write(scope, path, content, ifMatch) {
-		return this.forAgent(scope.agentId).write(scope, path, content, ifMatch);
+	write(scope, path, content, ifMatch, source) {
+		return this.forAgent(scope.agentId).write(scope, path, content, ifMatch, source);
 	}
 	/** The memory tools to inject for a specific agent (the daemon calls this in
 	*  `mcpServersFor` — native contributes none). Scope-carrying, unlike the
@@ -11506,4 +11556,4 @@ var AcpHost = class {
 //#endregion
 export { toolsForIntegrations as A, decodeRelayDaemonFrame as C, MAX_FRAME_BYTES as D, encode as E, cachedRuntimeVersions as M, resolveRuntimes as N, RESERVED_MCP_SERVER_NAME as O, buildRelayDaemonFrame as S, decodeEnvelope as T, writeMemoryFile as _, initGitInjection as a, RELAY_DAEMON_SUBPROTOCOL as b, simpleGit as c, memoryProviderFor as d, MemoryConflictError as f, resolveInMemoryDir as g, listMemory as h, prepareWorkspace as i, cachedRuntimeNames as j, MEMORY_TOOL_NAMES as k, createMemoryProvider as l, MemoryTooLargeError as m, installedRuntimes as n, probeGitVersion as o, MemoryPathError as p, prefetchWorkspace as r, sessionGitEnv as s, AcpHost as t, memoryKindOf as u, isFrame as v, buildEnvelope as w, RELAY_DAEMON_WS_PATH as x, normalizeGitUrl as y };
 
-//# sourceMappingURL=acp-host-iKdfasdN.js.map
+//# sourceMappingURL=acp-host-Bhc0M4Pn.js.map