@xfxstudio/claworld 2026.6.10-testing.3 → 2026.6.10-testing.5

package/openclaw.plugin.json

@@ -17,7 +17,7 @@
   },
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.6.10-testing.3",
+  "version": "2026.6.10-testing.5",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfxstudio/claworld",
-  "version": "2026.6.10-testing.3",
+  "version": "2026.6.10-testing.5",
   "description": "Claworld channel plugin for OpenClaw",
   "type": "module",
   "main": "index.js",

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

@@ -54,3 +54,14 @@ export function resolveConversationViewerRoot({
     || path.join(homeDir, '.openclaw');
   return path.resolve(stateDir.replace(/^~(?=$|\/|\\)/, homeDir), 'claworld', 'conversation-viewers');
 }
+
+export function resolveConversationViewerOpenClawRoot({
+  env = null,
+  homeDir = os.homedir(),
+} = {}) {
+  const sourceEnv = resolveEnv(env);
+  const stateDir = normalizeText(sourceEnv.OPENCLAW_STATE_DIR, null)
+    || normalizeText(sourceEnv.OPENCLAW_HOME, null)
+    || path.join(homeDir, '.openclaw');
+  return path.resolve(stateDir.replace(/^~(?=$|\/|\\)/, homeDir));
+}

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

@@ -5,6 +5,7 @@ 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';
@@ -14,6 +15,7 @@ export const CONVERSATION_VIEWER_ROUTE_PREFIX = '/plugins/claworld/conversation-
 export const CONVERSATION_VIEWER_SCHEMA = 'claworld.conversationViewer.v1';
 export {
   resolveConversationViewerGatewayBaseUrl,
+  resolveConversationViewerOpenClawRoot,
   resolveConversationViewerRoot,
 } from './conversation-viewer-env.js';
 
@@ -984,10 +986,18 @@ function buildStateLabel(status, { peerName = null, peerOnline = null } = {}) {
   return peerName ? `Conversation with ${peerName}` : 'Claworld conversation';
 }
 
-function resolveSnapshotStatus({ request = null, chat = null, conversation = null } = {}) {
+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, conversationStatus || 'pending'));
+  return normalizeText(
+    chat?.status,
+    normalizeText(request?.status, normalizeText(conversationStatus, normalizeText(fallbackStatus, 'pending'))),
+  );
 }
 
 function collectTurns(turnsPayload = {}) {
@@ -1000,6 +1010,294 @@ function collectTurns(turnsPayload = {}) {
   });
 }
 
+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));
@@ -1024,46 +1322,52 @@ export async function loadConversationViewerSnapshot({
   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);
-  const inboxQuery = queryString({
-    agentId: viewerAgentId,
-    chatRequestId: manifest.chatRequestId,
-    conversationKey: manifest.conversationKey,
-    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,
+  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,
     });
-    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,
-    };
+    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),
+    );
   }
-  const inbox = normalizeObject(inboxResult.body, {});
-  const request = resolveSnapshotRequest(inbox, manifest);
-  const chat = resolveSnapshotChat(inbox, manifest);
-  const conversationKey = normalizeText(
-    chat?.conversationKey,
-    normalizeText(manifest.conversationKey, normalizeText(request?.kickoff?.conversationKey, null)),
-  );
   let activeManifest = manifest;
   if (conversationKey) {
     activeManifest = await maybeUpdateManifestFromSnapshot(manifest, {
@@ -1074,6 +1378,7 @@ export async function loadConversationViewerSnapshot({
   let conversation = null;
   let participants = [];
   let turns = [];
+  let localTranscript = null;
   if (conversationKey) {
     const suffix = queryString({ agentId: viewerAgentId });
     const [conversationResult, turnsResult, participantsResult] = await Promise.all([
@@ -1106,11 +1411,46 @@ export async function loadConversationViewerSnapshot({
       });
     }
   }
+  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 status = resolveSnapshotStatus({ request, chat, conversation });
+  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,
@@ -1141,6 +1481,12 @@ export async function loadConversationViewerSnapshot({
       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,
   };
 }
@@ -1176,6 +1522,7 @@ export function buildConversationViewerRoute(plugin, {
             manifest,
             runtimeConfig,
             fetchImpl,
+            env,
           });
           return sendJson(res, snapshot.ok === false ? 502 : 200, snapshot);
         } catch (error) {