@xopcai/xopc 0.0.99 → 0.0.101

package/dist/src/media/paths.js

@@ -0,0 +1,20 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { join, resolve } from "node:path";
+//#region src/media/paths.ts
+init_paths_state();
+/** Global media store root: `{stateDir}/media/`. */
+function getMediaDir() {
+	return join(resolveStateDir(), "media");
+}
+function getMediaBucketDir(bucket) {
+	return join(getMediaDir(), bucket);
+}
+function isPathInside(root, candidate) {
+	const rootResolved = resolve(root);
+	const candidateResolved = resolve(candidate);
+	return candidateResolved === rootResolved || candidateResolved.startsWith(rootResolved + "/");
+}
+//#endregion
+export { getMediaBucketDir, getMediaDir, isPathInside };
+
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","names":[],"sources":["../../../src/media/paths.ts"],"sourcesContent":["import { join, resolve } from 'node:path';\n\nimport { resolveStateDir } from '../config/paths-state.js';\n\nimport type { MediaBucket } from './types.js';\n\n/** Global media store root: `{stateDir}/media/`. */\nexport function getMediaDir(): string {\n  return join(resolveStateDir(), 'media');\n}\n\nexport function getMediaBucketDir(bucket: MediaBucket): string {\n  return join(getMediaDir(), bucket);\n}\n\nexport function isPathInside(root: string, candidate: string): boolean {\n  const rootResolved = resolve(root);\n  const candidateResolved = resolve(candidate);\n  return (\n    candidateResolved === rootResolved ||\n    candidateResolved.startsWith(rootResolved + '/')\n  );\n}\n"],"mappings":";;;kBAE2D;;AAK3D,SAAgB,cAAsB;AACpC,QAAO,KAAK,iBAAiB,EAAE,QAAQ;;AAGzC,SAAgB,kBAAkB,QAA6B;AAC7D,QAAO,KAAK,aAAa,EAAE,OAAO;;AAGpC,SAAgB,aAAa,MAAc,WAA4B;CACrE,MAAM,eAAe,QAAQ,KAAK;CAClC,MAAM,oBAAoB,QAAQ,UAAU;AAC5C,QACE,sBAAsB,gBACtB,kBAAkB,WAAW,eAAe,IAAI"}

package/dist/src/media/session-references.d.ts

@@ -0,0 +1,8 @@
+import type { AgentMessage } from '@earendil-works/pi-agent-core';
+export declare function collectMediaUrisFromMessages(messages: readonly AgentMessage[]): Set<string>;
+export declare function messagesReferenceMediaUri(messages: readonly AgentMessage[], uri: string): boolean;
+export declare function deleteMediaUris(uris: Iterable<string>): Promise<void>;
+export declare function deleteMediaUrisNoLongerReferenced(params: {
+    removed: readonly AgentMessage[];
+    remaining: readonly AgentMessage[];
+}): Promise<void>;

package/dist/src/media/session-references.js

@@ -0,0 +1,45 @@
+import { tryParseMediaUri } from "./uri.js";
+import { deleteMediaBuffer } from "./store.js";
+//#region src/media/session-references.ts
+function collectFromValue(value, out) {
+	if (!value) return;
+	if (typeof value === "string") {
+		if (value.startsWith("media://")) out.add(value.trim());
+		return;
+	}
+	if (Array.isArray(value)) {
+		for (const item of value) collectFromValue(item, out);
+		return;
+	}
+	if (typeof value !== "object") return;
+	const record = value;
+	if (typeof record.uri === "string" && record.uri.startsWith("media://")) out.add(record.uri.trim());
+	if (Array.isArray(record.media)) collectFromValue(record.media, out);
+	if (Array.isArray(record.attachments)) collectFromValue(record.attachments, out);
+}
+function collectMediaUrisFromMessages(messages) {
+	const out = /* @__PURE__ */ new Set();
+	for (const message of messages) collectFromValue(message, out);
+	return out;
+}
+function messagesReferenceMediaUri(messages, uri) {
+	return collectMediaUrisFromMessages(messages).has(uri.trim());
+}
+async function deleteMediaUris(uris) {
+	for (const uri of new Set(uris)) {
+		const parsed = tryParseMediaUri(uri);
+		if (!parsed) continue;
+		await deleteMediaBuffer(parsed.id, parsed.bucket).catch(() => {});
+	}
+}
+async function deleteMediaUrisNoLongerReferenced(params) {
+	const removedUris = collectMediaUrisFromMessages(params.removed);
+	if (removedUris.size === 0) return;
+	const remainingUris = collectMediaUrisFromMessages(params.remaining);
+	for (const uri of remainingUris) removedUris.delete(uri);
+	await deleteMediaUris(removedUris);
+}
+//#endregion
+export { collectMediaUrisFromMessages, deleteMediaUris, deleteMediaUrisNoLongerReferenced, messagesReferenceMediaUri };
+
+//# sourceMappingURL=session-references.js.map

