@xfxstudio/claworld 0.2.9 → 0.2.10-beta.0

package/src/openclaw/runtime/backend-error-context.js

@@ -0,0 +1,91 @@
+function normalizeText(value, fallback = null) {
+  if (value == null) return fallback;
+  const normalized = String(value).trim();
+  return normalized || fallback;
+}
+
+function normalizeFieldError(fieldError = {}) {
+  const fieldId = normalizeText(fieldError.fieldId, null);
+  const message = normalizeText(fieldError.message, null);
+  const code = normalizeText(fieldError.code, null);
+  if (!fieldId && !message && !code) return null;
+  return {
+    ...(fieldId ? { fieldId } : {}),
+    ...(message ? { message } : {}),
+    ...(code ? { code } : {}),
+  };
+}
+
+function normalizeMissingField(field = {}) {
+  const fieldId = normalizeText(field.fieldId, null);
+  const label = normalizeText(field.label, null);
+  const description = normalizeText(field.description, null);
+  const message = normalizeText(field.message, null);
+  const code = normalizeText(field.code, null);
+  if (!fieldId && !label && !description && !message && !code) return null;
+  return {
+    ...(fieldId ? { fieldId } : {}),
+    ...(label ? { label } : {}),
+    ...(description ? { description } : {}),
+    ...(message ? { message } : {}),
+    ...(code ? { code } : {}),
+  };
+}
+
+function normalizePublicIdentity(publicIdentity = {}) {
+  const status = normalizeText(publicIdentity.status, null);
+  const displayName = normalizeText(publicIdentity.displayName, null);
+  const code = normalizeText(publicIdentity.code, null);
+  const displayIdentity = normalizeText(publicIdentity.displayIdentity, null);
+  const confirmedAt = normalizeText(publicIdentity.confirmedAt, null);
+  const updatedAt = normalizeText(publicIdentity.updatedAt, null);
+  if (!status && !displayName && !code && !displayIdentity && !confirmedAt && !updatedAt) return null;
+  return {
+    ...(status ? { status } : {}),
+    ...(displayName ? { displayName } : {}),
+    ...(code ? { code } : {}),
+    ...(displayIdentity ? { displayIdentity } : {}),
+    ...(confirmedAt ? { confirmedAt } : {}),
+    ...(updatedAt ? { updatedAt } : {}),
+  };
+}
+
+export function normalizeBackendFieldError(fieldError = {}) {
+  return normalizeFieldError(fieldError);
+}
+
+export function normalizeBackendMissingField(field = {}) {
+  return normalizeMissingField(field);
+}
+
+export function normalizeBackendPublicIdentity(publicIdentity = {}) {
+  return normalizePublicIdentity(publicIdentity);
+}
+
+export function extractBackendErrorContext(payload = {}) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return {};
+
+  const backendCode = normalizeText(payload.error, null);
+  const backendMessage = normalizeText(payload.message, null);
+  const requiredAction = normalizeText(payload.requiredAction, null);
+  const nextAction = normalizeText(payload.nextAction, null);
+  const nextTool = normalizeText(payload.nextTool, null);
+  const fieldErrors = Array.isArray(payload.fieldErrors)
+    ? payload.fieldErrors.map((fieldError) => normalizeFieldError(fieldError)).filter(Boolean)
+    : [];
+  const missingFields = Array.isArray(payload.missingFields)
+    ? payload.missingFields.map((field) => normalizeMissingField(field)).filter(Boolean)
+    : [];
+  const publicIdentity = normalizePublicIdentity(payload.publicIdentity);
+
+  return {
+    ...(backendCode ? { backendCode } : {}),
+    ...(backendMessage ? { backendMessage } : {}),
+    ...(requiredAction ? { requiredAction } : {}),
+    ...(nextAction ? { nextAction } : {}),
+    ...(nextTool ? { nextTool } : {}),
+    ...(fieldErrors.length > 0 ? { fieldErrors } : {}),
+    ...(missingFields.length > 0 ? { missingFields } : {}),
+    ...(publicIdentity ? { publicIdentity } : {}),
+  };
+}

