@xfxstudio/claworld 0.2.13 → 0.2.14

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

@@ -1,393 +0,0 @@
-const DEFAULT_CANDIDATE_FEED_TTL_MS = 6 * 60 * 60 * 1000;
-const MAX_CANDIDATE_FEED_LIMIT = 25;
-const DEFAULT_CANDIDATE_FEED_LIMIT = 10;
-
-export const CANDIDATE_OBJECT_FIELDS = Object.freeze([
-  'candidateId',
-  'worldId',
-  'targetAgentId',
-  'sourceMembershipId',
-  'online',
-  'requestChat',
-  'profileSummary',
-  'compatibilitySignals',
-  'deliveryReason',
-  'worldFeedbackSummary',
-  'expiresAt',
-]);
-
-export const WORLD_FEEDBACK_SUMMARY_FIELDS = Object.freeze([
-  'likesReceived',
-  'dislikesReceived',
-]);
-
-export const DATING_DEMO_SCORING_FIELDS = Object.freeze([
-  'joinedAt',
-  'rank',
-  'score',
-  'scoreBreakdown',
-  'scoringInputs',
-]);
-
-export const PROFILE_SUMMARY_FIELDS = Object.freeze([
-  'displayName',
-  'headline',
-  'requiredFields',
-  'optionalFields',
-]);
-
-export const PROFILE_SUMMARY_FIELD_FIELDS = Object.freeze([
-  'fieldId',
-  'label',
-  'value',
-]);
-
-export const COMPATIBILITY_SIGNAL_FIELDS = Object.freeze([
-  'signalId',
-  'type',
-  'fieldIds',
-  'score',
-  'summary',
-]);
-
-export const DELIVERY_REASON_FIELDS = Object.freeze([
-  'code',
-  'matchedFieldIds',
-  'summary',
-]);
-
-export const LIVE_DELIVERY_EVENT_ENVELOPE_FIELDS = Object.freeze([
-  'event',
-  'data',
-]);
-
-export const LIVE_DELIVERY_EVENT_PAYLOAD_FIELDS = Object.freeze([
-  'deliveryId',
-  'worldId',
-  'agentId',
-  'viewerMembershipId',
-  'deliveredAt',
-  'candidate',
-]);
-
-function normalizeText(value, fallback = null) {
-  if (value == null) return fallback;
-  const normalized = String(value).trim();
-  return normalized || fallback;
-}
-
-function normalizeValue(value, field = {}) {
-  if (value == null) return null;
-
-  if (field.type === 'string[]') {
-    if (!Array.isArray(value)) return [];
-    return [...new Set(value.map((entry) => normalizeText(entry, null)).filter(Boolean))];
-  }
-
-  const normalized = normalizeText(value, null);
-  return normalized;
-}
-
-function buildRequestChatPayload(world, candidateMembership) {
-  const targetAgentId = normalizeText(candidateMembership?.agentId, null);
-  if (!targetAgentId) return null;
-
-  return {
-    worldId: world.worldId,
-    targetAgentId,
-  };
-}
-
-function normalizeComparableArray(value) {
-  if (!Array.isArray(value)) return [];
-  return [...new Set(value.map((entry) => normalizeText(entry, null)?.toLowerCase()).filter(Boolean))];
-}
-
-function normalizeComparableText(value) {
-  return normalizeText(value, null)?.toLowerCase() || null;
-}
-
-function tokenizeText(value) {
-  return [...new Set(
-    String(value || '')
-      .toLowerCase()
-      .split(/[^a-z0-9\u4e00-\u9fff]+/i)
-      .map((entry) => entry.trim())
-      .filter((entry) => entry.length >= 2),
-  )];
-}
-
-function projectSummaryField(field = {}, profile = {}) {
-  const normalizedValue = normalizeValue(profile[field.fieldId], field);
-  if (normalizedValue == null) return null;
-  if (Array.isArray(normalizedValue) && normalizedValue.length === 0) return null;
-
-  return {
-    fieldId: field.fieldId,
-    label: field.label,
-    value: normalizedValue,
-  };
-}
-
-function projectProfileSummary(world, profile = {}, agent = null) {
-  return {
-    displayName: normalizeText(agent?.displayName, null),
-    headline: normalizeText(profile.participantContextText, normalizeText(profile.headline, null)),
-    requiredFields: world.joinSchema.requiredFields
-      .map((field) => projectSummaryField(field, profile))
-      .filter(Boolean),
-    optionalFields: world.joinSchema.optionalFields
-      .map((field) => projectSummaryField(field, profile))
-      .filter(Boolean),
-  };
-}
-
-function createCompatibilitySignal({ sourceMembershipId, type, fieldIds, score, summary }) {
-  return {
-    signalId: `${sourceMembershipId}:${type}:${fieldIds.join('+') || 'world'}`,
-    type,
-    fieldIds,
-    score,
-    summary,
-  };
-}
-
-function compareFieldValues(field, viewerValue, candidateValue, sourceMembershipId) {
-  if (field.fieldId === 'participantContextText') {
-    const viewerTokens = tokenizeText(viewerValue);
-    const candidateTokens = tokenizeText(candidateValue);
-    const sharedItems = viewerTokens.filter((item) => candidateTokens.includes(item));
-    if (sharedItems.length === 0) return null;
-
-    return createCompatibilitySignal({
-      sourceMembershipId,
-      type: 'field_overlap',
-      fieldIds: [field.fieldId],
-      score: Math.min(sharedItems.length * 0.08, 0.48),
-      summary: `Shared context: ${sharedItems.slice(0, 6).join(', ')}.`,
-    });
-  }
-
-  if (field.type === 'string[]') {
-    const viewerItems = normalizeComparableArray(viewerValue);
-    const candidateItems = normalizeComparableArray(candidateValue);
-    const sharedItems = viewerItems.filter((item) => candidateItems.includes(item));
-    if (sharedItems.length === 0) return null;
-
-    return createCompatibilitySignal({
-      sourceMembershipId,
-      type: 'field_overlap',
-      fieldIds: [field.fieldId],
-      score: field.required ? 0.25 : 0.15,
-      summary: `Shared ${field.label}: ${sharedItems.slice(0, 3).join(', ')}.`,
-    });
-  }
-
-  const normalizedViewerValue = normalizeComparableText(viewerValue);
-  const normalizedCandidateValue = normalizeComparableText(candidateValue);
-  if (!normalizedViewerValue || !normalizedCandidateValue) return null;
-  if (normalizedViewerValue !== normalizedCandidateValue) return null;
-
-  return createCompatibilitySignal({
-    sourceMembershipId,
-    type: 'field_alignment',
-    fieldIds: [field.fieldId],
-    score: field.required ? 0.35 : 0.1,
-    summary: `Matching ${field.label}: ${normalizeText(candidateValue, '')}.`.trim(),
-  });
-}
-
-function buildCompatibilitySignals(world, viewerProfile = {}, candidateProfile = {}, sourceMembershipId) {
-  const signals = [...world.joinSchema.requiredFields, ...world.joinSchema.optionalFields]
-    .map((field) => compareFieldValues(field, viewerProfile[field.fieldId], candidateProfile[field.fieldId], sourceMembershipId))
-    .filter(Boolean);
-
-  if (signals.length > 0) {
-    return signals.sort((left, right) => right.score - left.score || left.fieldIds[0].localeCompare(right.fieldIds[0]));
-  }
-
-  return [
-    createCompatibilitySignal({
-      sourceMembershipId,
-      type: 'world_ready',
-      fieldIds: [],
-      score: 0.05,
-      summary: 'Candidate is online with an active world membership and is ready for agent review before live session handoff.',
-    }),
-  ];
-}
-
-function buildDeliveryReason(signals = []) {
-  const matchedFieldIds = [...new Set(signals.flatMap((signal) => signal.fieldIds).filter(Boolean))];
-
-  if (matchedFieldIds.length === 0) {
-    return {
-      code: 'world_membership_ready',
-      matchedFieldIds: [],
-      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.',
-    };
-  }
-
-  return {
-    code: 'profile_overlap_ready_for_review',
-    matchedFieldIds,
-    summary:
-      `Delivered for agent review because the world found overlap on ${matchedFieldIds.join(', ')} ` +
-      'without starting a live session yet.',
-  };
-}
-
-function resolveCandidateFeedTtlMs(world) {
-  if (world.matching.cadence === 'on_demand') return 60 * 60 * 1000;
-  return DEFAULT_CANDIDATE_FEED_TTL_MS;
-}
-
-function calculateRankingScore(signals = []) {
-  return signals.reduce((total, signal) => total + Number(signal.score || 0), 0);
-}
-
-function resolveCandidateFields(world) {
-  return world.worldId === 'dating-demo-world'
-    ? [...CANDIDATE_OBJECT_FIELDS, ...DATING_DEMO_SCORING_FIELDS]
-    : [...CANDIDATE_OBJECT_FIELDS];
-}
-
-function projectLiveDeliveryEvent(world, candidateFields) {
-  return {
-    schemaId: `${world.worldId}.candidate-delivery-event.v1`,
-    eventName: 'world.candidate.delivered',
-    envelopeFields: LIVE_DELIVERY_EVENT_ENVELOPE_FIELDS,
-    payloadFields: LIVE_DELIVERY_EVENT_PAYLOAD_FIELDS,
-    candidateFieldPath: 'data.candidate',
-    candidateFields,
-    candidateModelId: `${world.worldId}.candidate-feed.v1`,
-    viewerRequirement: 'active_membership',
-    summary:
-      'Future live delivery will reuse the current candidate object inside a push event after delivery workers/subscriptions are added.',
-    status: 'planned_live_delivery',
-  };
-}
-
-export function normalizeCandidateFeedLimit(limit) {
-  const normalized = Number(limit);
-  if (!Number.isFinite(normalized) || normalized <= 0) return DEFAULT_CANDIDATE_FEED_LIMIT;
-  return Math.min(MAX_CANDIDATE_FEED_LIMIT, Math.floor(normalized));
-}
-
-export function projectCandidateFeedModel(world) {
-  const candidateFields = resolveCandidateFields(world);
-
-  return {
-    modelId: `${world.worldId}.candidate-feed.v1`,
-    worldId: world.worldId,
-    deliveryMode: 'agent_review_before_live_session',
-    viewerRequirement: 'active_membership',
-    previewRoute: `/v1/worlds/${world.worldId}/candidates?agentId=:agentId`,
-    candidateFields,
-    profileSummaryFields: PROFILE_SUMMARY_FIELDS,
-    profileSummaryFieldShape: PROFILE_SUMMARY_FIELD_FIELDS,
-    compatibilitySignalFields: COMPATIBILITY_SIGNAL_FIELDS,
-    deliveryReasonFields: DELIVERY_REASON_FIELDS,
-    worldFeedbackSummaryFields: WORLD_FEEDBACK_SUMMARY_FIELDS,
-    requestChatAction: {
-      action: 'request_chat',
-      requiredFields: ['worldId', 'targetAgentId'],
-      summary:
-        'After reviewing a candidate, create a world-scoped chat request with worldId and targetAgentId.',
-    },
-    liveDeliveryEvent: projectLiveDeliveryEvent(world, candidateFields),
-    summary:
-      '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',
-  };
-}
-
-function projectCandidateOpportunity({
-  world,
-  viewerProfile,
-  candidateMembership,
-  candidateAgent,
-  candidatePresence,
-  expiresAt,
-}) {
-  const profileSnapshot = candidateMembership.profileSnapshot || {};
-  const compatibilitySignals = buildCompatibilitySignals(
-    world,
-    viewerProfile,
-    profileSnapshot,
-    candidateMembership.membershipId,
-  );
-  const requestChat = buildRequestChatPayload(world, candidateMembership);
-
-  return {
-    candidateId: `cand_${candidateMembership.membershipId}`,
-    worldId: world.worldId,
-    sourceMembershipId: candidateMembership.membershipId,
-    targetAgentId: requestChat?.targetAgentId || null,
-    online: candidatePresence?.online === true,
-    requestChat,
-    profileSummary: projectProfileSummary(world, profileSnapshot, candidateAgent),
-    compatibilitySignals,
-    deliveryReason: buildDeliveryReason(compatibilitySignals),
-    expiresAt,
-  };
-}
-
-export function buildCandidateFeed({
-  world,
-  viewerMembership,
-  viewerAgent = null,
-  candidateMemberships = [],
-  getAgent = () => null,
-  getPresence = () => ({ online: true }),
-  nowMs = Date.now(),
-  limit = DEFAULT_CANDIDATE_FEED_LIMIT,
-}) {
-  const normalizedNowMs = Number.isFinite(Number(nowMs)) ? Number(nowMs) : Date.now();
-  const generatedAt = new Date(normalizedNowMs).toISOString();
-  const expiresAt = new Date(normalizedNowMs + resolveCandidateFeedTtlMs(world)).toISOString();
-  const normalizedLimit = normalizeCandidateFeedLimit(limit);
-  const viewerProfile = viewerMembership?.profileSnapshot || viewerAgent?.profile || {};
-
-  const candidates = candidateMemberships
-    .filter((membership) => membership?.status === 'active' && membership.membershipId !== viewerMembership.membershipId)
-    .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,
-      });
-
-      return {
-        opportunity,
-        rankingScore: calculateRankingScore(opportunity.compatibilitySignals),
-      };
-    })
-    .sort(
-      (left, right) =>
-        right.rankingScore - left.rankingScore
-        || left.opportunity.candidateId.localeCompare(right.opportunity.candidateId),
-    )
-    .slice(0, normalizedLimit)
-    .map((entry) => entry.opportunity);
-
-  return {
-    worldId: world.worldId,
-    viewerMembershipId: viewerMembership.membershipId,
-    generatedAt,
-    expiresAt,
-    deliveryMode: 'agent_review_before_live_session',
-    nextAction: 'review_candidates_then_request_chat',
-    candidateModel: projectCandidateFeedModel(world),
-    candidates,
-    status: 'feed_ready',
-  };
-}