@indexnetwork/protocol 3.13.0-rc.288.1 → 4.1.1-rc.290.1

package/dist/{profile/profile.tools.js → enrichment/enrichment.tools.js}

@@ -4,9 +4,9 @@ import { success, error, needsClarification, UUID_REGEX } from "../shared/agent/
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { socialsToEnrichmentRequest, detectSocialLabel } from "../shared/utils/social-label.js";
 import { normalizeTelegramHandle } from "../shared/utils/telegram-handle.js";
-import { ProfileGenerator } from "./profile.generator.js";
+import { EnrichmentGenerator } from "./enrichment.generator.js";
 import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
-const logger = protocolLogger("ChatTools:Profile");
+const logger = protocolLogger("ChatTools:Enrichment");
 function isMeaningfulEnrichment(enrichment) {
     return !!enrichment &&
         enrichment.confidentMatch &&
@@ -20,7 +20,7 @@ const approvedProfileDraftSchema = z.object({
     narrative: z.object({ context: z.string() }),
     attributes: z.object({ interests: z.array(z.string()), skills: z.array(z.string()) }),
 });
-export function createProfileTools(defineTool, deps) {
+export function createEnrichmentTools(defineTool, deps) {
     const { userDb, systemDb, graphs, enricher, grantDefaultSystemPermissions, reportToolError, getUserContextText } = deps;
     function trimToUndefined(value) {
         const trimmed = value?.trim();
@@ -104,10 +104,10 @@ export function createProfileTools(defineTool, deps) {
             return [];
         return Object.entries(socials).map(([label, value]) => ({ label, value }));
     }
-    async function enqueueProfileRun(context, operation, input) {
-        if (!context.isMcp || !deps.profileRuns || !deps.profileRunQueue)
+    async function enqueueEnrichmentRun(context, operation, input) {
+        if (!context.isMcp || !deps.enrichmentRuns || !deps.enrichmentRunQueue)
             return null;
-        const run = await deps.profileRuns.create({
+        const run = await deps.enrichmentRuns.create({
             userId: context.userId,
             agentId: context.agentId ?? null,
             operation,
@@ -125,11 +125,11 @@ export function createProfileTools(defineTool, deps) {
             },
         });
         try {
-            await deps.profileRunQueue.enqueue(run.id);
+            await deps.enrichmentRunQueue.enqueue(run.id);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            await deps.profileRuns.markFailed(run.id, message);
+            await deps.enrichmentRuns.markFailed(run.id, message);
             if (err instanceof Error)
                 throw err;
             const wrapped = new Error(`Failed to enqueue profile run: ${message}`);
@@ -203,7 +203,7 @@ export function createProfileTools(defineTool, deps) {
             return;
         const traceEmitter = requestContext.getStore()?.traceEmitter;
         const graphStart = Date.now();
-        traceEmitter?.({ type: "graph_start", name: "profile" });
+        traceEmitter?.({ type: "graph_start", name: "enrichment" });
         try {
             const graphInput = {
                 userId: profile.userId,
@@ -211,7 +211,7 @@ export function createProfileTools(defineTool, deps) {
                 input,
                 forceUpdate: true,
             };
-            // Always invoked as a background fire-and-forget task (see confirm_user_profile
+            // Always invoked as a background fire-and-forget task (see confirm_user_context
             // call sites), so decomposition must outlive the originating request — invoke
             // the graph directly and never bind the request abort signal, which would
             // cancel it as soon as the web request completes.
@@ -223,11 +223,11 @@ export function createProfileTools(defineTool, deps) {
                     error: result.error,
                 });
                 reportToolError?.(err, {
-                    subsystem: 'profile',
+                    subsystem: 'enrichment',
                     operation: 'profile.confirm_draft_decompose',
-                    toolName: 'confirm_user_profile',
+                    toolName: 'confirm_user_context',
                     userId: profile.userId,
-                    tags: { toolName: 'confirm_user_profile', execution: 'background' },
+                    tags: { toolName: 'confirm_user_context', execution: 'background' },
                 });
                 return;
             }
@@ -243,19 +243,19 @@ export function createProfileTools(defineTool, deps) {
                 error: err instanceof Error ? err.message : String(err),
             });
             reportToolError?.(err, {
-                subsystem: 'profile',
+                subsystem: 'enrichment',
                 operation: 'profile.confirm_draft_decompose',
-                toolName: 'confirm_user_profile',
+                toolName: 'confirm_user_context',
                 userId: profile.userId,
-                tags: { toolName: 'confirm_user_profile', execution: 'background' },
+                tags: { toolName: 'confirm_user_context', execution: 'background' },
             });
         }
         finally {
-            traceEmitter?.({ type: "graph_end", name: "profile", durationMs: Date.now() - graphStart });
+            traceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: Date.now() - graphStart });
         }
     }
-    const readUserProfiles = defineTool({
-        name: "read_user_profiles",
+    const readUserContexts = defineTool({
+        name: "read_user_contexts",
         description: "Retrieves user profiles containing identity info (name, bio, location) plus a rich `context` paragraph (the user's synthesized identity text). " +
             "Profiles are used for semantic matching in opportunity discovery — the richer the user's context, the better the matches.\n\n" +
             "**Usage modes:**\n" +
@@ -265,7 +265,7 @@ export function createProfileTools(defineTool, deps) {
             "- With `networkId` alone: returns thin-identity profiles of ALL members in that index (no `context`).\n" +
             "- No parameters: returns the current user's own profile, including their `context`.\n\n" +
             "**When to use:** Before creating introductions (need profiles of both parties), when the user asks about a person, " +
-            "or to check if a profile exists before suggesting create_user_profile. " +
+            "or to check if a profile exists before suggesting create_user_context. " +
             "MCP agents should call this with no arguments at session start to fetch the caller's profile AND onboarding status.\n\n" +
             "**Returns:** Profile objects with name, bio, location, and (for single-user reads) a `context` paragraph. Use userId from results with other tools like read_intents(userId, networkId). " +
             "When called for the current user (no args, or userId=self), the response also includes `onboardingComplete: boolean` and `onboardingCompletedAt?: string` — " +
@@ -324,23 +324,19 @@ export function createProfileTools(defineTool, deps) {
                 const profiles = await Promise.all(matched.map(async (m) => {
                     try {
                         const profile = await systemDb.getProfile(m.userId);
-                        // Thin identity for list results. skills/interests are retired; the rich
-                        // identity text (global user_context) is fetched per-user via a userId read.
+                        // Flat thin identity for list results. skills/interests are retired; the
+                        // rich identity text (global user_context) is fetched per-user via a userId read.
                         return {
                             userId: m.userId,
                             name: m.name,
                             hasProfile: !!profile,
-                            profile: profile
-                                ? {
-                                    name: profile.identity.name,
-                                    bio: profile.identity.bio,
-                                    location: profile.identity.location,
-                                }
-                                : undefined,
+                            ...(profile
+                                ? { bio: profile.identity.bio, location: profile.identity.location }
+                                : {}),
                         };
                     }
                     catch (err) {
-                        logger.warn("read_user_profiles: getProfile failed; degrading to hasProfile=false", {
+                        logger.warn("read_user_contexts: getProfile failed; degrading to hasProfile=false", {
                             userId: m.userId,
                             error: err instanceof Error ? err.message : String(err),
                         });
@@ -367,19 +363,15 @@ export function createProfileTools(defineTool, deps) {
                 const members = await systemDb.getNetworkMembers(effectiveIndexId);
                 const profiles = await Promise.all(members.map(async (member) => {
                     const profile = await systemDb.getProfile(member.userId);
-                    // Thin identity for roster results. skills/interests are retired; fetch a
+                    // Flat thin identity for roster results. skills/interests are retired; fetch a
                     // member's global user_context text via a single-user (userId) read.
                     return {
                         userId: member.userId,
                         name: member.name,
                         hasProfile: !!profile,
-                        profile: profile
-                            ? {
-                                name: profile.identity.name,
-                                bio: profile.identity.bio,
-                                location: profile.identity.location,
-                            }
-                            : undefined,
+                        ...(profile
+                            ? { bio: profile.identity.bio, location: profile.identity.location }
+                            : {}),
                     };
                 }));
                 return success({ networkId: effectiveIndexId, memberCount: members.length, profiles });
@@ -403,12 +395,10 @@ export function createProfileTools(defineTool, deps) {
                     const context = getUserContextText ? await getUserContextText(targetUserId) : '';
                     return success({
                         hasProfile: true,
-                        profile: {
-                            name: profile.identity.name,
-                            bio: profile.identity.bio,
-                            location: profile.identity.location,
-                            context,
-                        },
+                        name: profile.identity.name,
+                        bio: profile.identity.bio,
+                        location: profile.identity.location,
+                        context,
                     });
                 }
                 return success({ hasProfile: false, message: "This user does not have a profile yet." });
@@ -416,13 +406,13 @@ export function createProfileTools(defineTool, deps) {
             // --- Mode 1: No args / self → use profileGraph query (returns id for updates) ---
             const _readProfileGraphStart = Date.now();
             const _readProfileTraceEmitter = requestContext.getStore()?.traceEmitter;
-            _readProfileTraceEmitter?.({ type: "graph_start", name: "profile" });
+            _readProfileTraceEmitter?.({ type: "graph_start", name: "enrichment" });
             const result = await invokeWithAbortSignal(graphs.profile, {
                 userId: context.userId,
                 operationMode: 'query',
             });
             const _readProfileGraphMs = Date.now() - _readProfileGraphStart;
-            _readProfileTraceEmitter?.({ type: "graph_end", name: "profile", durationMs: _readProfileGraphMs });
+            _readProfileTraceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: _readProfileGraphMs });
             // Self-lookup includes onboarding status so MCP agents (e.g. Edge Claw)
             // can decide whether to run the onboarding flow without depending on
             // local-only state like a workspace BOOTSTRAP.md file.
@@ -435,29 +425,28 @@ export function createProfileTools(defineTool, deps) {
                 // Augment the graph's thin-identity readResult with the caller's global
                 // user_context text (the rich, profile-replacing identity paragraph).
                 const readResult = result.readResult;
-                const withContext = readResult.hasProfile && readResult.profile
-                    ? { ...readResult, profile: { ...readResult.profile, context: getUserContextText ? await getUserContextText(context.userId) : '' } }
-                    : readResult;
-                return success({ ...withContext, ...onboardingFields, _graphTimings: [{ name: 'profile', durationMs: _readProfileGraphMs, agents: result.agentTimings ?? [] }] });
+                // Flatten identity fields up; drop the nested `profile` object (WS11).
+                const flat = readResult.hasProfile && readResult.profile
+                    ? { hasProfile: true, ...readResult.profile, context: getUserContextText ? await getUserContextText(context.userId) : '' }
+                    : { ...readResult };
+                return success({ ...flat, ...onboardingFields, _graphTimings: [{ name: 'enrichment', durationMs: _readProfileGraphMs, agents: result.agentTimings ?? [] }] });
             }
             if (result.profile) {
                 return success({
                     hasProfile: true,
-                    profile: {
-                        name: result.profile.identity.name,
-                        bio: result.profile.identity.bio,
-                        location: result.profile.identity.location,
-                        context: getUserContextText ? await getUserContextText(context.userId) : '',
-                    },
+                    name: result.profile.identity.name,
+                    bio: result.profile.identity.bio,
+                    location: result.profile.identity.location,
+                    context: getUserContextText ? await getUserContextText(context.userId) : '',
                     ...onboardingFields,
-                    _graphTimings: [{ name: 'profile', durationMs: _readProfileGraphMs, agents: result.agentTimings ?? [] }],
+                    _graphTimings: [{ name: 'enrichment', durationMs: _readProfileGraphMs, agents: result.agentTimings ?? [] }],
                 });
             }
             return success({
                 hasProfile: false,
                 ...onboardingFields,
                 message: "You don't have a profile yet. Would you like to create one? You can share your LinkedIn, GitHub, or X/Twitter profile, or just tell me about yourself.",
-                _graphTimings: [{ name: 'profile', durationMs: _readProfileGraphMs, agents: result.agentTimings ?? [] }],
+                _graphTimings: [{ name: 'enrichment', durationMs: _readProfileGraphMs, agents: result.agentTimings ?? [] }],
             });
         },
     });
@@ -504,11 +493,11 @@ export function createProfileTools(defineTool, deps) {
             });
         },
     });
-    const previewUserProfile = defineTool({
-        name: "preview_user_profile",
+    const previewUserContext = defineTool({
+        name: "preview_user_context",
         description: "Builds a structured profile draft for onboarding without saving anything. Use this after recording privacy consent and before asking the user to approve the profile. " +
             "If allowPublicLookup is false, this tool uses only explicit text, EdgeOS/event data the user allowed, and user-provided social URLs. If allowPublicLookup is true, persisted public lookup consent is required. " +
-            "In MCP contexts, starts an async profile run and returns `profileRunId`; poll get_profile_run until status is `succeeded`, then present its `result`." +
+            "In MCP contexts, starts an async profile run and returns `profileRunId`; poll get_enrichment_run until status is `succeeded`, then present its `result`." +
             " When public lookup runs, the result includes a `publicLookup` block reporting whether a candidate identity was found (`used`, `confidentMatch`) and what it was (`identity` of name/role/location, plus `socials`), so the caller can confirm identity before saving. A candidate can be returned (`used: true`) without being confident enough to enter the draft; when no lookup runs the block is `{ used: false }`.",
         querySchema: z.object({
             name: z.string().optional().describe("Name explicitly provided by the user. For authenticated public lookup, the account identity is used first and this is only a fallback."),
@@ -525,12 +514,12 @@ export function createProfileTools(defineTool, deps) {
             const user = await userDb.getUser();
             if (!user)
                 return error("User not found.");
-            const profileRunId = await enqueueProfileRun(context, "preview_user_profile", query);
+            const profileRunId = await enqueueEnrichmentRun(context, "preview_user_context", query);
             if (profileRunId) {
                 return success({
                     status: "queued",
                     profileRunId,
-                    message: `Profile preview started. Call get_profile_run with profileRunId="${profileRunId}" until it succeeds, fails, or is cancelled.`,
+                    message: `Profile preview started. Call get_enrichment_run with profileRunId="${profileRunId}" until it succeeds, fails, or is cancelled.`,
                 });
             }
             const onboarding = user.onboarding ?? context.user.onboarding;
@@ -574,12 +563,12 @@ export function createProfileTools(defineTool, deps) {
                     message: "Please share a short description, allowed EdgeOS profile text, or user-provided profile links so I can draft your profile.",
                 });
             }
-            const generated = await new ProfileGenerator().invoke(input);
+            const generated = await new EnrichmentGenerator().invoke(input);
             const profile = { ...generated.output, userId: context.userId };
             return success({
                 preview: true,
                 persisted: false,
-                message: "Profile draft generated. Show this to the user and ask whether it looks right before calling confirm_user_profile.",
+                message: "Profile draft generated. Show this to the user and ask whether it looks right before calling confirm_user_context.",
                 profile: toProfileSummary(profile),
                 draft: profile,
                 publicLookup: enrichment
@@ -598,12 +587,12 @@ export function createProfileTools(defineTool, deps) {
             });
         },
     });
-    const confirmUserProfile = defineTool({
-        name: "confirm_user_profile",
-        description: "Saves an explicitly approved onboarding profile draft. Call this only after the user has seen the draft from preview_user_profile and approved it or provided corrections. " +
+    const confirmUserContext = defineTool({
+        name: "confirm_user_context",
+        description: "Saves an explicitly approved onboarding profile draft. Call this only after the user has seen the draft from preview_user_context and approved it or provided corrections. " +
             "This path uses only the approved draft/explicit correction text and does not scrape or run public lookup.",
         querySchema: z.object({
-            draft: approvedProfileDraftSchema.optional().describe("The structured profile draft returned by preview_user_profile after user approval."),
+            draft: approvedProfileDraftSchema.optional().describe("The structured profile draft returned by preview_user_context after user approval."),
             bioOrDescription: z.string().optional().describe("Approved correction or explicit profile text if not passing a structured draft."),
             name: z.string().optional().describe("Approved name correction."),
             location: z.string().optional().describe("Approved location correction."),
@@ -612,7 +601,7 @@ export function createProfileTools(defineTool, deps) {
             const user = await userDb.getUser();
             if (query.draft) {
                 const profile = { ...query.draft, userId: context.userId };
-                await userDb.saveProfile(profile);
+                await userDb.saveProfile({ userId: context.userId, identity: profile.identity, context: profile.narrative?.context ?? '' });
                 await persistApprovedProfileContext(profile, user, context.networkId);
                 const decomposeLogLabel = context.isMcp
                     ? 'Approved draft premise decomposition failed'
@@ -652,7 +641,7 @@ export function createProfileTools(defineTool, deps) {
             await persistApprovedProfileContext(rawProfile, user, context.networkId);
             const _confirmTraceEmitter = requestContext.getStore()?.traceEmitter;
             const _confirmGraphStart = Date.now();
-            _confirmTraceEmitter?.({ type: "graph_start", name: "profile" });
+            _confirmTraceEmitter?.({ type: "graph_start", name: "enrichment" });
             graphs.profile.invoke({
                 userId: context.userId,
                 operationMode: 'write',
@@ -670,7 +659,7 @@ export function createProfileTools(defineTool, deps) {
                 error: err instanceof Error ? err.message : String(err),
             })).finally(() => {
                 const _confirmGraphMs = Date.now() - _confirmGraphStart;
-                _confirmTraceEmitter?.({ type: "graph_end", name: "profile", durationMs: _confirmGraphMs });
+                _confirmTraceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: _confirmGraphMs });
             });
             return success({
                 created: true,
@@ -682,10 +671,10 @@ export function createProfileTools(defineTool, deps) {
             });
         },
     });
-    const createUserProfile = defineTool({
-        name: "create_user_profile",
+    const createUserContext = defineTool({
+        name: "create_user_context",
         description: "Legacy/backward-compatible tool that creates or regenerates the authenticated user's profile. AgentVillage/Hermes onboarding must use " +
-            "record_onboarding_privacy_consent → preview_user_profile → confirm_user_profile instead, so consent is recorded and the draft is shown before saving. " +
+            "record_onboarding_privacy_consent → preview_user_context → confirm_user_context instead, so consent is recorded and the draft is shown before saving. " +
             "Profiles are essential for discovery — they provide the semantic context used to match users with complementary intents.\n\n" +
             "**How it works:** For generic clients, the system can enrich profile data from public web sources (LinkedIn, GitHub, Twitter) and/or explicit user input, " +
             "then generates a structured profile with bio, skills, interests, location, and narrative context. Do not call with no arguments in consent-required onboarding flows.\n\n" +
@@ -693,7 +682,7 @@ export function createProfileTools(defineTool, deps) {
             "- No args: attempts auto-generation from account data. If insufficient info, returns `missingFields` — ask the user for name/social URLs and retry.\n" +
             "- With social URLs (linkedinUrl, githubUrl, etc.): enriches from those specific URLs.\n" +
             "- With bioOrDescription: creates profile from explicit text only (no web scraping).\n" +
-            "- Legacy onboarding clients: first call returns a preview. AgentVillage/Hermes clients should not use this preview path; use preview_user_profile instead because it does not persist enrichment side effects.\n\n" +
+            "- Legacy onboarding clients: first call returns a preview. AgentVillage/Hermes clients should not use this preview path; use preview_user_context instead because it does not persist enrichment side effects.\n\n" +
             "**Returns:** The generated profile (name, bio, location, skills, interests) or a `needsClarification` response listing missing fields.\n\n" +
             "**Next steps:** After profile creation, the user can create intents (create_intent) and join indexes (create_network_membership) to start discovering opportunities.",
         querySchema: z.object({
@@ -744,13 +733,11 @@ export function createProfileTools(defineTool, deps) {
                 if (existingProfile) {
                     return success({
                         alreadyExists: true,
-                        message: "Profile already exists. If the user confirmed it, call complete_onboarding() to finish setup. If they want changes, use create_user_profile(bioOrDescription=\"...\", confirm=true).",
+                        message: "Profile already exists. If the user confirmed it, call complete_onboarding() to finish setup. If they want changes, use create_user_context(bioOrDescription=\"...\", confirm=true).",
                         profile: {
                             name: existingProfile.identity.name,
                             bio: existingProfile.identity.bio,
                             location: existingProfile.identity.location,
-                            skills: existingProfile.attributes.skills,
-                            interests: existingProfile.attributes.interests,
                         },
                     });
                 }
@@ -789,7 +776,7 @@ export function createProfileTools(defineTool, deps) {
                             }
                             return success({
                                 preview: true,
-                                message: "Profile preview generated. Call create_user_profile(confirm=true) to save.",
+                                message: "Profile preview generated. Call create_user_context(confirm=true) to save.",
                                 profile: {
                                     name: enrichment.identity.name,
                                     bio: enrichment.identity.bio,
@@ -820,13 +807,13 @@ export function createProfileTools(defineTool, deps) {
                 try {
                     const _confirmGraphStart = Date.now();
                     const _confirmTraceEmitter = requestContext.getStore()?.traceEmitter;
-                    _confirmTraceEmitter?.({ type: "graph_start", name: "profile" });
+                    _confirmTraceEmitter?.({ type: "graph_start", name: "enrichment" });
                     const result = await invokeWithAbortSignal(graphs.profile, {
                         userId: context.userId,
                         operationMode: 'generate',
                     });
                     const _confirmGraphMs = Date.now() - _confirmGraphStart;
-                    _confirmTraceEmitter?.({ type: "graph_end", name: "profile", durationMs: _confirmGraphMs });
+                    _confirmTraceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: _confirmGraphMs });
                     if (result.error)
                         return error(result.error);
                     if (result.profile) {
@@ -840,7 +827,7 @@ export function createProfileTools(defineTool, deps) {
                                 skills: result.profile.attributes.skills,
                                 interests: result.profile.attributes.interests,
                             },
-                            _graphTimings: [{ name: 'profile', durationMs: _confirmGraphMs, agents: result.agentTimings ?? [] }],
+                            _graphTimings: [{ name: 'enrichment', durationMs: _confirmGraphMs, agents: result.agentTimings ?? [] }],
                         });
                     }
                 }
@@ -854,7 +841,7 @@ export function createProfileTools(defineTool, deps) {
             const hasBioOrDescription = !!query.bioOrDescription?.trim();
             if (hasBioOrDescription) {
                 // Create/update profile from user's explicit text only; do not persist to user record
-                // Include name and location in the input if provided so the ProfileGenerator can use them
+                // Include name and location in the input if provided so the EnrichmentGenerator can use them
                 const inputParts = [];
                 if (name)
                     inputParts.push(`Name: ${name}`);
@@ -864,7 +851,7 @@ export function createProfileTools(defineTool, deps) {
                 const profileInput = inputParts.join('\n');
                 const _bioProfileGraphStart = Date.now();
                 const _bioProfileTraceEmitter = requestContext.getStore()?.traceEmitter;
-                _bioProfileTraceEmitter?.({ type: "graph_start", name: "profile" });
+                _bioProfileTraceEmitter?.({ type: "graph_start", name: "enrichment" });
                 const result = await invokeWithAbortSignal(graphs.profile, {
                     userId: context.userId,
                     operationMode: 'write',
@@ -872,7 +859,7 @@ export function createProfileTools(defineTool, deps) {
                     forceUpdate: true,
                 });
                 const _bioProfileGraphMs = Date.now() - _bioProfileGraphStart;
-                _bioProfileTraceEmitter?.({ type: "graph_end", name: "profile", durationMs: _bioProfileGraphMs });
+                _bioProfileTraceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: _bioProfileGraphMs });
                 if (result.error) {
                     return error(result.error);
                 }
@@ -887,26 +874,26 @@ export function createProfileTools(defineTool, deps) {
                             skills: result.profile.attributes.skills,
                             interests: result.profile.attributes.interests,
                         },
-                        _graphTimings: [{ name: 'profile', durationMs: _bioProfileGraphMs, agents: result.agentTimings ?? [] }],
+                        _graphTimings: [{ name: 'enrichment', durationMs: _bioProfileGraphMs, agents: result.agentTimings ?? [] }],
                     });
                 }
                 return success({
                     created: true,
                     message: "Profile created/updated with the information you provided.",
-                    _graphTimings: [{ name: 'profile', durationMs: _bioProfileGraphMs, agents: result.agentTimings ?? [] }],
+                    _graphTimings: [{ name: 'enrichment', durationMs: _bioProfileGraphMs, agents: result.agentTimings ?? [] }],
                 });
             }
             // Invoke profile graph in generate mode (uses enrichUserProfile Chat API)
             const _generateProfileGraphStart = Date.now();
             const _generateProfileTraceEmitter = requestContext.getStore()?.traceEmitter;
-            _generateProfileTraceEmitter?.({ type: "graph_start", name: "profile" });
+            _generateProfileTraceEmitter?.({ type: "graph_start", name: "enrichment" });
             const result = await invokeWithAbortSignal(graphs.profile, {
                 userId: context.userId,
                 operationMode: 'generate',
                 forceUpdate: true,
             });
             const _generateProfileGraphMs = Date.now() - _generateProfileGraphStart;
-            _generateProfileTraceEmitter?.({ type: "graph_end", name: "profile", durationMs: _generateProfileGraphMs });
+            _generateProfileTraceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: _generateProfileGraphMs });
             // If user info is insufficient, ask conversationally
             if (result.needsUserInfo) {
                 return needsClarification({
@@ -928,14 +915,14 @@ export function createProfileTools(defineTool, deps) {
                         skills: result.profile.attributes.skills,
                         interests: result.profile.attributes.interests,
                     },
-                    _graphTimings: [{ name: 'profile', durationMs: _generateProfileGraphMs, agents: result.agentTimings ?? [] }],
+                    _graphTimings: [{ name: 'enrichment', durationMs: _generateProfileGraphMs, agents: result.agentTimings ?? [] }],
                 });
             }
             return error("Failed to create profile. Please try again.");
         },
     });
-    const updateUserProfile = defineTool({
-        name: "update_user_profile",
+    const updateUserContext = defineTool({
+        name: "update_user_context",
         description: "Updates the authenticated user's existing profile using a verb-style instruction interface.\n\n" +
             "**How to use it:**\n" +
             "- `action`: a natural-language instruction describing what to change (e.g. \"add interests\", \"update bio\", \"remove skill\", \"set location\").\n" +
@@ -946,12 +933,12 @@ export function createProfileTools(defineTool, deps) {
             "- `action=\"update bio\"`, `details=\"Product designer focused on desktop CRPG interfaces\"`\n" +
             "- `action=\"set location\"`, `details=\"Berlin\"`\n" +
             "- `socials={ telegram: \"@alice\" }` to silently add a reachable chat handle without regenerating the profile.\n\n" +
-            "**When to use:** When the user wants to make specific changes without regenerating the whole profile. For full profile regeneration from social URLs, use create_user_profile instead.\n\n" +
+            "**When to use:** When the user wants to make specific changes without regenerating the whole profile. For full profile regeneration from social URLs, use create_user_context instead.\n\n" +
             "**Important:** If the user provides a URL to update from, call scrape_url first, then pass the scraped content in `details`.\n\n" +
             "**MCP behavior:** For MCP clients, text/profile graph updates are accepted immediately and completed in the background to avoid transport timeouts. Social-only updates still complete synchronously.\n\n" +
             "**Returns:** Confirmation that the profile was updated or accepted for background update.",
         querySchema: z.object({
-            profileId: z.string().optional().describe("Profile UUID from read_user_profiles. Omit to update the current user's own profile (most common usage)."),
+            profileId: z.string().optional().describe("Profile UUID from read_user_contexts. Omit to update the current user's own profile (most common usage)."),
             action: z.string().optional().describe("Natural language description of ALL changes to make in a single call. Examples: 'update bio to focus on AI research', 'add Python and Rust to skills', 'change location to Berlin and add machine learning to interests'. Optional when only updating socials."),
             details: z.string().optional().describe("Additional context or content to incorporate. Use this to pass scraped URL content (from scrape_url) or longer text the user provided."),
             socials: z.record(z.string()).optional().describe("Social handles or URLs to merge into the user profile, keyed by label. Example: { telegram: '@alice', github: 'alice' }. Existing socials with other labels are preserved."),
@@ -966,28 +953,28 @@ export function createProfileTools(defineTool, deps) {
                 }
                 return error("Please specify what to update (e.g. action: 'update bio to X') or provide socials.");
             }
-            const profileRunId = await enqueueProfileRun(context, "update_user_profile", query);
+            const profileRunId = await enqueueEnrichmentRun(context, "update_user_context", query);
             if (profileRunId) {
                 return success({
                     status: "queued",
                     profileRunId,
-                    message: `Profile update started. Call get_profile_run with profileRunId="${profileRunId}" until it succeeds, fails, or is cancelled.`,
+                    message: `Profile update started. Call get_enrichment_run with profileRunId="${profileRunId}" until it succeeds, fails, or is cancelled.`,
                 });
             }
             // Use profileGraph query mode to validate profile existence and get id
             const _updateQueryProfileGraphStart = Date.now();
             const _updateQueryProfileTraceEmitter = requestContext.getStore()?.traceEmitter;
-            _updateQueryProfileTraceEmitter?.({ type: "graph_start", name: "profile" });
+            _updateQueryProfileTraceEmitter?.({ type: "graph_start", name: "enrichment" });
             const queryResult = await invokeWithAbortSignal(graphs.profile, { userId: context.userId, operationMode: 'query' });
             const _updateQueryProfileGraphMs = Date.now() - _updateQueryProfileGraphStart;
-            _updateQueryProfileTraceEmitter?.({ type: "graph_end", name: "profile", durationMs: _updateQueryProfileGraphMs });
+            _updateQueryProfileTraceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: _updateQueryProfileGraphMs });
             if (!queryResult.readResult?.hasProfile && !queryResult.profile) {
-                return error("You don't have a profile yet. Use create_user_profile first.");
+                return error("You don't have a profile yet. Use create_user_context first.");
             }
             const existingProfileId = queryResult.readResult?.profile?.id;
             const providedProfileId = query.profileId?.trim();
             if (providedProfileId && existingProfileId && providedProfileId !== existingProfileId) {
-                return error("Invalid profileId. Use the profile id from read_user_profiles.");
+                return error("Invalid profileId. Use the profile id from read_user_contexts.");
             }
             if (socialUpdates.length > 0) {
                 await mergeUserSocials(socialUpdates);
@@ -995,7 +982,7 @@ export function createProfileTools(defineTool, deps) {
             if (context.isMcp) {
                 const _backgroundWriteProfileGraphStart = Date.now();
                 const _backgroundWriteProfileTraceEmitter = requestContext.getStore()?.traceEmitter;
-                _backgroundWriteProfileTraceEmitter?.({ type: "graph_start", name: "profile" });
+                _backgroundWriteProfileTraceEmitter?.({ type: "graph_start", name: "enrichment" });
                 graphs.profile.invoke({
                     userId: context.userId,
                     operationMode: "write",
@@ -1008,11 +995,11 @@ export function createProfileTools(defineTool, deps) {
                             error: writeResult.error,
                         });
                         reportToolError?.(new Error(writeResult.error), {
-                            subsystem: "profile",
+                            subsystem: "enrichment",
                             operation: "profile.update_background",
-                            toolName: "update_user_profile",
+                            toolName: "update_user_context",
                             userId: context.userId,
-                            tags: { toolName: "update_user_profile", execution: "background" },
+                            tags: { toolName: "update_user_context", execution: "background" },
                             context: { profileId: existingProfileId ?? providedProfileId },
                         });
                     }
@@ -1023,29 +1010,29 @@ export function createProfileTools(defineTool, deps) {
                         error: message,
                     });
                     reportToolError?.(err, {
-                        subsystem: "profile",
+                        subsystem: "enrichment",
                         operation: "profile.update_background",
-                        toolName: "update_user_profile",
+                        toolName: "update_user_context",
                         userId: context.userId,
-                        tags: { toolName: "update_user_profile", execution: "background" },
+                        tags: { toolName: "update_user_context", execution: "background" },
                         context: { profileId: existingProfileId ?? providedProfileId },
                     });
                 }).finally(() => {
                     const _backgroundWriteProfileGraphMs = Date.now() - _backgroundWriteProfileGraphStart;
-                    _backgroundWriteProfileTraceEmitter?.({ type: "graph_end", name: "profile", durationMs: _backgroundWriteProfileGraphMs });
+                    _backgroundWriteProfileTraceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: _backgroundWriteProfileGraphMs });
                 });
                 return success({
                     accepted: true,
                     message: "Profile update accepted. The structured profile will refresh in the background.",
                     _graphTimings: [
-                        { name: 'profile', durationMs: _updateQueryProfileGraphMs, agents: queryResult.agentTimings ?? [] },
+                        { name: 'enrichment', durationMs: _updateQueryProfileGraphMs, agents: queryResult.agentTimings ?? [] },
                     ],
                 });
             }
             // Execute update directly
             const _updateWriteProfileGraphStart = Date.now();
             const _updateWriteProfileTraceEmitter = requestContext.getStore()?.traceEmitter;
-            _updateWriteProfileTraceEmitter?.({ type: "graph_start", name: "profile" });
+            _updateWriteProfileTraceEmitter?.({ type: "graph_start", name: "enrichment" });
             const _writeResult = await invokeWithAbortSignal(graphs.profile, {
                 userId: context.userId,
                 operationMode: "write",
@@ -1053,31 +1040,31 @@ export function createProfileTools(defineTool, deps) {
                 forceUpdate: true,
             });
             const _updateWriteProfileGraphMs = Date.now() - _updateWriteProfileGraphStart;
-            _updateWriteProfileTraceEmitter?.({ type: "graph_end", name: "profile", durationMs: _updateWriteProfileGraphMs });
+            _updateWriteProfileTraceEmitter?.({ type: "graph_end", name: "enrichment", durationMs: _updateWriteProfileGraphMs });
             if (_writeResult.error) {
                 return error(_writeResult.error);
             }
             return success({
                 message: "Profile updated.",
                 _graphTimings: [
-                    { name: 'profile', durationMs: _updateQueryProfileGraphMs, agents: queryResult.agentTimings ?? [] },
-                    { name: 'profile', durationMs: _updateWriteProfileGraphMs, agents: _writeResult.agentTimings ?? [] },
+                    { name: 'enrichment', durationMs: _updateQueryProfileGraphMs, agents: queryResult.agentTimings ?? [] },
+                    { name: 'enrichment', durationMs: _updateWriteProfileGraphMs, agents: _writeResult.agentTimings ?? [] },
                 ],
             });
         },
     });
-    const getProfileRun = defineTool({
-        name: "get_profile_run",
-        description: "Checks the status of an async profile preview/update run started by preview_user_profile or update_user_profile in MCP contexts. " +
+    const getEnrichmentRun = defineTool({
+        name: "get_enrichment_run",
+        description: "Checks the status of an async profile preview/update run started by preview_user_context or update_user_context in MCP contexts. " +
             "Poll this tool with the profileRunId until status is succeeded, failed, or cancelled. When succeeded, present the result to the user.",
         querySchema: z.object({
-            profileRunId: z.string().describe("Profile run ID returned by preview_user_profile or update_user_profile."),
+            profileRunId: z.string().describe("Profile run ID returned by preview_user_context or update_user_context."),
         }),
         handler: async ({ context, query }) => {
-            if (!deps.profileRuns) {
+            if (!deps.enrichmentRuns) {
                 return error("Profile run polling is not available in this environment.");
             }
-            const run = await deps.profileRuns.get(query.profileRunId, context.userId);
+            const run = await deps.enrichmentRuns.get(query.profileRunId, context.userId);
             if (!run)
                 return error("Profile run not found.");
             return success({
@@ -1093,18 +1080,18 @@ export function createProfileTools(defineTool, deps) {
             });
         },
     });
-    const cancelProfileRun = defineTool({
-        name: "cancel_profile_run",
+    const cancelEnrichmentRun = defineTool({
+        name: "cancel_enrichment_run",
         description: "Requests cancellation for an async profile run. If the queued job has not started, it is removed and marked cancelled. " +
             "If already running, the worker observes the cancellation request and aborts where supported.",
         querySchema: z.object({
-            profileRunId: z.string().describe("Profile run ID returned by preview_user_profile or update_user_profile."),
+            profileRunId: z.string().describe("Profile run ID returned by preview_user_context or update_user_context."),
         }),
         handler: async ({ context, query }) => {
-            if (!deps.profileRuns || !deps.profileRunQueue) {
+            if (!deps.enrichmentRuns || !deps.enrichmentRunQueue) {
                 return error("Profile run cancellation is not available in this environment.");
             }
-            const existing = await deps.profileRuns.get(query.profileRunId, context.userId);
+            const existing = await deps.enrichmentRuns.get(query.profileRunId, context.userId);
             if (!existing)
                 return error("Profile run not found.");
             if (!["queued", "running"].includes(existing.status)) {
@@ -1114,14 +1101,14 @@ export function createProfileTools(defineTool, deps) {
                     message: `Profile run is already ${existing.status}.`,
                 });
             }
-            const run = await deps.profileRuns.requestCancel(query.profileRunId, context.userId);
+            const run = await deps.enrichmentRuns.requestCancel(query.profileRunId, context.userId);
             if (!run)
                 return error("Profile run not found or cannot be cancelled.");
-            const removed = await deps.profileRunQueue.cancel(run.id);
+            const removed = await deps.enrichmentRunQueue.cancel(run.id);
             if (removed) {
-                await deps.profileRuns.markCancelled(run.id, "cancelled before worker start");
+                await deps.enrichmentRuns.markCancelled(run.id, "cancelled before worker start");
             }
-            const updated = await deps.profileRuns.get(run.id, context.userId);
+            const updated = await deps.enrichmentRuns.get(run.id, context.userId);
             return success({
                 profileRunId: run.id,
                 status: updated?.status ?? run.status,
@@ -1138,7 +1125,7 @@ export function createProfileTools(defineTool, deps) {
             "**Prerequisites:** The user must have a confirmed profile AND at least one active intent/signal. The profile must be shown to the user and explicitly approved " +
             "(said 'yes', 'looks good', 'that's right', or similar). The first signal must be persisted before this tool is called; MCP/onboarding agents should call create_intent(..., autoApprove=true).\n\n" +
             "**What happens:** Validates that the confirmed profile and first active intent exist, then sets completedAt timestamp on the user's onboarding record.\n\n" +
-            "**Workflow:** create_user_profile() -> user confirms preview -> create_user_profile(confirm=true) -> create_intent(..., autoApprove=true) -> complete_onboarding()\n\n" +
+            "**Workflow:** create_user_context() -> user confirms preview -> create_user_context(confirm=true) -> create_intent(..., autoApprove=true) -> complete_onboarding()\n\n" +
             "**Returns:** Confirmation that onboarding is complete. No parameters needed.",
         querySchema: z.object({}),
         handler: async ({ context }) => {
@@ -1176,6 +1163,6 @@ export function createProfileTools(defineTool, deps) {
             return success({ message: "Onboarding complete." });
         },
     });
-    return [readUserProfiles, recordOnboardingPrivacyConsent, previewUserProfile, confirmUserProfile, createUserProfile, updateUserProfile, getProfileRun, cancelProfileRun, completeOnboarding];
+    return [readUserContexts, recordOnboardingPrivacyConsent, previewUserContext, confirmUserContext, createUserContext, updateUserContext, getEnrichmentRun, cancelEnrichmentRun, completeOnboarding];
 }
-//# sourceMappingURL=profile.tools.js.map
+//# sourceMappingURL=enrichment.tools.js.map