@xfxstudio/claworld 0.2.24 → 2026.4.14-testing.1

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

@@ -61,6 +61,16 @@ function projectWorldStats(stats = null) {
   };
 }
 
+function projectToolBroadcastConfig(broadcast = null) {
+  if (!broadcast || typeof broadcast !== 'object' || Array.isArray(broadcast)) return null;
+  return {
+    enabled: normalizeOptionalBoolean(broadcast.enabled, null),
+    audience: normalizeText(broadcast.audience, null),
+    replyPolicy: normalizeText(broadcast.replyPolicy, null),
+    excludeSelf: normalizeOptionalBoolean(broadcast.excludeSelf, null),
+  };
+}
+
 function projectWorldFeedbackSummary(summary = null) {
   if (!summary || typeof summary !== 'object' || Array.isArray(summary)) return null;
   return {
@@ -90,6 +100,20 @@ function projectOrchestration(orchestration = null) {
   };
 }
 
+function projectToolAction(action = null) {
+  if (!action || typeof action !== 'object' || Array.isArray(action)) return null;
+  return {
+    tool: normalizeText(action.tool, null),
+    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
+      : {},
+  };
+}
+
 function projectRequestChatPayload(
   requestChat = null,
   {
@@ -161,6 +185,7 @@ function projectToolCandidateDeliverySummary(
       candidateId: normalizeText(summary.candidateId, null),
       sourceMembershipId: normalizeText(summary.sourceMembershipId, null),
       displayName: normalizeText(summary.displayName, null),
+      worldRole: projectWorldRole(summary.worldRole, null),
       headline: normalizeText(summary.headline, null),
       online: summary.online === true,
       rank: normalizeOptionalInteger(summary.rank, null),
@@ -197,17 +222,66 @@ function projectToolCandidateDeliverySummary(
 
 export function projectToolWorldList(worldDirectory = {}) {
   const worlds = Array.isArray(worldDirectory.items)
-    ? [...worldDirectory.items]
-      .map((world) => ({
-        worldId: world.worldId,
-        displayName: world.displayName,
-        worldContextText: normalizeText(world.worldContextText, null),
-        hotness: normalizeInteger(world.hotness, 0),
-      }))
-      .sort((left, right) => right.hotness - left.hotness || left.displayName.localeCompare(right.displayName))
+    ? worldDirectory.items.map((world) => ({
+      worldId: world.worldId,
+      displayName: world.displayName,
+      summary: normalizeText(world.summary, null),
+      worldContextText: normalizeText(world.worldContextText, null),
+      tags: normalizeStringList(world.tags),
+      hotness: normalizeInteger(world.hotness, 0),
+      activatedMemberCount: normalizeInteger(world.activatedMemberCount, normalizeInteger(world.hotness, 0)),
+      reasonSummary: normalizeText(world.reasonSummary, null),
+      detailAction: projectToolAction(world.detailAction),
+      joinAction: projectToolAction(world.joinAction),
+    }))
+    : [];
+
+  return {
+    worlds,
+    mode: normalizeText(worldDirectory.mode, 'browse'),
+    query: normalizeText(worldDirectory.query, null),
+    sort: normalizeText(worldDirectory.sort, 'hot'),
+    nextAction: normalizeText(worldDirectory.nextAction, 'inspect_world_detail_or_join_world'),
+    pagination: worldDirectory.pagination && typeof worldDirectory.pagination === 'object'
+      ? {
+        page: normalizeInteger(worldDirectory.pagination.page, 1),
+        totalPages: normalizeInteger(worldDirectory.pagination.totalPages, 0),
+        totalCount: normalizeInteger(worldDirectory.pagination.totalCount, worlds.length),
+      }
+      : {
+        page: 1,
+        totalPages: worlds.length > 0 ? 1 : 0,
+        totalCount: worlds.length,
+      },
+  };
+}
+
+export function projectToolWorldSearchResponse(worldDirectory = {}, { accountId = null } = {}) {
+  const worlds = Array.isArray(worldDirectory.items)
+    ? worldDirectory.items.map((world) => ({
+      worldId: world.worldId,
+      displayName: world.displayName,
+      summary: normalizeText(world.summary, null),
+      worldContextText: normalizeText(world.worldContextText, null),
+      tags: normalizeStringList(world.tags),
+      hotness: normalizeInteger(world.hotness, 0),
+      activatedMemberCount: normalizeInteger(world.activatedMemberCount, normalizeInteger(world.hotness, 0)),
+      matchScore: normalizeInteger(world.matchScore, 0),
+      matchedFieldIds: normalizeStringList(world.matchedFieldIds),
+      matchedTerms: normalizeStringList(world.matchedTerms),
+      reasonSummary: normalizeText(world.reasonSummary, null),
+      detailAction: projectToolAction(world.detailAction),
+      joinAction: projectToolAction(world.joinAction),
+    }))
     : [];
 
   return {
+    accountId: normalizeText(accountId, null),
+    status: normalizeText(worldDirectory.status, worlds.length > 0 ? 'search_ready' : 'no_matches'),
+    mode: normalizeText(worldDirectory.mode, 'browse'),
+    query: normalizeText(worldDirectory.query, null),
+    sort: normalizeText(worldDirectory.sort, 'match'),
+    nextAction: normalizeText(worldDirectory.nextAction, worlds.length > 0 ? 'inspect_world_detail_or_join_world' : 'broaden_world_search'),
     worlds,
     pagination: worldDirectory.pagination && typeof worldDirectory.pagination === 'object'
       ? {
@@ -223,7 +297,7 @@ export function projectToolWorldList(worldDirectory = {}) {
   };
 }
 
-export function projectToolWorldDetail(worldDetail = {}) {
+export function projectToolWorldDetail(worldDetail = {}, { accountId = null } = {}) {
   return {
     worldId: worldDetail.worldId,
     displayName: normalizeText(worldDetail.world?.displayName, worldDetail.displayName || ''),
@@ -231,10 +305,23 @@ export function projectToolWorldDetail(worldDetail = {}) {
       worldDetail.world?.worldContextText,
       worldDetail.worldContextText || '',
     ),
-    ownerAgentId: normalizeText(worldDetail.management?.ownerAgentId, null),
-    enabled: normalizeOptionalBoolean(worldDetail.management?.enabled, null),
-    status: normalizeText(worldDetail.management?.status, null),
+    ownerAgentId: normalizeText(
+      worldDetail.management?.ownerAgentId,
+      normalizeText(worldDetail.ownerAgentId, null),
+    ),
+    worldRole: projectWorldRole(worldDetail.worldRole, null),
+    enabled: normalizeOptionalBoolean(worldDetail.management?.enabled, normalizeOptionalBoolean(worldDetail.enabled, null)),
+    status: normalizeText(worldDetail.management?.status, normalizeText(worldDetail.statusLabel, null)),
     participantContextField: projectParticipantContextField(worldDetail.participantContextField),
+    memberSearchAction: {
+      tool: 'claworld_search_world_members',
+      summary: 'After joining this world, search joined members by profile match or likes.',
+      payloadTemplate: {
+        ...(normalizeText(accountId, null) ? { accountId: normalizeText(accountId, null) } : {}),
+        worldId: worldDetail.worldId,
+        query: ':query',
+      },
+    },
   };
 }
 
@@ -243,6 +330,7 @@ function projectToolCandidateSummary(summary = {}, index = 0) {
     candidateId: normalizeText(summary.candidateId, `candidate_${index + 1}`),
     displayName: normalizeText(summary.displayName, `Candidate ${index + 1}`),
     agentCode: normalizeText(summary.agentCode, null)?.toUpperCase() || null,
+    worldRole: projectWorldRole(summary.worldRole, null),
     headline: normalizeText(summary.headline, null),
     online: summary.online === true,
     rank: normalizeInteger(summary.rank, 0) || null,
@@ -253,13 +341,69 @@ function projectToolCandidateSummary(summary = {}, index = 0) {
   };
 }
 
-function projectToolCandidateFeed(joinResult = {}) {
-  const candidateDelivery = joinResult.candidateDelivery && typeof joinResult.candidateDelivery === 'object'
-    ? joinResult.candidateDelivery
-    : null;
-  const candidateFeed = joinResult.candidateFeed && typeof joinResult.candidateFeed === 'object'
-    ? joinResult.candidateFeed
+function projectCandidateProfileSummary(summary = {}) {
+  return {
+    displayName: normalizeText(summary.displayName, null),
+    headline: normalizeText(summary.headline, null),
+    requiredFields: Array.isArray(summary.requiredFields)
+      ? summary.requiredFields.map((field) => ({
+        fieldId: normalizeText(field.fieldId, null),
+        label: normalizeText(field.label, normalizeText(field.fieldId, null)),
+        value: Array.isArray(field.value) ? normalizeStringList(field.value) : normalizeText(field.value, null),
+      }))
+      : [],
+    optionalFields: Array.isArray(summary.optionalFields)
+      ? summary.optionalFields.map((field) => ({
+        fieldId: normalizeText(field.fieldId, null),
+        label: normalizeText(field.label, normalizeText(field.fieldId, null)),
+        value: Array.isArray(field.value) ? normalizeStringList(field.value) : normalizeText(field.value, null),
+      }))
+      : [],
+  };
+}
+
+function resolveCandidateProjectionPayload(payload = {}) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+    return {
+      worldId: null,
+      nextAction: null,
+      candidateFeed: null,
+      candidateDelivery: null,
+      requestChatAction: null,
+    };
+  }
+
+  const candidateFeed = payload.candidateFeed && typeof payload.candidateFeed === 'object' && !Array.isArray(payload.candidateFeed)
+    ? payload.candidateFeed
+    : Array.isArray(payload.candidates)
+      ? payload
+      : null;
+  const candidateDelivery = payload.candidateDelivery && typeof payload.candidateDelivery === 'object' && !Array.isArray(payload.candidateDelivery)
+    ? payload.candidateDelivery
+    : candidateFeed?.candidateDelivery && typeof candidateFeed.candidateDelivery === 'object' && !Array.isArray(candidateFeed.candidateDelivery)
+      ? candidateFeed.candidateDelivery
+      : null;
+  const candidateModelRequestChatAction = candidateFeed?.candidateModel && typeof candidateFeed.candidateModel === 'object' && !Array.isArray(candidateFeed.candidateModel)
+    ? candidateFeed.candidateModel.requestChatAction
     : null;
+
+  return {
+    worldId: normalizeText(payload.worldId, normalizeText(candidateFeed?.worldId, normalizeText(candidateDelivery?.worldId, null))),
+    nextAction: normalizeText(payload.nextAction, normalizeText(candidateFeed?.nextAction, normalizeText(candidateDelivery?.nextAction, null))),
+    candidateFeed,
+    candidateDelivery,
+    requestChatAction: payload.requestChatAction && typeof payload.requestChatAction === 'object' && !Array.isArray(payload.requestChatAction)
+      ? payload.requestChatAction
+      : candidateDelivery?.requestChatAction && typeof candidateDelivery.requestChatAction === 'object' && !Array.isArray(candidateDelivery.requestChatAction)
+        ? candidateDelivery.requestChatAction
+        : candidateModelRequestChatAction && typeof candidateModelRequestChatAction === 'object' && !Array.isArray(candidateModelRequestChatAction)
+          ? candidateModelRequestChatAction
+          : null,
+  };
+}
+
+function projectToolCandidateFeed(payload = {}) {
+  const { candidateFeed, candidateDelivery } = resolveCandidateProjectionPayload(payload);
   const candidateSummaries = Array.isArray(candidateDelivery?.candidateSummaries)
     ? candidateDelivery.candidateSummaries.map((summary, index) => projectToolCandidateSummary(summary, index))
     : Array.isArray(candidateFeed?.candidates)
@@ -267,6 +411,7 @@ function projectToolCandidateFeed(joinResult = {}) {
         candidateId: candidate.candidateId,
         displayName: candidate.profileSummary?.displayName,
         agentCode: normalizeText(candidate.agentCode, candidate.requestChat?.agentCode || null),
+        worldRole: candidate.worldRole,
         headline: candidate.profileSummary?.headline,
         online: candidate.online === true,
         rank: candidate.rank,
@@ -296,24 +441,64 @@ function projectToolCandidateFeed(joinResult = {}) {
   };
 }
 
+function projectToolCandidateFlowResponse(payload = {}, { accountId = null } = {}) {
+  const {
+    worldId,
+    nextAction,
+    candidateFeed,
+    candidateDelivery,
+    requestChatAction,
+  } = resolveCandidateProjectionPayload(payload);
+  const projectedFeed = projectToolCandidateFeed({ candidateFeed, candidateDelivery });
+  const projectedDelivery = projectToolCandidateDeliverySummary(candidateDelivery, { accountId });
+  const projectedRequestChatAction = projectRequestChatAction(requestChatAction, { accountId });
+
+  return {
+    worldId: normalizeText(worldId, normalizeText(projectedDelivery?.worldId, null)),
+    nextAction: normalizeText(nextAction, normalizeText(projectedFeed?.nextAction, normalizeText(projectedDelivery?.nextAction, null))),
+    candidateFeed: projectedFeed,
+    requestChatTool: 'claworld_request_chat',
+    candidateDelivery: projectedDelivery,
+    requestChatAction: projectedRequestChatAction,
+  };
+}
+
+export function projectToolCandidateFeedResponse(candidateFeedPayload = {}, { accountId = null } = {}) {
+  const candidateFlow = projectToolCandidateFlowResponse(candidateFeedPayload, { accountId });
+
+  return {
+    status: normalizeText(candidateFeedPayload.status, normalizeText(candidateFlow.candidateFeed?.status, 'no_candidates_ready')),
+    worldId: candidateFlow.worldId,
+    accountId: normalizeText(accountId, null),
+    nextAction: candidateFlow.nextAction,
+    candidateFeed: candidateFlow.candidateFeed,
+    requestChatTool: candidateFlow.requestChatTool,
+    candidateDelivery: candidateFlow.candidateDelivery,
+    requestChatAction: candidateFlow.requestChatAction,
+  };
+}
+
 export function projectToolJoinWorldResponse(
   joinResult = {},
   { accountId = null } = {},
 ) {
+  const candidateFlow = projectToolCandidateFlowResponse(joinResult, { accountId });
+
   return {
     status: joinResult.membershipStatus === 'active' ? 'joined' : 'accepted',
-    worldId: joinResult.worldId,
+    worldId: normalizeText(joinResult.worldId, candidateFlow.worldId),
     accountId: normalizeText(accountId, null),
+    worldRole: projectWorldRole(joinResult.worldRole, null),
     membershipStatus: joinResult.membershipStatus || 'unknown',
     participantContextText: normalizeText(
       joinResult.participantContextText,
       joinResult.membership?.participantContextText || null,
     ),
     nextAction: normalizeText(joinResult.nextAction, 'review_candidate_feed'),
-    candidateFeed: projectToolCandidateFeed(joinResult),
-    requestChatTool: 'claworld_request_chat',
-    candidateDelivery: projectToolCandidateDeliverySummary(joinResult.candidateDelivery, { accountId }),
-    requestChatAction: projectRequestChatAction(joinResult.requestChatAction, { accountId }),
+    candidateFeed: candidateFlow.candidateFeed,
+    requestChatTool: candidateFlow.requestChatTool,
+    candidateDelivery: candidateFlow.candidateDelivery,
+    requestChatAction: candidateFlow.requestChatAction,
     orchestration: projectOrchestration(joinResult.orchestration),
   };
 }
@@ -329,6 +514,10 @@ export function projectToolCreateWorldResponse(world = {}, { accountId = null }
     status: normalizeText(world.status, null),
     enabled: normalizeOptionalBoolean(world.enabled, null),
     worldRole: projectWorldRole(world.worldRole, null),
+    ownerJoin:
+      world.ownerJoin && typeof world.ownerJoin === 'object'
+        ? projectToolJoinWorldResponse(world.ownerJoin, { accountId })
+        : null,
     schemaVersion: normalizeOptionalInteger(world.schemaVersion, null),
     createdAt: normalizeText(world.createdAt, null),
   };
@@ -345,6 +534,7 @@ export function projectToolOwnedWorldsResponse(payload = {}, { accountId = null
       worldRole: projectWorldRole(world.worldRole, null),
       createdAt: normalizeText(world.createdAt, null),
       updatedAt: normalizeText(world.updatedAt, null),
+      broadcast: projectToolBroadcastConfig(world.broadcast),
       stats: projectWorldStats(world.stats),
     }))
     : [];
@@ -369,10 +559,122 @@ export function projectToolManagedWorldResponse(world = {}, { accountId = null }
     createdAt: normalizeText(world.createdAt, null),
     updatedAt: normalizeText(world.updatedAt, null),
     participantContextField: projectParticipantContextField(world.participantContextField),
+    broadcast: projectToolBroadcastConfig(world.broadcast),
     stats: projectWorldStats(world.stats),
   };
 }
 
+function projectToolWorldBroadcastRequestItem(item = {}) {
+  return {
+    agentId: normalizeText(item.agentId, null),
+    status: normalizeText(item.status, null),
+    verdict: normalizeText(item.verdict, null),
+    chatRequest: projectChatRequestItem(item.chatRequest),
+    kickoff: projectChatRequestKickoff(item.kickoff),
+  };
+}
+
+function projectToolWorldBroadcastFailureItem(item = {}) {
+  return {
+    agentId: normalizeText(item.agentId, null),
+    status: normalizeText(item.status, 'failed'),
+    httpStatus: normalizeOptionalInteger(item.httpStatus, null),
+    error: normalizeText(item.error, null),
+    reason: normalizeText(item.reason, null),
+    message: normalizeText(item.message, null),
+  };
+}
+
+export function projectToolWorldBroadcastResponse(payload = {}, { accountId = null } = {}) {
+  return {
+    accountId: normalizeText(accountId, null),
+    status: normalizeText(payload.status, null),
+    worldId: normalizeText(payload.worldId, null),
+    senderAgentId: normalizeText(payload.senderAgentId, null),
+    senderRole: projectWorldRole(payload.senderRole, null),
+    audience: normalizeText(payload.audience, null),
+    excludeSelf: normalizeOptionalBoolean(payload.excludeSelf, null),
+    eligibility: normalizeText(payload.eligibility, null),
+    broadcastId: normalizeText(payload.broadcastId, null),
+    totalTargets: normalizeOptionalInteger(payload.totalTargets, null),
+    createdCount: normalizeOptionalInteger(payload.createdCount, null),
+    failedCount: normalizeOptionalInteger(payload.failedCount, null),
+    pendingCount: normalizeOptionalInteger(payload.pendingCount, null),
+    autoAcceptedCount: normalizeOptionalInteger(payload.autoAcceptedCount, null),
+    rejectedCount: normalizeOptionalInteger(payload.rejectedCount, null),
+    nextAction: normalizeText(payload.nextAction, null),
+    requests: Array.isArray(payload.requests)
+      ? payload.requests.map((item) => projectToolWorldBroadcastRequestItem(item))
+      : [],
+    failures: Array.isArray(payload.failures)
+      ? payload.failures.map((item) => projectToolWorldBroadcastFailureItem(item))
+      : [],
+  };
+}
+
+function projectToolWorldMembershipSummary(membership = {}) {
+  return {
+    membershipId: normalizeText(membership.membershipId, null),
+    worldId: normalizeText(membership.worldId, null),
+    displayName: normalizeText(membership.displayName, null),
+    worldContextText: normalizeText(membership.worldContextText, null),
+    ownerAgentId: normalizeText(membership.ownerAgentId, null),
+    enabled: normalizeOptionalBoolean(membership.enabled, null),
+    worldStatus: normalizeText(membership.worldStatus, null),
+    worldRole: projectWorldRole(membership.worldRole, null),
+    membershipStatus: normalizeText(membership.membershipStatus, null),
+    participantContextText: normalizeText(membership.participantContextText, null),
+    joinedAt: normalizeText(membership.joinedAt, null),
+    updatedAt: normalizeText(membership.updatedAt, null),
+    nextAction: normalizeText(membership.nextAction, null),
+  };
+}
+
+export function projectToolWorldMembershipListResponse(payload = {}, { accountId = null } = {}) {
+  return {
+    accountId: normalizeText(accountId, null),
+    memberships: Array.isArray(payload.items)
+      ? payload.items.map((membership) => projectToolWorldMembershipSummary(membership))
+      : [],
+    nextAction: normalizeText(payload.nextAction, null),
+  };
+}
+
+export function projectToolWorldMembershipResponse(payload = {}, { accountId = null } = {}) {
+  return {
+    accountId: normalizeText(accountId, null),
+    ...projectToolWorldMembershipSummary(payload),
+  };
+}
+
+export function projectToolWorldMemberSearchResponse(payload = {}, { accountId = null } = {}) {
+  return {
+    accountId: normalizeText(accountId, null),
+    status: normalizeText(payload.status, 'no_matches'),
+    worldId: normalizeText(payload.worldId, null),
+    query: normalizeText(payload.query, null),
+    sort: normalizeText(payload.sort, 'match'),
+    limit: normalizeInteger(payload.limit, 0),
+    totalMatches: normalizeInteger(payload.totalMatches, Array.isArray(payload.items) ? payload.items.length : 0),
+    nextAction: normalizeText(payload.nextAction, null),
+    members: Array.isArray(payload.items)
+      ? payload.items.map((item, index) => ({
+        candidateId: normalizeText(item.membershipId, `candidate_${index + 1}`),
+        displayName: normalizeText(item.displayName, `Candidate ${index + 1}`),
+        agentCode: normalizeText(item.agentCode, null)?.toUpperCase() || null,
+        headline: normalizeText(item.headline, null),
+        online: item.online === true,
+        score: normalizeInteger(item.score, 0),
+        matchedFieldIds: normalizeStringList(item.matchedFieldIds),
+        reasonSummary: normalizeText(item.reasonSummary, null),
+        profileSummary: projectCandidateProfileSummary(item.profileSummary || {}),
+        worldFeedbackSummary: projectWorldFeedbackSummary(item.worldFeedbackSummary),
+        requestChat: projectRequestChatPayload(item.requestChat, { accountId }),
+      }))
+      : [],
+  };
+}
+
 export function projectToolFeedbackSubmissionResponse(result = {}) {
   const feedback = result.feedback && typeof result.feedback === 'object' ? result.feedback : {};
   const reporter = feedback.reporter && typeof feedback.reporter === 'object' ? feedback.reporter : {};
@@ -556,6 +858,7 @@ function projectChatInboxCountBlock(counts = {}, fallback = {}) {
     chatStatusCounts: counts.chatStatusCounts && typeof counts.chatStatusCounts === 'object' && !Array.isArray(counts.chatStatusCounts)
       ? {
           opening: normalizeInteger(counts.chatStatusCounts.opening, 0),
+          ending: normalizeInteger(counts.chatStatusCounts.ending, 0),
           active: normalizeInteger(counts.chatStatusCounts.active, 0),
           silent: normalizeInteger(counts.chatStatusCounts.silent, 0),
           kickoff_failed: normalizeInteger(counts.chatStatusCounts.kickoff_failed, 0),
@@ -563,6 +866,7 @@ function projectChatInboxCountBlock(counts = {}, fallback = {}) {
         }
       : {
           opening: 0,
+          ending: 0,
           active: 0,
           silent: 0,
           kickoff_failed: 0,

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

@@ -14,9 +14,12 @@ export const CLAWORLD_FEEDBACK_TOOL_NAMES = Object.freeze([
 ]);
 
 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',
 ]);
 
 export const CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES = Object.freeze([