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

package/dist/chat/chat.interrupt.classifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.interrupt.classifier.js","sourceRoot":"/","sources":["chat/chat.interrupt.classifier.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AAEvD,MAAM,aAAa,GAAG;;;;;;oCAMc,CAAC;AAYrC;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAGlC;QACE,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IAEG,AAAN,KAAK,CAAC,QAAQ,CAAC,KAA6B;QAC1C,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE;gBACvD,IAAI,aAAa,CAAC,aAAa,CAAC;gBAChC,IAAI,YAAY,CACd,2BAA2B,UAAU,IAAI,MAAM,0BAA0B,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAC/G;aACF,CAAC,CAAC;YAEH,MAAM,IAAI,GACR,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;gBAClC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;gBACvC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAE1D,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;YAC7C,yDAAyD;YACzD,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,+EAA+E,EAAE;gBAC3F,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;CACF;AA1BO;IADL,KAAK,EAAE;;;;uDA0BP","sourcesContent":["import type { ChatOpenAI } from \"@langchain/openai\";\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\n\nimport { log } from \"../shared/observability/log.js\";\nimport { Timed } from \"../shared/observability/performance.js\";\nimport { createModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\n\nconst logger = log.lib.from(\"ChatInterruptClassifier\");\n\nconst SYSTEM_PROMPT = `You decide whether a new user message sent during an active AI process should STEER or QUEUE.\n\nRules:\n- Reply with ONLY one word: steer or queue (lowercase).\n- STEER: the message redirects, corrects, stops, contradicts, or changes what the AI is doing. Keywords: \"wait\", \"stop\", \"actually\", \"ignore that\", \"instead\", \"no\", \"cancel\".\n- QUEUE: the message adds context, asks a follow-up, or complements what the AI is doing. Keywords: \"also\", \"and\", \"when done\", \"additionally\", \"plus\".\n- When ambiguous, default to steer.`;\n\nexport interface ClassifyInterruptInput {\n  /** The new user message sent while the agent is running. */\n  message: string;\n  /**\n   * Current agent activity summary derived from the last few SSE trace event names\n   * (e.g. \"tool_start: discover_opportunities, graph_start: opportunity\").\n   */\n  agentState: string;\n}\n\n/**\n * Binary classifier that decides whether a mid-stream user message should steer\n * (interrupt the current run) or queue (buffer until the run completes).\n * Uses a low-temperature, minimal-token model for sub-1 s latency.\n */\nexport class ChatInterruptClassifier {\n  private model: ChatOpenAI;\n\n  constructor() {\n    this.model = createModel(\"interruptClassifier\");\n  }\n\n  /**\n   * Classify a mid-stream interrupt as steer or queue.\n   *\n   * @param input - The new message and current agent state context\n   * @returns \"steer\" to interrupt the current run; \"queue\" to buffer\n   */\n  @Timed()\n  async classify(input: ClassifyInterruptInput): Promise<\"steer\" | \"queue\"> {\n    const { message, agentState } = input;\n\n    try {\n      const response = await invokeWithAbortSignal(this.model, [\n        new SystemMessage(SYSTEM_PROMPT),\n        new HumanMessage(\n          `Current agent activity: ${agentState || \"idle\"}\\n\\nNew user message: \"${message.slice(0, 500)}\"\\n\\nDecision:`,\n        ),\n      ]);\n\n      const text =\n        typeof response.content === \"string\"\n          ? response.content.trim().toLowerCase()\n          : String(response.content ?? \"\").trim().toLowerCase();\n\n      if (text.startsWith(\"queue\")) return \"queue\";\n      // Default to steer on any ambiguity or unexpected output\n      return \"steer\";\n    } catch (error) {\n      logger.warn(\"[ChatInterruptClassifier.classify] Classification failed, defaulting to steer\", {\n        error: error instanceof Error ? error.message : String(error),\n      });\n      return \"steer\";\n    }\n  }\n}\n"]}
+{"version":3,"file":"chat.interrupt.classifier.js","sourceRoot":"/","sources":["chat/chat.interrupt.classifier.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AAEvD,MAAM,aAAa,GAAG;;;;;;oCAMc,CAAC;AAYrC;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAGlC;QACE,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IAEG,AAAN,KAAK,CAAC,QAAQ,CAAC,KAA6B;QAC1C,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE;gBACvD,IAAI,aAAa,CAAC,aAAa,CAAC;gBAChC,IAAI,YAAY,CACd,2BAA2B,UAAU,IAAI,MAAM,0BAA0B,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAC/G;aACF,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAEjE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;YAC7C,yDAAyD;YACzD,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,+EAA+E,EAAE;gBAC3F,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;CACF;AAvBO;IADL,KAAK,EAAE;;;;uDAuBP","sourcesContent":["import type { ChatOpenAI } from \"@langchain/openai\";\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\n\nimport { log } from \"../shared/observability/log.js\";\nimport { Timed } from \"../shared/observability/performance.js\";\nimport { createModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\n\nconst logger = log.lib.from(\"ChatInterruptClassifier\");\n\nconst SYSTEM_PROMPT = `You decide whether a new user message sent during an active AI process should STEER or QUEUE.\n\nRules:\n- Reply with ONLY one word: steer or queue (lowercase).\n- STEER: the message redirects, corrects, stops, contradicts, or changes what the AI is doing. Keywords: \"wait\", \"stop\", \"actually\", \"ignore that\", \"instead\", \"no\", \"cancel\".\n- QUEUE: the message adds context, asks a follow-up, or complements what the AI is doing. Keywords: \"also\", \"and\", \"when done\", \"additionally\", \"plus\".\n- When ambiguous, default to steer.`;\n\nexport interface ClassifyInterruptInput {\n  /** The new user message sent while the agent is running. */\n  message: string;\n  /**\n   * Current agent activity summary derived from the last few SSE trace event names\n   * (e.g. \"tool_start: discover_opportunities, graph_start: opportunity\").\n   */\n  agentState: string;\n}\n\n/**\n * Binary classifier that decides whether a mid-stream user message should steer\n * (interrupt the current run) or queue (buffer until the run completes).\n * Uses a low-temperature, minimal-token model for sub-1 s latency.\n */\nexport class ChatInterruptClassifier {\n  private model: ChatOpenAI;\n\n  constructor() {\n    this.model = createModel(\"interruptClassifier\");\n  }\n\n  /**\n   * Classify a mid-stream interrupt as steer or queue.\n   *\n   * @param input - The new message and current agent state context\n   * @returns \"steer\" to interrupt the current run; \"queue\" to buffer\n   */\n  @Timed()\n  async classify(input: ClassifyInterruptInput): Promise<\"steer\" | \"queue\"> {\n    const { message, agentState } = input;\n\n    try {\n      const response = await invokeWithAbortSignal(this.model, [\n        new SystemMessage(SYSTEM_PROMPT),\n        new HumanMessage(\n          `Current agent activity: ${agentState || \"idle\"}\\n\\nNew user message: \"${message.slice(0, 500)}\"\\n\\nDecision:`,\n        ),\n      ]);\n\n      const text = String(response.content ?? \"\").trim().toLowerCase();\n\n      if (text.startsWith(\"queue\")) return \"queue\";\n      // Default to steer on any ambiguity or unexpected output\n      return \"steer\";\n    } catch (error) {\n      logger.warn(\"[ChatInterruptClassifier.classify] Classification failed, defaulting to steer\", {\n        error: error instanceof Error ? error.message : String(error),\n      });\n      return \"steer\";\n    }\n  }\n}\n"]}

package/dist/chat/chat.suggester.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.suggester.js","sourceRoot":"/","sources":["chat/chat.suggester.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChatOpenAI } from \"@langchain/openai\";\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\nimport { z } from \"zod\";\nimport type { ChatSuggestion } from \"./chat-streaming.types.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { Timed } from \"../shared/observability/performance.js\";\nimport { createModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\n\nconst logger = protocolLogger(\"SuggestionGenerator\");\n\nconst suggestionItemSchema = z.object({\n  label: z.string().describe(\"Short label for the chip (2-5 words)\"),\n  type: z.enum([\"direct\", \"prompt\"]).describe(\"direct = auto-submit message; prompt = prefill input\"),\n  followupText: z.string().nullable().describe(\"For type=direct: full message to send when clicked; null for prompt type\"),\n  prefill: z.string().nullable().describe(\"For type=prompt: text to prefill the input; null for direct type\"),\n});\n\nconst suggestionsSchema = z.object({\n  suggestions: z\n    .array(suggestionItemSchema)\n    .min(1)\n    .max(6)\n    .describe(\"3-5 follow-up suggestions based on the conversation\"),\n});\n\nconst SYSTEM_PROMPT = `You generate follow-up suggestions for a chat user based on their conversation.\n\nRules:\n- Return 3-5 suggestions. Mix of \"direct\" (one-click send) and \"prompt\" (prefill for user to edit).\n- Labels must be short: 2-5 words (e.g. \"Find collaborators\", \"Add more details\").\n- For type=direct: provide followupText as the exact message to send (complete sentence).\n- For type=prompt: provide prefill as the start of a sentence the user can complete (e.g. \"I need help with \").\n- Suggestions must be relevant to the last exchange and natural next steps.\n- Do not repeat what the user or assistant just said; suggest logical follow-ups.\n- Voice: Calm, direct; no hype or networking clichés. Prefer words like opportunity, overlap, signal, pattern, relevant. Avoid: search, leverage, networking, match, optimize, scale.`;\n\nexport interface SuggestionGeneratorInput {\n  /** Last few messages (user and assistant) to derive context */\n  messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n  /** Optional index/community context to tailor suggestions */\n  indexContext?: string;\n}\n\n/**\n * Lightweight generator for context-aware chat follow-up suggestions.\n * Uses a fast model and structured output to return 3-5 suggestions per call.\n */\nexport class SuggestionGenerator {\n  private model: ReturnType<ChatOpenAI[\"withStructuredOutput\"]>;\n\n  constructor() {\n    const llm = createModel(\"suggestionGenerator\");\n    this.model = llm.withStructuredOutput(suggestionsSchema, { name: \"chat_suggestions\" });\n  }\n\n  /**\n   * Generate follow-up suggestions from the last exchange.\n   * Returns empty array on failure (graceful degradation).\n   */\n  @Timed()\n  async generate(input: SuggestionGeneratorInput): Promise<ChatSuggestion[]> {\n    const { messages, indexContext } = input;\n    if (messages.length === 0) return [];\n\n    const excerpt = messages\n      .slice(-6)\n      .map((m) => `${m.role === \"user\" ? \"User\" : \"Assistant\"}: ${m.content.slice(0, 300)}`)\n      .join(\"\\n\\n\");\n\n    const userContent = indexContext\n      ? `Conversation (community context: ${indexContext}):\\n\\n${excerpt}\\n\\nGenerate 3-5 follow-up suggestions.`\n      : `Conversation:\\n\\n${excerpt}\\n\\nGenerate 3-5 follow-up suggestions.`;\n\n    try {\n      const result = await invokeWithAbortSignal(this.model, [\n        new SystemMessage(SYSTEM_PROMPT),\n        new HumanMessage(userContent),\n      ]);\n      const parsed = suggestionsSchema.safeParse(result);\n      if (!parsed.success) {\n        logger.warn(\"[SuggestionGenerator] Parse failed\", { error: parsed.error.message });\n        return [];\n      }\n      const out: ChatSuggestion[] = parsed.data.suggestions.map((s) => ({\n        label: s.label,\n        type: s.type as \"direct\" | \"prompt\",\n        ...(s.type === \"direct\" && s.followupText != null && { followupText: s.followupText }),\n        ...(s.type === \"prompt\" && s.prefill != null && { prefill: s.prefill }),\n      }));\n      logger.verbose(\"[SuggestionGenerator] Generated\", { count: out.length });\n      return out;\n    } catch (error) {\n      logger.warn(\"[SuggestionGenerator] Failed\", {\n        error: error instanceof Error ? error.message : String(error),\n      });\n      return [];\n    }\n  }\n}\n"]}
+{"version":3,"file":"chat.suggester.js","sourceRoot":"/","sources":["chat/chat.suggester.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChatOpenAI } from \"@langchain/openai\";\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\nimport { z } from \"zod\";\nimport type { ChatSuggestion } from \"./chat-streaming.types.js\";\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { Timed } from \"../shared/observability/performance.js\";\nimport { createModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\n\nconst logger = protocolLogger(\"SuggestionGenerator\");\n\nconst suggestionItemSchema = z.object({\n  label: z.string().describe(\"Short label for the chip (2-5 words)\"),\n  type: z.enum([\"direct\", \"prompt\"]).describe(\"direct = auto-submit message; prompt = prefill input\"),\n  followupText: z.string().nullable().describe(\"For type=direct: full message to send when clicked; null for prompt type\"),\n  prefill: z.string().nullable().describe(\"For type=prompt: text to prefill the input; null for direct type\"),\n});\n\nconst suggestionsSchema = z.object({\n  suggestions: z\n    .array(suggestionItemSchema)\n    .min(1)\n    .max(6)\n    .describe(\"3-5 follow-up suggestions based on the conversation\"),\n});\n\nconst SYSTEM_PROMPT = `You generate follow-up suggestions for a chat user based on their conversation.\n\nRules:\n- Return 3-5 suggestions. Mix of \"direct\" (one-click send) and \"prompt\" (prefill for user to edit).\n- Labels must be short: 2-5 words (e.g. \"Find collaborators\", \"Add more details\").\n- For type=direct: provide followupText as the exact message to send (complete sentence).\n- For type=prompt: provide prefill as the start of a sentence the user can complete (e.g. \"I need help with \").\n- Suggestions must be relevant to the last exchange and natural next steps.\n- Do not repeat what the user or assistant just said; suggest logical follow-ups.\n- Voice: Calm, direct; no hype or networking clichés. Prefer words like opportunity, overlap, signal, pattern, relevant. Avoid: search, leverage, networking, match, optimize, scale.`;\n\nexport interface SuggestionGeneratorInput {\n  /** Last few messages (user and assistant) to derive context */\n  messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n  /** Optional index/community context to tailor suggestions */\n  indexContext?: string;\n}\n\n/**\n * Lightweight generator for context-aware chat follow-up suggestions.\n * Uses a fast model and structured output to return 3-5 suggestions per call.\n */\nexport class SuggestionGenerator {\n  private model: ReturnType<ChatOpenAI[\"withStructuredOutput\"]>;\n\n  constructor() {\n    const llm = createModel(\"suggestionGenerator\");\n    this.model = llm.withStructuredOutput(suggestionsSchema, { name: \"chat_suggestions\" });\n  }\n\n  /**\n   * Generate follow-up suggestions from the last exchange.\n   * Returns empty array on failure (graceful degradation).\n   */\n  @Timed()\n  async generate(input: SuggestionGeneratorInput): Promise<ChatSuggestion[]> {\n    const { messages, indexContext } = input;\n    if (messages.length === 0) return [];\n\n    const excerpt = messages\n      .slice(-6)\n      .map((m) => `${m.role === \"user\" ? \"User\" : \"Assistant\"}: ${m.content.slice(0, 300)}`)\n      .join(\"\\n\\n\");\n\n    const userContent = indexContext\n      ? `Conversation (community context: ${indexContext}):\\n\\n${excerpt}\\n\\nGenerate 3-5 follow-up suggestions.`\n      : `Conversation:\\n\\n${excerpt}\\n\\nGenerate 3-5 follow-up suggestions.`;\n\n    try {\n      const result = await invokeWithAbortSignal(this.model, [\n        new SystemMessage(SYSTEM_PROMPT),\n        new HumanMessage(userContent),\n      ]);\n      const parsed = suggestionsSchema.safeParse(result);\n      if (!parsed.success) {\n        logger.warn(\"[SuggestionGenerator] Parse failed\", { error: parsed.error.message });\n        return [];\n      }\n      const out: ChatSuggestion[] = parsed.data.suggestions.map((s) => ({\n        label: s.label,\n        type: s.type,\n        ...(s.type === \"direct\" && s.followupText != null && { followupText: s.followupText }),\n        ...(s.type === \"prompt\" && s.prefill != null && { prefill: s.prefill }),\n      }));\n      logger.verbose(\"[SuggestionGenerator] Generated\", { count: out.length });\n      return out;\n    } catch (error) {\n      logger.warn(\"[SuggestionGenerator] Failed\", {\n        error: error instanceof Error ? error.message : String(error),\n      });\n      return [];\n    }\n  }\n}\n"]}

