@xfxstudio/claworld 2026.6.10-testing.1 → 2026.6.10-testing.2

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.1",
+  "version": "2026.6.10-testing.2",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

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

@@ -866,15 +866,63 @@ function parseViewerRoute(req) {
   };
 }
 
-async function fetchBackendJson(fetchImpl, runtimeConfig = {}, pathName) {
+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 response = await fetchImpl(`${baseUrl}${pathName}`, {
+  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();
@@ -885,6 +933,7 @@ async function fetchBackendJson(fetchImpl, runtimeConfig = {}, pathName) {
     ok: response.ok,
     status: response.status,
     body,
+    path: pathName,
   };
 }
 
@@ -974,8 +1023,10 @@ export async function loadConversationViewerSnapshot({
   manifest,
   runtimeConfig,
   fetchImpl = globalThis.fetch,
+  timeoutMs = DEFAULT_SNAPSHOT_FETCH_TIMEOUT_MS,
 } = {}) {
   const fetchedAt = new Date().toISOString();
+  const diagnostics = [];
   const viewerAgentId = normalizeText(manifest.viewerAgentId, runtimeConfig?.relay?.agentId || null);
   const inboxQuery = queryString({
     agentId: viewerAgentId,
@@ -983,15 +1034,27 @@ export async function loadConversationViewerSnapshot({
     conversationKey: manifest.conversationKey,
     localSessionKey: manifest.localSessionKey,
   });
-  const inboxResult = await fetchBackendJson(fetchImpl, runtimeConfig, `/v1/chat-requests${inboxQuery}`);
+  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,
     };
   }
   const inbox = normalizeObject(inboxResult.body, {});
@@ -1014,14 +1077,33 @@ export async function loadConversationViewerSnapshot({
   if (conversationKey) {
     const suffix = queryString({ agentId: viewerAgentId });
     const [conversationResult, turnsResult, participantsResult] = await Promise.all([
-      fetchBackendJson(fetchImpl, runtimeConfig, `/v1/conversations/${encodeURIComponent(conversationKey)}${suffix}`),
-      fetchBackendJson(fetchImpl, runtimeConfig, `/v1/conversations/${encodeURIComponent(conversationKey)}/turns${suffix}`),
-      fetchBackendJson(fetchImpl, runtimeConfig, `/v1/conversations/${encodeURIComponent(conversationKey)}/participants${suffix}`),
+      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,
+      });
     }
   }
   const peer = normalizeObject(chat?.counterparty, null)
@@ -1059,6 +1141,7 @@ export async function loadConversationViewerSnapshot({
       counts: inbox.counts || null,
       filters: inbox.filters || null,
     },
+    diagnostics,
   };
 }