@xopcai/xopc 0.0.99 → 0.0.100

package/dist/src/media/store.js

@@ -0,0 +1,131 @@
+import { getMediaBucketDir, getMediaDir, isPathInside } from "./paths.js";
+import { buildMediaUri } from "./uri.js";
+import { extname, join, parse } from "node:path";
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+//#region src/media/store.ts
+/** Default per-file cap for inbound staging (5 MiB). */
+const MEDIA_MAX_BYTES = 5 * 1024 * 1024;
+const MEDIA_DIR_MODE = 448;
+const MEDIA_FILE_MODE = 420;
+const MIME_BY_EXT = {
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".webp": "image/webp",
+	".pdf": "application/pdf",
+	".txt": "text/plain",
+	".md": "text/markdown",
+	".json": "application/json",
+	".webm": "audio/webm",
+	".ogg": "audio/ogg",
+	".opus": "audio/ogg",
+	".mp3": "audio/mpeg",
+	".wav": "audio/wav",
+	".m4a": "audio/mp4"
+};
+function sanitizeFilename(name) {
+	return (name.replace(/[/\\?%*:|"<>]/g, "_").trim() || "file").slice(0, 60);
+}
+function extFromMime(mimeType, fallbackName) {
+	if (mimeType) {
+		const m = mimeType.split(";")[0]?.trim().toLowerCase() ?? "";
+		if (m === "image/jpeg") return ".jpg";
+		if (m === "image/png") return ".png";
+		if (m === "image/webp") return ".webp";
+		if (m === "image/gif") return ".gif";
+		if (m === "application/pdf") return ".pdf";
+		if (m === "audio/ogg") return ".ogg";
+		if (m === "audio/mpeg") return ".mp3";
+		if (m === "audio/wav") return ".wav";
+		if (m === "audio/webm") return ".webm";
+		if (m === "audio/mp4") return ".m4a";
+		if (m === "text/plain") return ".txt";
+	}
+	const fromName = fallbackName ? extname(fallbackName).toLowerCase() : "";
+	if (fromName && fromName.length <= 10) return fromName;
+	return ".bin";
+}
+function buildSavedMediaId(opts) {
+	const ext = opts.ext.startsWith(".") ? opts.ext : `.${opts.ext}`;
+	if (opts.originalFilename) {
+		const stem = sanitizeFilename(parse(opts.originalFilename).name);
+		if (stem) return `${stem}---${opts.baseId}${ext}`;
+	}
+	return `${opts.baseId}${ext}`;
+}
+function assertSafeMediaId(id, caller) {
+	if (!id || id.includes("/") || id.includes("\\") || id.includes("\0") || id === "..") throw new Error(`${caller}: unsafe media id: ${JSON.stringify(id)}`);
+}
+function assertSafeBucket(bucket) {
+	if (bucket !== "inbound" && bucket !== "tts" && bucket !== "outbound") throw new Error(`Unsupported media bucket: ${JSON.stringify(bucket)}`);
+}
+async function ensureMediaDir() {
+	const root = getMediaDir();
+	await mkdir(root, {
+		recursive: true,
+		mode: MEDIA_DIR_MODE
+	});
+	return root;
+}
+async function saveMediaBuffer(buffer, opts) {
+	const bucket = opts?.bucket ?? "inbound";
+	const maxBytes = opts?.maxBytes ?? 5242880;
+	if (buffer.byteLength > maxBytes) throw new Error(`Media exceeds ${Math.floor(maxBytes / (1024 * 1024))}MB limit`);
+	await ensureMediaDir();
+	const dir = getMediaBucketDir(bucket);
+	await mkdir(dir, {
+		recursive: true,
+		mode: MEDIA_DIR_MODE
+	});
+	const baseId = randomUUID();
+	const ext = extFromMime(opts?.contentType, opts?.originalFilename);
+	const id = buildSavedMediaId({
+		baseId,
+		ext,
+		originalFilename: opts?.originalFilename
+	});
+	assertSafeMediaId(id, "saveMediaBuffer");
+	const absPath = join(dir, id);
+	if (!isPathInside(dir, absPath)) throw new Error("Media path escapes bucket directory");
+	await writeFile(absPath, buffer, { mode: MEDIA_FILE_MODE });
+	const uri = buildMediaUri(bucket, id);
+	return {
+		id,
+		path: absPath,
+		size: buffer.byteLength,
+		contentType: opts?.contentType?.split(";")[0]?.trim() || MIME_BY_EXT[ext] || "application/octet-stream",
+		bucket,
+		uri
+	};
+}
+function resolveMediaBufferPath(id, bucket = "inbound") {
+	assertSafeBucket(bucket);
+	assertSafeMediaId(id, "resolveMediaBufferPath");
+	const dir = getMediaBucketDir(bucket);
+	const abs = join(dir, id);
+	if (!isPathInside(dir, abs)) throw new Error("Media path escapes bucket directory");
+	return abs;
+}
+async function readMediaBuffer(id, bucket = "inbound", maxBytes = MEDIA_MAX_BYTES) {
+	const path = resolveMediaBufferPath(id, bucket);
+	const buffer = await readFile(path);
+	if (buffer.byteLength > maxBytes) throw new Error(`Media ${JSON.stringify(id)} exceeds read limit`);
+	return {
+		id,
+		path,
+		buffer,
+		size: buffer.byteLength
+	};
+}
+async function deleteMediaBuffer(id, bucket = "inbound") {
+	await rm(resolveMediaBufferPath(id, bucket), { force: true });
+}
+function mimeTypeFromMediaPath(filePath) {
+	return MIME_BY_EXT[extname(filePath).toLowerCase()] ?? "application/octet-stream";
+}
+//#endregion
+export { MEDIA_MAX_BYTES, deleteMediaBuffer, ensureMediaDir, mimeTypeFromMediaPath, readMediaBuffer, resolveMediaBufferPath, saveMediaBuffer };
+
+//# sourceMappingURL=store.js.map

package/dist/src/media/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","names":["parsePath"],"sources":["../../../src/media/store.ts"],"sourcesContent":["import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';\nimport { extname, join, parse as parsePath } from 'node:path';\nimport { randomUUID } from 'node:crypto';\n\nimport { getMediaBucketDir, getMediaDir, isPathInside } from './paths.js';\nimport { buildMediaUri } from './uri.js';\nimport type { MediaBucket, SavedMedia } from './types.js';\n\n/** Default per-file cap for inbound staging (5 MiB). */\nexport const MEDIA_MAX_BYTES = 5 * 1024 * 1024;\n\nconst MEDIA_DIR_MODE = 0o700;\nconst MEDIA_FILE_MODE = 0o644;\n\nconst MIME_BY_EXT: Record<string, string> = {\n  '.png': 'image/png',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.gif': 'image/gif',\n  '.webp': 'image/webp',\n  '.pdf': 'application/pdf',\n  '.txt': 'text/plain',\n  '.md': 'text/markdown',\n  '.json': 'application/json',\n  '.webm': 'audio/webm',\n  '.ogg': 'audio/ogg',\n  '.opus': 'audio/ogg',\n  '.mp3': 'audio/mpeg',\n  '.wav': 'audio/wav',\n  '.m4a': 'audio/mp4',\n};\n\nfunction sanitizeFilename(name: string): string {\n  const base = name.replace(/[/\\\\?%*:|\"<>]/g, '_').trim() || 'file';\n  return base.slice(0, 60);\n}\n\nfunction extFromMime(mimeType: string | undefined, fallbackName?: string): string {\n  if (mimeType) {\n    const m = mimeType.split(';')[0]?.trim().toLowerCase() ?? '';\n    if (m === 'image/jpeg') return '.jpg';\n    if (m === 'image/png') return '.png';\n    if (m === 'image/webp') return '.webp';\n    if (m === 'image/gif') return '.gif';\n    if (m === 'application/pdf') return '.pdf';\n    if (m === 'audio/ogg') return '.ogg';\n    if (m === 'audio/mpeg') return '.mp3';\n    if (m === 'audio/wav') return '.wav';\n    if (m === 'audio/webm') return '.webm';\n    if (m === 'audio/mp4') return '.m4a';\n    if (m === 'text/plain') return '.txt';\n  }\n  const fromName = fallbackName ? extname(fallbackName).toLowerCase() : '';\n  if (fromName && fromName.length <= 10) return fromName;\n  return '.bin';\n}\n\nfunction buildSavedMediaId(opts: {\n  baseId: string;\n  ext: string;\n  originalFilename?: string;\n}): string {\n  const ext = opts.ext.startsWith('.') ? opts.ext : `.${opts.ext}`;\n  if (opts.originalFilename) {\n    const stem = sanitizeFilename(parsePath(opts.originalFilename).name);\n    if (stem) {\n      return `${stem}---${opts.baseId}${ext}`;\n    }\n  }\n  return `${opts.baseId}${ext}`;\n}\n\nfunction assertSafeMediaId(id: string, caller: string): void {\n  if (!id || id.includes('/') || id.includes('\\\\') || id.includes('\\0') || id === '..') {\n    throw new Error(`${caller}: unsafe media id: ${JSON.stringify(id)}`);\n  }\n}\n\nfunction assertSafeBucket(bucket: string): asserts bucket is MediaBucket {\n  if (bucket !== 'inbound' && bucket !== 'tts' && bucket !== 'outbound') {\n    throw new Error(`Unsupported media bucket: ${JSON.stringify(bucket)}`);\n  }\n}\n\nexport async function ensureMediaDir(): Promise<string> {\n  const root = getMediaDir();\n  await mkdir(root, { recursive: true, mode: MEDIA_DIR_MODE });\n  return root;\n}\n\nexport async function saveMediaBuffer(\n  buffer: Buffer,\n  opts?: {\n    contentType?: string;\n    bucket?: MediaBucket;\n    maxBytes?: number;\n    originalFilename?: string;\n  },\n): Promise<SavedMedia> {\n  const bucket = opts?.bucket ?? 'inbound';\n  const maxBytes = opts?.maxBytes ?? MEDIA_MAX_BYTES;\n  if (buffer.byteLength > maxBytes) {\n    throw new Error(`Media exceeds ${Math.floor(maxBytes / (1024 * 1024))}MB limit`);\n  }\n\n  await ensureMediaDir();\n  const dir = getMediaBucketDir(bucket);\n  await mkdir(dir, { recursive: true, mode: MEDIA_DIR_MODE });\n\n  const baseId = randomUUID();\n  const ext = extFromMime(opts?.contentType, opts?.originalFilename);\n  const id = buildSavedMediaId({ baseId, ext, originalFilename: opts?.originalFilename });\n  assertSafeMediaId(id, 'saveMediaBuffer');\n\n  const absPath = join(dir, id);\n  if (!isPathInside(dir, absPath)) {\n    throw new Error('Media path escapes bucket directory');\n  }\n\n  await writeFile(absPath, buffer, { mode: MEDIA_FILE_MODE });\n  const uri = buildMediaUri(bucket, id);\n\n  return {\n    id,\n    path: absPath,\n    size: buffer.byteLength,\n    contentType: opts?.contentType?.split(';')[0]?.trim() || MIME_BY_EXT[ext] || 'application/octet-stream',\n    bucket,\n    uri,\n  };\n}\n\nexport function resolveMediaBufferPath(id: string, bucket: MediaBucket = 'inbound'): string {\n  assertSafeBucket(bucket);\n  assertSafeMediaId(id, 'resolveMediaBufferPath');\n  const dir = getMediaBucketDir(bucket);\n  const abs = join(dir, id);\n  if (!isPathInside(dir, abs)) {\n    throw new Error('Media path escapes bucket directory');\n  }\n  return abs;\n}\n\nexport async function readMediaBuffer(\n  id: string,\n  bucket: MediaBucket = 'inbound',\n  maxBytes = MEDIA_MAX_BYTES,\n): Promise<{ id: string; path: string; buffer: Buffer; size: number }> {\n  const path = resolveMediaBufferPath(id, bucket);\n  const buffer = await readFile(path);\n  if (buffer.byteLength > maxBytes) {\n    throw new Error(`Media ${JSON.stringify(id)} exceeds read limit`);\n  }\n  return { id, path, buffer, size: buffer.byteLength };\n}\n\nexport async function deleteMediaBuffer(id: string, bucket: MediaBucket = 'inbound'): Promise<void> {\n  const path = resolveMediaBufferPath(id, bucket);\n  await rm(path, { force: true });\n}\n\nexport function mimeTypeFromMediaPath(filePath: string): string {\n  const ext = extname(filePath).toLowerCase();\n  return MIME_BY_EXT[ext] ?? 'application/octet-stream';\n}\n"],"mappings":"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"}

package/dist/src/media/types.d.ts

@@ -0,0 +1,34 @@
+/** Media store bucket — maps to `{stateDir}/media/<bucket>/`. */
+export type MediaBucket = 'inbound' | 'tts' | 'outbound';
+/** Persisted media reference — never includes base64. */
+export interface MediaRef {
+    id: string;
+    bucket: MediaBucket;
+    type: string;
+    mimeType: string;
+    name: string;
+    size: number;
+    /** Canonical URI, e.g. `media://inbound/photo---uuid.png`. */
+    uri: string;
+    /** Absolute filesystem path (for MediaPaths transcript fields). */
+    path: string;
+}
+export type SavedMedia = {
+    id: string;
+    path: string;
+    size: number;
+    contentType: string;
+    bucket: MediaBucket;
+    uri: string;
+};
+/** Wire / pre-persist attachment (may include base64 `data`). */
+export interface InboundAttachmentInput {
+    id?: string;
+    type: string;
+    mimeType?: string;
+    data?: string;
+    name?: string;
+    size?: number;
+    /** Already persisted — pass-through by URI. */
+    uri?: string;
+}

package/dist/src/media/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/media/uri.d.ts

@@ -0,0 +1,15 @@
+import type { MediaBucket } from './types.js';
+export declare class MediaUriError extends Error {
+    constructor(message: string);
+}
+export declare function buildMediaUri(bucket: MediaBucket, id: string): string;
+export declare function parseMediaUri(source: string): {
+    bucket: MediaBucket;
+    id: string;
+    uri: string;
+};
+export declare function tryParseMediaUri(source: string): {
+    bucket: MediaBucket;
+    id: string;
+    uri: string;
+} | null;

package/dist/src/media/uri.js

@@ -0,0 +1,51 @@
+//#region src/media/uri.ts
+const BUCKETS = new Set([
+	"inbound",
+	"tts",
+	"outbound"
+]);
+var MediaUriError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "MediaUriError";
+	}
+};
+function buildMediaUri(bucket, id) {
+	if (!id || id.includes("/") || id.includes("\\") || id.includes("\0")) throw new MediaUriError(`Invalid media id: ${JSON.stringify(id)}`);
+	return `media://${bucket}/${encodeURIComponent(id).replace(/%2F/g, "/")}`;
+}
+function parseMediaUri(source) {
+	const trimmed = source.trim();
+	if (!/^media:\/\//i.test(trimmed)) throw new MediaUriError(`Not a media URI: ${JSON.stringify(source)}`);
+	let parsed;
+	try {
+		parsed = new URL(trimmed);
+	} catch {
+		throw new MediaUriError(`Invalid media URI: ${trimmed}`);
+	}
+	const bucket = parsed.hostname;
+	if (!BUCKETS.has(bucket)) throw new MediaUriError(`Unsupported media bucket: ${bucket || "(missing)"}`);
+	let id;
+	try {
+		id = decodeURIComponent(parsed.pathname.replace(/^\/+/, ""));
+	} catch {
+		throw new MediaUriError(`Invalid media URI: ${trimmed}`);
+	}
+	if (!id || id.includes("/") || id.includes("\\") || id.includes("\0")) throw new MediaUriError(`Invalid media URI id: ${trimmed}`);
+	return {
+		bucket,
+		id,
+		uri: trimmed
+	};
+}
+function tryParseMediaUri(source) {
+	try {
+		return parseMediaUri(source);
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { MediaUriError, buildMediaUri, parseMediaUri, tryParseMediaUri };
+
+//# sourceMappingURL=uri.js.map

package/dist/src/media/uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.js","names":[],"sources":["../../../src/media/uri.ts"],"sourcesContent":["import type { MediaBucket } from './types.js';\n\nconst BUCKETS: ReadonlySet<string> = new Set(['inbound', 'tts', 'outbound']);\n\nexport class MediaUriError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'MediaUriError';\n  }\n}\n\nexport function buildMediaUri(bucket: MediaBucket, id: string): string {\n  if (!id || id.includes('/') || id.includes('\\\\') || id.includes('\\0')) {\n    throw new MediaUriError(`Invalid media id: ${JSON.stringify(id)}`);\n  }\n  return `media://${bucket}/${encodeURIComponent(id).replace(/%2F/g, '/')}`;\n}\n\nexport function parseMediaUri(source: string): { bucket: MediaBucket; id: string; uri: string } {\n  const trimmed = source.trim();\n  if (!/^media:\\/\\//i.test(trimmed)) {\n    throw new MediaUriError(`Not a media URI: ${JSON.stringify(source)}`);\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new MediaUriError(`Invalid media URI: ${trimmed}`);\n  }\n\n  const bucket = parsed.hostname;\n  if (!BUCKETS.has(bucket)) {\n    throw new MediaUriError(`Unsupported media bucket: ${bucket || '(missing)'}`);\n  }\n\n  let id: string;\n  try {\n    id = decodeURIComponent(parsed.pathname.replace(/^\\/+/, ''));\n  } catch {\n    throw new MediaUriError(`Invalid media URI: ${trimmed}`);\n  }\n\n  if (!id || id.includes('/') || id.includes('\\\\') || id.includes('\\0')) {\n    throw new MediaUriError(`Invalid media URI id: ${trimmed}`);\n  }\n\n  return {\n    bucket: bucket as MediaBucket,\n    id,\n    uri: trimmed,\n  };\n}\n\nexport function tryParseMediaUri(source: string): { bucket: MediaBucket; id: string; uri: string } | null {\n  try {\n    return parseMediaUri(source);\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";AAEA,MAAM,UAA+B,IAAI,IAAI;CAAC;CAAW;CAAO;CAAW,CAAC;AAE5E,IAAa,gBAAb,cAAmC,MAAM;CACvC,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;AAIhB,SAAgB,cAAc,QAAqB,IAAoB;AACrE,KAAI,CAAC,MAAM,GAAG,SAAS,IAAI,IAAI,GAAG,SAAS,KAAK,IAAI,GAAG,SAAS,KAAK,CACnE,OAAM,IAAI,cAAc,qBAAqB,KAAK,UAAU,GAAG,GAAG;AAEpE,QAAO,WAAW,OAAO,GAAG,mBAAmB,GAAG,CAAC,QAAQ,QAAQ,IAAI;;AAGzE,SAAgB,cAAc,QAAkE;CAC9F,MAAM,UAAU,OAAO,MAAM;AAC7B,KAAI,CAAC,eAAe,KAAK,QAAQ,CAC/B,OAAM,IAAI,cAAc,oBAAoB,KAAK,UAAU,OAAO,GAAG;CAGvE,IAAI;AACJ,KAAI;AACF,WAAS,IAAI,IAAI,QAAQ;SACnB;AACN,QAAM,IAAI,cAAc,sBAAsB,UAAU;;CAG1D,MAAM,SAAS,OAAO;AACtB,KAAI,CAAC,QAAQ,IAAI,OAAO,CACtB,OAAM,IAAI,cAAc,6BAA6B,UAAU,cAAc;CAG/E,IAAI;AACJ,KAAI;AACF,OAAK,mBAAmB,OAAO,SAAS,QAAQ,QAAQ,GAAG,CAAC;SACtD;AACN,QAAM,IAAI,cAAc,sBAAsB,UAAU;;AAG1D,KAAI,CAAC,MAAM,GAAG,SAAS,IAAI,IAAI,GAAG,SAAS,KAAK,IAAI,GAAG,SAAS,KAAK,CACnE,OAAM,IAAI,cAAc,yBAAyB,UAAU;AAG7D,QAAO;EACG;EACR;EACA,KAAK;EACN;;AAGH,SAAgB,iBAAiB,QAAyE;AACxG,KAAI;AACF,SAAO,cAAc,OAAO;SACtB;AACN,SAAO"}

package/dist/src/session/session-title.js

@@ -5,7 +5,6 @@ import { init_logger } from "../utils/logger.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
 import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";
-import { stripInboundFileMetadataFromText } from "../channels/attachments/inbound-persist.js";
 import { stripEnvelopeTimestampPrefix } from "../channels/envelope-timestamp.js";
 import { complete } from "@earendil-works/pi-ai";
 //#region src/session/session-title.ts
@@ -33,7 +32,11 @@ function extractTextFromMessage(m) {
 function firstUserText(messages) {
 	const u = messages.find((m) => m.role === "user");
 	if (!u) return "";
-	return stripInboundFileMetadataFromText(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(extractTextFromMessage(u))));
+	return stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(extractTextFromMessage(u))));
+}
+function stripMediaClaimChecks(text) {
+	if (!text.includes("[media attached:") && !text.includes("xopc-media-uri:")) return text;
+	return text.replace(/\s*\[media attached:[^\]]+\]\s*\r?\nxopc-media-uri:[^\r\n]+\r?\n\s*xopc-media-path:[^\r\n]+(?:\r?\n\s*Use the read_media tool[^\r\n]*)?/g, "").replace(/\s*\[media attached:[^\]]+\]\s*/g, " ").replace(/\s*xopc-media-uri:[^\r\n]+/g, "").replace(/\s*xopc-media-path:[^\r\n]+/g, "").replace(/\s*Use the read_media tool[^\r\n]*/g, "").replace(/\n{3,}/g, "\n\n").trim();
 }
 /** First assistant message that has visible text (skips tool-only assistant rows). */
 function firstAssistantText(messages) {
@@ -70,7 +73,7 @@ function getSessionTitleSource(meta) {
 }
 /** Title from a single user message (first line), for immediate sidebar labels. */
 function provisionalTitleFromUserText(raw) {
-	const text = stripInboundFileMetadataFromText(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText((raw ?? "").trim())));
+	const text = stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText((raw ?? "").trim()));
 	if (!text) return null;
 	const line = text.split(/\n/)[0]?.trim();
 	if (!line) return null;

