@xfxstudio/claworld 2026.4.22-testing.5 → 2026.4.22-testing.7

package/src/openclaw/runtime/tool-contracts.js

@@ -102,15 +102,42 @@ function projectOrchestration(orchestration = null) {
 
 function projectToolAction(action = null) {
   if (!action || typeof action !== 'object' || Array.isArray(action)) return null;
+  const tool = normalizeText(action.tool, null);
+  const payload = action.payload && typeof action.payload === 'object' && !Array.isArray(action.payload)
+    ? action.payload
+    : {};
+  const payloadTemplate = action.payloadTemplate && typeof action.payloadTemplate === 'object' && !Array.isArray(action.payloadTemplate)
+    ? action.payloadTemplate
+    : {};
+  if (tool === 'claworld_join_world') {
+    return {
+      tool: 'claworld_manage_worlds',
+      summary: normalizeText(action.summary, null),
+      payload: { ...payload, action: 'join_world' },
+      payloadTemplate: { ...payloadTemplate, action: 'join_world' },
+    };
+  }
+  if (tool === 'claworld_get_world_detail') {
+    return {
+      tool: 'claworld_manage_worlds',
+      summary: normalizeText(action.summary, null),
+      payload: { ...payload, action: 'get_world' },
+      payloadTemplate: { ...payloadTemplate, action: 'get_world' },
+    };
+  }
+  if (tool === 'claworld_search_world_members') {
+    return {
+      tool: 'claworld_search',
+      summary: normalizeText(action.summary, null),
+      payload: { ...payload, scope: 'world_members' },
+      payloadTemplate: { ...payloadTemplate, scope: 'world_members' },
+    };
+  }
   return {
-    tool: normalizeText(action.tool, null),
+    tool,
     summary: normalizeText(action.summary, null),
-    payload: action.payload && typeof action.payload === 'object' && !Array.isArray(action.payload)
-      ? action.payload
-      : {},
-    payloadTemplate: action.payloadTemplate && typeof action.payloadTemplate === 'object' && !Array.isArray(action.payloadTemplate)
-      ? action.payloadTemplate
-      : {},
+    payload,
+    payloadTemplate,
   };
 }
 
@@ -118,7 +145,7 @@ function projectRequestChatPayload(
   requestChat = null,
   {
     accountId = null,
-    requestToolName = 'claworld_request_chat',
+    requestToolName = 'claworld_manage_conversations',
   } = {},
 ) {
   if (!requestChat || typeof requestChat !== 'object' || Array.isArray(requestChat)) return null;
@@ -136,6 +163,7 @@ function projectRequestChatPayload(
     requestTool: normalizeText(requestToolName, null),
     requestPayload: {
       ...(normalizedAccountId ? { accountId: normalizedAccountId } : {}),
+      action: 'request',
       worldId,
       displayName,
       agentCode,
@@ -147,7 +175,7 @@ function projectRequestChatAction(
   requestChatAction = null,
   {
     accountId = null,
-    requestToolName = 'claworld_request_chat',
+    requestToolName = 'claworld_manage_conversations',
   } = {},
 ) {
   if (!requestChatAction || typeof requestChatAction !== 'object' || Array.isArray(requestChatAction)) return null;
@@ -163,6 +191,7 @@ function projectRequestChatAction(
     requestTool: normalizeText(requestToolName, null),
     requestPayloadTemplate: {
       ...(normalizedAccountId ? { accountId: normalizedAccountId } : {}),
+      action: 'request',
       worldId,
       displayName: ':displayName',
       agentCode: ':agentCode',
@@ -176,7 +205,7 @@ function projectToolCandidateDeliverySummary(
   candidateDelivery = {},
   {
     accountId = null,
-    requestToolName = 'claworld_request_chat',
+    requestToolName = 'claworld_manage_conversations',
   } = {},
 ) {
   if (!candidateDelivery || typeof candidateDelivery !== 'object' || Array.isArray(candidateDelivery)) return null;
@@ -313,12 +342,16 @@ export function projectToolWorldDetail(worldDetail = {}, { accountId = null } =
     worldRole: projectWorldRole(worldDetail.worldRole, null),
     enabled: normalizeOptionalBoolean(worldDetail.management?.enabled, normalizeOptionalBoolean(worldDetail.enabled, null)),
     status: normalizeText(worldDetail.management?.status, normalizeText(worldDetail.statusLabel, null)),
+    broadcast: projectToolBroadcastConfig(
+      worldDetail.management?.broadcast || worldDetail.broadcast || worldDetail.world?.broadcast,
+    ),
     participantContextField: projectParticipantContextField(worldDetail.participantContextField),
     memberSearchAction: {
-      tool: 'claworld_search_world_members',
+      tool: 'claworld_search',
       summary: 'After joining this world, search joined members by profile match or likes.',
       payloadTemplate: {
         ...(normalizeText(accountId, null) ? { accountId: normalizeText(accountId, null) } : {}),
+        scope: 'world_members',
         worldId: worldDetail.worldId,
         query: ':query',
       },
@@ -458,7 +491,7 @@ function projectToolCandidateFlowResponse(payload = {}, { accountId = null } = {
     worldId: normalizeText(worldId, normalizeText(projectedDelivery?.worldId, null)),
     nextAction: normalizeText(nextAction, normalizeText(projectedFeed?.nextAction, normalizeText(projectedDelivery?.nextAction, null))),
     candidateFeed: projectedFeed,
-    requestChatTool: 'claworld_request_chat',
+    requestChatTool: 'claworld_manage_conversations',
     candidateDelivery: projectedDelivery,
     requestChatAction: projectedRequestChatAction,
   };
@@ -479,15 +512,25 @@ export function projectToolCandidateFeedResponse(candidateFeedPayload = {}, { ac
   };
 }
 
+
+function projectToolJoinAction(action = null, { accountId = null, requestToolName = null } = {}) {
+  if (!action || typeof action !== 'object' || Array.isArray(action)) return null;
+  const normalizedAccountId = normalizeText(accountId, null);
+  const requestTool = normalizeText(requestToolName, null);
+  return {
+    ...action,
+    ...(normalizedAccountId ? { accountId: normalizedAccountId } : {}),
+    ...(requestTool ? { requestTool } : {}),
+  };
+}
+
 export function projectToolJoinWorldResponse(
   joinResult = {},
   { accountId = null } = {},
 ) {
-  const candidateFlow = projectToolCandidateFlowResponse(joinResult, { accountId });
-
   return {
     status: joinResult.membershipStatus === 'active' ? 'joined' : 'accepted',
-    worldId: normalizeText(joinResult.worldId, candidateFlow.worldId),
+    worldId: normalizeText(joinResult.worldId, null),
     accountId: normalizeText(accountId, null),
     worldRole: projectWorldRole(joinResult.worldRole, null),
     membershipStatus: joinResult.membershipStatus || 'unknown',
@@ -495,11 +538,14 @@ export function projectToolJoinWorldResponse(
       joinResult.participantContextText,
       joinResult.membership?.participantContextText || null,
     ),
-    nextAction: normalizeText(joinResult.nextAction, 'review_candidate_feed'),
-    candidateFeed: candidateFlow.candidateFeed,
-    requestChatTool: candidateFlow.requestChatTool,
-    candidateDelivery: candidateFlow.candidateDelivery,
-    requestChatAction: candidateFlow.requestChatAction,
+    nextAction: normalizeText(joinResult.nextAction, 'search_world_members_or_view_activity'),
+    memberSearchAction: projectToolJoinAction(joinResult.memberSearchAction, { accountId }),
+    worldActivityAction: projectToolJoinAction(joinResult.worldActivityAction, { accountId }),
+    subscribeWorldAction: projectToolJoinAction(joinResult.subscribeWorldAction, { accountId }),
+    requestChatAction: projectToolJoinAction(joinResult.requestChatAction, {
+      accountId,
+      requestToolName: 'claworld_manage_conversations',
+    }),
     orchestration: projectOrchestration(joinResult.orchestration),
   };
 }
@@ -589,7 +635,12 @@ function projectToolWorldBroadcastFailureItem(item = {}) {
 export function projectToolWorldBroadcastResponse(payload = {}, { accountId = null } = {}) {
   return {
     accountId: normalizeText(accountId, null),
+    accepted: payload.accepted === true,
     status: normalizeText(payload.status, null),
+    commandId: normalizeText(payload.commandId, null),
+    command: payload.command && typeof payload.command === 'object' && !Array.isArray(payload.command)
+      ? payload.command
+      : null,
     worldId: normalizeText(payload.worldId, null),
     senderAgentId: normalizeText(payload.senderAgentId, null),
     senderRole: projectWorldRole(payload.senderRole, null),
@@ -597,6 +648,7 @@ export function projectToolWorldBroadcastResponse(payload = {}, { accountId = nu
     excludeSelf: normalizeOptionalBoolean(payload.excludeSelf, null),
     eligibility: normalizeText(payload.eligibility, null),
     broadcastId: normalizeText(payload.broadcastId, null),
+    fanoutStatus: normalizeText(payload.fanoutStatus, null),
     totalTargets: normalizeOptionalInteger(payload.totalTargets, null),
     createdCount: normalizeOptionalInteger(payload.createdCount, null),
     failedCount: normalizeOptionalInteger(payload.failedCount, null),

package/src/openclaw/runtime/tool-inventory.js

@@ -1,37 +1,31 @@
-export const CLAWORLD_TOOL_CONTRACT_VERSION = 'v1';
-
-export const CLAWORLD_CHAT_REQUEST_TOOL_NAMES = Object.freeze([
-  'claworld_request_chat',
-  'claworld_chat_inbox',
-]);
+export const CLAWORLD_TOOL_CONTRACT_VERSION = 'v2';
 
 export const CLAWORLD_ACCOUNT_TOOL_NAMES = Object.freeze([
-  'claworld_account',
+  'claworld_manage_account',
 ]);
 
-export const CLAWORLD_FEEDBACK_TOOL_NAMES = Object.freeze([
-  'claworld_submit_feedback',
+export const CLAWORLD_SEARCH_TOOL_NAMES = Object.freeze([
+  'claworld_search',
+  'claworld_get_public_profile',
 ]);
 
 export const CLAWORLD_WORLD_TOOL_NAMES = Object.freeze([
-  'claworld_search_worlds',
-  'claworld_list_worlds',
-  'claworld_get_world_detail',
-  'claworld_join_world',
-  'claworld_search_world_members',
-  'claworld_get_candidate_feed',
+  'claworld_manage_worlds',
 ]);
 
-export const CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES = Object.freeze([
-  'claworld_create_world',
-  'claworld_manage_world',
+export const CLAWORLD_CONVERSATION_TOOL_NAMES = Object.freeze([
+  'claworld_manage_conversations',
+]);
+
+export const CLAWORLD_FEEDBACK_TOOL_NAMES = Object.freeze([
+  'claworld_submit_feedback',
 ]);
 
 export const CLAWORLD_REGISTERED_TOOL_NAMES = Object.freeze([
   ...CLAWORLD_ACCOUNT_TOOL_NAMES,
+  ...CLAWORLD_SEARCH_TOOL_NAMES,
   ...CLAWORLD_WORLD_TOOL_NAMES,
-  ...CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES,
-  ...CLAWORLD_CHAT_REQUEST_TOOL_NAMES,
+  ...CLAWORLD_CONVERSATION_TOOL_NAMES,
   ...CLAWORLD_FEEDBACK_TOOL_NAMES,
 ]);
 
@@ -39,6 +33,20 @@ export const CLAWORLD_PUBLIC_TOOL_NAMES = Object.freeze([
   ...CLAWORLD_REGISTERED_TOOL_NAMES,
 ]);
 
+export const CLAWORLD_RETIRED_PUBLIC_TOOL_NAMES = Object.freeze([
+  'claworld_account',
+  'claworld_search_worlds',
+  'claworld_list_worlds',
+  'claworld_get_world_detail',
+  'claworld_join_world',
+  'claworld_search_world_members',
+  'claworld_get_candidate_feed',
+  'claworld_create_world',
+  'claworld_manage_world',
+  'claworld_request_chat',
+  'claworld_chat_inbox',
+]);
+
 export const CLAWORLD_MINIMAL_OPENCLAW_TOOL_NAMES = Object.freeze([
   'session_status',
 ]);
@@ -52,11 +60,7 @@ export const CLAWORLD_READ_ONLY_OPENCLAW_TOOL_NAMES = Object.freeze([
 ]);
 
 export const CLAWORLD_PLUGIN_SMOKE_REQUIRED_TOOL_NAMES = Object.freeze([
-  ...CLAWORLD_ACCOUNT_TOOL_NAMES,
-  ...CLAWORLD_WORLD_TOOL_NAMES,
-  ...CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES,
-  ...CLAWORLD_CHAT_REQUEST_TOOL_NAMES,
-  ...CLAWORLD_FEEDBACK_TOOL_NAMES,
+  ...CLAWORLD_REGISTERED_TOOL_NAMES,
 ]);
 
 export const CLAWORLD_TOOL_PROFILES = Object.freeze({