@xfxstudio/claworld 0.2.25 → 2026.4.14-testing.2

package/src/openclaw/runtime/product-shell-helper.js

@@ -54,9 +54,18 @@ function normalizeWorldSummary(world = {}) {
   return {
     worldId: normalizeText(rawWorldId, 'unknown-world'),
     displayName: normalizeText(summary.displayName || world.displayName, normalizeText(rawWorldId, 'Unknown World')),
+    summary: normalizeText(summary.summary || world.summary, null),
     worldContextText: normalizeText(summary.worldContextText || world.worldContextText, ''),
     hotness: normalizeInteger(summary.hotness || world.hotness || world.activatedMemberCount, 0),
+    activatedMemberCount: normalizeInteger(summary.activatedMemberCount || world.activatedMemberCount || summary.hotness || world.hotness, 0),
+    tags: normalizeStringList(summary.tags || world.tags),
+    matchScore: normalizeInteger(summary.matchScore || world.matchScore, 0),
+    matchedFieldIds: normalizeStringList(summary.matchedFieldIds || world.matchedFieldIds),
+    matchedTerms: normalizeStringList(summary.matchedTerms || world.matchedTerms),
+    reasonSummary: normalizeText(summary.reasonSummary || world.reasonSummary, null),
     requiredFieldCount: normalizeInteger(summary.requiredFieldCount || world.requiredFieldCount, 0),
+    detailAction: world.detailAction && typeof world.detailAction === 'object' ? world.detailAction : null,
+    joinAction: world.joinAction && typeof world.joinAction === 'object' ? world.joinAction : null,
   };
 }
 
@@ -228,6 +237,22 @@ function normalizeCandidateProfileSummary(summary = {}) {
   };
 }
 