package/dist/context/context.generator.d.ts

@@ -51,6 +51,8 @@ export declare class UserContextGenerator {
      * @returns Updated context text with embedding vector
      */
     generateIncremental(input: IncrementalContextInput): Promise<UserContextResult>;
+    /** Normalize an LLM message content into a plain string. */
+    private extractText;
     /** Format the network context header for LLM prompts. */
     private formatNetworkContext;
     /** Describe the premise change for the incremental prompt. */

package/dist/context/context.generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.generator.d.ts","sourceRoot":"/","sources":["context/context.generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD;;;GAGG;AACH,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,kBAAkB;IAFtC,OAAO,CAAC,KAAK,CAAuC;gBAEhC,kBAAkB,EAAE,kBAAkB;IAE1D;;;;;OAKG;IACG,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmB5E;;;;;OAKG;IACG,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmBrF,yDAAyD;IACzD,OAAO,CAAC,oBAAoB;IAM5B,8DAA8D;IAC9D,OAAO,CAAC,cAAc;IAatB,iEAAiE;YACnD,KAAK;CAIpB"}
+{"version":3,"file":"context.generator.d.ts","sourceRoot":"/","sources":["context/context.generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD;;;GAGG;AACH,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,kBAAkB;IAFtC,OAAO,CAAC,KAAK,CAAuC;gBAEhC,kBAAkB,EAAE,kBAAkB;IAE1D;;;;;OAKG;IACG,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiB5E;;;;;OAKG;IACG,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiBrF,4DAA4D;IAC5D,OAAO,CAAC,WAAW;IAMnB,yDAAyD;IACzD,OAAO,CAAC,oBAAoB;IAM5B,8DAA8D;IAC9D,OAAO,CAAC,cAAc;IAatB,iEAAiE;YACnD,KAAK;CAIpB"}

package/dist/context/context.generator.js

@@ -33,9 +33,7 @@ export class UserContextGenerator {
             new SystemMessage(COLD_START_SYSTEM_PROMPT),
             new HumanMessage(`${networkContext}\n\nPremises:\n${premiseBlock}\n\nWrite a focused context paragraph for this person in this network.`),
         ]);
-        const text = typeof response.content === 'string'
-            ? response.content
-            : String(response.content ?? '').trim();
+        const text = this.extractText(response.content);
         const embedding = await this.embed(text);
         return { text, embedding };
     }
