@indexnetwork/protocol 3.7.0-rc.277.1 → 3.7.1-rc.278.1

package/dist/questioner/questioner.presets.js

@@ -14,6 +14,27 @@ const REFERENTIAL_CLOSURE_RULES = `Referential closure. The prompt must resolve
 No process narration. Never describe Index's own activity or internal state. Forbidden: "the previous negotiation", "the negotiation stalled", "opportunities found so far", "my search", "the counterparty", "candidates reviewed", restating why a match did or did not happen, or quoting words a counterparty did or did not use. Ask about the user's goal or intent directly, never about the matching pipeline.
 - Bad: "The previous negotiation stalled because the counterparty didn't mention 'matchmaking'. Should I broaden the search?"
 - Good: "Do you want to focus on dedicated matchmakers, or also people interested in relationships more broadly?"`;
+/**
+ * Renders a "## User profile"-style block from the common profile fields shared
+ * by every preset's context. `location` is only emitted when present, so this
+ * serves the intent/negotiation shapes (no location) and the profile shape alike.
+ * @param profile - The user profile subset carried by the mode context.
+ * @returns The newline-joined profile lines, or "(no profile data)" when empty.
+ */
+function buildProfileBlock(profile) {
+    const lines = [];
+    if (profile.name)
+        lines.push(`Name: ${profile.name}`);
+    if (profile.bio)
+        lines.push(`Bio: ${profile.bio}`);
+    if (profile.location)
+        lines.push(`Location: ${profile.location}`);
+    if (profile.skills && profile.skills.length > 0)
+        lines.push(`Skills: ${profile.skills.join(", ")}`);
+    if (profile.interests && profile.interests.length > 0)
+        lines.push(`Interests: ${profile.interests.join(", ")}`);
+    return lines.length > 0 ? lines.join("\n") : "(no profile data)";
+}
 // ─── Intent preset ──────────────────────────────────────────────────────────
 const INTENT_SYSTEM_PROMPT = `You sit between a human and a discovery protocol. The user has stated an intent — what they are looking for. Your job: surface the minimum set of structured questions that help the user sharpen that intent before the protocol runs discovery on their behalf.
 
@@ -51,18 +72,7 @@ Output. Return at most 2 entries in the "questions" array. Each entry must inclu
  * @returns The assembled user message string.
  */
 function buildIntentPrompt(ctx) {
-    const profileLines = [];
-    if (ctx.userProfile.name)
-        profileLines.push(`Name: ${ctx.userProfile.name}`);
-    if (ctx.userProfile.bio)
-        profileLines.push(`Bio: ${ctx.userProfile.bio}`);
-    if (ctx.userProfile.skills && ctx.userProfile.skills.length > 0) {
-        profileLines.push(`Skills: ${ctx.userProfile.skills.join(", ")}`);
-    }
-    if (ctx.userProfile.interests && ctx.userProfile.interests.length > 0) {
-        profileLines.push(`Interests: ${ctx.userProfile.interests.join(", ")}`);
-    }
-    const profileBlock = profileLines.length > 0 ? profileLines.join("\n") : "(no profile data)";
+    const profileBlock = buildProfileBlock(ctx.userProfile);
     const summaryBlock = ctx.summary ? ctx.summary : "(no summary available)";
     return [
         "## Intent",
@@ -121,20 +131,7 @@ Output. Return at most 2 entries in the "questions" array. Each entry must inclu
  * @returns The assembled user message string.
  */
 function buildProfilePrompt(ctx) {
-    const profileLines = [];
-    if (ctx.userProfile.name)
-        profileLines.push(`Name: ${ctx.userProfile.name}`);
-    if (ctx.userProfile.bio)
-        profileLines.push(`Bio: ${ctx.userProfile.bio}`);
-    if (ctx.userProfile.location)
-        profileLines.push(`Location: ${ctx.userProfile.location}`);
-    if (ctx.userProfile.skills && ctx.userProfile.skills.length > 0) {
-        profileLines.push(`Skills: ${ctx.userProfile.skills.join(", ")}`);
-    }
-    if (ctx.userProfile.interests && ctx.userProfile.interests.length > 0) {
-        profileLines.push(`Interests: ${ctx.userProfile.interests.join(", ")}`);
-    }
-    const profileBlock = profileLines.length > 0 ? profileLines.join("\n") : "(no profile data)";
+    const profileBlock = buildProfileBlock(ctx.userProfile);
     const premisesBlock = ctx.existingPremises && ctx.existingPremises.length > 0
         ? ctx.existingPremises.map((p, i) => `${i + 1}. ${p}`).join("\n")
         : "(none)";
@@ -191,18 +188,7 @@ Output. Return at most 2 entries in the "questions" array. Each entry must inclu
  * @returns The assembled user message string.
  */
 function buildNegotiationPrompt(ctx) {
-    const profileLines = [];
-    if (ctx.userProfile.name)
-        profileLines.push(`Name: ${ctx.userProfile.name}`);
-    if (ctx.userProfile.bio)
-        profileLines.push(`Bio: ${ctx.userProfile.bio}`);
-    if (ctx.userProfile.skills && ctx.userProfile.skills.length > 0) {
-        profileLines.push(`Skills: ${ctx.userProfile.skills.join(", ")}`);
-    }
-    if (ctx.userProfile.interests && ctx.userProfile.interests.length > 0) {
-        profileLines.push(`Interests: ${ctx.userProfile.interests.join(", ")}`);
-    }
-    const profileBlock = profileLines.length > 0 ? profileLines.join("\n") : "(no profile data)";
+    const profileBlock = buildProfileBlock(ctx.userProfile);
     return [
         "## Negotiation context",
         `Community: ${ctx.indexContext}`,

package/dist/questioner/questioner.presets.js.map

@@ -1 +1 @@
-{"version":3,"file":"questioner.presets.js","sourceRoot":"/","sources":["questioner/questioner.presets.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mode presets for the QuestionerAgent. Each preset provides a system prompt\n * and a buildPrompt function that assembles the user message from a typed\n * context object. Only the `discovery` preset ships in Slice 1; others throw\n * until their implementation slices land.\n */\nimport type { QuestionMode } from \"../shared/schemas/question.schema.js\";\nimport { SYSTEM_PROMPT as DISCOVERY_SYSTEM_PROMPT, buildQuestionPrompt as buildDiscoveryPrompt } from \"../opportunity/question.prompt.js\";\n\nimport type { IntentContext, NegotiationContext, ProfileContext } from \"./questioner.types.js\";\n\n/**\n * Shared rule block appended to every questioner system prompt. Enforces that\n * the generated `prompt` resolves on its own — no demonstratives/anaphora that\n * point at people, events, or prior turns the reader cannot see — and never\n * narrates Index's own matching pipeline. Closes the referential-leak class\n * surfaced in digest audits (\"…with these builders?\", \"the previous\n * negotiation stalled because the counterparty didn't mention …\").\n */\nconst REFERENTIAL_CLOSURE_RULES = `Referential closure. The prompt must resolve entirely on its own, with no dangling references. The reader sees ONLY the question text — never the people you reviewed, the counterparty, the events on their calendar, or this conversation. Do not use demonstratives or definite anaphora that point at things the reader cannot see: \"these builders\", \"those founders\", \"these researchers\", \"these conversations\", \"this lunch\", \"the speaker\". If you reference a person, name them. If you reference a group, restate the concrete shared attribute inside the question itself (\"founders working on decentralized identity\"), never \"these founders\". Never imply a list, set, or prior exchange the reader is not currently looking at.\n- Bad: \"What kind of collaboration are you looking for with these builders?\"\n- Good: \"You're meeting people building agent infrastructure — what kind of collaboration are you looking for?\"\n\nNo process narration. Never describe Index's own activity or internal state. Forbidden: \"the previous negotiation\", \"the negotiation stalled\", \"opportunities found so far\", \"my search\", \"the counterparty\", \"candidates reviewed\", restating why a match did or did not happen, or quoting words a counterparty did or did not use. Ask about the user's goal or intent directly, never about the matching pipeline.\n- Bad: \"The previous negotiation stalled because the counterparty didn't mention 'matchmaking'. Should I broaden the search?\"\n- Good: \"Do you want to focus on dedicated matchmakers, or also people interested in relationships more broadly?\"`;\n\nexport interface QuestionerPreset {\n  /** The LLM system prompt for this mode. */\n  systemPrompt: string;\n  /** Builds the user-message string from the mode-specific context. */\n  buildPrompt: (context: unknown) => string;\n}\n\n// ─── Intent preset ──────────────────────────────────────────────────────────\n\nconst INTENT_SYSTEM_PROMPT = `You sit between a human and a discovery protocol. The user has stated an intent — what they are looking for. Your job: surface the minimum set of structured questions that help the user sharpen that intent before the protocol runs discovery on their behalf.\n\nYou may pick from two strategies. Choose contextually; mix only when each question is genuinely distinct.\n- refine_intent: ask the user to sharpen or pivot the core signal (scope, scale, specificity, direction).\n- surface_missing_detail: ask for one concrete missing input that would change which candidates surface (stage, location, timing, budget, constraints, format, …).\n\nAsk a question only when ALL of these hold:\n1. The agent cannot infer the answer from the intent text or user profile already shown.\n2. The answer would materially change which candidates surface.\n3. The question targets a different decision domain from any other question in this batch.\n\nStandalone prompt rule. Every generated \\`prompt\\` must be understandable outside the conversation where it was created. Naturally include the source intent/topic in the question text itself, using concise plain language from the intent or summary. Do not rely on \\`title\\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.\n- Bad: \"What kind of collaboration are you looking for?\"\n- Good: \"For your decentralized identity protocol-design search, what kind of collaboration are you looking for?\"\n\n${REFERENTIAL_CLOSURE_RULES}\n\nCardinality. Default one question. Add a second only when a DIFFERENT strategy genuinely complements the first and unblocks a clearly distinct decision. Never ask two questions of the same strategy unless their decision domains differ (different titles).\n\nOption construction. Each option must represent a meaningfully different outcome. Suffix the safest or most common path with \" (Recommended)\" and list it first. The description states the CONSEQUENCE of choosing the option, not its definition. 2–4 options. Never add an \"Other\" option — clients provide a free-text fallback automatically.\n\nTitle rules. ≤12 chars. Noun of the decision domain. Examples: \"Stage\", \"Timing\", \"Location\", \"Scope\", \"Budget\", \"Format\", \"Skills\", \"Collab\".\n\nAnti-patterns — never do these.\n- Don't ask procedural confirmations (\"Should I start searching?\").\n- Don't ask about hypothetical edge cases not implied by the intent.\n- Don't re-ask for facts already visible in the user profile.\n- Don't ask vague introspective questions (\"What do you really want?\").\n\nOutput. Return at most 2 entries in the \"questions\" array. Each entry must include a \"strategy\" field (one of the two values above). If the intent is already specific enough, return \"questions\": [].`;\n\n/**\n * Build the user message for the intent preset from an IntentContext.\n * @param ctx - The intent context.\n * @returns The assembled user message string.\n */\nfunction buildIntentPrompt(ctx: IntentContext): string {\n  const profileLines: string[] = [];\n  if (ctx.userProfile.name) profileLines.push(`Name: ${ctx.userProfile.name}`);\n  if (ctx.userProfile.bio) profileLines.push(`Bio: ${ctx.userProfile.bio}`);\n  if (ctx.userProfile.skills && ctx.userProfile.skills.length > 0) {\n    profileLines.push(`Skills: ${ctx.userProfile.skills.join(\", \")}`);\n  }\n  if (ctx.userProfile.interests && ctx.userProfile.interests.length > 0) {\n    profileLines.push(`Interests: ${ctx.userProfile.interests.join(\", \")}`);\n  }\n  const profileBlock = profileLines.length > 0 ? profileLines.join(\"\\n\") : \"(no profile data)\";\n\n  const summaryBlock = ctx.summary ? ctx.summary : \"(no summary available)\";\n\n  return [\n    \"## Intent\",\n    ctx.payload,\n    \"\",\n    \"## Summary\",\n    summaryBlock,\n    \"\",\n    \"## User profile\",\n    profileBlock,\n    \"\",\n    \"## Your task\",\n    \"Identify the minimum set of questions the user must answer to sharpen this intent.\",\n    \"Apply every rule from your system prompt before outputting.\",\n    \"Return an empty `questions` array if the intent is already specific enough.\",\n  ].join(\"\\n\");\n}\n\n// ─── Profile preset ─────────────────────────────────────────────────────────\n\nconst PROFILE_SYSTEM_PROMPT = `You sit between a human and a discovery protocol. The user has a profile that is incomplete. Your job: surface the minimum set of structured questions that fill the identified gaps — asking about location, skills, interests, current work, or goals — so the protocol can run better discovery on their behalf.\n\nThe user may already have premises — atomic self-descriptions they have stated. These cover specific profile domains. Do not ask about domains already addressed by existing premises. Focus only on gaps not covered by any premise.\n\nYou may pick from two strategies. Choose contextually; mix only when each question is genuinely distinct.\n- surface_missing_detail: ask for one concrete missing piece of profile data (location, current role, skills, interests, goals, availability, …).\n- refine_intent: ask the user to clarify or sharpen an existing profile signal so candidates can be ranked more accurately.\n\nAsk a question only when ALL of these hold:\n1. The answer is not already visible in the profile data shown.\n2. The answer is not already covered by an existing premise listed below the profile.\n3. The answer would meaningfully change which opportunities surface for this user.\n4. The question targets a different profile domain from any other question in this batch.\n\nStandalone prompt rule. Every generated \\`prompt\\` must be understandable outside the conversation where it was created. Naturally include the profile signal or gap being clarified in the question text itself, using concise plain language from the current profile, existing premises, or identified gaps. Do not rely on \\`title\\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.\n- Bad: \"What kind of role are you looking for?\"\n- Good: \"To improve matches from your founder/operator profile, what kind of role are you looking for?\"\n\n${REFERENTIAL_CLOSURE_RULES}\n\nCardinality. Default one question. Add a second only when a DIFFERENT strategy genuinely complements the first and unblocks a clearly distinct decision. Never ask two questions of the same strategy unless their decision domains differ.\n\nOption construction. Each option must represent a meaningfully different outcome. Suffix the safest or most common path with \" (Recommended)\" and list it first. The description states the CONSEQUENCE of choosing the option, not its definition. 2–4 options. Never add an \"Other\" option — clients provide a free-text fallback automatically.\n\nTitle rules. ≤12 chars. Noun of the profile domain. Examples: \"Location\", \"Role\", \"Skills\", \"Goals\", \"Interests\", \"Availability\", \"Stage\".\n\nAnti-patterns — never do these.\n- Don't ask about fields already filled in the profile.\n- Don't ask about information already captured in an existing premise.\n- Don't ask procedural confirmations (\"Should I update your profile?\").\n- Don't ask vague introspective questions (\"Who are you really?\").\n- Don't re-ask for facts visible anywhere in the profile data or premises shown.\n\nOutput. Return at most 2 entries in the \"questions\" array. Each entry must include a \"strategy\" field (one of the two values above). If the profile is already complete enough for discovery, return \"questions\": [].`;\n\n/**\n * Build the user message for the profile preset from a ProfileContext.\n * @param ctx - The profile context including current profile data and identified gaps.\n * @returns The assembled user message string.\n */\nfunction buildProfilePrompt(ctx: ProfileContext): string {\n  const profileLines: string[] = [];\n  if (ctx.userProfile.name) profileLines.push(`Name: ${ctx.userProfile.name}`);\n  if (ctx.userProfile.bio) profileLines.push(`Bio: ${ctx.userProfile.bio}`);\n  if (ctx.userProfile.location) profileLines.push(`Location: ${ctx.userProfile.location}`);\n  if (ctx.userProfile.skills && ctx.userProfile.skills.length > 0) {\n    profileLines.push(`Skills: ${ctx.userProfile.skills.join(\", \")}`);\n  }\n  if (ctx.userProfile.interests && ctx.userProfile.interests.length > 0) {\n    profileLines.push(`Interests: ${ctx.userProfile.interests.join(\", \")}`);\n  }\n  const profileBlock = profileLines.length > 0 ? profileLines.join(\"\\n\") : \"(no profile data)\";\n\n  const premisesBlock =\n    ctx.existingPremises && ctx.existingPremises.length > 0\n      ? ctx.existingPremises.map((p, i) => `${i + 1}. ${p}`).join(\"\\n\")\n      : \"(none)\";\n\n  const gapsBlock = ctx.gaps.length > 0 ? ctx.gaps.join(\", \") : \"(none identified)\";\n\n  const parts: string[] = [\n    \"## Current profile\",\n    profileBlock,\n    \"\",\n    \"## Existing premises\",\n    premisesBlock,\n    \"\",\n    \"## Identified gaps\",\n    gapsBlock,\n    \"\",\n  ];\n\n  parts.push(\n    \"## Your task\",\n    \"Generate the minimum set of questions needed to fill the identified gaps.\",\n    \"Apply every rule from your system prompt before outputting.\",\n    \"Return an empty `questions` array if the profile is already complete enough.\",\n  );\n\n  return parts.join(\"\\n\");\n}\n\n// ─── Negotiation preset ──────────────────────────────────────────────────────\n\nconst NEGOTIATION_SYSTEM_PROMPT = `You sit between a human and a discovery protocol. A negotiation between this user and a counterparty has ended without a clear outcome — either the turn budget was exhausted, the session timed out, or conversation stalled. Your job: surface the minimum set of structured questions that help the user provide the missing signal needed to unblock or refine the next discovery attempt on their behalf.\n\nYou may pick from three strategies. Choose contextually; mix only when each question is genuinely distinct.\n- refine_intent: help the user sharpen their underlying signal based on what the negotiation revealed (scope, scale, priority, direction).\n- surface_missing_detail: ask for one concrete piece of information that was absent and would have moved the negotiation forward (timeline, budget, format, constraints, decision criteria, …).\n- reflective_summary: mirror the key takeaway from the negotiation and ask the user to confirm, correct, or decide — useful when the conversation revealed partial signal worth locking in.\n\nAsk a question only when ALL of these hold:\n1. The answer is not already visible in the negotiation context or user profile shown.\n2. The answer would materially change how the next attempt surfaces or engages candidates.\n3. The question targets a different decision domain from any other question in this batch.\n\nStandalone prompt rule. Every generated \\`prompt\\` must be understandable outside the conversation where it was created. Naturally include the user's underlying goal or topic and the relevant community in the question text itself, in plain language drawn from their intent or profile — NOT the mechanics of the match attempt. Do not rely on \\`title\\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.\n- Bad: \"Which role is a better fit for your immediate needs?\"\n- Good: \"For your search for AI infrastructure collaborators in the AI founders community, what kind of working relationship fits your immediate needs?\"\n\n${REFERENTIAL_CLOSURE_RULES}\n\nCardinality. Default one question. Add a second only when a DIFFERENT strategy genuinely complements the first and unblocks a clearly distinct decision. Never ask two questions of the same strategy unless their decision domains differ.\n\nOption construction. Each option must represent a meaningfully different outcome. Suffix the safest or most common path with \" (Recommended)\" and list it first. The description states the CONSEQUENCE of choosing the option, not its definition. 2–4 options. Never add an \"Other\" option — clients provide a free-text fallback automatically.\n\nTitle rules. ≤12 chars. Noun of the decision domain. Examples: \"Scope\", \"Timeline\", \"Budget\", \"Priority\", \"Format\", \"Stance\", \"Criteria\".\n\nAnti-patterns — never do these.\n- Don't ask procedural confirmations (\"Should I try again?\").\n- Don't re-ask for facts already visible in the user profile.\n- Don't ask vague introspective questions (\"What do you really want?\").\n- Don't ask about hypothetical edge cases not implied by the negotiation context.\n\nOutput. Return at most 2 entries in the \"questions\" array. Each entry must include a \"strategy\" field (one of the three values above). If the context already contains enough signal to proceed, return \"questions\": [].`;\n\n/**\n * Build the user message for the negotiation preset from a NegotiationContext.\n * @param ctx - The negotiation context including counterparty hint, stall reason, and key takeaway.\n * @returns The assembled user message string.\n */\nfunction buildNegotiationPrompt(ctx: NegotiationContext): string {\n  const profileLines: string[] = [];\n  if (ctx.userProfile.name) profileLines.push(`Name: ${ctx.userProfile.name}`);\n  if (ctx.userProfile.bio) profileLines.push(`Bio: ${ctx.userProfile.bio}`);\n  if (ctx.userProfile.skills && ctx.userProfile.skills.length > 0) {\n    profileLines.push(`Skills: ${ctx.userProfile.skills.join(\", \")}`);\n  }\n  if (ctx.userProfile.interests && ctx.userProfile.interests.length > 0) {\n    profileLines.push(`Interests: ${ctx.userProfile.interests.join(\", \")}`);\n  }\n  const profileBlock = profileLines.length > 0 ? profileLines.join(\"\\n\") : \"(no profile data)\";\n\n  return [\n    \"## Negotiation context\",\n    `Community: ${ctx.indexContext}`,\n    `Counterparty: ${ctx.counterpartyHint}`,\n    `Stall reason: ${ctx.outcomeReason}`,\n    \"\",\n    \"## Key takeaway\",\n    ctx.keyTake,\n    \"\",\n    \"## User profile\",\n    profileBlock,\n    \"\",\n    \"## Your task\",\n    \"Identify the minimum set of questions the user must answer to unblock the next discovery attempt.\",\n    \"Apply every rule from your system prompt before outputting.\",\n    \"Return an empty `questions` array if the context already contains enough signal to proceed.\",\n  ].join(\"\\n\");\n}\n\nconst presets: Record<QuestionMode, QuestionerPreset> = {\n  discovery: {\n    systemPrompt: DISCOVERY_SYSTEM_PROMPT,\n    buildPrompt: (context: unknown) =>\n      buildDiscoveryPrompt(context as Parameters<typeof buildDiscoveryPrompt>[0]),\n  },\n  intent: {\n    systemPrompt: INTENT_SYSTEM_PROMPT,\n    buildPrompt: (context: unknown) => buildIntentPrompt(context as IntentContext),\n  },\n  profile: {\n    systemPrompt: PROFILE_SYSTEM_PROMPT,\n    buildPrompt: (context: unknown) => buildProfilePrompt(context as ProfileContext),\n  },\n  negotiation: {\n    systemPrompt: NEGOTIATION_SYSTEM_PROMPT,\n    buildPrompt: (context: unknown) => buildNegotiationPrompt(context as NegotiationContext),\n  },\n};\n\n/**\n * Retrieve the preset for the given mode.\n * @param mode - The question mode to look up.\n * @returns The matching preset with systemPrompt and buildPrompt.\n * @throws Error if the mode's preset is not yet implemented.\n */\nexport function getPreset(mode: QuestionMode): QuestionerPreset {\n  const preset = presets[mode];\n  if (!preset) {\n    throw new Error(`QuestionerAgent preset \"${mode}\" is not implemented yet`);\n  }\n  return preset;\n}\n"]}
+{"version":3,"file":"questioner.presets.js","sourceRoot":"/","sources":["questioner/questioner.presets.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mode presets for the QuestionerAgent. Each preset provides a system prompt\n * and a buildPrompt function that assembles the user message from a typed\n * context object. Only the `discovery` preset ships in Slice 1; others throw\n * until their implementation slices land.\n */\nimport type { QuestionMode } from \"../shared/schemas/question.schema.js\";\nimport { SYSTEM_PROMPT as DISCOVERY_SYSTEM_PROMPT, buildQuestionPrompt as buildDiscoveryPrompt } from \"../opportunity/question.prompt.js\";\n\nimport type { IntentContext, NegotiationContext, ProfileContext } from \"./questioner.types.js\";\n\n/**\n * Shared rule block appended to every questioner system prompt. Enforces that\n * the generated `prompt` resolves on its own — no demonstratives/anaphora that\n * point at people, events, or prior turns the reader cannot see — and never\n * narrates Index's own matching pipeline. Closes the referential-leak class\n * surfaced in digest audits (\"…with these builders?\", \"the previous\n * negotiation stalled because the counterparty didn't mention …\").\n */\nconst REFERENTIAL_CLOSURE_RULES = `Referential closure. The prompt must resolve entirely on its own, with no dangling references. The reader sees ONLY the question text — never the people you reviewed, the counterparty, the events on their calendar, or this conversation. Do not use demonstratives or definite anaphora that point at things the reader cannot see: \"these builders\", \"those founders\", \"these researchers\", \"these conversations\", \"this lunch\", \"the speaker\". If you reference a person, name them. If you reference a group, restate the concrete shared attribute inside the question itself (\"founders working on decentralized identity\"), never \"these founders\". Never imply a list, set, or prior exchange the reader is not currently looking at.\n- Bad: \"What kind of collaboration are you looking for with these builders?\"\n- Good: \"You're meeting people building agent infrastructure — what kind of collaboration are you looking for?\"\n\nNo process narration. Never describe Index's own activity or internal state. Forbidden: \"the previous negotiation\", \"the negotiation stalled\", \"opportunities found so far\", \"my search\", \"the counterparty\", \"candidates reviewed\", restating why a match did or did not happen, or quoting words a counterparty did or did not use. Ask about the user's goal or intent directly, never about the matching pipeline.\n- Bad: \"The previous negotiation stalled because the counterparty didn't mention 'matchmaking'. Should I broaden the search?\"\n- Good: \"Do you want to focus on dedicated matchmakers, or also people interested in relationships more broadly?\"`;\n\nexport interface QuestionerPreset {\n  /** The LLM system prompt for this mode. */\n  systemPrompt: string;\n  /** Builds the user-message string from the mode-specific context. */\n  buildPrompt: (context: unknown) => string;\n}\n\n/**\n * Renders a \"## User profile\"-style block from the common profile fields shared\n * by every preset's context. `location` is only emitted when present, so this\n * serves the intent/negotiation shapes (no location) and the profile shape alike.\n * @param profile - The user profile subset carried by the mode context.\n * @returns The newline-joined profile lines, or \"(no profile data)\" when empty.\n */\nfunction buildProfileBlock(profile: {\n  name?: string;\n  bio?: string;\n  location?: string;\n  skills?: string[];\n  interests?: string[];\n}): string {\n  const lines: string[] = [];\n  if (profile.name) lines.push(`Name: ${profile.name}`);\n  if (profile.bio) lines.push(`Bio: ${profile.bio}`);\n  if (profile.location) lines.push(`Location: ${profile.location}`);\n  if (profile.skills && profile.skills.length > 0) lines.push(`Skills: ${profile.skills.join(\", \")}`);\n  if (profile.interests && profile.interests.length > 0) lines.push(`Interests: ${profile.interests.join(\", \")}`);\n  return lines.length > 0 ? lines.join(\"\\n\") : \"(no profile data)\";\n}\n\n// ─── Intent preset ──────────────────────────────────────────────────────────\n\nconst INTENT_SYSTEM_PROMPT = `You sit between a human and a discovery protocol. The user has stated an intent — what they are looking for. Your job: surface the minimum set of structured questions that help the user sharpen that intent before the protocol runs discovery on their behalf.\n\nYou may pick from two strategies. Choose contextually; mix only when each question is genuinely distinct.\n- refine_intent: ask the user to sharpen or pivot the core signal (scope, scale, specificity, direction).\n- surface_missing_detail: ask for one concrete missing input that would change which candidates surface (stage, location, timing, budget, constraints, format, …).\n\nAsk a question only when ALL of these hold:\n1. The agent cannot infer the answer from the intent text or user profile already shown.\n2. The answer would materially change which candidates surface.\n3. The question targets a different decision domain from any other question in this batch.\n\nStandalone prompt rule. Every generated \\`prompt\\` must be understandable outside the conversation where it was created. Naturally include the source intent/topic in the question text itself, using concise plain language from the intent or summary. Do not rely on \\`title\\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.\n- Bad: \"What kind of collaboration are you looking for?\"\n- Good: \"For your decentralized identity protocol-design search, what kind of collaboration are you looking for?\"\n\n${REFERENTIAL_CLOSURE_RULES}\n\nCardinality. Default one question. Add a second only when a DIFFERENT strategy genuinely complements the first and unblocks a clearly distinct decision. Never ask two questions of the same strategy unless their decision domains differ (different titles).\n\nOption construction. Each option must represent a meaningfully different outcome. Suffix the safest or most common path with \" (Recommended)\" and list it first. The description states the CONSEQUENCE of choosing the option, not its definition. 2–4 options. Never add an \"Other\" option — clients provide a free-text fallback automatically.\n\nTitle rules. ≤12 chars. Noun of the decision domain. Examples: \"Stage\", \"Timing\", \"Location\", \"Scope\", \"Budget\", \"Format\", \"Skills\", \"Collab\".\n\nAnti-patterns — never do these.\n- Don't ask procedural confirmations (\"Should I start searching?\").\n- Don't ask about hypothetical edge cases not implied by the intent.\n- Don't re-ask for facts already visible in the user profile.\n- Don't ask vague introspective questions (\"What do you really want?\").\n\nOutput. Return at most 2 entries in the \"questions\" array. Each entry must include a \"strategy\" field (one of the two values above). If the intent is already specific enough, return \"questions\": [].`;\n\n/**\n * Build the user message for the intent preset from an IntentContext.\n * @param ctx - The intent context.\n * @returns The assembled user message string.\n */\nfunction buildIntentPrompt(ctx: IntentContext): string {\n  const profileBlock = buildProfileBlock(ctx.userProfile);\n\n  const summaryBlock = ctx.summary ? ctx.summary : \"(no summary available)\";\n\n  return [\n    \"## Intent\",\n    ctx.payload,\n    \"\",\n    \"## Summary\",\n    summaryBlock,\n    \"\",\n    \"## User profile\",\n    profileBlock,\n    \"\",\n    \"## Your task\",\n    \"Identify the minimum set of questions the user must answer to sharpen this intent.\",\n    \"Apply every rule from your system prompt before outputting.\",\n    \"Return an empty `questions` array if the intent is already specific enough.\",\n  ].join(\"\\n\");\n}\n\n// ─── Profile preset ─────────────────────────────────────────────────────────\n\nconst PROFILE_SYSTEM_PROMPT = `You sit between a human and a discovery protocol. The user has a profile that is incomplete. Your job: surface the minimum set of structured questions that fill the identified gaps — asking about location, skills, interests, current work, or goals — so the protocol can run better discovery on their behalf.\n\nThe user may already have premises — atomic self-descriptions they have stated. These cover specific profile domains. Do not ask about domains already addressed by existing premises. Focus only on gaps not covered by any premise.\n\nYou may pick from two strategies. Choose contextually; mix only when each question is genuinely distinct.\n- surface_missing_detail: ask for one concrete missing piece of profile data (location, current role, skills, interests, goals, availability, …).\n- refine_intent: ask the user to clarify or sharpen an existing profile signal so candidates can be ranked more accurately.\n\nAsk a question only when ALL of these hold:\n1. The answer is not already visible in the profile data shown.\n2. The answer is not already covered by an existing premise listed below the profile.\n3. The answer would meaningfully change which opportunities surface for this user.\n4. The question targets a different profile domain from any other question in this batch.\n\nStandalone prompt rule. Every generated \\`prompt\\` must be understandable outside the conversation where it was created. Naturally include the profile signal or gap being clarified in the question text itself, using concise plain language from the current profile, existing premises, or identified gaps. Do not rely on \\`title\\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.\n- Bad: \"What kind of role are you looking for?\"\n- Good: \"To improve matches from your founder/operator profile, what kind of role are you looking for?\"\n\n${REFERENTIAL_CLOSURE_RULES}\n\nCardinality. Default one question. Add a second only when a DIFFERENT strategy genuinely complements the first and unblocks a clearly distinct decision. Never ask two questions of the same strategy unless their decision domains differ.\n\nOption construction. Each option must represent a meaningfully different outcome. Suffix the safest or most common path with \" (Recommended)\" and list it first. The description states the CONSEQUENCE of choosing the option, not its definition. 2–4 options. Never add an \"Other\" option — clients provide a free-text fallback automatically.\n\nTitle rules. ≤12 chars. Noun of the profile domain. Examples: \"Location\", \"Role\", \"Skills\", \"Goals\", \"Interests\", \"Availability\", \"Stage\".\n\nAnti-patterns — never do these.\n- Don't ask about fields already filled in the profile.\n- Don't ask about information already captured in an existing premise.\n- Don't ask procedural confirmations (\"Should I update your profile?\").\n- Don't ask vague introspective questions (\"Who are you really?\").\n- Don't re-ask for facts visible anywhere in the profile data or premises shown.\n\nOutput. Return at most 2 entries in the \"questions\" array. Each entry must include a \"strategy\" field (one of the two values above). If the profile is already complete enough for discovery, return \"questions\": [].`;\n\n/**\n * Build the user message for the profile preset from a ProfileContext.\n * @param ctx - The profile context including current profile data and identified gaps.\n * @returns The assembled user message string.\n */\nfunction buildProfilePrompt(ctx: ProfileContext): string {\n  const profileBlock = buildProfileBlock(ctx.userProfile);\n\n  const premisesBlock =\n    ctx.existingPremises && ctx.existingPremises.length > 0\n      ? ctx.existingPremises.map((p, i) => `${i + 1}. ${p}`).join(\"\\n\")\n      : \"(none)\";\n\n  const gapsBlock = ctx.gaps.length > 0 ? ctx.gaps.join(\", \") : \"(none identified)\";\n\n  const parts: string[] = [\n    \"## Current profile\",\n    profileBlock,\n    \"\",\n    \"## Existing premises\",\n    premisesBlock,\n    \"\",\n    \"## Identified gaps\",\n    gapsBlock,\n    \"\",\n  ];\n\n  parts.push(\n    \"## Your task\",\n    \"Generate the minimum set of questions needed to fill the identified gaps.\",\n    \"Apply every rule from your system prompt before outputting.\",\n    \"Return an empty `questions` array if the profile is already complete enough.\",\n  );\n\n  return parts.join(\"\\n\");\n}\n\n// ─── Negotiation preset ──────────────────────────────────────────────────────\n\nconst NEGOTIATION_SYSTEM_PROMPT = `You sit between a human and a discovery protocol. A negotiation between this user and a counterparty has ended without a clear outcome — either the turn budget was exhausted, the session timed out, or conversation stalled. Your job: surface the minimum set of structured questions that help the user provide the missing signal needed to unblock or refine the next discovery attempt on their behalf.\n\nYou may pick from three strategies. Choose contextually; mix only when each question is genuinely distinct.\n- refine_intent: help the user sharpen their underlying signal based on what the negotiation revealed (scope, scale, priority, direction).\n- surface_missing_detail: ask for one concrete piece of information that was absent and would have moved the negotiation forward (timeline, budget, format, constraints, decision criteria, …).\n- reflective_summary: mirror the key takeaway from the negotiation and ask the user to confirm, correct, or decide — useful when the conversation revealed partial signal worth locking in.\n\nAsk a question only when ALL of these hold:\n1. The answer is not already visible in the negotiation context or user profile shown.\n2. The answer would materially change how the next attempt surfaces or engages candidates.\n3. The question targets a different decision domain from any other question in this batch.\n\nStandalone prompt rule. Every generated \\`prompt\\` must be understandable outside the conversation where it was created. Naturally include the user's underlying goal or topic and the relevant community in the question text itself, in plain language drawn from their intent or profile — NOT the mechanics of the match attempt. Do not rely on \\`title\\`, UI labels, hidden metadata, or surrounding digest/chat text to explain what the question is about.\n- Bad: \"Which role is a better fit for your immediate needs?\"\n- Good: \"For your search for AI infrastructure collaborators in the AI founders community, what kind of working relationship fits your immediate needs?\"\n\n${REFERENTIAL_CLOSURE_RULES}\n\nCardinality. Default one question. Add a second only when a DIFFERENT strategy genuinely complements the first and unblocks a clearly distinct decision. Never ask two questions of the same strategy unless their decision domains differ.\n\nOption construction. Each option must represent a meaningfully different outcome. Suffix the safest or most common path with \" (Recommended)\" and list it first. The description states the CONSEQUENCE of choosing the option, not its definition. 2–4 options. Never add an \"Other\" option — clients provide a free-text fallback automatically.\n\nTitle rules. ≤12 chars. Noun of the decision domain. Examples: \"Scope\", \"Timeline\", \"Budget\", \"Priority\", \"Format\", \"Stance\", \"Criteria\".\n\nAnti-patterns — never do these.\n- Don't ask procedural confirmations (\"Should I try again?\").\n- Don't re-ask for facts already visible in the user profile.\n- Don't ask vague introspective questions (\"What do you really want?\").\n- Don't ask about hypothetical edge cases not implied by the negotiation context.\n\nOutput. Return at most 2 entries in the \"questions\" array. Each entry must include a \"strategy\" field (one of the three values above). If the context already contains enough signal to proceed, return \"questions\": [].`;\n\n/**\n * Build the user message for the negotiation preset from a NegotiationContext.\n * @param ctx - The negotiation context including counterparty hint, stall reason, and key takeaway.\n * @returns The assembled user message string.\n */\nfunction buildNegotiationPrompt(ctx: NegotiationContext): string {\n  const profileBlock = buildProfileBlock(ctx.userProfile);\n\n  return [\n    \"## Negotiation context\",\n    `Community: ${ctx.indexContext}`,\n    `Counterparty: ${ctx.counterpartyHint}`,\n    `Stall reason: ${ctx.outcomeReason}`,\n    \"\",\n    \"## Key takeaway\",\n    ctx.keyTake,\n    \"\",\n    \"## User profile\",\n    profileBlock,\n    \"\",\n    \"## Your task\",\n    \"Identify the minimum set of questions the user must answer to unblock the next discovery attempt.\",\n    \"Apply every rule from your system prompt before outputting.\",\n    \"Return an empty `questions` array if the context already contains enough signal to proceed.\",\n  ].join(\"\\n\");\n}\n\nconst presets: Record<QuestionMode, QuestionerPreset> = {\n  discovery: {\n    systemPrompt: DISCOVERY_SYSTEM_PROMPT,\n    buildPrompt: (context: unknown) =>\n      buildDiscoveryPrompt(context as Parameters<typeof buildDiscoveryPrompt>[0]),\n  },\n  intent: {\n    systemPrompt: INTENT_SYSTEM_PROMPT,\n    buildPrompt: (context: unknown) => buildIntentPrompt(context as IntentContext),\n  },\n  profile: {\n    systemPrompt: PROFILE_SYSTEM_PROMPT,\n    buildPrompt: (context: unknown) => buildProfilePrompt(context as ProfileContext),\n  },\n  negotiation: {\n    systemPrompt: NEGOTIATION_SYSTEM_PROMPT,\n    buildPrompt: (context: unknown) => buildNegotiationPrompt(context as NegotiationContext),\n  },\n};\n\n/**\n * Retrieve the preset for the given mode.\n * @param mode - The question mode to look up.\n * @returns The matching preset with systemPrompt and buildPrompt.\n * @throws Error if the mode's preset is not yet implemented.\n */\nexport function getPreset(mode: QuestionMode): QuestionerPreset {\n  const preset = presets[mode];\n  if (!preset) {\n    throw new Error(`QuestionerAgent preset \"${mode}\" is not implemented yet`);\n  }\n  return preset;\n}\n"]}

