@yeaft/webchat-agent 0.1.868 → 0.1.870

package/connection/message-router.js

@@ -37,7 +37,7 @@ import { handleRestartAgent, handleUpgradeAgent } from './upgrade.js';
 import { loadMcpServers, updateMcpConfig } from '../mcp.js';
 import { getLlmConfig, updateLlmConfig, getYeaftSettings, updateYeaftSettings, getSearchSettings, updateSearchSettings, fetchTavilyUsage } from '../yeaft/config-api.js';
 import { fetchModelsDev } from '../yeaft/llm/models-dev.js';
-import { handleYeaftGroupChat, handleYeaftModeSwitch, handleYeaftModelSwitch, resetYeaftSession, handleYeaftLoadHistory, handleYeaftLoadMoreHistory, handleYeaftAbortThread, handleYeaftAbortAll, handleYeaftAbortTurn, handleYeaftVpSubscribe, handleYeaftVpCreate, handleYeaftVpUpdate, handleYeaftVpDelete, handleYeaftVpRead, handleYeaftListGroups, handleYeaftCreateGroup, handleYeaftRenameGroup, handleYeaftUpdateGroup, handleYeaftUpdateGroupConfig, handleYeaftArchiveGroup, handleYeaftDeleteGroup, handleYeaftAddMember, handleYeaftRemoveMember, handleYeaftSetDefaultVp, handleYeaftChatSend, handleYeaftListChats, handleYeaftCreateChat, handleYeaftRenameChat, handleYeaftArchiveChat, handleYeaftDeleteChat, handleYeaftDreamTrigger, handleYeaftFetchToolStats, handleYeaftFetchDebugHistory, broadcastLanguageChange } from '../yeaft/web-bridge.js';
+import { handleYeaftGroupChat, handleYeaftModeSwitch, handleYeaftModelSwitch, resetYeaftSession, handleYeaftLoadHistory, handleYeaftLoadMoreHistory, handleYeaftAbortThread, handleYeaftAbortAll, handleYeaftAbortTurn, handleYeaftVpSubscribe, handleYeaftVpCreate, handleYeaftVpUpdate, handleYeaftVpDelete, handleYeaftVpRead, handleYeaftListGroups, handleYeaftCreateGroup, handleYeaftRenameGroup, handleYeaftUpdateGroup, handleYeaftUpdateGroupConfig, handleYeaftArchiveGroup, handleYeaftDeleteGroup, handleYeaftAddMember, handleYeaftRemoveMember, handleYeaftSetDefaultVp, handleYeaftDreamTrigger, handleYeaftFetchToolStats, handleYeaftFetchDebugHistory, broadcastLanguageChange } from '../yeaft/web-bridge.js';
 
 export async function handleMessage(msg) {
   switch (msg.type) {
@@ -565,26 +565,6 @@ export async function handleMessage(msg) {
       handleYeaftGroupChat(msg);
       break;
 
-    // Yeaft Chat Mode (1:1 single-VP) — separate from group fan-out.
-    case 'yeaft_chat_send':
-      await handleYeaftChatSend(msg);
-      break;
-    case 'yeaft_list_chats':
-      await handleYeaftListChats(msg);
-      break;
-    case 'yeaft_create_chat':
-      await handleYeaftCreateChat(msg);
-      break;
-    case 'yeaft_rename_chat':
-      await handleYeaftRenameChat(msg);
-      break;
-    case 'yeaft_archive_chat':
-      await handleYeaftArchiveChat(msg);
-      break;
-    case 'yeaft_delete_chat':
-      await handleYeaftDeleteChat(msg);
-      break;
-
     // wave-6b: manual dream trigger from VP detail page
     case 'yeaft_dream_trigger':
     case 'unify_dream_trigger':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.1.868",
+  "version": "0.1.870",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",

package/yeaft/web-bridge.js

@@ -45,15 +45,6 @@ import {
   groupsRoot,
 } from './groups/group-crud.js';
 import { openGroup, loadGroupMeta } from './groups/group-store.js';
-import {
-  createChat as createChatStore,
-  openChat,
-  listChats,
-  renameChat as renameChatStore,
-  archiveChat as archiveChatStore,
-  deleteChat as deleteChatStore,
-  touchChat,
-} from './chats/chat-store.js';
 import { loadGroupConfig, resolveGroupConfig, GroupConfigError } from './groups/group-config.js';
 import { updateGroupConfig } from './groups/group-crud.js';
 import { createCoordinator } from './groups/coordinator.js';
@@ -1676,53 +1667,12 @@ export function handleYeaftSetDefaultVp(msg) {
   }
 }
 
-// ─── Yeaft Chat Mode ──────────────────────────────────────────
-//
-// 1:1 conversation between the user and a single VP. Reuses the engine,
-// memory, tool, and adapter stacks; bypasses the group coordinator and
-// fan-out machinery entirely. Persisted under `~/.yeaft/chats/<chatId>/`.
-
-const chatEngines = new Map();   // key: `${chatId}::${vpId}` → Engine
-const chatAborts = new Map();    // key: chatId → AbortController for the in-flight turn
-
-function chatsRootFor(yeaftDir) {
-  return join(yeaftDir, 'chats');
-}
-
-function snapshotChats(yeaftDir) {
-  if (!yeaftDir) return [];
-  try { return listChats(chatsRootFor(yeaftDir)); }
-  catch { return []; }
-}
-
-function sendChatCrudResult(payload) {
-  sendYeaftEvent({ type: 'chat_crud_result', ...payload });
-}
-
-function sendChatSnapshotBroadcast() {
-  try {
-    const yeaftDir = ctx.CONFIG?.yeaftDir;
-    if (!yeaftDir) return;
-    sendYeaftEvent({ type: 'chat_list_updated', chats: snapshotChats(yeaftDir) });
-  } catch (err) {
-    console.warn('[Yeaft] sendChatSnapshotBroadcast failed:', err?.message || err);
-  }
-}
-
-function chatErrorPayload(err) {
-  return {
-    code: (err && err.code) || 'unknown',
-    chatId: err && err.chatId,
-    message: err && err.message,
-  };
-}
 
 /**
  * Build the vpPersona payload threaded into engine.query so the worker
  * system prompt carries the VP's identity/role/persona/planInstruction.
  * Returns null on miss — callers treat that as "use generic prompt".
- * Shared by handleYeaftChatSend and the group fan-out path so the field
- * set stays in lockstep.
+ * Used by the group fan-out path (buildVpQueryOpts).
  */
 function buildVpPersona(vpId) {
   if (!vpId) return null;
@@ -1743,297 +1693,6 @@ function buildVpPersona(vpId) {
   }
 }
 
-export function handleYeaftListChats(msg) {
-  const requestId = msg && msg.requestId;
-  try {
-    const yeaftDir = ctx.CONFIG?.yeaftDir;
-    sendChatCrudResult({ op: 'list', requestId, ok: true, chats: snapshotChats(yeaftDir) });
-  } catch (err) {
-    sendChatCrudResult({ op: 'list', requestId, ok: false, error: chatErrorPayload(err) });
-  }
-}
-
-export function handleYeaftCreateChat(msg) {
-  const requestId = msg && msg.requestId;
-  // Accept fields at top-level (current wire shape) AND inside `payload`
-  // (legacy / future) — keeps backwards compatibility cheap.
-  const top = msg || {};
-  const payload = (msg && msg.payload) || {};
-  const displayName = payload.displayName || top.displayName;
-  const workDir = payload.workDir || top.workDir;
-  const explicitId = payload.id || top.id;
-  // Chat mode is 1:1 with the built-in Omni assistant by default. The
-  // VP picker is gone from the UI; callers may still override vpId to
-  // bind a chat to a specialist, but the default is omni.
-  const vpId = payload.vpId || top.vpId || 'omni';
-  try {
-    const yeaftDir = ctx.CONFIG?.yeaftDir;
-    if (!yeaftDir) throw new Error('no yeaft directory configured');
-    // Fail loud at create time if the requested VP (default: omni) is
-    // not installed — otherwise the chat would silently degrade to a
-    // generic prompt at first send.
-    if (!buildVpPersona(vpId)) {
-      throw new Error(`VP '${vpId}' is not installed`);
-    }
-    const root = chatsRootFor(yeaftDir);
-    const chatId = (explicitId && String(explicitId).trim())
-      || `chat_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
-    const h = createChatStore(root, {
-      id: chatId,
-      vpId,
-      displayName,
-      workDir,
-    });
-    const meta = h.getMeta();
-    h.close();
-    sendChatCrudResult({ op: 'create', requestId, ok: true, chat: meta });
-    sendChatSnapshotBroadcast();
-  } catch (err) {
-    sendChatCrudResult({ op: 'create', requestId, ok: false, error: chatErrorPayload(err) });
-  }
-}
-
-export function handleYeaftRenameChat(msg) {
-  const requestId = msg && msg.requestId;
-  const chatId = msg && msg.chatId;
-  const displayName = msg && msg.displayName;
-  try {
-    const yeaftDir = ctx.CONFIG?.yeaftDir;
-    const chat = renameChatStore(chatsRootFor(yeaftDir), chatId, displayName);
-    sendChatCrudResult({ op: 'rename', requestId, ok: true, chat });
-    sendChatSnapshotBroadcast();
-  } catch (err) {
-    sendChatCrudResult({ op: 'rename', requestId, ok: false, error: chatErrorPayload(err) });
-  }
-}
-
-export function handleYeaftArchiveChat(msg) {
-  const requestId = msg && msg.requestId;
-  const chatId = msg && msg.chatId;
-  try {
-    const yeaftDir = ctx.CONFIG?.yeaftDir;
-    const ok = archiveChatStore(chatsRootFor(yeaftDir), chatId);
-    if (!ok) throw new Error(`chat ${chatId} not found`);
-    invalidateChatRuntime(chatId);
-    sendChatCrudResult({ op: 'archive', requestId, ok: true, chatId });
-    sendChatSnapshotBroadcast();
-  } catch (err) {
-    sendChatCrudResult({ op: 'archive', requestId, ok: false, error: chatErrorPayload(err) });
-  }
-}
-
-export function handleYeaftDeleteChat(msg) {
-  const requestId = msg && msg.requestId;
-  const chatId = msg && msg.chatId;
-  try {
-    const yeaftDir = ctx.CONFIG?.yeaftDir;
-    const ok = deleteChatStore(chatsRootFor(yeaftDir), chatId);
-    if (!ok) throw new Error(`chat ${chatId} not found`);
-    invalidateChatRuntime(chatId);
-    sendChatCrudResult({ op: 'delete', requestId, ok: true, chatId });
-    sendChatSnapshotBroadcast();
-  } catch (err) {
-    sendChatCrudResult({ op: 'delete', requestId, ok: false, error: chatErrorPayload(err) });
-  }
-}
-
-function invalidateChatRuntime(chatId) {
-  if (!chatId) return;
-  const prefix = `${chatId}::`;
-  for (const k of Array.from(chatEngines.keys())) {
-    if (k.startsWith(prefix)) chatEngines.delete(k);
-  }
-  const ctrl = chatAborts.get(chatId);
-  if (ctrl) {
-    try { ctrl.abort(); } catch { /* best-effort */ }
-    chatAborts.delete(chatId);
-  }
-}
-
-function getOrCreateChatEngine(chatId, vpId) {
-  const key = `${chatId}::${vpId}`;
-  let eng = chatEngines.get(key);
-  if (eng) return eng;
-  if (!session) throw new Error('getOrCreateChatEngine: session not loaded');
-  eng = new Engine({
-    adapter: session.adapter,
-    trace: session.trace,
-    config: session.config,
-    conversationStore: session.conversationStore,
-    memoryIndex: session.memoryIndex || null,
-    amsRegistry: session.amsRegistry,
-    toolRegistry: session.toolRegistry,
-    skillManager: session.skillManager,
-    mcpManager: session.mcpManager,
-    yeaftDir: session.yeaftDir,
-    toolStats: session.toolStats || null,
-    chatId,
-    vpId,
-  });
-  chatEngines.set(key, eng);
-  return eng;
-}
-
-/**
- * Send a single user turn in a chat session. 1:1 — no fan-out, no
- * coordinator, no @-mention dispatch. Engine events are forwarded as
- * yeaft_output with `chatId` instead of `groupId`.
- */
-export async function handleYeaftChatSend(msg) {
-  if (!msg || typeof msg !== 'object') return;
-  const chatId = typeof msg.chatId === 'string' ? msg.chatId.trim() : '';
-  const text = typeof msg.text === 'string' ? msg.text : '';
-  if (!chatId) return;
-  if (!text.trim()) return;
-
-  const yeaftDir = ctx.CONFIG?.yeaftDir;
-  if (!yeaftDir) {
-    sendYeaftOutput({
-      type: 'assistant',
-      message: { content: [{ type: 'text', text: '⚠️ Yeaft session error: no yeaft directory configured.' }] },
-    }, { chatId });
-    sendYeaftOutput({ type: 'result', result_text: '' }, { chatId });
-    return;
-  }
-
-  await ensureSessionLoaded();
-
-  const root = chatsRootFor(yeaftDir);
-  let handle;
-  try { handle = openChat(root, chatId); }
-  catch (err) {
-    sendYeaftOutput({
-      type: 'assistant',
-      message: { content: [{ type: 'text', text: `⚠️ ${err.message}` }] },
-    }, { chatId });
-    sendYeaftOutput({ type: 'result', result_text: '' }, { chatId });
-    return;
-  }
-  const meta = handle.getMeta();
-  if (!meta) {
-    handle.close();
-    sendYeaftOutput({
-      type: 'assistant',
-      message: { content: [{ type: 'text', text: `⚠️ Chat ${chatId} not found.` }] },
-    }, { chatId });
-    sendYeaftOutput({ type: 'result', result_text: '' }, { chatId });
-    return;
-  }
-  const vpId = meta.vpId;
-
-  // Persist attachments + build LLM-side multimodal parts. Same flow as
-  // the group path (handleYeaftGroupChat) so chat mode isn't a
-  // second-class citizen for images / files.
-  const inboundFiles = Array.isArray(msg.files) ? msg.files : [];
-  let attachmentBundle = { promptAttachments: [], promptSuffix: '', promptParts: [], failed: [] };
-  if (inboundFiles.length > 0) {
-    try {
-      attachmentBundle = persistYeaftAttachments(inboundFiles, { subdir: `chat-${chatId}` });
-    } catch (err) {
-      console.warn('[Yeaft] yeaft_chat_send: attachment persist failed', err?.message || err);
-    }
-  }
-  if (Array.isArray(attachmentBundle.failed) && attachmentBundle.failed.length > 0) {
-    const detail = attachmentBundle.failed.map((f) => `  - ${f.name}: ${f.error}`).join('\n');
-    sendYeaftOutput({
-      type: 'assistant',
-      message: { content: [{ type: 'text', text: `⚠️ ${attachmentBundle.failed.length} file(s) could not be attached:\n${detail}` }] },
-    }, { chatId });
-  }
-  const persistedAttachments = attachmentsForPersistence(attachmentBundle.promptAttachments);
-
-  // Append the user message to the chat log so subsequent reads see it.
-  try {
-    handle.appendMessage({ from: 'user', role: 'user', text, meta: { attachments: persistedAttachments } });
-  } catch (err) {
-    console.warn('[Yeaft] chat appendMessage failed:', err?.message || err);
-  } finally {
-    handle.close();
-  }
-
-  const turnId = `t_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
-  const envelope = { chatId, vpId, turnId };
-
-  // Cancel any in-flight turn on this chat — 1:1 has no parallelism.
-  const prior = chatAborts.get(chatId);
-  if (prior) { try { prior.abort(); } catch { /* ignore */ } }
-  const abort = new AbortController();
-  chatAborts.set(chatId, abort);
-
-  sendYeaftEvent({ type: 'vp_turn_start', vpId, threadId: 'main', turnId, chatId, title: meta.displayName || '' }, envelope);
-
-  let queryTimer = null;
-  const resetQueryTimer = () => {
-    if (queryTimer) clearTimeout(queryTimer);
-    queryTimer = setTimeout(() => {
-      if (!abort.signal.aborted) {
-        try { abort.abort(); } catch { /* ignore */ }
-      }
-    }, QUERY_TIMEOUT_MS);
-  };
-  resetQueryTimer();
-
-  try {
-    const assistantTextParts = [];
-    const toolCallsAccum = [];
-    const toolResultsAccum = [];
-    const thinkingBlocksAccum = [];
-    const appendedUserPrompts = [];
-
-    const eng = getOrCreateChatEngine(chatId, vpId);
-    const handlerCtx = {
-      assistantTextParts,
-      toolCallsAccum,
-      toolResultsAccum,
-      thinkingBlocksAccum,
-      resetQueryTimer,
-      chatId,
-      vpId,
-      turnId,
-      threadId: 'main',
-      thread: null,
-      appendedUserPrompts,
-    };
-
-    // Load the VP persona (defaults to omni) so the engine's worker
-    // prompt has the right identity/role/persona blocks. Without this,
-    // chat mode runs with a generic system prompt instead of Omni.
-    const vpPersona = buildVpPersona(vpId);
-
-    for await (const event of eng.query({
-      prompt: text,
-      promptParts: attachmentBundle.promptParts && attachmentBundle.promptParts.length > 0 ? attachmentBundle.promptParts : null,
-      signal: abort.signal,
-      userAlreadyPersisted: false,
-      threadId: 'main',
-      senderVpId: vpId,
-      vpPersona,
-    })) {
-      resetQueryTimer();
-      handleEngineEvent(event, handlerCtx);
-    }
-
-    sendYeaftOutput({ type: 'assistant', message: { content: [] } }, envelope);
-    sendYeaftOutput({ type: 'result', result_text: '' }, envelope);
-
-    try { touchChat(root, chatId); } catch { /* best-effort */ }
-  } catch (err) {
-    const isAbort = err && (err.name === 'AbortError' || err.name === 'LLMAbortError');
-    if (isAbort) {
-      sendYeaftOutput({ type: 'result', result_text: '', stopped: true }, envelope);
-    } else {
-      console.error('[Yeaft] chat-send error:', err);
-      sendYeaftOutput({
-        type: 'assistant',
-        message: { content: [{ type: 'text', text: `⚠️ Chat error: ${err.message}` }] },
-      }, envelope);
-      sendYeaftOutput({ type: 'result', result_text: '' }, envelope);
-    }
-  } finally {
-    if (queryTimer) clearTimeout(queryTimer);
-    if (chatAborts.get(chatId) === abort) chatAborts.delete(chatId);
-  }
-}
 
 /**
  * Install the dream pipeline progress sink and runtime settings bridge.

package/yeaft/chats/chat-store.js

@@ -1,224 +0,0 @@
-/**
- * chat-store.js — Per-chat persistent store for Yeaft Chat Mode.
- *
- * Layout (architecture parity with group-store.js):
- *   ~/.yeaft/chats/<chat-id>/
- *     chat.json           # { id, displayName, vpId, workDir, createdAt, lastTurnAt }
- *     messages/           # JSONL size-rotation log
- *       000001.jsonl
- *       index.json
- *
- * A chat is 1:1 with a single VP and persists messages the same way groups
- * do — same storage primitives, same jsonl shape — but without a roster.
- *
- * Hard constraint: no @-mention parsing, no dispatch, no engine awareness.
- * This module only owns chat.json + the messages log.
- */
-
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  renameSync,
-  rmSync,
-  statSync,
-} from 'fs';
-import { join } from 'path';
-import { writeAtomic, openLog } from '../storage/index.js';
-import { nextMsgId, isReservedVpId, ReservedVpIdError, validateVpId, InvalidVpIdError } from '../groups/ids.js';
-
-const CHAT_FILE = 'chat.json';
-const MESSAGES_DIR = 'messages';
-
-const CHAT_ID_RE = /^[A-Za-z0-9_-]{1,64}$/;
-
-/**
- * Open (or partially create) the directory for a chat. Returns a handle even
- * when chat.json is absent — call createChat() to materialise it.
- *
- * @param {string} chatsRoot
- * @param {string} chatId
- * @returns {ChatHandle}
- */
-export function openChat(chatsRoot, chatId) {
-  if (!chatId || typeof chatId !== 'string') {
-    throw new Error('openChat: chatId required (string)');
-  }
-  if (!CHAT_ID_RE.test(chatId)) {
-    throw new Error(`openChat: invalid chatId "${chatId}"`);
-  }
-  const dir = join(chatsRoot, chatId);
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-
-  let meta = loadChatMeta(dir);
-
-  const messagesDir = join(dir, MESSAGES_DIR);
-  if (!existsSync(messagesDir)) mkdirSync(messagesDir, { recursive: true });
-  const log = openLog(messagesDir);
-
-  return {
-    dir,
-    id: chatId,
-    getMeta() { return meta ? structuredClone(meta) : null; },
-    saveMeta(next) {
-      validateMeta(next);
-      meta = next;
-      writeAtomic(join(dir, CHAT_FILE), JSON.stringify(meta, null, 2));
-    },
-    appendMessage(record) {
-      if (!record || typeof record !== 'object') {
-        throw new Error('appendMessage: record required');
-      }
-      const leaked = Object.keys(record).filter((k) => typeof k === 'string' && k.startsWith('_'));
-      if (leaked.length > 0) {
-        throw new Error(`appendMessage: ephemeral fields leaked into log: ${leaked.join(', ')}`);
-      }
-      const stored = {
-        id: record.id || nextMsgId(),
-        ts: record.ts || new Date().toISOString(),
-        from: record.from,
-        role: record.role || (record.from === 'user' ? 'user' : 'assistant'),
-        text: record.text ?? '',
-        taskId: record.taskId || null,
-        mentions: Array.isArray(record.mentions) ? record.mentions.slice() : [],
-        meta: record.meta || {},
-      };
-      log.append(stored);
-      return stored;
-    },
-    *streamMessages() { yield* log.streamAll(); },
-    *readMessageRange(firstId, lastId) { yield* log.readRange(firstId, lastId); },
-    close() { log.close(); },
-  };
-}
-
-/**
- * Create a new chat on disk. Fails if chat.json already exists.
- * @param {string} chatsRoot
- * @param {{id:string, vpId:string, displayName?:string, workDir?:string, createdAt?:string}} spec
- * @returns {ChatHandle}
- */
-export function createChat(chatsRoot, spec) {
-  if (!spec || !spec.id) throw new Error('createChat: spec.id required');
-  if (!spec.vpId) throw new Error('createChat: spec.vpId required');
-  if (isReservedVpId(spec.vpId)) throw new ReservedVpIdError(spec.vpId);
-  const verdict = validateVpId(spec.vpId);
-  if (!verdict.ok) throw new InvalidVpIdError(spec.vpId, verdict.reason);
-
-  const h = openChat(chatsRoot, spec.id);
-  if (h.getMeta()) {
-    throw new Error(`chat ${spec.id} already exists`);
-  }
-  const meta = {
-    id: spec.id,
-    displayName: typeof spec.displayName === 'string' && spec.displayName.trim()
-      ? spec.displayName.trim() : spec.id,
-    vpId: spec.vpId,
-    workDir: typeof spec.workDir === 'string' ? spec.workDir.trim() : '',
-    createdAt: spec.createdAt || new Date().toISOString(),
-    lastTurnAt: null,
-  };
-  h.saveMeta(meta);
-  return h;
-}
-
-/** Non-destructive load — returns null if chat.json is missing/corrupt. */
-export function loadChatMeta(dir) {
-  const path = join(dir, CHAT_FILE);
-  if (!existsSync(path)) return null;
-  try {
-    const raw = readFileSync(path, 'utf8');
-    const parsed = JSON.parse(raw);
-    validateMeta(parsed);
-    if (typeof parsed.displayName !== 'string') parsed.displayName = parsed.id;
-    if (typeof parsed.workDir !== 'string') parsed.workDir = '';
-    if (parsed.lastTurnAt === undefined) parsed.lastTurnAt = null;
-    return parsed;
-  } catch {
-    return null;
-  }
-}
-
-/** List every chat directory under `chatsRoot`. */
-export function listChats(chatsRoot) {
-  if (!existsSync(chatsRoot)) return [];
-  const out = [];
-  for (const name of readdirSync(chatsRoot)) {
-    if (name.startsWith('.')) continue;
-    const p = join(chatsRoot, name);
-    try {
-      if (!statSync(p).isDirectory()) continue;
-    } catch { continue; }
-    const meta = loadChatMeta(p);
-    if (meta) out.push(meta);
-  }
-  return out;
-}
-
-/** Update a chat's displayName. */
-export function renameChat(chatsRoot, chatId, displayName) {
-  const h = openChat(chatsRoot, chatId);
-  const meta = h.getMeta();
-  if (!meta) throw new Error(`renameChat: chat ${chatId} not found`);
-  const next = { ...meta, displayName: String(displayName || '').trim() || meta.id };
-  h.saveMeta(next);
-  h.close();
-  return next;
-}
-
-/** Stamp lastTurnAt — invoked by web-bridge after a successful turn. */
-export function touchChat(chatsRoot, chatId, when = new Date().toISOString()) {
-  const h = openChat(chatsRoot, chatId);
-  const meta = h.getMeta();
-  if (!meta) { h.close(); return null; }
-  const next = { ...meta, lastTurnAt: when };
-  h.saveMeta(next);
-  h.close();
-  return next;
-}
-
-/** Soft-archive: rename dir to `.archived-<chatId>-<ts>`. */
-export function archiveChat(chatsRoot, chatId) {
-  const src = join(chatsRoot, chatId);
-  if (!existsSync(src)) return false;
-  const ts = new Date().toISOString().replace(/[:.]/g, '-');
-  const dst = join(chatsRoot, `.archived-${chatId}-${ts}`);
-  renameSync(src, dst);
-  return true;
-}
-
-/** Permanently delete a chat directory. Use after archive when sure. */
-export function deleteChat(chatsRoot, chatId) {
-  const src = join(chatsRoot, chatId);
-  if (!existsSync(src)) return false;
-  rmSync(src, { recursive: true, force: true });
-  return true;
-}
-
-function validateMeta(meta) {
-  if (!meta || typeof meta !== 'object') throw new Error('chat.json must be object');
-  if (!meta.id || typeof meta.id !== 'string') throw new Error('chat.id required');
-  if (!meta.vpId || typeof meta.vpId !== 'string') throw new Error('chat.vpId required');
-  if (meta.displayName != null && typeof meta.displayName !== 'string') {
-    throw new Error('chat.displayName must be string');
-  }
-  if (meta.workDir != null && typeof meta.workDir !== 'string') {
-    throw new Error('chat.workDir must be string');
-  }
-  if (meta.lastTurnAt != null && typeof meta.lastTurnAt !== 'string') {
-    throw new Error('chat.lastTurnAt must be string|null');
-  }
-}
-
-/**
- * @typedef {Object} ChatHandle
- * @property {string} dir
- * @property {string} id
- * @property {() => any} getMeta
- * @property {(next:any) => void} saveMeta
- * @property {(record:any) => any} appendMessage
- * @property {() => Generator<any>} streamMessages
- * @property {(first:string,last:string) => Generator<any>} readMessageRange
- * @property {() => void} close
- */