@@ -52,12 +50,16 @@ export class UserContextGenerator {
             new SystemMessage(INCREMENTAL_SYSTEM_PROMPT),
             new HumanMessage(`${networkContext}\n\nCurrent context:\n${input.currentContext}\n\nChange:\n${changeDescription}\n\nWrite the updated context paragraph.`),
         ]);
-        const text = typeof response.content === 'string'
-            ? response.content
-            : String(response.content ?? '').trim();
+        const text = this.extractText(response.content);
         const embedding = await this.embed(text);
         return { text, embedding };
     }
+    /** Normalize an LLM message content into a plain string. */
+    extractText(content) {
+        return typeof content === 'string'
+            ? content
+            : String(content ?? '').trim();
+    }
     /** Format the network context header for LLM prompts. */
     formatNetworkContext(prompt, title) {
         return prompt

package/dist/context/context.generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.generator.js","sourceRoot":"/","sources":["context/context.generator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * User Context Generator\n *\n * Synthesizes network-scoped context paragraphs from user premises.\n * Two modes: cold-start (all premises at once) and incremental\n * (single premise change applied to an existing context).\n * Returns { text, embedding } for storage in the user_contexts table.\n */\n\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\n\nimport { createModel } from \"../shared/agent/model.config.js\";\nimport { getAbortSignalConfig, invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\nimport type { EmbeddingGenerator } from \"../shared/interfaces/embedder.interface.js\";\n\n/** Input for cold-start context generation from a full set of premises. */\nexport interface UserContextInput {\n  premises: Array<{ text: string }>;\n  networkPrompt: string | null;\n  networkTitle: string;\n}\n\n/** Input for incremental context update from a single premise change. */\nexport interface IncrementalContextInput {\n  currentContext: string;\n  changeType: 'added' | 'updated' | 'retracted' | 'expired';\n  premiseText: string;\n  previousPremiseText?: string;\n  networkPrompt: string | null;\n  networkTitle: string;\n}\n\n/** Generated context paragraph with its embedding vector. */\nexport interface UserContextResult {\n  text: string;\n  embedding: number[];\n}\n\nconst COLD_START_SYSTEM_PROMPT = `You synthesize user context paragraphs for community matching. Given a list of premises (atomic facts about a person) and a network description, write a focused paragraph (3-6 sentences) that captures who this person is through the lens of that network's purpose. Highlight what is most relevant to the network. Write in third person. Be specific and concrete, not generic.`;\n\nconst INCREMENTAL_SYSTEM_PROMPT = `You maintain user context paragraphs for community matching. You will receive the current context paragraph, a change that occurred, and the network description. Update the context paragraph to reflect the change while preserving all other information. Keep the same style: 3-6 sentences, third person, specific and concrete. For retractions/expirations, remove the relevant information. For additions/updates, integrate the new information naturally.`;\n\n/**\n * Generates network-scoped context paragraphs from user premises.\n * Uses LLM synthesis to produce focused context and an embedding vector.\n */\nexport class UserContextGenerator {\n  private model = createModel('userContextGenerator');\n\n  constructor(private embeddingGenerator: EmbeddingGenerator) {}\n\n  /**\n   * Generate a context paragraph from the full set of premises (cold-start).\n   *\n   * @param input - Premises, network prompt, and network title\n   * @returns Synthesized context text with embedding vector\n   */\n  async generateColdStart(input: UserContextInput): Promise<UserContextResult> {\n    const premiseBlock = input.premises.map(p => `- ${p.text}`).join('\\n');\n    const networkContext = this.formatNetworkContext(input.networkPrompt, input.networkTitle);\n\n    const response = await invokeWithAbortSignal(this.model, [\n      new SystemMessage(COLD_START_SYSTEM_PROMPT),\n      new HumanMessage(\n        `${networkContext}\\n\\nPremises:\\n${premiseBlock}\\n\\nWrite a focused context paragraph for this person in this network.`,\n      ),\n    ]);\n\n    const text = typeof response.content === 'string'\n      ? response.content\n      : String(response.content ?? '').trim();\n\n    const embedding = await this.embed(text);\n    return { text, embedding };\n  }\n\n  /**\n   * Update an existing context paragraph after a single premise change.\n   *\n   * @param input - Current context, change details, network metadata\n   * @returns Updated context text with embedding vector\n   */\n  async generateIncremental(input: IncrementalContextInput): Promise<UserContextResult> {\n    const networkContext = this.formatNetworkContext(input.networkPrompt, input.networkTitle);\n    const changeDescription = this.describeChange(input);\n\n    const response = await invokeWithAbortSignal(this.model, [\n      new SystemMessage(INCREMENTAL_SYSTEM_PROMPT),\n      new HumanMessage(\n        `${networkContext}\\n\\nCurrent context:\\n${input.currentContext}\\n\\nChange:\\n${changeDescription}\\n\\nWrite the updated context paragraph.`,\n      ),\n    ]);\n\n    const text = typeof response.content === 'string'\n      ? response.content\n      : String(response.content ?? '').trim();\n\n    const embedding = await this.embed(text);\n    return { text, embedding };\n  }\n\n  /** Format the network context header for LLM prompts. */\n  private formatNetworkContext(prompt: string | null, title: string): string {\n    return prompt\n      ? `Network \"${title}\": ${prompt}`\n      : `Network: ${title}`;\n  }\n\n  /** Describe the premise change for the incremental prompt. */\n  private describeChange(input: IncrementalContextInput): string {\n    switch (input.changeType) {\n      case 'added':\n        return `A new fact was learned about this person:\\n\"${input.premiseText}\"`;\n      case 'updated':\n        return `A fact was updated.\\nOld: \"${input.previousPremiseText}\"\\nNew: \"${input.premiseText}\"`;\n      case 'retracted':\n        return `A fact was retracted (no longer true):\\n\"${input.premiseText}\"`;\n      case 'expired':\n        return `A fact has expired (time-bound, no longer current):\\n\"${input.premiseText}\"`;\n    }\n  }\n\n  /** Generate embedding from text, normalizing the return type. */\n  private async embed(text: string): Promise<number[]> {\n    const result = await this.embeddingGenerator.generate(text, undefined, getAbortSignalConfig());\n    return Array.isArray(result[0]) ? result[0] as number[] : result as number[];\n  }\n}\n"]}
+{"version":3,"file":"context.generator.js","sourceRoot":"/","sources":["context/context.generator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * User Context Generator\n *\n * Synthesizes network-scoped context paragraphs from user premises.\n * Two modes: cold-start (all premises at once) and incremental\n * (single premise change applied to an existing context).\n * Returns { text, embedding } for storage in the user_contexts table.\n */\n\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\n\nimport { createModel } from \"../shared/agent/model.config.js\";\nimport { getAbortSignalConfig, invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\nimport type { EmbeddingGenerator } from \"../shared/interfaces/embedder.interface.js\";\n\n/** Input for cold-start context generation from a full set of premises. */\nexport interface UserContextInput {\n  premises: Array<{ text: string }>;\n  networkPrompt: string | null;\n  networkTitle: string;\n}\n\n/** Input for incremental context update from a single premise change. */\nexport interface IncrementalContextInput {\n  currentContext: string;\n  changeType: 'added' | 'updated' | 'retracted' | 'expired';\n  premiseText: string;\n  previousPremiseText?: string;\n  networkPrompt: string | null;\n  networkTitle: string;\n}\n\n/** Generated context paragraph with its embedding vector. */\nexport interface UserContextResult {\n  text: string;\n  embedding: number[];\n}\n\nconst COLD_START_SYSTEM_PROMPT = `You synthesize user context paragraphs for community matching. Given a list of premises (atomic facts about a person) and a network description, write a focused paragraph (3-6 sentences) that captures who this person is through the lens of that network's purpose. Highlight what is most relevant to the network. Write in third person. Be specific and concrete, not generic.`;\n\nconst INCREMENTAL_SYSTEM_PROMPT = `You maintain user context paragraphs for community matching. You will receive the current context paragraph, a change that occurred, and the network description. Update the context paragraph to reflect the change while preserving all other information. Keep the same style: 3-6 sentences, third person, specific and concrete. For retractions/expirations, remove the relevant information. For additions/updates, integrate the new information naturally.`;\n\n/**\n * Generates network-scoped context paragraphs from user premises.\n * Uses LLM synthesis to produce focused context and an embedding vector.\n */\nexport class UserContextGenerator {\n  private model = createModel('userContextGenerator');\n\n  constructor(private embeddingGenerator: EmbeddingGenerator) {}\n\n  /**\n   * Generate a context paragraph from the full set of premises (cold-start).\n   *\n   * @param input - Premises, network prompt, and network title\n   * @returns Synthesized context text with embedding vector\n   */\n  async generateColdStart(input: UserContextInput): Promise<UserContextResult> {\n    const premiseBlock = input.premises.map(p => `- ${p.text}`).join('\\n');\n    const networkContext = this.formatNetworkContext(input.networkPrompt, input.networkTitle);\n\n    const response = await invokeWithAbortSignal(this.model, [\n      new SystemMessage(COLD_START_SYSTEM_PROMPT),\n      new HumanMessage(\n        `${networkContext}\\n\\nPremises:\\n${premiseBlock}\\n\\nWrite a focused context paragraph for this person in this network.`,\n      ),\n    ]);\n\n    const text = this.extractText(response.content);\n\n    const embedding = await this.embed(text);\n    return { text, embedding };\n  }\n\n  /**\n   * Update an existing context paragraph after a single premise change.\n   *\n   * @param input - Current context, change details, network metadata\n   * @returns Updated context text with embedding vector\n   */\n  async generateIncremental(input: IncrementalContextInput): Promise<UserContextResult> {\n    const networkContext = this.formatNetworkContext(input.networkPrompt, input.networkTitle);\n    const changeDescription = this.describeChange(input);\n\n    const response = await invokeWithAbortSignal(this.model, [\n      new SystemMessage(INCREMENTAL_SYSTEM_PROMPT),\n      new HumanMessage(\n        `${networkContext}\\n\\nCurrent context:\\n${input.currentContext}\\n\\nChange:\\n${changeDescription}\\n\\nWrite the updated context paragraph.`,\n      ),\n    ]);\n\n    const text = this.extractText(response.content);\n\n    const embedding = await this.embed(text);\n    return { text, embedding };\n  }\n\n  /** Normalize an LLM message content into a plain string. */\n  private extractText(content: unknown): string {\n    return typeof content === 'string'\n      ? content\n      : String(content ?? '').trim();\n  }\n\n  /** Format the network context header for LLM prompts. */\n  private formatNetworkContext(prompt: string | null, title: string): string {\n    return prompt\n      ? `Network \"${title}\": ${prompt}`\n      : `Network: ${title}`;\n  }\n\n  /** Describe the premise change for the incremental prompt. */\n  private describeChange(input: IncrementalContextInput): string {\n    switch (input.changeType) {\n      case 'added':\n        return `A new fact was learned about this person:\\n\"${input.premiseText}\"`;\n      case 'updated':\n        return `A fact was updated.\\nOld: \"${input.previousPremiseText}\"\\nNew: \"${input.premiseText}\"`;\n      case 'retracted':\n        return `A fact was retracted (no longer true):\\n\"${input.premiseText}\"`;\n      case 'expired':\n        return `A fact has expired (time-bound, no longer current):\\n\"${input.premiseText}\"`;\n    }\n  }\n\n  /** Generate embedding from text, normalizing the return type. */\n  private async embed(text: string): Promise<number[]> {\n    const result = await this.embeddingGenerator.generate(text, undefined, getAbortSignalConfig());\n    return Array.isArray(result[0]) ? result[0] as number[] : result as number[];\n  }\n}\n"]}