package/dist/shared/agent/tool.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.factory.d.ts","sourceRoot":"/","sources":["shared/agent/tool.factory.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAqC,MAAM,mBAAmB,CAAC;AAelH,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxF,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAQlD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,WAAW,EACjB,kBAAkB,CAAC,EAAE,mBAAmB,kBAuMzC;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC"}
+{"version":3,"file":"tool.factory.d.ts","sourceRoot":"/","sources":["shared/agent/tool.factory.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAmE,MAAM,mBAAmB,CAAC;AAchJ,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxF,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAQlD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,WAAW,EACjB,kBAAkB,CAAC,EAAE,mBAAmB,kBAuMzC;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC"}

package/dist/shared/agent/tool.factory.js

@@ -12,8 +12,7 @@ import { IntentIndexer } from "../../intent/intent.indexer.js";
 import { NegotiationGraphFactory } from "../../negotiation/negotiation.graph.js";
 import { PremiseGraphFactory } from "../../premise/premise.graph.js";
 import { protocolLogger } from "../observability/protocol.logger.js";
-import { resolveChatContext } from "./tool.helpers.js";
-import { error, redactSensitiveFields } from "./tool.helpers.js";
+import { resolveChatContext, error, redactSensitiveFields } from "./tool.helpers.js";
 import { invokeToolRuntime, toolRuntimeErrorToResult } from "./tool.runtime.js";
 import { createProfileTools } from "../../profile/profile.tools.js";
 import { createIntentTools } from "../../intent/intent.tools.js";

package/dist/shared/agent/tool.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.factory.js","sourceRoot":"/","sources":["shared/agent/tool.factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\nimport type { HydeGraphDatabase } from \"../interfaces/database.interface.js\";\nimport { IntentGraphFactory } from \"../../intent/intent.graph.js\";\nimport { ProfileGraphFactory } from \"../../profile/profile.graph.js\";\nimport { OpportunityGraphFactory } from \"../../opportunity/opportunity.graph.js\";\nimport { HydeGraphFactory } from \"../hyde/hyde.graph.js\";\nimport { HydeGenerator } from \"../hyde/hyde.generator.js\";\nimport { LensInferrer } from \"../hyde/lens.inferrer.js\";\nimport { NetworkGraphFactory } from \"../../network/network.graph.js\";\nimport { NetworkMembershipGraphFactory } from \"../../network/membership/membership.graph.js\";\nimport { IntentNetworkGraphFactory } from \"../../network/indexer/indexer.graph.js\";\nimport { IntentIndexer } from \"../../intent/intent.indexer.js\";\nimport { NegotiationGraphFactory } from \"../../negotiation/negotiation.graph.js\";\nimport { PremiseGraphFactory } from \"../../premise/premise.graph.js\";\nimport { protocolLogger } from \"../observability/protocol.logger.js\";\n\nimport type { QuestionerEnqueueFn } from \"../../questioner/questioner.types.js\";\n\nimport { type ToolContext, type ResolvedToolContext, type ToolDeps, resolveChatContext } from \"./tool.helpers.js\";\nimport { error, redactSensitiveFields } from \"./tool.helpers.js\";\nimport { invokeToolRuntime, toolRuntimeErrorToResult } from \"./tool.runtime.js\";\nimport { createProfileTools } from \"../../profile/profile.tools.js\";\nimport { createIntentTools } from \"../../intent/intent.tools.js\";\nimport { createNetworkTools } from \"../../network/network.tools.js\";\nimport { createOpportunityTools } from \"../../opportunity/opportunity.tools.js\";\nimport { createUtilityTools } from \"./utility.tools.js\";\nimport { createIntegrationTools } from \"../../integration/integration.tools.js\";\nimport { createContactTools } from \"../../contact/contact.tools.js\";\nimport { createAgentTools } from \"../../agent/agent.tools.js\";\nimport { createNegotiationTools } from \"../../negotiation/negotiation.tools.js\";\nimport { createPremiseTools } from \"../../premise/premise.tools.js\";\n\n// Re-export types for consumers\nexport type { ToolContext, ResolvedToolContext, ProtocolDeps } from \"./tool.helpers.js\";\nexport type { ToolDeps } from \"./tool.helpers.js\";\n\nconst logger = protocolLogger(\"ChatTools\");\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// TOOL FACTORY\n// ═══════════════════════════════════════════════════════════════════════════════\n\n/**\n * Creates all chat tools bound to a specific user context.\n * Resolves user/index identity from DB at init time.\n * Tools are created fresh for each user session to ensure proper isolation.\n *\n * All external dependencies (cache, integration, queue, etc.) are provided\n * via the `deps` parameter — the protocol lib never imports concrete adapters.\n */\nexport async function createChatTools(\n  deps: ToolContext,\n  preResolvedContext?: ResolvedToolContext\n) {\n  const { database, embedder, scraper } = deps;\n\n  // ─── Resolve context from DB ───────────────────────────────────────────────\n  const resolvedContext =\n    preResolvedContext ??\n    (await resolveChatContext({\n      database,\n      userId: deps.userId,\n      networkId: deps.networkId,\n      sessionId: deps.sessionId,\n    }));\n\n  // Allow callers (e.g. MCP server, tests) to override the computed indexScope\n  // without going through a full re-resolve. The MCP path sets this via\n  // applyNetworkScopeToContext; ToolContext.indexScope provides the same override\n  // when no preResolvedContext is given.\n  if (!preResolvedContext && deps.indexScope !== undefined) {\n    resolvedContext.indexScope = deps.indexScope;\n  }\n\n  // ─── Tool wrapper ──────────────────────────────────────────────────────────\n  /**\n   * Standardized tool factory. Auto-injects resolved context and\n   * provides uniform logging / error handling for every tool.\n   */\n  function defineTool<T extends z.ZodType>(opts: {\n    name: string;\n    description: string;\n    querySchema: T;\n    handler: (input: { context: ResolvedToolContext; query: z.infer<T> }) => Promise<string>;\n  }) {\n    return tool(\n      async (query: z.infer<T>) => {\n        logger.info(`Tool: ${opts.name}`, {\n          context: { userId: resolvedContext.userId, networkId: resolvedContext.networkId },\n          query: redactSensitiveFields(query),\n        });\n        try {\n          return await invokeToolRuntime({\n            toolName: opts.name,\n            tool: { handler: async ({ context, query }) => opts.handler({ context, query: query as z.infer<T> }) },\n            context: resolvedContext,\n            query,\n          });\n        } catch (err) {\n          logger.error(`${opts.name} failed`, {\n            error: err instanceof Error ? err.message : String(err),\n          });\n          const runtimeResult = toolRuntimeErrorToResult(err);\n          if (runtimeResult) return runtimeResult;\n          const reason = err instanceof Error ? err.message : String(err);\n          return error(`Failed to execute ${opts.name}: ${reason}`);\n        }\n      },\n      { name: opts.name, description: opts.description, schema: opts.querySchema }\n    );\n  }\n\n  // ─── Compile subgraphs ─────────────────────────────────────────────────────\n\n  // Wrap questionerEnqueue to include session context when available\n  const sessionAwareEnqueue: QuestionerEnqueueFn | undefined = deps.questionerEnqueue\n    ? (input) => deps.questionerEnqueue!({\n        ...input,\n        ...(resolvedContext.sessionId && !input.conversationId ? { conversationId: resolvedContext.sessionId } : {}),\n      })\n    : undefined;\n\n  const intentGraph = new IntentGraphFactory(database, embedder, deps.intentQueue, sessionAwareEnqueue).createGraph();\n  const premiseGraph = new PremiseGraphFactory(database, embedder).createGraph();\n  const profileGraph = new ProfileGraphFactory(database, scraper, deps.enricher, sessionAwareEnqueue, premiseGraph).createGraph();\n  const hydeCache = deps.hydeCache;\n  const lensInferrer = new LensInferrer();\n  const hydeGenerator = new HydeGenerator();\n  const compiledHydeGraph = new HydeGraphFactory(\n    database as unknown as HydeGraphDatabase,\n    embedder,\n    hydeCache,\n    lensInferrer,\n    hydeGenerator\n  ).createGraph();\n  const negotiationGraph = deps.agentDispatcher\n    ? new NegotiationGraphFactory(\n        deps.negotiationDatabase,\n        deps.agentDispatcher,\n        deps.negotiationTimeoutQueue,\n        sessionAwareEnqueue,\n      ).createGraph()\n    : undefined;\n  const opportunityGraph = new OpportunityGraphFactory(\n    database,\n    embedder,\n    compiledHydeGraph,\n    undefined, // evaluator (default)\n    undefined, // queueNotification\n    negotiationGraph,\n    deps.agentDispatcher,\n    deps.queueNegotiateExisting,\n  ).createGraph();\n  const networkGraph = new NetworkGraphFactory(database).createGraph();\n  const networkMembershipGraph = new NetworkMembershipGraphFactory(database).createGraph();\n  const intentNetworkGraph = new IntentNetworkGraphFactory(database, new IntentIndexer()).createGraph();\n\n  // ─── Create context-bound databases ────────────────────────────────────────\n  // Use injected instances when provided (e.g. tests). Otherwise create from the same\n  // database used for graphs so that scope checks (e.g. ensureScopedMembership, opportunity\n  // update) use the same adapter as the rest of the tool pipeline.\n  //\n  // The systemDb's DB-level clamp uses `resolvedContext.indexScope` — the same\n  // set tools see — so the JSDoc claim that indexScope is \"the same set used\n  // to clamp the DB-level systemDb\" holds for both the MCP path (where the\n  // MCP server already populated indexScope via applyNetworkScopeToContext)\n  // and the web-chat path (where resolveChatContext clamps to [bound, personal]\n  // when networkId is set).\n  const userDb = deps.userDb ?? deps.createUserDatabase(database, resolvedContext.userId);\n  const systemDb = deps.systemDb ?? deps.createSystemDatabase(database, resolvedContext.userId, resolvedContext.indexScope, embedder);\n\n  // ─── Assemble dependencies ─────────────────────────────────────────────────\n  const cache = deps.cache;\n  const integration = deps.integration;\n  const toolDeps: ToolDeps = {\n    database,\n    userDb,\n    systemDb,\n    scraper,\n    embedder,\n    cache,\n    integration,\n    contactService: deps.contactService,\n    contactsEnabled: deps.contactsEnabled,\n    integrationImporter: deps.integrationImporter,\n    enricher: deps.enricher,\n    negotiationDatabase: deps.negotiationDatabase,\n    negotiationTimeoutQueue: deps.negotiationTimeoutQueue,\n    agentDatabase: deps.agentDatabase,\n    grantDefaultSystemPermissions: deps.grantDefaultSystemPermissions,\n    agentDispatcher: deps.agentDispatcher,\n    deliveryLedger: deps.deliveryLedger,\n    discoveryRuns: deps.discoveryRuns,\n    discoveryRunQueue: deps.discoveryRunQueue,\n    profileRuns: deps.profileRuns,\n    profileRunQueue: deps.profileRunQueue,\n    mintConnectToken: deps.mintConnectToken,\n    mintConnectLink: deps.mintConnectLink,\n    frontendUrl: deps.frontendUrl,\n    apiBaseUrl: deps.apiBaseUrl,\n    ...(deps.premiseEvents && { premiseEvents: deps.premiseEvents }),\n    ...(deps.chatSummary && { chatSummary: deps.chatSummary }),\n    ...(deps.questionGenerator && { questionGenerator: deps.questionGenerator }),\n    ...(sessionAwareEnqueue && { questionerEnqueue: sessionAwareEnqueue }),\n    ...(deps.negotiationSummary && { negotiationSummary: deps.negotiationSummary }),\n    graphs: {\n      profile: profileGraph,\n      intent: intentGraph,\n      index: networkGraph,\n      networkMembership: networkMembershipGraph,\n      intentIndex: intentNetworkGraph,\n      opportunity: opportunityGraph,\n      premise: premiseGraph,\n    },\n  };\n\n  // ─── Create domain tools ──────────────────────────────────────────────────\n  const profileTools = createProfileTools(defineTool, toolDeps);\n  const intentTools = createIntentTools(defineTool, toolDeps);\n  const networkTools = createNetworkTools(defineTool, toolDeps);\n  const opportunityTools = createOpportunityTools(defineTool, toolDeps);\n  const utilityTools = createUtilityTools(defineTool, toolDeps);\n  const contactTools = createContactTools(defineTool, toolDeps);\n  const agentTools = createAgentTools(defineTool, toolDeps);\n  const integrationTools = createIntegrationTools(defineTool, toolDeps);\n  const negotiationTools = deps.agentDispatcher\n    ? createNegotiationTools(defineTool, toolDeps)\n    : [];\n  const premiseTools = createPremiseTools(defineTool, toolDeps);\n\n  // confirm_opportunity_delivery is an OpenClaw-delivery ledger write and must not be\n  // callable from regular chat sessions.\n  const chatOpportunityToolExclusions = new Set([\n    \"confirm_opportunity_delivery\",\n  ]);\n  const opportunityToolsForChat = opportunityTools.filter(\n    (t) => !chatOpportunityToolExclusions.has((t as { name: string }).name)\n  );\n\n  return [\n    ...profileTools,\n    ...intentTools,\n    ...networkTools,\n    ...opportunityToolsForChat,\n    ...utilityTools,\n    ...integrationTools,\n    ...contactTools,\n    ...agentTools,\n    ...negotiationTools,\n    ...premiseTools,\n  ];\n}\n\n/**\n * Type for the tools array returned by createChatTools.\n */\nexport type ChatTools = Awaited<ReturnType<typeof createChatTools>>;\n"]}
+{"version":3,"file":"tool.factory.js","sourceRoot":"/","sources":["shared/agent/tool.factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\nimport type { HydeGraphDatabase } from \"../interfaces/database.interface.js\";\nimport { IntentGraphFactory } from \"../../intent/intent.graph.js\";\nimport { ProfileGraphFactory } from \"../../profile/profile.graph.js\";\nimport { OpportunityGraphFactory } from \"../../opportunity/opportunity.graph.js\";\nimport { HydeGraphFactory } from \"../hyde/hyde.graph.js\";\nimport { HydeGenerator } from \"../hyde/hyde.generator.js\";\nimport { LensInferrer } from \"../hyde/lens.inferrer.js\";\nimport { NetworkGraphFactory } from \"../../network/network.graph.js\";\nimport { NetworkMembershipGraphFactory } from \"../../network/membership/membership.graph.js\";\nimport { IntentNetworkGraphFactory } from \"../../network/indexer/indexer.graph.js\";\nimport { IntentIndexer } from \"../../intent/intent.indexer.js\";\nimport { NegotiationGraphFactory } from \"../../negotiation/negotiation.graph.js\";\nimport { PremiseGraphFactory } from \"../../premise/premise.graph.js\";\nimport { protocolLogger } from \"../observability/protocol.logger.js\";\n\nimport type { QuestionerEnqueueFn } from \"../../questioner/questioner.types.js\";\n\nimport { type ToolContext, type ResolvedToolContext, type ToolDeps, resolveChatContext, error, redactSensitiveFields } from \"./tool.helpers.js\";\nimport { invokeToolRuntime, toolRuntimeErrorToResult } from \"./tool.runtime.js\";\nimport { createProfileTools } from \"../../profile/profile.tools.js\";\nimport { createIntentTools } from \"../../intent/intent.tools.js\";\nimport { createNetworkTools } from \"../../network/network.tools.js\";\nimport { createOpportunityTools } from \"../../opportunity/opportunity.tools.js\";\nimport { createUtilityTools } from \"./utility.tools.js\";\nimport { createIntegrationTools } from \"../../integration/integration.tools.js\";\nimport { createContactTools } from \"../../contact/contact.tools.js\";\nimport { createAgentTools } from \"../../agent/agent.tools.js\";\nimport { createNegotiationTools } from \"../../negotiation/negotiation.tools.js\";\nimport { createPremiseTools } from \"../../premise/premise.tools.js\";\n\n// Re-export types for consumers\nexport type { ToolContext, ResolvedToolContext, ProtocolDeps } from \"./tool.helpers.js\";\nexport type { ToolDeps } from \"./tool.helpers.js\";\n\nconst logger = protocolLogger(\"ChatTools\");\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// TOOL FACTORY\n// ═══════════════════════════════════════════════════════════════════════════════\n\n/**\n * Creates all chat tools bound to a specific user context.\n * Resolves user/index identity from DB at init time.\n * Tools are created fresh for each user session to ensure proper isolation.\n *\n * All external dependencies (cache, integration, queue, etc.) are provided\n * via the `deps` parameter — the protocol lib never imports concrete adapters.\n */\nexport async function createChatTools(\n  deps: ToolContext,\n  preResolvedContext?: ResolvedToolContext\n) {\n  const { database, embedder, scraper } = deps;\n\n  // ─── Resolve context from DB ───────────────────────────────────────────────\n  const resolvedContext =\n    preResolvedContext ??\n    (await resolveChatContext({\n      database,\n      userId: deps.userId,\n      networkId: deps.networkId,\n      sessionId: deps.sessionId,\n    }));\n\n  // Allow callers (e.g. MCP server, tests) to override the computed indexScope\n  // without going through a full re-resolve. The MCP path sets this via\n  // applyNetworkScopeToContext; ToolContext.indexScope provides the same override\n  // when no preResolvedContext is given.\n  if (!preResolvedContext && deps.indexScope !== undefined) {\n    resolvedContext.indexScope = deps.indexScope;\n  }\n\n  // ─── Tool wrapper ──────────────────────────────────────────────────────────\n  /**\n   * Standardized tool factory. Auto-injects resolved context and\n   * provides uniform logging / error handling for every tool.\n   */\n  function defineTool<T extends z.ZodType>(opts: {\n    name: string;\n    description: string;\n    querySchema: T;\n    handler: (input: { context: ResolvedToolContext; query: z.infer<T> }) => Promise<string>;\n  }) {\n    return tool(\n      async (query: z.infer<T>) => {\n        logger.info(`Tool: ${opts.name}`, {\n          context: { userId: resolvedContext.userId, networkId: resolvedContext.networkId },\n          query: redactSensitiveFields(query),\n        });\n        try {\n          return await invokeToolRuntime({\n            toolName: opts.name,\n            tool: { handler: async ({ context, query }) => opts.handler({ context, query: query as z.infer<T> }) },\n            context: resolvedContext,\n            query,\n          });\n        } catch (err) {\n          logger.error(`${opts.name} failed`, {\n            error: err instanceof Error ? err.message : String(err),\n          });\n          const runtimeResult = toolRuntimeErrorToResult(err);\n          if (runtimeResult) return runtimeResult;\n          const reason = err instanceof Error ? err.message : String(err);\n          return error(`Failed to execute ${opts.name}: ${reason}`);\n        }\n      },\n      { name: opts.name, description: opts.description, schema: opts.querySchema }\n    );\n  }\n\n  // ─── Compile subgraphs ─────────────────────────────────────────────────────\n\n  // Wrap questionerEnqueue to include session context when available\n  const sessionAwareEnqueue: QuestionerEnqueueFn | undefined = deps.questionerEnqueue\n    ? (input) => deps.questionerEnqueue!({\n        ...input,\n        ...(resolvedContext.sessionId && !input.conversationId ? { conversationId: resolvedContext.sessionId } : {}),\n      })\n    : undefined;\n\n  const intentGraph = new IntentGraphFactory(database, embedder, deps.intentQueue, sessionAwareEnqueue).createGraph();\n  const premiseGraph = new PremiseGraphFactory(database, embedder).createGraph();\n  const profileGraph = new ProfileGraphFactory(database, scraper, deps.enricher, sessionAwareEnqueue, premiseGraph).createGraph();\n  const hydeCache = deps.hydeCache;\n  const lensInferrer = new LensInferrer();\n  const hydeGenerator = new HydeGenerator();\n  const compiledHydeGraph = new HydeGraphFactory(\n    database as unknown as HydeGraphDatabase,\n    embedder,\n    hydeCache,\n    lensInferrer,\n    hydeGenerator\n  ).createGraph();\n  const negotiationGraph = deps.agentDispatcher\n    ? new NegotiationGraphFactory(\n        deps.negotiationDatabase,\n        deps.agentDispatcher,\n        deps.negotiationTimeoutQueue,\n        sessionAwareEnqueue,\n      ).createGraph()\n    : undefined;\n  const opportunityGraph = new OpportunityGraphFactory(\n    database,\n    embedder,\n    compiledHydeGraph,\n    undefined, // evaluator (default)\n    undefined, // queueNotification\n    negotiationGraph,\n    deps.agentDispatcher,\n    deps.queueNegotiateExisting,\n  ).createGraph();\n  const networkGraph = new NetworkGraphFactory(database).createGraph();\n  const networkMembershipGraph = new NetworkMembershipGraphFactory(database).createGraph();\n  const intentNetworkGraph = new IntentNetworkGraphFactory(database, new IntentIndexer()).createGraph();\n\n  // ─── Create context-bound databases ────────────────────────────────────────\n  // Use injected instances when provided (e.g. tests). Otherwise create from the same\n  // database used for graphs so that scope checks (e.g. ensureScopedMembership, opportunity\n  // update) use the same adapter as the rest of the tool pipeline.\n  //\n  // The systemDb's DB-level clamp uses `resolvedContext.indexScope` — the same\n  // set tools see — so the JSDoc claim that indexScope is \"the same set used\n  // to clamp the DB-level systemDb\" holds for both the MCP path (where the\n  // MCP server already populated indexScope via applyNetworkScopeToContext)\n  // and the web-chat path (where resolveChatContext clamps to [bound, personal]\n  // when networkId is set).\n  const userDb = deps.userDb ?? deps.createUserDatabase(database, resolvedContext.userId);\n  const systemDb = deps.systemDb ?? deps.createSystemDatabase(database, resolvedContext.userId, resolvedContext.indexScope, embedder);\n\n  // ─── Assemble dependencies ─────────────────────────────────────────────────\n  const cache = deps.cache;\n  const integration = deps.integration;\n  const toolDeps: ToolDeps = {\n    database,\n    userDb,\n    systemDb,\n    scraper,\n    embedder,\n    cache,\n    integration,\n    contactService: deps.contactService,\n    contactsEnabled: deps.contactsEnabled,\n    integrationImporter: deps.integrationImporter,\n    enricher: deps.enricher,\n    negotiationDatabase: deps.negotiationDatabase,\n    negotiationTimeoutQueue: deps.negotiationTimeoutQueue,\n    agentDatabase: deps.agentDatabase,\n    grantDefaultSystemPermissions: deps.grantDefaultSystemPermissions,\n    agentDispatcher: deps.agentDispatcher,\n    deliveryLedger: deps.deliveryLedger,\n    discoveryRuns: deps.discoveryRuns,\n    discoveryRunQueue: deps.discoveryRunQueue,\n    profileRuns: deps.profileRuns,\n    profileRunQueue: deps.profileRunQueue,\n    mintConnectToken: deps.mintConnectToken,\n    mintConnectLink: deps.mintConnectLink,\n    frontendUrl: deps.frontendUrl,\n    apiBaseUrl: deps.apiBaseUrl,\n    ...(deps.premiseEvents && { premiseEvents: deps.premiseEvents }),\n    ...(deps.chatSummary && { chatSummary: deps.chatSummary }),\n    ...(deps.questionGenerator && { questionGenerator: deps.questionGenerator }),\n    ...(sessionAwareEnqueue && { questionerEnqueue: sessionAwareEnqueue }),\n    ...(deps.negotiationSummary && { negotiationSummary: deps.negotiationSummary }),\n    graphs: {\n      profile: profileGraph,\n      intent: intentGraph,\n      index: networkGraph,\n      networkMembership: networkMembershipGraph,\n      intentIndex: intentNetworkGraph,\n      opportunity: opportunityGraph,\n      premise: premiseGraph,\n    },\n  };\n\n  // ─── Create domain tools ──────────────────────────────────────────────────\n  const profileTools = createProfileTools(defineTool, toolDeps);\n  const intentTools = createIntentTools(defineTool, toolDeps);\n  const networkTools = createNetworkTools(defineTool, toolDeps);\n  const opportunityTools = createOpportunityTools(defineTool, toolDeps);\n  const utilityTools = createUtilityTools(defineTool, toolDeps);\n  const contactTools = createContactTools(defineTool, toolDeps);\n  const agentTools = createAgentTools(defineTool, toolDeps);\n  const integrationTools = createIntegrationTools(defineTool, toolDeps);\n  const negotiationTools = deps.agentDispatcher\n    ? createNegotiationTools(defineTool, toolDeps)\n    : [];\n  const premiseTools = createPremiseTools(defineTool, toolDeps);\n\n  // confirm_opportunity_delivery is an OpenClaw-delivery ledger write and must not be\n  // callable from regular chat sessions.\n  const chatOpportunityToolExclusions = new Set([\n    \"confirm_opportunity_delivery\",\n  ]);\n  const opportunityToolsForChat = opportunityTools.filter(\n    (t) => !chatOpportunityToolExclusions.has((t as { name: string }).name)\n  );\n\n  return [\n    ...profileTools,\n    ...intentTools,\n    ...networkTools,\n    ...opportunityToolsForChat,\n    ...utilityTools,\n    ...integrationTools,\n    ...contactTools,\n    ...agentTools,\n    ...negotiationTools,\n    ...premiseTools,\n  ];\n}\n\n/**\n * Type for the tools array returned by createChatTools.\n */\nexport type ChatTools = Awaited<ReturnType<typeof createChatTools>>;\n"]}