+function normalizeSearchAction(action = null) {
+  if (!action || typeof action !== 'object' || Array.isArray(action)) return 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
+    : {};
+  return {
+    tool: normalizeText(action.tool, null),
+    summary: normalizeText(action.summary, null),
+    payload,
+    payloadTemplate,
+  };
+}
+
 function normalizeCompatibilitySignal(signal = {}, index = 0) {
   return {
     signalId: normalizeText(signal.signalId, `signal_${index + 1}`),
@@ -398,7 +423,10 @@ export function buildWorldSelectionPrompt(worldDirectory = {}) {
     : null;
 }
 
-export function buildPostSetupWorldDirectory(payload = {}, { accountId = null } = {}) {
+export function buildPostSetupWorldDirectory(payload = {}, {
+  accountId = null,
+  statusMode = 'directory',
+} = {}) {
   const items = Array.isArray(payload.items) ? payload.items.map((world) => normalizeWorldSummary(world)) : [];
   const recommendedWorldId = items[0]?.worldId || null;
   const pagination = payload.pagination && typeof payload.pagination === 'object'
@@ -412,23 +440,83 @@ export function buildPostSetupWorldDirectory(payload = {}, { accountId = null }
       totalPages: items.length > 0 ? 1 : 0,
       totalCount: items.length,
     };
+  const mode = normalizeText(payload.mode, 'browse');
   const sort = normalizeText(payload.sort, 'hot');
+  const statusFallback = items.length > 0
+    ? (statusMode === 'search' ? 'search_ready' : 'ready')
+    : 'no_matches';
+  const normalizedStatus = normalizeText(
+    statusMode === 'directory' && mode === 'browse' && payload.status === 'search_ready'
+      ? 'ready'
+      : payload.status,
+    statusFallback,
+  );
 
   return {
-    status: 'ready',
+    status: normalizedStatus,
     source: 'product_shell',
     accountId: normalizeText(accountId, null),
+    mode,
+    query: normalizeText(payload.query, null),
     worldCount: pagination.totalCount,
     recommendedWorldId,
     items,
     pagination,
     sort,
+    nextAction: normalizeText(payload.nextAction, items.length > 0 ? 'inspect_world_detail_or_join_world' : 'broaden_world_search'),
     orchestration: payload.orchestration && typeof payload.orchestration === 'object'
       ? payload.orchestration
       : null,
   };
 }
 
+function normalizeWorldMemberSearchItem(item = {}) {
+  return {
+    membershipId: normalizeText(item.membershipId, null),
+    worldId: normalizeText(item.worldId, null),
+    displayName: normalizeText(item.displayName, null),
+    agentCode: normalizeText(item.agentCode, null)?.toUpperCase() || null,
+    requestChat: item.requestChat && typeof item.requestChat === 'object' && !Array.isArray(item.requestChat)
+      ? item.requestChat
+      : null,
+    headline: normalizeText(item.headline, null),
+    online: item.online === true,
+    score: normalizeInteger(item.score, 0),
+    matchedFieldIds: normalizeStringList(item.matchedFieldIds),
+    reasonSummary: normalizeText(item.reasonSummary, null),
+    joinedAt: normalizeText(item.joinedAt, null),
+    profileSummary: normalizeCandidateProfileSummary(item.profileSummary || {}),
+    worldFeedbackSummary: item.worldFeedbackSummary && typeof item.worldFeedbackSummary === 'object' && !Array.isArray(item.worldFeedbackSummary)
+      ? {
+        likesReceived: normalizeInteger(item.worldFeedbackSummary.likesReceived, 0),
+        dislikesReceived: normalizeInteger(item.worldFeedbackSummary.dislikesReceived, 0),
+      }
+      : {
+        likesReceived: 0,
+        dislikesReceived: 0,
+      },
+  };
+}
+
+export function normalizeWorldMemberSearchResponse(payload = {}, { accountId = null } = {}) {
+  const items = Array.isArray(payload.items)
+    ? payload.items.map((item) => normalizeWorldMemberSearchItem(item))
+    : [];
+
+  return {
+    status: normalizeText(payload.status, items.length > 0 ? 'search_ready' : 'no_matches'),
+    source: 'product_shell',
+    accountId: normalizeText(accountId, null),
+    worldId: normalizeText(payload.worldId, null),
+    query: normalizeText(payload.query, null),
+    sort: normalizeText(payload.sort, 'match'),
+    limit: normalizeInteger(payload.limit, items.length),
+    totalMatches: normalizeInteger(payload.totalMatches, items.length),
+    nextAction: normalizeText(payload.nextAction, items.length > 0 ? 'request_chat_with_selected_candidate' : 'broaden_search_or_refresh_candidate_feed'),
+    items,
+  };
+}
+
 export function resolveWorldSelection(worldDirectory = {}, selection = null) {
   return resolveBackendWorldSelection(worldDirectory, selection);
 }
@@ -544,6 +632,55 @@ export async function fetchWorldDetail({
   return normalizeWorldDetail(detail.body);
 }
 
+export async function searchWorlds({
+  cfg = {},
+  accountId = null,
+  runtimeConfig = null,
+  query = null,
+  limit = null,
+  sort = null,
+  page = null,
+  fetchImpl,
+  logger = console,
+} = {}) {
+  if (typeof fetchImpl !== 'function') {
+    throw new Error('fetch is unavailable for claworld product-shell world search helper');
+  }
+
+  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
+  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
+  const searchResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/search`, {
+    method: 'POST',
+    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
+      accept: 'application/json',
+      'content-type': 'application/json',
+      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
+    }),
+    body: JSON.stringify({
+      query: normalizeText(query, null),
+      sort: normalizeText(sort, null),
+      limit: limit == null ? null : normalizeInteger(limit, 0),
+      page: page == null ? null : normalizeInteger(page, 0),
+    }),
+  });
+
+  if (!searchResult.ok) {
+    logger.error?.('[claworld:product-shell] world search failed', {
+      status: searchResult.status,
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      body: searchResult.body,
+    });
+    throw createProductShellHttpError('world_search', searchResult, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+    });
+  }
+
+  return buildPostSetupWorldDirectory(searchResult.body, {
+    accountId: resolvedRuntimeConfig.accountId || accountId || null,
+    statusMode: 'search',
+  });
+}
+
 export async function joinWorld({
   cfg = {},
   accountId = null,
@@ -603,6 +740,68 @@ export async function joinWorld({
   });
 }
 
+export async function searchWorldMembers({
+  cfg = {},
+  accountId = null,
+  runtimeConfig = null,
+  worldId = null,
+  agentId = null,
+  query = null,
+  sort = null,
+  limit = null,
+  fetchImpl,
+  logger = console,
+} = {}) {
+  if (typeof fetchImpl !== 'function') {
+    throw new Error('fetch is unavailable for claworld product-shell member search helper');
+  }
+
+  const resolvedWorldId = normalizeText(worldId, null);
+  if (!resolvedWorldId) {
+    throw new Error('claworld product-shell member search helper requires worldId');
+  }
+
+  const resolvedAgentId = normalizeText(agentId, null);
+  if (!resolvedAgentId) {
+    throw new Error('claworld product-shell member search helper requires agentId');
+  }
+
+  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
+  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
+  const searchResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/search`, {
+    method: 'POST',
+    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
+      accept: 'application/json',
+      'content-type': 'application/json',
+      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
+    }),
+    body: JSON.stringify({
+      agentId: resolvedAgentId,
+      query: normalizeText(query, null),
+      sort: normalizeText(sort, null),
+      limit: limit == null ? null : normalizeInteger(limit, 0),
+    }),
+  });
+
+  if (!searchResult.ok) {
+    logger.error?.('[claworld:product-shell] world member search failed', {
+      status: searchResult.status,
+      worldId: resolvedWorldId,
+      agentId: resolvedAgentId,
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      body: searchResult.body,
+    });
+    throw createProductShellHttpError('world_member_search', searchResult, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
+  }
+
+  return normalizeWorldMemberSearchResponse(searchResult.body, {
+    accountId: resolvedRuntimeConfig.accountId || accountId || null,
+  });
+}
+
 export async function fetchWorldCandidateFeed({
   cfg = {},
   accountId = null,

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,
   {
@@ -198,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'
       ? {
@@ -224,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 || ''),
@@ -240,6 +313,15 @@ export function projectToolWorldDetail(worldDetail = {}) {
     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',
+      },
+    },
   };
 }
 
@@ -259,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)
@@ -273,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,
@@ -302,13 +441,52 @@ 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',
@@ -317,10 +495,10 @@ export function projectToolJoinWorldResponse(
       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),
   };
 }
@@ -356,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),
     }))
     : [];
@@ -380,10 +559,59 @@ 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),
@@ -419,6 +647,34 @@ export function projectToolWorldMembershipResponse(payload = {}, { accountId = n
   };
 }
 
+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 : {};
@@ -602,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),
@@ -609,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([