package/dist/intent/intent.clarifier.d.ts

@@ -21,6 +21,8 @@ export declare class IntentClarifier {
     private readonly suggestionModel;
     private readonly clarificationDraftModel;
     constructor();
+    /** Build the shared user prompt with intent, profile, and active-intent context. */
+    private buildPrompt;
     invoke(description: string, profileContext: string, activeIntentsContext: string): Promise<IntentClarifierOutput>;
     private generateSuggestion;
     private generateClarificationDraft;

package/dist/intent/intent.clarifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent.clarifier.d.ts","sourceRoot":"/","sources":["intent/intent.clarifier.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;EAKvB,CAAC;AASH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AA4CxE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA2B;;IAiBtD,MAAM,CACjB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC,qBAAqB,CAAC;YA2CnB,kBAAkB;YA6BlB,0BAA0B;CAoCzC"}
+{"version":3,"file":"intent.clarifier.d.ts","sourceRoot":"/","sources":["intent/intent.clarifier.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;EAKvB,CAAC;AASH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AA4CxE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA2B;;IAgBnE,oFAAoF;IACpF,OAAO,CAAC,WAAW;IAkBN,MAAM,CACjB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC,qBAAqB,CAAC;YAkCnB,kBAAkB;YAoBlB,0BAA0B;CA2BzC"}

package/dist/intent/intent.clarifier.js

@@ -77,9 +77,9 @@ export class IntentClarifier {
         });
         this.clarificationDraftModel = baseModel.withStructuredOutput(clarificationDraftSchema, { name: "intent_clarifier_message" });
     }