package/dist/src/media/session-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-references.js","names":[],"sources":["../../../src/media/session-references.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport { deleteMediaBuffer } from './store.js';\nimport { tryParseMediaUri } from './uri.js';\n\nfunction collectFromValue(value: unknown, out: Set<string>): void {\n  if (!value) return;\n  if (typeof value === 'string') {\n    if (value.startsWith('media://')) out.add(value.trim());\n    return;\n  }\n  if (Array.isArray(value)) {\n    for (const item of value) collectFromValue(item, out);\n    return;\n  }\n  if (typeof value !== 'object') return;\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.uri === 'string' && record.uri.startsWith('media://')) {\n    out.add(record.uri.trim());\n  }\n  if (Array.isArray(record.media)) collectFromValue(record.media, out);\n  if (Array.isArray(record.attachments)) collectFromValue(record.attachments, out);\n}\n\nexport function collectMediaUrisFromMessages(messages: readonly AgentMessage[]): Set<string> {\n  const out = new Set<string>();\n  for (const message of messages) collectFromValue(message, out);\n  return out;\n}\n\nexport function messagesReferenceMediaUri(messages: readonly AgentMessage[], uri: string): boolean {\n  return collectMediaUrisFromMessages(messages).has(uri.trim());\n}\n\nexport async function deleteMediaUris(uris: Iterable<string>): Promise<void> {\n  for (const uri of new Set(uris)) {\n    const parsed = tryParseMediaUri(uri);\n    if (!parsed) continue;\n    await deleteMediaBuffer(parsed.id, parsed.bucket).catch(() => {});\n  }\n}\n\nexport async function deleteMediaUrisNoLongerReferenced(params: {\n  removed: readonly AgentMessage[];\n  remaining: readonly AgentMessage[];\n}): Promise<void> {\n  const removedUris = collectMediaUrisFromMessages(params.removed);\n  if (removedUris.size === 0) return;\n\n  const remainingUris = collectMediaUrisFromMessages(params.remaining);\n  for (const uri of remainingUris) removedUris.delete(uri);\n  await deleteMediaUris(removedUris);\n}\n"],"mappings":";;;AAKA,SAAS,iBAAiB,OAAgB,KAAwB;AAChE,KAAI,CAAC,MAAO;AACZ,KAAI,OAAO,UAAU,UAAU;AAC7B,MAAI,MAAM,WAAW,WAAW,CAAE,KAAI,IAAI,MAAM,MAAM,CAAC;AACvD;;AAEF,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,OAAK,MAAM,QAAQ,MAAO,kBAAiB,MAAM,IAAI;AACrD;;AAEF,KAAI,OAAO,UAAU,SAAU;CAE/B,MAAM,SAAS;AACf,KAAI,OAAO,OAAO,QAAQ,YAAY,OAAO,IAAI,WAAW,WAAW,CACrE,KAAI,IAAI,OAAO,IAAI,MAAM,CAAC;AAE5B,KAAI,MAAM,QAAQ,OAAO,MAAM,CAAE,kBAAiB,OAAO,OAAO,IAAI;AACpE,KAAI,MAAM,QAAQ,OAAO,YAAY,CAAE,kBAAiB,OAAO,aAAa,IAAI;;AAGlF,SAAgB,6BAA6B,UAAgD;CAC3F,MAAM,sBAAM,IAAI,KAAa;AAC7B,MAAK,MAAM,WAAW,SAAU,kBAAiB,SAAS,IAAI;AAC9D,QAAO;;AAGT,SAAgB,0BAA0B,UAAmC,KAAsB;AACjG,QAAO,6BAA6B,SAAS,CAAC,IAAI,IAAI,MAAM,CAAC;;AAG/D,eAAsB,gBAAgB,MAAuC;AAC3E,MAAK,MAAM,OAAO,IAAI,IAAI,KAAK,EAAE;EAC/B,MAAM,SAAS,iBAAiB,IAAI;AACpC,MAAI,CAAC,OAAQ;AACb,QAAM,kBAAkB,OAAO,IAAI,OAAO,OAAO,CAAC,YAAY,GAAG;;;AAIrE,eAAsB,kCAAkC,QAGtC;CAChB,MAAM,cAAc,6BAA6B,OAAO,QAAQ;AAChE,KAAI,YAAY,SAAS,EAAG;CAE5B,MAAM,gBAAgB,6BAA6B,OAAO,UAAU;AACpE,MAAK,MAAM,OAAO,cAAe,aAAY,OAAO,IAAI;AACxD,OAAM,gBAAgB,YAAY"}

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

@@ -0,0 +1,19 @@
+import type { MediaBucket, SavedMedia } from './types.js';
+/** Default per-file cap for inbound staging (5 MiB). */
+export declare const MEDIA_MAX_BYTES: number;
+export declare function ensureMediaDir(): Promise<string>;
+export declare function saveMediaBuffer(buffer: Buffer, opts?: {
+    contentType?: string;
+    bucket?: MediaBucket;
+    maxBytes?: number;
+    originalFilename?: string;
+}): Promise<SavedMedia>;
+export declare function resolveMediaBufferPath(id: string, bucket?: MediaBucket): string;
+export declare function readMediaBuffer(id: string, bucket?: MediaBucket, maxBytes?: number): Promise<{
+    id: string;
+    path: string;
+    buffer: Buffer;
+    size: number;
+}>;
+export declare function deleteMediaBuffer(id: string, bucket?: MediaBucket): Promise<void>;
+export declare function mimeTypeFromMediaPath(filePath: string): string;

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;