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

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

@@ -125,14 +125,6 @@ function projectToolAction(action = null) {
       payloadTemplate: { ...payloadTemplate, action: 'get_world' },
     };
   }
-  if (tool === 'claworld_search_world_members') {
-    return {
-      tool: 'claworld_search',
-      summary: normalizeText(action.summary, null),
-      payload: { ...payload, scope: 'world_members' },
-      payloadTemplate: { ...payloadTemplate, scope: 'world_members' },
-    };
-  }
   return {
     tool,
     summary: normalizeText(action.summary, null),
@@ -201,55 +193,6 @@ function projectRequestChatAction(
   };
 }
 
-function projectToolCandidateDeliverySummary(
-  candidateDelivery = {},
-  {
-    accountId = null,
-    requestToolName = 'claworld_manage_conversations',
-  } = {},
-) {
-  if (!candidateDelivery || typeof candidateDelivery !== 'object' || Array.isArray(candidateDelivery)) return null;
-
-  const candidateSummaries = Array.isArray(candidateDelivery.candidateSummaries)
-    ? candidateDelivery.candidateSummaries.map((summary) => ({
-      candidateId: normalizeText(summary.candidateId, null),
-      sourceMembershipId: normalizeText(summary.sourceMembershipId, null),
-      displayName: normalizeText(summary.displayName, null),
-      worldRole: projectWorldRole(summary.worldRole, null),
-      headline: normalizeText(summary.headline, null),
-      online: summary.online === true,
-      rank: normalizeOptionalInteger(summary.rank, null),
-      score: normalizeOptionalInteger(summary.score, null),
-      agentCode: normalizeText(summary.agentCode, summary.requestChat?.agentCode || null)?.toUpperCase() || null,
-      requestChat: projectRequestChatPayload(summary.requestChat, {
-        accountId,
-        requestToolName,
-      }),
-      requiredFieldSummary: normalizeStringList(summary.requiredFieldSummary),
-      optionalFieldSummary: normalizeStringList(summary.optionalFieldSummary),
-      compatibilitySummary: normalizeStringList(summary.compatibilitySummary),
-      deliveryReasonSummary: normalizeText(summary.deliveryReasonSummary, null),
-      expiresAt: normalizeText(summary.expiresAt, null),
-      summary: normalizeText(summary.summary, null),
-    }))
-    : [];
-
-  return {
-    status: normalizeText(candidateDelivery.status, null),
-    worldId: normalizeText(candidateDelivery.worldId, null),
-    deliveredCandidateCount: normalizeInteger(candidateDelivery.deliveredCandidateCount, candidateSummaries.length),
-    totalCandidateCount: normalizeInteger(candidateDelivery.totalCandidateCount, candidateSummaries.length),
-    remainingCandidateCount: normalizeInteger(candidateDelivery.remainingCandidateCount, 0),
-    nextAction: normalizeText(candidateDelivery.nextAction, null),
-    requestChatAction: projectRequestChatAction(candidateDelivery.requestChatAction, {
-      accountId,
-      requestToolName,
-    }),
-    candidateSummaries,
-    orchestration: projectOrchestration(candidateDelivery.orchestration),
-  };
-}
-
 export function projectToolWorldList(worldDirectory = {}) {
   const worlds = Array.isArray(worldDirectory.items)
     ? worldDirectory.items.map((world) => ({
@@ -359,23 +302,7 @@ export function projectToolWorldDetail(worldDetail = {}, { accountId = null } =
   };
 }
 
-function projectToolCandidateSummary(summary = {}, index = 0) {
-  return {
-    candidateId: normalizeText(summary.candidateId, `candidate_${index + 1}`),
-    displayName: normalizeText(summary.displayName, `Candidate ${index + 1}`),
-    agentCode: normalizeText(summary.agentCode, null)?.toUpperCase() || null,
-    worldRole: projectWorldRole(summary.worldRole, null),
-    headline: normalizeText(summary.headline, null),
-    online: summary.online === true,
-    rank: normalizeInteger(summary.rank, 0) || null,
-    score: normalizeInteger(summary.score, 0) || null,
-    summary: normalizeText(summary.summary, null),
-    expiresAt: normalizeText(summary.expiresAt, null),
-    worldFeedbackSummary: projectWorldFeedbackSummary(summary.worldFeedbackSummary),
-  };
-}
-
-function projectCandidateProfileSummary(summary = {}) {
+function projectMemberProfileSummary(summary = {}) {
   return {
     displayName: normalizeText(summary.displayName, null),
     headline: normalizeText(summary.headline, null),
@@ -396,123 +323,6 @@ function projectCandidateProfileSummary(summary = {}) {
   };
 }
 
-function resolveCandidateProjectionPayload(payload = {}) {
-  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
-    return {
-      worldId: null,
-      nextAction: null,
-      candidateFeed: null,
-      candidateDelivery: null,
-      requestChatAction: null,
-    };
-  }
-
-  const candidateFeed = payload.candidateFeed && typeof payload.candidateFeed === 'object' && !Array.isArray(payload.candidateFeed)
-    ? payload.candidateFeed
-    : Array.isArray(payload.candidates)
-      ? payload
-      : null;
-  const candidateDelivery = payload.candidateDelivery && typeof payload.candidateDelivery === 'object' && !Array.isArray(payload.candidateDelivery)
-    ? payload.candidateDelivery
-    : candidateFeed?.candidateDelivery && typeof candidateFeed.candidateDelivery === 'object' && !Array.isArray(candidateFeed.candidateDelivery)
-      ? candidateFeed.candidateDelivery
-      : null;
-  const candidateModelRequestChatAction = candidateFeed?.candidateModel && typeof candidateFeed.candidateModel === 'object' && !Array.isArray(candidateFeed.candidateModel)
-    ? candidateFeed.candidateModel.requestChatAction
-    : null;
-
-  return {
-    worldId: normalizeText(payload.worldId, normalizeText(candidateFeed?.worldId, normalizeText(candidateDelivery?.worldId, null))),
-    nextAction: normalizeText(payload.nextAction, normalizeText(candidateFeed?.nextAction, normalizeText(candidateDelivery?.nextAction, null))),
-    candidateFeed,
-    candidateDelivery,
-    requestChatAction: payload.requestChatAction && typeof payload.requestChatAction === 'object' && !Array.isArray(payload.requestChatAction)
-      ? payload.requestChatAction
-      : candidateDelivery?.requestChatAction && typeof candidateDelivery.requestChatAction === 'object' && !Array.isArray(candidateDelivery.requestChatAction)
-        ? candidateDelivery.requestChatAction
-        : candidateModelRequestChatAction && typeof candidateModelRequestChatAction === 'object' && !Array.isArray(candidateModelRequestChatAction)
-          ? candidateModelRequestChatAction
-          : null,
-  };
-}
-
-function projectToolCandidateFeed(payload = {}) {
-  const { candidateFeed, candidateDelivery } = resolveCandidateProjectionPayload(payload);
-  const candidateSummaries = Array.isArray(candidateDelivery?.candidateSummaries)
-    ? candidateDelivery.candidateSummaries.map((summary, index) => projectToolCandidateSummary(summary, index))
-    : Array.isArray(candidateFeed?.candidates)
-      ? candidateFeed.candidates.map((candidate, index) => projectToolCandidateSummary({
-        candidateId: candidate.candidateId,
-        displayName: candidate.profileSummary?.displayName,
-        agentCode: normalizeText(candidate.agentCode, candidate.requestChat?.agentCode || null),
-        worldRole: candidate.worldRole,
-        headline: candidate.profileSummary?.headline,
-        online: candidate.online === true,
-        rank: candidate.rank,
-        score: candidate.score,
-        summary: normalizeText(candidate.deliveryReason?.summary, null),
-        expiresAt: candidate.expiresAt,
-        worldFeedbackSummary: candidate.worldFeedbackSummary,
-      }, index))
-      : [];
-
-  return {
-    status: normalizeText(
-      candidateDelivery?.status,
-      normalizeText(candidateFeed?.status, candidateSummaries.length > 0 ? 'candidate_summary_ready' : 'candidate_summary_pending'),
-    ),
-    nextAction: normalizeText(
-      candidateDelivery?.nextAction,
-      normalizeText(candidateFeed?.nextAction, candidateSummaries.length > 0 ? 'review_candidates_then_request_chat' : 'wait_for_more_candidates'),
-    ),
-    deliveredCandidateCount: normalizeInteger(candidateDelivery?.deliveredCandidateCount, candidateSummaries.length),
-    totalCandidateCount: normalizeInteger(
-      candidateDelivery?.totalCandidateCount,
-      normalizeInteger(candidateFeed?.totalCandidates, candidateSummaries.length),
-    ),
-    remainingCandidateCount: normalizeInteger(candidateDelivery?.remainingCandidateCount, 0),
-    candidates: candidateSummaries,
-  };
-}
-
-function projectToolCandidateFlowResponse(payload = {}, { accountId = null } = {}) {
-  const {
-    worldId,
-    nextAction,
-    candidateFeed,
-    candidateDelivery,
-    requestChatAction,
-  } = resolveCandidateProjectionPayload(payload);
-  const projectedFeed = projectToolCandidateFeed({ candidateFeed, candidateDelivery });
-  const projectedDelivery = projectToolCandidateDeliverySummary(candidateDelivery, { accountId });
-  const projectedRequestChatAction = projectRequestChatAction(requestChatAction, { accountId });
-
-  return {
-    worldId: normalizeText(worldId, normalizeText(projectedDelivery?.worldId, null)),
-    nextAction: normalizeText(nextAction, normalizeText(projectedFeed?.nextAction, normalizeText(projectedDelivery?.nextAction, null))),
-    candidateFeed: projectedFeed,
-    requestChatTool: 'claworld_manage_conversations',
-    candidateDelivery: projectedDelivery,
-    requestChatAction: projectedRequestChatAction,
-  };
-}
-
-export function projectToolCandidateFeedResponse(candidateFeedPayload = {}, { accountId = null } = {}) {
-  const candidateFlow = projectToolCandidateFlowResponse(candidateFeedPayload, { accountId });
-
-  return {
-    status: normalizeText(candidateFeedPayload.status, normalizeText(candidateFlow.candidateFeed?.status, 'no_candidates_ready')),
-    worldId: candidateFlow.worldId,
-    accountId: normalizeText(accountId, null),
-    nextAction: candidateFlow.nextAction,
-    candidateFeed: candidateFlow.candidateFeed,
-    requestChatTool: candidateFlow.requestChatTool,
-    candidateDelivery: candidateFlow.candidateDelivery,
-    requestChatAction: candidateFlow.requestChatAction,
-  };
-}
-
-
 function projectToolJoinAction(action = null, { accountId = null, requestToolName = null } = {}) {
   if (!action || typeof action !== 'object' || Array.isArray(action)) return null;
   const normalizedAccountId = normalizeText(accountId, null);
@@ -529,7 +339,7 @@ export function projectToolJoinWorldResponse(
   { accountId = null } = {},
 ) {
   return {
-    status: joinResult.membershipStatus === 'active' ? 'joined' : 'accepted',
+    status: joinResult.membershipStatus === 'active' ? 'active' : 'accepted',
     worldId: normalizeText(joinResult.worldId, null),
     accountId: normalizeText(accountId, null),
     worldRole: projectWorldRole(joinResult.worldRole, null),
@@ -706,21 +516,22 @@ export function projectToolWorldMemberSearchResponse(payload = {}, { accountId =
     status: normalizeText(payload.status, 'no_matches'),
     worldId: normalizeText(payload.worldId, null),
     query: normalizeText(payload.query, null),
-    sort: normalizeText(payload.sort, 'match'),
+    sort: normalizeText(payload.sort, 'relevance'),
     limit: normalizeInteger(payload.limit, 0),
     totalMatches: normalizeInteger(payload.totalMatches, Array.isArray(payload.items) ? payload.items.length : 0),
     nextAction: normalizeText(payload.nextAction, null),
     members: Array.isArray(payload.items)
       ? payload.items.map((item, index) => ({
-        candidateId: normalizeText(item.membershipId, `candidate_${index + 1}`),
-        displayName: normalizeText(item.displayName, `Candidate ${index + 1}`),
+        memberId: normalizeText(item.membershipId, `member_${index + 1}`),
+        membershipId: normalizeText(item.membershipId, null),
+        displayName: normalizeText(item.displayName, `Member ${index + 1}`),
         agentCode: normalizeText(item.agentCode, null)?.toUpperCase() || null,
         headline: normalizeText(item.headline, null),
         online: item.online === true,
         score: normalizeInteger(item.score, 0),
         matchedFieldIds: normalizeStringList(item.matchedFieldIds),
         reasonSummary: normalizeText(item.reasonSummary, null),
-        profileSummary: projectCandidateProfileSummary(item.profileSummary || {}),
+        profileSummary: projectMemberProfileSummary(item.profileSummary || {}),
         worldFeedbackSummary: projectWorldFeedbackSummary(item.worldFeedbackSummary),
         requestChat: projectRequestChatPayload(item.requestChat, { accountId }),
       }))

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

@@ -17,16 +17,12 @@ export const CLAWORLD_CONVERSATION_TOOL_NAMES = Object.freeze([
   'claworld_manage_conversations',
 ]);
 
-export const CLAWORLD_FEEDBACK_TOOL_NAMES = Object.freeze([
-  'claworld_submit_feedback',
-]);
 
 export const CLAWORLD_REGISTERED_TOOL_NAMES = Object.freeze([
   ...CLAWORLD_ACCOUNT_TOOL_NAMES,
   ...CLAWORLD_SEARCH_TOOL_NAMES,
   ...CLAWORLD_WORLD_TOOL_NAMES,
   ...CLAWORLD_CONVERSATION_TOOL_NAMES,
-  ...CLAWORLD_FEEDBACK_TOOL_NAMES,
 ]);
 
 export const CLAWORLD_PUBLIC_TOOL_NAMES = Object.freeze([
@@ -34,17 +30,6 @@ export const CLAWORLD_PUBLIC_TOOL_NAMES = Object.freeze([
 ]);
 
 export const CLAWORLD_RETIRED_PUBLIC_TOOL_NAMES = Object.freeze([
-  'claworld_account',
-  'claworld_search_worlds',
-  'claworld_list_worlds',
-  'claworld_get_world_detail',
-  'claworld_join_world',
-  'claworld_search_world_members',
-  'claworld_get_candidate_feed',
-  'claworld_create_world',
-  'claworld_manage_world',
-  'claworld_request_chat',
-  'claworld_chat_inbox',
 ]);
 
 export const CLAWORLD_MINIMAL_OPENCLAW_TOOL_NAMES = Object.freeze([

package/src/openclaw/runtime/working-memory.js

@@ -602,7 +602,6 @@ function compactResultPayload(payload = {}) {
     'displayName',
     'chatRequestId',
     'conversationKey',
-    'candidateId',
     'feedbackId',
     'nextAction',
     'requiredAction',
@@ -632,7 +631,6 @@ export function buildClaworldToolMaintenanceEvent({
     worldId: params.worldId || payload.worldId,
     chatRequestId: params.chatRequestId || payload.chatRequestId,
     conversationKey: params.conversationKey || payload.conversationKey,
-    candidateId: params.candidateId || payload.candidateId,
     agentCode: params.agentCode || payload.agentCode,
   };
   return buildClaworldMaintenanceEvent({

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

@@ -92,6 +92,34 @@ function normalizeWorldBroadcastConfig(broadcast = null) {
   };
 }
 
+function normalizeWorldInvite(payload = {}) {
+  return {
+    status: normalizeText(payload.status, null),
+    worldId: normalizeText(payload.worldId, null),
+    displayName: normalizeText(payload.displayName, null),
+    targetAgentId: normalizeText(payload.targetAgentId, null),
+    targetIdentity: normalizeText(payload.targetIdentity, null),
+    invitedByAgentId: normalizeText(payload.invitedByAgentId, null),
+    membershipId: normalizeText(payload.membershipId, null),
+    membershipStatus: normalizeText(payload.membershipStatus, null),
+    created: normalizeOptionalBoolean(payload.created, null),
+    invitedAt: normalizeText(payload.invitedAt, null),
+    inviteMessage: normalizeText(payload.inviteMessage, null),
+    inviteRevokedAt: normalizeText(payload.inviteRevokedAt, null),
+    notificationId: normalizeText(payload.notificationId, null),
+    nextAction: normalizeText(payload.nextAction, null),
+  };
+}
+
+function normalizeWorldInviteList(payload = {}) {
+  return {
+    worldId: normalizeText(payload.worldId, null),
+    items: Array.isArray(payload.items) ? payload.items.map((item) => normalizeWorldInvite(item)) : [],
+    totalItems: normalizeOptionalInteger(payload.totalItems, 0),
+    nextAction: normalizeText(payload.nextAction, null),
+  };
+}
+
 function normalizeManagedWorld(payload = {}) {
   return {
     worldId: normalizeText(payload.worldId, null),
@@ -101,6 +129,10 @@ function normalizeManagedWorld(payload = {}) {
     enabled: normalizeOptionalBoolean(payload.enabled, null),
     status: normalizeText(payload.status, null),
     worldRole: normalizeWorldRole(payload.worldRole, null),
+    visibility: normalizeText(payload.visibility, 'public'),
+    identityMode: normalizeText(payload.identityMode, 'imaginary'),
+    joinPolicy: normalizeText(payload.joinPolicy, 'open'),
+    approvalPolicy: normalizeText(payload.approvalPolicy, 'auto'),
     schemaVersion: normalizeOptionalInteger(payload.schemaVersion, null),
     createdAt: normalizeText(payload.createdAt, null),
     updatedAt: normalizeText(payload.updatedAt, null),
@@ -133,6 +165,10 @@ function normalizeOwnedWorldSummary(payload = {}) {
     enabled: normalizeOptionalBoolean(payload.enabled, null),
     status: normalizeText(payload.status, null),
     worldRole: normalizeWorldRole(payload.worldRole, null),
+    visibility: normalizeText(payload.visibility, 'public'),
+    identityMode: normalizeText(payload.identityMode, 'imaginary'),
+    joinPolicy: normalizeText(payload.joinPolicy, 'open'),
+    approvalPolicy: normalizeText(payload.approvalPolicy, 'auto'),
     createdAt: normalizeText(payload.createdAt, null),
     updatedAt: normalizeText(payload.updatedAt, null),
     broadcast: normalizeWorldBroadcastConfig(payload.broadcast),
@@ -273,6 +309,10 @@ export async function createModeratedWorld({
   worldContextText = null,
   participantContextText = null,
   enabled = true,
+  visibility = null,
+  identityMode = null,
+  joinPolicy = null,
+  approvalPolicy = null,
   fetchImpl,
   logger = console,
 } = {}) {
@@ -300,6 +340,10 @@ export async function createModeratedWorld({
       worldContextText,
       participantContextText: normalizeText(participantContextText, null),
       enabled,
+      ...(normalizeText(visibility, null) ? { visibility: normalizeText(visibility, null) } : {}),
+      ...(normalizeText(identityMode, null) ? { identityMode: normalizeText(identityMode, null) } : {}),
+      ...(normalizeText(joinPolicy, null) ? { joinPolicy: normalizeText(joinPolicy, null) } : {}),
+      ...(normalizeText(approvalPolicy, null) ? { approvalPolicy: normalizeText(approvalPolicy, null) } : {}),
     }),
   });
 
@@ -449,6 +493,170 @@ export async function manageModeratedWorld({
   return normalizeManagedWorld(result.body);
 }
 
+export async function inviteModeratedWorldMember({
+  cfg = {},
+  accountId = null,
+  runtimeConfig = null,
+  agentId = null,
+  worldId = null,
+  targetAgentId = null,
+  identity = null,
+  inviteMessage = null,
+  fetchImpl,
+  logger = console,
+} = {}) {
+  if (typeof fetchImpl !== 'function') {
+    throw new Error('fetch is unavailable for claworld world invite helper');
+  }
+
+  const resolvedAgentId = normalizeText(agentId, null);
+  if (!resolvedAgentId) {
+    throw new Error('claworld world invite helper requires agentId');
+  }
+  const resolvedWorldId = normalizeText(worldId, null);
+  if (!resolvedWorldId) {
+    throw new Error('claworld world invite helper requires worldId');
+  }
+  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
+  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
+  const result = await fetchJson(fetchImpl, `${baseUrl}/v1/moderation/worlds/${encodeURIComponent(resolvedWorldId)}/invitations`, {
+    method: 'POST',
+    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
+      accept: 'application/json',
+      'content-type': 'application/json',
+      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
+    }),
+    body: JSON.stringify({
+      agentId: resolvedAgentId,
+      ...(normalizeText(targetAgentId, null) ? { targetAgentId: normalizeText(targetAgentId, null) } : {}),
+      ...(normalizeText(identity, null) ? { identity: normalizeText(identity, null) } : {}),
+      ...(normalizeText(inviteMessage, null) ? { inviteMessage: normalizeText(inviteMessage, null) } : {}),
+    }),
+  });
+
+  if (!result.ok) {
+    logger.error?.('[claworld:moderation] world invite failed', {
+      status: result.status,
+      worldId: resolvedWorldId,
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      body: result.body,
+    });
+    throw createModerationHttpError('invite_member', result, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
+  }
+
+  return normalizeWorldInvite(result.body);
+}
+
+export async function revokeModeratedWorldInvite({
+  cfg = {},
+  accountId = null,
+  runtimeConfig = null,
+  agentId = null,
+  worldId = null,
+  targetAgentId = null,
+  fetchImpl,
+  logger = console,
+} = {}) {
+  if (typeof fetchImpl !== 'function') {
+    throw new Error('fetch is unavailable for claworld world invite revoke helper');
+  }
+
+  const resolvedAgentId = normalizeText(agentId, null);
+  if (!resolvedAgentId) {
+    throw new Error('claworld world invite revoke helper requires agentId');
+  }
+  const resolvedWorldId = normalizeText(worldId, null);
+  if (!resolvedWorldId) {
+    throw new Error('claworld world invite revoke helper requires worldId');
+  }
+  const resolvedTargetAgentId = normalizeText(targetAgentId, null);
+  if (!resolvedTargetAgentId) {
+    throw new Error('claworld world invite revoke helper requires targetAgentId');
+  }
+  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
+  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
+  const result = await fetchJson(fetchImpl, `${baseUrl}/v1/moderation/worlds/${encodeURIComponent(resolvedWorldId)}/invitations/revoke`, {
+    method: 'POST',
+    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
+      accept: 'application/json',
+      'content-type': 'application/json',
+      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
+    }),
+    body: JSON.stringify({
+      agentId: resolvedAgentId,
+      targetAgentId: resolvedTargetAgentId,
+    }),
+  });
+
+  if (!result.ok) {
+    logger.error?.('[claworld:moderation] world invite revoke failed', {
+      status: result.status,
+      worldId: resolvedWorldId,
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      body: result.body,
+    });
+    throw createModerationHttpError('revoke_invite', result, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
+  }
+
+  return normalizeWorldInvite(result.body);
+}
+
+export async function fetchModeratedWorldInvites({
+  cfg = {},
+  accountId = null,
+  runtimeConfig = null,
+  agentId = null,
+  worldId = null,
+  status = 'invited',
+  fetchImpl,
+  logger = console,
+} = {}) {
+  if (typeof fetchImpl !== 'function') {
+    throw new Error('fetch is unavailable for claworld world invites helper');
+  }
+
+  const resolvedAgentId = normalizeText(agentId, null);
+  if (!resolvedAgentId) {
+    throw new Error('claworld world invites helper requires agentId');
+  }
+  const resolvedWorldId = normalizeText(worldId, null);
+  if (!resolvedWorldId) {
+    throw new Error('claworld world invites helper requires worldId');
+  }
+  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
+  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
+  const requestUrl = new URL(`${baseUrl}/v1/moderation/worlds/${encodeURIComponent(resolvedWorldId)}/invitations`);
+  requestUrl.searchParams.set('agentId', resolvedAgentId);
+  if (normalizeText(status, null)) requestUrl.searchParams.set('status', normalizeText(status, null));
+  const result = await fetchJson(fetchImpl, requestUrl.toString(), {
+    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
+      accept: 'application/json',
+      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
+    }),
+  });
+
+  if (!result.ok) {
+    logger.error?.('[claworld:moderation] world invites fetch failed', {
+      status: result.status,
+      worldId: resolvedWorldId,
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      body: result.body,
+    });
+    throw createModerationHttpError('list_invites', result, {
+      accountId: resolvedRuntimeConfig.accountId || accountId || null,
+      worldId: resolvedWorldId,
+    });
+  }
+
+  return normalizeWorldInviteList(result.body);
+}
+
 export async function broadcastModeratedWorld({
   cfg = {},
   accountId = null,