@xfxstudio/claworld 0.1.4 → 0.1.5

package/src/openclaw/plugin/managed-config.js

@@ -107,12 +107,21 @@ function findManagedAccountEntry(config = {}, accountId) {
   return {};
 }
 
+const MANAGED_LEGACY_BUNDLED_SKILL_NAMES = Object.freeze([
+  'claworld-join-and-chat',
+  'claworld-manage-worlds',
+  'claworld-help',
+]);
+
+function hasOnlyManagedBundledSkills(value) {
+  if (!Array.isArray(value) || value.length === 0) return false;
+  return value.every((skillName) => MANAGED_LEGACY_BUNDLED_SKILL_NAMES.includes(skillName));
+}
+
 function buildManagedAgentEntry(options = {}) {
-  const managedSkills = resolveManagedAgentSkills({ toolProfile: options.toolProfile });
   return {
     id: options.agentId,
     workspace: options.workspace,
-    ...(managedSkills === undefined ? {} : { skills: managedSkills }),
     ...(options.agentDirExplicit && options.agentDir ? { agentDir: options.agentDir } : {}),
   };
 }
@@ -123,7 +132,6 @@ function buildManagedAccountEntry(options = {}) {
     serverUrl: options.serverUrl,
     apiKey: options.apiKey,
     accountId: options.accountId,
-    toolProfile: options.toolProfile,
     name: normalizeText(options.name, normalizeText(options.displayName, null)),
     approval: {
       mode: normalizeChatRequestApprovalMode(options.approvalMode, DEFAULT_CLAWORLD_APPROVAL_MODE),
@@ -162,7 +170,6 @@ function buildMergedAccountEntry(existingAccount = {}, options = {}) {
     serverUrl: options.serverUrl,
     apiKey: options.apiKey,
     accountId: options.accountId,
-    toolProfile: options.toolProfile,
     name: normalizeText(options.name, normalizeText(existingAccount.name, normalizeText(options.displayName, null))),
     approval: {
       ...existingApproval,
@@ -179,6 +186,7 @@ function buildMergedAccountEntry(existingAccount = {}, options = {}) {
         ? { relay: existingRelay }
         : {}),
   };
+  delete merged.toolProfile;
 
   if (options.appToken) {
     return {
@@ -421,10 +429,6 @@ export function resolveClaworldManagedRuntimeOptions({
     normalizeText(input.name, resolveDefaultManagedDisplayName(resolvedAccountId)),
   );
   const name = normalizeText(overrides.name, displayName);
-  const explicitToolProfile = normalizeText(
-    overrides.toolProfile,
-    normalizeText(input.toolProfile, null),
-  );
   const existingRegistrationAgentCode = normalizeRegistrationAgentCode(
     existingAccount?.registration?.agentCode,
     normalizeRegistrationAgentCode(existingAccount?.localAgent?.agentCode, null),
@@ -461,11 +465,6 @@ export function resolveClaworldManagedRuntimeOptions({
     displayName,
     name,
     defaultToAddress: normalizeText(overrides.defaultToAddress, null),
-    toolProfile: resolveManagedToolProfile({
-      cfg,
-      existingAccount,
-      explicitToolProfile,
-    }),
     approvalMode,
     sessionDmScope: normalizeText(
       overrides.sessionDmScope,
@@ -481,8 +480,6 @@ export function resolveClaworldManagedRuntimeOptions({
 
 export function applyClaworldManagedRuntimeConfig(inputConfig = {}, options = {}) {
   const config = JSON.parse(JSON.stringify(ensureObject(inputConfig)));
-  const toolProfile = normalizeClaworldToolProfile(options.toolProfile);
-  const toolNames = resolveToolNames({ toolProfile });
   const summary = [];
   const replaceManagedRuntime = options.replaceManagedRuntime !== false;
   const preserveDefaultAccount = options.preserveDefaultAccount === true;
@@ -492,21 +489,28 @@ export function applyClaworldManagedRuntimeConfig(inputConfig = {}, options = {}
     throw new Error('claworld registration agentCode is required when appToken is absent');
   }
 
-  config.tools = ensureObject(config.tools);
   const removedManagedToolNames = new Set([
+    ...CLAWORLD_PUBLIC_TOOL_NAMES,
     ...CLAWORLD_COMPATIBILITY_TOOL_NAMES,
     ...CLAWORLD_RETIRED_PUBLIC_TOOL_NAMES,
   ]);
-  const existingAllow = asStringArray(config.tools.allow);
-  const removedHelperTools = existingAllow.filter((toolName) => removedManagedToolNames.has(toolName));
-  config.tools.allow = uniqueStrings([
-    ...existingAllow.filter((toolName) => !removedManagedToolNames.has(toolName)),
-    ...toolNames,
-  ]);
-  if (removedHelperTools.length > 0) {
-    summary.push(`tools.allow removed optional helper entries (${removedHelperTools.join(',')})`);
+  if (inputConfig?.tools && typeof inputConfig.tools === 'object') {
+    config.tools = ensureObject(config.tools);
+    const existingAllow = asStringArray(config.tools.allow);
+    const filteredAllow = existingAllow.filter((toolName) => !removedManagedToolNames.has(toolName));
+    const removedManagedTools = existingAllow.filter((toolName) => removedManagedToolNames.has(toolName));
+    if (removedManagedTools.length > 0) {
+      if (filteredAllow.length > 0) {
+        config.tools.allow = uniqueStrings(filteredAllow);
+      } else {
+        delete config.tools.allow;
+      }
+      summary.push(`tools.allow removed managed claworld entries (${removedManagedTools.join(',')})`);
+    }
+    if (Object.keys(config.tools).length === 0) {
+      delete config.tools;
+    }
   }
-  summary.push(`tools.allow updated for ${toolProfile} profile (${describeToolAllowEntries(toolNames)})`);
 
   config.session = ensureObject(config.session);
   if (!Object.prototype.hasOwnProperty.call(config.session, 'dmScope')) {
@@ -533,7 +537,6 @@ export function applyClaworldManagedRuntimeConfig(inputConfig = {}, options = {}
     if (agentIndex >= 0) {
       const existingAgent = ensureObject(existingAgentList[agentIndex]);
       const existingAgentDir = normalizeText(existingAgent.agentDir, null);
-      const managedSkills = resolveManagedAgentSkills({ toolProfile: options.toolProfile });
       const keepExistingAgentDir = Boolean(
         existingAgentDir
         && (
@@ -546,12 +549,11 @@ export function applyClaworldManagedRuntimeConfig(inputConfig = {}, options = {}
         id: options.agentId,
         workspace: normalizeText(existingAgent.workspace, options.workspace),
         ...(keepExistingAgentDir ? { agentDir: existingAgentDir } : {}),
-        ...(managedSkills === undefined ? {} : { skills: managedSkills }),
       };
       if (!keepExistingAgentDir) {
         delete nextAgentEntry.agentDir;
       }
-      if (managedSkills === undefined) {
+      if (hasOnlyManagedBundledSkills(existingAgent.skills)) {
         delete nextAgentEntry.skills;
       }
       existingAgentList[agentIndex] = nextAgentEntry;
@@ -619,7 +621,6 @@ export function applyClaworldManagedRuntimeConfig(inputConfig = {}, options = {}
 
   return {
     config,
-    toolNames,
     summary,
     canonicalAgentCode: canonicalRelayAgentCode(
       options.registrationAgentCode,

package/src/openclaw/plugin/register.js

@@ -401,13 +401,13 @@ function buildRegisteredTools(api, plugin) {
     {
       name: 'claworld_join_world',
       label: 'Claworld Join World',
-      description: 'Canonical world-entry tool. Retry this same tool with profileDraft plus profileUpdate until the backend stops returning needs_profile; on success it returns candidate-review and request_chat follow-up payloads.',
+      description: 'Canonical world-entry tool. Retry this same tool with profileDraft plus profileUpdate until the backend stops returning needs_profile; on success it returns online candidate-review and request_chat follow-up payloads.',
       metadata: buildToolMetadata({
         category: 'world_join',
         usageNotes: [
           'This is the only public join entrypoint for the default flow.',
           'When status is needs_profile, merge the user reply into profileDraft and retry this same tool.',
-          'When status is joined, use candidateDelivery/requestChatAction and move to claworld_request_chat.',
+          'When status is joined, read candidateFeed/candidateDelivery online state, then use requestChatAction and move to claworld_request_chat.',
         ],
         examples: [
           {
@@ -435,7 +435,7 @@ function buildRegisteredTools(api, plugin) {
                 interests: ['running', 'climbing'],
               },
             },
-            outcome: 'Returns joined plus candidateDelivery and requestChatAction.',
+            outcome: 'Returns joined plus online candidateDelivery and requestChatAction.',
           },
         ],
       }),
@@ -1195,7 +1195,7 @@ export function registerClaworldPluginFull(api, plugin) {
   }
   if (typeof api.registerTool === 'function') {
     for (const tool of buildRegisteredTools(api, plugin)) {
-      api.registerTool(tool, { optional: true });
+      api.registerTool(tool);
     }
   }
   return plugin;

package/src/openclaw/plugin/relay-client.js

@@ -517,7 +517,7 @@ export class ClaworldRelayClient extends EventEmitter {
     config,
     agentId,
     credential = null,
-    clientVersion = 'claworld-plugin/0.1.4',
+    clientVersion = 'claworld-plugin/0.1.5',
     sessionTarget,
     fallbackTarget,
   } = {}) {

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

@@ -422,6 +422,7 @@ function normalizeCandidate(candidate = {}, index = 0) {
     worldId: normalizeText(candidate.worldId, 'unknown-world'),
     targetAgentId: normalizeText(candidate.targetAgentId, null),
     sourceMembershipId: normalizeText(candidate.sourceMembershipId, null),
+    online: candidate.online === true,
     targetAgentId,
     requestChat,
     profileSummary: normalizeCandidateProfileSummary(candidate.profileSummary),
@@ -457,7 +458,7 @@ function normalizeCandidateFeedResponse(payload = {}, { worldId = null, agentId
     candidateDelivery: payload.candidateDelivery && typeof payload.candidateDelivery === 'object'
       ? payload.candidateDelivery
       : null,
-    candidateSource: normalizeText(payload.candidateSource, 'active_memberships'),
+    candidateSource: normalizeText(payload.candidateSource, 'active_memberships_online'),
     candidateModel: payload.candidateModel && typeof payload.candidateModel === 'object' ? payload.candidateModel : {},
     strategy: payload.strategy && typeof payload.strategy === 'object' ? payload.strategy : {},
     limit: normalizeInteger(payload.limit, candidates.length),

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

@@ -230,6 +230,7 @@ function projectToolCandidateDeliverySummary(
       sourceMembershipId: normalizeText(summary.sourceMembershipId, null),
       displayName: normalizeText(summary.displayName, null),
       headline: normalizeText(summary.headline, null),
+      online: summary.online === true,
       rank: normalizeOptionalInteger(summary.rank, null),
       score: normalizeOptionalInteger(summary.score, null),
       targetAgentId: normalizeText(summary.targetAgentId, summary.requestChat?.targetAgentId || null),
@@ -383,6 +384,7 @@ function projectToolCandidateSummary(summary = {}, index = 0) {
     targetAgentId: normalizeText(summary.targetAgentId, null),
     displayName: normalizeText(summary.displayName, `Candidate ${index + 1}`),
     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),
@@ -405,6 +407,7 @@ function projectToolCandidateFeed(joinResult = {}) {
         targetAgentId: candidate.targetAgentId,
         displayName: candidate.profileSummary?.displayName,
         headline: candidate.profileSummary?.headline,
+        online: candidate.online === true,
         rank: candidate.rank,
         score: candidate.score,
         summary: normalizeText(candidate.deliveryReason?.summary, null),

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

@@ -83,8 +83,8 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
       mode: 'scored_push',
       cadence: 'periodic',
       strategySummary:
-        'Score active memberships by intent, location, and interests, deliver candidate summaries first, and route live contact through request_chat after review.',
-      candidateSources: ['active_memberships'],
+        'Score active online memberships by intent, location, and interests, deliver candidate summaries first, and route live contact through request_chat after review.',
+      candidateSources: ['active_memberships_online'],
     },
     sessionTemplate: {
       mode: 'a2a',
@@ -179,8 +179,8 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
       mode: 'intent_filter',
       cadence: 'on_demand',
       strategySummary:
-        'Filter by capability overlap, deliver candidate summaries first, and let members request_chat before negotiating fit in a short session.',
-      candidateSources: ['world_members'],
+        'Filter active online world members by capability overlap, deliver candidate summaries first, and let members request_chat before negotiating fit in a short session.',
+      candidateSources: ['active_memberships_online'],
     },
     sessionTemplate: {
       mode: 'a2a',
@@ -273,8 +273,8 @@ export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
       mode: 'profile_overlap',
       cadence: 'periodic',
       strategySummary:
-        'Use target role, experience summary, and location/work mode as the first-pass scoring surface, deliver candidate summaries, and route contact through request_chat after review.',
-      candidateSources: ['world_members', 'search_results'],
+        'Use active online memberships plus target role, experience summary, and location/work mode as the first-pass scoring surface, deliver candidate summaries, and route contact through request_chat after review.',
+      candidateSources: ['active_memberships_online'],
     },
     sessionTemplate: {
       mode: 'a2a',

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

@@ -7,6 +7,7 @@ export const CANDIDATE_OBJECT_FIELDS = Object.freeze([
   'worldId',
   'targetAgentId',
   'sourceMembershipId',
+  'online',
   'requestChat',
   'profileSummary',
   'compatibilitySignals',
@@ -180,7 +181,7 @@ function buildCompatibilitySignals(world, viewerProfile = {}, candidateProfile =
       type: 'world_ready',
       fieldIds: [],
       score: 0.05,
-      summary: 'Candidate has an active world membership and is ready for agent review before live session handoff.',
+      summary: 'Candidate is online with an active world membership and is ready for agent review before live session handoff.',
     }),
   ];
 }
@@ -192,7 +193,7 @@ function buildDeliveryReason(signals = []) {
     return {
       code: 'world_membership_ready',
       matchedFieldIds: [],
-      summary: 'Delivered for manual review because the candidate is active in this world, even though no direct profile overlap signal was detected yet.',
+      summary: 'Delivered for manual review because the candidate is online and active in this world, even though no direct profile overlap signal was detected yet.',
     };
   }
 
@@ -264,7 +265,7 @@ export function projectCandidateFeedModel(world) {
     },
     liveDeliveryEvent: projectLiveDeliveryEvent(world, candidateFields),
     summary:
-      'Active members can review candidate opportunities first, then call request_chat with the selected targetAgentId when they want to start a world-scoped conversation request.',
+      'Active online members can review candidate opportunities first, then call request_chat with the selected targetAgentId when they want to start a world-scoped conversation request.',
     status: 'phase1_candidate_feed',
   };
 }
@@ -274,6 +275,7 @@ function projectCandidateOpportunity({
   viewerProfile,
   candidateMembership,
   candidateAgent,
+  candidatePresence,
   expiresAt,
 }) {
   const profileSnapshot = candidateMembership.profileSnapshot || {};
@@ -290,6 +292,7 @@ function projectCandidateOpportunity({
     worldId: world.worldId,
     sourceMembershipId: candidateMembership.membershipId,
     targetAgentId: requestChat?.targetAgentId || null,
+    online: candidatePresence?.online === true,
     requestChat,
     profileSummary: projectProfileSummary(world, profileSnapshot, candidateAgent),
     compatibilitySignals,
@@ -304,6 +307,7 @@ export function buildCandidateFeed({
   viewerAgent = null,
   candidateMemberships = [],
   getAgent = () => null,
+  getPresence = () => ({ online: true }),
   nowMs = Date.now(),
   limit = DEFAULT_CANDIDATE_FEED_LIMIT,
 }) {
@@ -315,12 +319,18 @@ export function buildCandidateFeed({
 
   const candidates = candidateMemberships
     .filter((membership) => membership?.status === 'active' && membership.membershipId !== viewerMembership.membershipId)
-    .map((membership) => {
+    .map((membership) => ({
+      membership,
+      candidatePresence: getPresence(membership.agentId),
+    }))
+    .filter(({ candidatePresence }) => candidatePresence?.online === true)
+    .map(({ membership, candidatePresence }) => {
       const opportunity = projectCandidateOpportunity({
         world,
         viewerProfile,
         candidateMembership: membership,
         candidateAgent: getAgent(membership.agentId),
+        candidatePresence,
         expiresAt,
       });
 

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

@@ -12,6 +12,24 @@ function normalizeStringList(values = []) {
   return [...new Set(values.map((value) => normalizeText(value, null)).filter(Boolean))];
 }
 
+function normalizeCandidateSource(value) {
+  const normalized = normalizeText(value, null);
+  if (!normalized) return null;
+  if (
+    normalized === 'active_memberships'
+    || normalized === 'world_members'
+    || normalized === 'search_results'
+  ) {
+    return 'active_memberships_online';
+  }
+  return normalized;
+}
+
+function normalizeCandidateSources(values = []) {
+  if (!Array.isArray(values)) return [];
+  return [...new Set(values.map((value) => normalizeCandidateSource(value)).filter(Boolean))];
+}
+
 function normalizeWorldEligibility(value, fallback = 'active') {
   const normalized = normalizeText(value, fallback);
   if (normalized === 'joined') return 'joined';
@@ -188,7 +206,7 @@ export function normalizeWorldManifest(manifest = {}, index = 0) {
       mode: normalizeText(manifest.matching?.mode, 'manual_review'),
       cadence: normalizeText(manifest.matching?.cadence, 'on_demand'),
       strategySummary: normalizeText(manifest.matching?.strategySummary, null),
-      candidateSources: normalizeStringList(manifest.matching?.candidateSources),
+      candidateSources: normalizeCandidateSources(manifest.matching?.candidateSources),
     },
     sessionTemplate: {
       mode: normalizeText(manifest.sessionTemplate?.mode, 'a2a'),

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

@@ -388,6 +388,7 @@ function normalizeCandidate(candidate = {}, index = 0) {
     candidateId: normalizeText(candidate.candidateId, `candidate_${index + 1}`),
     worldId: normalizeText(candidate.worldId, 'unknown-world'),
     sourceMembershipId: normalizeText(candidate.sourceMembershipId, null),
+    online: candidate.online === true,
     targetAgentId,
     requestChat,
     profileSummary: normalizeCandidateProfileSummary(candidate.profileSummary),
@@ -420,7 +421,7 @@ function normalizeCandidateFeedResponse(payload = {}, { worldId = null, agentId
       payload.nextAction,
       candidates.length > 0 ? 'review_candidates_then_request_chat' : 'wait_for_more_candidates',
     ),
-    candidateSource: normalizeText(payload.candidateSource, 'active_memberships'),
+    candidateSource: normalizeText(payload.candidateSource, 'active_memberships_online'),
     candidateModel: payload.candidateModel && typeof payload.candidateModel === 'object' ? payload.candidateModel : {},
     strategy: payload.strategy && typeof payload.strategy === 'object' ? payload.strategy : {},
     limit: normalizeInteger(payload.limit, candidates.length),
@@ -949,6 +950,7 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
       .map((signal) => sentenceCase(signal.summary, ''))
       .filter(Boolean);
     const deliveryReasonSummary = sentenceCase(candidate.deliveryReason.summary, '');
+    const availabilitySummary = candidate.online === true ? 'Online now.' : 'Currently offline.';
     const scoreSummary = candidate.score == null
       ? null
       : `Score ${candidate.score}${candidate.rank == null ? '' : `, rank ${candidate.rank}`}.`;
@@ -958,12 +960,14 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
       optionalFieldSummary.length > 0 ? `Optional context: ${optionalFieldSummary.join('; ')}.` : null,
       compatibilitySummary.length > 0 ? compatibilitySummary.join(' ') : null,
       deliveryReasonSummary || null,
+      availabilitySummary,
       scoreSummary,
     ].filter(Boolean).join(' ');
 
     return {
       candidateId: candidate.candidateId,
       sourceMembershipId: candidate.sourceMembershipId,
+      online: candidate.online === true,
       targetAgentId: candidate.targetAgentId,
       requestChat: candidate.requestChat,
       displayName: name,
@@ -982,11 +986,11 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
   const totalCandidateCount = Math.max(normalizedFeed.totalCandidates, deliveredCandidateCount);
   const remainingCandidateCount = Math.max(totalCandidateCount - deliveredCandidateCount, 0);
   const heading = deliveredCandidateCount > 0
-    ? `${displayName} has ${deliveredCandidateCount} candidate profile ${deliveredCandidateCount === 1 ? 'summary' : 'summaries'} ready for review now.`
-    : `No candidate profile summaries are ready for review in ${displayName} yet.`;
+    ? `${displayName} has ${deliveredCandidateCount} online candidate profile ${deliveredCandidateCount === 1 ? 'summary' : 'summaries'} ready for review now.`
+    : `No online candidate profile summaries are ready for review in ${displayName} yet.`;
   const promptBody = deliveredCandidateCount > 0
     ? candidateSummaries.map((summary, index) => buildCandidateDeliverySummaryLine(summary, index)).join('\n\n')
-    : 'No candidates are currently available from the active-membership feed.';
+    : 'No online candidates are currently available from the active-membership feed.';
 
   return {
     worldId: normalizedFeed.worldId,

package/src/product-shell/index.js

@@ -33,7 +33,7 @@ export function createClaworldProductShell({
     worldService,
     membershipService,
   });
-  const matchmakingService = createMatchmakingService({ worldService, worldAuthorizationService, store });
+  const matchmakingService = createMatchmakingService({ worldService, worldAuthorizationService, store, presence });
   const searchService = createWorldSearchService({ worldService, worldAuthorizationService, store, presence });
   const worldAdminService = createWorldAdminService({ worldService, worldAuthorizationService, store });
   const chatRequestService = createChatRequestService({

package/src/product-shell/matching/matchmaking-service.js

@@ -217,7 +217,14 @@ function buildViewerContext({ world, membershipStore, normalizedAgentId, worldAu
   };
 }
 
-function buildBaseFeed({ world, membershipStore, normalizedAgentId, limit, worldAuthorizationService }) {
+function buildBaseFeed({
+  world,
+  membershipStore,
+  normalizedAgentId,
+  limit,
+  worldAuthorizationService,
+  resolvePresence,
+}) {
   const { viewerAgent, viewerMembership } = buildViewerContext({
     world,
     membershipStore,
@@ -236,6 +243,7 @@ function buildBaseFeed({ world, membershipStore, normalizedAgentId, limit, world
     viewerAgent,
     candidateMemberships: activeMemberships,
     getAgent: (candidateAgentId) => membershipStore.getAgent(candidateAgentId),
+    getPresence: (candidateAgentId) => resolvePresence(candidateAgentId),
     nowMs,
     limit: activeMemberships.length,
   });
@@ -248,13 +256,21 @@ function buildBaseFeed({ world, membershipStore, normalizedAgentId, limit, world
   };
 }
 
-function buildDatingDemoFeed({ world, membershipStore, normalizedAgentId, limit, worldAuthorizationService }) {
+function buildDatingDemoFeed({
+  world,
+  membershipStore,
+  normalizedAgentId,
+  limit,
+  worldAuthorizationService,
+  resolvePresence,
+}) {
   const { viewerMembership, activeMemberships, normalizedLimit, baseFeed } = buildBaseFeed({
     world,
     membershipStore,
     normalizedAgentId,
     limit,
     worldAuthorizationService,
+    resolvePresence,
   });
   const membershipById = new Map(activeMemberships.map((membership) => [membership.membershipId, membership]));
   const rankedCandidates = baseFeed.candidates
@@ -278,19 +294,35 @@ function buildDatingDemoFeed({ world, membershipStore, normalizedAgentId, limit,
     ...baseFeed,
     agentId: normalizedAgentId,
     limit: normalizedLimit,
-    candidateSource: 'active_memberships',
+    candidateSource: 'active_memberships_online',
     strategy: buildStrategy(world),
     totalCandidates: rankedCandidates.length,
     candidates,
   };
 }
 
-export function createMatchmakingService({ worldService, worldAuthorizationService, store = null } = {}) {
+export function createMatchmakingService({
+  worldService,
+  worldAuthorizationService,
+  store = null,
+  presence = null,
+} = {}) {
   function assertStore() {
     if (!store) throw createConfigurationError();
     return store;
   }
 
+  function resolvePresence(agentId) {
+    if (!presence) {
+      return {
+        online: true,
+        connectedAt: null,
+        lastHeartbeatAt: null,
+      };
+    }
+    return presence.getPresence(agentId);
+  }
+
   return {
     describeStrategy(worldId) {
       const world = worldService.requireWorld(worldId);
@@ -312,6 +344,7 @@ export function createMatchmakingService({ worldService, worldAuthorizationServi
           normalizedAgentId,
           limit,
           worldAuthorizationService,
+          resolvePresence,
         });
       }
 
@@ -321,13 +354,14 @@ export function createMatchmakingService({ worldService, worldAuthorizationServi
         normalizedAgentId,
         limit,
         worldAuthorizationService,
+        resolvePresence,
       });
 
       return {
         ...baseFeed,
         agentId: normalizedAgentId,
         limit: normalizedLimit,
-        candidateSource: 'active_memberships',
+        candidateSource: 'active_memberships_online',
         strategy: buildStrategy(world),
         totalCandidates: baseFeed.candidates.length,
         candidates: baseFeed.candidates.slice(0, normalizedLimit),

package/src/product-shell/worlds/world-admin-service.js

@@ -239,8 +239,8 @@ function buildMatchingStrategy(entryProfileSchema) {
     mode: 'profile_overlap',
     cadence: 'on_demand',
     strategySummary:
-      `Rank world members by overlap on ${entryProfileSchema.searchableFieldIds.join(', ')}, deliver candidate summaries first, and let members request_chat after review.`,
-    candidateSources: ['active_memberships'],
+      `Rank active online world members by overlap on ${entryProfileSchema.searchableFieldIds.join(', ')}, deliver candidate summaries first, and let members request_chat after review.`,
+    candidateSources: ['active_memberships_online'],
   };
 }