package/src/openclaw/runtime/feedback-helper.js

@@ -114,7 +114,6 @@ export async function submitFeedbackReport({
         turnId: normalizeText(normalizedContext.turnId, null),
         deliveryId: normalizeText(normalizedContext.deliveryId, null),
         targetAgentId: normalizeText(normalizedContext.targetAgentId, null),
-        targetAgentCode: normalizeText(normalizedContext.targetAgentCode, null),
         tags: normalizeStringList(normalizedContext.tags),
         metadata: normalizeObject(normalizedContext.metadata),
       },
@@ -128,7 +127,7 @@ export async function submitFeedbackReport({
         accountId: normalizeText(resolvedRuntimeConfig.accountId, normalizeText(accountId, null)),
         serverUrl: baseUrl,
         relayAgentId: resolvedAgentId,
-        defaultToAddress: normalizeText(resolvedRuntimeConfig.relay?.defaultToAddress, null),
+        defaultTargetAgentId: normalizeText(resolvedRuntimeConfig.relay?.defaultTargetAgentId, null),
       },
     }),
   });

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

@@ -1,6 +1,7 @@
 import { resolveClaworldRuntimeConfig } from '../plugin/config-schema.js';
 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,
@@ -337,6 +338,15 @@ function normalizeCandidate(candidate = {}, index = 0) {
       ? 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)),
@@ -437,7 +447,6 @@ function normalizeWorldSearchItem(item = {}, index = 0) {
     worldId: normalizeText(item.worldId, 'unknown-world'),
     displayName: normalizeText(item.displayName, `Player ${index + 1}`),
     headline: normalizeText(item.headline, null),
-    address: normalizeText(item.address, null),
     online: item.online === true,
     connectedAt: normalizeText(item.connectedAt, null),
     lastHeartbeatAt: normalizeText(item.lastHeartbeatAt, null),
@@ -450,6 +459,15 @@ function normalizeWorldSearchItem(item = {}, index = 0) {
     reasonSummary: normalizeText(item.reasonSummary, ''),
     joinedAt: normalizeText(item.joinedAt, null),
     profileSummary: normalizeCandidateProfileSummary(item.profileSummary),
+    worldFeedbackSummary: item.worldFeedbackSummary && typeof item.worldFeedbackSummary === 'object'
+      ? {
+          likesReceived: normalizeInteger(item.worldFeedbackSummary.likesReceived, 0),
+          dislikesReceived: normalizeInteger(item.worldFeedbackSummary.dislikesReceived, 0),
+        }
+      : {
+          likesReceived: 0,
+          dislikesReceived: 0,
+        },
   };
 }
 
@@ -686,8 +704,7 @@ function createProductShellHttpError(action, response, { accountId = null, world
       accountId,
       ...(worldId ? { worldId } : {}),
       httpStatus: response?.status ?? 500,
-      backendCode,
-      backendMessage,
+      ...extractBackendErrorContext(response?.body),
     },
   });
 }
@@ -776,7 +793,10 @@ export async function fetchWorldDetail({
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       body: detail.body,
     });
-    throw new Error(`claworld product-shell world detail fetch failed: ${detail.status}`);
+    throw createProductShellHttpError('world_detail', detail, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
   }
 
   return normalizeWorldDetail(detail.body);
@@ -830,7 +850,10 @@ export async function joinWorld({
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       body: joinResult.body,
     });
