@xfxstudio/claworld 0.2.13 → 0.2.15

package/src/product-shell/agent-cards/template-registry.js

@@ -1,131 +0,0 @@
-import fs from 'fs/promises';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-const TEMPLATE_DEFINITIONS = Object.freeze([
-  {
-    templateId: 'agent-card.figma-v2',
-    templateVersion: 'v1',
-    width: 1077,
-    height: 1443,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.figma-v2.svg'),
-    description: 'Embedded Figma-export card with centered name/handle over the illustrated shrimp poster.',
-  },
-  {
-    templateId: 'agent-card.slot-01',
-    templateVersion: 'v1',
-    width: 1792,
-    height: 2400,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.slot-01.svg'),
-    description: 'Slot-driven poster card with wide centered name/handle fields and shrink-to-fit metadata.',
-  },
-  {
-    templateId: 'agent-card.slot-02',
-    templateVersion: 'v1',
-    width: 1792,
-    height: 2400,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.slot-02.svg'),
-    description: 'Slot-driven right-side card with centered adaptive text fields and tighter width constraints.',
-  },
-  {
-    templateId: 'agent-card.slot-03',
-    templateVersion: 'v1',
-    width: 1792,
-    height: 2400,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.slot-03.svg'),
-    description: 'Slot-driven wide centered card with larger adaptive text fields over an embedded background.',
-  },
-  {
-    templateId: 'agent-card.slot-04',
-    templateVersion: 'v1',
-    width: 1792,
-    height: 2400,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.slot-04.svg'),
-    description: 'Slot-driven centered card with compact adaptive text fields over an embedded earthy background.',
-  },
-  {
-    templateId: 'agent-card.slot-05',
-    templateVersion: 'v1',
-    width: 1792,
-    height: 2400,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.slot-05.svg'),
-    description: 'Figma-adjusted poster card with left-anchored adaptive name and handle slots.',
-  },
-  {
-    templateId: 'agent-card.slot-06',
-    templateVersion: 'v1',
-    width: 1792,
-    height: 2400,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.slot-06.svg'),
-    description: 'Slot-driven right-column card with centered adaptive text fields over an embedded background.',
-  },
-  {
-    templateId: 'agent-card.slot-07',
-    templateVersion: 'v1',
-    width: 1792,
-    height: 2400,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.slot-07.svg'),
-    description: 'Figma-adjusted warm poster card with large left-anchored adaptive name and handle slots.',
-  },
-  {
-    templateId: 'agent-card.slot-08',
-    templateVersion: 'v1',
-    width: 1792,
-    height: 2400,
-    templatePath: path.join(__dirname, 'templates', 'agent-card.slot-08.svg'),
-    description: 'Figma-adjusted rotated poster card with adaptive slanted name and handle slots.',
-  },
-]);
-
-function normalizeText(value, fallback = null) {
-  if (value == null) return fallback;
-  const normalized = String(value).trim();
-  return normalized || fallback;
-}
-
-export function createAgentCardTemplateRegistry() {
-  const sourceCache = new Map();
-  const templatesById = new Map(TEMPLATE_DEFINITIONS.map((template) => [template.templateId, template]));
-
-  async function loadSource(template) {
-    const cached = sourceCache.get(template.templateId);
-    if (cached) return cached;
-    const source = await fs.readFile(template.templatePath, 'utf8');
-    sourceCache.set(template.templateId, source);
-    return source;
-  }
-
-  return {
-    listTemplates() {
-      return TEMPLATE_DEFINITIONS.map((template) => ({
-        templateId: template.templateId,
-        templateVersion: template.templateVersion,
-        width: template.width,
-        height: template.height,
-        description: template.description,
-      }));
-    },
-    async getTemplate(templateId = TEMPLATE_DEFINITIONS[0].templateId) {
-      const normalizedTemplateId = normalizeText(templateId, TEMPLATE_DEFINITIONS[0].templateId);
-      const template = templatesById.get(normalizedTemplateId) || null;
-      if (!template) {
-        const error = new Error(`unknown_agent_card_template:${normalizedTemplateId}`);
-        error.code = 'unknown_agent_card_template';
-        error.status = 404;
-        error.responseBody = {
-          error: error.code,
-          message: 'agent card template not found',
-          templateId: normalizedTemplateId,
-        };
-        throw error;
-      }
-
-      return {
-        ...template,
-        source: await loadSource(template),
-      };
-    },
-  };
-}

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

@@ -1,38 +0,0 @@
-export const DEFAULT_WORLD_MANIFESTS = Object.freeze([
-  {
-    worldId: 'dating-demo-world',
-    displayName: 'Dating Demo World',
-    summary: 'A lightweight social world for proving world-scoped join, review, and chat request flow.',
-    description:
-      'A lightweight social world where agents compare fit briefly before deciding whether to continue beyond agent chat.',
-    category: 'social',
-    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.',
-  },
-  {
-    worldId: 'skill-handoff-world',
-    displayName: 'Skill Handoff World',
-    summary: 'A small scoped skill-handoff world for proving service-fit review before direct contact.',
-    description:
-      'A service marketplace world where agents quickly screen delivery fit before moving to direct human contact.',
-    category: 'marketplace',
-    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.',
-  },
-  {
-    worldId: 'job-match-world',
-    displayName: 'Job Match World',
-    summary: 'A hiring-fit world optimized for profile completeness, matching, and concise A2A screening.',
-    description:
-      'A recruiting world for agent-assisted screening where both sides validate fit before escalating to direct human contact.',
-    category: 'recruiting',
-    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.',
-  },
-]);

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',
-  };
-}