@xfxstudio/claworld 2026.4.29-testing.3 → 2026.4.29-testing.4

package/openclaw.plugin.json

@@ -8,7 +8,7 @@
   ],
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.4.29-testing.3",
+  "version": "2026.4.29-testing.4",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

package/src/openclaw/plugin/register-tooling.js

@@ -653,7 +653,10 @@ export function projectToolAccountViewResponse({
   identityPayload = null,
 } = {}) {
   const identityReady = identityPayload?.ready === true;
-  const ready = pairingPayload?.status === 'paired' && identityReady;
+  const bindingReady = pairingPayload?.status === 'paired';
+  const ready = bindingReady && identityReady;
+  const relayResolved = pairingPayload?.relayAgent?.resolved ?? null;
+  const relayOnline = pairingPayload?.relayAgent?.online ?? null;
   const resolvedShareCard = identityPayload && Object.prototype.hasOwnProperty.call(identityPayload, 'shareCard')
     ? projectToolShareCard(identityPayload.shareCard)
     : undefined;
@@ -668,7 +671,14 @@ export function projectToolAccountViewResponse({
     reason: normalizeText(pairingPayload?.reason, null),
     bindingSource: normalizeText(pairingPayload?.bindingSource, null),
     activation: {
-      status: pairingPayload?.status === 'paired' ? 'ready' : 'pending',
+      status: bindingReady ? 'ready' : 'pending',
+    },
+    diagnostics: {
+      toolReachable: true,
+      bindingReady,
+      publicIdentityReady: identityReady,
+      relayPresenceResolved: relayResolved,
+      relayOnline,
     },
     relay: {
       agentId: normalizeText(
@@ -678,9 +688,9 @@ export function projectToolAccountViewResponse({
       displayName: normalizeText(pairingPayload?.relayAgent?.displayName, null),
       discoverable: pairingPayload?.relayAgent?.discoverable ?? null,
       contactable: pairingPayload?.relayAgent?.contactable ?? null,
-      online: pairingPayload?.relayAgent?.online ?? null,
-      resolved: pairingPayload?.relayAgent?.resolved ?? null,
-      bindingStatus: pairingPayload?.status === 'paired' ? 'bound' : 'unactivated',
+      online: relayOnline,
+      resolved: relayResolved,
+      bindingStatus: bindingReady ? 'bound' : 'unactivated',
     },
     profile: projectToolAccountProfile(identityPayload),
     ...projectToolAccountIdentityFields(identityPayload),

package/src/openclaw/plugin/register.js

@@ -142,33 +142,6 @@ const CHAT_INBOX_FILTER_STATUSES = Object.freeze([
   'kickoff_failed',
   'ended',
 ]);
-const CHAT_INBOX_FILTER_KEYS = Object.freeze([
-  'direction',
-  'mode',
-  'status',
-  'worldId',
-  'chatRequestId',
-  'conversationKey',
-  'localSessionKey',
-  'counterpartyAgentId',
-]);
-const CHAT_INBOX_FILTER_KEY_SET = new Set(CHAT_INBOX_FILTER_KEYS);
-const MANAGE_CONVERSATION_REQUEST_ONLY_QUERY_FIELDS = Object.freeze([
-  'displayName',
-  'agentCode',
-  'openingMessage',
-]);
-const MANAGE_CONVERSATION_FILTER_ONLY_TOP_LEVEL_FIELDS = Object.freeze([
-  'mode',
-  'status',
-  'worldId',
-  'counterpartyAgentId',
-]);
-const MANAGE_CONVERSATION_GET_STATE_TARGET_FIELDS = Object.freeze([
-  'chatRequestId',
-  'conversationKey',
-  'localSessionKey',
-]);
 
 const TERMINAL_ACCOUNT_ACTIONS = Object.freeze([
   'view_account',
@@ -319,117 +292,6 @@ function normalizeChatInboxListFiltersInput(params = {}) {
   );
 }
 
-function hasProvidedToolParam(params = {}, fieldId) {
-  if (!params || typeof params !== 'object') return false;
-  if (!Object.prototype.hasOwnProperty.call(params, fieldId)) return false;
-  const value = params[fieldId];
-  if (typeof value === 'string') return normalizeText(value, null) != null;
-  return value != null;
-}
-
-function buildChatInboxFiltersParam({ description, worldIdProperty } = {}) {
-  return objectParam({
-    description,
-    additionalProperties: false,
-    properties: {
-      direction: stringParam({
-        description: 'Filter from the current account perspective.',
-        enumValues: CHAT_INBOX_FILTER_DIRECTIONS,
-        examples: ['outbound'],
-      }),
-      mode: stringParam({
-        description: 'Filter to direct or world-scoped chat items.',
-        enumValues: CHAT_INBOX_FILTER_MODES,
-        examples: ['world'],
-      }),
-      status: stringParam({
-        description: 'Filter to pending or terminal requests, or to chats by current status.',
-        enumValues: CHAT_INBOX_FILTER_STATUSES,
-        examples: ['active'],
-      }),
-      worldId: worldIdProperty,
-      chatRequestId: stringParam({
-        description: 'Filter to one canonical chat request id.',
-        minLength: 1,
-        examples: ['req_demo_1'],
-      }),
-      conversationKey: stringParam({
-        description: 'Filter to one canonical conversation key.',
-        minLength: 1,
-        examples: ['pair:agt_alice::agt_moza:world:dating-demo-world'],
-      }),
-      localSessionKey: stringParam({
-        description: 'Filter to one local Claworld session reference for internal tracking, summaries, or orchestration only. Not a transport address for sending a user message to the peer.',
-        minLength: 1,
-        examples: ['conversation:pair:agt_alice::agt_moza:world:dating-demo-world'],
-      }),
-      counterpartyAgentId: stringParam({
-        description: 'Filter to one counterparty agentId.',
-        minLength: 1,
-        examples: ['agt_alice'],
-      }),
-    },
-  });
-}
-
-function validateChatInboxFilterInput(filters = {}, action) {
-  const source = normalizeObject(filters, {}) || {};
-  for (const key of Object.keys(source)) {
-    if (CHAT_INBOX_FILTER_KEY_SET.has(key)) continue;
-    requireManageWorldField(`filters.${key}`, `filters.${key} is not supported for action=${action}`);
-  }
-  return source;
-}
-
-function normalizeManageConversationInboxQuery(params = {}, action) {
-  const normalizedAction = normalizeTerminalConversationAction(action, 'list_related');
-  const filters = validateChatInboxFilterInput(params.filters, normalizedAction);
-
-  const requestOnlyField = MANAGE_CONVERSATION_REQUEST_ONLY_QUERY_FIELDS.find((fieldId) => hasProvidedToolParam(params, fieldId));
-  if (requestOnlyField) {
-    requireManageWorldField(requestOnlyField, `${requestOnlyField} is only supported for action=request`);
-  }
-  if (hasProvidedToolParam(params, 'limit')) {
-    requireManageWorldField('limit', `limit is not supported for action=${normalizedAction}`);
-  }
-
-  const filterOnlyField = MANAGE_CONVERSATION_FILTER_ONLY_TOP_LEVEL_FIELDS.find((fieldId) => hasProvidedToolParam(params, fieldId));
-  if (filterOnlyField) {
-    requireManageWorldField(
-      filterOnlyField,
-      `${filterOnlyField} must be passed as filters.${filterOnlyField} for action=${normalizedAction}`,
-    );
-  }
-
-  if (normalizedAction !== 'get_state') {
-    const getStateOnlyField = MANAGE_CONVERSATION_GET_STATE_TARGET_FIELDS.find((fieldId) => hasProvidedToolParam(params, fieldId));
-    if (getStateOnlyField) {
-      requireManageWorldField(
-        getStateOnlyField,
-        `${getStateOnlyField} must be passed as filters.${getStateOnlyField} for action=${normalizedAction}`,
-      );
-    }
-  }
-
-  const mergedFilters = {
-    ...filters,
-    ...(!Object.prototype.hasOwnProperty.call(filters, 'direction') && hasProvidedToolParam(params, 'direction')
-      ? { direction: params.direction }
-      : {}),
-    ...(normalizedAction === 'get_state'
-      ? Object.fromEntries(
-          MANAGE_CONVERSATION_GET_STATE_TARGET_FIELDS
-            .filter((fieldId) => (
-              !Object.prototype.hasOwnProperty.call(filters, fieldId)
-              && hasProvidedToolParam(params, fieldId)
-            ))
-            .map((fieldId) => [fieldId, params[fieldId]]),
-        )
-      : {}),
-  };
-  return normalizeChatInboxListFiltersInput({ filters: mergedFilters });
-}
-
 function parseToolResultPayload(result = null) {
   const text = result?.content?.[0]?.text;
   if (typeof text !== 'string') return null;
@@ -1062,27 +924,10 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
           agentCode: stringParam({ description: 'Target public agent code for request.', minLength: 1 }),
           openingMessage: stringParam({ description: 'Request/re-engagement kickoff message.', minLength: 1 }),
           worldId: worldIdProperty,
-          direction: stringParam({
-            description: 'Top-level alias for filters.direction on action=list_related/get_state.',
-            enumValues: CHAT_INBOX_FILTER_DIRECTIONS,
-            examples: ['outbound'],
-          }),
-          filters: buildChatInboxFiltersParam({
-            description: 'Inbox filters for action=list_related/get_state.',
-            worldIdProperty,
-          }),
-          chatRequestId: stringParam({
-            description: 'Request id for action=accept/reject, or a top-level get_state convenience target that normalizes to filters.chatRequestId.',
-            minLength: 1,
-          }),
-          conversationKey: stringParam({
-            description: 'Conversation key for action=close, or a top-level get_state convenience target that normalizes to filters.conversationKey.',
-            minLength: 1,
-          }),
-          localSessionKey: stringParam({
-            description: 'Local conversation session key for action=close, or a top-level get_state convenience target that normalizes to filters.localSessionKey.',
-            minLength: 1,
-          }),
+          filters: objectParam({ description: 'List filters.', additionalProperties: true }),
+          chatRequestId: stringParam({ description: 'Request id for accept/reject.', minLength: 1 }),
+          conversationKey: stringParam({ description: 'Conversation key for get_state/close.', minLength: 1 }),
+          localSessionKey: stringParam({ description: 'Local conversation session key for get_state/close.', minLength: 1 }),
         },
       }),
       async execute(toolCallId, params = {}) {
@@ -1094,19 +939,10 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
           });
           return rewriteToolResultName(result, manageConversationsTool, action);
         }
-        if (action === 'list_related' || action === 'get_state') {
-          const filters = normalizeManageConversationInboxQuery(params, action);
-          const result = await requireTerminalTool(internalTools, 'claworld_chat_inbox').execute(toolCallId, {
-            ...params,
-            action: 'list',
-            ...(Object.keys(filters).length > 0 ? { filters } : {}),
-          });
-          return rewriteToolResultName(result, manageConversationsTool, action);
-        }
-        if (action === 'accept' || action === 'reject') {
+        if (['list_related', 'get_state', 'accept', 'reject'].includes(action)) {
           const result = await requireTerminalTool(internalTools, 'claworld_chat_inbox').execute(toolCallId, {
             ...params,
-            action,
+            action: ['list_related', 'get_state'].includes(action) ? 'list' : action,
           });
           return rewriteToolResultName(result, manageConversationsTool, action);
         }
@@ -1854,10 +1690,45 @@ function buildRegisteredTools(api, plugin) {
             examples: ['list', 'accept', 'reject'],
           }),
           filters: objectParam({
-            ...buildChatInboxFiltersParam({
-              description: 'Optional list filters for query mode. Omit to review the full inbox across inbound and outbound items.',
-              worldIdProperty,
-            }),
+            description: 'Optional list filters for query mode. Omit to review the full inbox across inbound and outbound items.',
+            properties: {
+              direction: stringParam({
+                description: 'Filter from the current account perspective.',
+                enumValues: CHAT_INBOX_FILTER_DIRECTIONS,
+                examples: ['outbound'],
+              }),
+              mode: stringParam({
+                description: 'Filter to direct or world-scoped chat items.',
+                enumValues: CHAT_INBOX_FILTER_MODES,
+                examples: ['world'],
+              }),
+              status: stringParam({
+                description: 'Filter to pending or terminal requests, or to chats by current status.',
+                enumValues: CHAT_INBOX_FILTER_STATUSES,
+                examples: ['active'],
+              }),
+              worldId: worldIdProperty,
+              chatRequestId: stringParam({
+                description: 'Filter to one canonical chat request id.',
+                minLength: 1,
+                examples: ['req_demo_1'],
+              }),
+              conversationKey: stringParam({
+                description: 'Filter to one canonical conversation key.',
+                minLength: 1,
+                examples: ['pair:agt_alice::agt_moza:world:dating-demo-world'],
+              }),
+              localSessionKey: stringParam({
+                description: 'Filter to one local Claworld session reference for internal tracking, summaries, or orchestration only. Not a transport address for sending a user message to the peer.',
+                minLength: 1,
+                examples: ['conversation:pair:agt_alice::agt_moza:world:dating-demo-world'],
+              }),
+              counterpartyAgentId: stringParam({
+                description: 'Filter to one counterparty agentId.',
+                minLength: 1,
+                examples: ['agt_alice'],
+              }),
+            },
           }),
           chatRequestId: stringParam({
             description: 'Canonical chat request id returned by claworld_chat_inbox pendingRequests. Required for action=accept or action=reject.',
@@ -2097,7 +1968,16 @@ function buildRegisteredTools(api, plugin) {
           expiresInSeconds: params.expiresInSeconds ?? null,
         });
         const pairedAgentId = identityPayload?.agentId || runtimeConfig.relay?.agentId || null;
-        const relayAgent = pairedAgentId
+        const pairedRuntimeConfig = pairedAgentId
+          ? {
+            ...runtimeConfig,
+            relay: {
+              ...(runtimeConfig.relay && typeof runtimeConfig.relay === 'object' ? runtimeConfig.relay : {}),
+              agentId: pairedAgentId,
+            },
+          }
+          : runtimeConfig;
+        const relayAgentFallback = pairedAgentId
           ? {
             agentId: pairedAgentId,
             displayName: normalizeText(
@@ -2118,6 +1998,23 @@ function buildRegisteredTools(api, plugin) {
           || runtimeConfig.relay?.appToken
           || runtimeConfig.relay?.credentialToken,
         );
+        let relayAgent = relayAgentFallback;
+        if (hasConfiguredAppToken && pairedAgentId && typeof plugin.helpers?.pairing?.resolveAgentIdentity === 'function') {
+          const resolvedRelayAgent = await plugin.helpers.pairing.resolveAgentIdentity({
+            cfg,
+            accountId,
+            runtimeConfig: pairedRuntimeConfig,
+            agentId: pairedAgentId,
+          });
+          if (resolvedRelayAgent && typeof resolvedRelayAgent === 'object') {
+            relayAgent = {
+              ...relayAgentFallback,
+              ...resolvedRelayAgent,
+              agentId: normalizeText(resolvedRelayAgent.agentId, pairedAgentId),
+              displayName: normalizeText(resolvedRelayAgent.displayName, relayAgentFallback?.displayName ?? null),
+            };
+          }
+        }
         const pairingPayload = {
           status: hasConfiguredAppToken ? 'paired' : 'unpaired',
           reason: hasConfiguredAppToken
@@ -2126,15 +2023,7 @@ function buildRegisteredTools(api, plugin) {
           bindingSource: hasConfiguredAppToken
             ? 'configured_app_token'
             : (runtimeConfig.registration?.enabled === true ? 'registration_pending' : 'unbound'),
-          runtimeConfig: pairedAgentId
-            ? {
-              ...runtimeConfig,
-              relay: {
-                ...(runtimeConfig.relay && typeof runtimeConfig.relay === 'object' ? runtimeConfig.relay : {}),
-                agentId: pairedAgentId,
-              },
-            }
-            : runtimeConfig,
+          runtimeConfig: pairedRuntimeConfig,
           relayAgent,
         };
         return buildToolResult(projectToolAccountViewResponse({