-    throw new Error(`claworld product-shell world join failed: ${joinResult.status}`);
+    throw createProductShellHttpError('world_join', joinResult, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
   }
 
   return normalizeWorldJoinResponse(joinResult.body, {
@@ -890,7 +913,10 @@ export async function fetchWorldSearch({
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       body: searchResult.body,
     });
-    throw new Error(`claworld product-shell world search failed: ${searchResult.status}`);
+    throw createProductShellHttpError('world_search', searchResult, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
   }
 
   return normalizeWorldSearchResponse(searchResult.body, {
@@ -950,7 +976,10 @@ export async function submitWorldSearch({
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       body: searchResult.body,
     });
-    throw new Error(`claworld product-shell world search failed: ${searchResult.status}`);
+    throw createProductShellHttpError('world_search', searchResult, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
   }
 
   if (searchResult.status === 409) {
@@ -1095,7 +1124,10 @@ export async function fetchWorldCandidateFeed({
       accountId: resolvedRuntimeConfig.accountId || accountId || null,
       body: candidateFeed.body,
     });
-    throw new Error(`claworld product-shell candidate feed failed: ${candidateFeed.status}`);
+    throw createProductShellHttpError('world_candidate_feed', candidateFeed, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
   }
 
   return normalizeCandidateFeedResponse(candidateFeed.body, {
@@ -1136,7 +1168,9 @@ export async function resolveWorldSelectionFlow({
           accountId: resolvedRuntimeConfig.accountId || accountId || null,
           body: worlds.body,
         });
-        throw new Error(`claworld product-shell world fetch failed: ${worlds.status}`);
+        throw createProductShellHttpError('world_directory', worlds, {
+          accountId: resolvedRuntimeConfig.accountId || accountId || null,
+        });
       }
 
       return buildPostSetupWorldDirectory(worlds.body, {

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

@@ -85,6 +85,26 @@ function projectWorldStats(stats = null) {
     totalParticipants: normalizeOptionalInteger(stats.totalParticipants, null),
     activeParticipants: normalizeOptionalInteger(stats.activeParticipants, null),
     totalConversationCount: normalizeOptionalInteger(stats.totalConversationCount, null),
+    totalLikes: normalizeOptionalInteger(stats.totalLikes, null),
+    totalDislikes: normalizeOptionalInteger(stats.totalDislikes, null),
+  };
+}
+
+function projectWorldFeedbackSummary(summary = null) {
+  if (!summary || typeof summary !== 'object' || Array.isArray(summary)) return null;
+  return {
+    likesReceived: normalizeInteger(summary.likesReceived, 0),
+    dislikesReceived: normalizeInteger(summary.dislikesReceived, 0),
+  };
+}
+
+function projectConversationFeedbackSummary(summary = null) {
+  if (!summary || typeof summary !== 'object' || Array.isArray(summary)) return null;
+  return {
+    likeCount: normalizeInteger(summary.likeCount, 0),
+    dislikeCount: normalizeInteger(summary.dislikeCount, 0),
+    viewerGave: normalizeText(summary.viewerGave, null),
+    viewerReceived: normalizeText(summary.viewerReceived, null),
   };
 }
 
@@ -254,6 +274,7 @@ function projectToolCandidateSummary(summary = {}, index = 0) {
     score: normalizeInteger(summary.score, 0) || null,
     summary: normalizeText(summary.summary, null),
     expiresAt: normalizeText(summary.expiresAt, null),
+    worldFeedbackSummary: projectWorldFeedbackSummary(summary.worldFeedbackSummary),
   };
 }
 
@@ -277,6 +298,7 @@ function projectToolCandidateFeed(joinResult = {}) {
         score: candidate.score,
         summary: normalizeText(candidate.deliveryReason?.summary, null),
         expiresAt: candidate.expiresAt,
+        worldFeedbackSummary: candidate.worldFeedbackSummary,
       }, index))
       : [];
 
@@ -354,6 +376,7 @@ export function projectToolSearchWorldResponse(searchResult = {}, { accountId =
       matchReasons: projectSearchMatchReasons(item),
       profileSnippet: summarizeProfileSnippet(item.profileSummary),
       online: item.online === true,
+      worldFeedbackSummary: projectWorldFeedbackSummary(item.worldFeedbackSummary),
     }))
     : [];
 
@@ -482,7 +505,7 @@ export function projectToolFeedbackSubmissionResponse(result = {}) {
     title: normalizeText(feedback.title, null),
     accountId: normalizeText(feedback.accountId, null),
     reporterAgentId: normalizeText(reporter.agentId, null),
-    reporterAgentCode: normalizeText(reporter.agentCode, null),
+    reporterIdentity: normalizeText(reporter.publicIdentity?.displayIdentity, null),
     worldId: normalizeText(context.worldId, null),
     conversationKey: normalizeText(context.conversationKey, null),
     turnId: normalizeText(context.turnId, null),
@@ -503,9 +526,8 @@ function projectToolAgentSummary(agent = {}) {
   if (!agent || typeof agent !== 'object') return null;
   return {
     agentId: normalizeText(agent.agentId, null),
-    agentCode: normalizeText(agent.agentCode, null),
-    address: normalizeText(agent.address, null),
     displayName: normalizeText(agent.displayName, null),
+    identity: normalizeText(agent.publicIdentity?.displayIdentity, null),
     online: agent.online === true,
     discoverable: typeof agent.discoverable === 'boolean' ? agent.discoverable : null,
     contactable: typeof agent.contactable === 'boolean' ? agent.contactable : null,
@@ -635,6 +657,7 @@ function projectChatInboxChatItem(chat = {}) {
     localSessionKey: normalizeText(chat.localSessionKey, normalizeText(chat.sessionKey, null)),
     counterparty: projectToolAgentSummary(chat.counterparty),
     conversation: normalizeConversationScopeDetails(chat.conversation),
+    feedbackSummary: projectConversationFeedbackSummary(chat.feedbackSummary),
   };
 }
 

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

@@ -11,6 +11,11 @@ export const CLAWORLD_BOOTSTRAP_TOOL_NAMES = Object.freeze([
   'claworld_pair_agent',
 ]);
 
+export const CLAWORLD_PROFILE_TOOL_NAMES = Object.freeze([
+  'claworld_get_public_identity',
+  'claworld_update_public_identity',
+]);
+
 export const CLAWORLD_FEEDBACK_TOOL_NAMES = Object.freeze([
   'claworld_submit_feedback',
 ]);
@@ -43,6 +48,7 @@ export const CLAWORLD_RETIRED_PUBLIC_TOOL_NAMES = Object.freeze([
 
 export const CLAWORLD_REGISTERED_TOOL_NAMES = Object.freeze([
   ...CLAWORLD_BOOTSTRAP_TOOL_NAMES,
+  ...CLAWORLD_PROFILE_TOOL_NAMES,
   ...CLAWORLD_WORLD_TOOL_NAMES,
   ...CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES,
   ...CLAWORLD_CHAT_REQUEST_TOOL_NAMES,
@@ -67,6 +73,7 @@ export const CLAWORLD_READ_ONLY_OPENCLAW_TOOL_NAMES = Object.freeze([
 
 export const CLAWORLD_PLUGIN_SMOKE_REQUIRED_TOOL_NAMES = Object.freeze([
   ...CLAWORLD_BOOTSTRAP_TOOL_NAMES,
+  ...CLAWORLD_PROFILE_TOOL_NAMES,
   ...CLAWORLD_WORLD_TOOL_NAMES,
   ...CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES,
   ...CLAWORLD_CHAT_REQUEST_TOOL_NAMES,

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

@@ -1,6 +1,7 @@
 import { resolveClaworldRuntimeConfig } from '../plugin/config-schema.js';
 import { buildRuntimeAuthHeaders } from '../plugin/account-identity.js';
 import { createRuntimeBoundaryError } from '../../lib/runtime-errors.js';
+import { extractBackendErrorContext } from './backend-error-context.js';
 
 function normalizeText(value, fallback = null) {
   if (value == null) return fallback;
@@ -36,18 +37,6 @@ function normalizeStringList(values = []) {
   return [...new Set(values.map((value) => normalizeText(value, null)).filter(Boolean))];
 }
 
-function normalizeFieldError(fieldError = {}) {
-  const fieldId = normalizeText(fieldError.fieldId, null);
-  const message = normalizeText(fieldError.message, null);
-  const code = normalizeText(fieldError.code, null);
-  if (!fieldId && !message && !code) return null;
-  return {
-    ...(fieldId ? { fieldId } : {}),
-    ...(message ? { message } : {}),
-    ...(code ? { code } : {}),
-  };
-}
-
 function normalizeParticipantContextField(field = {}, index = 0) {
   return {
     fieldId: normalizeText(field.fieldId, `field_${index + 1}`),
@@ -160,9 +149,6 @@ function inferHttpErrorCategory(status) {
 function createModerationHttpError(action, response, { accountId = null, worldId = null } = {}) {
   const backendCode = normalizeText(response?.body?.error, null);
   const backendMessage = normalizeText(response?.body?.message, `claworld world ${action} failed`);
-  const fieldErrors = Array.isArray(response?.body?.fieldErrors)
-    ? response.body.fieldErrors.map((fieldError) => normalizeFieldError(fieldError)).filter(Boolean)
-    : [];
 
   return createRuntimeBoundaryError({
     code: backendCode || `claworld_world_${action}_failed`,
@@ -176,9 +162,7 @@ function createModerationHttpError(action, response, { accountId = null, worldId
       accountId,
       ...(worldId ? { worldId } : {}),
       httpStatus: response?.status ?? 500,
-      backendCode,
-      backendMessage,
-      ...(fieldErrors.length > 0 ? { fieldErrors } : {}),
+      ...extractBackendErrorContext(response?.body),
     },
   });
 }
@@ -190,7 +174,7 @@ export async function createModeratedWorld({
   agentId = null,
   displayName = null,
   worldContextText = null,
-  enabled = false,
+  enabled = true,
   fetchImpl,
   logger = console,
 } = {}) {

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

@@ -12,9 +12,15 @@ export const CANDIDATE_OBJECT_FIELDS = Object.freeze([
   'profileSummary',
   'compatibilitySignals',
   'deliveryReason',
+  'worldFeedbackSummary',
   'expiresAt',
 ]);
 
+export const WORLD_FEEDBACK_SUMMARY_FIELDS = Object.freeze([
+  'likesReceived',
+  'dislikesReceived',
+]);
+
 export const DATING_DEMO_SCORING_FIELDS = Object.freeze([
   'joinedAt',
   'rank',
@@ -282,6 +288,7 @@ export function projectCandidateFeedModel(world) {
     profileSummaryFieldShape: PROFILE_SUMMARY_FIELD_FIELDS,
     compatibilitySignalFields: COMPATIBILITY_SIGNAL_FIELDS,
     deliveryReasonFields: DELIVERY_REASON_FIELDS,
+    worldFeedbackSummaryFields: WORLD_FEEDBACK_SUMMARY_FIELDS,
     requestChatAction: {
       action: 'request_chat',
       requiredFields: ['worldId', 'targetAgentId'],

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

@@ -124,7 +124,6 @@ function normalizeSearchSchema(searchSchema = {}, joinSchema = {}) {
         'worldId',
         'displayName',
         'headline',
-        'address',
         'online',
         'matchedFieldIds',
         'score',

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

@@ -390,7 +390,12 @@ function summarizeProfileFields(fields = []) {
 }
 
 function buildCandidateDeliverySummaryLine(candidateSummary = {}, index = 0) {
-  return `${index + 1}. ${candidateSummary.summary}`;
+  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 = {}) {
@@ -697,6 +702,10 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
       optionalFieldSummary,
       compatibilitySummary,
       deliveryReasonSummary: deliveryReasonSummary || null,
+      worldFeedbackSummary: candidate.worldFeedbackSummary || {
+        likesReceived: 0,
+        dislikesReceived: 0,
+      },
       expiresAt: candidate.expiresAt,
       summary,
     };