@walkhi/code-relax 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/src/server.mjs

@@ -5,7 +5,8 @@ import net from 'node:net';
 import path from 'node:path';
 import os from 'node:os';
 import { fileURLToPath } from 'node:url';
-import vm from 'node:vm';
+import vm from 'node:vm';
+import sharp from 'sharp';
 import { attachLanSocket } from './lan-socket-server.mjs';
 import { validateInlineImage, persistLegacyImage } from './message-images.mjs';
 import { ThreadWriterConflictError } from './shared-app-server.mjs';
@@ -33,7 +34,9 @@ const MAX_ATTACHMENT_BYTES = 16 * 1024 * 1024;
 const MAX_CACHED_ATTACHMENTS = 32;
 const MAX_CACHED_FILES = 64;
 const MAX_CONTEXT_TAIL_BYTES = 4 * 1024 * 1024;
-const MAX_LIVE_ACTIVITY_TAIL_BYTES = 1024 * 1024;
+const MAX_LIVE_ACTIVITY_TAIL_BYTES = 1024 * 1024;
+const SHARED_HISTORY_PAGE_BYTES = 500 * 1024;
+const SHARED_HISTORY_PAGE_TURNS = 8;
 const MAX_SETTINGS_SCAN_BYTES = 64 * 1024 * 1024;
 const ALLOWED_MODELS = new Set([
   'gpt-6-astra',
@@ -49,7 +52,6 @@ const ALLOWED_TOOLS = new Set([
   'get_usage_limits',
   'list_projects',
   'list_threads',
-  'navigate_to_codex_page',
   'read_thread',
   'send_message_to_thread',
   'wait_threads',
@@ -68,9 +70,11 @@ const markdownSandbox = { atob };
 vm.runInNewContext(markdownItScript.toString(), markdownSandbox);
 const imageMarkdown = markdownSandbox.markdownit({ html: false });
 let nextRequestId = 0;
-const attachmentCache = new Map();
-const fileCache = new Map();
-const fileCapabilitySecret = crypto.randomBytes(32);
+const attachmentCache = new Map();
+const fileCache = new Map();
+const fileCapabilitySecret = crypto.randomBytes(32);
+const imageCapabilityKey = crypto.createHash('sha256')
+  .update('code-relax-image-capability\0').update(options.token || fileCapabilitySecret).digest();
 const legacyUploadsRoot = path.resolve(webRoot, '..', 'uploads');
 const allowedUploadsRoots = [uploadsRoot, legacyUploadsRoot,
   ...JSON.parse(process.env.CODEX_REMOTE_LEGACY_UPLOADS_ROOTS || '[]')];
@@ -88,7 +92,7 @@ function selectSharedExecution(enabled) {
   const next = enabled ? managedAppServer.client : null;
   if (sharedServer === next) return;
   sharedServer = next;
-  sharedCatalog = sharedServer ? new SharedCatalog(sharedServer, desktopMonitor) : null;
+  sharedCatalog = sharedServer ? new SharedCatalog(sharedServer) : null;
 }
 const executionHealth = new ExecutionHealth(async () => {
   await managedAppServer.ensure();
@@ -225,11 +229,23 @@ async function handleRequest(request, response) {
     }
 
 
-    const imageMatch = /^\/api\/images\/([a-f0-9]{64})$/.exec(url.pathname);
-    if (request.method === 'GET' && imageMatch) {
-      const image = attachmentCache.get(imageMatch[1]);
-      if (!image) throw new RequestError(404, '图片缓存已失效，请重新读取对话。');
-      sendJson(response, 200, { url: `data:${image.mimeType};base64,${image.buffer.toString('base64')}` });
+    const imageMatch = /^\/api\/images\/([a-f0-9]{64})$/.exec(url.pathname);
+    if (request.method === 'GET' && imageMatch) {
+      let image = attachmentCache.get(imageMatch[1])
+        || recoverLocalImage(imageMatch[1], url.searchParams.get('recovery') || '');
+      const contextThreadId = url.searchParams.get('threadId') || '';
+      const contextTurnId = url.searchParams.get('turnId') || '';
+      if (!image && sharedServer && contextThreadId && contextTurnId
+        && contextThreadId.length <= 128 && contextTurnId.length <= 128) {
+        try {
+          normalizeTurn(await sharedServer.turnContext(contextThreadId, contextTurnId));
+          image = attachmentCache.get(imageMatch[1]);
+        } catch {}
+      }
+      if (!image) throw new RequestError(404, '这张图片已失效，无法从工作站重新读取。');
+      const thumbnail = url.searchParams.get('variant') === 'thumbnail';
+      const asset = thumbnail ? await attachmentThumbnail(image) : { buffer: image.buffer, mimeType: image.mimeType };
+      sendJson(response, 200, { url: `data:${asset.mimeType};base64,${asset.buffer.toString('base64')}` });
       return;
     }
 
@@ -272,13 +288,14 @@ async function handleRequest(request, response) {
           projects: catalogProjects };
       }
       let appServerThreads = archived ? [] : appServerTasks.store.list().map(record => ({
-        id: record.id,
-        kind: 'codex',
-        hostId: 'app-server',
-        title: record.title,
-        cwd: record.cwd,
-        projectId: record.projectId,
-        updatedAt: record.updatedAt,
+        id: record.id,
+        kind: 'codex',
+        hostId: 'app-server',
+        title: record.title,
+        cwd: record.cwd,
+        projectId: record.projectId,
+        updatedAt: record.updatedAt,
+        recencyAt: record.recencyAt ?? record.updatedAt,
         status: 'unknown',
         transport: 'app-server',
       }));
@@ -398,17 +415,20 @@ async function handleRequest(request, response) {
     if (request.method === 'GET' && timelineMatch) {
       const threadId = decodeURIComponent(timelineMatch[1]);
       if (!appServerTasks.owns(threadId) && usesSharedTask({ hostId: url.searchParams.get('hostId') })) {
-        const timeline = normalizeSharedTimeline(await sharedServer.timeline(threadId));
+        const timeline = normalizeSharedTimeline(await sharedServer.timeline(threadId, sharedHistoryPageOptions()));
         const knownUpdatedAt = Number(url.searchParams.get('knownUpdatedAt'));
         const knownTurnId = url.searchParams.get('knownTurnId') || '';
         const knownTurnStatus = url.searchParams.get('knownTurnStatus') || '';
+        const knownHistoryView = url.searchParams.get('knownHistoryView') || '';
         const latest = timeline.turns.at(-1);
         const knownIndex = knownTurnId ? timeline.turns.findIndex(turn => turn.id === knownTurnId) : -1;
-        const unchanged = knownIndex === timeline.turns.length - 1
+        const sameHistoryView = knownHistoryView === timeline.historyView;
+        const unchanged = sameHistoryView
+          && knownIndex === timeline.turns.length - 1
           && timeline.thread.status === 'idle' && latest?.status !== 'inProgress'
           && knownTurnStatus && knownTurnStatus !== 'inProgress'
           && (!Number.isFinite(knownUpdatedAt) || knownUpdatedAt <= 0 || timeline.thread.updatedAt === knownUpdatedAt);
-        const partial = !unchanged && knownIndex >= 0
+        const partial = !unchanged && sameHistoryView && knownIndex >= 0
           ? { ...timeline, turns: timeline.turns.slice(knownIndex), partialFromTurnId: knownTurnId }
           : timeline;
         sendJson(response, 200, unchanged ? { ...timeline, turns: [], notModified: true } : partial);
@@ -474,23 +494,6 @@ async function handleRequest(request, response) {
       return;
     }
 
-    const navigateMatch = /^\/api\/threads\/([^/]+)\/navigate$/.exec(url.pathname);
-    if (request.method === 'POST' && navigateMatch) {
-      const threadId = decodeURIComponent(navigateMatch[1]);
-      if (sharedServer && !desktopMonitor.pipe) {
-        sendJson(response, 200, { opened: false, reason: 'Desktop 工具通道尚未就绪' });
-        return;
-      }
-      if (appServerTasks.owns(threadId)) {
-        sendJson(response, 200, { opened: false, transport: 'app-server' });
-        return;
-      }
-      sendToolResult(response, await callTool('navigate_to_codex_page', {
-        threadId,
-      }, 15_000));
-      return;
-    }
-
     const contextMatch = /^\/api\/threads\/([^/]+)\/context$/.exec(url.pathname);
     if (request.method === 'GET' && contextMatch) {
       const threadId = decodeURIComponent(contextMatch[1]);
@@ -502,11 +505,11 @@ async function handleRequest(request, response) {
     }
 
     const sharedAction = /^\/api\/threads\/([^/]+)\/(history|settings|permissions)$/.exec(url.pathname);
-    if (sharedAction) {
+    if (sharedAction) {
       const id = decodeURIComponent(sharedAction[1]);
       if (!usesSharedTask({ hostId: url.searchParams.get('hostId') }) || appServerTasks.owns(id)) throw new RequestError(400, '此连接不支持该操作。');
       if (request.method === 'GET' && sharedAction[2] === 'history') {
-        sendJson(response, 200, normalizeSharedTimeline(await sharedServer.history(id, url.searchParams.get('cursor'))));
+        sendJson(response, 200, normalizeSharedTimeline(await sharedServer.history(id, url.searchParams.get('cursor'), sharedHistoryPageOptions())));
         return;
       }
       if (request.method === 'POST' && sharedAction[2] === 'settings') {
@@ -520,10 +523,24 @@ async function handleRequest(request, response) {
         const body = await readJsonBody(request);
         sendJson(response, 200, await sharedServer.permissions(id, body.mode));
         return;
-      }
-    }
-
-    const archiveMatch = /^\/api\/threads\/([^/]+)\/(archive|unarchive)$/.exec(url.pathname);
+      }
+    }
+
+    const sharedOperationGroup = /^\/api\/threads\/([^/]+)\/turns\/([^/]+)\/groups\/([^/]+)\/items$/.exec(url.pathname);
+    if (request.method === 'GET' && sharedOperationGroup) {
+      const threadId = decodeURIComponent(sharedOperationGroup[1]);
+      const turnId = decodeURIComponent(sharedOperationGroup[2]);
+      const groupId = decodeURIComponent(sharedOperationGroup[3]);
+      if (!usesSharedTask({ hostId: url.searchParams.get('hostId') }) || appServerTasks.owns(threadId)) {
+        throw new RequestError(400, '此连接不支持操作组分页。');
+      }
+      const page = await sharedServer.operationGroupItems(threadId, turnId, groupId, url.searchParams.get('offset'));
+      sendJson(response, 200, { turnId: page.turnId, groupId: page.groupId,
+        entries: page.items.map(normalizeItem).filter(Boolean), nextOffset: page.nextOffset, total: page.total });
+      return;
+    }
+
+    const archiveMatch = /^\/api\/threads\/([^/]+)\/(archive|unarchive)$/.exec(url.pathname);
     if (request.method === 'POST' && archiveMatch) {
       const threadId = decodeURIComponent(archiveMatch[1]);
       await requireExecutionWritable(threadId);
@@ -1232,17 +1249,17 @@ function appServerProjectTarget(projectId, projects) {
 function mergeThreadCatalog(catalog, appThreads, limit, sharedSnapshot = Boolean(sharedServer)) {
   const owned = new Map(appThreads.map(thread => [thread.id, thread]));
   const pinnedThreads = (catalog.pinnedThreads || []).map(thread => owned.get(thread.id) || thread);
-  const pinnedIds = new Set(pinnedThreads.map(thread => thread.id));
-  if (sharedSnapshot) {
-    const listed = new Set([...pinnedIds, ...(catalog.threads || []).map(thread => thread.id)]);
-    return { ...catalog, pinnedThreads, threads: [
-      ...(catalog.threads || []).map(thread => owned.get(thread.id) || thread),
-      ...appThreads.filter(thread => !listed.has(thread.id)),
-    ].slice(0, limit) };
-  }
+  const pinnedIds = new Set(pinnedThreads.map(thread => thread.id));
+  if (sharedSnapshot) {
+    const listed = new Set([...pinnedIds, ...(catalog.threads || []).map(thread => thread.id)]);
+    const threads = (catalog.threads || []).map(thread => owned.get(thread.id) || thread);
+    threads.push(...appThreads.filter(thread => !listed.has(thread.id)));
+    threads.sort((left, right) => threadRecency(right) - threadRecency(left));
+    return { ...catalog, pinnedThreads: [], threads: threads.slice(0, limit) };
+  }
   const desktopThreads = (catalog.threads || []).filter(thread => !owned.has(thread.id));
   const merged = [...desktopThreads, ...appThreads.filter(thread => !pinnedIds.has(thread.id))]
-    .sort((left, right) => Number(right.updatedAt || 0) - Number(left.updatedAt || 0))
+    .sort((left, right) => threadRecency(right) - threadRecency(left))
     .slice(0, limit);
   return { ...catalog, pinnedThreads, threads: merged };
 }
@@ -1489,10 +1506,11 @@ function normalizeAppServerTimeline(thread) {
   }, false);
 }
 
-function normalizeSharedTimeline({ thread, nextCursor, sync }) {
-  return { ...normalizeTimeline({ thread: { ...thread, title: thread.name || thread.title || '', hostId: 'local', transport: 'shared-app-server' } }, false),
-    ...(nextCursor !== undefined ? { nextCursor } : {}), ...(sync ? { sync } : {}) };
-}
+function normalizeSharedTimeline({ thread, nextCursor, sync }) {
+  return { ...normalizeTimeline({ thread: { ...thread, title: thread.name || thread.title || '', hostId: 'local', transport: 'shared-app-server' } }, false),
+    historyView: 'grouped-lazy-skeleton-v11',
+    ...(nextCursor !== undefined ? { nextCursor } : {}), ...(sync ? { sync } : {}) };
+}
 
 function restoreEmptyTurnMessages(threadId, turns) {
   const missing = new Map(turns.filter(turn => turn.entries.length === 0).map(turn => [turn.id, turn]));
@@ -1539,6 +1557,7 @@ function normalizeThread(thread) {
     title: source.name || source.title || source.preview || '',
     status: statusText(source.status),
     updatedAt: Number(source.updatedAt) || 0,
+    recencyAt: Number(source.recencyAt ?? source.updatedAt) || 0,
     projectId: source.projectId || '',
     cwd: source.cwd || '',
     hostId: source.hostId || '',
@@ -1548,21 +1567,39 @@ function normalizeThread(thread) {
   };
 }
 
-function normalizeTurn(turn) {
-  const source = turn && typeof turn === 'object' ? turn : {};
-  return {
-    id: source.id || '',
-    status: statusText(source.status),
+function normalizeTurn(turn) {
+  const source = turn && typeof turn === 'object' ? turn : {};
+  const turnId = source.id || '';
+  const entries = Array.isArray(source.items) ? source.items.map(normalizeItem).filter(Boolean) : [];
+  for (const entry of entries) {
+    const images = [...(entry.attachments || []), entry.image, ...Object.values(entry.imageAssets || {})].filter(Boolean);
+    for (const image of images) if (image.remotePath && !image.recoveryTurnId) image.recoveryTurnId = turnId;
+  }
+  return {
+    id: turnId,
+    status: statusText(source.status),
     startedAt: source.startedAt || null,
     completedAt: source.completedAt || null,
     durationMs: source.durationMs ?? null,
-    error: source.error ?? null,
-    entries: Array.isArray(source.items) ? source.items.map(normalizeItem).filter(Boolean) : [],
-  };
-}
-
-function normalizeItem(item) {
-  if (!item || typeof item !== 'object') return null;
+    error: source.error ?? null,
+    entries,
+  };
+}
+
+function normalizeItem(item) {
+  if (!item || typeof item !== 'object') return null;
+
+  if (item.type === 'lazyOperationGroup') {
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'lazyOperationGroup',
+      turnId: item.turnId || '',
+      groupId: item.groupId || '',
+      title: item.title || '执行过程',
+      count: Number(item.count) || 0,
+    };
+  }
 
   if (item.type === 'contextCompaction') {
     return {
@@ -1616,132 +1653,147 @@ function normalizeItem(item) {
     };
   }
 
-  if (item.type === 'reasoning') {
-    const detail = Array.isArray(item.summary)
-      ? item.summary.map(summaryText).filter(Boolean).join('\n')
-      : summaryText(item.summary);
-    return {
-      type: 'activity',
-      id: item.id || '',
-      kind: 'reasoning',
-      title: '思考摘要',
-      detail,
-    };
-  }
-
-  if (item.type === 'commandExecution') {
-    return {
-      type: 'activity',
-      id: item.id || '',
-      kind: 'command',
-      title: '命令',
-      status: statusText(item.status),
-      command: item.command || '',
-      cwd: item.cwd || '',
-      exitCode: item.exitCode ?? null,
-      durationMs: item.durationMs ?? null,
-      output: item.aggregatedOutput || item.output?.text || '',
-    };
-  }
+  if (item.type === 'reasoning') {
+    const detail = Array.isArray(item.summary)
+      ? item.summary.map(summaryText).filter(Boolean).join('\n')
+      : summaryText(item.summary);
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'reasoning',
+      title: '思考摘要',
+      detail,
+    };
+  }
 
+  if (item.type === 'commandExecution') {
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'command',
+      title: '命令',
+      titleOnly: true,
+      status: statusText(item.status),
+      command: item.command,
+      cwd: item.cwd,
+      exitCode: item.exitCode,
+      durationMs: item.durationMs,
+    };
+  }
+
   if (item.type === 'mcpToolCall') {
-    const result = normalizeToolResult(item.result, item.error);
     return {
       type: 'activity',
       id: item.id || '',
-      kind: 'tool',
-      title: '工具',
-      status: statusText(item.status),
-      server: item.server || '',
-      tool: item.tool || '',
-      arguments: item.arguments || {},
-      resultText: result.text,
-      errorText: result.error,
-      resources: result.resources,
-      mediaCount: result.mediaCount,
-      durationMs: item.durationMs ?? null,
+      kind: 'tool',
+      title: '工具',
+      titleOnly: true,
+      status: statusText(item.status),
+      server: item.server,
+      tool: item.tool,
+      arguments: item.arguments,
+      durationMs: item.durationMs,
+      error: item.error,
+    };
+  }
+
+  if (item.type === 'dynamicToolCall') {
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'tool',
+      title: '工具',
+      titleOnly: true,
+      status: statusText(item.status),
+      namespace: item.namespace,
+      tool: item.tool,
+      arguments: item.arguments,
+      durationMs: item.durationMs,
+      success: item.success,
+    };
+  }
+
+  if (item.type === 'fileChange') {
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'fileChange',
+      title: '文件修改',
+      titleOnly: true,
+      status: statusText(item.status),
+      changes: Array.isArray(item.changes) ? item.changes : [],
     };
   }
 
-  if (item.type === 'fileChange') {
-    return {
-      type: 'activity',
-      id: item.id || '',
-      kind: 'fileChange',
-      title: '文件修改',
-      status: statusText(item.status),
-      changes: Array.isArray(item.changes) ? item.changes : [],
-    };
-  }
-
-  if (item.type === 'webSearch') {
-    return {
-      type: 'activity',
-      id: item.id || '',
-      kind: 'webSearch',
-      title: '网页搜索',
-      query: item.query || item.action?.query || '',
-    };
-  }
-
-  if (item.type === 'imageView') {
-    return {
-      type: 'activity',
-      id: item.id || '',
-      kind: 'imageView',
-      title: '查看图片',
-      path: item.path || '',
-      image: typeof item.path === 'string' && item.path
-        ? normalizeAttachment({ type: 'localImage', path: item.path })
-        : null,
-    };
-  }
-
-  if (item.type === 'imageGeneration') {
-    let image = typeof item.savedPath === 'string' && item.savedPath
-      ? normalizeAttachment({ type: 'localImage', path: item.savedPath, name: '生成的图片' })
-      : null;
-    if ((!image || !image.available) && typeof item.result === 'string' && item.result.trim()) {
-      const result = item.result.trim();
-      const url = result.startsWith('data:image/') ? result : `data:image/png;base64,${result}`;
-      image = normalizeAttachment({ type: 'image', url, name: '生成的图片' });
-    }
-    return {
-      type: 'activity',
-      id: item.id || '',
-      kind: 'imageGeneration',
-      title: '生成图片',
-      status: statusText(item.status),
-      image,
-      failure: item.failure || null,
-      transparentBackground: item.transparentBackground === true,
-    };
-  }
-
-  if (item.type === 'subAgentActivity') {
-    return {
-      type: 'activity',
-      id: item.id || '',
-      kind: 'subAgent',
-      title: '子任务',
-      status: statusText(item.kind),
-      agentPath: item.agentPath || '',
-      agentThreadId: item.agentThreadId || '',
-    };
-  }
-
-  if (item.type === 'collabAgentToolCall') {
-    return {
-      type: 'activity',
-      id: item.id || '',
-      kind: 'collaboration',
-      title: '任务协作',
-      status: statusText(item.status),
-      tool: item.tool || '',
-      prompt: item.prompt || '',
-      receiverThreadIds: Array.isArray(item.receiverThreadIds) ? item.receiverThreadIds : [],
-    };
-  }
+  if (item.type === 'webSearch') {
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'webSearch',
+      title: '网页搜索',
+      titleOnly: true,
+      query: item.query || item.action?.query || '',
+      ...(item.action && typeof item.action === 'object' ? { action: item.action } : {}),
+    };
+  }
+
+  if (item.type === 'imageView') {
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'imageView',
+      title: '查看图片',
+      titleOnly: true,
+      path: item.path || '',
+      image: typeof item.path === 'string' && item.path
+        ? normalizeAttachment({ type: 'localImage', path: item.path })
+        : null,
+    };
+  }
+
+  if (item.type === 'imageGeneration') {
+    const image = typeof item.savedPath === 'string' && item.savedPath
+      ? normalizeAttachment({ type: 'localImage', path: item.savedPath, name: '生成的图片' })
+      : null;
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'imageGeneration',
+      title: '生成图片',
+      titleOnly: true,
+      status: statusText(item.status),
+      image,
+      failure: item.failure || null,
+      transparentBackground: item.transparentBackground === true,
+    };
+  }
+
+  if (item.type === 'subAgentActivity') {
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'subAgent',
+      title: '子任务',
+      titleOnly: true,
+      status: statusText(item.kind),
+      agentPath: item.agentPath || '',
+      agentThreadId: item.agentThreadId || '',
+    };
+  }
+
+  if (item.type === 'collabAgentToolCall') {
+    return {
+      type: 'activity',
+      id: item.id || '',
+      kind: 'collaboration',
+      title: '任务协作',
+      titleOnly: true,
+      status: statusText(item.status),
+      tool: item.tool || '',
+      prompt: item.prompt || '',
+      receiverThreadIds: Array.isArray(item.receiverThreadIds) ? item.receiverThreadIds : [],
+    };
+  }
 
   return {
     type: 'activity',
@@ -1753,44 +1805,19 @@ function normalizeItem(item) {
   };
 }
 
-function normalizeToolResult(result, fallbackError) {
-  const text = [];
-  const resources = [];
-  let mediaCount = 0;
-  const seen = new Set();
-  const addText = value => {
-    const normalized = typeof value === 'string' ? value.trim() : '';
-    if (normalized && !seen.has(normalized)) { seen.add(normalized); text.push(normalized); }
-  };
-  const visit = (value, depth = 0) => {
-    if (value == null || depth > 4) return;
-    if (typeof value === 'string') { addText(value); return; }
-    if (Array.isArray(value)) { for (const item of value) visit(item, depth + 1); return; }
-    if (typeof value !== 'object') return;
-    if (value.type === 'image' || value.type === 'audio') { mediaCount += 1; return; }
-    if (value.type === 'resource_link') {
-      resources.push({ name: value.title || value.name || '资源', uri: value.uri || '', description: value.description || '' });
-      return;
-    }
-    if (value.type === 'resource' && value.resource) {
-      const resource = value.resource;
-      if (typeof resource.text === 'string') addText(resource.text);
-      else if (resource.uri) resources.push({ name: resource.title || resource.name || '资源', uri: resource.uri, description: resource.description || '' });
-      return;
-    }
-    if (typeof value.text === 'string') addText(value.text);
-    if (typeof value.message === 'string') addText(value.message);
-    if (value.content) visit(value.content, depth + 1);
-    if (value.raw) visit(value.raw, depth + 1);
+function sharedHistoryPageOptions() {
+  return {
+    maxTurns: SHARED_HISTORY_PAGE_TURNS,
+    maxBytes: SHARED_HISTORY_PAGE_BYTES,
+    measure: value => Buffer.byteLength(JSON.stringify(normalizeSharedTimeline(value))),
   };
-  visit(result);
-  const resultError = result?.type === 'error' ? result.error : null;
-  const errorValue = fallbackError || resultError;
-  const error = typeof errorValue === 'string' ? errorValue : errorValue?.message || errorValue?.text || '';
-  return { text: text.join('\n\n'), error, resources, mediaCount };
 }
-
-function normalizeAttachments(content) {
+
+function threadRecency(thread) {
+  return Number(thread?.recencyAt ?? thread?.updatedAt) || 0;
+}
+
+function normalizeAttachments(content) {
   if (!Array.isArray(content)) return [];
   const items = content.filter(item => item && !['text', 'input_text'].includes(item.type)).map(item => ({ ...item }));
   const text = content.filter(item => ['text', 'input_text'].includes(item?.type)).map(item => item.text || '').join('\n');
@@ -1833,18 +1860,19 @@ function markdownImageAssets(text) {
   return assets;
 }
 
-function markdownFileAssets(text) {
+function markdownFileAssets(text) {
   const assets = Object.create(null);
   function visit(tokens) {
     for (const token of tokens) {
       if (token.type === 'link_open') {
         const value = token.attrGet('href');
         if (value && !Object.hasOwn(assets, value)) {
-          let localPath;
-          try { localPath = decodeURIComponent(value); } catch { localPath = ''; }
-          if (/^\/?[a-z]:[\\/]/i.test(localPath)) {
-            localPath = localPath.replace(/^\/(?=[a-z]:)/i, '');
-            const asset = rememberLocalFile(localPath);
+          let localPath;
+          try { localPath = decodeURIComponent(value); } catch { localPath = ''; }
+          if (/^\/?[a-z]:[\\/]/i.test(localPath)) {
+            localPath = localPath.replace(/^\/(?=[a-z]:)/i, '');
+            localPath = localPath.replace(/:(\d+)(?::\d+)?$/, '');
+            const asset = rememberLocalFile(localPath);
             if (asset) assets[value] = { remotePath: asset.id, name: asset.name, size: asset.size };
           }
         }
@@ -1914,18 +1942,23 @@ function normalizeAttachment(item) {
     name,
     mimeType: cached?.mimeType || item.mimeType || '',
     available: Boolean(cached),
-    remotePath: cached ? cached.id : '',
+    remotePath: cached ? cached.id : '',
+    recoveryToken: cached?.recoveryToken || '',
     url: '',
     thumbnailUrl: '',
   };
 }
 
-function cacheLocalImage(filePath, name) {
-  try {
-    const stat = fs.statSync(filePath);
-    const mimeType = imageMimeType(filePath);
-    if (!stat.isFile() || !mimeType || stat.size > MAX_ATTACHMENT_BYTES) return null;
-    return rememberAttachment(fs.readFileSync(filePath), mimeType, name);
+function cacheLocalImage(filePath, name) {
+  try {
+    const resolved = path.resolve(filePath);
+    const stat = fs.statSync(resolved);
+    const mimeType = imageMimeType(resolved);
+    if (!stat.isFile() || !mimeType || stat.size > MAX_ATTACHMENT_BYTES) return null;
+    const cached = rememberAttachment(fs.readFileSync(resolved), mimeType, name,
+      localImageRecoveryToken(resolved, stat));
+    void attachmentThumbnail(cached).catch(() => {});
+    return cached;
   } catch {
     return null;
   }
@@ -1943,16 +1976,65 @@ function cacheDataImage(dataUrl, name) {
   }
 }
 
-function rememberAttachment(buffer, mimeType, name) {
-  const id = crypto.createHash('sha256').update(buffer).digest('hex');
-  if (!attachmentCache.has(id)) {
+function rememberAttachment(buffer, mimeType, name, recoveryToken = '') {
+  const id = crypto.createHash('sha256').update(buffer).digest('hex');
+  if (!attachmentCache.has(id)) {
     while (attachmentCache.size >= MAX_CACHED_ATTACHMENTS) {
       attachmentCache.delete(attachmentCache.keys().next().value);
-    }
-    attachmentCache.set(id, { id, buffer, mimeType, name });
-  }
-  return attachmentCache.get(id);
-}
+    }
+    attachmentCache.set(id, { id, buffer, mimeType, name, recoveryToken });
+  } else if (recoveryToken && !attachmentCache.get(id).recoveryToken) {
+    attachmentCache.get(id).recoveryToken = recoveryToken;
+  }
+  return attachmentCache.get(id);
+}
+
+function localImageRecoveryToken(filePath, stat) {
+  const iv = crypto.randomBytes(12);
+  const cipher = crypto.createCipheriv('aes-256-gcm', imageCapabilityKey, iv);
+  const payload = Buffer.from(JSON.stringify([filePath, stat.size, stat.mtimeMs]));
+  const encrypted = Buffer.concat([cipher.update(payload), cipher.final()]);
+  return Buffer.concat([iv, cipher.getAuthTag(), encrypted]).toString('base64url');
+}
+
+function recoverLocalImage(id, token) {
+  if (!token || token.length > 2048) return null;
+  try {
+    const value = Buffer.from(token, 'base64url');
+    if (value.length < 29) return null;
+    const decipher = crypto.createDecipheriv('aes-256-gcm', imageCapabilityKey, value.subarray(0, 12));
+    decipher.setAuthTag(value.subarray(12, 28));
+    const [filePath, size, mtimeMs] = JSON.parse(Buffer.concat([
+      decipher.update(value.subarray(28)), decipher.final(),
+    ]).toString('utf8'));
+    if (typeof filePath !== 'string' || !path.isAbsolute(filePath)
+      || !Number.isSafeInteger(size) || size <= 0 || size > MAX_ATTACHMENT_BYTES
+      || typeof mtimeMs !== 'number' || !Number.isFinite(mtimeMs)) return null;
+    const stat = fs.statSync(filePath);
+    const mimeType = imageMimeType(filePath);
+    if (!stat.isFile() || stat.size !== size || stat.mtimeMs !== mtimeMs || !mimeType) return null;
+    const buffer = fs.readFileSync(filePath);
+    if (crypto.createHash('sha256').update(buffer).digest('hex') !== id) return null;
+    return rememberAttachment(buffer, mimeType, path.basename(filePath), token);
+  } catch {
+    return null;
+  }
+}
+
+async function attachmentThumbnail(image) {
+  if (!image.thumbnail) {
+    image.thumbnail = sharp(image.buffer, { limitInputPixels: 40_000_000 }).rotate()
+      .resize({ width: 640, height: 640, fit: 'inside', withoutEnlargement: true })
+      .webp({ quality: 78, effort: 4 })
+      .toBuffer()
+      .then(buffer => ({ buffer, mimeType: 'image/webp' }))
+      .catch(error => {
+        image.thumbnail = null;
+        throw error;
+      });
+  }
+  return image.thumbnail;
+}
 
 function imageMimeType(filePath) {
   switch (path.extname(filePath).toLowerCase()) {
@@ -1999,18 +2081,18 @@ function extractDelegatedInput(value) {
     .trim();
 }
 
-function delegatedOutputText(output) {
+function delegatedOutputText(output) {
   if (typeof output === 'string') return output;
   return output && typeof output.text === 'string' ? output.text : '';
-}
-
-function summaryText(value) {
-  if (typeof value === 'string') return value;
-  if (value && typeof value === 'object') return value.text || value.summary || JSON.stringify(value);
-  return '';
-}
-
-function statusText(value) {
+}
+
+function summaryText(value) {
+  if (typeof value === 'string') return value;
+  if (value && typeof value === 'object') return value.text || value.summary || JSON.stringify(value);
+  return '';
+}
+
+function statusText(value) {
   if (typeof value === 'string') return value;
   if (value && typeof value === 'object') return value.type || value.status || 'unknown';
   return value == null ? 'unknown' : String(value);