npm - @lamplitisles/codex-for-love - Versions diffs - 0.5.0 → 0.6.0 - Mend

@lamplitisles/codex-for-love 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

package/vendor/build/_app/version.json CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":"~~1789828770771~~"}
1	+ {"version":"1790151901957"}

package/vendor/build/index.html CHANGED Viewed

@@ -1,27 +1,27 @@
 <!doctype html>
 <html lang="en" data-theme="sticker-messenger">
-  <head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" /><script>(function(){try{var appearance=localStorage.getItem('her.companion.appearance');var language=localStorage.getItem('her.companion.language');var systemDark=matchMedia('(prefers-color-scheme: dark)').matches;var dark=appearance==='dark'||(appearance!=='light'&&systemDark);document.documentElement.dataset.theme=dark?'night-voyage':'sticker-messenger';document.documentElement.lang=language==='zh'?'zh-Hans':'en'}catch(_){var systemDark=matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.dataset.theme=systemDark?'night-voyage':'sticker-messenger'}})();</script><link href="/_app/immutable/entry/start.DWuEW6S3.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/DFTMMhXH.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/C2DTc7yw.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/CyqZh0gB.js" rel="modulepreload">
-		<link href="/_app/immutable/entry/app.Ci6fUWwj.js" rel="modulepreload">
+  <head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" /><script>(function(){try{var appearance=localStorage.getItem('her.companion.appearance');var language=localStorage.getItem('her.companion.language');var systemDark=matchMedia('(prefers-color-scheme: dark)').matches;var dark=appearance==='dark'||(appearance!=='light'&&systemDark);document.documentElement.dataset.theme=dark?'night-voyage':'sticker-messenger';document.documentElement.lang=language==='zh'?'zh-Hans':'en'}catch(_){var systemDark=matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.dataset.theme=systemDark?'night-voyage':'sticker-messenger'}})();</script><link href="/_app/immutable/entry/start.ZF-Jvc9b.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/hmUBTeUN.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/CLwTq0ua.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/B4it5vzu.js" rel="modulepreload">
+		<link href="/_app/immutable/entry/app.DWpdogiL.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/uBIymjUX.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/xihTtKlq.js" rel="modulepreload">
-		<link href="/_app/immutable/nodes/0.C8SV4li-.js" rel="modulepreload">
+		<link href="/_app/immutable/nodes/0.DsknM3BK.js" rel="modulepreload">
-		<link href="/_app/immutable/assets/0.CkWBasWr.css" rel="stylesheet"></head>
+		<link href="/_app/immutable/assets/0.CfdLiH0M.css" rel="stylesheet"></head>
   <body data-sveltekit-preload-data="hover"><div style="display: contents">
 			<script>
 				{
-					__sveltekit_17ylz81 = {
+					__sveltekit_st3em4 = {
 						base: ""
 					};
 					const element = document.currentScript.parentElement;
 					Promise.all([
-						import("/_app/immutable/entry/start.DWuEW6S3.js"),
-						import("/_app/immutable/entry/app.Ci6fUWwj.js")
+						import("/_app/immutable/entry/start.ZF-Jvc9b.js"),
+						import("/_app/immutable/entry/app.DWpdogiL.js")
 					]).then(([kit, app]) => {
 						kit.start(app, element);
 					});

package/vendor/runtime/cli.mjs CHANGED Viewed

@@ -63240,6 +63240,21 @@ var Store = class {
 			};
 		}));
 	}
