@xfxstudio/claworld 2026.4.27-testing.1 → 2026.4.28-testing

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

@@ -125,6 +125,14 @@ function projectToolAction(action = null) {
       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,
     summary: normalizeText(action.summary, null),
@@ -193,6 +201,55 @@ function projectRequestChatAction(
   };
 }
 
+function projectToolCandidateDeliverySummary(
+  candidateDelivery = {},
+  {
+    accountId = null,
+    requestToolName = 'claworld_manage_conversations',
+  } = {},
+) {
+  if (!candidateDelivery || typeof candidateDelivery !== 'object' || Array.isArray(candidateDelivery)) return null;
+
+  const candidateSummaries = Array.isArray(candidateDelivery.candidateSummaries)
+    ? candidateDelivery.candidateSummaries.map((summary) => ({
+      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),
+      score: normalizeOptionalInteger(summary.score, null),
+      agentCode: normalizeText(summary.agentCode, summary.requestChat?.agentCode || null)?.toUpperCase() || null,
+      requestChat: projectRequestChatPayload(summary.requestChat, {
+        accountId,
+        requestToolName,
+      }),
+      requiredFieldSummary: normalizeStringList(summary.requiredFieldSummary),
+      optionalFieldSummary: normalizeStringList(summary.optionalFieldSummary),
+      compatibilitySummary: normalizeStringList(summary.compatibilitySummary),
+      deliveryReasonSummary: normalizeText(summary.deliveryReasonSummary, null),
+      expiresAt: normalizeText(summary.expiresAt, null),
+      summary: normalizeText(summary.summary, null),
+    }))
+    : [];
+
+  return {
+    status: normalizeText(candidateDelivery.status, null),
+    worldId: normalizeText(candidateDelivery.worldId, null),
+    deliveredCandidateCount: normalizeInteger(candidateDelivery.deliveredCandidateCount, candidateSummaries.length),
+    totalCandidateCount: normalizeInteger(candidateDelivery.totalCandidateCount, candidateSummaries.length),
+    remainingCandidateCount: normalizeInteger(candidateDelivery.remainingCandidateCount, 0),
+    nextAction: normalizeText(candidateDelivery.nextAction, null),
+    requestChatAction: projectRequestChatAction(candidateDelivery.requestChatAction, {
+      accountId,
+      requestToolName,
+    }),
+    candidateSummaries,
+    orchestration: projectOrchestration(candidateDelivery.orchestration),
+  };
+}
+
 export function projectToolWorldList(worldDirectory = {}) {
   const worlds = Array.isArray(worldDirectory.items)
     ? worldDirectory.items.map((world) => ({
@@ -302,7 +359,23 @@ export function projectToolWorldDetail(worldDetail = {}, { accountId = null } =
   };
 }
 
-function projectMemberProfileSummary(summary = {}) {
+function projectToolCandidateSummary(summary = {}, index = 0) {
+  return {
+    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,
+    score: normalizeInteger(summary.score, 0) || null,
+    summary: normalizeText(summary.summary, null),
+    expiresAt: normalizeText(summary.expiresAt, null),
+    worldFeedbackSummary: projectWorldFeedbackSummary(summary.worldFeedbackSummary),
+  };
+}
+
+function projectCandidateProfileSummary(summary = {}) {
   return {
     displayName: normalizeText(summary.displayName, null),
     headline: normalizeText(summary.headline, null),
@@ -323,6 +396,123 @@ function projectMemberProfileSummary(summary = {}) {
   };
 }
 
+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)
+      ? candidateFeed.candidates.map((candidate, index) => projectToolCandidateSummary({
+        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,
+        score: candidate.score,
+        summary: normalizeText(candidate.deliveryReason?.summary, null),
+        expiresAt: candidate.expiresAt,
+        worldFeedbackSummary: candidate.worldFeedbackSummary,
+      }, index))
+      : [];
+
+  return {
+    status: normalizeText(
+      candidateDelivery?.status,
+      normalizeText(candidateFeed?.status, candidateSummaries.length > 0 ? 'candidate_summary_ready' : 'candidate_summary_pending'),
+    ),
+    nextAction: normalizeText(
+      candidateDelivery?.nextAction,
+      normalizeText(candidateFeed?.nextAction, candidateSummaries.length > 0 ? 'review_candidates_then_request_chat' : 'wait_for_more_candidates'),
+    ),
+    deliveredCandidateCount: normalizeInteger(candidateDelivery?.deliveredCandidateCount, candidateSummaries.length),
+    totalCandidateCount: normalizeInteger(
+      candidateDelivery?.totalCandidateCount,
+      normalizeInteger(candidateFeed?.totalCandidates, candidateSummaries.length),
+    ),
+    remainingCandidateCount: normalizeInteger(candidateDelivery?.remainingCandidateCount, 0),
+    candidates: candidateSummaries,
+  };
+}
+
+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_manage_conversations',
+    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,
+  };
+}
+
+
 function projectToolJoinAction(action = null, { accountId = null, requestToolName = null } = {}) {
   if (!action || typeof action !== 'object' || Array.isArray(action)) return null;
   const normalizedAccountId = normalizeText(accountId, null);
@@ -516,22 +706,21 @@ export function projectToolWorldMemberSearchResponse(payload = {}, { accountId =
     status: normalizeText(payload.status, 'no_matches'),
     worldId: normalizeText(payload.worldId, null),
     query: normalizeText(payload.query, null),
-    sort: normalizeText(payload.sort, 'relevance'),
+    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) => ({
-        memberId: normalizeText(item.membershipId, `member_${index + 1}`),
-        membershipId: normalizeText(item.membershipId, null),
-        displayName: normalizeText(item.displayName, `Member ${index + 1}`),
+        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: projectMemberProfileSummary(item.profileSummary || {}),
+        profileSummary: projectCandidateProfileSummary(item.profileSummary || {}),
         worldFeedbackSummary: projectWorldFeedbackSummary(item.worldFeedbackSummary),
         requestChat: projectRequestChatPayload(item.requestChat, { accountId }),
       }))

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

@@ -17,12 +17,16 @@ 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_CONVERSATION_TOOL_NAMES,
+  ...CLAWORLD_FEEDBACK_TOOL_NAMES,
 ]);
 
 export const CLAWORLD_PUBLIC_TOOL_NAMES = Object.freeze([
@@ -30,6 +34,17 @@ export const CLAWORLD_PUBLIC_TOOL_NAMES = Object.freeze([
 ]);
 
 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([

package/src/openclaw/runtime/working-memory.js

@@ -602,6 +602,7 @@ function compactResultPayload(payload = {}) {
     'displayName',
     'chatRequestId',
     'conversationKey',
+    'candidateId',
     'feedbackId',
     'nextAction',
     'requiredAction',
@@ -631,6 +632,7 @@ export function buildClaworldToolMaintenanceEvent({
     worldId: params.worldId || payload.worldId,
     chatRequestId: params.chatRequestId || payload.chatRequestId,
     conversationKey: params.conversationKey || payload.conversationKey,
+    candidateId: params.candidateId || payload.candidateId,
     agentCode: params.agentCode || payload.agentCode,
   };
   return buildClaworldMaintenanceEvent({

package/src/openclaw/runtime/world-moderation-helper.js

@@ -101,10 +101,6 @@ function normalizeManagedWorld(payload = {}) {
     enabled: normalizeOptionalBoolean(payload.enabled, null),
     status: normalizeText(payload.status, null),
     worldRole: normalizeWorldRole(payload.worldRole, null),
-    visibility: normalizeText(payload.visibility, 'public'),
-    identityMode: normalizeText(payload.identityMode, 'imaginary'),
-    joinPolicy: normalizeText(payload.joinPolicy, 'open'),
-    approvalPolicy: normalizeText(payload.approvalPolicy, 'auto'),
     schemaVersion: normalizeOptionalInteger(payload.schemaVersion, null),
     createdAt: normalizeText(payload.createdAt, null),
     updatedAt: normalizeText(payload.updatedAt, null),
@@ -137,10 +133,6 @@ function normalizeOwnedWorldSummary(payload = {}) {
     enabled: normalizeOptionalBoolean(payload.enabled, null),
     status: normalizeText(payload.status, null),
     worldRole: normalizeWorldRole(payload.worldRole, null),
-    visibility: normalizeText(payload.visibility, 'public'),
-    identityMode: normalizeText(payload.identityMode, 'imaginary'),
-    joinPolicy: normalizeText(payload.joinPolicy, 'open'),
-    approvalPolicy: normalizeText(payload.approvalPolicy, 'auto'),
     createdAt: normalizeText(payload.createdAt, null),
     updatedAt: normalizeText(payload.updatedAt, null),
     broadcast: normalizeWorldBroadcastConfig(payload.broadcast),
@@ -281,10 +273,6 @@ export async function createModeratedWorld({
   worldContextText = null,
   participantContextText = null,
   enabled = true,
-  visibility = null,
-  identityMode = null,
-  joinPolicy = null,
-  approvalPolicy = null,
   fetchImpl,
   logger = console,
 } = {}) {
@@ -312,10 +300,6 @@ export async function createModeratedWorld({
       worldContextText,
       participantContextText: normalizeText(participantContextText, null),
       enabled,
-      ...(normalizeText(visibility, null) ? { visibility: normalizeText(visibility, null) } : {}),
-      ...(normalizeText(identityMode, null) ? { identityMode: normalizeText(identityMode, null) } : {}),
-      ...(normalizeText(joinPolicy, null) ? { joinPolicy: normalizeText(joinPolicy, null) } : {}),
-      ...(normalizeText(approvalPolicy, null) ? { approvalPolicy: normalizeText(approvalPolicy, null) } : {}),
     }),
   });
 

package/src/product-shell/contracts/world-orchestration.js

@@ -10,6 +10,12 @@ function normalizeInteger(value, fallback = 0) {
   return Math.max(0, Math.trunc(parsed));
 }
 
+function normalizeNumber(value, fallback = null) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) return fallback;
+  return parsed;
+}
+
 function normalizeStringList(values = []) {
   if (!Array.isArray(values)) return [];
   return [...new Set(values.map((value) => normalizeText(value, null)).filter(Boolean))];
@@ -208,6 +214,147 @@ function normalizeWorldDetail(payload = {}) {
   };
 }
 
+function normalizeProfileSummaryField(field = {}, index = 0) {
+  const fieldId = normalizeText(field.fieldId || field.id, `field_${index + 1}`);
+  const value = Array.isArray(field.value)
+    ? normalizeStringList(field.value)
+    : normalizeText(field.value, null);
+
+  if (value == null || (Array.isArray(value) && value.length === 0)) {
+    return null;
+  }
+
+  return {
+    fieldId,
+    label: normalizeText(field.label, fieldId),
+    value,
+  };
+}
+
+function normalizeCandidateProfileSummary(summary = {}) {
+  return {
+    displayName: normalizeText(summary.displayName, null),
+    headline: normalizeText(summary.headline, null),
+    requiredFields: Array.isArray(summary.requiredFields)
+      ? summary.requiredFields.map((field, index) => normalizeProfileSummaryField(field, index)).filter(Boolean)
+      : [],
+    optionalFields: Array.isArray(summary.optionalFields)
+      ? summary.optionalFields.map((field, index) => normalizeProfileSummaryField(field, index)).filter(Boolean)
+      : [],
+  };
+}
+
+function normalizeCompatibilitySignal(signal = {}, index = 0) {
+  return {
+    signalId: normalizeText(signal.signalId, `signal_${index + 1}`),
+    type: normalizeText(signal.type, 'world_ready'),
+    fieldIds: normalizeStringList(signal.fieldIds),
+    score: normalizeNumber(signal.score, 0),
+    summary: normalizeText(signal.summary, ''),
+  };
+}
+
+function normalizeDeliveryReason(reason = {}) {
+  return {
+    code: normalizeText(reason.code, null),
+    matchedFieldIds: normalizeStringList(reason.matchedFieldIds),
+    summary: normalizeText(reason.summary, ''),
+  };
+}
+
+function normalizeWorldRole(worldRole, fallback = null) {
+  const normalized = normalizeText(worldRole, fallback);
+  return ['owner', 'member'].includes(normalized) ? normalized : fallback;
+}
+
+function normalizeCandidate(candidate = {}, index = 0) {
+  const normalizedRank = normalizeNumber(candidate.rank, null);
+  const displayName = normalizeText(
+    candidate.displayName || candidate.profileSummary?.displayName || candidate.requestChat?.displayName,
+    null,
+  );
+  const agentCode = normalizeText(
+    candidate.agentCode || candidate.requestChat?.agentCode,
+    null,
+  )?.toUpperCase() || null;
+  const requestChat = displayName && agentCode
+    ? {
+      worldId: normalizeText(candidate.requestChat?.worldId, normalizeText(candidate.worldId, 'unknown-world')),
+      displayName,
+      agentCode,
+    }
+    : null;
+
+  return {
+    candidateId: normalizeText(candidate.candidateId, `candidate_${index + 1}`),
+    worldId: normalizeText(candidate.worldId, 'unknown-world'),
+    worldRole: normalizeWorldRole(candidate.worldRole, null),
+    sourceMembershipId: normalizeText(candidate.sourceMembershipId, null),
+    online: candidate.online === true,
+    displayName,
+    agentCode,
+    requestChat,
+    profileSummary: normalizeCandidateProfileSummary(candidate.profileSummary),
+    compatibilitySignals: Array.isArray(candidate.compatibilitySignals)
+      ? candidate.compatibilitySignals.map((signal, signalIndex) => normalizeCompatibilitySignal(signal, signalIndex))
+      : [],
+    deliveryReason: normalizeDeliveryReason(candidate.deliveryReason),
+    expiresAt: normalizeText(candidate.expiresAt, null),
+    joinedAt: normalizeText(candidate.joinedAt, null),
+    rank: normalizedRank == null ? null : Math.max(1, Math.trunc(normalizedRank)),
+    score: normalizeNumber(candidate.score, null),
+  };
+}
+
+function normalizeCandidateFeedResponse(payload = {}, { worldId = null } = {}) {
+  const candidates = Array.isArray(payload.candidates)
+    ? payload.candidates.map((candidate, index) => normalizeCandidate(candidate, index))
+    : [];
+
+  return {
+    worldId: normalizeText(payload.worldId, worldId || 'unknown-world'),
+    viewerMembershipId: normalizeText(payload.viewerMembershipId, null),
+    generatedAt: normalizeText(payload.generatedAt, null),
+    expiresAt: normalizeText(payload.expiresAt, null),
+    deliveryMode: normalizeText(payload.deliveryMode, 'agent_review_before_live_session'),
+    nextAction: normalizeText(
+      payload.nextAction,
+      candidates.length > 0 ? 'review_candidates_then_request_chat' : 'wait_for_more_candidates',
+    ),
+    candidateSource: normalizeText(payload.candidateSource, 'active_memberships_online'),
+    candidateModel: payload.candidateModel && typeof payload.candidateModel === 'object' ? payload.candidateModel : {},
+    strategy: payload.strategy && typeof payload.strategy === 'object' ? payload.strategy : {},
+    limit: normalizeInteger(payload.limit, candidates.length),
+    totalCandidates: normalizeInteger(payload.totalCandidates, candidates.length),
+    status: normalizeText(payload.status, candidates.length > 0 ? 'feed_ready' : 'no_candidates_ready'),
+    candidates,
+  };
+}
+
+function summarizeProfileValue(value) {
+  if (Array.isArray(value)) return joinAsNaturalLanguage(value.map((entry) => String(entry).trim()).filter(Boolean));
+  return normalizeText(value, '');
+}
+
+function summarizeProfileFields(fields = []) {
+  return fields
+    .map((field) => {
+      const value = summarizeProfileValue(field.value);
+      if (!value) return null;
+      return `${field.label}: ${value}`;
+    })
+    .filter(Boolean);
+}
+
+function buildCandidateDeliverySummaryLine(candidateSummary = {}, index = 0) {
+  const likesReceived = Number(candidateSummary.worldFeedbackSummary?.likesReceived || 0);
+  const dislikesReceived = Number(candidateSummary.worldFeedbackSummary?.dislikesReceived || 0);
+  const feedbackLine = likesReceived > 0 || dislikesReceived > 0
+    ? ` World feedback in this world: ${likesReceived} like${likesReceived === 1 ? '' : 's'}, ${dislikesReceived} dislike${dislikesReceived === 1 ? '' : 's'}.`
+    : '';
+  return `${index + 1}. ${candidateSummary.summary}${feedbackLine}`;
+}
+
 function formatConversationOverview(detail = {}) {
   const conversationOverview = detail.conversationOverview && typeof detail.conversationOverview === 'object'
     ? detail.conversationOverview
@@ -458,11 +605,133 @@ export function buildRequiredFieldExplanation(worldDetail = {}) {
   };
 }
 
+export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail = null, limit = null } = {}) {
+  const detail = worldDetail ? normalizeWorldDetail(worldDetail) : null;
+  const normalizedFeed = normalizeCandidateFeedResponse(candidateFeed, {
+    worldId: detail?.worldId || candidateFeed.worldId || null,
+  });
+  const summaryLimit = Math.max(
+    1,
+    normalizeInteger(limit, normalizedFeed.candidates.length || normalizedFeed.totalCandidates || 1),
+  );
+  const displayName = detail?.displayName || normalizedFeed.worldId || 'the selected world';
+  const requestChatAction = {
+    action: 'request_chat',
+    worldId: normalizedFeed.worldId,
+    requiredFields: ['worldId', 'displayName', 'agentCode', 'openingMessage'],
+    summary:
+      'After the user chooses a candidate, request_chat with this worldId, displayName, agentCode, and a non-blank openingMessage.',
+  };
+  const candidateSummaries = normalizedFeed.candidates.slice(0, summaryLimit).map((candidate, index) => {
+    const name = candidate.profileSummary.displayName || `Candidate ${index + 1}`;
+    const requiredFieldSummary = summarizeProfileFields(candidate.profileSummary.requiredFields);
+    const optionalFieldSummary = summarizeProfileFields(candidate.profileSummary.optionalFields);
+    const compatibilitySummary = candidate.compatibilitySignals
+      .map((signal) => sentenceCase(signal.summary, ''))
+      .filter(Boolean);
+    const deliveryReasonSummary = sentenceCase(candidate.deliveryReason.summary, '');
+    const availabilitySummary = candidate.online === true ? 'Online now.' : 'Currently offline.';
+    const roleSummary = candidate.worldRole ? `World role: ${candidate.worldRole}.` : null;
+    const scoreSummary = candidate.score == null
+      ? null
+      : `Score ${candidate.score}${candidate.rank == null ? '' : `, rank ${candidate.rank}`}.`;
+    const summary = [
+      candidate.profileSummary.headline ? `${name}: ${candidate.profileSummary.headline}.` : `${name}.`,
+      requiredFieldSummary.length > 0 ? `Required profile fields: ${requiredFieldSummary.join('; ')}.` : null,
+      optionalFieldSummary.length > 0 ? `Optional context: ${optionalFieldSummary.join('; ')}.` : null,
+      compatibilitySummary.length > 0 ? compatibilitySummary.join(' ') : null,
+      deliveryReasonSummary || null,
+      roleSummary,
+      availabilitySummary,
+      scoreSummary,
+    ].filter(Boolean).join(' ');
+
+    return {
+      candidateId: candidate.candidateId,
+      sourceMembershipId: candidate.sourceMembershipId,
+      online: candidate.online === true,
+      worldRole: candidate.worldRole,
+      agentCode: candidate.agentCode,
+      requestChat: candidate.requestChat,
+      displayName: name,
+      headline: candidate.profileSummary.headline,
+      rank: candidate.rank,
+      score: candidate.score,
+      requiredFieldSummary,
+      optionalFieldSummary,
+      compatibilitySummary,
+      deliveryReasonSummary: deliveryReasonSummary || null,
+      worldFeedbackSummary: candidate.worldFeedbackSummary || {
+        likesReceived: 0,
+        dislikesReceived: 0,
+      },
+      expiresAt: candidate.expiresAt,
+      summary,
+    };
+  });
+  const deliveredCandidateCount = candidateSummaries.length;
+  const totalCandidateCount = Math.max(normalizedFeed.totalCandidates, deliveredCandidateCount);
+  const remainingCandidateCount = Math.max(totalCandidateCount - deliveredCandidateCount, 0);
+  const heading = deliveredCandidateCount > 0
+    ? `${displayName} has ${deliveredCandidateCount} online candidate profile ${deliveredCandidateCount === 1 ? 'summary' : 'summaries'} ready for review now.`
+    : `No online candidate profile summaries are ready for review in ${displayName} yet.`;
+  const promptBody = deliveredCandidateCount > 0
+    ? candidateSummaries.map((summary, index) => buildCandidateDeliverySummaryLine(summary, index)).join('\n\n')
+    : 'No online candidates are currently available from the active-membership feed.';
+
+  return {
+    worldId: normalizedFeed.worldId,
+    status: deliveredCandidateCount > 0 ? 'candidate_summary_ready' : 'candidate_summary_pending',
+    deliveredCandidateCount,
+    totalCandidateCount,
+    remainingCandidateCount,
+    requestChatAction,
+    candidateSummaries,
+    nextAction: deliveredCandidateCount > 0
+      ? normalizedFeed.nextAction
+      : 'wait_for_more_candidates',
+    orchestration: {
+      stage: 'post_join_candidate_delivery',
+      system:
+        'Use the backend-authored candidate summaries already attached to this payload. Candidate requestChat payloads are the canonical follow-up inputs for world-scoped contact establishment.',
+      confirmation: `Candidate review payload for ${displayName} [${normalizedFeed.worldId}].`,
+      user: [heading, promptBody].filter(Boolean).join('\n\n'),
+      followUp: deliveredCandidateCount > 0
+        ? (remainingCandidateCount > 0
+          ? `Share these ${deliveredCandidateCount} candidate summaries first. If the user chooses someone now, continue with request_chat using that candidate's {worldId, displayName, agentCode} plus a non-blank openingMessage from the user. If they want more options first, continue with the remaining ${remainingCandidateCount} candidate${remainingCandidateCount === 1 ? '' : 's'} from the same feed.`
+          : 'Share these candidate summaries and, if the user chooses one, continue with request_chat using the attached {worldId, displayName, agentCode} payload plus a non-blank openingMessage from the user.')
+        : 'Tell the user candidate delivery can be retried later through the same backend-authored world flow.',
+    },
+  };
+}
+
 export function buildResolvedWorldJoinOrchestration({
   joinResult = null,
+  candidateDelivery = null,
 } = {}) {
   const joinOrchestration = joinResult?.orchestration && typeof joinResult.orchestration === 'object' && !Array.isArray(joinResult.orchestration)
     ? joinResult.orchestration
     : null;
-  return joinOrchestration;
+  const candidateOrchestration = candidateDelivery?.orchestration && typeof candidateDelivery.orchestration === 'object' && !Array.isArray(candidateDelivery.orchestration)
+    ? candidateDelivery.orchestration
+    : null;
+
+  if (!candidateOrchestration) return joinOrchestration;
+
+  return {
+    stage: normalizeText(candidateOrchestration.stage, normalizeText(joinOrchestration?.stage, null)),
+    system: normalizeText(candidateOrchestration.system, normalizeText(joinOrchestration?.system, null)),
+    confirmation: normalizeText(
+      joinOrchestration?.confirmation,
+      normalizeText(candidateOrchestration.confirmation, null),
+    ),
+    user: [
+      normalizeText(joinOrchestration?.user, normalizeText(joinOrchestration?.confirmation, null)),
+      normalizeText(candidateOrchestration.user, null),
+    ].filter(Boolean).join('\n\n'),
+    followUp: normalizeText(
+      candidateOrchestration.followUp,
+      normalizeText(joinOrchestration?.followUp, null),
+    ),
+  };
 }