-    async invoke(description, profileContext, activeIntentsContext) {
-        try {
-            const prompt = `
+    /** Build the shared user prompt with intent, profile, and active-intent context. */
+    buildPrompt(description, profileContext, activeIntentsContext) {
+        return `
 # User Input Intent
 ${description}
 
@@ -89,6 +89,10 @@ ${profileContext || "none"}
 # Active Intents
 ${activeIntentsContext || "none"}
 `;
+    }
+    async invoke(description, profileContext, activeIntentsContext) {
+        try {
+            const prompt = this.buildPrompt(description, profileContext, activeIntentsContext);
             const result = await invokeWithAbortSignal(this.model, [
                 new SystemMessage(systemPrompt),
                 new HumanMessage(prompt),
@@ -119,16 +123,7 @@ ${activeIntentsContext || "none"}
     }
     async generateSuggestion(description, profileContext, activeIntentsContext) {
         try {
-            const prompt = `
-# User Input Intent
-${description}
-
-# User Profile
-${profileContext || "none"}
-
-# Active Intents
-${activeIntentsContext || "none"}
-`;
+            const prompt = this.buildPrompt(description, profileContext, activeIntentsContext);
             const output = await invokeWithAbortSignal(this.suggestionModel, [
                 new SystemMessage(suggestionPrompt),
                 new HumanMessage(prompt),
@@ -144,16 +139,7 @@ ${activeIntentsContext || "none"}
     }
     async generateClarificationDraft(description, profileContext, activeIntentsContext) {
         try {
-            const prompt = `
-# User Input Intent
-${description}
-
-# User Profile
-${profileContext || "none"}
-
-# Active Intents
-${activeIntentsContext || "none"}
-`;
+            const prompt = this.buildPrompt(description, profileContext, activeIntentsContext);
             const output = await invokeWithAbortSignal(this.clarificationDraftModel, [
                 new SystemMessage(clarificationDraftPrompt),
                 new HumanMessage(prompt),

package/dist/intent/intent.clarifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"intent.clarifier.js","sourceRoot":"/","sources":["intent/intent.clarifier.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChatOpenAI } from \"@langchain/openai\";\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\nimport { z } from \"zod\";\n\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { Timed } from \"../shared/observability/performance.js\";\n\nimport { createModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\n\nconst logger = protocolLogger(\"IntentClarifier\");\n\ntype ClarifierStructuredModel = ReturnType<ChatOpenAI[\"withStructuredOutput\"]>;\n\nconst clarificationSchema = z.object({\n  needsClarification: z.boolean(),\n  reason: z.string(),\n  suggestedDescription: z.string().nullable(),\n  clarificationMessage: z.string().nullable(),\n});\nconst suggestionSchema = z.object({\n  suggestedDescription: z.string(),\n});\nconst clarificationDraftSchema = z.object({\n  suggestedDescription: z.string(),\n  clarificationMessage: z.string(),\n});\n\nexport type IntentClarifierOutput = z.infer<typeof clarificationSchema>;\n\nconst systemPrompt = `\nYou evaluate whether an intent is specific enough to persist without asking the user to confirm a refinement.\n\nOnly set needsClarification=true when the intent is truly vague — e.g. a single generic phrase with no role, domain, location, or other concrete criteria (like \"find a job\", \"I need help\", \"looking for something\").\n\nDo NOT ask for clarification when the user has already given:\n- A role or type (e.g. \"UX designer\", \"technical co-founder\", \"engineer\")\n- A domain or industry (e.g. \"in AI\", \"climate tech\", \"fintech\")\n- A location or format (e.g. \"remote\", \"Berlin\", \"full-time\")\n- Any other concrete detail that makes the intent actionable\n\nDefault to needsClarification=false when in doubt. Only clarify when the intent is so broad that persisting it as-is would be unhelpful (e.g. literally \"a job\" or \"something\" with no other signal).\n\nRules when needsClarification=true:\n- User Profile is the primary source for suggestedDescription; Active Intents are secondary.\n- You MUST provide a concrete suggestedDescription and short clarificationMessage.\n- Do not include JSON in clarificationMessage.\n`;\n\nconst suggestionPrompt = `\nYou generate one concrete, specific intent rewrite.\n\nRules:\n- Output only a concise intent sentence in suggestedDescription.\n- Use profile as primary source of personalization.\n- Use active intents as secondary context for consistency.\n- Keep user intent meaning, but make it actionable and specific.\n- Never return an empty suggestion.\n`;\n\nconst clarificationDraftPrompt = `\nYou draft a concise clarification response for a vague intent.\n\nRules:\n- Return both:\n  1) suggestedDescription (specific rewritten intent)\n  2) clarificationMessage (single short message to the user)\n- clarificationMessage must include the suggestion naturally and ask for confirmation.\n- Use this shape: ` + \"`Did you mean: \\\"<suggestedDescription>\\\"?`\" + ` followed by a brief confirmation instruction.\n- Keep it short. No bullet lists. No JSON.\n`;\n\nexport class IntentClarifier {\n  private readonly model: ClarifierStructuredModel;\n  private readonly suggestionModel: ClarifierStructuredModel;\n  private readonly clarificationDraftModel: ClarifierStructuredModel;\n\n  constructor() {\n    const baseModel = createModel(\"intentClarifier\");\n    this.model = baseModel.withStructuredOutput(clarificationSchema, {\n      name: \"intent_clarifier\",\n    });\n    this.suggestionModel = baseModel.withStructuredOutput(suggestionSchema, {\n      name: \"intent_clarifier_suggestion\",\n    });\n    this.clarificationDraftModel = baseModel.withStructuredOutput(\n      clarificationDraftSchema,\n      { name: \"intent_clarifier_message\" }\n    );\n  }\n\n  @Timed()\n  public async invoke(\n    description: string,\n    profileContext: string,\n    activeIntentsContext: string\n  ): Promise<IntentClarifierOutput> {\n    try {\n      const prompt = `\n# User Input Intent\n${description}\n\n# User Profile\n${profileContext || \"none\"}\n\n# Active Intents\n${activeIntentsContext || \"none\"}\n`;\n\n      const result = await invokeWithAbortSignal(this.model, [\n        new SystemMessage(systemPrompt),\n        new HumanMessage(prompt),\n      ]);\n      const parsed = clarificationSchema.parse(result);\n\n      if (parsed.needsClarification) {\n        // Always prefer a dedicated rewrite pass for vague inputs so we avoid generic follow-up text.\n        const draft = await this.generateClarificationDraft(description, profileContext, activeIntentsContext);\n        if (draft) {\n          return {\n            ...parsed,\n            suggestedDescription: draft.suggestedDescription,\n            clarificationMessage: draft.clarificationMessage,\n          };\n        }\n      }\n\n      return parsed;\n    } catch (error) {\n      logger.warn(\"invoke: clarification failed\", { error });\n      return {\n        needsClarification: false,\n        reason: \"fallback_on_model_error\",\n        suggestedDescription: null,\n        clarificationMessage: null,\n      };\n    }\n  }\n\n  private async generateSuggestion(\n    description: string,\n    profileContext: string,\n    activeIntentsContext: string\n  ): Promise<string | null> {\n    try {\n      const prompt = `\n# User Input Intent\n${description}\n\n# User Profile\n${profileContext || \"none\"}\n\n# Active Intents\n${activeIntentsContext || \"none\"}\n`;\n      const output = await invokeWithAbortSignal(this.suggestionModel, [\n        new SystemMessage(suggestionPrompt),\n        new HumanMessage(prompt),\n      ]);\n      const parsed = suggestionSchema.parse(output);\n      const suggestion = parsed.suggestedDescription.trim();\n      return suggestion.length > 0 ? suggestion : null;\n    } catch (error) {\n      logger.warn(\"generateSuggestion: failed\", { error });\n      return null;\n    }\n  }\n\n  private async generateClarificationDraft(\n    description: string,\n    profileContext: string,\n    activeIntentsContext: string\n  ): Promise<{ suggestedDescription: string; clarificationMessage: string } | null> {\n    try {\n      const prompt = `\n# User Input Intent\n${description}\n\n# User Profile\n${profileContext || \"none\"}\n\n# Active Intents\n${activeIntentsContext || \"none\"}\n`;\n      const output = await invokeWithAbortSignal(this.clarificationDraftModel, [\n        new SystemMessage(clarificationDraftPrompt),\n        new HumanMessage(prompt),\n      ]);\n      const parsed = clarificationDraftSchema.parse(output);\n      const suggestedDescription = parsed.suggestedDescription.trim();\n      const clarificationMessage = parsed.clarificationMessage.trim();\n      if (!suggestedDescription || !clarificationMessage) return null;\n      return { suggestedDescription, clarificationMessage };\n    } catch (error) {\n      logger.warn(\"generateClarificationDraft: failed\", { error });\n      const suggestion = await this.generateSuggestion(description, profileContext, activeIntentsContext);\n      if (!suggestion) return null;\n      const clarificationMessage = `Do you mean: ${suggestion}?`;\n      return {\n        suggestedDescription: suggestion,\n        clarificationMessage,\n      };\n    }\n  }\n}\n"]}
+{"version":3,"file":"intent.clarifier.js","sourceRoot":"/","sources":["intent/intent.clarifier.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChatOpenAI } from \"@langchain/openai\";\nimport { HumanMessage, SystemMessage } from \"@langchain/core/messages\";\nimport { z } from \"zod\";\n\nimport { protocolLogger } from \"../shared/observability/protocol.logger.js\";\nimport { Timed } from \"../shared/observability/performance.js\";\n\nimport { createModel } from \"../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../shared/agent/model-signal.js\";\n\nconst logger = protocolLogger(\"IntentClarifier\");\n\ntype ClarifierStructuredModel = ReturnType<ChatOpenAI[\"withStructuredOutput\"]>;\n\nconst clarificationSchema = z.object({\n  needsClarification: z.boolean(),\n  reason: z.string(),\n  suggestedDescription: z.string().nullable(),\n  clarificationMessage: z.string().nullable(),\n});\nconst suggestionSchema = z.object({\n  suggestedDescription: z.string(),\n});\nconst clarificationDraftSchema = z.object({\n  suggestedDescription: z.string(),\n  clarificationMessage: z.string(),\n});\n\nexport type IntentClarifierOutput = z.infer<typeof clarificationSchema>;\n\nconst systemPrompt = `\nYou evaluate whether an intent is specific enough to persist without asking the user to confirm a refinement.\n\nOnly set needsClarification=true when the intent is truly vague — e.g. a single generic phrase with no role, domain, location, or other concrete criteria (like \"find a job\", \"I need help\", \"looking for something\").\n\nDo NOT ask for clarification when the user has already given:\n- A role or type (e.g. \"UX designer\", \"technical co-founder\", \"engineer\")\n- A domain or industry (e.g. \"in AI\", \"climate tech\", \"fintech\")\n- A location or format (e.g. \"remote\", \"Berlin\", \"full-time\")\n- Any other concrete detail that makes the intent actionable\n\nDefault to needsClarification=false when in doubt. Only clarify when the intent is so broad that persisting it as-is would be unhelpful (e.g. literally \"a job\" or \"something\" with no other signal).\n\nRules when needsClarification=true:\n- User Profile is the primary source for suggestedDescription; Active Intents are secondary.\n- You MUST provide a concrete suggestedDescription and short clarificationMessage.\n- Do not include JSON in clarificationMessage.\n`;\n\nconst suggestionPrompt = `\nYou generate one concrete, specific intent rewrite.\n\nRules:\n- Output only a concise intent sentence in suggestedDescription.\n- Use profile as primary source of personalization.\n- Use active intents as secondary context for consistency.\n- Keep user intent meaning, but make it actionable and specific.\n- Never return an empty suggestion.\n`;\n\nconst clarificationDraftPrompt = `\nYou draft a concise clarification response for a vague intent.\n\nRules:\n- Return both:\n  1) suggestedDescription (specific rewritten intent)\n  2) clarificationMessage (single short message to the user)\n- clarificationMessage must include the suggestion naturally and ask for confirmation.\n- Use this shape: ` + \"`Did you mean: \\\"<suggestedDescription>\\\"?`\" + ` followed by a brief confirmation instruction.\n- Keep it short. No bullet lists. No JSON.\n`;\n\nexport class IntentClarifier {\n  private readonly model: ClarifierStructuredModel;\n  private readonly suggestionModel: ClarifierStructuredModel;\n  private readonly clarificationDraftModel: ClarifierStructuredModel;\n\n  constructor() {\n    const baseModel = createModel(\"intentClarifier\");\n    this.model = baseModel.withStructuredOutput(clarificationSchema, {\n      name: \"intent_clarifier\",\n    });\n    this.suggestionModel = baseModel.withStructuredOutput(suggestionSchema, {\n      name: \"intent_clarifier_suggestion\",\n    });\n    this.clarificationDraftModel = baseModel.withStructuredOutput(\n      clarificationDraftSchema,\n      { name: \"intent_clarifier_message\" }\n    );\n  }\n\n  /** Build the shared user prompt with intent, profile, and active-intent context. */\n  private buildPrompt(\n    description: string,\n    profileContext: string,\n    activeIntentsContext: string\n  ): string {\n    return `\n# User Input Intent\n${description}\n\n# User Profile\n${profileContext || \"none\"}\n\n# Active Intents\n${activeIntentsContext || \"none\"}\n`;\n  }\n\n  @Timed()\n  public async invoke(\n    description: string,\n    profileContext: string,\n    activeIntentsContext: string\n  ): Promise<IntentClarifierOutput> {\n    try {\n      const prompt = this.buildPrompt(description, profileContext, activeIntentsContext);\n\n      const result = await invokeWithAbortSignal(this.model, [\n        new SystemMessage(systemPrompt),\n        new HumanMessage(prompt),\n      ]);\n      const parsed = clarificationSchema.parse(result);\n\n      if (parsed.needsClarification) {\n        // Always prefer a dedicated rewrite pass for vague inputs so we avoid generic follow-up text.\n        const draft = await this.generateClarificationDraft(description, profileContext, activeIntentsContext);\n        if (draft) {\n          return {\n            ...parsed,\n            suggestedDescription: draft.suggestedDescription,\n            clarificationMessage: draft.clarificationMessage,\n          };\n        }\n      }\n\n      return parsed;\n    } catch (error) {\n      logger.warn(\"invoke: clarification failed\", { error });\n      return {\n        needsClarification: false,\n        reason: \"fallback_on_model_error\",\n        suggestedDescription: null,\n        clarificationMessage: null,\n      };\n    }\n  }\n\n  private async generateSuggestion(\n    description: string,\n    profileContext: string,\n    activeIntentsContext: string\n  ): Promise<string | null> {\n    try {\n      const prompt = this.buildPrompt(description, profileContext, activeIntentsContext);\n      const output = await invokeWithAbortSignal(this.suggestionModel, [\n        new SystemMessage(suggestionPrompt),\n        new HumanMessage(prompt),\n      ]);\n      const parsed = suggestionSchema.parse(output);\n      const suggestion = parsed.suggestedDescription.trim();\n      return suggestion.length > 0 ? suggestion : null;\n    } catch (error) {\n      logger.warn(\"generateSuggestion: failed\", { error });\n      return null;\n    }\n  }\n\n  private async generateClarificationDraft(\n    description: string,\n    profileContext: string,\n    activeIntentsContext: string\n  ): Promise<{ suggestedDescription: string; clarificationMessage: string } | null> {\n    try {\n      const prompt = this.buildPrompt(description, profileContext, activeIntentsContext);\n      const output = await invokeWithAbortSignal(this.clarificationDraftModel, [\n        new SystemMessage(clarificationDraftPrompt),\n        new HumanMessage(prompt),\n      ]);\n      const parsed = clarificationDraftSchema.parse(output);\n      const suggestedDescription = parsed.suggestedDescription.trim();\n      const clarificationMessage = parsed.clarificationMessage.trim();\n      if (!suggestedDescription || !clarificationMessage) return null;\n      return { suggestedDescription, clarificationMessage };\n    } catch (error) {\n      logger.warn(\"generateClarificationDraft: failed\", { error });\n      const suggestion = await this.generateSuggestion(description, profileContext, activeIntentsContext);\n      if (!suggestion) return null;\n      const clarificationMessage = `Do you mean: ${suggestion}?`;\n      return {\n        suggestedDescription: suggestion,\n        clarificationMessage,\n      };\n    }\n  }\n}\n"]}

package/dist/intent/intent.graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent.graph.d.ts","sourceRoot":"/","sources":["intent/intent.graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAEjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAIhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AA0G7E;;GAEG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ,CAAC;IACjB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,iBAAiB,CAAC;gBAHlB,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,CAAC,EAAE,kBAAkB,YAAA,EAC7B,WAAW,CAAC,EAAE,gBAAgB,YAAA,EAC9B,iBAAiB,CAAC,EAAE,mBAAmB,YAAA;IAG1C,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAiDZ,CAAR;wBAEI,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAFI,CAAR;4BAEI,CAAA;;;;;;;;;;;0BAFI,CAAR;4BAEI,CAAA;;;;;;;;;;;0BAFI,CAAR;4BAEI,CAAA;;;;;;;;;;CAizBH"}
+{"version":3,"file":"intent.graph.d.ts","sourceRoot":"/","sources":["intent/intent.graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAEjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAIhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AA0G7E;;GAEG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ,CAAC;IACjB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,iBAAiB,CAAC;gBAHlB,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,CAAC,EAAE,kBAAkB,YAAA,EAC7B,WAAW,CAAC,EAAE,gBAAgB,YAAA,EAC9B,iBAAiB,CAAC,EAAE,mBAAmB,YAAA;IAG1C,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAiDZ,CAAR;wBAEI,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;sBAFI,CAAR;wBAEI,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAFI,CAAR;4BAEI,CAAA;;;;;;;;;;;0BAFI,CAAR;4BAEI,CAAA;;;;;;;;;;;0BAFI,CAAR;4BAEI,CAAA;;;;;;;;;;CAwzBH"}

package/dist/intent/intent.graph.js

@@ -441,6 +441,33 @@ export class IntentGraphFactory {
                 .trim();
             return out.replace(/[.,;]\s*$/, "").trim() || payload;
         };
+        /**
+         * Generate a flat embedding for an intent payload, swallowing failures so
+         * persistence can continue without an embedding. `intentId` is logging-only
+         * (present for updates, absent for creates).
+         */
+        const generateIntentEmbedding = async (sanitizedPayload, intentId) => {
+            if (!this.embedder)
+                return undefined;
+            try {
+                const embedding = await this.embedder.generate(sanitizedPayload, undefined, getAbortSignalConfig());
+                const flatEmbedding = Array.isArray(embedding?.[0])
+                    ? embedding[0]
+                    : embedding;
+                logger.verbose("Generated embedding for intent", {
+                    ...(intentId ? { intentId } : {}),
+                    dimensions: flatEmbedding?.length,
+                });
+                return flatEmbedding;
+            }
+            catch (embErr) {
+                logger.error("Failed to generate embedding for intent (continuing without)", {
+                    ...(intentId ? { intentId } : {}),
+                    error: embErr,
+                });
+                return undefined;
+            }
+        };
         /**
          * Node 4: Executor
          * Executes reconciler actions against the database.
@@ -467,19 +494,7 @@ export class IntentGraphFactory {
                             const matchedVerifiedIntent = verifiedIntentByPayload.get(createAction.payload) ||
                                 verifiedIntentByPayload.get(sanitizedPayload);
                             // Generate embedding for the intent payload
-                            let flatEmbedding;
-                            if (this.embedder) {
-                                try {
-                                    const embedding = await this.embedder.generate(sanitizedPayload, undefined, getAbortSignalConfig());
-                                    flatEmbedding = Array.isArray(embedding?.[0])
-                                        ? embedding[0]
-                                        : embedding;
-                                    logger.verbose("Generated embedding for new intent", { dimensions: flatEmbedding?.length });
-                                }
-                                catch (embErr) {
-                                    logger.error("Failed to generate embedding for intent (continuing without)", { error: embErr });
-                                }
-                            }
+                            const flatEmbedding = await generateIntentEmbedding(sanitizedPayload);
                             const created = await this.database.createIntent({
                                 userId: state.userId,
                                 payload: sanitizedPayload,
@@ -532,19 +547,7 @@ export class IntentGraphFactory {
                             const matchedVerifiedIntent = verifiedIntentByPayload.get(updateAction.payload) ||
                                 verifiedIntentByPayload.get(sanitizedPayload);
                             // Regenerate embedding for the updated payload
-                            let flatEmbedding;
-                            if (this.embedder) {
-                                try {
-                                    const embedding = await this.embedder.generate(sanitizedPayload, undefined, getAbortSignalConfig());
-                                    flatEmbedding = Array.isArray(embedding?.[0])
-                                        ? embedding[0]
-                                        : embedding;
-                                    logger.verbose("Generated embedding for updated intent", { intentId: updateAction.id, dimensions: flatEmbedding?.length });
-                                }
-                                catch (embErr) {
-                                    logger.error("Failed to generate embedding for intent update (continuing without)", { error: embErr });
-                                }
-                            }
+                            const flatEmbedding = await generateIntentEmbedding(sanitizedPayload, updateAction.id);
                             const updated = await this.database.updateIntent(updateAction.id, {
                                 payload: sanitizedPayload,
                                 embedding: flatEmbedding,