@xfxstudio/claworld 0.2.6 → 0.2.7

package/src/openclaw/runtime/demo-session-bootstrap.js

@@ -23,8 +23,7 @@ export function createDemoSessionBootstrap() {
           'load demo world',
           'create manual session',
           'inject opening system message',
-          'wait for dual raise or manual stop',
-          'build canonical result',
+          'wait for conversation closure or manual stop',
         ],
         status: 'planned',
       };

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

@@ -622,6 +622,22 @@ function projectChatRequestItem(request = {}) {
   };
 }
 
+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)),
+    counterparty: projectToolAgentSummary(chat.counterparty),
+    conversation: normalizeConversationScopeDetails(chat.conversation),
+  };
+}
+
 export function projectToolFriendRequestMutationResponse(result = {}, { accountId = null } = {}) {
   return {
     status: result.alreadyFriends === true
@@ -690,3 +706,26 @@ export function projectToolChatRequestListResponse(result = {}, { accountId = nu
     items,
   };
 }
+
+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)
+    : [];
+  return {
+    accountId: normalizeText(accountId, null),
+    counts: result.counts && typeof result.counts === 'object' && !Array.isArray(result.counts)
+      ? {
+          pendingRequestCount: normalizeInteger(result.counts.pendingRequestCount, pendingRequests.length),
+          chatCount: normalizeInteger(result.counts.chatCount, chats.length),
+        }
+      : {
+          pendingRequestCount: pendingRequests.length,
+          chatCount: chats.length,
+        },
+    pendingRequests,
+    chats,
+  };
+}

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

@@ -2,7 +2,7 @@ export const CLAWORLD_TOOL_CONTRACT_VERSION = 'v1';
 
 export const CLAWORLD_CHAT_REQUEST_TOOL_NAMES = Object.freeze([
   'claworld_request_chat',
-  'claworld_list_chat_requests',
+  'claworld_chat_inbox',
   'claworld_accept_chat_request',
 ]);
 

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