package/dist/src/session/session-title.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-title.js","names":[],"sources":["../../../src/session/session-title.ts"],"sourcesContent":["/**\n * LLM-generated session titles (webchat and any path using SessionStore).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport { stripSessionStartupContextFromUserText } from '../agent/reply/startup-context.js';\nimport { stripInboundFileMetadataFromText } from '../channels/attachments/inbound-persist.js';\nimport { stripEnvelopeTimestampPrefix } from '../channels/envelope-timestamp.js';\nimport { isCronSessionKey, parseSessionKey } from '../routing/session-key.js';\nimport { resolveModel } from '../providers/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { readAgentMessageContent } from '../agent/memory/agent-message-access.js';\nimport type { SessionStore } from './store.js';\n\nconst log = createLogger('SessionAutoTitle');\n\nconst MAX_TITLE_LEN = 80;\n\n/** Collect visible text from any content block that exposes `text` (pi-ai / OpenAI / Anthropic shapes). */\nfunction extractTextFromMessage(m: AgentMessage): string {\n  const raw = readAgentMessageContent(m);\n  if (typeof raw === 'string') return raw.trim();\n  if (Array.isArray(raw)) {\n    const parts: string[] = [];\n    for (const c of raw) {\n      if (c && typeof c === 'object') {\n        const o = c as unknown as Record<string, unknown>;\n        const type = typeof o.type === 'string' ? o.type : '';\n        if (type === 'toolCall' || type === 'tool_use' || type === 'tool_result') continue;\n        if (typeof o.text === 'string' && o.text.trim()) {\n          parts.push(o.text.trim());\n        }\n      }\n    }\n    return parts.join(' ').trim();\n  }\n  return '';\n}\n\nfunction firstUserText(messages: AgentMessage[]): string {\n  const u = messages.find((m) => m.role === 'user');\n  if (!u) return '';\n  const raw = extractTextFromMessage(u);\n  // User turns include `formatInboundFileTextBlock` text blocks; do not feed [File:…] into title LLM / fallback.\n  // Inbound pipeline / webchat prepends `[YYYY-MM-DD HH:MM TZ]`; strip so titles are not timestamp-led.\n  return stripInboundFileMetadataFromText(\n    stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw)),\n  );\n}\n\n/** First assistant message that has visible text (skips tool-only assistant rows). */\nfunction firstAssistantText(messages: AgentMessage[]): string {\n  for (const m of messages) {\n    if (m.role === 'assistant') {\n      const t = extractTextFromMessage(m);\n      if (t.length > 0) return t;\n    }\n  }\n  return '';\n}\n\nexport function isWebchatSessionKey(sessionKey: string): boolean {\n  const p = parseSessionKey(sessionKey);\n  if (p?.source === 'webchat') return true;\n  return sessionKey.includes(':webchat:');\n}\n\n/** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */\nexport function shouldAutoTitleSessionKey(sessionKey: string): boolean {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) return false;\n  if (isCronSessionKey(raw)) return false;\n  if (raw.toLowerCase().startsWith('heartbeat:')) return false;\n  return true;\n}\n\nexport function sanitizeSessionTitle(raw: string): string {\n  let s = raw.trim();\n  if ((s.startsWith('\"') && s.endsWith('\"')) || (s.startsWith(\"'\") && s.endsWith(\"'\"))) {\n    s = s.slice(1, -1).trim();\n  }\n  const lineBreak = s.indexOf('\\n');\n  if (lineBreak !== -1) s = s.slice(0, lineBreak).trim();\n  if (s.length > MAX_TITLE_LEN) s = s.slice(0, MAX_TITLE_LEN - 1).trimEnd() + '…';\n  return s;\n}\n\nexport type SessionTitleSource = 'provisional' | 'llm' | 'user';\n\nexport function getSessionTitleSource(\n  meta: { customData?: Record<string, unknown> } | null | undefined,\n): SessionTitleSource | null {\n  const raw = meta?.customData?.titleSource;\n  if (raw === 'provisional' || raw === 'llm' || raw === 'user') return raw;\n  return null;\n}\n\n/** Title from a single user message (first line), for immediate sidebar labels. */\nexport function provisionalTitleFromUserText(raw: string): string | null {\n  const text = stripInboundFileMetadataFromText(\n    stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText((raw ?? '').trim())),\n  );\n  if (!text) return null;\n  const line = text.split(/\\n/)[0]?.trim();\n  if (!line) return null;\n  return sanitizeSessionTitle(line);\n}\n\n/** Non-LLM title: first line of first user text, else first assistant line. */\nexport function fallbackTitleFromMessages(messages: AgentMessage[]): string | null {\n  const u = firstUserText(messages);\n  if (u) {\n    const line = u.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  const a = firstAssistantText(messages);\n  if (a) {\n    const line = a.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  return null;\n}\n\n/**\n * Returns a title string, or null if generation should be skipped or failed.\n */\nexport async function generateSessionTitleFromMessages(\n  modelRef: string,\n  messages: AgentMessage[],\n  signal?: AbortSignal,\n): Promise<string | null> {\n  const userText = firstUserText(messages);\n  const assistantText = firstAssistantText(messages);\n  if (!userText && !assistantText) return null;\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    log.warn({ err, modelRef }, 'Cannot resolve model for session title');\n    return null;\n  }\n\n  const prompt =\n    userText && assistantText\n      ? `You label chat sessions. Given the first user message and the start of the assistant reply, output ONE short title (max 8 words). No quotes. No punctuation at the end. Use the same language as the user when possible.\n\nUser: ${userText.slice(0, 2000)}\n\nAssistant: ${assistantText.slice(0, 2000)}\n\nTitle:`\n      : userText\n        ? `The assistant reply only used tools (no visible text yet). Output ONE short title (max 8 words) based only on the user's first message. No quotes. No punctuation at the end. Use the same language as the user.\n\nUser: ${userText.slice(0, 2000)}\n\nTitle:`\n        : `Output ONE short title (max 8 words) for this assistant reply. No quotes. No punctuation at the end.\n\nAssistant: ${assistantText!.slice(0, 2000)}\n\nTitle:`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 64,\n        temperature: 0.35,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const cleaned = sanitizeSessionTitle(text);\n    return cleaned.length > 0 ? cleaned : null;\n  } catch (err) {\n    log.warn({ err }, 'Session title LLM call failed');\n    return null;\n  }\n}\n\nexport type SessionTitleUpdatedHook = (sessionKey: string, name: string) => void | Promise<void>;\n\n/** Whether post-turn LLM refine may run (provisional or still unnamed; not user-locked). */\nexport function shouldRefineSessionTitleWithLlm(\n  meta: { name?: string; customData?: Record<string, unknown> } | null | undefined,\n): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  if (meta.name?.trim()) return source === 'provisional';\n  return true;\n}\n\nfunction canAutoWriteTitle(meta: { name?: string; customData?: Record<string, unknown> } | null): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  return !meta.name?.trim();\n}\n\n/**\n * Set provisional title from first user text when session is still unnamed.\n * Skips cron/heartbeat keys and user-locked titles.\n */\nexport async function maybeSetProvisionalSessionTitle(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  userText?: string,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) return;\n  if (!canAutoWriteTitle(meta)) return;\n\n  let title: string | null = null;\n  if (userText?.trim()) {\n    title = provisionalTitleFromUserText(userText);\n  }\n  if (!title) {\n    const messages = await sessionStore.load(sessionKey);\n    if (!messages.length) return;\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'provisional' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: provisional updateMetadata failed');\n  }\n}\n\n/**\n * LLM refine when title is empty or still provisional (not user-locked).\n */\nexport async function maybeRefineSessionTitleWithLlm(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  modelRef: string | undefined,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let messages = await sessionStore.load(sessionKey);\n  if (!messages.length) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) {\n    await sessionStore.saveMessages(sessionKey, messages);\n    meta = await sessionStore.getMetadata(sessionKey);\n  }\n  if (!meta) {\n    log.warn({ sessionKey }, 'Session title: metadata missing after save');\n    return;\n  }\n  if (!shouldRefineSessionTitleWithLlm(meta)) return;\n\n  const source = getSessionTitleSource(meta);\n  let title: string | null = null;\n  const ref = modelRef?.trim();\n  if (ref) {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 25_000);\n    try {\n      title = await generateSessionTitleFromMessages(ref, messages, controller.signal);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n  if (!title) {\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  const existing = meta.name?.trim();\n  if (existing === title) {\n    if (source !== 'llm') {\n      try {\n        await sessionStore.updateMetadata(sessionKey, {\n          customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n        });\n      } catch {\n        /* ignore */\n      }\n    }\n    return;\n  }\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: refine updateMetadata failed');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-title.js","names":[],"sources":["../../../src/session/session-title.ts"],"sourcesContent":["/**\n * LLM-generated session titles (webchat and any path using SessionStore).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport { stripSessionStartupContextFromUserText } from '../agent/reply/startup-context.js';\nimport { stripEnvelopeTimestampPrefix } from '../channels/envelope-timestamp.js';\nimport { isCronSessionKey, parseSessionKey } from '../routing/session-key.js';\nimport { resolveModel } from '../providers/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { readAgentMessageContent } from '../agent/memory/agent-message-access.js';\nimport type { SessionStore } from './store.js';\n\nconst log = createLogger('SessionAutoTitle');\n\nconst MAX_TITLE_LEN = 80;\n\n/** Collect visible text from any content block that exposes `text` (pi-ai / OpenAI / Anthropic shapes). */\nfunction extractTextFromMessage(m: AgentMessage): string {\n  const raw = readAgentMessageContent(m);\n  if (typeof raw === 'string') return raw.trim();\n  if (Array.isArray(raw)) {\n    const parts: string[] = [];\n    for (const c of raw) {\n      if (c && typeof c === 'object') {\n        const o = c as unknown as Record<string, unknown>;\n        const type = typeof o.type === 'string' ? o.type : '';\n        if (type === 'toolCall' || type === 'tool_use' || type === 'tool_result') continue;\n        if (typeof o.text === 'string' && o.text.trim()) {\n          parts.push(o.text.trim());\n        }\n      }\n    }\n    return parts.join(' ').trim();\n  }\n  return '';\n}\n\nfunction firstUserText(messages: AgentMessage[]): string {\n  const u = messages.find((m) => m.role === 'user');\n  if (!u) return '';\n  const raw = extractTextFromMessage(u);\n  return stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw)));\n}\n\nfunction stripMediaClaimChecks(text: string): string {\n  if (!text.includes('[media attached:') && !text.includes('xopc-media-uri:')) {\n    return text;\n  }\n  return text\n    .replace(\n      /\\s*\\[media attached:[^\\]]+\\]\\s*\\r?\\nxopc-media-uri:[^\\r\\n]+\\r?\\n\\s*xopc-media-path:[^\\r\\n]+(?:\\r?\\n\\s*Use the read_media tool[^\\r\\n]*)?/g,\n      '',\n    )\n    .replace(/\\s*\\[media attached:[^\\]]+\\]\\s*/g, ' ')\n    .replace(/\\s*xopc-media-uri:[^\\r\\n]+/g, '')\n    .replace(/\\s*xopc-media-path:[^\\r\\n]+/g, '')\n    .replace(/\\s*Use the read_media tool[^\\r\\n]*/g, '')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n\n/** First assistant message that has visible text (skips tool-only assistant rows). */\nfunction firstAssistantText(messages: AgentMessage[]): string {\n  for (const m of messages) {\n    if (m.role === 'assistant') {\n      const t = extractTextFromMessage(m);\n      if (t.length > 0) return t;\n    }\n  }\n  return '';\n}\n\nexport function isWebchatSessionKey(sessionKey: string): boolean {\n  const p = parseSessionKey(sessionKey);\n  if (p?.source === 'webchat') return true;\n  return sessionKey.includes(':webchat:');\n}\n\n/** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */\nexport function shouldAutoTitleSessionKey(sessionKey: string): boolean {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) return false;\n  if (isCronSessionKey(raw)) return false;\n  if (raw.toLowerCase().startsWith('heartbeat:')) return false;\n  return true;\n}\n\nexport function sanitizeSessionTitle(raw: string): string {\n  let s = raw.trim();\n  if ((s.startsWith('\"') && s.endsWith('\"')) || (s.startsWith(\"'\") && s.endsWith(\"'\"))) {\n    s = s.slice(1, -1).trim();\n  }\n  const lineBreak = s.indexOf('\\n');\n  if (lineBreak !== -1) s = s.slice(0, lineBreak).trim();\n  if (s.length > MAX_TITLE_LEN) s = s.slice(0, MAX_TITLE_LEN - 1).trimEnd() + '…';\n  return s;\n}\n\nexport type SessionTitleSource = 'provisional' | 'llm' | 'user';\n\nexport function getSessionTitleSource(\n  meta: { customData?: Record<string, unknown> } | null | undefined,\n): SessionTitleSource | null {\n  const raw = meta?.customData?.titleSource;\n  if (raw === 'provisional' || raw === 'llm' || raw === 'user') return raw;\n  return null;\n}\n\n/** Title from a single user message (first line), for immediate sidebar labels. */\nexport function provisionalTitleFromUserText(raw: string): string | null {\n  const text = stripEnvelopeTimestampPrefix(\n    stripSessionStartupContextFromUserText((raw ?? '').trim()),\n  );\n  if (!text) return null;\n  const line = text.split(/\\n/)[0]?.trim();\n  if (!line) return null;\n  return sanitizeSessionTitle(line);\n}\n\n/** Non-LLM title: first line of first user text, else first assistant line. */\nexport function fallbackTitleFromMessages(messages: AgentMessage[]): string | null {\n  const u = firstUserText(messages);\n  if (u) {\n    const line = u.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  const a = firstAssistantText(messages);\n  if (a) {\n    const line = a.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  return null;\n}\n\n/**\n * Returns a title string, or null if generation should be skipped or failed.\n */\nexport async function generateSessionTitleFromMessages(\n  modelRef: string,\n  messages: AgentMessage[],\n  signal?: AbortSignal,\n): Promise<string | null> {\n  const userText = firstUserText(messages);\n  const assistantText = firstAssistantText(messages);\n  if (!userText && !assistantText) return null;\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    log.warn({ err, modelRef }, 'Cannot resolve model for session title');\n    return null;\n  }\n\n  const prompt =\n    userText && assistantText\n      ? `You label chat sessions. Given the first user message and the start of the assistant reply, output ONE short title (max 8 words). No quotes. No punctuation at the end. Use the same language as the user when possible.\n\nUser: ${userText.slice(0, 2000)}\n\nAssistant: ${assistantText.slice(0, 2000)}\n\nTitle:`\n      : userText\n        ? `The assistant reply only used tools (no visible text yet). Output ONE short title (max 8 words) based only on the user's first message. No quotes. No punctuation at the end. Use the same language as the user.\n\nUser: ${userText.slice(0, 2000)}\n\nTitle:`\n        : `Output ONE short title (max 8 words) for this assistant reply. No quotes. No punctuation at the end.\n\nAssistant: ${assistantText!.slice(0, 2000)}\n\nTitle:`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 64,\n        temperature: 0.35,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const cleaned = sanitizeSessionTitle(text);\n    return cleaned.length > 0 ? cleaned : null;\n  } catch (err) {\n    log.warn({ err }, 'Session title LLM call failed');\n    return null;\n  }\n}\n\nexport type SessionTitleUpdatedHook = (sessionKey: string, name: string) => void | Promise<void>;\n\n/** Whether post-turn LLM refine may run (provisional or still unnamed; not user-locked). */\nexport function shouldRefineSessionTitleWithLlm(\n  meta: { name?: string; customData?: Record<string, unknown> } | null | undefined,\n): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  if (meta.name?.trim()) return source === 'provisional';\n  return true;\n}\n\nfunction canAutoWriteTitle(meta: { name?: string; customData?: Record<string, unknown> } | null): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  return !meta.name?.trim();\n}\n\n/**\n * Set provisional title from first user text when session is still unnamed.\n * Skips cron/heartbeat keys and user-locked titles.\n */\nexport async function maybeSetProvisionalSessionTitle(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  userText?: string,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) return;\n  if (!canAutoWriteTitle(meta)) return;\n\n  let title: string | null = null;\n  if (userText?.trim()) {\n    title = provisionalTitleFromUserText(userText);\n  }\n  if (!title) {\n    const messages = await sessionStore.load(sessionKey);\n    if (!messages.length) return;\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'provisional' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: provisional updateMetadata failed');\n  }\n}\n\n/**\n * LLM refine when title is empty or still provisional (not user-locked).\n */\nexport async function maybeRefineSessionTitleWithLlm(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  modelRef: string | undefined,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let messages = await sessionStore.load(sessionKey);\n  if (!messages.length) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) {\n    await sessionStore.saveMessages(sessionKey, messages);\n    meta = await sessionStore.getMetadata(sessionKey);\n  }\n  if (!meta) {\n    log.warn({ sessionKey }, 'Session title: metadata missing after save');\n    return;\n  }\n  if (!shouldRefineSessionTitleWithLlm(meta)) return;\n\n  const source = getSessionTitleSource(meta);\n  let title: string | null = null;\n  const ref = modelRef?.trim();\n  if (ref) {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 25_000);\n    try {\n      title = await generateSessionTitleFromMessages(ref, messages, controller.signal);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n  if (!title) {\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  const existing = meta.name?.trim();\n  if (existing === title) {\n    if (source !== 'llm') {\n      try {\n        await sessionStore.updateMetadata(sessionKey, {\n          customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n        });\n      } catch {\n        /* ignore */\n      }\n    }\n    return;\n  }\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: refine updateMetadata failed');\n  }\n}\n"],"mappings":"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"}

package/dist/src/session/store.js

@@ -480,7 +480,7 @@ var SessionStore = class {
 				tool_calls: m.tool_calls,
 				name: m.name
 			};
-			if (Array.isArray(m.attachments) && m.attachments.length > 0) row.attachments = m.attachments;
+			if (Array.isArray(m.media) && m.media.length > 0) row.media = m.media;
 			const rawUsage = m.usage;
 			if (rawUsage && typeof rawUsage === "object") {
 				const inputTokens = typeof rawUsage.input === "number" ? rawUsage.input : void 0;

package/dist/src/session/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","names":[],"sources":["../../../src/session/store.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../config/schema.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport { readPostCompactionContext } from '../agent/reply/post-compaction-context.js';\nimport { createLogger } from '../utils/logger.js';\nimport { SessionCompactor, type CompactionConfig, type CompactionResult } from '../agent/memory/compaction.js';\nimport { SlidingWindow, type WindowConfig } from '../agent/memory/window.js';\nimport {\n  requireXopcDatabase,\n  appendTranscriptEntry,\n  captureCompactionCheckpoint,\n  deleteSessionRecord,\n  ensureSessionRecord,\n  estimateTokensFromMessages,\n  getCompactionCheckpointDetail,\n  getGlobalSessionStats,\n  getSessionMetadata,\n  listCompactionCheckpoints,\n  listSessionMetadata,\n  listSessionsByAgent,\n  loadCheckpointRows,\n  loadLlmMessagesForSession,\n  loadTranscriptRowsForSession,\n  patchSessionMetadata,\n  replaceTranscriptRows,\n  resetSessionRecord,\n  restoreCompactionCheckpoint,\n} from '../storage/sqlite/index.js';\nimport type { TranscriptCompactionRecord, XopcSessionTranscriptV1 } from './transcript-format.js';\nimport {\n  buildSessionContextForLlm,\n  mergeLlmMessagesPreservingContextRows,\n  type TranscriptStoredRow,\n  type XopcTranscriptContextEntry,\n} from './session-context-for-llm.js';\nimport { normalizeCompactionCheckpointId } from './compaction-checkpoints.js';\nimport type {\n  SessionMetadata,\n  SessionDetail,\n  SessionListQuery,\n  PaginatedResult,\n  GlobalSessionStats,\n  ExportFormat,\n  SessionExport,\n  SessionTranscriptSummary,\n  CompactionCheckpointSummary,\n  CompactionCheckpointDetail,\n} from './types.js';\nimport { SessionStatus } from './types.js';\nimport type { Message } from './types.js';\nimport type { SessionTranscriptUpdate } from './transcript-events.js';\nimport { isAppendOnlyLlmTranscriptMessage } from './transcript-stats.js';\n\nconst log = createLogger('SessionStore');\n\nconst INDEX_VERSION = '1.0';\n\nexport interface SessionStoreOptions {\n  config: Config;\n}\n\nexport class SessionStore {\n  private window: SlidingWindow;\n  private compactor: SessionCompactor;\n\n  constructor(\n    private options: SessionStoreOptions,\n    windowConfig?: Partial<WindowConfig>,\n    compactionConfig?: Partial<CompactionConfig>,\n  ) {\n    this.window = new SlidingWindow(windowConfig);\n    this.compactor = new SessionCompactor(compactionConfig);\n  }\n\n  private resolveWorkspaceCwd(sessionKey: string): string {\n    return resolveEffectiveAgentProfileForSession(this.options.config, sessionKey).resolvedWorkspacePath;\n  }\n\n  private async runStoreMutation<T>(fn: () => Promise<T>): Promise<T> {\n    return fn();\n  }\n\n  async initialize(): Promise<void> {\n    requireXopcDatabase();\n    log.debug('Session store initialized (SQLite)');\n  }\n\n  getSessionsRoot(): string {\n    return resolveStateDir();\n  }\n\n  async resolveTranscriptPath(\n    sessionKey: string,\n  ): Promise<{ sessionId: string; sessionKey: string }> {\n    requireXopcDatabase();\n    const cwd = this.resolveWorkspaceCwd(sessionKey);\n    const meta = ensureSessionRecord(sessionKey, cwd);\n    return { sessionId: meta.transcriptId!, sessionKey };\n  }\n\n  async appendTranscriptMessage(sessionKey: string, message: AgentMessage): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(sessionKey);\n      ensureSessionRecord(sessionKey, cwd);\n      appendTranscriptEntry(sessionKey, message);\n    });\n  }\n\n  async getByAgent(agentId: string): Promise<SessionMetadata[]> {\n    requireXopcDatabase();\n    return listSessionsByAgent(agentId);\n  }\n\n  async getByAccount(accountId: string): Promise<SessionMetadata[]> {\n    const { items } = await this.list({ limit: 100_000 });\n    return items.filter((m) => m.routing?.accountId === accountId);\n  }\n\n  async getByPeer(peerKind: string, peerId: string): Promise<SessionMetadata[]> {\n    const { items } = await this.list({ limit: 100_000 });\n    return items.filter((m) => m.routing?.peerKind === peerKind && m.routing.peerId === peerId);\n  }\n\n  async getMainSession(channel: string, accountId: string): Promise<SessionMetadata | null> {\n    const { items } = await this.list({ limit: 100_000 });\n    return (\n      items.find(\n        (m) =>\n          m.routing?.source === channel &&\n          m.routing.accountId === accountId &&\n          m.routing.peerKind === 'dm' &&\n          m.routing.peerId === 'main',\n      ) ?? null\n    );\n  }\n\n  async refreshIndex(): Promise<void> {\n    /* no-op: SQLite is authoritative */\n  }\n\n  async list(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    requireXopcDatabase();\n    return listSessionMetadata(query);\n  }\n\n  async get(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return null;\n    }\n    const messages = await this.loadDisplayMessages(key);\n    return this.buildSessionDetail(key, metadata, messages, options);\n  }\n\n  async getMessagePage(\n    key: string,\n    options: {\n      offset?: number;\n      limit?: number;\n      before?: string;\n      includeTranscriptSummary?: boolean;\n      includeTranscriptRows?: boolean;\n    } = {},\n  ): Promise<{\n    session: SessionDetail;\n    pagination: {\n      total: number;\n      limit: number;\n      offset: number;\n      hasMore: boolean;\n      before?: string;\n      nextBeforeCursor?: string;\n    };\n  } | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return null;\n    }\n\n    const limit = Math.min(200, Math.max(1, Math.trunc(options.limit ?? 50)));\n    const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n    const parsedBefore = options.before ? Number.parseInt(options.before, 10) : undefined;\n    const hasBeforeCursor = parsedBefore !== undefined && Number.isFinite(parsedBefore);\n\n    const displayMessages = await this.loadDisplayMessages(key);\n    const page = this.paginateDisplayMessages(displayMessages, {\n      limit,\n      offset: hasBeforeCursor ? undefined : offset,\n      beforeEndIndex: hasBeforeCursor ? parsedBefore : undefined,\n    });\n\n    const session = await this.buildSessionDetail(key, metadata, page.messages, options);\n    const nextBeforeCursor = page.startIndex > 0 ? String(page.startIndex) : undefined;\n\n    return {\n      session,\n      pagination: {\n        total: page.total,\n        limit,\n        offset,\n        hasMore: hasBeforeCursor ? page.startIndex > 0 : offset + limit < page.total,\n        ...(hasBeforeCursor ? { before: String(page.endIndex) } : {}),\n        ...(nextBeforeCursor ? { nextBeforeCursor } : {}),\n      },\n    };\n  }\n\n  private async buildSessionDetail(\n    key: string,\n    metadata: SessionMetadata,\n    messages: AgentMessage[],\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail> {\n    let transcriptSummary: SessionTranscriptSummary | undefined;\n    if (options?.includeTranscriptSummary) {\n      const env = await this.loadTranscriptDocument(key);\n      if (env) {\n        transcriptSummary = {\n          id: env.id,\n          version: env.version,\n          createdAt: env.createdAt,\n          updatedAt: env.updatedAt,\n          compactionCount: env.compactions?.length ?? 0,\n        };\n      }\n    }\n    let transcriptRows: TranscriptStoredRow[] | undefined;\n    if (options?.includeTranscriptRows) {\n      transcriptRows = await this.loadTranscriptRows(key);\n    }\n    return {\n      ...metadata,\n      messages: this.convertMessages(messages),\n      ...(transcriptSummary ? { transcriptSummary } : {}),\n      ...(transcriptRows !== undefined ? { transcriptRows } : {}),\n    };\n  }\n\n  async loadTranscriptRows(key: string): Promise<TranscriptStoredRow[]> {\n    requireXopcDatabase();\n    return loadTranscriptRowsForSession(key);\n  }\n\n  async getMetadata(key: string): Promise<SessionMetadata | null> {\n    requireXopcDatabase();\n    return getSessionMetadata(key);\n  }\n\n  async updateMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      patchSessionMetadata(key, updates);\n      log.debug({ key, updates }, 'Session metadata updated');\n    });\n  }\n\n  async reset(key: string): Promise<{ sessionId: string; previousSessionId: string } | null> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      const outcome = resetSessionRecord(key, cwd);\n      if (outcome) {\n        log.info({ key, ...outcome }, 'Session reset');\n      }\n      return outcome;\n    });\n  }\n\n  async delete(key: string): Promise<boolean> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const ok = deleteSessionRecord(key);\n      if (ok) {\n        log.info({ key }, 'Session deleted');\n      }\n      return ok;\n    });\n  }\n\n  async deleteMany(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    const success: string[] = [];\n    const failed: string[] = [];\n    for (const key of keys) {\n      try {\n        if (await this.delete(key)) {\n          success.push(key);\n        } else {\n          failed.push(key);\n        }\n      } catch {\n        failed.push(key);\n      }\n    }\n    return { success, failed };\n  }\n\n  async setStatus(key: string, status: SessionStatus): Promise<void> {\n    await this.updateMetadata(key, { status });\n  }\n\n  async archive(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ARCHIVED);\n  }\n\n  async unarchive(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ACTIVE);\n  }\n\n  async pin(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.PINNED);\n  }\n\n  async unpin(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ACTIVE);\n  }\n\n  async loadMessages(_key: string, _options?: { fromArchive?: boolean }): Promise<AgentMessage[]> {\n    requireXopcDatabase();\n    return loadLlmMessagesForSession(_key);\n  }\n\n  async loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata?.transcriptId) {\n      return null;\n    }\n    const rows = await this.loadTranscriptRows(key);\n    const compactions: TranscriptCompactionRecord[] = [];\n    for (const row of rows) {\n      if ((row as { type?: string }).type === 'compaction') {\n        const c = row as unknown as TranscriptCompactionRecord & { type: 'compaction' };\n        compactions.push({\n          at: c.at ?? new Date().toISOString(),\n          summary: c.summary ?? '',\n          firstKeptIndex: Number(c.firstKeptIndex ?? 0),\n          tokensBefore: c.tokensBefore ?? 0,\n          tokensAfter: (c as { tokensAfter?: number }).tokensAfter ?? 0,\n        });\n      }\n    }\n    return {\n      type: 'xopc_session_transcript',\n      version: 1,\n      id: metadata.transcriptId,\n      createdAt: metadata.createdAt,\n      updatedAt: metadata.updatedAt,\n      messages: rows,\n      ...(compactions.length > 0 ? { compactions } : {}),\n    };\n  }\n\n  async syncEmbeddedTranscriptUpdate(update: SessionTranscriptUpdate): Promise<void> {\n    const sessionKey = update.sessionKey?.trim();\n    if (!sessionKey) {\n      return;\n    }\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(sessionKey);\n      ensureSessionRecord(sessionKey, cwd);\n\n      if (update.message && isAppendOnlyLlmTranscriptMessage(update.message)) {\n        appendTranscriptEntry(sessionKey, update.message as AgentMessage);\n      }\n    });\n  }\n\n  async appendTranscriptContextEntry(\n    key: string,\n    entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>,\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const row: XopcTranscriptContextEntry = {\n        kind: 'context',\n        id: typeof entry.id === 'string' ? entry.id : undefined,\n        text: typeof entry.text === 'string' ? entry.text : undefined,\n        data: entry.data,\n        createdAt: entry.createdAt ?? new Date().toISOString(),\n      };\n      appendTranscriptEntry(key, row);\n    });\n  }\n\n  async saveMessages(key: string, messages: AgentMessage[]): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const prev = await this.loadTranscriptRows(key);\n      const merged = mergeLlmMessagesPreservingContextRows(prev, messages);\n      replaceTranscriptRows(key, merged);\n    });\n  }\n\n  getWindowStats(messages: AgentMessage[]) {\n    return this.window.getStats(messages);\n  }\n\n  needsCompaction(key: string, messages: AgentMessage[], contextWindow: number) {\n    return this.compactor.needsCompaction(messages, contextWindow);\n  }\n\n  prepareCompaction(key: string, messages: AgentMessage[], contextWindow: number) {\n    const result = this.compactor.needsCompaction(messages, contextWindow);\n    return { needsCompaction: result.needed, messages, stats: result };\n  }\n\n  async applyCompaction(\n    key: string,\n    messages: AgentMessage[],\n    result: CompactionResult,\n  ): Promise<AgentMessage[]> {\n    const compacted = this.compactor.applyCompaction(messages, result);\n    return this.runStoreMutation(async () => {\n      const prev = await this.loadTranscriptRows(key);\n      const merged = mergeLlmMessagesPreservingContextRows(prev, compacted);\n      captureCompactionCheckpoint(key);\n      replaceTranscriptRows(key, merged, {\n        appendCompaction: {\n          at: new Date().toISOString(),\n          summary: result.summary,\n          firstKeptIndex: result.firstKeptIndex,\n          tokensBefore: result.tokensBefore,\n          tokensAfter: result.tokensAfter,\n        },\n      });\n      const metadata = await this.getMetadata(key);\n      if (metadata) {\n        await this.updateMetadata(key, { compactedCount: metadata.compactedCount + 1 });\n      }\n      log.info(\n        { key, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter, keptMessages: compacted.length },\n        'Session compacted',\n      );\n      await this.injectPostCompactionContext(key);\n      return compacted;\n    });\n  }\n\n  async compact(\n    key: string,\n    messages: AgentMessage[],\n    contextWindow: number,\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    void contextWindow;\n    const result = await this.compactor.compact(messages, instructions, force);\n    if (result.compacted) {\n      await this.applyCompaction(key, messages, result);\n    }\n    return result;\n  }\n\n  async getCompactionStats(key: string) {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return undefined;\n    }\n    return {\n      compactionCount: metadata.compactedCount,\n      totalTokensBefore: 0,\n      totalTokensAfter: 0,\n      lastCompactionAt: undefined,\n    };\n  }\n\n  async listCompactionCheckpoints(key: string): Promise<CompactionCheckpointSummary[]> {\n    requireXopcDatabase();\n    return listCompactionCheckpoints(key);\n  }\n\n  async getCompactionCheckpointDetail(\n    key: string,\n    checkpointId: string,\n  ): Promise<CompactionCheckpointDetail | null> {\n    requireXopcDatabase();\n    const id = normalizeCompactionCheckpointId(checkpointId);\n    if (!id) {\n      return null;\n    }\n    return getCompactionCheckpointDetail(key, id);\n  }\n\n  async restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const id = normalizeCompactionCheckpointId(checkpointId);\n      if (!id) {\n        throw new Error(`Invalid checkpoint id: ${checkpointId}`);\n      }\n      restoreCompactionCheckpoint(key, id);\n    });\n  }\n\n  async deleteSession(key: string): Promise<boolean> {\n    return this.delete(key);\n  }\n\n  async load(key: string, options?: { fromArchive?: boolean }): Promise<AgentMessage[]> {\n    return this.loadMessages(key, options);\n  }\n\n  async estimateTokenUsage(_key: string, messages: AgentMessage[]): Promise<number> {\n    return this.estimateTokens(messages);\n  }\n\n  async searchInSession(key: string, keyword: string): Promise<Message[]> {\n    const messages = await this.loadDisplayMessages(key);\n    const q = keyword.toLowerCase();\n    return this.convertMessages(\n      messages.filter((m) => this.extractTextContent(this.messageContent(m)).toLowerCase().includes(q)),\n    );\n  }\n\n  async exportSession(key: string, format: ExportFormat): Promise<string> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      throw new Error(`Session not found: ${key}`);\n    }\n    const rows = await this.loadTranscriptRows(key);\n    const messages = this.convertMessages(buildSessionContextForLlm(rows));\n    const payload: SessionExport = {\n      version: INDEX_VERSION,\n      exportedAt: new Date().toISOString(),\n      metadata,\n      messages,\n      transcriptRows: rows,\n    };\n    if (format === 'json') {\n      return JSON.stringify(payload, null, 2);\n    }\n    const lines = [`# ${metadata.name ?? metadata.key}`, '', `Exported: ${payload.exportedAt}`, ''];\n    for (const msg of messages) {\n      lines.push(`## ${msg.role}`, '', typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content), '');\n    }\n    return lines.join('\\n');\n  }\n\n  async getStats(): Promise<GlobalSessionStats> {\n    requireXopcDatabase();\n    return getGlobalSessionStats();\n  }\n\n  async archiveOld(olderThanDays: number): Promise<number> {\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - olderThanDays);\n    const list = await this.list({ limit: 100_000 });\n    let archived = 0;\n    for (const session of list.items) {\n      if (session.status !== SessionStatus.ARCHIVED && session.status !== SessionStatus.PINNED) {\n        const lastAccess = new Date(session.lastAccessedAt);\n        if (lastAccess < cutoff) {\n          await this.archive(session.key);\n          archived++;\n        }\n      }\n    }\n    return archived;\n  }\n\n  estimateTokens(messages: AgentMessage[]): number {\n    return estimateTokensFromMessages(messages);\n  }\n\n  private async loadDisplayMessages(key: string): Promise<AgentMessage[]> {\n    requireXopcDatabase();\n    const checkpoints = listCompactionCheckpoints(key);\n    const rowSets: TranscriptStoredRow[][] = [];\n    for (const checkpoint of [...checkpoints].reverse()) {\n      rowSets.push(loadCheckpointRows(key, checkpoint.id));\n    }\n    rowSets.push(await this.loadTranscriptRows(key));\n\n    const messages: AgentMessage[] = [];\n    const seen = new Set<string>();\n    for (const rows of rowSets) {\n      for (const message of buildSessionContextForLlm(rows)) {\n        if (this.isCompactionSummaryMessage(message)) {\n          continue;\n        }\n        const identity = this.displayMessageIdentity(message);\n        if (seen.has(identity)) {\n          continue;\n        }\n        seen.add(identity);\n        messages.push(message);\n      }\n    }\n    return messages;\n  }\n\n  private paginateDisplayMessages(\n    messages: AgentMessage[],\n    options: {\n      offset?: number;\n      limit?: number;\n      beforeEndIndex?: number;\n    } = {},\n  ): { messages: AgentMessage[]; total: number; startIndex: number; endIndex: number } {\n    const total = messages.length;\n    const limit = Math.min(200, Math.max(1, Math.trunc(options.limit ?? 50)));\n    const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n\n    let startIndex: number;\n    let endIndex: number;\n    if (options.beforeEndIndex !== undefined && Number.isFinite(options.beforeEndIndex)) {\n      endIndex = Math.min(total, Math.max(0, Math.trunc(options.beforeEndIndex)));\n      startIndex = Math.max(0, endIndex - limit);\n    } else {\n      endIndex = Math.max(0, total - offset);\n      startIndex = Math.max(0, endIndex - limit);\n    }\n\n    return {\n      messages: messages.slice(startIndex, endIndex),\n      total,\n      startIndex,\n      endIndex,\n    };\n  }\n\n  private displayMessageIdentity(message: AgentMessage): string {\n    const record = message as unknown as Record<string, unknown>;\n    return JSON.stringify({\n      role: message.role,\n      timestamp: record.timestamp,\n      toolCallId: record.toolCallId ?? record.tool_call_id,\n      toolName: record.toolName,\n      content: this.messageContent(message),\n    });\n  }\n\n  private messageContent(msg: AgentMessage): unknown {\n    return (msg as { content?: unknown }).content;\n  }\n\n  private isCompactionSummaryMessage(msg: AgentMessage): boolean {\n    if (msg.role !== 'user') {\n      return false;\n    }\n    const text = this.extractTextContent(this.messageContent(msg)).trim();\n    return /^\\[Previous conversation summary\\]/i.test(text);\n  }\n\n  private extractTextContent(content: unknown): string {\n    if (typeof content === 'string') {\n      return content;\n    }\n    if (Array.isArray(content)) {\n      const parts: string[] = [];\n      for (const item of content) {\n        if (typeof item !== 'object' || item === null || !('type' in item)) {\n          continue;\n        }\n        const c = item as { type?: string; text?: string; name?: string };\n        if (c.type === 'text' && typeof c.text === 'string') {\n          parts.push(c.text);\n        } else if (c.type === 'toolCall' || c.type === 'tool_use') {\n          parts.push(c.name ? `[${c.name}]` : '');\n        }\n      }\n      return parts.join('');\n    }\n    return '';\n  }\n\n  private async injectPostCompactionContext(key: string): Promise<void> {\n    const contextText = readPostCompactionContext({\n      cfg: this.options.config,\n      sessionKey: key,\n    });\n    if (!contextText?.trim()) {\n      return;\n    }\n    try {\n      await this.appendTranscriptContextEntry(key, {\n        id: `post-compaction-${Date.now()}`,\n        text: contextText,\n        createdAt: new Date().toISOString(),\n      });\n    } catch (err) {\n      log.warn({ err, key }, 'Post-compaction context injection failed');\n    }\n  }\n\n  private convertMessages(messages: AgentMessage[]): Message[] {\n    return messages.map((m: AgentMessage & Record<string, unknown>) => {\n      const c = this.messageContent(m);\n      const content: string | unknown[] =\n        typeof c === 'string' ? c : Array.isArray(c) ? c : this.extractTextContent(c);\n      const row: Message = {\n        role: m.role as Message['role'],\n        content,\n        timestamp: m.timestamp ? new Date(m.timestamp as string | number).toISOString() : undefined,\n        tool_call_id: (m.tool_call_id as string | undefined) || (m.toolCallId as string | undefined),\n        tool_calls: m.tool_calls as Message['tool_calls'],\n        name: m.name as string | undefined,\n      };\n      if (Array.isArray(m.attachments) && m.attachments.length > 0) {\n        row.attachments = m.attachments as Message['attachments'];\n      }\n      const rawUsage = m.usage as { input?: number; output?: number; totalTokens?: number; total?: number } | undefined;\n      if (rawUsage && typeof rawUsage === 'object') {\n        const inputTokens = typeof rawUsage.input === 'number' ? rawUsage.input : undefined;\n        const outputTokens = typeof rawUsage.output === 'number' ? rawUsage.output : undefined;\n        const totalTokens = typeof rawUsage.totalTokens === 'number'\n          ? rawUsage.totalTokens\n          : typeof rawUsage.total === 'number'\n            ? rawUsage.total\n            : undefined;\n        if (inputTokens !== undefined || outputTokens !== undefined || totalTokens !== undefined) {\n          row.usage = { inputTokens, outputTokens, totalTokens };\n        }\n      }\n      return row;\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"store.js","names":[],"sources":["../../../src/session/store.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../config/schema.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport { readPostCompactionContext } from '../agent/reply/post-compaction-context.js';\nimport { createLogger } from '../utils/logger.js';\nimport { SessionCompactor, type CompactionConfig, type CompactionResult } from '../agent/memory/compaction.js';\nimport { SlidingWindow, type WindowConfig } from '../agent/memory/window.js';\nimport {\n  requireXopcDatabase,\n  appendTranscriptEntry,\n  captureCompactionCheckpoint,\n  deleteSessionRecord,\n  ensureSessionRecord,\n  estimateTokensFromMessages,\n  getCompactionCheckpointDetail,\n  getGlobalSessionStats,\n  getSessionMetadata,\n  listCompactionCheckpoints,\n  listSessionMetadata,\n  listSessionsByAgent,\n  loadCheckpointRows,\n  loadLlmMessagesForSession,\n  loadTranscriptRowsForSession,\n  patchSessionMetadata,\n  replaceTranscriptRows,\n  resetSessionRecord,\n  restoreCompactionCheckpoint,\n} from '../storage/sqlite/index.js';\nimport type { TranscriptCompactionRecord, XopcSessionTranscriptV1 } from './transcript-format.js';\nimport {\n  buildSessionContextForLlm,\n  mergeLlmMessagesPreservingContextRows,\n  type TranscriptStoredRow,\n  type XopcTranscriptContextEntry,\n} from './session-context-for-llm.js';\nimport { normalizeCompactionCheckpointId } from './compaction-checkpoints.js';\nimport type {\n  SessionMetadata,\n  SessionDetail,\n  SessionListQuery,\n  PaginatedResult,\n  GlobalSessionStats,\n  ExportFormat,\n  SessionExport,\n  SessionTranscriptSummary,\n  CompactionCheckpointSummary,\n  CompactionCheckpointDetail,\n} from './types.js';\nimport { SessionStatus } from './types.js';\nimport type { Message } from './types.js';\nimport type { SessionTranscriptUpdate } from './transcript-events.js';\nimport { isAppendOnlyLlmTranscriptMessage } from './transcript-stats.js';\n\nconst log = createLogger('SessionStore');\n\nconst INDEX_VERSION = '1.0';\n\nexport interface SessionStoreOptions {\n  config: Config;\n}\n\nexport class SessionStore {\n  private window: SlidingWindow;\n  private compactor: SessionCompactor;\n\n  constructor(\n    private options: SessionStoreOptions,\n    windowConfig?: Partial<WindowConfig>,\n    compactionConfig?: Partial<CompactionConfig>,\n  ) {\n    this.window = new SlidingWindow(windowConfig);\n    this.compactor = new SessionCompactor(compactionConfig);\n  }\n\n  private resolveWorkspaceCwd(sessionKey: string): string {\n    return resolveEffectiveAgentProfileForSession(this.options.config, sessionKey).resolvedWorkspacePath;\n  }\n\n  private async runStoreMutation<T>(fn: () => Promise<T>): Promise<T> {\n    return fn();\n  }\n\n  async initialize(): Promise<void> {\n    requireXopcDatabase();\n    log.debug('Session store initialized (SQLite)');\n  }\n\n  getSessionsRoot(): string {\n    return resolveStateDir();\n  }\n\n  async resolveTranscriptPath(\n    sessionKey: string,\n  ): Promise<{ sessionId: string; sessionKey: string }> {\n    requireXopcDatabase();\n    const cwd = this.resolveWorkspaceCwd(sessionKey);\n    const meta = ensureSessionRecord(sessionKey, cwd);\n    return { sessionId: meta.transcriptId!, sessionKey };\n  }\n\n  async appendTranscriptMessage(sessionKey: string, message: AgentMessage): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(sessionKey);\n      ensureSessionRecord(sessionKey, cwd);\n      appendTranscriptEntry(sessionKey, message);\n    });\n  }\n\n  async getByAgent(agentId: string): Promise<SessionMetadata[]> {\n    requireXopcDatabase();\n    return listSessionsByAgent(agentId);\n  }\n\n  async getByAccount(accountId: string): Promise<SessionMetadata[]> {\n    const { items } = await this.list({ limit: 100_000 });\n    return items.filter((m) => m.routing?.accountId === accountId);\n  }\n\n  async getByPeer(peerKind: string, peerId: string): Promise<SessionMetadata[]> {\n    const { items } = await this.list({ limit: 100_000 });\n    return items.filter((m) => m.routing?.peerKind === peerKind && m.routing.peerId === peerId);\n  }\n\n  async getMainSession(channel: string, accountId: string): Promise<SessionMetadata | null> {\n    const { items } = await this.list({ limit: 100_000 });\n    return (\n      items.find(\n        (m) =>\n          m.routing?.source === channel &&\n          m.routing.accountId === accountId &&\n          m.routing.peerKind === 'dm' &&\n          m.routing.peerId === 'main',\n      ) ?? null\n    );\n  }\n\n  async refreshIndex(): Promise<void> {\n    /* no-op: SQLite is authoritative */\n  }\n\n  async list(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    requireXopcDatabase();\n    return listSessionMetadata(query);\n  }\n\n  async get(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return null;\n    }\n    const messages = await this.loadDisplayMessages(key);\n    return this.buildSessionDetail(key, metadata, messages, options);\n  }\n\n  async getMessagePage(\n    key: string,\n    options: {\n      offset?: number;\n      limit?: number;\n      before?: string;\n      includeTranscriptSummary?: boolean;\n      includeTranscriptRows?: boolean;\n    } = {},\n  ): Promise<{\n    session: SessionDetail;\n    pagination: {\n      total: number;\n      limit: number;\n      offset: number;\n      hasMore: boolean;\n      before?: string;\n      nextBeforeCursor?: string;\n    };\n  } | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return null;\n    }\n\n    const limit = Math.min(200, Math.max(1, Math.trunc(options.limit ?? 50)));\n    const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n    const parsedBefore = options.before ? Number.parseInt(options.before, 10) : undefined;\n    const hasBeforeCursor = parsedBefore !== undefined && Number.isFinite(parsedBefore);\n\n    const displayMessages = await this.loadDisplayMessages(key);\n    const page = this.paginateDisplayMessages(displayMessages, {\n      limit,\n      offset: hasBeforeCursor ? undefined : offset,\n      beforeEndIndex: hasBeforeCursor ? parsedBefore : undefined,\n    });\n\n    const session = await this.buildSessionDetail(key, metadata, page.messages, options);\n    const nextBeforeCursor = page.startIndex > 0 ? String(page.startIndex) : undefined;\n\n    return {\n      session,\n      pagination: {\n        total: page.total,\n        limit,\n        offset,\n        hasMore: hasBeforeCursor ? page.startIndex > 0 : offset + limit < page.total,\n        ...(hasBeforeCursor ? { before: String(page.endIndex) } : {}),\n        ...(nextBeforeCursor ? { nextBeforeCursor } : {}),\n      },\n    };\n  }\n\n  private async buildSessionDetail(\n    key: string,\n    metadata: SessionMetadata,\n    messages: AgentMessage[],\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail> {\n    let transcriptSummary: SessionTranscriptSummary | undefined;\n    if (options?.includeTranscriptSummary) {\n      const env = await this.loadTranscriptDocument(key);\n      if (env) {\n        transcriptSummary = {\n          id: env.id,\n          version: env.version,\n          createdAt: env.createdAt,\n          updatedAt: env.updatedAt,\n          compactionCount: env.compactions?.length ?? 0,\n        };\n      }\n    }\n    let transcriptRows: TranscriptStoredRow[] | undefined;\n    if (options?.includeTranscriptRows) {\n      transcriptRows = await this.loadTranscriptRows(key);\n    }\n    return {\n      ...metadata,\n      messages: this.convertMessages(messages),\n      ...(transcriptSummary ? { transcriptSummary } : {}),\n      ...(transcriptRows !== undefined ? { transcriptRows } : {}),\n    };\n  }\n\n  async loadTranscriptRows(key: string): Promise<TranscriptStoredRow[]> {\n    requireXopcDatabase();\n    return loadTranscriptRowsForSession(key);\n  }\n\n  async getMetadata(key: string): Promise<SessionMetadata | null> {\n    requireXopcDatabase();\n    return getSessionMetadata(key);\n  }\n\n  async updateMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      patchSessionMetadata(key, updates);\n      log.debug({ key, updates }, 'Session metadata updated');\n    });\n  }\n\n  async reset(key: string): Promise<{ sessionId: string; previousSessionId: string } | null> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      const outcome = resetSessionRecord(key, cwd);\n      if (outcome) {\n        log.info({ key, ...outcome }, 'Session reset');\n      }\n      return outcome;\n    });\n  }\n\n  async delete(key: string): Promise<boolean> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const ok = deleteSessionRecord(key);\n      if (ok) {\n        log.info({ key }, 'Session deleted');\n      }\n      return ok;\n    });\n  }\n\n  async deleteMany(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    const success: string[] = [];\n    const failed: string[] = [];\n    for (const key of keys) {\n      try {\n        if (await this.delete(key)) {\n          success.push(key);\n        } else {\n          failed.push(key);\n        }\n      } catch {\n        failed.push(key);\n      }\n    }\n    return { success, failed };\n  }\n\n  async setStatus(key: string, status: SessionStatus): Promise<void> {\n    await this.updateMetadata(key, { status });\n  }\n\n  async archive(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ARCHIVED);\n  }\n\n  async unarchive(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ACTIVE);\n  }\n\n  async pin(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.PINNED);\n  }\n\n  async unpin(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ACTIVE);\n  }\n\n  async loadMessages(_key: string, _options?: { fromArchive?: boolean }): Promise<AgentMessage[]> {\n    requireXopcDatabase();\n    return loadLlmMessagesForSession(_key);\n  }\n\n  async loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata?.transcriptId) {\n      return null;\n    }\n    const rows = await this.loadTranscriptRows(key);\n    const compactions: TranscriptCompactionRecord[] = [];\n    for (const row of rows) {\n      if ((row as { type?: string }).type === 'compaction') {\n        const c = row as unknown as TranscriptCompactionRecord & { type: 'compaction' };\n        compactions.push({\n          at: c.at ?? new Date().toISOString(),\n          summary: c.summary ?? '',\n          firstKeptIndex: Number(c.firstKeptIndex ?? 0),\n          tokensBefore: c.tokensBefore ?? 0,\n          tokensAfter: (c as { tokensAfter?: number }).tokensAfter ?? 0,\n        });\n      }\n    }\n    return {\n      type: 'xopc_session_transcript',\n      version: 1,\n      id: metadata.transcriptId,\n      createdAt: metadata.createdAt,\n      updatedAt: metadata.updatedAt,\n      messages: rows,\n      ...(compactions.length > 0 ? { compactions } : {}),\n    };\n  }\n\n  async syncEmbeddedTranscriptUpdate(update: SessionTranscriptUpdate): Promise<void> {\n    const sessionKey = update.sessionKey?.trim();\n    if (!sessionKey) {\n      return;\n    }\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(sessionKey);\n      ensureSessionRecord(sessionKey, cwd);\n\n      if (update.message && isAppendOnlyLlmTranscriptMessage(update.message)) {\n        appendTranscriptEntry(sessionKey, update.message as AgentMessage);\n      }\n    });\n  }\n\n  async appendTranscriptContextEntry(\n    key: string,\n    entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>,\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const row: XopcTranscriptContextEntry = {\n        kind: 'context',\n        id: typeof entry.id === 'string' ? entry.id : undefined,\n        text: typeof entry.text === 'string' ? entry.text : undefined,\n        data: entry.data,\n        createdAt: entry.createdAt ?? new Date().toISOString(),\n      };\n      appendTranscriptEntry(key, row);\n    });\n  }\n\n  async saveMessages(key: string, messages: AgentMessage[]): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const prev = await this.loadTranscriptRows(key);\n      const merged = mergeLlmMessagesPreservingContextRows(prev, messages);\n      replaceTranscriptRows(key, merged);\n    });\n  }\n\n  getWindowStats(messages: AgentMessage[]) {\n    return this.window.getStats(messages);\n  }\n\n  needsCompaction(key: string, messages: AgentMessage[], contextWindow: number) {\n    return this.compactor.needsCompaction(messages, contextWindow);\n  }\n\n  prepareCompaction(key: string, messages: AgentMessage[], contextWindow: number) {\n    const result = this.compactor.needsCompaction(messages, contextWindow);\n    return { needsCompaction: result.needed, messages, stats: result };\n  }\n\n  async applyCompaction(\n    key: string,\n    messages: AgentMessage[],\n    result: CompactionResult,\n  ): Promise<AgentMessage[]> {\n    const compacted = this.compactor.applyCompaction(messages, result);\n    return this.runStoreMutation(async () => {\n      const prev = await this.loadTranscriptRows(key);\n      const merged = mergeLlmMessagesPreservingContextRows(prev, compacted);\n      captureCompactionCheckpoint(key);\n      replaceTranscriptRows(key, merged, {\n        appendCompaction: {\n          at: new Date().toISOString(),\n          summary: result.summary,\n          firstKeptIndex: result.firstKeptIndex,\n          tokensBefore: result.tokensBefore,\n          tokensAfter: result.tokensAfter,\n        },\n      });\n      const metadata = await this.getMetadata(key);\n      if (metadata) {\n        await this.updateMetadata(key, { compactedCount: metadata.compactedCount + 1 });\n      }\n      log.info(\n        { key, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter, keptMessages: compacted.length },\n        'Session compacted',\n      );\n      await this.injectPostCompactionContext(key);\n      return compacted;\n    });\n  }\n\n  async compact(\n    key: string,\n    messages: AgentMessage[],\n    contextWindow: number,\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    void contextWindow;\n    const result = await this.compactor.compact(messages, instructions, force);\n    if (result.compacted) {\n      await this.applyCompaction(key, messages, result);\n    }\n    return result;\n  }\n\n  async getCompactionStats(key: string) {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return undefined;\n    }\n    return {\n      compactionCount: metadata.compactedCount,\n      totalTokensBefore: 0,\n      totalTokensAfter: 0,\n      lastCompactionAt: undefined,\n    };\n  }\n\n  async listCompactionCheckpoints(key: string): Promise<CompactionCheckpointSummary[]> {\n    requireXopcDatabase();\n    return listCompactionCheckpoints(key);\n  }\n\n  async getCompactionCheckpointDetail(\n    key: string,\n    checkpointId: string,\n  ): Promise<CompactionCheckpointDetail | null> {\n    requireXopcDatabase();\n    const id = normalizeCompactionCheckpointId(checkpointId);\n    if (!id) {\n      return null;\n    }\n    return getCompactionCheckpointDetail(key, id);\n  }\n\n  async restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const id = normalizeCompactionCheckpointId(checkpointId);\n      if (!id) {\n        throw new Error(`Invalid checkpoint id: ${checkpointId}`);\n      }\n      restoreCompactionCheckpoint(key, id);\n    });\n  }\n\n  async deleteSession(key: string): Promise<boolean> {\n    return this.delete(key);\n  }\n\n  async load(key: string, options?: { fromArchive?: boolean }): Promise<AgentMessage[]> {\n    return this.loadMessages(key, options);\n  }\n\n  async estimateTokenUsage(_key: string, messages: AgentMessage[]): Promise<number> {\n    return this.estimateTokens(messages);\n  }\n\n  async searchInSession(key: string, keyword: string): Promise<Message[]> {\n    const messages = await this.loadDisplayMessages(key);\n    const q = keyword.toLowerCase();\n    return this.convertMessages(\n      messages.filter((m) => this.extractTextContent(this.messageContent(m)).toLowerCase().includes(q)),\n    );\n  }\n\n  async exportSession(key: string, format: ExportFormat): Promise<string> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      throw new Error(`Session not found: ${key}`);\n    }\n    const rows = await this.loadTranscriptRows(key);\n    const messages = this.convertMessages(buildSessionContextForLlm(rows));\n    const payload: SessionExport = {\n      version: INDEX_VERSION,\n      exportedAt: new Date().toISOString(),\n      metadata,\n      messages,\n      transcriptRows: rows,\n    };\n    if (format === 'json') {\n      return JSON.stringify(payload, null, 2);\n    }\n    const lines = [`# ${metadata.name ?? metadata.key}`, '', `Exported: ${payload.exportedAt}`, ''];\n    for (const msg of messages) {\n      lines.push(`## ${msg.role}`, '', typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content), '');\n    }\n    return lines.join('\\n');\n  }\n\n  async getStats(): Promise<GlobalSessionStats> {\n    requireXopcDatabase();\n    return getGlobalSessionStats();\n  }\n\n  async archiveOld(olderThanDays: number): Promise<number> {\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - olderThanDays);\n    const list = await this.list({ limit: 100_000 });\n    let archived = 0;\n    for (const session of list.items) {\n      if (session.status !== SessionStatus.ARCHIVED && session.status !== SessionStatus.PINNED) {\n        const lastAccess = new Date(session.lastAccessedAt);\n        if (lastAccess < cutoff) {\n          await this.archive(session.key);\n          archived++;\n        }\n      }\n    }\n    return archived;\n  }\n\n  estimateTokens(messages: AgentMessage[]): number {\n    return estimateTokensFromMessages(messages);\n  }\n\n  private async loadDisplayMessages(key: string): Promise<AgentMessage[]> {\n    requireXopcDatabase();\n    const checkpoints = listCompactionCheckpoints(key);\n    const rowSets: TranscriptStoredRow[][] = [];\n    for (const checkpoint of [...checkpoints].reverse()) {\n      rowSets.push(loadCheckpointRows(key, checkpoint.id));\n    }\n    rowSets.push(await this.loadTranscriptRows(key));\n\n    const messages: AgentMessage[] = [];\n    const seen = new Set<string>();\n    for (const rows of rowSets) {\n      for (const message of buildSessionContextForLlm(rows)) {\n        if (this.isCompactionSummaryMessage(message)) {\n          continue;\n        }\n        const identity = this.displayMessageIdentity(message);\n        if (seen.has(identity)) {\n          continue;\n        }\n        seen.add(identity);\n        messages.push(message);\n      }\n    }\n    return messages;\n  }\n\n  private paginateDisplayMessages(\n    messages: AgentMessage[],\n    options: {\n      offset?: number;\n      limit?: number;\n      beforeEndIndex?: number;\n    } = {},\n  ): { messages: AgentMessage[]; total: number; startIndex: number; endIndex: number } {\n    const total = messages.length;\n    const limit = Math.min(200, Math.max(1, Math.trunc(options.limit ?? 50)));\n    const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n\n    let startIndex: number;\n    let endIndex: number;\n    if (options.beforeEndIndex !== undefined && Number.isFinite(options.beforeEndIndex)) {\n      endIndex = Math.min(total, Math.max(0, Math.trunc(options.beforeEndIndex)));\n      startIndex = Math.max(0, endIndex - limit);\n    } else {\n      endIndex = Math.max(0, total - offset);\n      startIndex = Math.max(0, endIndex - limit);\n    }\n\n    return {\n      messages: messages.slice(startIndex, endIndex),\n      total,\n      startIndex,\n      endIndex,\n    };\n  }\n\n  private displayMessageIdentity(message: AgentMessage): string {\n    const record = message as unknown as Record<string, unknown>;\n    return JSON.stringify({\n      role: message.role,\n      timestamp: record.timestamp,\n      toolCallId: record.toolCallId ?? record.tool_call_id,\n      toolName: record.toolName,\n      content: this.messageContent(message),\n    });\n  }\n\n  private messageContent(msg: AgentMessage): unknown {\n    return (msg as { content?: unknown }).content;\n  }\n\n  private isCompactionSummaryMessage(msg: AgentMessage): boolean {\n    if (msg.role !== 'user') {\n      return false;\n    }\n    const text = this.extractTextContent(this.messageContent(msg)).trim();\n    return /^\\[Previous conversation summary\\]/i.test(text);\n  }\n\n  private extractTextContent(content: unknown): string {\n    if (typeof content === 'string') {\n      return content;\n    }\n    if (Array.isArray(content)) {\n      const parts: string[] = [];\n      for (const item of content) {\n        if (typeof item !== 'object' || item === null || !('type' in item)) {\n          continue;\n        }\n        const c = item as { type?: string; text?: string; name?: string };\n        if (c.type === 'text' && typeof c.text === 'string') {\n          parts.push(c.text);\n        } else if (c.type === 'toolCall' || c.type === 'tool_use') {\n          parts.push(c.name ? `[${c.name}]` : '');\n        }\n      }\n      return parts.join('');\n    }\n    return '';\n  }\n\n  private async injectPostCompactionContext(key: string): Promise<void> {\n    const contextText = readPostCompactionContext({\n      cfg: this.options.config,\n      sessionKey: key,\n    });\n    if (!contextText?.trim()) {\n      return;\n    }\n    try {\n      await this.appendTranscriptContextEntry(key, {\n        id: `post-compaction-${Date.now()}`,\n        text: contextText,\n        createdAt: new Date().toISOString(),\n      });\n    } catch (err) {\n      log.warn({ err, key }, 'Post-compaction context injection failed');\n    }\n  }\n\n  private convertMessages(messages: AgentMessage[]): Message[] {\n    return messages.map((m: AgentMessage & Record<string, unknown>) => {\n      const c = this.messageContent(m);\n      const content: string | unknown[] =\n        typeof c === 'string' ? c : Array.isArray(c) ? c : this.extractTextContent(c);\n      const row: Message = {\n        role: m.role as Message['role'],\n        content,\n        timestamp: m.timestamp ? new Date(m.timestamp as string | number).toISOString() : undefined,\n        tool_call_id: (m.tool_call_id as string | undefined) || (m.toolCallId as string | undefined),\n        tool_calls: m.tool_calls as Message['tool_calls'],\n        name: m.name as string | undefined,\n      };\n      if (Array.isArray(m.media) && m.media.length > 0) {\n        row.media = m.media as Message['media'];\n      }\n      const rawUsage = m.usage as { input?: number; output?: number; totalTokens?: number; total?: number } | undefined;\n      if (rawUsage && typeof rawUsage === 'object') {\n        const inputTokens = typeof rawUsage.input === 'number' ? rawUsage.input : undefined;\n        const outputTokens = typeof rawUsage.output === 'number' ? rawUsage.output : undefined;\n        const totalTokens = typeof rawUsage.totalTokens === 'number'\n          ? rawUsage.totalTokens\n          : typeof rawUsage.total === 'number'\n            ? rawUsage.total\n            : undefined;\n        if (inputTokens !== undefined || outputTokens !== undefined || totalTokens !== undefined) {\n          row.usage = { inputTokens, outputTokens, totalTokens };\n        }\n      }\n      return row;\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/src/session/types.d.ts

@@ -23,13 +23,16 @@ export interface Message {
         outputTokens?: number;
         totalTokens?: number;
     };
-    /** Webchat early-save / UI: inbound file metadata (no base64). Omitted when absent. */
-    attachments?: Array<{
-        type?: string;
-        mimeType?: string;
-        name?: string;
-        size?: number;
-        workspaceRelativePath?: string;
+    /** Inbound attachment metadata (no base64). */
+    media?: Array<{
+        id: string;
+        bucket: string;
+        type: string;
+        mimeType: string;
+        name: string;
+        size: number;
+        uri: string;
+        path: string;
     }>;
 }
 /** Session status enum */
@@ -82,6 +85,8 @@ export interface SessionMetadata {
     messageCount: number;
     estimatedTokens: number;
     compactedCount: number;
+    lastFlushedAt?: string;
+    flushCount?: number;
     sourceChannel: string;
     sourceChatId: string;
     customData?: Record<string, unknown>;