@xfxstudio/claworld 2026.4.22-testing.7 → 2026.4.27-testing.1

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 {
-  buildCandidateDeliverySummary as buildBackendCandidateDeliverySummary,
+  buildWorldSelectionPrompt as buildBackendWorldSelectionPrompt,
   resolveWorldSelection as resolveBackendWorldSelection,
 } from '../../product-shell/contracts/world-orchestration.js';
 
@@ -203,12 +203,6 @@ 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)
@@ -226,7 +220,7 @@ function normalizeProfileSummaryField(field = {}, index = 0) {
   };
 }
 
-function normalizeCandidateProfileSummary(summary = {}) {
+function normalizeMemberProfileSummary(summary = {}) {
   return {
     displayName: normalizeText(summary.displayName, null),
     headline: normalizeText(summary.headline, null),
@@ -265,102 +259,6 @@ 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;
 }
@@ -413,20 +311,6 @@ 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
@@ -476,7 +360,10 @@ 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
-      : null,
+      : buildBackendWorldSelectionPrompt({
+        items,
+        recommendedWorldId,
+      }),
   };
 }
 
@@ -495,7 +382,7 @@ function normalizeWorldMemberSearchItem(item = {}) {
     matchedFieldIds: normalizeStringList(item.matchedFieldIds),
     reasonSummary: normalizeText(item.reasonSummary, null),
     joinedAt: normalizeText(item.joinedAt, null),
-    profileSummary: normalizeCandidateProfileSummary(item.profileSummary || {}),
+    profileSummary: normalizeMemberProfileSummary(item.profileSummary || {}),
     worldFeedbackSummary: item.worldFeedbackSummary && typeof item.worldFeedbackSummary === 'object' && !Array.isArray(item.worldFeedbackSummary)
       ? {
         likesReceived: normalizeInteger(item.worldFeedbackSummary.likesReceived, 0),
@@ -519,10 +406,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, 'match'),
+    sort: normalizeText(payload.sort, 'relevance'),
     limit: normalizeInteger(payload.limit, items.length),
     totalMatches: normalizeInteger(payload.totalMatches, items.length),
-    nextAction: normalizeText(payload.nextAction, items.length > 0 ? 'request_chat_with_selected_candidate' : 'broaden_search_or_refresh_candidate_feed'),
+    nextAction: normalizeText(payload.nextAction, items.length > 0 ? 'request_chat_with_selected_result' : 'broaden_search'),
     items,
   };
 }
@@ -647,6 +534,13 @@ 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,
@@ -668,6 +562,13 @@ 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),
@@ -699,6 +600,13 @@ 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,
@@ -723,6 +631,13 @@ 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),
@@ -749,94 +664,122 @@ export async function search({
   };
 }
 
-export async function joinWorld({
+export async function getPublicProfile({
   cfg = {},
   accountId = null,
   runtimeConfig = null,
-  worldId = null,
   agentId = null,
-  participantContextText = null,
+  viewerAgentId = 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 public-profile 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 product-shell join helper requires agentId');
+    throw new Error('claworld public-profile 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`, {
-    method: 'POST',
+  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(), {
     headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
       accept: 'application/json',
-      'content-type': 'application/json',
       ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
     }),
-    body: JSON.stringify({
-      agentId: resolvedAgentId,
-      participantContextText: normalizeText(participantContextText, null),
-    }),
   });
-
-  if (!joinResult.ok) {
-    logger.error?.('[claworld:product-shell] world join failed', {
-      status: joinResult.status,
-      worldId: resolvedWorldId,
-      agentId: resolvedAgentId,
+  if (!profileResult.ok) {
+    logger.error?.('[claworld:product-shell] public profile fetch failed', {
+      status: profileResult.status,
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      body: joinResult.body,
+      agentId: resolvedAgentId,
+      body: profileResult.body,
     });
-    throw createProductShellHttpError('world_join', joinResult, {
+    throw createProductShellHttpError('public_profile', profileResult, {
       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 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 } : {}),
+    }),
   });
+  if (!profileResult.ok) {
+    logger.error?.('[claworld:product-shell] public profile lookup failed', {
+      status: profileResult.status,
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      identity: resolvedIdentity,
+      body: profileResult.body,
+    });
+    throw createProductShellHttpError('public_profile_lookup', profileResult, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+    });
+  }
+  return {
+    accountId: resolvedRuntimeConfig.accountId || accountId || null,
+    ...profileResult.body,
+  };
 }
 
-export async function searchWorldMembers({
+export async function joinWorld({
   cfg = {},
   accountId = null,
   runtimeConfig = null,
   worldId = null,
   agentId = null,
-  query = null,
-  sort = null,
-  limit = null,
+  participantContextText = 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 join 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 join 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 join helper requires agentId');
   }
 
   const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
   const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
-  const searchResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/search`, {
+  const joinResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/join`, {
     method: 'POST',
     headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
       accept: 'application/json',
@@ -845,58 +788,65 @@ export async function searchWorldMembers({
     }),
     body: JSON.stringify({
       agentId: resolvedAgentId,
-      query: normalizeText(query, null),
-      sort: normalizeText(sort, null),
-      limit: limit == null ? null : normalizeInteger(limit, 0),
+      participantContextText: normalizeText(participantContextText, null),
     }),
   });
 
-  if (!searchResult.ok) {
-    logger.error?.('[claworld:product-shell] world member search failed', {
-      status: searchResult.status,
+  if (!joinResult.ok) {
+    logger.error?.('[claworld:product-shell] world join failed', {
+      status: joinResult.status,
       worldId: resolvedWorldId,
       agentId: resolvedAgentId,
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      body: searchResult.body,
+      body: joinResult.body,
     });
-    throw createProductShellHttpError('world_member_search', searchResult, {
+    throw createProductShellHttpError('world_join', joinResult, {
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       worldId: resolvedWorldId,
     });
   }
 
-  return normalizeWorldMemberSearchResponse(searchResult.body, {
-    accountId: resolvedRuntimeConfig.accountId || accountId || null,
+  return normalizeWorldJoinResponse(joinResult.body, {
+    worldId: resolvedWorldId,
+    agentId: resolvedAgentId,
   });
 }
 
-export async function fetchWorldCandidateFeed({
+export async function searchWorldMembers({
   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 candidate feed 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 candidate feed 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 candidate feed 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 normalizedLimit = normalizeInteger(limit, 0);
   const searchResult = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/search`, {
     method: 'POST',
     headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
@@ -906,60 +856,36 @@ export async function fetchWorldCandidateFeed({
     }),
     body: JSON.stringify({
       agentId: resolvedAgentId,
-      query: null,
-      sort: 'match',
-      limit: normalizedLimit > 0 ? normalizedLimit : 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),
     }),
   });
 
   if (!searchResult.ok) {
-    logger.error?.('[claworld:product-shell] candidate feed compatibility search failed', {
+    logger.error?.('[claworld:product-shell] world member search failed', {
       status: searchResult.status,
       worldId: resolvedWorldId,
       agentId: resolvedAgentId,
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       body: searchResult.body,
     });
-    throw createProductShellHttpError('world_candidate_feed', searchResult, {
+    throw createProductShellHttpError('world_member_search', searchResult, {
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       worldId: resolvedWorldId,
     });
   }
 
-  const searchPayload = searchResult.body && typeof searchResult.body === 'object' ? searchResult.body : {};
-  const normalizedSearch = normalizeWorldMemberSearchResponse(searchPayload, {
+  return normalizeWorldMemberSearchResponse(searchResult.body, {
     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({