@xfxstudio/claworld 0.1.1 → 0.1.3

package/src/product-shell/catalog/default-world-catalog.js

@@ -72,7 +72,8 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
     searchSchema: {
       mode: 'profile_overlap_search',
       inputFieldIds: ['intent', 'location', 'interests'],
-      summary: 'Search active online members by intent, location, and shared interests before opening an A2A chat.',
+      summary:
+        'Compatibility-only manual search over active online members by intent, location, and shared interests. Candidate feed review is the canonical path before request_chat.',
       hints: [
         'Search defaults to the viewer membership profile when no explicit query is provided.',
         'Only online members with an active world membership are returned.',
@@ -81,7 +82,8 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
     matching: {
       mode: 'scored_push',
       cadence: 'periodic',
-      strategySummary: 'Score active memberships by intent, location, and interests; then inject world rules for a bounded A2A conversation.',
+      strategySummary:
+        'Score active memberships by intent, location, and interests, deliver candidate summaries first, and route live contact through request_chat after review.',
       candidateSources: ['active_memberships'],
     },
     sessionTemplate: {
@@ -170,12 +172,14 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
     searchSchema: {
       mode: 'capability_overlap_search',
       inputFieldIds: ['capabilities', 'budgetBand'],
-      summary: 'Search active online members by capability overlap and optional budget fit before creating a conversation.',
+      summary:
+        'Compatibility-only manual search over active online members by capability overlap and optional budget fit. Candidate feed review is the canonical path before request_chat.',
     },
     matching: {
       mode: 'intent_filter',
       cadence: 'on_demand',
-      strategySummary: 'Filter by capability overlap and then let agents negotiate fit in a short session.',
+      strategySummary:
+        'Filter by capability overlap, deliver candidate summaries first, and let members request_chat before negotiating fit in a short session.',
       candidateSources: ['world_members'],
     },
     sessionTemplate: {
@@ -262,12 +266,14 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
     searchSchema: {
       mode: 'profile_overlap_search',
       inputFieldIds: ['targetRole', 'location', 'workMode'],
-      summary: 'Search active online members by role fit, location, and work mode before starting screening.',
+      summary:
+        'Compatibility-only manual search over active online members by role fit, location, and work mode. Candidate feed review is the canonical path before request_chat.',
     },
     matching: {
       mode: 'profile_overlap',
       cadence: 'periodic',
-      strategySummary: 'Use target role, experience summary, and location/work mode as the first-pass scoring surface.',
+      strategySummary:
+        'Use target role, experience summary, and location/work mode as the first-pass scoring surface, deliver candidate summaries, and route contact through request_chat after review.',
       candidateSources: ['world_members', 'search_results'],
     },
     sessionTemplate: {

package/src/product-shell/contracts/candidate-feed.js

@@ -5,7 +5,9 @@ const DEFAULT_CANDIDATE_FEED_LIMIT = 10;
 export const CANDIDATE_OBJECT_FIELDS = Object.freeze([
   'candidateId',
   'worldId',
+  'targetAgentId',
   'sourceMembershipId',
+  'requestChat',
   'profileSummary',
   'compatibilitySignals',
   'deliveryReason',
@@ -79,6 +81,16 @@ function normalizeValue(value, field = {}) {
   return normalized;
 }
 
+function buildRequestChatPayload(world, candidateMembership) {
+  const targetAgentId = normalizeText(candidateMembership?.agentId, null);
+  if (!targetAgentId) return null;
+
+  return {
+    worldId: world.worldId,
+    targetAgentId,
+  };
+}
+
 function normalizeComparableArray(value) {
   if (!Array.isArray(value)) return [];
   return [...new Set(value.map((entry) => normalizeText(entry, null)?.toLowerCase()).filter(Boolean))];
@@ -244,9 +256,15 @@ export function projectCandidateFeedModel(world) {
     profileSummaryFieldShape: PROFILE_SUMMARY_FIELD_FIELDS,
     compatibilitySignalFields: COMPATIBILITY_SIGNAL_FIELDS,
     deliveryReasonFields: DELIVERY_REASON_FIELDS,
+    requestChatAction: {
+      action: 'request_chat',
+      requiredFields: ['worldId', 'targetAgentId'],
+      summary:
+        'After reviewing a candidate, create a world-scoped chat request with worldId and targetAgentId.',
+    },
     liveDeliveryEvent: projectLiveDeliveryEvent(world, candidateFields),
     summary:
-      'Active members can review candidate opportunities first, then decide whether a delivery or live session should happen.',
+      'Active members can review candidate opportunities first, then call request_chat with the selected targetAgentId when they want to start a world-scoped conversation request.',
     status: 'phase1_candidate_feed',
   };
 }
@@ -265,11 +283,14 @@ function projectCandidateOpportunity({
     profileSnapshot,
     candidateMembership.membershipId,
   );
+  const requestChat = buildRequestChatPayload(world, candidateMembership);
 
   return {
     candidateId: `cand_${candidateMembership.membershipId}`,
     worldId: world.worldId,
     sourceMembershipId: candidateMembership.membershipId,
+    targetAgentId: requestChat?.targetAgentId || null,
+    requestChat,
     profileSummary: projectProfileSummary(world, profileSnapshot, candidateAgent),
     compatibilitySignals,
     deliveryReason: buildDeliveryReason(compatibilitySignals),
@@ -322,7 +343,7 @@ export function buildCandidateFeed({
     generatedAt,
     expiresAt,
     deliveryMode: 'agent_review_before_live_session',
-    nextAction: 'review_candidates_before_requesting_live_session',
+    nextAction: 'review_candidates_then_request_chat',
     candidateModel: projectCandidateFeedModel(world),
     candidates,
     status: 'feed_ready',

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

@@ -133,7 +133,7 @@ function normalizeSearchSchema(searchSchema = {}, joinSchema = {}) {
       : 10,
     summary: normalizeText(
       searchSchema.summary,
-      'Search active online world members by world-profile overlap before opening a conversation.',
+      'Compatibility-only manual search over active online world members. Candidate feed review is the canonical path before request_chat.',
     ),
     hints: normalizeStringList(searchSchema.hints),
   };
@@ -259,7 +259,7 @@ export function projectJoinPlan(world) {
     requiredFields: world.joinSchema.requiredFields,
     optionalFields: world.joinSchema.optionalFields,
     hints: world.joinSchema.hints,
-    nextAction: 'collect_profile_fields_then_call_join',
+    nextAction: 'call_join_world',
   };
 }
 
@@ -290,7 +290,7 @@ export function projectSearchModel(world) {
     defaultLimit: world.searchSchema.defaultLimit,
     summary: world.searchSchema.summary,
     hints: world.searchSchema.hints,
-    status: 'phase1_world_search',
+    status: 'compatibility_world_search',
   };
 }
 

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

@@ -190,7 +190,7 @@ function normalizeWorldDetail(payload = {}) {
       requiredFields,
       optionalFields,
       hints: normalizeStringList(payload.hints),
-      nextAction: normalizeText(payload.nextAction, 'collect_profile_fields_then_call_join'),
+      nextAction: normalizeText(payload.nextAction, 'call_join_world'),
       sessionOverview: payload.sessionOverview && typeof payload.sessionOverview === 'object' ? payload.sessionOverview : {},
       matchingOverview: payload.matchingOverview && typeof payload.matchingOverview === 'object' ? payload.matchingOverview : {},
       searchSchema: normalizeSearchSchema(payload.searchSchema || {}, {
@@ -247,7 +247,7 @@ function normalizeWorldDetail(payload = {}) {
     requiredFields,
     optionalFields,
     hints: normalizeStringList(payload.hints || joinSchema.hints),
-    nextAction: normalizeText(payload.nextAction || joinSchema.nextAction, 'collect_profile_fields_then_call_join'),
+    nextAction: normalizeText(payload.nextAction || joinSchema.nextAction, 'call_join_world'),
     sessionOverview,
     matchingOverview,
     searchSchema: normalizeSearchSchema(searchOverview, {
@@ -301,7 +301,7 @@ function normalizeJoinCheckResponse(payload = {}, { worldId = null, profile = {}
     ),
     nextAction: normalizeText(
       payload.nextAction,
-      accepted ? 'join_world_when_membership_persistence_exists' : 'collect_missing_profile_fields',
+      accepted ? 'call_join_world' : 'retry_join_world_after_profile_update',
     ),
   };
 }
@@ -373,11 +373,23 @@ function normalizeCandidateScoreBreakdown(entries = []) {
 
 function normalizeCandidate(candidate = {}, index = 0) {
   const normalizedRank = normalizeNumber(candidate.rank, null);
+  const targetAgentId = normalizeText(
+    candidate.targetAgentId || candidate.requestChat?.targetAgentId,
+    null,
+  );
+  const requestChat = targetAgentId
+    ? {
+      worldId: normalizeText(candidate.requestChat?.worldId, normalizeText(candidate.worldId, 'unknown-world')),
+      targetAgentId,
+    }
+    : null;
 
   return {
     candidateId: normalizeText(candidate.candidateId, `candidate_${index + 1}`),
     worldId: normalizeText(candidate.worldId, 'unknown-world'),
     sourceMembershipId: normalizeText(candidate.sourceMembershipId, null),
+    targetAgentId,
+    requestChat,
     profileSummary: normalizeCandidateProfileSummary(candidate.profileSummary),
     compatibilitySignals: Array.isArray(candidate.compatibilitySignals)
       ? candidate.compatibilitySignals.map((signal, signalIndex) => normalizeCompatibilitySignal(signal, signalIndex))
@@ -406,7 +418,7 @@ function normalizeCandidateFeedResponse(payload = {}, { worldId = null, agentId
     deliveryMode: normalizeText(payload.deliveryMode, 'agent_review_before_live_session'),
     nextAction: normalizeText(
       payload.nextAction,
-      candidates.length > 0 ? 'review_candidates_before_requesting_live_session' : 'wait_for_more_candidates',
+      candidates.length > 0 ? 'review_candidates_then_request_chat' : 'wait_for_more_candidates',
     ),
     candidateSource: normalizeText(payload.candidateSource, 'active_memberships'),
     candidateModel: payload.candidateModel && typeof payload.candidateModel === 'object' ? payload.candidateModel : {},
@@ -443,12 +455,10 @@ function formatSessionOverview(detail = {}) {
     : {};
   const mode = normalizeText(detail.sessionMode || sessionOverview.mode, null);
   const maxTurns = normalizeInteger(sessionOverview.maxTurns, null);
-  const turnTimeoutMs = normalizeInteger(sessionOverview.turnTimeoutMs, null);
   const parts = [];
 
   if (mode) parts.push(`${mode} mode`);
   if (maxTurns != null) parts.push(`max ${maxTurns} turns`);
-  if (turnTimeoutMs != null) parts.push(`${turnTimeoutMs}ms turn timeout`);
 
   return parts.length > 0 ? parts.join(', ') : null;
 }
@@ -490,6 +500,7 @@ export function buildWorldSessionStartupText(detail = {}) {
     summary ? `Summary: ${summary}` : null,
     sessionSummary ? `Session overview: ${sessionSummary}` : null,
     raiseHandSummary ? `Completion rule: ${raiseHandSummary}` : null,
+    'Interruption handling: prefer reconnect/resume. Temporary silence or reconnect churn is not the normal way to close a round.',
     openingText ? `Opening focus: ${openingText}` : null,
     interactionRules ? `Interaction rules: ${interactionRules}` : null,
     prohibitedRules ? `Prohibited rules: ${prohibitedRules}` : null,
@@ -544,7 +555,7 @@ function buildSelectionRetryContract(status, selection, items = [], matches = []
         stage: 'post_setup_world_selection_retry',
         system: 'The world choice matched multiple worlds. Show the narrowed list and ask the user to pick one exact world ID or display name.',
         user: `The choice ${choiceLabel} is ambiguous. Matching worlds: ${joinAsNaturalLanguage(retrySummary)}. Ask the user to choose one exact world ID or display name.`,
-        followUp: 'Once the user confirms one exact world, fetch its detail and explain the required fields before join-check.',
+        followUp: 'Once the user confirms one exact world, fetch its detail, explain the required fields, and use join_world when enough profile data is available.',
       },
     };
   }
@@ -564,7 +575,7 @@ function buildSelectionRetryContract(status, selection, items = [], matches = []
       user: retrySummary.length > 0
         ? `I could not match ${choiceLabel} to an available world. Available worlds: ${joinAsNaturalLanguage(retrySummary)}. Ask the user to choose one by world ID or display name.`
         : 'No worlds are currently available. Tell the user setup is complete but world selection cannot continue yet.',
-      followUp: 'Once the user chooses a valid world, confirm it, fetch the world detail, and explain the required fields before join-check.',
+      followUp: 'Once the user chooses a valid world, confirm it, fetch the world detail, and explain the required fields before calling join_world.',
     },
   };
 }
@@ -588,7 +599,7 @@ export function buildWorldSelectionPrompt(worldDirectory = {}) {
         ? `Available worlds:\n${worldLines.join('\n')}\nAsk the user which world they want to join next.`
         : 'No worlds are currently available. Tell the user setup is complete but no worlds can be selected yet.',
     followUp:
-      'After the user chooses a world, confirm the selection, fetch that world detail, explain the required fields, and then use join-check for that world.',
+      'After the user chooses a world, confirm the selection, fetch that world detail, explain the required fields, and then use join_world for that world.',
   };
 }
 
@@ -653,7 +664,7 @@ export function resolveWorldSelection(worldDirectory = {}, selection = null) {
       system: 'Confirm the resolved world choice before fetching detail and explaining the required fields.',
       user: `I matched the user choice to ${selectedWorld.displayName} [${selectedWorld.worldId}]. Confirm that this is the world we will use next.`,
       confirmation: `Confirmed world: ${selectedWorld.displayName} [${selectedWorld.worldId}].`,
-      followUp: 'Fetch the selected world detail and explain the required fields one by one before join-check.',
+      followUp: 'Fetch the selected world detail, explain the required fields, and use join_world once enough profile data is available.',
     },
   };
 }
@@ -678,7 +689,7 @@ export function buildRequiredFieldExplanation(worldDetail = {}) {
   const optionalFieldLabels = optionalFields.map((field) => field.label);
   const summary = requiredFields.length > 0
     ? `To join ${detail.displayName}, I need ${requiredFields.length} required field${requiredFields.length === 1 ? '' : 's'}: ${joinAsNaturalLanguage(requiredFieldLabels)}.`
-    : `${detail.displayName} does not require any mandatory profile fields before join-check.`;
+    : `${detail.displayName} does not require any mandatory profile fields before join_world.`;
   const steps = requiredFields.map((field, index) => ({
     step: index + 1,
     fieldId: field.fieldId,
@@ -691,7 +702,7 @@ export function buildRequiredFieldExplanation(worldDetail = {}) {
   const optionalContextSummary = optionalFieldLabels.length > 0
     ? `Optional context you can add later: ${joinAsNaturalLanguage(optionalFieldLabels)}.`
     : null;
-  const nextInstruction = steps[0]?.prompt || 'All required fields are already explained. You can move to join-check.';
+  const nextInstruction = steps[0]?.prompt || 'All required fields are already explained. You can move to join_world.';
 
   return {
     status: 'ready',
@@ -707,14 +718,14 @@ export function buildRequiredFieldExplanation(worldDetail = {}) {
     nextAction: detail.nextAction,
     orchestration: {
       stage: 'post_setup_world_requirements',
-      system: 'Confirm the selected world, explain its required fields in plain language, and collect them one at a time before join-check.',
+      system: 'Confirm the selected world, explain its required fields in plain language, and use join_world once the available profile data is enough for the backend to validate.',
       confirmation: `Confirmed world: ${detail.displayName} [${detail.worldId}].`,
       user: [summary, nextInstruction, optionalContextSummary].filter(Boolean).join('\n\n'),
       followUp: requiredFields.length > 1
-        ? `After the user answers ${steps[0].label}, continue with the remaining required fields in order, then call join-check.`
+        ? `After the user answers ${steps[0].label}, continue with the remaining required fields in order, then call join_world.`
         : (requiredFields.length === 1
-          ? 'After the user answers the required field, call join-check.'
-          : 'No required fields remain. Call join-check now.'),
+          ? 'After the user answers the required field, call join_world.'
+          : 'No required fields remain. Call join_world now.'),
     },
   };
 }
@@ -778,10 +789,10 @@ function buildProfileCollectionFollowUp(promptFields = []) {
 
   const labels = promptFields.map((field) => field.label);
   if (promptFields.length === 1) {
-    return `After the user answers ${labels[0]}, merge it into the saved profile draft and re-run join-check before asking anything else.`;
+    return `After the user answers ${labels[0]}, merge it into the saved profile draft and retry join_world before asking anything else.`;
   }
 
-  return `After the user answers ${joinAsNaturalLanguage(labels)}, merge those fields into the saved profile draft and re-run join-check before asking anything else.`;
+  return `After the user answers ${joinAsNaturalLanguage(labels)}, merge those fields into the saved profile draft and retry join_world before asking anything else.`;
 }
 
 export function buildWorldProfileCollectionFlow({
@@ -848,7 +859,7 @@ export function buildWorldProfileCollectionFlow({
     orchestration: {
       stage: 'post_setup_world_profile_collection',
       system:
-        'Use backend join-check guidance as the source of truth for the next required field prompt. After every user reply or the current batch checkpoint, merge the updates into the saved profile draft and re-run join-check.',
+        'Use the backend join_world unmet-requirement guidance as the source of truth for the next required field prompt. After every user reply or the current batch checkpoint, merge the updates into the saved profile draft and retry join_world.',
       confirmation: `Confirmed world: ${detail.displayName} [${detail.worldId}].`,
       user: [summary, savedSummary, promptSummary, promptBody, optionalContextSummary].filter(Boolean).join('\n\n'),
       followUp: buildProfileCollectionFollowUp(promptFields),
@@ -870,13 +881,13 @@ export function buildWorldJoinOutcomeOrchestration({ worldDetail = {}, joinResul
     stage: 'world_join_result',
     status: membershipStatus,
     system:
-      'The backend already resolved the world join result. Reflect the authoritative membership outcome before any search, candidate review, or live-session follow-up.',
+      'The backend already resolved the world join result. Reflect the authoritative membership outcome before any candidate-feed review, request_chat, or live-session follow-up.',
     confirmation: `World membership in ${detail.displayName} [${detail.worldId}] is ${membershipStatus}.`,
     user: membershipStatus === 'active'
       ? ['Joined ' + detail.displayName + ' successfully. World membership is active.', joinSummary].filter(Boolean).join(' ')
       : `The join result for ${detail.displayName} is ${membershipStatus}.`,
     followUp: membershipStatus === 'active'
-      ? 'Use backend-authored next-stage summary and candidate-delivery payloads for the next world step.'
+      ? 'Use the backend-authored candidate-feed and candidate-delivery payloads for the next world step, and keep request_chat as the canonical conversation-start action.'
       : 'Do not continue to world-member-only follow-up until membership becomes active.',
   };
 }
@@ -923,6 +934,13 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
     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', 'targetAgentId'],
+    summary:
+      'After the user chooses a candidate, request_chat with this worldId and the candidate targetAgentId.',
+  };
   const candidateSummaries = normalizedFeed.candidates.slice(0, summaryLimit).map((candidate, index) => {
     const name = candidate.profileSummary.displayName || `Candidate ${index + 1}`;
     const requiredFieldSummary = summarizeProfileFields(candidate.profileSummary.requiredFields);
@@ -946,6 +964,8 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
     return {
       candidateId: candidate.candidateId,
       sourceMembershipId: candidate.sourceMembershipId,
+      targetAgentId: candidate.targetAgentId,
+      requestChat: candidate.requestChat,
       displayName: name,
       headline: candidate.profileSummary.headline,
       rank: candidate.rank,
@@ -969,10 +989,13 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
     : 'No candidates are currently available from the active-membership feed.';
 
   return {
+    worldId: normalizedFeed.worldId,
+    agentId: normalizedFeed.agentId,
     status: deliveredCandidateCount > 0 ? 'candidate_summary_ready' : 'candidate_summary_pending',
     deliveredCandidateCount,
     totalCandidateCount,
     remainingCandidateCount,
+    requestChatAction,
     candidateSummaries,
     nextAction: deliveredCandidateCount > 0
       ? normalizedFeed.nextAction
@@ -980,13 +1003,13 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
     orchestration: {
       stage: 'post_join_candidate_delivery',
       system:
-        'Use the backend-authored candidate summaries already attached to this payload. Do not invent additional candidate-delivery business text locally.',
+        '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 wants more, continue with the remaining ${remainingCandidateCount} candidate${remainingCandidateCount === 1 ? '' : 's'} from the same feed before requesting a live session.`
-          : 'Share these candidate summaries and ask whether the user wants to review them further or continue toward a live session later.')
+          ? `Share these ${deliveredCandidateCount} candidate summaries first. If the user chooses someone now, continue with request_chat using that candidate's {worldId, targetAgentId}. 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, targetAgentId} payload for that candidate.')
         : 'Tell the user candidate delivery can be retried later through the same backend-authored world flow.',
     },
   };

package/src/product-shell/membership/membership-service.js

@@ -69,15 +69,14 @@ function createJoinNotEligibleError(joinCheck) {
   error.responseBody = {
     error: error.code,
     message: 'profile does not satisfy world join requirements',
+    status: 'needs_profile',
     membershipStatus: 'inactive',
     worldId: joinCheck.worldId,
+    normalizedProfile: joinCheck.normalizedProfile,
     missingFields: joinCheck.missingFields,
     nextMissingField: joinCheck.nextMissingField,
     missingFieldGuidance: joinCheck.missingFieldGuidance,
-    normalizedProfile: joinCheck.normalizedProfile,
-    nextAction: joinCheck.nextAction,
-    joinCheck,
-    profileCollectionFlow: joinCheck.profileCollectionFlow || null,
+    nextAction: 'retry_join_world_after_profile_update',
   };
   return error;
 }
@@ -98,12 +97,14 @@ function normalizeProfileSnapshot(...candidates) {
 
 function buildNextStageSummary(world) {
   const matchingSummary = world.matching.strategySummary
-    || `The world uses ${world.matching.mode} matching before session handoff.`;
+    || `The world uses ${world.matching.mode} matching to deliver candidate summaries before request_chat.`;
+  const reviewSummary =
+    'Review the backend-authored candidate feed, choose a candidate, and create a world-scoped chat request.';
   const sessionSummary = `Matched agents then enter a ${world.sessionTemplate.mode} session with up to ${world.sessionTemplate.maxTurns} turns.`;
 
   return {
     stage: 'matchmaking',
-    summary: `${matchingSummary} ${sessionSummary}`.trim(),
+    summary: `${matchingSummary} ${reviewSummary} ${sessionSummary}`.trim(),
     matchingMode: world.matching.mode,
     matchingCadence: world.matching.cadence,
     sessionMode: world.sessionTemplate.mode,
@@ -143,7 +144,7 @@ export function createMembershipService({ worldService, store = null } = {}) {
         },
         normalizedProfile,
         nextAction:
-          missingFields.length === 0 ? 'join_world_when_membership_persistence_exists' : 'collect_missing_profile_fields',
+          missingFields.length === 0 ? 'call_join_world' : 'retry_join_world_after_profile_update',
       };
 
       const worldDetail = worldService.describeWorldDetail(world.worldId);
@@ -242,15 +243,21 @@ export function createMembershipService({ worldService, store = null } = {}) {
         });
 
       return {
+        status: 'joined',
+        worldId: world.worldId,
         membership,
         membershipStatus: membership.status,
         created: !existingMembership,
+        normalizedProfile: joinCheck.normalizedProfile,
+        nextAction: 'review_candidate_feed',
         nextStageSummary: buildNextStageSummary(world),
         orchestration: buildWorldJoinOutcomeOrchestration({
           worldDetail: worldService.describeWorldDetail(world.worldId),
           joinResult: {
             membershipStatus: membership.status,
             membership,
+            normalizedProfile: joinCheck.normalizedProfile,
+            nextAction: 'review_candidate_feed',
             nextStageSummary: buildNextStageSummary(world),
           },
         }),

package/src/product-shell/search/search-service.js

@@ -348,7 +348,7 @@ export function createWorldSearchService({
         limit: normalizedLimit,
         totalMatches: orderedItems.length,
         items: orderedItems.slice(0, normalizedLimit),
-        nextAction: orderedItems.length > 0 ? 'select_player_and_start_conversation' : 'broaden_search_or_wait',
+        nextAction: orderedItems.length > 0 ? 'request_chat_with_selected_candidate' : 'broaden_search_or_wait',
         status: orderedItems.length > 0 ? 'search_ready' : 'no_matches',
       };
     },

package/src/product-shell/worlds/world-admin-service.js

@@ -227,7 +227,8 @@ function buildSearchSchema(entryProfileSchema) {
   return {
     mode: 'profile_overlap_search',
     inputFieldIds: entryProfileSchema.searchableFieldIds,
-    summary: 'Search active online members by overlap on the world profile fields chosen by the world creator.',
+    summary:
+      'Compatibility-only manual search over active online members. Candidate feed review is the canonical path before request_chat.',
     onlineOnly: true,
     defaultLimit: 10,
   };
@@ -238,7 +239,7 @@ function buildMatchingStrategy(entryProfileSchema) {
     mode: 'profile_overlap',
     cadence: 'on_demand',
     strategySummary:
-      `Rank world members by overlap on ${entryProfileSchema.searchableFieldIds.join(', ')} before opening a conversation.`,
+      `Rank world members by overlap on ${entryProfileSchema.searchableFieldIds.join(', ')}, deliver candidate summaries first, and let members request_chat after review.`,
     candidateSources: ['active_memberships'],
   };
 }

package/src/product-shell/worlds/world-routes.js

@@ -2,6 +2,7 @@ import { authenticateAppTokenRequest, resolveAuthenticatedAgentId } from '../../
 import {
   buildCandidateDeliverySummary,
   buildRequiredFieldExplanation,
+  buildResolvedWorldJoinOrchestration,
   buildWorldSelectionPrompt,
 } from '../contracts/world-orchestration.js';
 
@@ -295,12 +296,33 @@ export function registerWorldRoutes(
         profileSnapshot: req.body?.profileSnapshot,
         maxFieldsPerStep: req.body?.maxFieldsPerStep,
       });
+      const worldDetail = worldService.describeWorldDetail(req.params.worldId);
+      const candidateFeed = matchmakingService.listCandidateFeed({
+        worldId: req.params.worldId,
+        agentId,
+        limit: req.body?.candidateLimit || null,
+      });
+      const candidateDelivery = buildCandidateDeliverySummary(candidateFeed, {
+        worldDetail,
+        limit: req.body?.candidateLimit || candidateFeed.limit || null,
+      });
       res.status(result.created ? 201 : 200).json({
+        status: result.status,
         worldId: req.params.worldId,
         membershipStatus: result.membershipStatus,
+        normalizedProfile: result.normalizedProfile,
         membership: result.membership,
+        nextAction: result.nextAction,
         nextStageSummary: result.nextStageSummary,
-        orchestration: result.orchestration || null,
+        candidateFeed: {
+          ...candidateFeed,
+          candidateDelivery,
+        },
+        candidateDelivery,
+        orchestration: buildResolvedWorldJoinOrchestration({
+          joinResult: result,
+          candidateDelivery,
+        }) || result.orchestration || null,
       });
     } catch (error) {
       sendWorldError(res, error);