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

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

@@ -10,12 +10,6 @@ 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))];
@@ -214,147 +208,6 @@ 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
@@ -605,133 +458,11 @@ 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;
-  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),
-    ),
-  };
+  return joinOrchestration;
 }