@@ -207,12 +207,11 @@ export async function createModeratedWorld({
   const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
   const created = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds`, {
     method: 'POST',
-    headers: {
+    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
       accept: 'application/json',
       'content-type': 'application/json',
       ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
-      ...(resolvedRuntimeConfig.relay?.credentialToken ? { 'x-relay-token': resolvedRuntimeConfig.relay.credentialToken } : {}),
-    },
+    }),
     body: JSON.stringify({
       agentId: resolvedAgentId,
       displayName,
@@ -259,11 +258,10 @@ export async function fetchOwnedWorlds({
   requestUrl.searchParams.set('agentId', resolvedAgentId);
   requestUrl.searchParams.set('includeDisabled', includeDisabled ? 'true' : 'false');
   const result = await fetchJson(fetchImpl, requestUrl.toString(), {
-    headers: {
+    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
       accept: 'application/json',
       ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
-      ...(resolvedRuntimeConfig.relay?.credentialToken ? { 'x-relay-token': resolvedRuntimeConfig.relay.credentialToken } : {}),
-    },
+    }),
   });
 
   if (!result.ok) {
@@ -312,11 +310,10 @@ export async function manageModeratedWorld({
     const requestUrl = new URL(`${baseUrl}/v1/moderation/worlds/${encodeURIComponent(resolvedWorldId)}`);
     requestUrl.searchParams.set('agentId', resolvedAgentId);
     const result = await fetchJson(fetchImpl, requestUrl.toString(), {
-      headers: {
+      headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
         accept: 'application/json',
         ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
-        ...(resolvedRuntimeConfig.relay?.credentialToken ? { 'x-relay-token': resolvedRuntimeConfig.relay.credentialToken } : {}),
-      },
+      }),
     });
 
     if (!result.ok) {
@@ -334,12 +331,11 @@ export async function manageModeratedWorld({
 
   const result = await fetchJson(fetchImpl, `${baseUrl}/v1/moderation/worlds/${encodeURIComponent(resolvedWorldId)}`, {
     method: 'PATCH',
-    headers: {
+    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
       accept: 'application/json',
       'content-type': 'application/json',
       ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
-      ...(resolvedRuntimeConfig.relay?.credentialToken ? { 'x-relay-token': resolvedRuntimeConfig.relay.credentialToken } : {}),
-    },
+    }),
     body: JSON.stringify({
       agentId: resolvedAgentId,
       ...(changes && typeof changes === 'object' ? { changes } : {}),

package/src/product-shell/catalog/default-world-catalog.js

@@ -9,7 +9,7 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
     lifecycle: 'prototype',
     tags: ['dating', 'matching', 'a2a'],
     worldContextText:
-      '世界：Dating Demo World [dating-demo-world]\n简介：A lightweight social world for proving world-scoped join, review, and chat request flow.\n互动规则：Clarify fit quickly, stay respectful, and stop once next steps are clear.\n禁止事项：Do not pressure, harass, manipulate, or ask for unsafe personal details.\n结果要求：Rate the interaction from 1 to 10 based on fit, clarity, and respect.',
+      '世界：Dating Demo World [dating-demo-world]\n简介：A lightweight social world for proving world-scoped join, review, and chat request flow.\n互动规则：Clarify fit quickly, stay respectful, and stop once next steps are clear.\n禁止事项：Do not pressure, harass, manipulate, or ask for unsafe personal details.',
   },
   {
     worldId: 'skill-handoff-world',
@@ -21,7 +21,7 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
     lifecycle: 'prototype',
     tags: ['skills', 'services', 'matching'],
     worldContextText:
-      '世界：Skill Handoff World [skill-handoff-world]\n简介：A service marketplace world where agents screen delivery fit before moving to direct human contact.\n互动规则：Clarify scope, constraints, and whether a handoff is justified.\n禁止事项：Do not misrepresent capabilities or hide delivery blockers.\n结果要求：Rate the exchange from 1 to 10 based on scope clarity and handoff confidence.',
+      '世界：Skill Handoff World [skill-handoff-world]\n简介：A service marketplace world where agents screen delivery fit before moving to direct human contact.\n互动规则：Clarify scope, constraints, and whether a handoff is justified.\n禁止事项：Do not misrepresent capabilities or hide delivery blockers.',
   },
   {
     worldId: 'job-match-world',
@@ -33,6 +33,6 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
     lifecycle: 'prototype',
     tags: ['jobs', 'recruiting', 'screening'],
     worldContextText:
-      '世界：Job Match World [job-match-world]\n简介：A recruiting world for agent-assisted screening before direct human contact.\n互动规则：Focus on fit, constraints, and whether a next step is justified.\n禁止事项：Do not fabricate experience, compensation, or hiring authority.\n结果要求：Rate the interaction from 1 to 10 based on fit, clarity, and follow-up likelihood.',
+      '世界：Job Match World [job-match-world]\n简介：A recruiting world for agent-assisted screening before direct human contact.\n互动规则：Focus on fit, constraints, and whether a next step is justified.\n禁止事项：Do not fabricate experience, compensation, or hiring authority.',
   },
 ]);

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

@@ -77,15 +77,6 @@ function normalizeField(field = {}, index = 0, { required = false } = {}) {
   };
 }
 
-function normalizeExampleSignals(exampleSignals = {}) {
-  const normalizeGroup = (key) => (Array.isArray(exampleSignals[key]) ? exampleSignals[key] : []);
-  return {
-    intentSignals: normalizeGroup('intentSignals'),
-    conversationSignals: normalizeGroup('conversationSignals'),
-    agentSignals: normalizeGroup('agentSignals'),
-  };
-}
-
 function normalizeJoinSchema(joinSchema = {}) {
   return {
     requiredFields: [
@@ -167,10 +158,6 @@ export function normalizeWorldManifest(manifest = {}, index = 0) {
   const defaultInteractionRules = normalizeText(conversationTemplate?.worldRules?.openingText, null);
   const normalizedInteractionRules = normalizeText(manifest.interactionRules, defaultInteractionRules);
   const normalizedProhibitedRules = normalizeText(manifest.prohibitedRules, null);
-  const normalizedRatingRules = normalizeText(
-    manifest.ratingRules,
-    'After the interaction ends, each agent should rate the other participant from 1 to 10 based on fit, clarity, and rule compliance.',
-  );
 
   return {
     worldId,
@@ -183,7 +170,6 @@ export function normalizeWorldManifest(manifest = {}, index = 0) {
     tags: normalizeStringList(manifest.tags),
     interactionRules: normalizedInteractionRules,
     prohibitedRules: normalizedProhibitedRules,
-    ratingRules: normalizedRatingRules,
     worldContextText: buildWorldContextText({
       worldId,
       displayName: normalizeText(manifest.displayName, worldId),
@@ -194,7 +180,6 @@ export function normalizeWorldManifest(manifest = {}, index = 0) {
       ),
       interactionRules: normalizedInteractionRules,
       prohibitedRules: normalizedProhibitedRules,
-      ratingRules: normalizedRatingRules,
     }),
     creatorAgentId: normalizeText(manifest.creatorAgentId, null),
     eligibility: normalizeWorldEligibility(manifest.eligibility, 'active'),
@@ -232,12 +217,6 @@ export function normalizeWorldManifest(manifest = {}, index = 0) {
         stateChangeMessages: conversationTemplate?.worldRules?.stateChangeMessages || {},
       },
     },
-    resultContract: {
-      schemaId: normalizeText(manifest.resultContract?.schemaId, `${worldId}.result.v1`),
-      outputs: normalizeStringList(manifest.resultContract?.outputs),
-      successCriteria: normalizeStringList(manifest.resultContract?.successCriteria),
-      exampleSignals: normalizeExampleSignals(manifest.resultContract?.exampleSignals),
-    },
     meta: {
       status: normalizeText(manifest.meta?.status, 'scaffold_ready'),
       persistence: normalizeText(manifest.meta?.persistence, 'in_memory_catalog'),
@@ -311,7 +290,6 @@ export function projectWorldDetail(world) {
       summary: world.summary,
       interactionRules: world.interactionRules,
       prohibitedRules: world.prohibitedRules,
-      ratingRules: world.ratingRules,
       conversationMode: world.conversationTemplate.mode,
       conversationOverview: {
         worldId: world.worldId,
@@ -359,7 +337,6 @@ export function projectConversationWorldContext(world) {
         summary: world.summary,
         interactionRules: world.interactionRules,
         prohibitedRules: world.prohibitedRules,
-        ratingRules: world.ratingRules,
         conversationMode: world.conversationTemplate.mode,
         conversationOverview: {
           worldId: world.worldId,
@@ -378,7 +355,6 @@ export function projectConversationWorldContext(world) {
     worldContextText: runtimeWorldContext.text,
     interactionRules: world.interactionRules,
     prohibitedRules: world.prohibitedRules,
-    ratingRules: world.ratingRules,
     conversationMode: world.conversationTemplate.mode,
     conversationOverview: {
       worldId: world.worldId,

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

@@ -173,7 +173,6 @@ function normalizeWorldDetail(payload = {}) {
       conversationMode: normalizeText(payload.conversationMode, 'a2a'),
       interactionRules: normalizeText(payload.interactionRules, null),
       prohibitedRules: normalizeText(payload.prohibitedRules, null),
-      ratingRules: normalizeText(payload.ratingRules, null),
       eligibility: normalizeText(payload.eligibility, 'active'),
       broadcast: normalizeBroadcastConfig(payload.broadcast),
       requiredFields,
@@ -235,7 +234,6 @@ function normalizeWorldDetail(payload = {}) {
     ),
     interactionRules: normalizeText(payload.interactionRules || world.interactionRules, null),
     prohibitedRules: normalizeText(payload.prohibitedRules || world.prohibitedRules, null),
-    ratingRules: normalizeText(payload.ratingRules || world.ratingRules, null),
     eligibility: normalizeText(payload.eligibility || world.eligibility, 'active'),
     broadcast: normalizeBroadcastConfig(payload.broadcast || world.broadcast),
     requiredFields,
@@ -422,7 +420,6 @@ export function buildWorldSessionStartupText(detail = {}) {
   const convergenceText = normalizeText(conversationOverview.convergence?.text, null);
   const interactionRules = normalizeText(normalizedDetail.interactionRules, null);
   const prohibitedRules = normalizeText(normalizedDetail.prohibitedRules, null);
-  const ratingRules = normalizeText(normalizedDetail.ratingRules, null);
 
   const lines = [
     'Internal Claworld world context for this conversation.',
@@ -434,7 +431,6 @@ export function buildWorldSessionStartupText(detail = {}) {
     openingText ? `Opening focus: ${openingText}` : null,
     interactionRules ? `Interaction rules: ${interactionRules}` : null,
     prohibitedRules ? `Prohibited rules: ${prohibitedRules}` : null,
-    ratingRules ? `Rating rules: ${ratingRules}` : null,
     convergenceText ? `Convergence rule: ${convergenceText}` : null,
     'Apply these world rules symmetrically when responding in this conversation.',
   ].filter(Boolean);

package/src/product-shell/index.js

@@ -9,7 +9,6 @@ import { registerOnboardingRoutes } from './onboarding/onboarding-routes.js';
 import { createMembershipService } from './membership/membership-service.js';
 import { createMatchmakingService } from './matching/matchmaking-service.js';
 import { createWorldSearchService } from './search/search-service.js';
-import { createResultService } from './results/result-service.js';
 import { createWorldConversationOrchestrator } from './orchestration/world-conversation-orchestrator.js';
 import { createSocialService } from './social/social-service.js';
 import { registerSocialRoutes } from './social/social-routes.js';
@@ -50,7 +49,6 @@ export function createClaworldProductShell({
     chatRequestService,
     store,
   });
-  const resultService = createResultService();
   const friendService = createFriendService({ store, policy: relay?.policy });
   const socialLookupService = createSocialService({ worldService, store });
   const feedbackService = createFeedbackService({ store });
@@ -62,7 +60,6 @@ export function createClaworldProductShell({
   };
   const worldConversationOrchestrator = createWorldConversationOrchestrator({
     worldService,
-    resultService,
   });
 
   const productShell = {
@@ -78,7 +75,6 @@ export function createClaworldProductShell({
       chatRequests: chatRequestService,
       moderation: worldAdminService,
       feedback: feedbackService,
-      results: resultService,
       orchestration: worldConversationOrchestrator,
     },
     registerRoutes(app) {
@@ -115,7 +111,6 @@ export function createClaworldProductShell({
           'moderation',
           'feedback',
           'orchestration',
-          'results',
         ],
         routes: [
           'GET /v1/meta/product-shell',

package/src/product-shell/orchestration/world-conversation-orchestrator.js

@@ -2,7 +2,6 @@ import { createSystemMessageOrchestrator } from './world-conversation-text.js';
 
 export function createWorldConversationOrchestrator({
   worldService,
-  resultService,
   systemMessages = createSystemMessageOrchestrator(),
 } = {}) {
   return {
@@ -22,7 +21,6 @@ export function createWorldConversationOrchestrator({
         },
         openingPlan,
         convergencePlan,
-        resultPreview: resultService.previewConversation({ world, conversationKey }),
         status: 'preview_ready',
       };
     },

package/src/product-shell/orchestration/world-conversation-text.js

@@ -86,7 +86,6 @@ export function buildWorldConversationContextEvent(detail = {}) {
   const convergenceText = normalizeText(conversationOverview.convergence?.text, null);
   const interactionRules = normalizeText(detail.interactionRules, null);
   const prohibitedRules = normalizeText(detail.prohibitedRules, null);
-  const ratingRules = normalizeText(detail.ratingRules, null);
 
   const lines = [
     'Internal Claworld world context for this conversation.',
@@ -98,7 +97,6 @@ export function buildWorldConversationContextEvent(detail = {}) {
     openingText ? `Opening focus: ${openingText}` : null,
     interactionRules ? `Interaction rules: ${interactionRules}` : null,
     prohibitedRules ? `Prohibited rules: ${prohibitedRules}` : null,
-    ratingRules ? `Rating rules: ${ratingRules}` : null,
     convergenceText ? `Convergence rule: ${convergenceText}` : null,
     'Apply these world rules symmetrically when responding in this conversation.',
   ].filter(Boolean);

package/src/product-shell/social/chat-request-routes.js

@@ -56,7 +56,10 @@ export function registerChatRequestRoutes(app, { chatRequestService, store }) {
         targetAgentId: req.body?.targetAgentId,
         kickoffBrief: req.body?.kickoffBrief,
         openingMessage: req.body?.openingMessage,
+        openingPayload: req.body?.openingPayload,
         worldId: req.body?.worldId,
+        requestContext: req.body?.requestContext,
+        source: req.body?.source,
       });
       res.status(201).json(result);
     } catch (error) {
@@ -75,7 +78,7 @@ export function registerChatRequestRoutes(app, { chatRequestService, store }) {
     if (!authAgent.agentId) return sendMissingAgentIdentity(res);
 
     try {
-      const result = chatRequestService.listChatRequests({
+      const result = chatRequestService.listChatInbox({
         agentId: authAgent.agentId,
         direction: req.query.direction,
       });

package/src/product-shell/social/chat-request-service.js

@@ -1,4 +1,5 @@
 import { normalizeAgentProfile, resolveAgentDisplayName, resolveAgentVisibility } from '../../lib/agent-profile.js';
+import { normalizeChatRequestInput } from '../../lib/chat-request.js';
 import { createKickoffBrief, resolveStoredKickoffBrief } from '../../lib/relay/kickoff-text.js';
 import { WORLD_ACTIONS } from '../worlds/world-authorization.js';
 import { normalizeChatRequestApprovalPolicy } from '../contracts/chat-request-approval-policy.js';
@@ -198,6 +199,7 @@ function resolveAcceptNextAction(kickoff) {
   const kickoffStatus = kickoff?.status || 'skipped';
   if (kickoffStatus === 'established') return 'runtime_owns_live_conversation';
   if (kickoffStatus === 'sent') return 'wait_for_sender_opener_delivery';
+  if (kickoffStatus === 'kept_silent') return 'sender_kept_silent';
   if (kickoffStatus === 'failed') return 'backend_kickoff_failed';
   return 'chat_request_accepted_without_opening_message';
 }
@@ -280,6 +282,92 @@ function projectChatRequestOrigin(request = {}) {
   };
 }
 
+function hasConversationScope(conversation = null) {
+  return Boolean(conversation && typeof conversation === 'object' && !Array.isArray(conversation) && Object.keys(conversation).length > 0);
+}
+
+function resolveConversationLinkRequest(requests = [], conversation = {}) {
+  const conversationMeta = conversation?.meta && typeof conversation.meta === 'object' && !Array.isArray(conversation.meta)
+    ? conversation.meta
+    : {};
+  const approvalRequestId = normalizeText(conversationMeta.approvalRequestId, null);
+  if (approvalRequestId) {
+    return requests.find((request) => normalizeText(request.chatRequestId || request.requestId, null) === approvalRequestId) || null;
+  }
+
+  const conversationKey = normalizeText(conversation?.conversationKey, null);
+  if (!conversationKey) return null;
+
+  return requests.find((request) => {
+    const kickoff = request?.kickoff && typeof request.kickoff === 'object' && !Array.isArray(request.kickoff)
+      ? request.kickoff
+      : {};
+    return normalizeText(kickoff.conversationKey, null) === conversationKey
+      || normalizeText(request?.conversation?.conversationKey, null) === conversationKey;
+  }) || null;
+}
+
+function resolveInboxChatDirection(viewerAgentId, request = null) {
+  if (!request) return null;
+  if (viewerAgentId === request.fromAgentId) return 'outbound';
+  if (viewerAgentId === request.toAgentId) return 'inbound';
+  return 'related';
+}
+
+function resolveInboxChatCounterpartyAgentId(viewerAgentId, request = null, conversation = null) {
+  if (request) {
+    if (viewerAgentId === request.fromAgentId) return request.toAgentId;
+    if (viewerAgentId === request.toAgentId) return request.fromAgentId;
+  }
+
+  const participantIds = Array.isArray(conversation?.participantIds) ? conversation.participantIds : [];
+  return participantIds.find((participantId) => participantId && participantId !== viewerAgentId) || null;
+}
+
+function resolveInboxChatStatus(conversation = {}, request = null) {
+  const kickoffStatus = normalizeText(request?.kickoff?.status, null);
+  if (kickoffStatus === 'sent') return 'opening';
+  if (kickoffStatus === 'kept_silent') return 'silent';
+  if (kickoffStatus === 'failed') return 'kickoff_failed';
+  const conversationStatus = normalizeText(conversation?.status, 'active');
+  if (conversationStatus === 'active') return 'active';
+  if (conversationStatus === 'closed') return 'ended';
+  return conversationStatus;
+}
+
+function resolveInboxConversationWorldSummary(worldService, request = {}, conversation = {}) {
+  const requestContext = request?.requestContext && typeof request.requestContext === 'object' && !Array.isArray(request.requestContext)
+    ? request.requestContext
+    : {};
+  const requestConversation = request?.conversation && typeof request.conversation === 'object' && !Array.isArray(request.conversation)
+    ? request.conversation
+    : {};
+  const conversationMeta = conversation?.meta && typeof conversation.meta === 'object' && !Array.isArray(conversation.meta)
+    ? conversation.meta
+    : {};
+  const worldMeta = conversationMeta.world && typeof conversationMeta.world === 'object' && !Array.isArray(conversationMeta.world)
+    ? conversationMeta.world
+    : {};
+  const worldId = normalizeConversationWorldId(requestConversation.worldId)
+    || normalizeConversationWorldId(requestContext.conversation?.worldId)
+    || normalizeConversationWorldId(worldMeta.worldId)
+    || normalizeConversationWorldId(conversationMeta.worldId);
+
+  if (!worldId) {
+    return {
+      mode: 'direct',
+      worldId: null,
+      world: null,
+    };
+  }
+
+  return {
+    mode: 'world',
+    worldId,
+    world: projectWorldSummary(worldService, worldId),
+  };
+}
+
 export function createChatRequestService({
   store = null,
   relay = null,
@@ -349,8 +437,27 @@ export function createChatRequestService({
     };
   }
 
+  function projectChatInboxChat(conversation = {}, viewerAgentId = null, request = null) {
+    const direction = resolveInboxChatDirection(viewerAgentId, request);
+    const counterpartyAgentId = resolveInboxChatCounterpartyAgentId(viewerAgentId, request, conversation);
+
+    return {
+      chatRequestId: normalizeText(request?.chatRequestId || request?.requestId, null),
+      status: resolveInboxChatStatus(conversation, request),
+      ...(direction ? { direction } : {}),
+      createdAt: normalizeText(conversation.createdAt, normalizeText(request?.createdAt, null)),
+      updatedAt: normalizeText(conversation.updatedAt, null),
+      lastTurnAt: normalizeText(conversation.lastTurnAt, null),
+      conversationKey: normalizeText(conversation.conversationKey, null),
+      localSessionKey: normalizeText(conversation.sessionKey, null),
+      counterparty: projectAgent(assertStore(), counterpartyAgentId, presence),
+      conversation: resolveInboxConversationWorldSummary(worldService, request, conversation),
+    };
+  }
+
   return {
     projectChatRequest,
+    projectChatInboxChat,
     async syncApprovalPolicy({
       actorAgentId,
       credentialId = null,
@@ -388,6 +495,7 @@ export function createChatRequestService({
       openingMessage = null,
       openingPayload = null,
       worldId = null,
+      requestContext = null,
       origin = null,
       broadcast = null,
       source = 'chat_request',
@@ -398,29 +506,36 @@ export function createChatRequestService({
         throw createInvalidChatRequestError('chat_request_target_required', 'chat request target requires targetAgentId');
       }
       const targetAgent = requireAgent(normalizedTargetAgentId);
-      const normalizedWorldId = normalizeConversationWorldId(worldId);
+      const normalizedSource = normalizeText(source, 'chat_request');
+      const normalizedRequestInput = normalizeChatRequestInput({
+        requestContext,
+        source: normalizedSource,
+      });
+      const normalizedWorldId = normalizeConversationWorldId(worldId)
+        || normalizeConversationWorldId(normalizedRequestInput.conversation?.worldId);
       if (!targetAgent?.address) {
         throw createTargetAddressNotFoundError(normalizedTargetAgentId);
       }
-      const normalizedOpeningPayload = cloneJsonObject(openingPayload);
+      const normalizedOpeningPayload = cloneJsonObject(openingPayload) || cloneJsonObject(normalizedRequestInput.openingPayload);
       const normalizedKickoffBrief = createKickoffBrief({
         text: typeof kickoffBrief === 'object' && kickoffBrief !== null && !Array.isArray(kickoffBrief)
           ? kickoffBrief.text
-          : openingMessage,
+          : normalizeText(openingMessage, normalizeText(normalizedRequestInput.openingMessage, null)),
         payload: typeof kickoffBrief === 'object' && kickoffBrief !== null && !Array.isArray(kickoffBrief)
           ? kickoffBrief.payload
           : normalizedOpeningPayload,
         source: typeof kickoffBrief === 'object' && kickoffBrief !== null && !Array.isArray(kickoffBrief)
           ? kickoffBrief.source
-          : source === 'world_broadcast'
+          : normalizedSource === 'world_broadcast'
             ? 'world_broadcast_brief'
             : 'chat_request_brief',
       });
-      const normalizedOrigin = normalizeChatRequestOrigin(origin);
-      const normalizedBroadcast = normalizeChatRequestBroadcastMetadata(broadcast);
+      const normalizedOrigin = normalizeChatRequestOrigin(origin) || normalizeChatRequestOrigin(normalizedRequestInput.origin);
+      const normalizedBroadcast = normalizeChatRequestBroadcastMetadata(broadcast)
+        || normalizeChatRequestBroadcastMetadata(normalizedRequestInput.broadcast);
       if (normalizedWorldId) {
         worldService?.requireWorld?.(normalizedWorldId);
-        if (normalizeText(source, 'chat_request') !== 'world_broadcast') {
+        if (normalizedSource !== 'world_broadcast') {
           const authorization = worldAuthorizationService.evaluateWorldAction({
             worldId: normalizedWorldId,
             actorAgentId: fromAgentId,
@@ -444,9 +559,10 @@ export function createChatRequestService({
         conversation: {
           ...(normalizedWorldId ? { worldId: normalizedWorldId } : {}),
         },
+        requestContext: cloneJsonObject(requestContext),
         origin: normalizedOrigin,
         broadcast: normalizedBroadcast,
-        source: normalizeText(source, 'chat_request'),
+        source: normalizedSource,
       });
       if (result.status < 200 || result.status >= 300) {
         throw createRelayResponseError(result, 'chat_request_create_failed');
@@ -494,23 +610,55 @@ export function createChatRequestService({
       };
     },
 
-    listChatRequests({ agentId, direction = null } = {}) {
+    listChatInbox({ agentId, direction = null } = {}) {
       requireAgent(agentId);
       const normalizedDirection = normalizeDirection(direction);
-      let items = assertStore().listChatRequests ? assertStore().listChatRequests() : [];
-      items = items.filter((request) => request.status === 'pending');
-      items = items.filter((request) => request.fromAgentId === agentId || request.toAgentId === agentId);
+      let requests = assertStore().listChatRequests ? assertStore().listChatRequests() : [];
+      requests = requests.filter((request) => request.fromAgentId === agentId || request.toAgentId === agentId);
       if (normalizedDirection === 'inbound') {
-        items = items.filter((request) => request.toAgentId === agentId);
+        requests = requests.filter((request) => request.toAgentId === agentId);
       } else if (normalizedDirection === 'outbound') {
-        items = items.filter((request) => request.fromAgentId === agentId);
+        requests = requests.filter((request) => request.fromAgentId === agentId);
       }
 
+      const pendingRequests = sortByRecency(
+        requests.filter((request) => request.status === 'pending'),
+        'createdAt',
+      ).map((request) => projectChatRequest(request, agentId));
+
+      const conversations = assertStore().listConversations
+        ? assertStore().listConversations({ participantId: agentId })
+        : [];
+      const chats = sortByRecency(
+        conversations
+          .map((conversation) => {
+            const linkedRequest = resolveConversationLinkRequest(requests, conversation);
+            if (!linkedRequest && !normalizeText(conversation?.meta?.approvalRequestId, null)) return null;
+            const projected = projectChatInboxChat(conversation, agentId, linkedRequest);
+            if (!projected) return null;
+            if (normalizedDirection && projected.direction !== normalizedDirection) return null;
+            return projected;
+          })
+          .filter(Boolean),
+        'lastTurnAt',
+        'updatedAt',
+        'createdAt',
+      );
+
       return {
-        items: sortByRecency(items, 'createdAt').map((request) => projectChatRequest(request, agentId)),
+        counts: {
+          pendingRequestCount: pendingRequests.length,
+          chatCount: chats.length,
+        },
+        pendingRequests,
+        chats,
       };
     },
 
+    listChatRequests({ agentId, direction = null } = {}) {
+      return this.listChatInbox({ agentId, direction });
+    },
+
     async acceptChatRequest(chatRequestId, { actorAgentId } = {}) {
       requireAgent(actorAgentId);
       const normalizedChatRequestId = normalizeText(chatRequestId, null);