@xfxstudio/claworld 2026.4.16-testing.1 → 2026.4.16-testing.2

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

@@ -0,0 +1,939 @@
+import { normalizeAcceptedChatKickoffRecord } from '../../lib/relay/kickoff-progress.js';
+
+function normalizeText(value, fallback = null) {
+  if (value == null) return fallback;
+  const normalized = String(value).trim();
+  return normalized || fallback;
+}
+
+function normalizeInteger(value, fallback = 0) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) return fallback;
+  return Math.max(0, Math.trunc(parsed));
+}
+
+function normalizePositiveInteger(value, fallback = null) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
+  return Math.max(1, Math.trunc(parsed));
+}
+
+function normalizeOptionalBoolean(value, fallback = null) {
+  if (typeof value === 'boolean') return value;
+  return fallback;
+}
+
+function normalizeOptionalInteger(value, fallback = null) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) return fallback;
+  return Math.trunc(parsed);
+}
+
+function normalizeStringList(values = []) {
+  if (!Array.isArray(values)) return [];
+  return values
+    .map((value) => normalizeText(value, null))
+    .filter(Boolean);
+}
+
+function projectParticipantContextField(field = null) {
+  if (!field || typeof field !== 'object' || Array.isArray(field)) return null;
+  return {
+    fieldId: normalizeText(field.fieldId, null),
+    label: normalizeText(field.label, normalizeText(field.fieldId, 'Entry Profile')),
+    description: normalizeText(field.description, null),
+  };
+}
+
+function projectWorldRole(worldRole, fallback = null) {
+  const normalized = normalizeText(worldRole, fallback);
+  return ['owner', 'member'].includes(normalized) ? normalized : fallback;
+}
+
+function projectWorldStats(stats = null) {
+  if (!stats || typeof stats !== 'object' || Array.isArray(stats)) return null;
+  return {
+    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 projectToolBroadcastConfig(broadcast = null) {
+  if (!broadcast || typeof broadcast !== 'object' || Array.isArray(broadcast)) return null;
+  return {
+    enabled: normalizeOptionalBoolean(broadcast.enabled, null),
+    audience: normalizeText(broadcast.audience, null),
+    replyPolicy: normalizeText(broadcast.replyPolicy, null),
+    excludeSelf: normalizeOptionalBoolean(broadcast.excludeSelf, 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),
+  };
+}
+
+function projectOrchestration(orchestration = null) {
+  if (!orchestration || typeof orchestration !== 'object' || Array.isArray(orchestration)) return null;
+  return {
+    stage: normalizeText(orchestration.stage, null),
+    system: normalizeText(orchestration.system, null),
+    confirmation: normalizeText(orchestration.confirmation, null),
+    user: normalizeText(orchestration.user, null),
+    followUp: normalizeText(orchestration.followUp, null),
+  };
+}
+
+function projectToolAction(action = null) {
+  if (!action || typeof action !== 'object' || Array.isArray(action)) return null;
+  return {
+    tool: normalizeText(action.tool, null),
+    summary: normalizeText(action.summary, null),
+    payload: action.payload && typeof action.payload === 'object' && !Array.isArray(action.payload)
+      ? action.payload
+      : {},
+    payloadTemplate: action.payloadTemplate && typeof action.payloadTemplate === 'object' && !Array.isArray(action.payloadTemplate)
+      ? action.payloadTemplate
+      : {},
+  };
+}
+
+function projectRequestChatPayload(
+  requestChat = null,
+  {
+    accountId = null,
+    requestToolName = 'claworld_request_chat',
+  } = {},
+) {
+  if (!requestChat || typeof requestChat !== 'object' || Array.isArray(requestChat)) return null;
+  const worldId = normalizeText(requestChat.worldId, null);
+  const displayName = normalizeText(requestChat.displayName, null);
+  const agentCode = normalizeText(requestChat.agentCode, null)?.toUpperCase() || null;
+  if (!worldId || !displayName || !agentCode) return null;
+
+  const normalizedAccountId = normalizeText(accountId, null);
+
+  return {
+    worldId,
+    displayName,
+    agentCode,
+    requestTool: normalizeText(requestToolName, null),
+    requestPayload: {
+      ...(normalizedAccountId ? { accountId: normalizedAccountId } : {}),
+      worldId,
+      displayName,
+      agentCode,
+    },
+  };
+}
+
+function projectRequestChatAction(
+  requestChatAction = null,
+  {
+    accountId = null,
+    requestToolName = 'claworld_request_chat',
+  } = {},
+) {
+  if (!requestChatAction || typeof requestChatAction !== 'object' || Array.isArray(requestChatAction)) return null;
+  const worldId = normalizeText(requestChatAction.worldId, null);
+  if (!worldId) return null;
+
+  const normalizedAccountId = normalizeText(accountId, null);
+
+  return {
+    action: normalizeText(requestChatAction.action, 'request_chat'),
+    worldId,
+    requiredFields: normalizeStringList(requestChatAction.requiredFields),
+    requestTool: normalizeText(requestToolName, null),
+    requestPayloadTemplate: {
+      ...(normalizedAccountId ? { accountId: normalizedAccountId } : {}),
+      worldId,
+      displayName: ':displayName',
+      agentCode: ':agentCode',
+    },
+    summary: normalizeText(requestChatAction.summary, null),
+  };
+}
+
+function projectToolCandidateDeliverySummary(
+  candidateDelivery = {},
+  {
+    accountId = null,
+    requestToolName = 'claworld_request_chat',
+  } = {},
+) {
+  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) => ({
+      worldId: world.worldId,
+      displayName: world.displayName,
+      summary: normalizeText(world.summary, null),
+      worldContextText: normalizeText(world.worldContextText, null),
+      tags: normalizeStringList(world.tags),
+      hotness: normalizeInteger(world.hotness, 0),
+      activatedMemberCount: normalizeInteger(world.activatedMemberCount, normalizeInteger(world.hotness, 0)),
+      reasonSummary: normalizeText(world.reasonSummary, null),
+      detailAction: projectToolAction(world.detailAction),
+      joinAction: projectToolAction(world.joinAction),
+    }))
+    : [];
+
+  return {
+    worlds,
+    mode: normalizeText(worldDirectory.mode, 'browse'),
+    query: normalizeText(worldDirectory.query, null),
+    sort: normalizeText(worldDirectory.sort, 'hot'),
+    nextAction: normalizeText(worldDirectory.nextAction, 'inspect_world_detail_or_join_world'),
+    pagination: worldDirectory.pagination && typeof worldDirectory.pagination === 'object'
+      ? {
+        page: normalizeInteger(worldDirectory.pagination.page, 1),
+        totalPages: normalizeInteger(worldDirectory.pagination.totalPages, 0),
+        totalCount: normalizeInteger(worldDirectory.pagination.totalCount, worlds.length),
+      }
+      : {
+        page: 1,
+        totalPages: worlds.length > 0 ? 1 : 0,
+        totalCount: worlds.length,
+      },
+  };
+}
+
+export function projectToolWorldSearchResponse(worldDirectory = {}, { accountId = null } = {}) {
+  const worlds = Array.isArray(worldDirectory.items)
+    ? worldDirectory.items.map((world) => ({
+      worldId: world.worldId,
+      displayName: world.displayName,
+      summary: normalizeText(world.summary, null),
+      worldContextText: normalizeText(world.worldContextText, null),
+      tags: normalizeStringList(world.tags),
+      hotness: normalizeInteger(world.hotness, 0),
+      activatedMemberCount: normalizeInteger(world.activatedMemberCount, normalizeInteger(world.hotness, 0)),
+      matchScore: normalizeInteger(world.matchScore, 0),
+      matchedFieldIds: normalizeStringList(world.matchedFieldIds),
+      matchedTerms: normalizeStringList(world.matchedTerms),
+      reasonSummary: normalizeText(world.reasonSummary, null),
+      detailAction: projectToolAction(world.detailAction),
+      joinAction: projectToolAction(world.joinAction),
+    }))
+    : [];
+
+  return {
+    accountId: normalizeText(accountId, null),
+    status: normalizeText(worldDirectory.status, worlds.length > 0 ? 'search_ready' : 'no_matches'),
+    mode: normalizeText(worldDirectory.mode, 'browse'),
+    query: normalizeText(worldDirectory.query, null),
+    sort: normalizeText(worldDirectory.sort, 'match'),
+    nextAction: normalizeText(worldDirectory.nextAction, worlds.length > 0 ? 'inspect_world_detail_or_join_world' : 'broaden_world_search'),
+    worlds,
+    pagination: worldDirectory.pagination && typeof worldDirectory.pagination === 'object'
+      ? {
+        page: normalizeInteger(worldDirectory.pagination.page, 1),
+        totalPages: normalizeInteger(worldDirectory.pagination.totalPages, 0),
+        totalCount: normalizeInteger(worldDirectory.pagination.totalCount, worlds.length),
+      }
+      : {
+        page: 1,
+        totalPages: worlds.length > 0 ? 1 : 0,
+        totalCount: worlds.length,
+      },
+  };
+}
+
+export function projectToolWorldDetail(worldDetail = {}, { accountId = null } = {}) {
+  return {
+    worldId: worldDetail.worldId,
+    displayName: normalizeText(worldDetail.world?.displayName, worldDetail.displayName || ''),
+    worldContextText: normalizeText(
+      worldDetail.world?.worldContextText,
+      worldDetail.worldContextText || '',
+    ),
+    ownerAgentId: normalizeText(
+      worldDetail.management?.ownerAgentId,
+      normalizeText(worldDetail.ownerAgentId, null),
+    ),
+    worldRole: projectWorldRole(worldDetail.worldRole, null),
+    enabled: normalizeOptionalBoolean(worldDetail.management?.enabled, normalizeOptionalBoolean(worldDetail.enabled, null)),
+    status: normalizeText(worldDetail.management?.status, normalizeText(worldDetail.statusLabel, null)),
+    participantContextField: projectParticipantContextField(worldDetail.participantContextField),
+    memberSearchAction: {
+      tool: 'claworld_search_world_members',
+      summary: 'After joining this world, search joined members by profile match or likes.',
+      payloadTemplate: {
+        ...(normalizeText(accountId, null) ? { accountId: normalizeText(accountId, null) } : {}),
+        worldId: worldDetail.worldId,
+        query: ':query',
+      },
+    },
+  };
+}
+
+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 = {}) {
+  return {
+    displayName: normalizeText(summary.displayName, null),
+    headline: normalizeText(summary.headline, null),
+    requiredFields: Array.isArray(summary.requiredFields)
+      ? summary.requiredFields.map((field) => ({
+        fieldId: normalizeText(field.fieldId, null),
+        label: normalizeText(field.label, normalizeText(field.fieldId, null)),
+        value: Array.isArray(field.value) ? normalizeStringList(field.value) : normalizeText(field.value, null),
+      }))
+      : [],
+    optionalFields: Array.isArray(summary.optionalFields)
+      ? summary.optionalFields.map((field) => ({
+        fieldId: normalizeText(field.fieldId, null),
+        label: normalizeText(field.label, normalizeText(field.fieldId, null)),
+        value: Array.isArray(field.value) ? normalizeStringList(field.value) : normalizeText(field.value, null),
+      }))
+      : [],
+  };
+}
+
+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_request_chat',
+    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,
+  };
+}
+
+export function projectToolJoinWorldResponse(
+  joinResult = {},
+  { accountId = null } = {},
+) {
+  const candidateFlow = projectToolCandidateFlowResponse(joinResult, { accountId });
+
+  return {
+    status: joinResult.membershipStatus === 'active' ? 'joined' : 'accepted',
+    worldId: normalizeText(joinResult.worldId, candidateFlow.worldId),
+    accountId: normalizeText(accountId, null),
+    worldRole: projectWorldRole(joinResult.worldRole, null),
+    membershipStatus: joinResult.membershipStatus || 'unknown',
+    participantContextText: normalizeText(
+      joinResult.participantContextText,
+      joinResult.membership?.participantContextText || null,
+    ),
+    nextAction: normalizeText(joinResult.nextAction, 'review_candidate_feed'),
+    candidateFeed: candidateFlow.candidateFeed,
+    requestChatTool: candidateFlow.requestChatTool,
+    candidateDelivery: candidateFlow.candidateDelivery,
+    requestChatAction: candidateFlow.requestChatAction,
+    orchestration: projectOrchestration(joinResult.orchestration),
+  };
+}
+
+export function projectToolCreateWorldResponse(world = {}, { accountId = null } = {}) {
+  return {
+    worldId: world.worldId,
+    accountId: normalizeText(accountId, null),
+    displayName: normalizeText(world.displayName, null),
+    worldContextText: normalizeText(world.worldContextText, null),
+    participantContextField: projectParticipantContextField(world.participantContextField),
+    ownerAgentId: normalizeText(world.ownerAgentId, null),
+    status: normalizeText(world.status, null),
+    enabled: normalizeOptionalBoolean(world.enabled, null),
+    worldRole: projectWorldRole(world.worldRole, null),
+    ownerJoin:
+      world.ownerJoin && typeof world.ownerJoin === 'object'
+        ? projectToolJoinWorldResponse(world.ownerJoin, { accountId })
+        : null,
+    schemaVersion: normalizeOptionalInteger(world.schemaVersion, null),
+    createdAt: normalizeText(world.createdAt, null),
+  };
+}
+
+export function projectToolOwnedWorldsResponse(payload = {}, { accountId = null } = {}) {
+  const worlds = Array.isArray(payload.items)
+    ? payload.items.map((world) => ({
+      worldId: world.worldId,
+      displayName: world.displayName,
+      worldContextText: normalizeText(world.worldContextText, null),
+      enabled: normalizeOptionalBoolean(world.enabled, null),
+      status: normalizeText(world.status, null),
+      worldRole: projectWorldRole(world.worldRole, null),
+      createdAt: normalizeText(world.createdAt, null),
+      updatedAt: normalizeText(world.updatedAt, null),
+      broadcast: projectToolBroadcastConfig(world.broadcast),
+      stats: projectWorldStats(world.stats),
+    }))
+    : [];
+
+  return {
+    accountId: normalizeText(accountId, null),
+    worlds,
+  };
+}
+
+export function projectToolManagedWorldResponse(world = {}, { accountId = null } = {}) {
+  return {
+    worldId: world.worldId,
+    accountId: normalizeText(accountId, null),
+    displayName: world.displayName,
+    worldContextText: normalizeText(world.worldContextText, null),
+    ownerAgentId: normalizeText(world.ownerAgentId, null),
+    enabled: normalizeOptionalBoolean(world.enabled, null),
+    status: normalizeText(world.status, null),
+    worldRole: projectWorldRole(world.worldRole, null),
+    schemaVersion: normalizeOptionalInteger(world.schemaVersion, null),
+    createdAt: normalizeText(world.createdAt, null),
+    updatedAt: normalizeText(world.updatedAt, null),
+    participantContextField: projectParticipantContextField(world.participantContextField),
+    broadcast: projectToolBroadcastConfig(world.broadcast),
+    stats: projectWorldStats(world.stats),
+  };
+}
+
+function projectToolWorldBroadcastRequestItem(item = {}) {
+  return {
+    agentId: normalizeText(item.agentId, null),
+    status: normalizeText(item.status, null),
+    verdict: normalizeText(item.verdict, null),
+    chatRequest: projectChatRequestItem(item.chatRequest),
+    kickoff: projectChatRequestKickoff(item.kickoff),
+  };
+}
+
+function projectToolWorldBroadcastFailureItem(item = {}) {
+  return {
+    agentId: normalizeText(item.agentId, null),
+    status: normalizeText(item.status, 'failed'),
+    httpStatus: normalizeOptionalInteger(item.httpStatus, null),
+    error: normalizeText(item.error, null),
+    reason: normalizeText(item.reason, null),
+    message: normalizeText(item.message, null),
+  };
+}
+
+export function projectToolWorldBroadcastResponse(payload = {}, { accountId = null } = {}) {
+  return {
+    accountId: normalizeText(accountId, null),
+    status: normalizeText(payload.status, null),
+    worldId: normalizeText(payload.worldId, null),
+    senderAgentId: normalizeText(payload.senderAgentId, null),
+    senderRole: projectWorldRole(payload.senderRole, null),
+    audience: normalizeText(payload.audience, null),
+    excludeSelf: normalizeOptionalBoolean(payload.excludeSelf, null),
+    eligibility: normalizeText(payload.eligibility, null),
+    broadcastId: normalizeText(payload.broadcastId, null),
+    totalTargets: normalizeOptionalInteger(payload.totalTargets, null),
+    createdCount: normalizeOptionalInteger(payload.createdCount, null),
+    failedCount: normalizeOptionalInteger(payload.failedCount, null),
+    pendingCount: normalizeOptionalInteger(payload.pendingCount, null),
+    autoAcceptedCount: normalizeOptionalInteger(payload.autoAcceptedCount, null),
+    rejectedCount: normalizeOptionalInteger(payload.rejectedCount, null),
+    nextAction: normalizeText(payload.nextAction, null),
+    requests: Array.isArray(payload.requests)
+      ? payload.requests.map((item) => projectToolWorldBroadcastRequestItem(item))
+      : [],
+    failures: Array.isArray(payload.failures)
+      ? payload.failures.map((item) => projectToolWorldBroadcastFailureItem(item))
+      : [],
+  };
+}
+
+function projectToolWorldMembershipSummary(membership = {}) {
+  return {
+    membershipId: normalizeText(membership.membershipId, null),
+    worldId: normalizeText(membership.worldId, null),
+    displayName: normalizeText(membership.displayName, null),
+    worldContextText: normalizeText(membership.worldContextText, null),
+    ownerAgentId: normalizeText(membership.ownerAgentId, null),
+    enabled: normalizeOptionalBoolean(membership.enabled, null),
+    worldStatus: normalizeText(membership.worldStatus, null),
+    worldRole: projectWorldRole(membership.worldRole, null),
+    membershipStatus: normalizeText(membership.membershipStatus, null),
+    participantContextText: normalizeText(membership.participantContextText, null),
+    joinedAt: normalizeText(membership.joinedAt, null),
+    updatedAt: normalizeText(membership.updatedAt, null),
+    nextAction: normalizeText(membership.nextAction, null),
+  };
+}
+
+export function projectToolWorldMembershipListResponse(payload = {}, { accountId = null } = {}) {
+  return {
+    accountId: normalizeText(accountId, null),
+    memberships: Array.isArray(payload.items)
+      ? payload.items.map((membership) => projectToolWorldMembershipSummary(membership))
+      : [],
+    nextAction: normalizeText(payload.nextAction, null),
+  };
+}
+
+export function projectToolWorldMembershipResponse(payload = {}, { accountId = null } = {}) {
+  return {
+    accountId: normalizeText(accountId, null),
+    ...projectToolWorldMembershipSummary(payload),
+  };
+}
+
+export function projectToolWorldMemberSearchResponse(payload = {}, { accountId = null } = {}) {
+  return {
+    accountId: normalizeText(accountId, null),
+    status: normalizeText(payload.status, 'no_matches'),
+    worldId: normalizeText(payload.worldId, null),
+    query: normalizeText(payload.query, null),
+    sort: normalizeText(payload.sort, 'match'),
+    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}`),
+        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 || {}),
+        worldFeedbackSummary: projectWorldFeedbackSummary(item.worldFeedbackSummary),
+        requestChat: projectRequestChatPayload(item.requestChat, { accountId }),
+      }))
+      : [],
+  };
+}
+
+export function projectToolFeedbackSubmissionResponse(result = {}) {
+  const feedback = result.feedback && typeof result.feedback === 'object' ? result.feedback : {};
+  const reporter = feedback.reporter && typeof feedback.reporter === 'object' ? feedback.reporter : {};
+  const context = feedback.context && typeof feedback.context === 'object' ? feedback.context : {};
+  const runtimeContext = feedback.runtimeContext && typeof feedback.runtimeContext === 'object'
+    ? feedback.runtimeContext
+    : {};
+
+  return {
+    status: normalizeText(result.status, 'recorded'),
+    feedbackId: normalizeText(feedback.feedbackId, null),
+    category: normalizeText(feedback.category, null),
+    impact: normalizeText(feedback.impact, 'medium'),
+    title: normalizeText(feedback.title, null),
+    accountId: normalizeText(feedback.accountId, null),
+    reporterAgentId: normalizeText(reporter.agentId, null),
+    reporterIdentity: normalizeText(reporter.publicIdentity?.displayIdentity, null),
+    worldId: normalizeText(context.worldId, null),
+    conversationKey: normalizeText(context.conversationKey, null),
+    turnId: normalizeText(context.turnId, null),
+    deliveryId: normalizeText(context.deliveryId, null),
+    tags: normalizeStringList(context.tags),
+    createdAt: normalizeText(feedback.createdAt, null),
+    runtime: {
+      channelId: normalizeText(runtimeContext.channelId, null),
+      toolName: normalizeText(runtimeContext.toolName, null),
+      toolCallId: normalizeText(runtimeContext.toolCallId, null),
+      pluginVersion: normalizeText(runtimeContext.pluginVersion, null),
+    },
+    nextAction: 'keep_feedback_id_for_follow_up',
+  };
+}
+
+function projectToolAgentSummary(agent = {}) {
+  if (!agent || typeof agent !== 'object') return null;
+  return {
+    agentId: normalizeText(agent.agentId, 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,
+  };
+}
+
+function projectToolWorldSummary(world = {}) {
+  if (!world || typeof world !== 'object') return null;
+  return {
+    worldId: normalizeText(world.worldId, null),
+    slug: normalizeText(world.slug, null),
+    displayName: normalizeText(world.displayName, null),
+    summary: normalizeText(world.summary, null),
+  };
+}
+
+function normalizeConversationScopeDetails(input = {}) {
+  const conversation = input && typeof input === 'object' && !Array.isArray(input) ? input : {};
+  const worldId = normalizeText(conversation.worldId, null);
+  return {
+    mode: worldId ? 'world' : 'direct',
+    worldId,
+    world: projectToolWorldSummary(conversation.world),
+  };
+}
+
+function projectChatRequestKickoff(kickoff = {}) {
+  const normalizedKickoff = normalizeAcceptedChatKickoffRecord(kickoff, { fallbackStatus: 'skipped' });
+  if (!normalizedKickoff) return null;
+  return {
+    status: normalizeText(normalizedKickoff.status, 'skipped'),
+    deliveredAt: normalizeText(normalizedKickoff.deliveredAt, null),
+    senderKickoffDeliveredAt: normalizeText(
+      normalizedKickoff.senderKickoffDeliveredAt,
+      normalizeText(normalizedKickoff.deliveredAt, null),
+    ),
+    openerAcceptedAt: normalizeText(normalizedKickoff.openerAcceptedAt, null),
+    openerDeliveredAt: normalizeText(normalizedKickoff.openerDeliveredAt, null),
+    liveChatEstablishedAt: normalizeText(normalizedKickoff.liveChatEstablishedAt, null),
+    conversationKey: normalizeText(normalizedKickoff.conversationKey, null),
+    localSessionKey: normalizeText(
+      normalizedKickoff.localSessionKey,
+      normalizeText(normalizedKickoff.sessionKey, null),
+    ),
+    turnId: normalizeText(normalizedKickoff.turnId, null),
+    deliveryId: normalizeText(normalizedKickoff.deliveryId, null),
+    created: typeof normalizedKickoff.created === 'boolean' ? normalizedKickoff.created : null,
+    reason: normalizeText(normalizedKickoff.reason, null),
+  };
+}
+
+function projectChatRequestOrigin(origin = {}) {
+  if (!origin || typeof origin !== 'object' || Array.isArray(origin)) return null;
+  return {
+    type: normalizeText(origin.type, 'chat_request'),
+    broadcastId: normalizeText(origin.broadcastId, null),
+  };
+}
+
+function projectChatRequestItem(request = {}) {
+  if (!request || typeof request !== 'object') return null;
+  const requestContext = request.requestContext && typeof request.requestContext === 'object' && !Array.isArray(request.requestContext)
+    ? request.requestContext
+    : {};
+  const kickoffBrief = request.kickoffBrief && typeof request.kickoffBrief === 'object' && !Array.isArray(request.kickoffBrief)
+    ? request.kickoffBrief
+    : requestContext.kickoffBrief && typeof requestContext.kickoffBrief === 'object' && !Array.isArray(requestContext.kickoffBrief)
+      ? requestContext.kickoffBrief
+      : null;
+  const conversation = normalizeConversationScopeDetails(
+    request.conversation && typeof request.conversation === 'object' && !Array.isArray(request.conversation)
+      ? request.conversation
+      : requestContext.conversation,
+  );
+  return {
+    chatRequestId: normalizeText(request.chatRequestId || request.requestId, null),
+    status: normalizeText(request.status, 'pending'),
+    direction: normalizeText(request.direction, null),
+    openingMessage: normalizeText(
+      request.openingMessage,
+      normalizeText(kickoffBrief?.text, normalizeText(requestContext.openingPayload?.text, normalizeText(requestContext.message, null))),
+    ),
+    kickoffBrief: kickoffBrief
+      ? {
+          text: normalizeText(kickoffBrief.text, null),
+          payload: kickoffBrief.payload && typeof kickoffBrief.payload === 'object' && !Array.isArray(kickoffBrief.payload)
+            ? kickoffBrief.payload
+            : null,
+          source: normalizeText(kickoffBrief.source, 'chat_request_brief'),
+        }
+      : null,
+    createdAt: normalizeText(request.createdAt, null),
+    respondedAt: normalizeText(request.respondedAt, null),
+    expiresAt: normalizeText(request.expiresAt, null),
+    origin: projectChatRequestOrigin(request.origin),
+    fromAgent: projectToolAgentSummary(request.fromAgent),
+    toAgent: projectToolAgentSummary(request.toAgent),
+    counterparty: projectToolAgentSummary(request.counterparty),
+    conversation,
+  };
+}
+
+function projectChatInboxChatItem(chat = {}) {
+  if (!chat || typeof chat !== 'object' || Array.isArray(chat)) return null;
+  return {
+    chatRequestId: normalizeText(chat.chatRequestId, null),
+    status: normalizeText(chat.status, null),
+    direction: normalizeText(chat.direction, null),
+    createdAt: normalizeText(chat.createdAt, null),
+    updatedAt: normalizeText(chat.updatedAt, null),
+    lastTurnAt: normalizeText(chat.lastTurnAt, null),
+    conversationKey: normalizeText(chat.conversationKey, null),
+    localSessionKey: normalizeText(chat.localSessionKey, normalizeText(chat.sessionKey, null)),
+    turnCount: normalizeInteger(chat.turnCount, null),
+    counterparty: projectToolAgentSummary(chat.counterparty),
+    conversation: normalizeConversationScopeDetails(chat.conversation),
+    feedbackSummary: projectConversationFeedbackSummary(chat.feedbackSummary),
+  };
+}
+
+function projectChatInboxFilters(filters = {}) {
+  if (!filters || typeof filters !== 'object' || Array.isArray(filters)) return {};
+  const projected = {
+    direction: normalizeText(filters.direction, null),
+    mode: normalizeText(filters.mode, null),
+    status: normalizeText(filters.status, null),
+    worldId: normalizeText(filters.worldId, null),
+    chatRequestId: normalizeText(filters.chatRequestId, null),
+    conversationKey: normalizeText(filters.conversationKey, null),
+    localSessionKey: normalizeText(filters.localSessionKey, null),
+    counterpartyAgentId: normalizeText(filters.counterpartyAgentId, null),
+  };
+  return Object.fromEntries(
+    Object.entries(projected).filter(([, value]) => value != null),
+  );
+}
+
+function projectChatInboxCountBlock(counts = {}, fallback = {}) {
+  return {
+    pendingRequestCount: normalizeInteger(counts.pendingRequestCount, fallback.pendingRequestCount ?? 0),
+    chatCount: normalizeInteger(counts.chatCount, fallback.chatCount ?? 0),
+    chatStatusCounts: counts.chatStatusCounts && typeof counts.chatStatusCounts === 'object' && !Array.isArray(counts.chatStatusCounts)
+      ? {
+          opening: normalizeInteger(counts.chatStatusCounts.opening, 0),
+          ending: normalizeInteger(counts.chatStatusCounts.ending, 0),
+          active: normalizeInteger(counts.chatStatusCounts.active, 0),
+          silent: normalizeInteger(counts.chatStatusCounts.silent, 0),
+          kickoff_failed: normalizeInteger(counts.chatStatusCounts.kickoff_failed, 0),
+          ended: normalizeInteger(counts.chatStatusCounts.ended, 0),
+        }
+      : {
+          opening: 0,
+          ending: 0,
+          active: 0,
+          silent: 0,
+          kickoff_failed: 0,
+          ended: 0,
+        },
+  };
+}
+
+export function projectToolChatRequestMutationResponse(result = {}, { accountId = null } = {}) {
+  const request = result.chatRequest && typeof result.chatRequest === 'object'
+    ? result.chatRequest
+    : result.request && typeof result.request === 'object'
+      ? result.request
+      : result;
+  const projectedRequest = projectChatRequestItem(request);
+  const kickoff = projectChatRequestKickoff(result.kickoff || result.request?.kickoff);
+  const projectedChat = projectChatInboxChatItem(result.chat);
+  const normalizedStatus = normalizeText(result.status, projectedRequest?.status || 'pending');
+  return {
+    status: normalizedStatus,
+    accountId: normalizeText(accountId, null),
+    chatRequest: projectedRequest,
+    ...(projectedChat ? { chat: projectedChat } : {}),
+    kickoff,
+    nextAction: normalizeText(
+      result.nextAction,
+      normalizedStatus === 'accepted'
+        ? kickoff?.status === 'established'
+          ? 'runtime_owns_live_conversation'
+          : kickoff?.status === 'sent'
+            ? 'wait_for_sender_opener_delivery'
+            : kickoff?.status === 'queued'
+              ? 'wait_for_sender_runtime_availability'
+              : kickoff?.status === 'failed'
+                ? 'backend_kickoff_failed'
+                : 'chat_request_accepted_without_opening_message'
+        : normalizedStatus === 'pending'
+          ? 'wait_for_peer_acceptance'
+          : 'chat_request_closed',
+    ),
+  };
+}
+
+export function projectToolChatInboxResponse(result = {}, { accountId = null } = {}) {
+  const pendingRequests = Array.isArray(result.pendingRequests)
+    ? result.pendingRequests.map((request) => projectChatRequestItem(request)).filter(Boolean)
+    : [];
+  const chats = Array.isArray(result.chats)
+    ? result.chats.map((chat) => projectChatInboxChatItem(chat)).filter(Boolean)
+    : [];
+  const projectedFilters = projectChatInboxFilters(result.filters);
+  const globalCounts = projectChatInboxCountBlock(result.counts?.global, {
+    pendingRequestCount: pendingRequests.length,
+    chatCount: chats.length,
+  });
+  const filteredCounts = projectChatInboxCountBlock(result.counts?.filtered, {
+    pendingRequestCount: pendingRequests.length,
+    chatCount: chats.length,
+  });
+  return {
+    accountId: normalizeText(accountId, null),
+    filters: projectedFilters,
+    counts: {
+      global: globalCounts,
+      filtered: filteredCounts,
+    },
+    pendingRequests,
+    chats,
+  };
+}