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

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

@@ -3,7 +3,7 @@ import { buildRuntimeAuthHeaders } from '../plugin/account-identity.js';
 import { createRuntimeBoundaryError } from '../../lib/runtime-errors.js';
 import { extractBackendErrorContext } from './backend-error-context.js';
 import {
-  buildWorldSelectionPrompt as buildBackendWorldSelectionPrompt,
+  buildCandidateDeliverySummary as buildBackendCandidateDeliverySummary,
   resolveWorldSelection as resolveBackendWorldSelection,
 } from '../../product-shell/contracts/world-orchestration.js';
 
@@ -203,6 +203,12 @@ function normalizeWorldDetail(payload = {}) {
   };
 }
 
+function normalizeNumber(value, fallback = null) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) return fallback;
+  return parsed;
+}
+
 function normalizeProfileSummaryField(field = {}, index = 0) {
   const fieldId = normalizeText(field.fieldId || field.id, `field_${index + 1}`);
   const value = Array.isArray(field.value)
@@ -220,7 +226,7 @@ function normalizeProfileSummaryField(field = {}, index = 0) {
   };
 }
 
-function normalizeMemberProfileSummary(summary = {}) {
+function normalizeCandidateProfileSummary(summary = {}) {
   return {
     displayName: normalizeText(summary.displayName, null),
     headline: normalizeText(summary.headline, null),
@@ -259,6 +265,102 @@ function normalizeBroadcastConfig(broadcast = null) {
   };
 }
 
+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 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),
+    worldFeedbackSummary: candidate.worldFeedbackSummary && typeof candidate.worldFeedbackSummary === 'object'
+      ? {
+          likesReceived: normalizeInteger(candidate.worldFeedbackSummary.likesReceived, 0),
+          dislikesReceived: normalizeInteger(candidate.worldFeedbackSummary.dislikesReceived, 0),
+        }
+      : {
+          likesReceived: 0,
+          dislikesReceived: 0,
+        },
+    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, agentId = null } = {}) {
+  const candidates = Array.isArray(payload.candidates)
+    ? payload.candidates.map((candidate, index) => normalizeCandidate(candidate, index))
+    : [];
+
+  return {
+    worldId: normalizeText(payload.worldId, worldId || 'unknown-world'),
+    agentId: normalizeText(payload.agentId, agentId || null),
+    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',
+    ),
+    candidateDelivery: payload.candidateDelivery && typeof payload.candidateDelivery === 'object'
+      ? payload.candidateDelivery
+      : null,
+    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 normalizeActionPayload(value = null) {
   return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
 }
@@ -311,6 +413,20 @@ function summarizeProfileFields(fields = []) {
     .filter(Boolean);
 }
 
+function buildCandidateDeliverySummaryLine(candidateSummary = {}, index = 0) {
+  return `${index + 1}. ${candidateSummary.summary}`;
+}
+
+export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail = null, limit = null } = {}) {
+  if (candidateFeed?.candidateDelivery && typeof candidateFeed.candidateDelivery === 'object') {
+    return candidateFeed.candidateDelivery;
+  }
+  if (worldDetail?.candidateDelivery && typeof worldDetail.candidateDelivery === 'object') {
+    return worldDetail.candidateDelivery;
+  }
+  return buildBackendCandidateDeliverySummary(candidateFeed, { worldDetail, limit });
+}
+
 export function buildWorldSelectionPrompt(worldDirectory = {}) {
   return worldDirectory?.orchestration && typeof worldDirectory.orchestration === 'object'
     ? worldDirectory.orchestration
@@ -360,10 +476,7 @@ export function buildPostSetupWorldDirectory(payload = {}, {
     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
-      : buildBackendWorldSelectionPrompt({
-        items,
-        recommendedWorldId,
-      }),
+      : null,
   };
 }
 
@@ -382,7 +495,7 @@ function normalizeWorldMemberSearchItem(item = {}) {
     matchedFieldIds: normalizeStringList(item.matchedFieldIds),
     reasonSummary: normalizeText(item.reasonSummary, null),
     joinedAt: normalizeText(item.joinedAt, null),
-    profileSummary: normalizeMemberProfileSummary(item.profileSummary || {}),
+    profileSummary: normalizeCandidateProfileSummary(item.profileSummary || {}),
     worldFeedbackSummary: item.worldFeedbackSummary && typeof item.worldFeedbackSummary === 'object' && !Array.isArray(item.worldFeedbackSummary)
       ? {
         likesReceived: normalizeInteger(item.worldFeedbackSummary.likesReceived, 0),
@@ -406,10 +519,10 @@ export function normalizeWorldMemberSearchResponse(payload = {}, { accountId = n
     accountId: normalizeText(accountId, null),
     worldId: normalizeText(payload.worldId, null),
     query: normalizeText(payload.query, null),
-    sort: normalizeText(payload.sort, 'relevance'),
+    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_result' : 'broaden_search'),
+    nextAction: normalizeText(payload.nextAction, items.length > 0 ? 'request_chat_with_selected_candidate' : 'broaden_search_or_refresh_candidate_feed'),
     items,
   };
 }
@@ -534,13 +647,6 @@ export async function searchWorlds({
   accountId = null,
   runtimeConfig = null,
   query = null,
-  keywords = [],
-  topics = [],
-  location = null,
-  timeWindow = null,
-  intent = null,
-  desiredInteraction = null,
-  constraints = [],
   limit = null,
   sort = null,
   page = null,
@@ -562,13 +668,6 @@ export async function searchWorlds({
     }),
     body: JSON.stringify({
       query: normalizeText(query, null),
-      keywords: normalizeStringList(keywords),
-      topics: normalizeStringList(topics),
-      location: normalizeText(location, null),
-      timeWindow: normalizeText(timeWindow, null),
-      intent: normalizeText(intent, null),
-      desiredInteraction: normalizeText(desiredInteraction, null),
-      constraints: normalizeStringList(constraints),
       sort: normalizeText(sort, null),
       limit: limit == null ? null : normalizeInteger(limit, 0),
       page: page == null ? null : normalizeInteger(page, 0),
@@ -600,13 +699,6 @@ export async function search({
   worldId = null,
   agentId = null,
   query = null,
-  keywords = [],
-  topics = [],
-  location = null,
-  timeWindow = null,
-  intent = null,
-  desiredInteraction = null,
-  constraints = [],
   limit = null,
   sort = null,
   page = null,
@@ -631,13 +723,6 @@ export async function search({
       worldId: normalizeText(worldId, null),
       agentId: normalizeText(agentId, null),
       query: normalizeText(query, null),
-      keywords: normalizeStringList(keywords),
-      topics: normalizeStringList(topics),
-      location: normalizeText(location, null),
-      timeWindow: normalizeText(timeWindow, null),
-      intent: normalizeText(intent, null),
-      desiredInteraction: normalizeText(desiredInteraction, null),
-      constraints: normalizeStringList(constraints),
       sort: normalizeText(sort, null),
       limit: limit == null ? null : normalizeInteger(limit, 0),
       page: page == null ? null : normalizeInteger(page, 0),
@@ -664,122 +749,94 @@ export async function search({
   };
 }
 
-export async function getPublicProfile({
+export async function joinWorld({
   cfg = {},
   accountId = null,
   runtimeConfig = null,
+  worldId = null,
   agentId = null,
-  viewerAgentId = null,
+  participantContextText = null,
   fetchImpl,
   logger = console,
 } = {}) {
   if (typeof fetchImpl !== 'function') {
-    throw new Error('fetch is unavailable for claworld public-profile helper');
+    throw new Error('fetch is unavailable for claworld product-shell join helper');
   }
+
+  const resolvedWorldId = normalizeText(worldId, null);
+  if (!resolvedWorldId) {
+    throw new Error('claworld product-shell join helper requires worldId');
+  }
+
   const resolvedAgentId = normalizeText(agentId, null);
   if (!resolvedAgentId) {
-    throw new Error('claworld public-profile helper requires agentId');
+    throw new Error('claworld product-shell join helper requires agentId');
   }
+
   const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
   const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
-  const requestUrl = new URL(`${baseUrl}/v1/public-profiles/${encodeURIComponent(resolvedAgentId)}`);
-  const resolvedViewerAgentId = normalizeText(viewerAgentId, null);
-  if (resolvedViewerAgentId) requestUrl.searchParams.set('viewerAgentId', resolvedViewerAgentId);
-  const profileResult = await fetchJson(fetchImpl, requestUrl.toString(), {
+  const joinResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/join`, {
+    method: 'POST',
     headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
       accept: 'application/json',
+      'content-type': 'application/json',
       ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
     }),
-  });
-  if (!profileResult.ok) {
-    logger.error?.('[claworld:product-shell] public profile fetch failed', {
-      status: profileResult.status,
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+    body: JSON.stringify({
       agentId: resolvedAgentId,
-      body: profileResult.body,
-    });
-    throw createProductShellHttpError('public_profile', profileResult, {
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-    });
-  }
-  return {
-    accountId: resolvedRuntimeConfig.accountId || accountId || null,
-    ...profileResult.body,
-  };
-}
-
-export async function lookupPublicProfile({
-  cfg = {},
-  accountId = null,
-  runtimeConfig = null,
-  identity = null,
-  viewerAgentId = null,
-  fetchImpl,
-  logger = console,
-} = {}) {
-  if (typeof fetchImpl !== 'function') {
-    throw new Error('fetch is unavailable for claworld public-profile helper');
-  }
-  const resolvedIdentity = normalizeText(identity, null);
-  if (!resolvedIdentity) {
-    throw new Error('claworld public-profile lookup helper requires identity');
-  }
-  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
-  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
-  const requestUrl = new URL(`${baseUrl}/v1/public-profiles/lookup`);
-  requestUrl.searchParams.set('identity', resolvedIdentity);
-  const resolvedViewerAgentId = normalizeText(viewerAgentId, null);
-  if (resolvedViewerAgentId) requestUrl.searchParams.set('viewerAgentId', resolvedViewerAgentId);
-  const profileResult = await fetchJson(fetchImpl, requestUrl.toString(), {
-    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
-      accept: 'application/json',
-      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
+      participantContextText: normalizeText(participantContextText, null),
     }),
   });
-  if (!profileResult.ok) {
-    logger.error?.('[claworld:product-shell] public profile lookup failed', {
-      status: profileResult.status,
+
+  if (!joinResult.ok) {
+    logger.error?.('[claworld:product-shell] world join failed', {
+      status: joinResult.status,
+      worldId: resolvedWorldId,
+      agentId: resolvedAgentId,
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      identity: resolvedIdentity,
-      body: profileResult.body,
+      body: joinResult.body,
     });
-    throw createProductShellHttpError('public_profile_lookup', profileResult, {
+    throw createProductShellHttpError('world_join', joinResult, {
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
     });
   }
-  return {
-    accountId: resolvedRuntimeConfig.accountId || accountId || null,
-    ...profileResult.body,
-  };
+
+  return normalizeWorldJoinResponse(joinResult.body, {
+    worldId: resolvedWorldId,
+    agentId: resolvedAgentId,
+  });
 }
 
-export async function joinWorld({
+export async function searchWorldMembers({
   cfg = {},
   accountId = null,
   runtimeConfig = null,
   worldId = null,
   agentId = null,
-  participantContextText = null,
+  query = null,
+  sort = null,
+  limit = null,
   fetchImpl,
   logger = console,
 } = {}) {
   if (typeof fetchImpl !== 'function') {
-    throw new Error('fetch is unavailable for claworld product-shell join helper');
+    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 join helper requires worldId');
+    throw new Error('claworld product-shell member search helper requires worldId');
   }
 
   const resolvedAgentId = normalizeText(agentId, null);
   if (!resolvedAgentId) {
-    throw new Error('claworld product-shell join helper requires agentId');
+    throw new Error('claworld product-shell member search helper requires agentId');
   }
 
   const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
   const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
-  const joinResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/join`, {
+  const searchResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/search`, {
     method: 'POST',
     headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
       accept: 'application/json',
@@ -788,65 +845,58 @@ export async function joinWorld({
     }),
     body: JSON.stringify({
       agentId: resolvedAgentId,
-      participantContextText: normalizeText(participantContextText, null),
+      query: normalizeText(query, null),
+      sort: normalizeText(sort, null),
+      limit: limit == null ? null : normalizeInteger(limit, 0),
     }),
   });
 
-  if (!joinResult.ok) {
-    logger.error?.('[claworld:product-shell] world join failed', {
-      status: joinResult.status,
+  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: joinResult.body,
+      body: searchResult.body,
     });
-    throw createProductShellHttpError('world_join', joinResult, {
+    throw createProductShellHttpError('world_member_search', searchResult, {
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       worldId: resolvedWorldId,
     });
   }
 
-  return normalizeWorldJoinResponse(joinResult.body, {
-    worldId: resolvedWorldId,
-    agentId: resolvedAgentId,
+  return normalizeWorldMemberSearchResponse(searchResult.body, {
+    accountId: resolvedRuntimeConfig.accountId || accountId || null,
   });
 }
 
-export async function searchWorldMembers({
+export async function fetchWorldCandidateFeed({
   cfg = {},
   accountId = null,
   runtimeConfig = null,
   worldId = null,
   agentId = null,
-  query = null,
-  keywords = [],
-  topics = [],
-  location = null,
-  timeWindow = null,
-  intent = null,
-  desiredInteraction = null,
-  constraints = [],
-  sort = null,
   limit = null,
   fetchImpl,
   logger = console,
 } = {}) {
   if (typeof fetchImpl !== 'function') {
-    throw new Error('fetch is unavailable for claworld product-shell member search helper');
+    throw new Error('fetch is unavailable for claworld product-shell candidate feed helper');
   }
 
   const resolvedWorldId = normalizeText(worldId, null);
   if (!resolvedWorldId) {
-    throw new Error('claworld product-shell member search helper requires worldId');
+    throw new Error('claworld product-shell candidate feed helper requires worldId');
   }
 
   const resolvedAgentId = normalizeText(agentId, null);
   if (!resolvedAgentId) {
-    throw new Error('claworld product-shell member search helper requires agentId');
+    throw new Error('claworld product-shell candidate feed helper requires agentId');
   }
 
   const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
   const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
+  const normalizedLimit = normalizeInteger(limit, 0);
   const searchResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/search`, {
     method: 'POST',
     headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
@@ -856,36 +906,60 @@ export async function searchWorldMembers({
     }),
     body: JSON.stringify({
       agentId: resolvedAgentId,
-      query: normalizeText(query, null),
-      keywords: normalizeStringList(keywords),
-      topics: normalizeStringList(topics),
-      location: normalizeText(location, null),
-      timeWindow: normalizeText(timeWindow, null),
-      intent: normalizeText(intent, null),
-      desiredInteraction: normalizeText(desiredInteraction, null),
-      constraints: normalizeStringList(constraints),
-      sort: normalizeText(sort, null),
-      limit: limit == null ? null : normalizeInteger(limit, 0),
+      query: null,
+      sort: 'match',
+      limit: normalizedLimit > 0 ? normalizedLimit : null,
     }),
   });
 
   if (!searchResult.ok) {
-    logger.error?.('[claworld:product-shell] world member search failed', {
+    logger.error?.('[claworld:product-shell] candidate feed compatibility search failed', {
       status: searchResult.status,
       worldId: resolvedWorldId,
       agentId: resolvedAgentId,
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       body: searchResult.body,
     });
-    throw createProductShellHttpError('world_member_search', searchResult, {
+    throw createProductShellHttpError('world_candidate_feed', searchResult, {
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       worldId: resolvedWorldId,
     });
   }
 
-  return normalizeWorldMemberSearchResponse(searchResult.body, {
+  const searchPayload = searchResult.body && typeof searchResult.body === 'object' ? searchResult.body : {};
+  const normalizedSearch = normalizeWorldMemberSearchResponse(searchPayload, {
     accountId: resolvedRuntimeConfig.accountId || accountId || null,
   });
+  return normalizeCandidateFeedResponse({
+    worldId: resolvedWorldId,
+    agentId: resolvedAgentId,
+    viewerMembershipId: searchPayload.viewerMembershipId,
+    generatedAt: searchPayload.generatedAt,
+    limit: normalizedSearch.limit,
+    totalCandidates: normalizedSearch.totalMatches,
+    candidateSource: searchPayload.candidateSource || 'active_memberships',
+    status: normalizedSearch.items.length > 0 ? 'feed_ready' : 'no_candidates_ready',
+    nextAction: normalizedSearch.nextAction,
+    candidates: normalizedSearch.items.map((item, index) => ({
+      candidateId: item.membershipId || `candidate_${index + 1}`,
+      sourceMembershipId: item.membershipId || null,
+      worldId: item.worldId || resolvedWorldId,
+      online: item.online === true,
+      rank: index + 1,
+      score: item.score,
+      agentCode: item.agentCode,
+      requestChat: item.requestChat,
+      profileSummary: item.profileSummary,
+      deliveryReason: {
+        summary: item.reasonSummary || item.headline || null,
+      },
+      worldFeedbackSummary: item.worldFeedbackSummary,
+      joinedAt: item.joinedAt,
+    })),
+  }, {
+    worldId: resolvedWorldId,
+    agentId: resolvedAgentId,
+  });
 }
 
 export async function resolveWorldSelectionFlow({