+	async messageMeta(id) {
+		return this.transaction(() => {
+			const row = this.db.prepare(`
+        SELECT m.sequence,m.id,m.created,r.revision
+        FROM message_meta m JOIN message_revisions r ON r.message_id=m.id
+        WHERE m.id=?
+      `).get(id);
+			return row ? {
+				id: row.id,
+				created: Number(row.created),
+				sequence: Number(row.sequence),
+				revision: Number(row.revision)
+			} : void 0;
+		});
+	}
 	async pendingMessages() {
 		return this.transaction(() => this.db.prepare(`
       SELECT m.sequence,m.id,m.created,r.revision,p.input
@@ -64442,6 +64457,7 @@ function buildRollout(extraction, media, threadId, destination, persona, relatio
 			lastByTurn.set(record.turn, index);
 		}
 	});
+	const startedAtByTurn = new Map([...firstByTurn].map(([turn, index]) => [turn, Math.floor(extraction.records[index].time / 1e3)]));
 	for (const [index, record] of extraction.records.entries()) {
 		const timestamp = new Date(record.time).toISOString();
 		if (record.type === "compact") {
@@ -64480,6 +64496,7 @@ function buildRollout(extraction, media, threadId, destination, persona, relatio
 				type: "task_complete",
 				turn_id: turnId,
 				last_agent_message: null,
+				started_at: Math.floor(record.time / 1e3),
 				completed_at: Math.floor(record.time / 1e3)
 			}, timestamp);
 			boundaries.push({
@@ -64492,10 +64509,11 @@ function buildRollout(extraction, media, threadId, destination, persona, relatio
 			continue;
 		}
 		const turnId = `turn-${record.turn}`;
+		const startedAt = startedAtByTurn.get(record.turn);
 		if (firstByTurn.get(record.turn) === index) add("event_msg", {
 			type: "task_started",
 			turn_id: turnId,
-			started_at: Math.floor(record.time / 1e3),
+			started_at: startedAt,
 			model_context_window: null,
 			collaboration_mode_kind: "default"
 		}, timestamp);
@@ -64551,7 +64569,7 @@ function buildRollout(extraction, media, threadId, destination, persona, relatio
 			type: "task_complete",
 			turn_id: turnId,
 			last_agent_message: record.type === "assistant" ? record.text : null,
-			started_at: null,
+			started_at: startedAt,
 			completed_at: Math.floor(record.time / 1e3),
 			duration_ms: null
 		}, timestamp);
@@ -65556,16 +65574,17 @@ async function writeConversationImages(path, images) {
 	await rename(temporary, target);
 }
 const HISTORY_PAGE_MESSAGES = 50;
+const HISTORICAL_FALLBACK_START = new Date(2026, 8, 1).getTime();
 /** Match DSH's 50-message history window against CFL's rendered projection. */
 function visibleHistoryPage(messages, results, before) {
 	const candidates = messages.filter((message) => before === void 0 || message.sequence < before);
-	const resultByOwner = new Map(results.map((result) => [result.sourceIds.at(-1), result]));
+	const resultBySource = new Map(results.map((result) => [result.sourceIds.at(-1), result]));
 	const selected = [];
 	let visible = 0;
 	let index = candidates.length - 1;
 	for (; index >= 0; index -= 1) {
 		const message = candidates[index];
-		const result = resultByOwner.get(message.id);
+		const result = resultBySource.get(message.id);
 		const units = 1 + (result ? result.answers.length + result.generatedIds.length + result.voiceIds.length + (result.error || [
 			"failed",
 			"interrupted",
@@ -65608,11 +65627,17 @@ function turnStatus(turn) {
 function isActiveTurn(turn) {
 	return turnStatus(turn) === "inProgress" || turnStatus(turn) === "in_progress" || turnStatus(turn) === "active";
 }
-function turnTime(value, fallback) {
+function recordedTurnTime(value) {
 	const number = numberOrNull(value);
-	if (number === null) return fallback;
+	if (number === null) return void 0;
 	return number > 1e10 ? Math.round(number) : Math.round(number * 1e3);
 }
+function turnTime(value, fallback) {
+	return recordedTurnTime(value) ?? fallback;
+}
+function historicalFallbackTime(sequence) {
+	return HISTORICAL_FALLBACK_START + Math.max(0, sequence - 1) * 1e3;
+}
 function completedTurnTime(value) {
 	const raw = numberOrNull(value);
 	if (raw === null) return void 0;
@@ -65623,7 +65648,7 @@ function inputTimeContext(source, now) {
 	const time = `${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
 	return {
 		kind: "application",
-		value: `${source === "owner" ? "Current owner input" : "Qualifying Keet input"} received around local ${time}. Trusted delivery metadata; not user-authored text or an instruction.`
+		value: `${source === "human" ? "Current human input" : "Qualifying Keet input"} received around local ${time}. Trusted delivery metadata; not user-authored text or an instruction.`
 	};
 }
 function textFromUserItem(item) {
@@ -65871,7 +65896,12 @@ async function createPartner(config, credentials, dependencies = {}) {
 	const store = new Store(paths.database);
 	const now = dependencies.now ?? Date.now;
 	const listeners = /* @__PURE__ */ new Set();
-	const messageIds = new Set((await store.allMessages()).map((message) => message.id));
+	const storedMessages = await store.allMessages();
+	const messageIds = new Set(storedMessages.map((message) => message.id));
+	const messagesById = new Map(storedMessages.map((message) => [message.id, {
+		created: message.created,
+		sequence: message.sequence
+	}]));
 	const turns = /* @__PURE__ */ new Map();
 	/** One turn owns an ordered list of application input identities. */
 	const turnInputs = /* @__PURE__ */ new Map();
@@ -66068,11 +66098,11 @@ async function createPartner(config, credentials, dependencies = {}) {
 		return status === "failed" ? "Native image generation failed" : "Native image artifact unavailable";
 	}
 	async function markAttachmentError(sourceIds, error) {
-		const owner = sourceIds.at(-1);
-		if (!owner) return;
-		const previous = await store.outcome(owner);
+		const sourceId = sourceIds.at(-1);
+		if (!sourceId) return;
+		const previous = await store.outcome(sourceId);
 		if (previous?.status === "replaced") return;
-		if (previous?.status !== "attachment-error" || previous.error !== error) await store.markOutcome(owner, "attachment-error", error);
+		if (previous?.status !== "attachment-error" || previous.error !== error) await store.markOutcome(sourceId, "attachment-error", error);
 	}
 	async function projectGeneratedImage(operationId, sourceIds, item, created) {
 		if (item.type !== "imageGeneration") return void 0;
@@ -66089,7 +66119,7 @@ async function createPartner(config, credentials, dependencies = {}) {
 		const existing = await store.generatedImageForItem(operationId, itemId);
 		if (existing) try {
 			await access(existing.path);
-			await catalogueImage("partner", existing, created);
+			await catalogueImage("agent", existing, created);
 			return existing.id;
 		} catch {
 			storageError = true;
@@ -66112,7 +66142,7 @@ async function createPartner(config, credentials, dependencies = {}) {
 				return;
 			}
 			await store.saveGeneratedImage(generated, itemId);
-			await catalogueImage("partner", generated, created);
+			await catalogueImage("agent", generated, created);
 			return generated.id;
 		} catch (error) {
 			storageError = true;
@@ -66199,11 +66229,21 @@ async function createPartner(config, credentials, dependencies = {}) {
 				text_offset: 0,
 				text_length: source.input.length
 			};
-			if (!messageIds.has(sourceId)) {
-				await store.ensureMessage(sourceId, turnTime(turn.startedAt, now()), source.input, source.images);
+			let message = messagesById.get(sourceId);
+			if (!message) {
+				const created = turnTime(turn.startedAt, now());
+				const stored = await store.ensureMessage(sourceId, created, source.input, source.images);
 				messageIds.add(sourceId);
+				message = {
+					created: stored.created,
+					sequence: stored.sequence
+				};
+				messagesById.set(sourceId, message);
+			}
+			if (!sourceId.startsWith("keet:")) for (const image of source.images) {
+				const origin = isUnder(join(paths.managedRoot, "historical-media"), image.path) ? "historical" : "human";
+				await catalogueImage(origin, image, origin === "historical" ? recordedTurnTime(turn.startedAt) ?? historicalFallbackTime(message.sequence) : message.created);
 			}
-			if (!sourceId.startsWith("keet:")) for (const image of source.images) await catalogueImage(isUnder(join(paths.managedRoot, "historical-media"), image.path) ? "historical" : "owner", image, turnTime(turn.startedAt, now()));
 			await store.markObserved(sourceId, segment);
 		}
 		acknowledgeInputIds(officialIds);
@@ -66423,7 +66463,7 @@ async function createPartner(config, credentials, dependencies = {}) {
 			input: intents.map((intent) => intent.input).join("\n"),
 			images: intents.flatMap((intent) => intent.images),
 			transportId: clientIdForInputs(ids),
-			source: intents.every((intent) => intent.source === "owner") ? "owner" : "none"
+			source: intents.every((intent) => intent.source === "human") ? "human" : "none"
 		};
 		recoveryPromise = (async () => {
 			try {
@@ -67108,6 +67148,11 @@ async function createPartner(config, credentials, dependencies = {}) {
 				const materialized = await materializeImages(paths.workspaceRoot, images);
 				await store.admit(id, input, materialized);
 				messageIds.add(id);
+				const message = await store.messageMeta(id);
+				if (message) messagesById.set(id, {
+					created: message.created,
+					sequence: message.sequence
+				});
 				if (operationTurn(id) || pendingStarts.has(id) || pendingSteers.some((intent) => intent.ids.includes(id)) || await store.outcome(id)) return;
 				if (unresolvedInputIds.has(id) && !replaces.includes(id)) throw new Error("Message delivery is unresolved; inspect the conversation before retrying");
 				for (const replacedId of replaces) {
@@ -67125,7 +67170,7 @@ async function createPartner(config, credentials, dependencies = {}) {
 					input,
 					images: materialized,
 					transportId: id,
-					source: "owner"
+					source: "human"
 				};
 				if (compacting && !activeTurnId) {
 					rejectedSteers.push(intent);
@@ -67938,6 +67983,27 @@ function createWebServer(partner, assets, options = {}) {
 				}).strict().refine((value) => value.before === void 0 || value.after === void 0).parse(params);
 				return json(response, await partner.snapshot(options));
 			}
+			if (path === "/api/conversation-search" && request.method === "GET") {
+				const params = Object.fromEntries(new URL(request.url, "http://localhost").searchParams);
+				const parsed = object({ q: string().trim().min(1).max(500) }).strict().safeParse(params);
+				if (!parsed.success) return json(response, { error: "Invalid search query" }, 400);
+				try {
+					if (!options.conversationSearch) throw new Error("Search unavailable");
+					return json(response, await options.conversationSearch.search(parsed.data.q));
+				} catch {
+					return json(response, { error: "Search unavailable" }, 503);
+				}
+			}
+			if (path.startsWith("/api/conversation-search/") && request.method === "GET") {
+				const id = path.slice(25);
+				if (!/^[a-f0-9]{64}$/u.test(id)) return json(response, { error: "Invalid record id" }, 400);
+				try {
+					if (!options.conversationSearch) throw new Error("Search unavailable");
+					return json(response, await options.conversationSearch.read(id));
+				} catch {
+					return json(response, { error: "Record unavailable" }, 404);
+				}
+			}
 			if (path === "/api/diary" && request.method === "GET") try {
 				return json(response, { entries: await partner.diary() });
 			} catch {
@@ -68088,6 +68154,110 @@ function createWebServer(partner, assets, options = {}) {
 	};
 }
 //#endregion
+//#region apps/partner/runtime/conversation-search.ts
+const executeFile = promisify(execFile);
+const idSchema = string().regex(/^[a-f0-9]{64}$/u);
+const querySchema = string().trim().min(1).max(500);
+const resultSchema = object({
+	query: string(),
+	estimatedTotalHits: number$1().int().nonnegative(),
+	hits: array(object({
+		id: idSchema,
+		kind: _enum(["message", "compaction"]),
+		sessionId: string(),
+		sessionName: string().optional(),
+		cwd: string(),
+		role: _enum(["user", "assistant"]).optional(),
+		phase: _enum(["commentary", "final_answer"]).optional(),
+		createdAt: string().optional(),
+		snippet: string()
+	})).max(20)
+});
+const recordSchema = object({
+	id: idSchema,
+	kind: _enum(["message", "compaction"]),
+	sessionId: string(),
+	sessionName: string().optional(),
+	cwd: string(),
+	role: _enum(["user", "assistant"]).optional(),
+	phase: _enum(["commentary", "final_answer"]).optional(),
+	createdAt: string().optional(),
+	content: string()
+});
+const contextSchema = object({
+	messageId: idSchema,
+	targetSourceRecordIndex: number$1().int(),
+	truncated: boolean(),
+	items: array(object({
+		sourceRecordIndex: number$1().int(),
+		kind: _enum([
+			"message",
+			"compaction",
+			"tool"
+		]),
+		role: _enum(["user", "assistant"]).optional(),
+		phase: string().optional(),
+		content: string(),
+		truncated: boolean().optional()
+	}))
+});
+function createConversationSearch(options) {
+	const workspace = resolve(options.workspace);
+	const env = {
+		...process.env,
+		...options.env,
+		...options.codexHome ? { CODEX_HOME: options.codexHome } : {}
+	};
+	const binary = env.FLICKLOG_BIN ?? "flicklog";
+	let pending = Promise.resolve();
+	function run(args) {
+		const task = pending.then(async () => {
+			if (!env.FLICKLOG_MEILI_KEY && env.CREDENTIALS_DIRECTORY) try {
+				env.FLICKLOG_MEILI_KEY = (await readFile(join(env.CREDENTIALS_DIRECTORY, "flicklog-meili-key"), "utf8")).trim();
+			} catch (error) {
+				if (error.code !== "ENOENT") throw error;
+			}
+			const { stdout } = await executeFile(binary, args, {
+				cwd: workspace,
+				env,
+				timeout: 3e5,
+				maxBuffer: 8388608,
+				windowsHide: true
+			});
+			return JSON.parse(stdout);
+		});
+		pending = task.then(() => void 0, () => void 0);
+		return task;
+	}
+	return {
+		async search(query, limit = 20) {
+			const q = querySchema.parse(query);
+			const count = number$1().int().min(1).max(20).parse(limit);
+			const value = object({ results: resultSchema }).parse(await run([
+				"search",
+				q,
+				"--limit",
+				String(count)
+			]));
+			return {
+				...value.results,
+				hits: value.results.hits.filter((hit) => resolve(hit.cwd) === workspace)
+			};
+		},
+		async read(id) {
+			const selected = idSchema.parse(id);
+			const record = recordSchema.parse(await run(["get", selected]));
+			if (resolve(record.cwd) !== workspace) throw new Error("Conversation record is outside this workspace");
+			const context = contextSchema.parse(await run(["context", selected]));
+			if (context.messageId !== selected) throw new Error("Conversation context does not match the record");
+			return {
+				record,
+				context
+			};
+		}
+	};
+}
+//#endregion
 //#region apps/partner/runtime/migrate-relationship-journal.ts
 /** One-time, explicit conversion of a legacy CFL relationship table. */
 async function migrateRelationshipJournal(workspace) {
@@ -68189,7 +68359,10 @@ if (command === "credential") {
 	const partner = await createPartner(config, credentials);
 	let app;
 	try {
-		app = createWebServer(partner, assets);
+		app = createWebServer(partner, assets, { conversationSearch: createConversationSearch({
+			workspace: config.workspace,
+			codexHome: config.codex.home
+		}) });
 	} catch (error) {
 		await partner.close();
 		throw error;

package/vendor/runtime/companion-mcp.mjs CHANGED Viewed

@@ -23011,12 +23011,120 @@ async function withAvailability(images) {
 	}));
 }
 //#endregion
+//#region apps/partner/runtime/conversation-search.ts
+const executeFile = promisify(execFile);
+const idSchema = string().regex(/^[a-f0-9]{64}$/u);
+const querySchema = string().trim().min(1).max(500);
+const resultSchema = object({
+	query: string(),
+	estimatedTotalHits: number().int().nonnegative(),
+	hits: array(object({
+		id: idSchema,
+		kind: _enum(["message", "compaction"]),
+		sessionId: string(),
+		sessionName: string().optional(),
+		cwd: string(),
+		role: _enum(["user", "assistant"]).optional(),
+		phase: _enum(["commentary", "final_answer"]).optional(),
+		createdAt: string().optional(),
+		snippet: string()
+	})).max(20)
+});
+const recordSchema = object({
+	id: idSchema,
+	kind: _enum(["message", "compaction"]),
+	sessionId: string(),
+	sessionName: string().optional(),
+	cwd: string(),
+	role: _enum(["user", "assistant"]).optional(),
+	phase: _enum(["commentary", "final_answer"]).optional(),
+	createdAt: string().optional(),
+	content: string()
+});
+const contextSchema = object({
+	messageId: idSchema,
+	targetSourceRecordIndex: number().int(),
+	truncated: boolean(),
+	items: array(object({
+		sourceRecordIndex: number().int(),
+		kind: _enum([
+			"message",
+			"compaction",
+			"tool"
+		]),
+		role: _enum(["user", "assistant"]).optional(),
+		phase: string().optional(),
+		content: string(),
+		truncated: boolean().optional()
+	}))
+});
+function createConversationSearch(options) {
+	const workspace = resolve(options.workspace);
+	const env = {
+		...process.env,
+		...options.env,
+		...options.codexHome ? { CODEX_HOME: options.codexHome } : {}
+	};
+	const binary = env.FLICKLOG_BIN ?? "flicklog";
+	let pending = Promise.resolve();
+	function run(args) {
+		const task = pending.then(async () => {
+			if (!env.FLICKLOG_MEILI_KEY && env.CREDENTIALS_DIRECTORY) try {
+				env.FLICKLOG_MEILI_KEY = (await readFile(join(env.CREDENTIALS_DIRECTORY, "flicklog-meili-key"), "utf8")).trim();
+			} catch (error) {
+				if (error.code !== "ENOENT") throw error;
+			}
+			const { stdout } = await executeFile(binary, args, {
+				cwd: workspace,
+				env,
+				timeout: 3e5,
+				maxBuffer: 8388608,
+				windowsHide: true
+			});
+			return JSON.parse(stdout);
+		});
+		pending = task.then(() => void 0, () => void 0);
+		return task;
+	}
+	return {
+		async search(query, limit = 20) {
+			const q = querySchema.parse(query);
+			const count = number().int().min(1).max(20).parse(limit);
+			const value = object({ results: resultSchema }).parse(await run([
+				"search",
+				q,
+				"--limit",
+				String(count)
+			]));
+			return {
+				...value.results,
+				hits: value.results.hits.filter((hit) => resolve(hit.cwd) === workspace)
+			};
+		},
+		async read(id) {
+			const selected = idSchema.parse(id);
+			const record = recordSchema.parse(await run(["get", selected]));
+			if (resolve(record.cwd) !== workspace) throw new Error("Conversation record is outside this workspace");
+			const context = contextSchema.parse(await run(["context", selected]));
+			if (context.messageId !== selected) throw new Error("Conversation context does not match the record");
+			return {
+				record,
+				context
+			};
+		}
+	};
+}
+//#endregion
 //#region apps/partner/runtime/companion-mcp.ts
 const workspace = process.argv[2];
 if (!workspace) throw new Error("Companion MCP requires a workspace path");
 const configPath = process.argv[3];
 const journal = partnerPaths(workspace).relationshipJournal;
 const conversationImages = partnerPaths(workspace).conversationImages;
+const conversationSearch = createConversationSearch({
+	workspace,
+	codexHome: configPath ? (await loadConfig(configPath)).codex.home : void 0
+});
 const server = new McpServer({
 	name: "companion",
 	version: "0.1.0"
@@ -23060,7 +23168,7 @@ server.registerTool("read_relationship_history", {
 	text: JSON.stringify((await readRelationshipJournal(journal)).reverse().slice(0, canonicalizeHistoryRead(input)))
 }] }));
 server.registerTool("list_photos", {
-	description: "List our shared photo library: owner-sent, Partner-generated, and restored historical conversation images, newest first in bounded pages. Returned local paths may be inspected deliberately with native tools.",
+	description: "List our shared photo library: human-sent, Agent-generated, and restored historical conversation images, newest first in bounded pages. Returned local paths may be inspected deliberately with native tools.",
 	inputSchema: {
 		limit: number().int().min(1).max(50).optional(),
 		cursor: string().regex(/^[A-Za-z0-9_-]{54}$/u).optional()
@@ -23083,6 +23191,47 @@ server.registerTool("list_photos", {
 		})
 	}] };
 });
+server.registerTool("search_conversation", {
+	description: "Find text in our conversation records. Returns bounded highlighted excerpts; read a selected record for its full text and nearby context.",
+	inputSchema: {
+		query: string().trim().min(1).max(500),
+		limit: number().int().min(1).max(20).optional()
+	}
+}, async ({ query, limit }) => {
+	try {
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(await conversationSearch.search(query, limit ?? 5))
+		}] };
+	} catch {
+		return {
+			content: [{
+				type: "text",
+				text: "Conversation search is unavailable"
+			}],
+			isError: true
+		};
+	}
+});
+server.registerTool("read_conversation_record", {
+	description: "Read one selected conversation search result in full with nearby context.",
+	inputSchema: { id: string().regex(/^[a-f0-9]{64}$/u) }
+}, async ({ id }) => {
+	try {
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(await conversationSearch.read(id))
+		}] };
+	} catch {
+		return {
+			content: [{
+				type: "text",
+				text: "Conversation record is unavailable"
+			}],
+			isError: true
+		};
+	}
+});
 server.registerTool("roll_dice", {
 	description: "Roll dice with an optional modifier and label.",
 	inputSchema: {