@xfxstudio/claworld 2026.6.10-testing.5 → 2026.6.26-testing.1

package/src/openclaw/plugin/conversation-viewer.js

@@ -1,1547 +0,0 @@
-import crypto from 'node:crypto';
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-import { buildRuntimeAuthHeaders } from './account-identity.js';
-import {
-  resolveConversationViewerGatewayBaseUrl,
-  resolveConversationViewerOpenClawRoot,
-  resolveConversationViewerRoot,
-} from './conversation-viewer-env.js';
-import { loadCurrentConfig } from './register-tooling.js';
-import { normalizeRelayHttpBaseUrl } from '../runtime/http-boundary.js';
-
-export const CONVERSATION_VIEWER_ROUTE_PREFIX = '/plugins/claworld/conversation-viewers/';
-export const CONVERSATION_VIEWER_SCHEMA = 'claworld.conversationViewer.v1';
-export {
-  resolveConversationViewerGatewayBaseUrl,
-  resolveConversationViewerOpenClawRoot,
-  resolveConversationViewerRoot,
-} from './conversation-viewer-env.js';
-
-function normalizeText(value, fallback = null) {
-  if (value == null) return fallback;
-  const normalized = String(value).trim();
-  return normalized || fallback;
-}
-
-function normalizeObject(value, fallback = null) {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) return fallback;
-  return value;
-}
-
-function cloneJsonObject(value, fallback = null) {
-  if (!value || typeof value !== 'object') return fallback;
-  try {
-    return JSON.parse(JSON.stringify(value));
-  } catch {
-    return fallback;
-  }
-}
-
-function safeJsonForScript(value) {
-  return JSON.stringify(value).replace(/</g, '\\u003c');
-}
-
-function normalizeRouteId(value) {
-  const normalized = normalizeText(value, null);
-  return normalized && /^[a-zA-Z0-9_-]+$/.test(normalized) ? normalized : null;
-}
-
-function resolveRequest(input = {}) {
-  return normalizeObject(input.chatRequest, null)
-    || normalizeObject(input.request, null)
-    || (normalizeText(input.chatRequestId || input.requestId, null) ? input : null);
-}
-
-function resolveChat(input = {}) {
-  return normalizeObject(input.chat, null)
-    || normalizeObject(input.conversationChat, null)
-    || null;
-}
-
-function resolveKickoff(input = {}, request = null) {
-  return normalizeObject(input.kickoff, null)
-    || normalizeObject(input.request?.kickoff, null)
-    || normalizeObject(request?.kickoff, null)
-    || null;
-}
-
-function resolveConversation(input = {}, chat = null) {
-  return normalizeObject(input.conversation, null)
-    || normalizeObject(chat?.conversation, null)
-    || null;
-}
-
-function resolveCounterparty(input = {}, request = null, chat = null) {
-  return normalizeObject(chat?.counterparty, null)
-    || normalizeObject(request?.counterparty, null)
-    || normalizeObject(input.counterparty, null)
-    || null;
-}
-
-export function resolveConversationViewerTarget(input = {}, {
-  accountId = null,
-  viewerAgentId = null,
-  role = null,
-  source = null,
-} = {}) {
-  const payload = normalizeObject(input, {}) || {};
-  const request = resolveRequest(payload);
-  const chat = resolveChat(payload);
-  const kickoff = resolveKickoff(payload, request);
-  const conversation = resolveConversation(payload, chat);
-  const counterparty = resolveCounterparty(payload, request, chat);
-  const chatRequestId = normalizeText(
-    request?.chatRequestId,
-    normalizeText(request?.requestId, normalizeText(chat?.chatRequestId, normalizeText(payload.chatRequestId, null))),
-  );
-  const conversationKey = normalizeText(
-    kickoff?.conversationKey,
-    normalizeText(
-      chat?.conversationKey,
-      normalizeText(conversation?.conversationKey, normalizeText(payload.conversationKey, null)),
-    ),
-  );
-  const localSessionKey = normalizeText(
-    kickoff?.localSessionKey,
-    normalizeText(
-      kickoff?.sessionKey,
-      normalizeText(chat?.localSessionKey, normalizeText(chat?.sessionKey, normalizeText(conversation?.sessionKey, null))),
-    ),
-  );
-  if (!chatRequestId && !conversationKey && !localSessionKey) return null;
-  const targetKey = chatRequestId
-    ? `${normalizeText(accountId, 'default')}|${normalizeText(viewerAgentId, 'unknown')}|request:${chatRequestId}`
-    : `${normalizeText(accountId, 'default')}|${normalizeText(viewerAgentId, 'unknown')}|conversation:${conversationKey || localSessionKey}`;
-  return {
-    targetKey,
-    accountId: normalizeText(accountId, null),
-    viewerAgentId: normalizeText(viewerAgentId, null),
-    role: normalizeText(role, null),
-    source: normalizeText(source, null),
-    status: normalizeText(payload.status, normalizeText(request?.status, normalizeText(chat?.status, null))),
-    verdict: normalizeText(payload.verdict, null),
-    reason: normalizeText(payload.reason, null),
-    chatRequestId,
-    conversationKey,
-    localSessionKey,
-    counterpartyAgentId: normalizeText(counterparty?.agentId, null),
-    counterpartyName: normalizeText(counterparty?.displayName, normalizeText(counterparty?.identity, null)),
-    worldId: normalizeText(conversation?.worldId, normalizeText(request?.conversation?.worldId, normalizeText(chat?.conversation?.worldId, null))),
-    direction: normalizeText(request?.direction, normalizeText(chat?.direction, null)),
-  };
-}
-
-async function readJsonIfPresent(filePath) {
-  try {
-    return JSON.parse(await fs.readFile(filePath, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-async function writeJson(filePath, value) {
-  await fs.mkdir(path.dirname(filePath), { recursive: true });
-  await fs.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
-}
-
-async function readViewerIndex(root) {
-  const index = await readJsonIfPresent(path.join(root, 'index.json'));
-  return normalizeObject(index, { schema: CONVERSATION_VIEWER_SCHEMA, viewers: {} });
-}
-
-function buildPublicConversationViewer(manifest = {}) {
-  return {
-    id: normalizeText(manifest.viewerId, null),
-    status: normalizeText(manifest.status, 'ready'),
-    url: normalizeText(manifest.viewerUrl, null),
-    localFile: normalizeText(manifest.htmlPath, null),
-    fileUrl: normalizeText(manifest.fileUrl, null),
-    chatRequestId: normalizeText(manifest.chatRequestId, null),
-    conversationKey: normalizeText(manifest.conversationKey, null),
-    localSessionKey: normalizeText(manifest.localSessionKey, null),
-    replay: {
-      firstOpenReplaysEndedConversation: true,
-      secondOpenShowsFullTranscript: true,
-    },
-    note: 'Open this local viewer URL to watch the Claworld A2A chat transcript.',
-  };
-}
-
-function buildViewerHtml(manifest = {}) {
-  const bootstrap = safeJsonForScript({
-    schema: CONVERSATION_VIEWER_SCHEMA,
-    viewerId: manifest.viewerId,
-    createdAt: manifest.createdAt,
-    target: {
-      chatRequestId: manifest.chatRequestId || null,
-      conversationKey: manifest.conversationKey || null,
-      localSessionKey: manifest.localSessionKey || null,
-    },
-  });
-  return `<!doctype html>
-<html lang="zh-CN">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Claworld A2A Chat</title>
-<style>
-:root {
-  color-scheme: light;
-  --bg: #eef2f6;
-  --panel: #ffffff;
-  --ink: #16202a;
-  --muted: #607083;
-  --line: #d9e0e8;
-  --self: #1f7a5c;
-  --selfText: #ffffff;
-  --peer: #ffffff;
-  --peerText: #17212b;
-  --warn: #b35b00;
-  --bad: #b42318;
-  --good: #0f766e;
-  --chip: #edf4ff;
-  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-}
-* { box-sizing: border-box; }
-body {
-  margin: 0;
-  min-height: 100vh;
-  background: linear-gradient(180deg, #f7f9fc 0%, var(--bg) 100%);
-  color: var(--ink);
-}
-.app {
-  min-height: 100vh;
-  display: grid;
-  grid-template-rows: auto 1fr auto;
-}
-.topbar {
-  display: flex;
-  gap: 14px;
-  align-items: center;
-  justify-content: space-between;
-  padding: 14px 18px;
-  background: rgba(255, 255, 255, 0.92);
-  border-bottom: 1px solid var(--line);
-  position: sticky;
-  top: 0;
-  z-index: 2;
-  backdrop-filter: blur(16px);
-}
-.identity {
-  min-width: 0;
-  display: flex;
-  align-items: center;
-  gap: 12px;
-}
-.avatar {
-  width: 40px;
-  height: 40px;
-  border-radius: 50%;
-  display: grid;
-  place-items: center;
-  background: #17212b;
-  color: #fff;
-  font-weight: 700;
-}
-.title { min-width: 0; }
-.title h1 {
-  margin: 0;
-  font-size: 16px;
-  line-height: 1.25;
-  font-weight: 700;
-  white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
-}
-.title p {
-  margin: 3px 0 0;
-  color: var(--muted);
-  font-size: 12px;
-}
-.status {
-  display: inline-flex;
-  align-items: center;
-  gap: 8px;
-  color: var(--muted);
-  font-size: 13px;
-  white-space: nowrap;
-}
-.dot {
-  width: 9px;
-  height: 9px;
-  border-radius: 50%;
-  background: var(--muted);
-}
-.dot.online { background: var(--good); }
-.dot.warn { background: var(--warn); }
-.dot.bad { background: var(--bad); }
-.messages {
-  width: min(920px, 100%);
-  margin: 0 auto;
-  padding: 18px 14px 96px;
-  display: flex;
-  flex-direction: column;
-  gap: 12px;
-}
-.empty {
-  margin: 18vh auto 0;
-  max-width: 520px;
-  text-align: center;
-  color: var(--muted);
-  line-height: 1.6;
-}
-.row {
-  display: flex;
-  gap: 8px;
-  align-items: flex-end;
-}
-.row.self { justify-content: flex-end; }
-.bubble {
-  max-width: min(680px, 78vw);
-  border: 1px solid var(--line);
-  border-radius: 8px;
-  padding: 10px 12px;
-  background: var(--peer);
-  color: var(--peerText);
-  box-shadow: 0 2px 8px rgba(18, 31, 46, 0.04);
-  overflow-wrap: anywhere;
-}
-.self .bubble {
-  background: var(--self);
-  color: var(--selfText);
-  border-color: color-mix(in srgb, var(--self) 80%, #000 20%);
-}
-.meta {
-  margin-top: 6px;
-  font-size: 11px;
-  color: color-mix(in srgb, currentColor 62%, transparent);
-}
-.md p { margin: 0 0 8px; }
-.md p:last-child { margin-bottom: 0; }
-.md pre {
-  overflow: auto;
-  margin: 8px 0;
-  padding: 10px;
-  border-radius: 6px;
-  background: rgba(0, 0, 0, 0.08);
-}
-.md code {
-  padding: 1px 4px;
-  border-radius: 4px;
-  background: rgba(0, 0, 0, 0.08);
-  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
-  font-size: 0.92em;
-}
-.md ul, .md ol { margin: 8px 0 8px 20px; padding: 0; }
-.chips {
-  margin-top: 8px;
-  display: flex;
-  flex-wrap: wrap;
-  gap: 6px;
-}
-.chip {
-  display: inline-flex;
-  align-items: center;
-  gap: 5px;
-  border-radius: 999px;
-  padding: 4px 8px;
-  font-size: 12px;
-  background: var(--chip);
-  color: #17406d;
-  border: 1px solid #c9ddf7;
-}
-.self .chip {
-  background: rgba(255, 255, 255, 0.16);
-  color: #fff;
-  border-color: rgba(255, 255, 255, 0.28);
-}
-.composer {
-  position: fixed;
-  left: 0;
-  right: 0;
-  bottom: 0;
-  padding: 12px 14px 14px;
-  background: rgba(238, 242, 246, 0.92);
-  border-top: 1px solid var(--line);
-  backdrop-filter: blur(16px);
-}
-.composer-inner {
-  width: min(920px, 100%);
-  margin: 0 auto;
-  min-height: 48px;
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  padding: 10px 12px;
-  background: var(--panel);
-  border: 1px solid var(--line);
-  border-radius: 8px;
-}
-.typing {
-  color: var(--muted);
-  font-size: 13px;
-  min-width: 0;
-}
-.typing .pulse::after {
-  content: "";
-  animation: dots 1.2s steps(4, end) infinite;
-}
-.timestamp {
-  color: var(--muted);
-  font-size: 12px;
-  white-space: nowrap;
-}
-@keyframes dots {
-  0% { content: ""; }
-  25% { content: "."; }
-  50% { content: ".."; }
-  75%, 100% { content: "..."; }
-}
-@media (max-width: 640px) {
-  .topbar { padding: 12px; align-items: flex-start; }
-  .status { font-size: 12px; }
-  .bubble { max-width: 86vw; }
-  .composer-inner { align-items: flex-start; flex-direction: column; }
-}
-</style>
-</head>
-<body>
-<div class="app">
-  <header class="topbar">
-    <div class="identity">
-      <div class="avatar" id="avatar">C</div>
-      <div class="title">
-        <h1 id="title">Claworld A2A Chat</h1>
-        <p id="subtitle">Preparing transcript</p>
-      </div>
-    </div>
-    <div class="status"><span class="dot" id="stateDot"></span><span id="stateText">Loading</span></div>
-  </header>
-  <main class="messages" id="messages">
-    <div class="empty">Loading the local conversation viewer.</div>
-  </main>
-  <footer class="composer">
-    <div class="composer-inner">
-      <div class="typing" id="typing">Connecting to Claworld state.</div>
-      <div class="timestamp" id="updatedAt"></div>
-    </div>
-  </footer>
-</div>
-<script>
-const BOOTSTRAP = ${bootstrap};
-const state = {
-  snapshot: null,
-  renderedIds: new Set(),
-  replaying: false,
-  firstSnapshotSeen: false,
-};
-const els = {
-  avatar: document.getElementById('avatar'),
-  title: document.getElementById('title'),
-  subtitle: document.getElementById('subtitle'),
-  stateDot: document.getElementById('stateDot'),
-  stateText: document.getElementById('stateText'),
-  messages: document.getElementById('messages'),
-  typing: document.getElementById('typing'),
-  updatedAt: document.getElementById('updatedAt'),
-};
-const replayKey = 'claworld.conversationViewer.' + BOOTSTRAP.viewerId + '.played';
-
-function escapeHtml(value) {
-  return String(value ?? '')
-    .replaceAll('&', '&amp;')
-    .replaceAll('<', '&lt;')
-    .replaceAll('>', '&gt;')
-    .replaceAll('"', '&quot;')
-    .replaceAll("'", '&#39;');
-}
-
-function renderInlineMarkdown(text) {
-  let html = escapeHtml(text);
-  html = html.replace(/\\[([^\\]]+)\\]\\((https?:\\/\\/[^\\s)]+)\\)/g, '<a href="$2" target="_blank" rel="noreferrer">$1</a>');
-  html = html.replace(/\\*\\*([^*]+)\\*\\*/g, '<strong>$1</strong>');
-  html = html.replace(/\\*([^*]+)\\*/g, '<em>$1</em>');
-  html = html.replace(/\`([^\`]+)\`/g, '<code>$1</code>');
-  return html;
-}
-
-function renderMarkdown(text) {
-  const blocks = String(text || '').split(/\\n{2,}/);
-  return blocks.map((block) => {
-    if (/^\`\`\`/.test(block.trim())) {
-      return '<pre><code>' + escapeHtml(block.replace(/^\`\`\`[a-zA-Z0-9_-]*\\n?/, '').replace(/\`\`\`$/, '')) + '</code></pre>';
-    }
-    const lines = block.split('\\n');
-    if (lines.every((line) => /^\\s*[-*]\\s+/.test(line))) {
-      return '<ul>' + lines.map((line) => '<li>' + renderInlineMarkdown(line.replace(/^\\s*[-*]\\s+/, '')) + '</li>').join('') + '</ul>';
-    }
-    return '<p>' + lines.map(renderInlineMarkdown).join('<br>') + '</p>';
-  }).join('');
-}
-
-function parseControlTokens(text) {
-  const tokens = [];
-  const cleanText = String(text || '').replace(/\\[\\[(like|dislike|request_conversation_end)\\]\\]/gi, (match, token) => {
-    tokens.push(String(token || '').toLowerCase());
-    return '';
-  }).replace(/\\s{2,}/g, ' ').trim();
-  return { cleanText, tokens };
-}
-
-function tokenLabel(token) {
-  if (token === 'like') return 'Liked';
-  if (token === 'dislike') return 'Disliked';
-  if (token === 'request_conversation_end') return 'Asked to end the conversation';
-  return token;
-}
-
-function turnText(turn) {
-  const content = Array.isArray(turn?.content) ? turn.content : [];
-  const textParts = content.map((item) => item && typeof item === 'object' ? item.text : null).filter(Boolean);
-  return textParts.join('\\n\\n') || turn?.previewText || '';
-}
-
-function isSelfTurn(turn, snapshot) {
-  return turn?.fromAgentId && turn.fromAgentId === snapshot?.viewer?.viewerAgentId;
-}
-
-function formatTime(value) {
-  const date = new Date(value || Date.now());
-  if (Number.isNaN(date.getTime())) return '';
-  return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
-}
-
-function terminalState(snapshot) {
-  const status = snapshot?.state?.status || '';
-  return ['ended', 'closed', 'expired', 'rejected', 'silent', 'kickoff_failed', 'failed'].includes(status);
-}
-
-function renderTurn(turn, snapshot) {
-  const row = document.createElement('div');
-  row.className = 'row ' + (isSelfTurn(turn, snapshot) ? 'self' : 'peer');
-  const bubble = document.createElement('div');
-  bubble.className = 'bubble';
-  const parsed = parseControlTokens(turnText(turn));
-  const md = document.createElement('div');
-  md.className = 'md';
-  md.innerHTML = parsed.cleanText ? renderMarkdown(parsed.cleanText) : '<p>Conversation control update</p>';
-  bubble.appendChild(md);
-  if (parsed.tokens.length) {
-    const chips = document.createElement('div');
-    chips.className = 'chips';
-    for (const token of parsed.tokens) {
-      const chip = document.createElement('span');
-      chip.className = 'chip';
-      chip.textContent = tokenLabel(token);
-      chips.appendChild(chip);
-    }
-    bubble.appendChild(chips);
-  }
-  const meta = document.createElement('div');
-  meta.className = 'meta';
-  meta.textContent = formatTime(turn.createdAt || turn.updatedAt);
-  bubble.appendChild(meta);
-  row.appendChild(bubble);
-  return row;
-}
-
-function setHeader(snapshot) {
-  const peer = snapshot?.state?.peerName || snapshot?.chat?.counterparty?.displayName || snapshot?.request?.counterparty?.displayName || 'Peer agent';
-  const status = snapshot?.state?.status || 'loading';
-  const online = snapshot?.state?.peerOnline === true;
-  els.title.textContent = peer;
-  els.avatar.textContent = (peer || 'C').slice(0, 1).toUpperCase();
-  els.subtitle.textContent = snapshot?.state?.scopeLabel || 'Claworld conversation';
-  els.stateText.textContent = snapshot?.state?.label || status;
-  els.stateDot.className = 'dot ' + (terminalState(snapshot) ? 'bad' : online ? 'online' : status === 'pending' || status === 'opening' ? 'warn' : '');
-  els.updatedAt.textContent = snapshot?.fetchedAt ? 'Updated ' + formatTime(snapshot.fetchedAt) : '';
-}
-
-function setTyping(snapshot) {
-  if (snapshot?.error) {
-    els.typing.textContent = 'Connection interrupted. Retrying.';
-    return;
-  }
-  const status = snapshot?.state?.status || 'loading';
-  if (status === 'pending') {
-    els.typing.textContent = 'Waiting for the peer to accept.';
-    return;
-  }
-  if (terminalState(snapshot)) {
-    els.typing.textContent = snapshot?.state?.terminalLabel || 'This conversation has ended.';
-    return;
-  }
-  const turns = Array.isArray(snapshot?.turns) ? snapshot.turns : [];
-  const last = turns[turns.length - 1] || null;
-  const peer = snapshot?.state?.peerName || 'The peer';
-  if (last && isSelfTurn(last, snapshot)) {
-    els.typing.innerHTML = '<span class="pulse">' + escapeHtml(peer) + ' is typing</span>';
-    return;
-  }
-  if (snapshot?.state?.peerOnline === false) {
-    els.typing.textContent = peer + ' is currently offline. New messages will appear here when delivery resumes.';
-    return;
-  }
-  els.typing.textContent = 'Conversation is live.';
-}
-
-function renderAll(snapshot) {
-  const turns = Array.isArray(snapshot?.turns) ? snapshot.turns : [];
-  els.messages.innerHTML = '';
-  state.renderedIds.clear();
-  if (!turns.length) {
-    const empty = document.createElement('div');
-    empty.className = 'empty';
-    empty.textContent = snapshot?.state?.emptyText || 'No conversation turns yet.';
-    els.messages.appendChild(empty);
-    return;
-  }
-  for (const turn of turns) {
-    state.renderedIds.add(turn.turnId || String(turn.seq));
-    els.messages.appendChild(renderTurn(turn, snapshot));
-  }
-  window.scrollTo({ top: document.body.scrollHeight, behavior: 'smooth' });
-}
-
-function appendNew(snapshot) {
-  const turns = Array.isArray(snapshot?.turns) ? snapshot.turns : [];
-  if (!turns.length) {
-    renderAll(snapshot);
-    return;
-  }
-  if (els.messages.querySelector('.empty')) els.messages.innerHTML = '';
-  for (const turn of turns) {
-    const id = turn.turnId || String(turn.seq);
-    if (state.renderedIds.has(id)) continue;
-    state.renderedIds.add(id);
-    els.messages.appendChild(renderTurn(turn, snapshot));
-  }
-  window.scrollTo({ top: document.body.scrollHeight, behavior: 'smooth' });
-}
-
-async function replay(snapshot) {
-  state.replaying = true;
-  const turns = Array.isArray(snapshot?.turns) ? snapshot.turns : [];
-  els.messages.innerHTML = '';
-  state.renderedIds.clear();
-  for (const turn of turns) {
-    const id = turn.turnId || String(turn.seq);
-    state.renderedIds.add(id);
-    els.messages.appendChild(renderTurn(turn, snapshot));
-    window.scrollTo({ top: document.body.scrollHeight, behavior: 'smooth' });
-    await new Promise((resolve) => setTimeout(resolve, Math.min(900, Math.max(280, turnText(turn).length * 18))));
-  }
-  try { localStorage.setItem(replayKey, new Date().toISOString()); } catch {}
-  state.replaying = false;
-}
-
-function hasReplayPlayed() {
-  try {
-    return Boolean(localStorage.getItem(replayKey));
-  } catch {
-    return false;
-  }
-}
-
-async function handleSnapshot(snapshot) {
-  state.snapshot = snapshot;
-  setHeader(snapshot);
-  setTyping(snapshot);
-  const shouldReplay = !state.firstSnapshotSeen && terminalState(snapshot) && Array.isArray(snapshot?.turns) && snapshot.turns.length > 0 && !hasReplayPlayed();
-  state.firstSnapshotSeen = true;
-  if (shouldReplay) {
-    await replay(snapshot);
-    return;
-  }
-  if (!state.renderedIds.size) renderAll(snapshot);
-  else if (!state.replaying) appendNew(snapshot);
-}
-
-async function loadSnapshot() {
-  const basePath = location.pathname.replace(/\\/$/, '');
-  const response = await fetch(basePath + '/snapshot', { cache: 'no-store' });
-  const snapshot = await response.json();
-  if (!response.ok) throw new Error(snapshot?.error || 'snapshot_failed');
-  return snapshot;
-}
-
-async function tick() {
-  try {
-    await handleSnapshot(await loadSnapshot());
-  } catch (error) {
-    await handleSnapshot({
-      error: true,
-      fetchedAt: new Date().toISOString(),
-      state: {
-        status: 'failed',
-        label: 'Viewer retrying',
-        emptyText: 'The local viewer cannot reach the Claworld state yet.',
-      },
-      turns: [],
-    });
-  } finally {
-    const delay = terminalState(state.snapshot) ? 5000 : 1800;
-    setTimeout(tick, delay);
-  }
-}
-
-tick();
-</script>
-</body>
-</html>
-`;
-}
-
-async function createOrUpdateManifest({
-  root,
-  target,
-  cfg = {},
-  env = null,
-  workspaceRoot = null,
-  gatewayBaseUrl = null,
-} = {}) {
-  const index = await readViewerIndex(root);
-  const existingViewerId = normalizeRouteId(index.viewers?.[target.targetKey]?.viewerId);
-  const viewerId = existingViewerId || `cv_${crypto.randomBytes(12).toString('hex')}`;
-  const viewerDir = path.join(root, viewerId);
-  const manifestPath = path.join(viewerDir, 'manifest.json');
-  const htmlPath = path.join(viewerDir, 'index.html');
-  const previous = await readJsonIfPresent(manifestPath);
-  const now = new Date().toISOString();
-  const resolvedGatewayBaseUrl = resolveConversationViewerGatewayBaseUrl({
-    cfg,
-    env,
-    explicitBaseUrl: gatewayBaseUrl,
-  });
-  const viewerUrl = `${resolvedGatewayBaseUrl}${CONVERSATION_VIEWER_ROUTE_PREFIX}${viewerId}/`;
-  const manifest = {
-    ...normalizeObject(previous, {}),
-    schema: CONVERSATION_VIEWER_SCHEMA,
-    viewerId,
-    targetKey: target.targetKey,
-    accountId: target.accountId,
-    viewerAgentId: target.viewerAgentId,
-    role: target.role || null,
-    source: target.source || null,
-    status: previous?.status || 'ready',
-    targetStatus: target.status || previous?.targetStatus || null,
-    verdict: target.verdict || null,
-    reason: target.reason || null,
-    chatRequestId: target.chatRequestId || previous?.chatRequestId || null,
-    conversationKey: target.conversationKey || previous?.conversationKey || null,
-    localSessionKey: target.localSessionKey || previous?.localSessionKey || null,
-    counterpartyAgentId: target.counterpartyAgentId || previous?.counterpartyAgentId || null,
-    counterpartyName: target.counterpartyName || previous?.counterpartyName || null,
-    worldId: target.worldId || previous?.worldId || null,
-    direction: target.direction || previous?.direction || null,
-    workspaceRoot: normalizeText(workspaceRoot, previous?.workspaceRoot || null),
-    root,
-    manifestPath,
-    htmlPath,
-    fileUrl: pathToFileURL(htmlPath).href,
-    routePath: `${CONVERSATION_VIEWER_ROUTE_PREFIX}${viewerId}/`,
-    viewerUrl,
-    createdAt: previous?.createdAt || now,
-    updatedAt: now,
-  };
-  await fs.mkdir(viewerDir, { recursive: true });
-  await fs.writeFile(htmlPath, buildViewerHtml(manifest), 'utf8');
-  await writeJson(manifestPath, manifest);
-  index.schema = CONVERSATION_VIEWER_SCHEMA;
-  index.updatedAt = now;
-  index.viewers = {
-    ...normalizeObject(index.viewers, {}),
-    [target.targetKey]: {
-      viewerId,
-      manifestPath,
-      updatedAt: now,
-    },
-  };
-  await writeJson(path.join(root, 'index.json'), index);
-  return manifest;
-}
-
-function addViewerToPayload(payload = {}, viewer = null) {
-  if (!viewer) return payload;
-  const next = cloneJsonObject(payload, {}) || {};
-  next.conversationViewer = viewer;
-  if (normalizeObject(next.chatRequest, null)) {
-    next.chatRequest = { ...next.chatRequest, conversationViewer: viewer };
-  }
-  if (normalizeObject(next.request, null)) {
-    next.request = { ...next.request, conversationViewer: viewer };
-  }
-  if (normalizeObject(next.chat, null)) {
-    next.chat = { ...next.chat, conversationViewer: viewer };
-  }
-  if (normalizeObject(next.conversation, null)) {
-    next.conversation = { ...next.conversation, conversationViewer: viewer };
-  }
-  return next;
-}
-
-export async function attachConversationViewerToPayload(payload = {}, {
-  accountId = null,
-  viewerAgentId = null,
-  role = null,
-  source = null,
-  cfg = {},
-  env = null,
-  workspaceRoot = null,
-  gatewayBaseUrl = null,
-  logger = console,
-} = {}) {
-  const target = resolveConversationViewerTarget(payload, {
-    accountId,
-    viewerAgentId,
-    role,
-    source,
-  });
-  if (!target) return payload;
-  try {
-    const root = resolveConversationViewerRoot({ env });
-    const manifest = await createOrUpdateManifest({
-      root,
-      target,
-      cfg,
-      env,
-      workspaceRoot,
-      gatewayBaseUrl,
-    });
-    return addViewerToPayload(payload, buildPublicConversationViewer(manifest));
-  } catch (error) {
-    logger?.warn?.('[claworld:conversation-viewer] failed to create local viewer', {
-      error: error?.message || String(error),
-      chatRequestId: target.chatRequestId || null,
-      conversationKey: target.conversationKey || null,
-    });
-    return {
-      ...payload,
-      conversationViewer: {
-        status: 'unavailable',
-        reason: 'viewer_creation_failed',
-      },
-    };
-  }
-}
-
-function sendResponse(res, statusCode, contentType, body) {
-  if (typeof res?.status === 'function' && typeof res?.send === 'function') {
-    const response = res.status(statusCode);
-    if (typeof response?.type === 'function') response.type(contentType);
-    res.send(body);
-    return true;
-  }
-  if (typeof res?.setHeader === 'function') {
-    res.statusCode = statusCode;
-    res.setHeader('content-type', contentType);
-    res.setHeader('cache-control', 'no-store');
-  }
-  if (typeof res?.end === 'function') {
-    res.end(body);
-    return true;
-  }
-  return false;
-}
-
-function sendJson(res, statusCode, payload) {
-  if (typeof res?.status === 'function' && typeof res?.json === 'function') {
-    res.status(statusCode).json(payload);
-    return true;
-  }
-  return sendResponse(res, statusCode, 'application/json; charset=utf-8', JSON.stringify(payload, null, 2));
-}
-
-function parseViewerRoute(req) {
-  const requestUrl = new URL(req?.url || CONVERSATION_VIEWER_ROUTE_PREFIX, 'http://127.0.0.1');
-  if (!requestUrl.pathname.startsWith(CONVERSATION_VIEWER_ROUTE_PREFIX)) return null;
-  const rest = requestUrl.pathname.slice(CONVERSATION_VIEWER_ROUTE_PREFIX.length);
-  const parts = rest.split('/').filter(Boolean);
-  const viewerId = normalizeRouteId(parts[0]);
-  if (!viewerId) return null;
-  return {
-    viewerId,
-    action: normalizeText(parts[1], 'html'),
-  };
-}
-
-const DEFAULT_SNAPSHOT_FETCH_TIMEOUT_MS = 4500;
-
-function timeoutError(message) {
-  const error = new Error(message);
-  error.name = 'TimeoutError';
-  return error;
-}
-
-async function withTimeout(promise, timeoutMs, onTimeout) {
-  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) return promise;
-  let timeoutId = null;
-  try {
-    return await Promise.race([
-      promise,
-      new Promise((_resolve, reject) => {
-        timeoutId = setTimeout(() => {
-          try {
-            reject(onTimeout());
-          } catch (error) {
-            reject(error);
-          }
-        }, timeoutMs);
-      }),
-    ]);
-  } finally {
-    if (timeoutId) clearTimeout(timeoutId);
-  }
-}
-
-async function fetchBackendJson(fetchImpl, runtimeConfig = {}, pathName, {
-  timeoutMs = DEFAULT_SNAPSHOT_FETCH_TIMEOUT_MS,
-} = {}) {
-  const baseUrl = normalizeRelayHttpBaseUrl(runtimeConfig.serverUrl);
-  const controller = typeof AbortController === 'function' ? new AbortController() : null;
-  const targetUrl = `${baseUrl}${pathName}`;
-  const fetchPromise = fetchImpl(targetUrl, {
-    method: 'GET',
-    headers: {
-      ...(runtimeConfig.apiKey ? { 'x-api-key': runtimeConfig.apiKey } : {}),
-      ...buildRuntimeAuthHeaders(runtimeConfig),
-    },
-    ...(controller ? { signal: controller.signal } : {}),
-  });
-  let response = null;
-  try {
-    response = await withTimeout(fetchPromise, timeoutMs, () => {
-      controller?.abort?.();
-      throw timeoutError(`backend request timed out after ${timeoutMs}ms`);
-    });
-  } catch (error) {
-    return {
-      ok: false,
-      status: 0,
-      error: error?.message || String(error),
-      path: pathName,
-    };
-  }
-  let body = null;
-  try {
-    body = await response.json();
-  } catch {
-    body = null;
-  }
-  return {
-    ok: response.ok,
-    status: response.status,
-    body,
-    path: pathName,
-  };
-}
-
-function queryString(params = {}) {
-  const search = new URLSearchParams();
-  for (const [key, value] of Object.entries(params)) {
-    const normalized = normalizeText(value, null);
-    if (normalized) search.set(key, normalized);
-  }
-  const rendered = search.toString();
-  return rendered ? `?${rendered}` : '';
-}
-
-function firstMatching(items = [], predicate) {
-  return Array.isArray(items) ? items.find((item) => item && predicate(item)) || null : null;
-}
-
-function resolveSnapshotRequest(inbox = {}, manifest = {}) {
-  const chatRequestId = normalizeText(manifest.chatRequestId, null);
-  if (!chatRequestId) return null;
-  const matches = (item) => normalizeText(item.chatRequestId || item.requestId, null) === chatRequestId;
-  return firstMatching(inbox.pendingRequests, matches)
-    || firstMatching(inbox.recentRequests, matches)
-    || null;
-}
-
-function resolveSnapshotChat(inbox = {}, manifest = {}) {
-  const conversationKey = normalizeText(manifest.conversationKey, null);
-  const chatRequestId = normalizeText(manifest.chatRequestId, null);
-  const localSessionKey = normalizeText(manifest.localSessionKey, null);
-  return firstMatching(inbox.chats, (item) => (
-    (conversationKey && normalizeText(item.conversationKey, null) === conversationKey)
-    || (chatRequestId && normalizeText(item.chatRequestId, null) === chatRequestId)
-    || (localSessionKey && normalizeText(item.localSessionKey, normalizeText(item.sessionKey, null)) === localSessionKey)
-  ));
-}
-
-function buildStateLabel(status, { peerName = null, peerOnline = null } = {}) {
-  if (status === 'pending') return 'Waiting for peer acceptance';
-  if (status === 'opening') return 'Opening conversation';
-  if (status === 'active') return peerOnline === false ? 'Peer offline, delivery will retry' : 'Live conversation';
-  if (status === 'ending') return 'Ending requested';
-  if (status === 'ended' || status === 'closed') return 'Conversation ended';
-  if (status === 'silent') return 'Peer kept silent';
-  if (status === 'kickoff_failed' || status === 'failed') return 'Conversation delivery issue';
-  if (status === 'expired') return 'Request expired';
-  if (status === 'rejected') return 'Request rejected';
-  return peerName ? `Conversation with ${peerName}` : 'Claworld conversation';
-}
-
-function resolveSnapshotStatus({
-  request = null,
-  chat = null,
-  conversation = null,
-  fallbackStatus = null,
-} = {}) {
-  const conversationStatus = normalizeText(conversation?.status, null);
-  if (conversationStatus === 'closed') return 'ended';
-  return normalizeText(
-    chat?.status,
-    normalizeText(request?.status, normalizeText(conversationStatus, normalizeText(fallbackStatus, 'pending'))),
-  );
-}
-
-function collectTurns(turnsPayload = {}) {
-  const turns = Array.isArray(turnsPayload?.items) ? turnsPayload.items : [];
-  return turns.slice().sort((left, right) => {
-    const leftSeq = Number(left?.seq);
-    const rightSeq = Number(right?.seq);
-    if (Number.isFinite(leftSeq) && Number.isFinite(rightSeq) && leftSeq !== rightSeq) return leftSeq - rightSeq;
-    return String(left?.createdAt || '').localeCompare(String(right?.createdAt || ''));
-  });
-}
-
-function uniqueNormalized(values = []) {
-  const seen = new Set();
-  const next = [];
-  for (const value of values) {
-    const normalized = normalizeText(value, null);
-    if (!normalized || seen.has(normalized)) continue;
-    seen.add(normalized);
-    next.push(normalized);
-  }
-  return next;
-}
-
-function normalizeSessionStoreKey(value) {
-  return normalizeText(value, '').toLowerCase();
-}
-
-function extractLocalAgentIdsFromManifest(manifest = {}) {
-  const ids = [];
-  for (const value of [manifest.localSessionKey, manifest.sessionKey]) {
-    const normalized = normalizeText(value, null);
-    const match = normalized?.match(/^agent:([^:]+):/);
-    if (match?.[1]) ids.push(match[1]);
-  }
-  ids.push('main');
-  return uniqueNormalized(ids);
-}
-
-function buildLocalSessionKeyCandidates(manifest = {}) {
-  const conversationKey = normalizeText(manifest.conversationKey, null);
-  const localSessionKey = normalizeText(manifest.localSessionKey, null);
-  const keys = [];
-  if (localSessionKey) {
-    keys.push(localSessionKey);
-    if (!localSessionKey.startsWith('agent:')) {
-      for (const localAgentId of extractLocalAgentIdsFromManifest(manifest)) {
-        keys.push(`agent:${localAgentId}:${localSessionKey}`);
-      }
-    }
-  }
-  if (conversationKey) {
-    keys.push(`conversation:${conversationKey}`);
-    for (const localAgentId of extractLocalAgentIdsFromManifest(manifest)) {
-      keys.push(`agent:${localAgentId}:conversation:${conversationKey}`);
-    }
-  }
-  return uniqueNormalized(keys);
-}
-
-function resolveSessionStoreEntry(store = null, candidateKeys = [], manifest = {}) {
-  if (!store || typeof store !== 'object' || Array.isArray(store)) return null;
-  const normalizedCandidates = new Set(candidateKeys.map(normalizeSessionStoreKey));
-  for (const key of candidateKeys) {
-    if (store[key] && typeof store[key] === 'object' && !Array.isArray(store[key])) {
-      return { key, record: store[key] };
-    }
-  }
-  for (const [key, record] of Object.entries(store)) {
-    if (
-      normalizedCandidates.has(normalizeSessionStoreKey(key))
-      && record
-      && typeof record === 'object'
-      && !Array.isArray(record)
-    ) {
-      return { key, record };
-    }
-  }
-
-  const conversationKey = normalizeText(manifest.conversationKey, null);
-  const counterpartyAgentId = normalizeText(manifest.counterpartyAgentId, null);
-  for (const [key, record] of Object.entries(store)) {
-    if (!record || typeof record !== 'object' || Array.isArray(record)) continue;
-    const keyText = normalizeText(key, '');
-    const recordText = [
-      keyText,
-      record.sessionFile,
-      record.transcriptPath,
-      record.lastTo,
-      record.route?.target?.to,
-      record.deliveryContext?.to,
-      record.origin?.to,
-    ].map((value) => normalizeText(value, '')).join('\n');
-    if (conversationKey && recordText.includes(conversationKey)) {
-      return { key, record };
-    }
-    if (
-      counterpartyAgentId
-      && candidateKeys.some((candidate) => keyText.includes(candidate))
-      && recordText.includes(counterpartyAgentId)
-    ) {
-      return { key, record };
-    }
-  }
-  return null;
-}
-
-function resolveTranscriptPathFromSessionRecord({
-  record = {},
-  sessionStorePath = null,
-} = {}) {
-  const direct = normalizeText(
-    record.transcriptPath,
-    normalizeText(record.sessionFile, normalizeText(record.sessionPath, null)),
-  );
-  if (direct) {
-    if (path.isAbsolute(direct) || !sessionStorePath) return direct;
-    return path.resolve(path.dirname(sessionStorePath), direct);
-  }
-  const sessionId = normalizeText(record.sessionId, normalizeText(record.id, null));
-  if (!sessionId || !sessionStorePath) return null;
-  return path.join(path.dirname(sessionStorePath), `${sessionId}.jsonl`);
-}
-
-function extractRequestBrief(content = '') {
-  const normalized = normalizeText(content, null);
-  if (!normalized || !normalized.startsWith('# Background')) return null;
-  const match = normalized.match(/## Request Brief[\s\S]*?```(?:text)?\s*\n([\s\S]*?)```/i);
-  return normalizeText(match?.[1], null);
-}
-
-function messageText(message = {}) {
-  if (typeof message?.content === 'string') return normalizeText(message.content, '');
-  if (Array.isArray(message?.content)) {
-    return message.content
-      .map((item) => {
-        if (typeof item === 'string') return item;
-        if (item && typeof item === 'object') return item.text || item.content || '';
-        return '';
-      })
-      .filter(Boolean)
-      .join('\n\n')
-      .trim();
-  }
-  return '';
-}
-
-function containsConversationEndToken(text = '') {
-  return /\[\[request_conversation_end\]\]/i.test(String(text || ''));
-}
-
-function buildLocalTranscriptTurn({
-  line,
-  seq,
-  text,
-  fromAgentId,
-  role,
-  source,
-  suffix = '',
-} = {}) {
-  const turnId = normalizeText(line.id, null) || `local_${seq}${suffix}`;
-  return {
-    turnId,
-    seq,
-    fromAgentId: normalizeText(fromAgentId, null),
-    role,
-    source,
-    createdAt: normalizeText(line.timestamp, null)
-      || (Number.isFinite(Number(line.message?.timestamp)) ? new Date(Number(line.message.timestamp)).toISOString() : null)
-      || new Date().toISOString(),
-    content: [{ type: 'text', text }],
-  };
-}
-
-async function readLocalTranscriptTurns({
-  transcriptPath = null,
-  manifest = {},
-  viewerAgentId = null,
-} = {}) {
-  const normalizedPath = normalizeText(transcriptPath, null);
-  if (!normalizedPath) return null;
-  let raw = '';
-  try {
-    raw = await fs.readFile(normalizedPath, 'utf8');
-  } catch {
-    return null;
-  }
-  const peerAgentId = normalizeText(manifest.counterpartyAgentId, 'peer');
-  const turns = [];
-  let seq = 1;
-  let sawNoReply = false;
-  let selfEndRequested = false;
-  let peerEndRequested = false;
-  for (const row of raw.split(/\n+/)) {
-    const lineText = row.trim();
-    if (!lineText) continue;
-    let line = null;
-    try {
-      line = JSON.parse(lineText);
-    } catch {
-      continue;
-    }
-    if (line?.type !== 'message') continue;
-    const message = line.message && typeof line.message === 'object' && !Array.isArray(line.message)
-      ? line.message
-      : {};
-    const text = messageText(message);
-    if (!text) continue;
-
-    const brief = extractRequestBrief(text);
-    if (brief) {
-      const requesterIsSelf = normalizeText(manifest.role, null) === 'requester';
-      const fromAgentId = requesterIsSelf ? viewerAgentId : peerAgentId;
-      turns.push(buildLocalTranscriptTurn({
-        line,
-        seq,
-        text: brief,
-        fromAgentId,
-        role: requesterIsSelf ? 'self' : 'peer',
-        source: 'local_transcript_request_brief',
-        suffix: '_brief',
-      }));
-      seq += 1;
-      if (requesterIsSelf && containsConversationEndToken(brief)) selfEndRequested = true;
-      if (!requesterIsSelf && containsConversationEndToken(brief)) peerEndRequested = true;
-      continue;
-    }
-
-    if (text === 'NO_REPLY') {
-      sawNoReply = true;
-      continue;
-    }
-    const isAssistant = message.role === 'assistant';
-    const fromAgentId = isAssistant ? viewerAgentId : peerAgentId;
-    if (containsConversationEndToken(text)) {
-      if (isAssistant) selfEndRequested = true;
-      else peerEndRequested = true;
-    }
-    turns.push(buildLocalTranscriptTurn({
-      line,
-      seq,
-      text,
-      fromAgentId,
-      role: isAssistant ? 'self' : 'peer',
-      source: 'local_transcript',
-    }));
-    seq += 1;
-  }
-  return {
-    transcriptPath: normalizedPath,
-    turns,
-    terminal: sawNoReply || (selfEndRequested && peerEndRequested),
-    sawNoReply,
-  };
-}
-
-async function loadLocalTranscriptSnapshot({
-  manifest = {},
-  env = null,
-  viewerAgentId = null,
-} = {}) {
-  const stateRoot = resolveConversationViewerOpenClawRoot({ env });
-  const candidateKeys = buildLocalSessionKeyCandidates(manifest);
-  const localAgentIds = extractLocalAgentIdsFromManifest(manifest);
-  for (const localAgentId of localAgentIds) {
-    const sessionStorePath = path.join(stateRoot, 'agents', localAgentId, 'sessions', 'sessions.json');
-    const store = await readJsonIfPresent(sessionStorePath);
-    const match = resolveSessionStoreEntry(store, candidateKeys, manifest);
-    if (!match) continue;
-    const transcriptPath = resolveTranscriptPathFromSessionRecord({
-      record: match.record,
-      sessionStorePath,
-    });
-    const transcript = await readLocalTranscriptTurns({
-      transcriptPath,
-      manifest,
-      viewerAgentId,
-    });
-    if (transcript && transcript.turns.length > 0) {
-      return {
-        ...transcript,
-        sessionStorePath,
-        sessionKey: match.key,
-        sessionId: normalizeText(match.record?.sessionId, null),
-      };
-    }
-  }
-  return null;
-}
-
-function inferLocalTranscriptStatus(status, localTranscript = null) {
-  const normalized = normalizeText(status, null);
-  if (['ended', 'closed', 'expired', 'rejected', 'silent', 'kickoff_failed', 'failed'].includes(normalized)) {
-    return normalized;
-  }
-  if (localTranscript?.terminal) return 'ended';
-  if (localTranscript?.turns?.length) return 'active';
-  return normalized || 'pending';
-}
-
-async function maybeUpdateManifestFromSnapshot(manifest = {}, patch = {}) {
-  const nextConversationKey = normalizeText(patch.conversationKey, normalizeText(manifest.conversationKey, null));
-  const nextLocalSessionKey = normalizeText(patch.localSessionKey, normalizeText(manifest.localSessionKey, null));
-  if (
-    nextConversationKey === normalizeText(manifest.conversationKey, null)
-    && nextLocalSessionKey === normalizeText(manifest.localSessionKey, null)
-  ) {
-    return manifest;
-  }
-  const next = {
-    ...manifest,
-    conversationKey: nextConversationKey,
-    localSessionKey: nextLocalSessionKey,
-    updatedAt: new Date().toISOString(),
-  };
-  await writeJson(manifest.manifestPath, next);
-  return next;
-}
-
-export async function loadConversationViewerSnapshot({
-  manifest,
-  runtimeConfig,
-  fetchImpl = globalThis.fetch,
-  timeoutMs = DEFAULT_SNAPSHOT_FETCH_TIMEOUT_MS,
-  env = null,
-} = {}) {
-  const fetchedAt = new Date().toISOString();
-  const diagnostics = [];
-  const viewerAgentId = normalizeText(manifest.viewerAgentId, runtimeConfig?.relay?.agentId || null);
-  let inbox = {};
-  let request = null;
-  let chat = null;
-  let conversationKey = normalizeText(manifest.conversationKey, null);
-  if (!conversationKey) {
-    const inboxQuery = queryString({
-      agentId: viewerAgentId,
-      chatRequestId: manifest.chatRequestId,
-      localSessionKey: manifest.localSessionKey,
-    });
-    let inboxResult = await fetchBackendJson(fetchImpl, runtimeConfig, `/v1/chat-requests${inboxQuery}`, { timeoutMs });
-    if (!inboxResult.ok && inboxQuery) {
-      diagnostics.push({
-        source: 'chat_requests_filtered',
-        status: inboxResult.status,
-        error: inboxResult.error || null,
-        path: inboxResult.path || null,
-      });
-      const fallbackQuery = queryString({ agentId: viewerAgentId });
-      inboxResult = await fetchBackendJson(fetchImpl, runtimeConfig, `/v1/chat-requests${fallbackQuery}`, { timeoutMs });
-    }
-    if (!inboxResult.ok) {
-      return {
-        ok: false,
-        error: 'chat_inbox_snapshot_failed',
-        status: inboxResult.status,
-        message: inboxResult.error || null,
-        fetchedAt,
-        viewer: buildPublicConversationViewer(manifest),
-        body: inboxResult.body,
-        diagnostics,
-      };
-    }
-    inbox = normalizeObject(inboxResult.body, {});
-    request = resolveSnapshotRequest(inbox, manifest);
-    chat = resolveSnapshotChat(inbox, manifest);
-    conversationKey = normalizeText(
-      chat?.conversationKey,
-      normalizeText(request?.kickoff?.conversationKey, null),
-    );
-  }
-  let activeManifest = manifest;
-  if (conversationKey) {
-    activeManifest = await maybeUpdateManifestFromSnapshot(manifest, {
-      conversationKey,
-      localSessionKey: normalizeText(chat?.localSessionKey, normalizeText(request?.kickoff?.localSessionKey, normalizeText(request?.kickoff?.sessionKey, null))),
-    });
-  }
-  let conversation = null;
-  let participants = [];
-  let turns = [];
-  let localTranscript = null;
-  if (conversationKey) {
-    const suffix = queryString({ agentId: viewerAgentId });
-    const [conversationResult, turnsResult, participantsResult] = await Promise.all([
-      fetchBackendJson(fetchImpl, runtimeConfig, `/v1/conversations/${encodeURIComponent(conversationKey)}${suffix}`, { timeoutMs }),
-      fetchBackendJson(fetchImpl, runtimeConfig, `/v1/conversations/${encodeURIComponent(conversationKey)}/turns${suffix}`, { timeoutMs }),
-      fetchBackendJson(fetchImpl, runtimeConfig, `/v1/conversations/${encodeURIComponent(conversationKey)}/participants${suffix}`, { timeoutMs }),
-    ]);
-    if (conversationResult.ok) conversation = conversationResult.body || null;
-    else diagnostics.push({
-      source: 'conversation',
-      status: conversationResult.status,
-      error: conversationResult.error || null,
-      path: conversationResult.path || null,
-    });
-    if (turnsResult.ok) turns = collectTurns(turnsResult.body);
-    else diagnostics.push({
-      source: 'turns',
-      status: turnsResult.status,
-      error: turnsResult.error || null,
-      path: turnsResult.path || null,
-    });
-    if (participantsResult.ok && Array.isArray(participantsResult.body?.items)) {
-      participants = participantsResult.body.items;
-    } else if (!participantsResult.ok) {
-      diagnostics.push({
-        source: 'participants',
-        status: participantsResult.status,
-        error: participantsResult.error || null,
-        path: participantsResult.path || null,
-      });
-    }
-  }
-  if (turns.length === 0) {
-    localTranscript = await loadLocalTranscriptSnapshot({
-      manifest: activeManifest,
-      env,
-      viewerAgentId,
-    });
-    if (localTranscript?.turns?.length) {
-      turns = localTranscript.turns;
-      diagnostics.push({
-        source: 'local_transcript',
-        status: 200,
-        path: localTranscript.transcriptPath,
-        sessionKey: localTranscript.sessionKey || null,
-        sessionId: localTranscript.sessionId || null,
-      });
-    }
-  }
-  if (participants.length === 0 && localTranscript?.turns?.length) {
-    participants = [
-      {
-        agentId: viewerAgentId,
-        displayName: 'You',
-      },
-      {
-        agentId: normalizeText(activeManifest.counterpartyAgentId, 'peer'),
-        displayName: normalizeText(activeManifest.counterpartyName, 'Peer agent'),
-      },
-    ];
-  }
-  const peer = normalizeObject(chat?.counterparty, null)
-    || normalizeObject(request?.counterparty, null)
-    || null;
-  const peerName = normalizeText(peer?.displayName, normalizeText(activeManifest.counterpartyName, 'Peer agent'));
-  const resolvedStatus = resolveSnapshotStatus({
-    request,
-    chat,
-    conversation,
-    fallbackStatus: activeManifest.targetStatus,
-  });
-  const status = inferLocalTranscriptStatus(resolvedStatus, localTranscript);
-  const worldName = normalizeText(chat?.conversation?.world?.displayName, normalizeText(request?.conversation?.world?.displayName, null));
-  return {
-    ok: true,
-    schema: CONVERSATION_VIEWER_SCHEMA,
-    fetchedAt,
-    viewer: {
-      ...buildPublicConversationViewer(activeManifest),
-      accountId: normalizeText(activeManifest.accountId, null),
-      viewerAgentId,
-    },
-    state: {
-      status,
-      label: buildStateLabel(status, { peerName, peerOnline: peer?.online }),
-      terminalLabel: status === 'ended' || status === 'closed' ? 'Both sides have finished this conversation.' : null,
-      emptyText: status === 'pending'
-        ? 'The request exists. Messages will appear here after the peer accepts.'
-        : 'No conversation turns have been recorded yet.',
-      peerName,
-      peerOnline: typeof peer?.online === 'boolean' ? peer.online : null,
-      scopeLabel: worldName ? `World: ${worldName}` : 'Direct Claworld chat',
-    },
-    request,
-    chat,
-    conversation,
-    participants,
-    turns,
-    inbox: {
-      counts: inbox.counts || null,
-      filters: inbox.filters || null,
-    },
-    localTranscript: localTranscript ? {
-      path: localTranscript.transcriptPath,
-      sessionKey: localTranscript.sessionKey || null,
-      sessionId: localTranscript.sessionId || null,
-      terminal: localTranscript.terminal === true,
-    } : null,
-    diagnostics,
-  };
-}
-
-export function buildConversationViewerRoute(plugin, {
-  api = null,
-  fetchImpl = globalThis.fetch,
-  env = null,
-  logger = console,
-} = {}) {
-  return {
-    method: 'GET',
-    path: CONVERSATION_VIEWER_ROUTE_PREFIX,
-    auth: 'plugin',
-    match: 'prefix',
-    async handler(req, res) {
-      const route = parseViewerRoute(req);
-      if (!route) {
-        return sendJson(res, 404, { error: 'viewer_not_found' });
-      }
-      const root = resolveConversationViewerRoot({ env });
-      const manifestPath = path.join(root, route.viewerId, 'manifest.json');
-      const manifest = await readJsonIfPresent(manifestPath);
-      if (!manifest || manifest.schema !== CONVERSATION_VIEWER_SCHEMA) {
-        return sendJson(res, 404, { error: 'viewer_not_found' });
-      }
-      if (route.action === 'snapshot') {
-        try {
-          const cfg = await loadCurrentConfig(api);
-          const accountId = normalizeText(manifest.accountId, plugin.config.defaultAccountId(cfg) || null);
-          const runtimeConfig = plugin.config.resolveRuntimeConfig(cfg, accountId);
-          const snapshot = await loadConversationViewerSnapshot({
-            manifest,
-            runtimeConfig,
-            fetchImpl,
-            env,
-          });
-          return sendJson(res, snapshot.ok === false ? 502 : 200, snapshot);
-        } catch (error) {
-          logger?.warn?.('[claworld:conversation-viewer] snapshot failed', {
-            viewerId: route.viewerId,
-            error: error?.message || String(error),
-          });
-          return sendJson(res, 502, {
-            ok: false,
-            error: 'viewer_snapshot_failed',
-            message: error?.message || String(error),
-          });
-        }
-      }
-      if (route.action && route.action !== 'html') {
-        return sendJson(res, 404, { error: 'viewer_route_not_found' });
-      }
-      const html = await fs.readFile(manifest.htmlPath, 'utf8');
-      return sendResponse(res, 200, 'text/html; charset=utf-8', html);
-    },
-  };
-}