package/dist/shared/agent/tool.runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.runtime.d.ts","sourceRoot":"/","sources":["shared/agent/tool.runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAC3E,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAE/F,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IACzC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAmED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAoBxE;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,IAAI,EAAE,oBAAoB;aAE1B,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,iBAAiB;gBAHzB,IAAI,EAAE,oBAAoB,EAC1C,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB;CAK5C;AAkCD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;AA4ED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAapE"}
+{"version":3,"file":"tool.runtime.d.ts","sourceRoot":"/","sources":["shared/agent/tool.runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAC3E,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAE/F,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IACzC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAmED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA0BxE;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,IAAI,EAAE,oBAAoB;aAE1B,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,iBAAiB;gBAHzB,IAAI,EAAE,oBAAoB,EAC1C,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB;CAK5C;AA+CD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;AA4DD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAapE"}

package/dist/shared/agent/tool.runtime.js

@@ -66,11 +66,17 @@ export function getToolTimeoutPolicy(toolName) {
         : ASYNC_CANDIDATE_TOOLS.has(toolName)
             ? "async_candidate"
             : "bounded_slow";
-    const classDefault = classification === "fast"
-        ? parsePositiveIntEnv("MCP_TOOL_TIMEOUT_FAST_MS", FAST_TIMEOUT_MS)
-        : classification === "async_candidate"
-            ? parsePositiveIntEnv("MCP_TOOL_TIMEOUT_ASYNC_CANDIDATE_MS", ASYNC_CANDIDATE_TIMEOUT_MS)
-            : parsePositiveIntEnv("MCP_TOOL_TIMEOUT_BOUNDED_SLOW_MS", BOUNDED_SLOW_TIMEOUT_MS);
+    let classDefault;
+    switch (classification) {
+        case "fast":
+            classDefault = parsePositiveIntEnv("MCP_TOOL_TIMEOUT_FAST_MS", FAST_TIMEOUT_MS);
+            break;
+        case "async_candidate":
+            classDefault = parsePositiveIntEnv("MCP_TOOL_TIMEOUT_ASYNC_CANDIDATE_MS", ASYNC_CANDIDATE_TIMEOUT_MS);
+            break;
+        default:
+            classDefault = parsePositiveIntEnv("MCP_TOOL_TIMEOUT_BOUNDED_SLOW_MS", BOUNDED_SLOW_TIMEOUT_MS);
+    }
     const defaultMaxOutputBytes = parsePositiveIntEnv("MCP_TOOL_MAX_OUTPUT_BYTES", DEFAULT_MAX_OUTPUT_BYTES);
     return {
         class: classification,
@@ -87,6 +93,13 @@ export class ToolRuntimeError extends Error {
         this.name = "ToolRuntimeError";
     }
 }
+/** Builds the typed timeout/cancellation error shared by the abort race and catch paths. */
+function makeAbortError(timedOut, toolName, policy) {
+    const code = timedOut ? "TOOL_TIMEOUT" : "TOOL_CANCELLED";
+    return new ToolRuntimeError(code, code === "TOOL_TIMEOUT"
+        ? `Tool ${toolName} timed out after ${policy.timeoutMs}ms.`
+        : `Tool ${toolName} was cancelled before it completed.`, toolName, policy);
+}
 function combineSignals(signals) {
     const controller = new AbortController();
     const listeners = [];
@@ -136,10 +149,7 @@ async function invokeToolRuntimeInner(input) {
     let removeAbortListener = () => { };
     const abortPromise = new Promise((_, reject) => {
         const onAbort = () => {
-            const code = timedOut ? "TOOL_TIMEOUT" : "TOOL_CANCELLED";
-            reject(new ToolRuntimeError(code, code === "TOOL_TIMEOUT"
-                ? `Tool ${input.toolName} timed out after ${policy.timeoutMs}ms.`
-                : `Tool ${input.toolName} was cancelled before it completed.`, input.toolName, policy));
+            reject(makeAbortError(timedOut, input.toolName, policy));
         };
         combined.signal.addEventListener("abort", onAbort, { once: true });
         removeAbortListener = () => combined.signal.removeEventListener("abort", onAbort);
@@ -162,10 +172,7 @@ async function invokeToolRuntimeInner(input) {
         if (err instanceof ToolRuntimeError)
             throw err;
         if (combined.signal.aborted) {
-            const code = timedOut ? "TOOL_TIMEOUT" : "TOOL_CANCELLED";
-            throw new ToolRuntimeError(code, code === "TOOL_TIMEOUT"
-                ? `Tool ${input.toolName} timed out after ${policy.timeoutMs}ms.`
-                : `Tool ${input.toolName} was cancelled before it completed.`, input.toolName, policy);
+            throw makeAbortError(timedOut, input.toolName, policy);
         }
         throw err;
     }

package/dist/shared/agent/tool.runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.runtime.js","sourceRoot":"/","sources":["shared/agent/tool.runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { timed } from \"../observability/performance.js\";\nimport type { TraceEmitter } from \"../observability/request-context.js\";\nimport { requestContext } from \"../observability/request-context.js\";\n\nimport type { RawToolDefinition, ResolvedToolContext } from \"./tool.helpers.js\";\n\nexport type ToolTimeoutClass = \"fast\" | \"bounded_slow\" | \"async_candidate\";\nexport type ToolRuntimeErrorCode = \"TOOL_TIMEOUT\" | \"TOOL_CANCELLED\" | \"TOOL_OUTPUT_TOO_LARGE\";\n\nexport interface ToolTimeoutPolicy {\n  class: ToolTimeoutClass;\n  timeoutMs: number;\n  maxOutputBytes: number;\n}\n\nexport interface ToolInvocationRuntimeInput {\n  toolName: string;\n  tool: Pick<RawToolDefinition, \"handler\">;\n  context: ResolvedToolContext;\n  query: unknown;\n  signal?: AbortSignal;\n  traceEmitter?: TraceEmitter;\n  timeoutMs?: number;\n  maxOutputBytes?: number;\n}\n\nconst FAST_TIMEOUT_MS = 10_000;\nconst BOUNDED_SLOW_TIMEOUT_MS = 45_000;\nconst ASYNC_CANDIDATE_TIMEOUT_MS = 50_000;\nconst DEFAULT_MAX_OUTPUT_BYTES = 1_000_000;\n\nconst FAST_TOOLS = new Set([\n  \"record_onboarding_privacy_consent\",\n  \"create_intent_index\",\n  \"delete_intent_index\",\n  \"search_intents\",\n  \"read_networks\",\n  \"update_network\",\n  \"create_network\",\n  \"delete_network\",\n  \"create_network_membership\",\n  \"delete_network_membership\",\n  \"confirm_opportunity_delivery\",\n  \"read_docs\",\n  \"get_discovery_run\",\n  \"cancel_discovery_run\",\n  \"get_profile_run\",\n  \"cancel_profile_run\",\n  \"remove_contact\",\n  \"register_agent\",\n  \"list_agents\",\n  \"update_agent\",\n  \"delete_agent\",\n  \"grant_agent_permission\",\n  \"revoke_agent_permission\",\n  \"retract_premise\",\n]);\n\nconst ASYNC_CANDIDATE_TOOLS = new Set([\n  \"read_user_profiles\",\n  \"preview_user_profile\",\n  \"create_user_profile\",\n  \"update_user_profile\",\n  \"create_intent\",\n  \"update_intent\",\n  \"discover_opportunities\",\n  \"scrape_url\",\n  \"import_gmail_contacts\",\n  \"import_contacts\",\n  \"respond_to_negotiation\",\n  \"create_premise\",\n  \"update_premise\",\n]);\n\nfunction parsePositiveIntEnv(name: string, fallback: number): number {\n  const raw = process.env[name];\n  if (!raw) return fallback;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed > 0 && parsed <= Number.MAX_SAFE_INTEGER\n    ? parsed\n    : fallback;\n}\n\nfunction toolNameEnv(toolName: string): string {\n  return `MCP_TOOL_TIMEOUT_${toolName.toUpperCase().replace(/[^A-Z0-9]+/g, \"_\")}_MS`;\n}\n\nfunction toolNameOutputEnv(toolName: string): string {\n  return `MCP_TOOL_MAX_OUTPUT_${toolName.toUpperCase().replace(/[^A-Z0-9]+/g, \"_\")}_BYTES`;\n}\n\nexport function getToolTimeoutPolicy(toolName: string): ToolTimeoutPolicy {\n  const classification: ToolTimeoutClass = FAST_TOOLS.has(toolName)\n    ? \"fast\"\n    : ASYNC_CANDIDATE_TOOLS.has(toolName)\n      ? \"async_candidate\"\n      : \"bounded_slow\";\n\n  const classDefault = classification === \"fast\"\n    ? parsePositiveIntEnv(\"MCP_TOOL_TIMEOUT_FAST_MS\", FAST_TIMEOUT_MS)\n    : classification === \"async_candidate\"\n      ? parsePositiveIntEnv(\"MCP_TOOL_TIMEOUT_ASYNC_CANDIDATE_MS\", ASYNC_CANDIDATE_TIMEOUT_MS)\n      : parsePositiveIntEnv(\"MCP_TOOL_TIMEOUT_BOUNDED_SLOW_MS\", BOUNDED_SLOW_TIMEOUT_MS);\n\n  const defaultMaxOutputBytes = parsePositiveIntEnv(\"MCP_TOOL_MAX_OUTPUT_BYTES\", DEFAULT_MAX_OUTPUT_BYTES);\n\n  return {\n    class: classification,\n    timeoutMs: parsePositiveIntEnv(toolNameEnv(toolName), classDefault),\n    maxOutputBytes: parsePositiveIntEnv(toolNameOutputEnv(toolName), defaultMaxOutputBytes),\n  };\n}\n\nexport class ToolRuntimeError extends Error {\n  constructor(\n    public readonly code: ToolRuntimeErrorCode,\n    message: string,\n    public readonly toolName: string,\n    public readonly policy: ToolTimeoutPolicy,\n  ) {\n    super(message);\n    this.name = \"ToolRuntimeError\";\n  }\n}\n\nfunction combineSignals(signals: Array<AbortSignal | undefined>): {\n  signal: AbortSignal;\n  abort: (reason?: unknown) => void;\n  cleanup: () => void;\n} {\n  const controller = new AbortController();\n  const listeners: Array<() => void> = [];\n\n  for (const source of signals) {\n    if (!source) continue;\n    if (source.aborted) {\n      controller.abort(source.reason);\n      break;\n    }\n    const onAbort = () => {\n      if (!controller.signal.aborted) controller.abort(source.reason);\n    };\n    source.addEventListener(\"abort\", onAbort, { once: true });\n    listeners.push(() => source.removeEventListener(\"abort\", onAbort));\n  }\n\n  return {\n    signal: controller.signal,\n    abort: (reason?: unknown) => {\n      if (!controller.signal.aborted) controller.abort(reason);\n    },\n    cleanup: () => {\n      for (const cleanup of listeners) cleanup();\n    },\n  };\n}\n\nexport async function invokeToolRuntime(input: ToolInvocationRuntimeInput): Promise<string> {\n  return timed(`ToolRuntime.${input.toolName}`, () => invokeToolRuntimeInner(input));\n}\n\nasync function invokeToolRuntimeInner(input: ToolInvocationRuntimeInput): Promise<string> {\n  const basePolicy = getToolTimeoutPolicy(input.toolName);\n  const policy = {\n    ...basePolicy,\n    ...(input.timeoutMs !== undefined ? { timeoutMs: input.timeoutMs } : {}),\n    ...(input.maxOutputBytes !== undefined ? { maxOutputBytes: input.maxOutputBytes } : {}),\n  };\n  const inherited = requestContext.getStore();\n  const combined = combineSignals([input.signal, inherited?.abortSignal]);\n  let timedOut = false;\n  const timer = setTimeout(() => {\n    timedOut = true;\n    combined.abort(new Error(`Tool ${input.toolName} timed out after ${policy.timeoutMs}ms`));\n  }, policy.timeoutMs);\n\n  let removeAbortListener = () => {};\n  const abortPromise = new Promise<never>((_, reject) => {\n    const onAbort = () => {\n      const code: ToolRuntimeErrorCode = timedOut ? \"TOOL_TIMEOUT\" : \"TOOL_CANCELLED\";\n      reject(new ToolRuntimeError(\n        code,\n        code === \"TOOL_TIMEOUT\"\n          ? `Tool ${input.toolName} timed out after ${policy.timeoutMs}ms.`\n          : `Tool ${input.toolName} was cancelled before it completed.`,\n        input.toolName,\n        policy,\n      ));\n    };\n    combined.signal.addEventListener(\"abort\", onAbort, { once: true });\n    removeAbortListener = () => combined.signal.removeEventListener(\"abort\", onAbort);\n  });\n\n  try {\n    const run = () => input.tool.handler({ context: input.context, query: input.query });\n    const toolPromise = requestContext.run(\n      {\n        ...inherited,\n        abortSignal: combined.signal,\n        traceEmitter: input.traceEmitter ?? inherited?.traceEmitter,\n      },\n      run,\n    );\n    const result = await Promise.race([toolPromise, abortPromise]);\n    const outputBytes = new TextEncoder().encode(result).byteLength;\n    if (outputBytes > policy.maxOutputBytes) {\n      throw new ToolRuntimeError(\n        \"TOOL_OUTPUT_TOO_LARGE\",\n        `Tool ${input.toolName} returned ${outputBytes} bytes, exceeding the ${policy.maxOutputBytes} byte limit.`,\n        input.toolName,\n        policy,\n      );\n    }\n    return result;\n  } catch (err) {\n    if (err instanceof ToolRuntimeError) throw err;\n    if (combined.signal.aborted) {\n      const code: ToolRuntimeErrorCode = timedOut ? \"TOOL_TIMEOUT\" : \"TOOL_CANCELLED\";\n      throw new ToolRuntimeError(\n        code,\n        code === \"TOOL_TIMEOUT\"\n          ? `Tool ${input.toolName} timed out after ${policy.timeoutMs}ms.`\n          : `Tool ${input.toolName} was cancelled before it completed.`,\n        input.toolName,\n        policy,\n      );\n    }\n    throw err;\n  } finally {\n    clearTimeout(timer);\n    removeAbortListener();\n    combined.cleanup();\n  }\n}\n\nexport function toolRuntimeErrorToResult(err: unknown): string | null {\n  if (!(err instanceof ToolRuntimeError)) return null;\n  return JSON.stringify({\n    success: false,\n    code: err.code,\n    error: err.message,\n    data: {\n      tool: err.toolName,\n      timeoutClass: err.policy.class,\n      timeoutMs: err.policy.timeoutMs,\n      maxOutputBytes: err.policy.maxOutputBytes,\n    },\n  });\n}\n"]}
+{"version":3,"file":"tool.runtime.js","sourceRoot":"/","sources":["shared/agent/tool.runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { timed } from \"../observability/performance.js\";\nimport type { TraceEmitter } from \"../observability/request-context.js\";\nimport { requestContext } from \"../observability/request-context.js\";\n\nimport type { RawToolDefinition, ResolvedToolContext } from \"./tool.helpers.js\";\n\nexport type ToolTimeoutClass = \"fast\" | \"bounded_slow\" | \"async_candidate\";\nexport type ToolRuntimeErrorCode = \"TOOL_TIMEOUT\" | \"TOOL_CANCELLED\" | \"TOOL_OUTPUT_TOO_LARGE\";\n\nexport interface ToolTimeoutPolicy {\n  class: ToolTimeoutClass;\n  timeoutMs: number;\n  maxOutputBytes: number;\n}\n\nexport interface ToolInvocationRuntimeInput {\n  toolName: string;\n  tool: Pick<RawToolDefinition, \"handler\">;\n  context: ResolvedToolContext;\n  query: unknown;\n  signal?: AbortSignal;\n  traceEmitter?: TraceEmitter;\n  timeoutMs?: number;\n  maxOutputBytes?: number;\n}\n\nconst FAST_TIMEOUT_MS = 10_000;\nconst BOUNDED_SLOW_TIMEOUT_MS = 45_000;\nconst ASYNC_CANDIDATE_TIMEOUT_MS = 50_000;\nconst DEFAULT_MAX_OUTPUT_BYTES = 1_000_000;\n\nconst FAST_TOOLS = new Set([\n  \"record_onboarding_privacy_consent\",\n  \"create_intent_index\",\n  \"delete_intent_index\",\n  \"search_intents\",\n  \"read_networks\",\n  \"update_network\",\n  \"create_network\",\n  \"delete_network\",\n  \"create_network_membership\",\n  \"delete_network_membership\",\n  \"confirm_opportunity_delivery\",\n  \"read_docs\",\n  \"get_discovery_run\",\n  \"cancel_discovery_run\",\n  \"get_profile_run\",\n  \"cancel_profile_run\",\n  \"remove_contact\",\n  \"register_agent\",\n  \"list_agents\",\n  \"update_agent\",\n  \"delete_agent\",\n  \"grant_agent_permission\",\n  \"revoke_agent_permission\",\n  \"retract_premise\",\n]);\n\nconst ASYNC_CANDIDATE_TOOLS = new Set([\n  \"read_user_profiles\",\n  \"preview_user_profile\",\n  \"create_user_profile\",\n  \"update_user_profile\",\n  \"create_intent\",\n  \"update_intent\",\n  \"discover_opportunities\",\n  \"scrape_url\",\n  \"import_gmail_contacts\",\n  \"import_contacts\",\n  \"respond_to_negotiation\",\n  \"create_premise\",\n  \"update_premise\",\n]);\n\nfunction parsePositiveIntEnv(name: string, fallback: number): number {\n  const raw = process.env[name];\n  if (!raw) return fallback;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed > 0 && parsed <= Number.MAX_SAFE_INTEGER\n    ? parsed\n    : fallback;\n}\n\nfunction toolNameEnv(toolName: string): string {\n  return `MCP_TOOL_TIMEOUT_${toolName.toUpperCase().replace(/[^A-Z0-9]+/g, \"_\")}_MS`;\n}\n\nfunction toolNameOutputEnv(toolName: string): string {\n  return `MCP_TOOL_MAX_OUTPUT_${toolName.toUpperCase().replace(/[^A-Z0-9]+/g, \"_\")}_BYTES`;\n}\n\nexport function getToolTimeoutPolicy(toolName: string): ToolTimeoutPolicy {\n  const classification: ToolTimeoutClass = FAST_TOOLS.has(toolName)\n    ? \"fast\"\n    : ASYNC_CANDIDATE_TOOLS.has(toolName)\n      ? \"async_candidate\"\n      : \"bounded_slow\";\n\n  let classDefault: number;\n  switch (classification) {\n    case \"fast\":\n      classDefault = parsePositiveIntEnv(\"MCP_TOOL_TIMEOUT_FAST_MS\", FAST_TIMEOUT_MS);\n      break;\n    case \"async_candidate\":\n      classDefault = parsePositiveIntEnv(\"MCP_TOOL_TIMEOUT_ASYNC_CANDIDATE_MS\", ASYNC_CANDIDATE_TIMEOUT_MS);\n      break;\n    default:\n      classDefault = parsePositiveIntEnv(\"MCP_TOOL_TIMEOUT_BOUNDED_SLOW_MS\", BOUNDED_SLOW_TIMEOUT_MS);\n  }\n\n  const defaultMaxOutputBytes = parsePositiveIntEnv(\"MCP_TOOL_MAX_OUTPUT_BYTES\", DEFAULT_MAX_OUTPUT_BYTES);\n\n  return {\n    class: classification,\n    timeoutMs: parsePositiveIntEnv(toolNameEnv(toolName), classDefault),\n    maxOutputBytes: parsePositiveIntEnv(toolNameOutputEnv(toolName), defaultMaxOutputBytes),\n  };\n}\n\nexport class ToolRuntimeError extends Error {\n  constructor(\n    public readonly code: ToolRuntimeErrorCode,\n    message: string,\n    public readonly toolName: string,\n    public readonly policy: ToolTimeoutPolicy,\n  ) {\n    super(message);\n    this.name = \"ToolRuntimeError\";\n  }\n}\n\n/** Builds the typed timeout/cancellation error shared by the abort race and catch paths. */\nfunction makeAbortError(timedOut: boolean, toolName: string, policy: ToolTimeoutPolicy): ToolRuntimeError {\n  const code: ToolRuntimeErrorCode = timedOut ? \"TOOL_TIMEOUT\" : \"TOOL_CANCELLED\";\n  return new ToolRuntimeError(\n    code,\n    code === \"TOOL_TIMEOUT\"\n      ? `Tool ${toolName} timed out after ${policy.timeoutMs}ms.`\n      : `Tool ${toolName} was cancelled before it completed.`,\n    toolName,\n    policy,\n  );\n}\n\nfunction combineSignals(signals: Array<AbortSignal | undefined>): {\n  signal: AbortSignal;\n  abort: (reason?: unknown) => void;\n  cleanup: () => void;\n} {\n  const controller = new AbortController();\n  const listeners: Array<() => void> = [];\n\n  for (const source of signals) {\n    if (!source) continue;\n    if (source.aborted) {\n      controller.abort(source.reason);\n      break;\n    }\n    const onAbort = () => {\n      if (!controller.signal.aborted) controller.abort(source.reason);\n    };\n    source.addEventListener(\"abort\", onAbort, { once: true });\n    listeners.push(() => source.removeEventListener(\"abort\", onAbort));\n  }\n\n  return {\n    signal: controller.signal,\n    abort: (reason?: unknown) => {\n      if (!controller.signal.aborted) controller.abort(reason);\n    },\n    cleanup: () => {\n      for (const cleanup of listeners) cleanup();\n    },\n  };\n}\n\nexport async function invokeToolRuntime(input: ToolInvocationRuntimeInput): Promise<string> {\n  return timed(`ToolRuntime.${input.toolName}`, () => invokeToolRuntimeInner(input));\n}\n\nasync function invokeToolRuntimeInner(input: ToolInvocationRuntimeInput): Promise<string> {\n  const basePolicy = getToolTimeoutPolicy(input.toolName);\n  const policy = {\n    ...basePolicy,\n    ...(input.timeoutMs !== undefined ? { timeoutMs: input.timeoutMs } : {}),\n    ...(input.maxOutputBytes !== undefined ? { maxOutputBytes: input.maxOutputBytes } : {}),\n  };\n  const inherited = requestContext.getStore();\n  const combined = combineSignals([input.signal, inherited?.abortSignal]);\n  let timedOut = false;\n  const timer = setTimeout(() => {\n    timedOut = true;\n    combined.abort(new Error(`Tool ${input.toolName} timed out after ${policy.timeoutMs}ms`));\n  }, policy.timeoutMs);\n\n  let removeAbortListener = () => {};\n  const abortPromise = new Promise<never>((_, reject) => {\n    const onAbort = () => {\n      reject(makeAbortError(timedOut, input.toolName, policy));\n    };\n    combined.signal.addEventListener(\"abort\", onAbort, { once: true });\n    removeAbortListener = () => combined.signal.removeEventListener(\"abort\", onAbort);\n  });\n\n  try {\n    const run = () => input.tool.handler({ context: input.context, query: input.query });\n    const toolPromise = requestContext.run(\n      {\n        ...inherited,\n        abortSignal: combined.signal,\n        traceEmitter: input.traceEmitter ?? inherited?.traceEmitter,\n      },\n      run,\n    );\n    const result = await Promise.race([toolPromise, abortPromise]);\n    const outputBytes = new TextEncoder().encode(result).byteLength;\n    if (outputBytes > policy.maxOutputBytes) {\n      throw new ToolRuntimeError(\n        \"TOOL_OUTPUT_TOO_LARGE\",\n        `Tool ${input.toolName} returned ${outputBytes} bytes, exceeding the ${policy.maxOutputBytes} byte limit.`,\n        input.toolName,\n        policy,\n      );\n    }\n    return result;\n  } catch (err) {\n    if (err instanceof ToolRuntimeError) throw err;\n    if (combined.signal.aborted) {\n      throw makeAbortError(timedOut, input.toolName, policy);\n    }\n    throw err;\n  } finally {\n    clearTimeout(timer);\n    removeAbortListener();\n    combined.cleanup();\n  }\n}\n\nexport function toolRuntimeErrorToResult(err: unknown): string | null {\n  if (!(err instanceof ToolRuntimeError)) return null;\n  return JSON.stringify({\n    success: false,\n    code: err.code,\n    error: err.message,\n    data: {\n      tool: err.toolName,\n      timeoutClass: err.policy.class,\n      timeoutMs: err.policy.timeoutMs,\n      maxOutputBytes: err.policy.maxOutputBytes,\n    },\n  });\n}\n"]}

package/dist/shared/hyde/hyde.graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hyde.graph.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAKlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAyBzE;;;GAGG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;gBAJT,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,aAAa;IAGlC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoOZ"}
+{"version":3,"file":"hyde.graph.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAKlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAyBzE;;;GAGG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;gBAJT,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,aAAa;IAGlC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqOZ"}

package/dist/shared/hyde/hyde.graph.js

@@ -54,8 +54,9 @@ export class HydeGraphFactory {
                         profileContext,
                         maxLenses,
                     });
-                    agentTimingsAccum.push({ name: 'lens.inferrer', durationMs: Date.now() - inferrerStart });
-                    _traceEmitterLens?.({ type: "agent_end", name: "lens-inferrer", durationMs: Date.now() - inferrerStart, summary: result.lenses.length > 0 ? `Inferred ${result.lenses.length} lens(es)` : "lens-inferrer completed" });
+                    const _inferrerDuration = Date.now() - inferrerStart;
+                    agentTimingsAccum.push({ name: 'lens.inferrer', durationMs: _inferrerDuration });
+                    _traceEmitterLens?.({ type: "agent_end", name: "lens-inferrer", durationMs: _inferrerDuration, summary: result.lenses.length > 0 ? `Inferred ${result.lenses.length} lens(es)` : "lens-inferrer completed" });
                     logger.verbose('Lenses inferred', {
                         count: result.lenses.length,
                         lenses: result.lenses.map(l => ({ label: l.label, corpus: l.corpus })),

package/dist/shared/hyde/hyde.graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"hyde.graph.js","sourceRoot":"/","sources":["shared/hyde/hyde.graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,cAAc,EAA0B,MAAM,iBAAiB,CAAC;AAMzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAGrE,MAAM,MAAM,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;AAElD,kFAAkF;AAClF,SAAS,QAAQ,CAAC,KAAa,EAAE,MAAe;IAC9C,MAAM,KAAK,GAAG,MAAM;QAClB,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,MAAM,EAAE;QAC3C,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,2CAA2C;AAC3C,SAAS,QAAQ,CACf,UAAkB,EAClB,QAA4B,EAC5B,UAAkB,EAClB,IAAY,EACZ,MAAe;IAEf,MAAM,SAAS,GACb,QAAQ,IAAI,KAAK,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACxF,OAAO,QAAQ,UAAU,IAAI,SAAS,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAC3B,YACU,QAA2B,EAC3B,QAA4B,EAC5B,KAAgB,EAChB,QAAsB,EACtB,SAAwB;QAJxB,aAAQ,GAAR,QAAQ,CAAmB;QAC3B,aAAQ,GAAR,QAAQ,CAAoB;QAC5B,UAAK,GAAL,KAAK,CAAW;QAChB,aAAQ,GAAR,QAAQ,CAAc;QACtB,cAAS,GAAT,SAAS,CAAe;IAC/B,CAAC;IAEJ,WAAW;QACT,MAAM,IAAI,GAAG,IAAI,CAAC;QAElB,wEAAwE;QACxE,MAAM,eAAe,GAAG,KAAK,EAAE,KAAkC,EAAE,EAAE;YACnE,OAAO,KAAK,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;gBAC/C,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;gBAExD,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,gBAAgB,EAAE,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;gBAEjH,MAAM,iBAAiB,GAAqB,EAAE,CAAC;gBAE/C,IAAI,CAAC;oBACH,MAAM,iBAAiB,GAAG,cAAc,CAAC,QAAQ,EAAE,EAAE,YAAY,CAAC;oBAClE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBACjC,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;oBACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;wBACvC,UAAU;wBACV,cAAc;wBACd,SAAS;qBACV,CAAC,CAAC;oBACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;oBAC1F,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,yBAAyB,EAAE,CAAC,CAAC;oBAEvN,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE;wBAChC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;wBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;qBACvE,CAAC,CAAC;oBAEH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;gBACpE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC/D,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;gBACzD,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,8EAA8E;QAC9E,MAAM,cAAc,GAAG,KAAK,EAAE,KAAkC,EAAE,EAAE;YAClE,OAAO,KAAK,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;gBAC9C,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;gBAE5E,IAAI,eAAe,EAAE,CAAC;oBACpB,MAAM,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;oBACpD,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;gBAC/B,CAAC;gBAED,MAAM,MAAM,GAAsC,EAAE,CAAC;gBAErD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,IAAI,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;oBAE7F,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,GAAG,CAAC,CAAC;oBAC/D,IAAI,SAAS,EAAE,QAAQ,IAAI,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;wBAC3D,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;wBAClD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;wBAC/B,SAAS;oBACX,CAAC;oBAED,kDAAkD;oBAClD,IAAI,QAAQ,EAAE,CAAC;wBACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAChD,UAAU,EACV,QAAQ,EACR,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAClC,CAAC;wBACF,IAAI,MAAM,EAAE,CAAC;4BACX,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;4BAC/C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG;gCACnB,IAAI,EAAE,IAAI,CAAC,KAAK;gCAChB,YAAY,EAAE,MAAM,CAAC,YAAsC;gCAC3D,QAAQ,EAAE,MAAM,CAAC,QAAQ;gCACzB,aAAa,EAAE,MAAM,CAAC,aAAa;6BACpC,CAAC;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE;oBACjC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;oBACjC,SAAS,EAAE,MAAM,CAAC,MAAM;iBACzB,CAAC,CAAC;gBACH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,gEAAgE;QAChE,MAAM,cAAc,GAAG,CAAC,KAAkC,EAAU,EAAE;YACpE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC3E,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;YACzD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAEF,+DAA+D;QAC/D,MAAM,mBAAmB,GAAG,KAAK,EAAE,KAAkC,EAAE,EAAE;YACvE,OAAO,KAAK,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;gBACnD,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;gBACpD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBAE9D,MAAM,CAAC,OAAO,CAAC,2BAA2B,EAAE;oBAC1C,KAAK,EAAE,OAAO,CAAC,MAAM;oBACrB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;iBAClC,CAAC,CAAC;gBAEH,MAAM,iBAAiB,GAAqB,EAAE,CAAC;gBAC/C,MAAM,SAAS,GAAsC,EAAE,CAAC;gBAExD,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;oBACzB,MAAM,iBAAiB,GAAG,cAAc,CAAC,QAAQ,EAAE,EAAE,YAAY,CAAC;oBAClE,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAClC,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;oBACrE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;wBACxC,UAAU;wBACV,IAAI,EAAE,IAAI,CAAC,KAAK;wBAChB,MAAM,EAAE,IAAI,CAAC,MAAM;qBACpB,CAAC,CAAC;oBACH,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC;oBAClD,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;oBAC9E,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACnI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG;wBACtB,IAAI,EAAE,IAAI,CAAC,KAAK;wBAChB,YAAY,EAAE,IAAI,CAAC,MAAM;wBACzB,QAAQ,EAAE,GAAG,CAAC,IAAI;wBAClB,aAAa,EAAE,EAAE;qBAClB,CAAC;gBACJ,CAAC,CAAC,CACH,CAAC;gBAEF,OAAO,EAAE,aAAa,EAAE,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE,GAAG,SAAS,EAAE,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;YACtG,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,uEAAuE;QACvE,MAAM,SAAS,GAAG,KAAK,EAAE,KAAkC,EAAE,EAAE;YAC7D,OAAO,KAAK,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;gBACzC,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;gBAChC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBAC9C,MAAM,OAAO,GAAgD,EAAE,CAAC;gBAChE,MAAM,OAAO,GAAsC,EAAE,CAAC;gBACtD,MAAM,cAAc,GAA6B,EAAE,CAAC;gBAEpD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;oBAC/B,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;oBACjC,IAAI,CAAC,GAAG;wBAAE,SAAS;oBACnB,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;wBAC9B,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;wBACrB,cAAc,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC;oBAC5C,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;gBAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;oBACjE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACjD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC,CAAC;oBAC1F,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;wBACjD,CAAC,CAAE,UAAyB;wBAC5B,CAAC,CAAC,CAAC,UAAsB,CAAC,CAAC;oBAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBACxC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;wBAClC,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;wBAC1C,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;wBACtD,cAAc,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;oBACpC,CAAC;gBACH,CAAC;gBAED,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;YACpD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,wEAAwE;QACxE,MAAM,gBAAgB,GAAG,KAAK,EAAE,KAAkC,EAAE,EAAE;YACpE,OAAO,KAAK,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;gBAChD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;gBAElE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC/C,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;oBACjC,IAAI,CAAC,GAAG;wBAAE,SAAS;oBAEnB,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,IAAI,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;oBAC7F,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,sBAAsB,EAAE,CAAC,CAAC;oBAEhE,oDAAoD;oBACpD,IAAI,QAAQ,EAAE,CAAC;wBACb,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;4BACnC,UAAU;4BACV,QAAQ;4BACR,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC;4BAC3C,YAAY,EAAE,GAAG,CAAC,YAAY;4BAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;4BACtB,aAAa,EAAE,GAAG,CAAC,aAAa;yBACjC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE;oBAC/B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM;iBACzC,CAAC,CAAC;gBACH,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC;aAC5C,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC;aACxC,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC;aACtC,OAAO,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;aAChD,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;aAC3B,OAAO,CAAC,eAAe,EAAE,gBAAgB,CAAC;aAC1C,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC;aAC9B,OAAO,CAAC,cAAc,EAAE,aAAa,CAAC;aACtC,mBAAmB,CAAC,aAAa,EAAE,cAAc,EAAE;YAClD,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,OAAO;SACd,CAAC;aACD,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC;aACpC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC;aACjC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAEjC,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;CACF","sourcesContent":["/**\n * HyDE Graph: cache-aware hypothetical document generation with lens inference.\n *\n * Flow: infer_lenses → check_cache → (generate_missing if needed) → embed → cache_results.\n * Constructor injects Database, Embedder, Cache, LensInferrer, HydeGenerator.\n */\n\nimport { StateGraph, START, END } from '@langchain/langgraph';\nimport { createHash } from 'crypto';\n\nimport { getAbortSignalConfig } from '../agent/model-signal.js';\nimport { HydeGraphState, type HydeDocumentState } from './hyde.state.js';\nimport { LensInferrer } from './lens.inferrer.js';\nimport { HydeGenerator } from './hyde.generator.js';\nimport type { HydeGraphDatabase } from '../interfaces/database.interface.js';\nimport type { EmbeddingGenerator } from '../interfaces/embedder.interface.js';\nimport type { HydeCache } from '../interfaces/cache.interface.js';\nimport { HYDE_DEFAULT_CACHE_TTL } from './hyde.strategies.js';\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { timed } from '../observability/performance.js';\nimport { requestContext } from \"../observability/request-context.js\";\nimport type { DebugMetaAgent } from '../../chat/chat-streaming.types.js';\n\nconst logger = protocolLogger(\"HyDEGraphFactory\");\n\n/** Hash a lens label (+ optional corpus) to a short key for cache/DB indexing. */\nfunction lensHash(label: string, corpus?: string): string {\n  const input = corpus\n    ? `${label.toLowerCase().trim()}:${corpus}`\n    : label.toLowerCase().trim();\n  return createHash('sha256').update(input).digest('hex').slice(0, 16);\n}\n\n/** Build cache key for a specific lens. */\nfunction cacheKey(\n  sourceType: string,\n  sourceId: string | undefined,\n  sourceText: string,\n  lens: string,\n  corpus?: string,\n): string {\n  const entityKey =\n    sourceId ?? `q:${createHash('sha256').update(sourceText).digest('hex').slice(0, 16)}`;\n  return `hyde:${sourceType}:${entityKey}:${lensHash(lens, corpus)}`;\n}\n\n/**\n * Factory for the HyDE generation graph.\n * Injects Database, Embedder, Cache, LensInferrer, and HydeGenerator.\n */\nexport class HydeGraphFactory {\n  constructor(\n    private database: HydeGraphDatabase,\n    private embedder: EmbeddingGenerator,\n    private cache: HydeCache,\n    private inferrer: LensInferrer,\n    private generator: HydeGenerator,\n  ) {}\n\n  createGraph() {\n    const self = this;\n\n    /** Node 1: Infer lenses from source text + optional profile context. */\n    const inferLensesNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.inferLenses\", async () => {\n        const { sourceText, profileContext, maxLenses } = state;\n\n        logger.verbose('Inferring lenses', { sourceTextLength: sourceText.length, hasProfileContext: !!profileContext });\n\n        const agentTimingsAccum: DebugMetaAgent[] = [];\n\n        try {\n          const _traceEmitterLens = requestContext.getStore()?.traceEmitter;\n          const inferrerStart = Date.now();\n          _traceEmitterLens?.({ type: \"agent_start\", name: \"lens-inferrer\" });\n          const result = await self.inferrer.infer({\n            sourceText,\n            profileContext,\n            maxLenses,\n          });\n          agentTimingsAccum.push({ name: 'lens.inferrer', durationMs: Date.now() - inferrerStart });\n          _traceEmitterLens?.({ type: \"agent_end\", name: \"lens-inferrer\", durationMs: Date.now() - inferrerStart, summary: result.lenses.length > 0 ? `Inferred ${result.lenses.length} lens(es)` : \"lens-inferrer completed\" });\n\n          logger.verbose('Lenses inferred', {\n            count: result.lenses.length,\n            lenses: result.lenses.map(l => ({ label: l.label, corpus: l.corpus })),\n          });\n\n          return { lenses: result.lenses, agentTimings: agentTimingsAccum };\n        } catch (error) {\n          logger.error('Lens inference failed in graph node', { error });\n          return { lenses: [], agentTimings: agentTimingsAccum };\n        }\n      });\n    };\n\n    /** Node 2: Check cache/DB for existing HyDE docs matching inferred lenses. */\n    const checkCacheNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.checkCache\", async () => {\n        const { sourceType, sourceId, sourceText, lenses, forceRegenerate } = state;\n\n        if (forceRegenerate) {\n          logger.verbose('Force regenerate - skipping cache');\n          return { hydeDocuments: {} };\n        }\n\n        const cached: Record<string, HydeDocumentState> = {};\n\n        for (const lens of lenses) {\n          const key = cacheKey(sourceType, sourceId ?? undefined, sourceText, lens.label, lens.corpus);\n\n          const fromCache = await self.cache.get<HydeDocumentState>(key);\n          if (fromCache?.hydeText && fromCache.hydeEmbedding?.length) {\n            logger.verbose('Cache hit', { lens: lens.label });\n            cached[lens.label] = fromCache;\n            continue;\n          }\n\n          // For entity sources, check DB for persisted docs\n          if (sourceId) {\n            const fromDb = await self.database.getHydeDocument(\n              sourceType,\n              sourceId,\n              lensHash(lens.label, lens.corpus),\n            );\n            if (fromDb) {\n              logger.verbose('DB hit', { lens: lens.label });\n              cached[lens.label] = {\n                lens: lens.label,\n                targetCorpus: fromDb.targetCorpus as 'profiles' | 'intents',\n                hydeText: fromDb.hydeText,\n                hydeEmbedding: fromDb.hydeEmbedding,\n              };\n            }\n          }\n        }\n\n        logger.verbose('Check cache done', {\n          found: Object.keys(cached).length,\n          requested: lenses.length,\n        });\n        return { hydeDocuments: cached };\n      });\n    };\n\n    /** Conditional: decide whether to generate or skip to embed. */\n    const shouldGenerate = (state: typeof HydeGraphState.State): string => {\n      const { lenses, hydeDocuments } = state;\n      const missing = lenses.filter((l) => !hydeDocuments[l.label]);\n      if (missing.length > 0) {\n        logger.verbose('Need to generate', { missing: missing.map(l => l.label) });\n        return 'generate';\n      }\n      logger.verbose('All lenses cached, skipping generation');\n      return 'skip';\n    };\n\n    /** Node 3: Generate HyDE documents for lenses not in cache. */\n    const generateMissingNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.generateMissing\", async () => {\n        const { sourceText, lenses, hydeDocuments } = state;\n        const missing = lenses.filter((l) => !hydeDocuments[l.label]);\n\n        logger.verbose('Generating HyDE documents', {\n          count: missing.length,\n          lenses: missing.map(l => l.label),\n        });\n\n        const agentTimingsAccum: DebugMetaAgent[] = [];\n        const generated: Record<string, HydeDocumentState> = {};\n\n        await Promise.all(\n          missing.map(async (lens) => {\n            const _traceEmitterHyde = requestContext.getStore()?.traceEmitter;\n            const generatorStart = Date.now();\n            _traceEmitterHyde?.({ type: \"agent_start\", name: \"hyde-generator\" });\n            const out = await self.generator.generate({\n              sourceText,\n              lens: lens.label,\n              corpus: lens.corpus,\n            });\n            const _hydeDuration = Date.now() - generatorStart;\n            agentTimingsAccum.push({ name: 'hyde.generator', durationMs: _hydeDuration });\n            _traceEmitterHyde?.({ type: \"agent_end\", name: \"hyde-generator\", durationMs: _hydeDuration, summary: `Generated: ${lens.label}` });\n            generated[lens.label] = {\n              lens: lens.label,\n              targetCorpus: lens.corpus,\n              hydeText: out.text,\n              hydeEmbedding: [],\n            };\n          })\n        );\n\n        return { hydeDocuments: { ...state.hydeDocuments, ...generated }, agentTimings: agentTimingsAccum };\n      });\n    };\n\n    /** Node 4: Embed all HyDE documents that don't have embeddings yet. */\n    const embedNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.embed\", async () => {\n        const { hydeDocuments } = state;\n        const lensLabels = Object.keys(hydeDocuments);\n        const toEmbed: { label: string; doc: HydeDocumentState }[] = [];\n        const updated: Record<string, HydeDocumentState> = {};\n        const hydeEmbeddings: Record<string, number[]> = {};\n\n        for (const label of lensLabels) {\n          const doc = hydeDocuments[label];\n          if (!doc) continue;\n          if (doc.hydeEmbedding?.length) {\n            updated[label] = doc;\n            hydeEmbeddings[label] = doc.hydeEmbedding;\n          } else {\n            toEmbed.push({ label, doc });\n          }\n        }\n\n        if (toEmbed.length > 0) {\n          logger.verbose('Embedding documents', { count: toEmbed.length });\n          const texts = toEmbed.map((t) => t.doc.hydeText);\n          const embeddings = await self.embedder.generate(texts, undefined, getAbortSignalConfig());\n          const embeddingArray = Array.isArray(embeddings[0])\n            ? (embeddings as number[][])\n            : [embeddings as number[]];\n\n          for (let i = 0; i < toEmbed.length; i++) {\n            const { label, doc } = toEmbed[i];\n            const embedding = embeddingArray[i] ?? [];\n            updated[label] = { ...doc, hydeEmbedding: embedding };\n            hydeEmbeddings[label] = embedding;\n          }\n        }\n\n        return { hydeDocuments: updated, hydeEmbeddings };\n      });\n    };\n\n    /** Node 5: Cache results in Redis; persist to DB for entity sources. */\n    const cacheResultsNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.cacheResults\", async () => {\n        const { sourceType, sourceId, sourceText, hydeDocuments } = state;\n\n        for (const label of Object.keys(hydeDocuments)) {\n          const doc = hydeDocuments[label];\n          if (!doc) continue;\n\n          const key = cacheKey(sourceType, sourceId ?? undefined, sourceText, label, doc.targetCorpus);\n          await self.cache.set(key, doc, { ttl: HYDE_DEFAULT_CACHE_TTL });\n\n          // Persist to DB for entity sources (intent/profile)\n          if (sourceId) {\n            await self.database.saveHydeDocument({\n              sourceType,\n              sourceId,\n              strategy: lensHash(label, doc.targetCorpus),\n              targetCorpus: doc.targetCorpus,\n              hydeText: doc.hydeText,\n              hydeEmbedding: doc.hydeEmbedding,\n            });\n          }\n        }\n\n        logger.verbose('Cached results', {\n          count: Object.keys(hydeDocuments).length,\n        });\n        return {};\n      });\n    };\n\n    const workflow = new StateGraph(HydeGraphState)\n      .addNode('infer_lenses', inferLensesNode)\n      .addNode('check_cache', checkCacheNode)\n      .addNode('generate_missing', generateMissingNode)\n      .addNode('embed', embedNode)\n      .addNode('cache_results', cacheResultsNode)\n      .addEdge(START, 'infer_lenses')\n      .addEdge('infer_lenses', 'check_cache')\n      .addConditionalEdges('check_cache', shouldGenerate, {\n        generate: 'generate_missing',\n        skip: 'embed',\n      })\n      .addEdge('generate_missing', 'embed')\n      .addEdge('embed', 'cache_results')\n      .addEdge('cache_results', END);\n\n    return workflow.compile();\n  }\n}\n"]}
+{"version":3,"file":"hyde.graph.js","sourceRoot":"/","sources":["shared/hyde/hyde.graph.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HyDE Graph: cache-aware hypothetical document generation with lens inference.\n *\n * Flow: infer_lenses → check_cache → (generate_missing if needed) → embed → cache_results.\n * Constructor injects Database, Embedder, Cache, LensInferrer, HydeGenerator.\n */\n\nimport { StateGraph, START, END } from '@langchain/langgraph';\nimport { createHash } from 'crypto';\n\nimport { getAbortSignalConfig } from '../agent/model-signal.js';\nimport { HydeGraphState, type HydeDocumentState } from './hyde.state.js';\nimport { LensInferrer } from './lens.inferrer.js';\nimport { HydeGenerator } from './hyde.generator.js';\nimport type { HydeGraphDatabase } from '../interfaces/database.interface.js';\nimport type { EmbeddingGenerator } from '../interfaces/embedder.interface.js';\nimport type { HydeCache } from '../interfaces/cache.interface.js';\nimport { HYDE_DEFAULT_CACHE_TTL } from './hyde.strategies.js';\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { timed } from '../observability/performance.js';\nimport { requestContext } from \"../observability/request-context.js\";\nimport type { DebugMetaAgent } from '../../chat/chat-streaming.types.js';\n\nconst logger = protocolLogger(\"HyDEGraphFactory\");\n\n/** Hash a lens label (+ optional corpus) to a short key for cache/DB indexing. */\nfunction lensHash(label: string, corpus?: string): string {\n  const input = corpus\n    ? `${label.toLowerCase().trim()}:${corpus}`\n    : label.toLowerCase().trim();\n  return createHash('sha256').update(input).digest('hex').slice(0, 16);\n}\n\n/** Build cache key for a specific lens. */\nfunction cacheKey(\n  sourceType: string,\n  sourceId: string | undefined,\n  sourceText: string,\n  lens: string,\n  corpus?: string,\n): string {\n  const entityKey =\n    sourceId ?? `q:${createHash('sha256').update(sourceText).digest('hex').slice(0, 16)}`;\n  return `hyde:${sourceType}:${entityKey}:${lensHash(lens, corpus)}`;\n}\n\n/**\n * Factory for the HyDE generation graph.\n * Injects Database, Embedder, Cache, LensInferrer, and HydeGenerator.\n */\nexport class HydeGraphFactory {\n  constructor(\n    private database: HydeGraphDatabase,\n    private embedder: EmbeddingGenerator,\n    private cache: HydeCache,\n    private inferrer: LensInferrer,\n    private generator: HydeGenerator,\n  ) {}\n\n  createGraph() {\n    const self = this;\n\n    /** Node 1: Infer lenses from source text + optional profile context. */\n    const inferLensesNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.inferLenses\", async () => {\n        const { sourceText, profileContext, maxLenses } = state;\n\n        logger.verbose('Inferring lenses', { sourceTextLength: sourceText.length, hasProfileContext: !!profileContext });\n\n        const agentTimingsAccum: DebugMetaAgent[] = [];\n\n        try {\n          const _traceEmitterLens = requestContext.getStore()?.traceEmitter;\n          const inferrerStart = Date.now();\n          _traceEmitterLens?.({ type: \"agent_start\", name: \"lens-inferrer\" });\n          const result = await self.inferrer.infer({\n            sourceText,\n            profileContext,\n            maxLenses,\n          });\n          const _inferrerDuration = Date.now() - inferrerStart;\n          agentTimingsAccum.push({ name: 'lens.inferrer', durationMs: _inferrerDuration });\n          _traceEmitterLens?.({ type: \"agent_end\", name: \"lens-inferrer\", durationMs: _inferrerDuration, summary: result.lenses.length > 0 ? `Inferred ${result.lenses.length} lens(es)` : \"lens-inferrer completed\" });\n\n          logger.verbose('Lenses inferred', {\n            count: result.lenses.length,\n            lenses: result.lenses.map(l => ({ label: l.label, corpus: l.corpus })),\n          });\n\n          return { lenses: result.lenses, agentTimings: agentTimingsAccum };\n        } catch (error) {\n          logger.error('Lens inference failed in graph node', { error });\n          return { lenses: [], agentTimings: agentTimingsAccum };\n        }\n      });\n    };\n\n    /** Node 2: Check cache/DB for existing HyDE docs matching inferred lenses. */\n    const checkCacheNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.checkCache\", async () => {\n        const { sourceType, sourceId, sourceText, lenses, forceRegenerate } = state;\n\n        if (forceRegenerate) {\n          logger.verbose('Force regenerate - skipping cache');\n          return { hydeDocuments: {} };\n        }\n\n        const cached: Record<string, HydeDocumentState> = {};\n\n        for (const lens of lenses) {\n          const key = cacheKey(sourceType, sourceId ?? undefined, sourceText, lens.label, lens.corpus);\n\n          const fromCache = await self.cache.get<HydeDocumentState>(key);\n          if (fromCache?.hydeText && fromCache.hydeEmbedding?.length) {\n            logger.verbose('Cache hit', { lens: lens.label });\n            cached[lens.label] = fromCache;\n            continue;\n          }\n\n          // For entity sources, check DB for persisted docs\n          if (sourceId) {\n            const fromDb = await self.database.getHydeDocument(\n              sourceType,\n              sourceId,\n              lensHash(lens.label, lens.corpus),\n            );\n            if (fromDb) {\n              logger.verbose('DB hit', { lens: lens.label });\n              cached[lens.label] = {\n                lens: lens.label,\n                targetCorpus: fromDb.targetCorpus as 'profiles' | 'intents',\n                hydeText: fromDb.hydeText,\n                hydeEmbedding: fromDb.hydeEmbedding,\n              };\n            }\n          }\n        }\n\n        logger.verbose('Check cache done', {\n          found: Object.keys(cached).length,\n          requested: lenses.length,\n        });\n        return { hydeDocuments: cached };\n      });\n    };\n\n    /** Conditional: decide whether to generate or skip to embed. */\n    const shouldGenerate = (state: typeof HydeGraphState.State): string => {\n      const { lenses, hydeDocuments } = state;\n      const missing = lenses.filter((l) => !hydeDocuments[l.label]);\n      if (missing.length > 0) {\n        logger.verbose('Need to generate', { missing: missing.map(l => l.label) });\n        return 'generate';\n      }\n      logger.verbose('All lenses cached, skipping generation');\n      return 'skip';\n    };\n\n    /** Node 3: Generate HyDE documents for lenses not in cache. */\n    const generateMissingNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.generateMissing\", async () => {\n        const { sourceText, lenses, hydeDocuments } = state;\n        const missing = lenses.filter((l) => !hydeDocuments[l.label]);\n\n        logger.verbose('Generating HyDE documents', {\n          count: missing.length,\n          lenses: missing.map(l => l.label),\n        });\n\n        const agentTimingsAccum: DebugMetaAgent[] = [];\n        const generated: Record<string, HydeDocumentState> = {};\n\n        await Promise.all(\n          missing.map(async (lens) => {\n            const _traceEmitterHyde = requestContext.getStore()?.traceEmitter;\n            const generatorStart = Date.now();\n            _traceEmitterHyde?.({ type: \"agent_start\", name: \"hyde-generator\" });\n            const out = await self.generator.generate({\n              sourceText,\n              lens: lens.label,\n              corpus: lens.corpus,\n            });\n            const _hydeDuration = Date.now() - generatorStart;\n            agentTimingsAccum.push({ name: 'hyde.generator', durationMs: _hydeDuration });\n            _traceEmitterHyde?.({ type: \"agent_end\", name: \"hyde-generator\", durationMs: _hydeDuration, summary: `Generated: ${lens.label}` });\n            generated[lens.label] = {\n              lens: lens.label,\n              targetCorpus: lens.corpus,\n              hydeText: out.text,\n              hydeEmbedding: [],\n            };\n          })\n        );\n\n        return { hydeDocuments: { ...state.hydeDocuments, ...generated }, agentTimings: agentTimingsAccum };\n      });\n    };\n\n    /** Node 4: Embed all HyDE documents that don't have embeddings yet. */\n    const embedNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.embed\", async () => {\n        const { hydeDocuments } = state;\n        const lensLabels = Object.keys(hydeDocuments);\n        const toEmbed: { label: string; doc: HydeDocumentState }[] = [];\n        const updated: Record<string, HydeDocumentState> = {};\n        const hydeEmbeddings: Record<string, number[]> = {};\n\n        for (const label of lensLabels) {\n          const doc = hydeDocuments[label];\n          if (!doc) continue;\n          if (doc.hydeEmbedding?.length) {\n            updated[label] = doc;\n            hydeEmbeddings[label] = doc.hydeEmbedding;\n          } else {\n            toEmbed.push({ label, doc });\n          }\n        }\n\n        if (toEmbed.length > 0) {\n          logger.verbose('Embedding documents', { count: toEmbed.length });\n          const texts = toEmbed.map((t) => t.doc.hydeText);\n          const embeddings = await self.embedder.generate(texts, undefined, getAbortSignalConfig());\n          const embeddingArray = Array.isArray(embeddings[0])\n            ? (embeddings as number[][])\n            : [embeddings as number[]];\n\n          for (let i = 0; i < toEmbed.length; i++) {\n            const { label, doc } = toEmbed[i];\n            const embedding = embeddingArray[i] ?? [];\n            updated[label] = { ...doc, hydeEmbedding: embedding };\n            hydeEmbeddings[label] = embedding;\n          }\n        }\n\n        return { hydeDocuments: updated, hydeEmbeddings };\n      });\n    };\n\n    /** Node 5: Cache results in Redis; persist to DB for entity sources. */\n    const cacheResultsNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.cacheResults\", async () => {\n        const { sourceType, sourceId, sourceText, hydeDocuments } = state;\n\n        for (const label of Object.keys(hydeDocuments)) {\n          const doc = hydeDocuments[label];\n          if (!doc) continue;\n\n          const key = cacheKey(sourceType, sourceId ?? undefined, sourceText, label, doc.targetCorpus);\n          await self.cache.set(key, doc, { ttl: HYDE_DEFAULT_CACHE_TTL });\n\n          // Persist to DB for entity sources (intent/profile)\n          if (sourceId) {\n            await self.database.saveHydeDocument({\n              sourceType,\n              sourceId,\n              strategy: lensHash(label, doc.targetCorpus),\n              targetCorpus: doc.targetCorpus,\n              hydeText: doc.hydeText,\n              hydeEmbedding: doc.hydeEmbedding,\n            });\n          }\n        }\n\n        logger.verbose('Cached results', {\n          count: Object.keys(hydeDocuments).length,\n        });\n        return {};\n      });\n    };\n\n    const workflow = new StateGraph(HydeGraphState)\n      .addNode('infer_lenses', inferLensesNode)\n      .addNode('check_cache', checkCacheNode)\n      .addNode('generate_missing', generateMissingNode)\n      .addNode('embed', embedNode)\n      .addNode('cache_results', cacheResultsNode)\n      .addEdge(START, 'infer_lenses')\n      .addEdge('infer_lenses', 'check_cache')\n      .addConditionalEdges('check_cache', shouldGenerate, {\n        generate: 'generate_missing',\n        skip: 'embed',\n      })\n      .addEdge('generate_missing', 'embed')\n      .addEdge('embed', 'cache_results')\n      .addEdge('cache_results', END);\n\n    return workflow.compile();\n  }\n}\n"]}