@indexnetwork/protocol 4.5.0-rc.323.1 → 4.5.0-rc.325.1

package/dist/questioner/questioner.env.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Centralized accessors for all question-generation environment variables.
+ *
+ * Naming scheme (one prefix, hierarchical):
+ *
+ *   QUESTIONER_ENABLED                  master switch — QuestionerQueue worker +
+ *                                       enqueue closures at every composition site.
+ *   QUESTIONER_DISCOVERY_ENABLED        per-surface switch — decision questions during
+ *                                       chat/MCP opportunity discovery. Only effective
+ *                                       when the master switch is on (the discovery
+ *                                       question step adds inline summarizer latency,
+ *                                       so operators can turn it off independently).
+ *   QUESTIONER_DISCOVERY_INPUT_MODE     'transcripts' | 'insights' generator input.
+ *   QUESTIONER_DISCOVERY_TIMEOUT_MS     per-call deadline for the discovery-questions
+ *                                       LLM step (default 12s).
+ *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat
+ *                                       tool waits for an inline answer (default 4 min).
+ *
+ * All reads go through this module — do not read these variables via
+ * `process.env` elsewhere. Values are read on every call (no caching) so tests
+ * and long-lived processes observe changes.
+ */
+/**
+ * Question-generator budget. Sized against Railway's ~60 s edge timeout:
+ * the discovery + evaluation + negotiate phases consume ~50 s on the slow
+ * path, leaving ~10 s of headroom for the tail. 12 s is the larger end of
+ * "fits"; the question step usually completes in 4-8 s, so most legitimate
+ * calls finish well inside. Aborted calls return `null` (no questions);
+ * the rest of the discovery payload still ships.
+ */
+export declare const DISCOVERY_QUESTIONS_TIMEOUT_MS_DEFAULT = 12000;
+export declare const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
+/** Master switch: is any background question generation enabled? */
+export declare function isQuestionerEnabled(): boolean;
+/**
+ * Per-surface switch: should chat/MCP opportunity discovery produce decision
+ * questions? Hierarchical — always false when the master switch is off.
+ */
+export declare function isDiscoveryQuestionsEnabled(): boolean;
+/**
+ * Input mode for the discovery question generator. Only `transcripts` is
+ * implemented; any other value falls back to `transcripts` (startup.env.ts
+ * warns on invalid values).
+ */
+export declare function discoveryQuestionsInputMode(): "transcripts" | "insights";
+/** Per-call deadline for the discovery-questions LLM step. */
+export declare function discoveryQuestionsTimeoutMs(): number;
+/** Wait budget for the blocking ask_user_question chat tool. */
+export declare function chatQuestionWaitTimeoutMs(): number;
+//# sourceMappingURL=questioner.env.d.ts.map

package/dist/questioner/questioner.env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questioner.env.d.ts","sourceRoot":"/","sources":["questioner/questioner.env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,sCAAsC,QAAS,CAAC;AAC7D,eAAO,MAAM,qCAAqC,SAAU,CAAC;AAe7D,oEAAoE;AACpE,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,aAAa,GAAG,UAAU,CAIxE;AAED,8DAA8D;AAC9D,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED,gEAAgE;AAChE,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}

package/dist/questioner/questioner.env.js

@@ -0,0 +1,76 @@
+/**
+ * Centralized accessors for all question-generation environment variables.
+ *
+ * Naming scheme (one prefix, hierarchical):
+ *
+ *   QUESTIONER_ENABLED                  master switch — QuestionerQueue worker +
+ *                                       enqueue closures at every composition site.
+ *   QUESTIONER_DISCOVERY_ENABLED        per-surface switch — decision questions during
+ *                                       chat/MCP opportunity discovery. Only effective
+ *                                       when the master switch is on (the discovery
+ *                                       question step adds inline summarizer latency,
+ *                                       so operators can turn it off independently).
+ *   QUESTIONER_DISCOVERY_INPUT_MODE     'transcripts' | 'insights' generator input.
+ *   QUESTIONER_DISCOVERY_TIMEOUT_MS     per-call deadline for the discovery-questions
+ *                                       LLM step (default 12s).
+ *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat
+ *                                       tool waits for an inline answer (default 4 min).
+ *
+ * All reads go through this module — do not read these variables via
+ * `process.env` elsewhere. Values are read on every call (no caching) so tests
+ * and long-lived processes observe changes.
+ */
+/**
+ * Question-generator budget. Sized against Railway's ~60 s edge timeout:
+ * the discovery + evaluation + negotiate phases consume ~50 s on the slow
+ * path, leaving ~10 s of headroom for the tail. 12 s is the larger end of
+ * "fits"; the question step usually completes in 4-8 s, so most legitimate
+ * calls finish well inside. Aborted calls return `null` (no questions);
+ * the rest of the discovery payload still ships.
+ */
+export const DISCOVERY_QUESTIONS_TIMEOUT_MS_DEFAULT = 12000;
+export const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
+/**
+ * Parse a positive integer env var, clamped to the safe-integer range so a
+ * malformed env value cannot crash `AbortSignal.timeout` (which throws on
+ * values outside `[0, MAX_SAFE_INTEGER]`).
+ */
+function positiveIntEnv(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0 || parsed > Number.MAX_SAFE_INTEGER)
+        return fallback;
+    return parsed;
+}
+/** Master switch: is any background question generation enabled? */
+export function isQuestionerEnabled() {
+    return process.env.QUESTIONER_ENABLED === "true";
+}
+/**
+ * Per-surface switch: should chat/MCP opportunity discovery produce decision
+ * questions? Hierarchical — always false when the master switch is off.
+ */
+export function isDiscoveryQuestionsEnabled() {
+    return isQuestionerEnabled() && process.env.QUESTIONER_DISCOVERY_ENABLED === "true";
+}
+/**
+ * Input mode for the discovery question generator. Only `transcripts` is
+ * implemented; any other value falls back to `transcripts` (startup.env.ts
+ * warns on invalid values).
+ */
+export function discoveryQuestionsInputMode() {
+    return process.env.QUESTIONER_DISCOVERY_INPUT_MODE?.trim() === "insights"
+        ? "insights"
+        : "transcripts";
+}
+/** Per-call deadline for the discovery-questions LLM step. */
+export function discoveryQuestionsTimeoutMs() {
+    return positiveIntEnv("QUESTIONER_DISCOVERY_TIMEOUT_MS", DISCOVERY_QUESTIONS_TIMEOUT_MS_DEFAULT);
+}
+/** Wait budget for the blocking ask_user_question chat tool. */
+export function chatQuestionWaitTimeoutMs() {
+    return positiveIntEnv("QUESTIONER_CHAT_WAIT_TIMEOUT_MS", CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT);
+}
+//# sourceMappingURL=questioner.env.js.map

package/dist/questioner/questioner.env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questioner.env.js","sourceRoot":"/","sources":["questioner/questioner.env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,KAAM,CAAC;AAC7D,MAAM,CAAC,MAAM,qCAAqC,GAAG,MAAO,CAAC;AAE7D;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,QAAgB;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,GAAG,MAAM,CAAC,gBAAgB;QAAE,OAAO,QAAQ,CAAC;IACjG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,mBAAmB;IACjC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,mBAAmB,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,MAAM,CAAC;AACtF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,IAAI,EAAE,KAAK,UAAU;QACvE,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,aAAa,CAAC;AACpB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,2BAA2B;IACzC,OAAO,cAAc,CAAC,iCAAiC,EAAE,sCAAsC,CAAC,CAAC;AACnG,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,yBAAyB;IACvC,OAAO,cAAc,CAAC,iCAAiC,EAAE,qCAAqC,CAAC,CAAC;AAClG,CAAC","sourcesContent":["/**\n * Centralized accessors for all question-generation environment variables.\n *\n * Naming scheme (one prefix, hierarchical):\n *\n *   QUESTIONER_ENABLED                  master switch — QuestionerQueue worker +\n *                                       enqueue closures at every composition site.\n *   QUESTIONER_DISCOVERY_ENABLED        per-surface switch — decision questions during\n *                                       chat/MCP opportunity discovery. Only effective\n *                                       when the master switch is on (the discovery\n *                                       question step adds inline summarizer latency,\n *                                       so operators can turn it off independently).\n *   QUESTIONER_DISCOVERY_INPUT_MODE     'transcripts' | 'insights' generator input.\n *   QUESTIONER_DISCOVERY_TIMEOUT_MS     per-call deadline for the discovery-questions\n *                                       LLM step (default 12s).\n *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat\n *                                       tool waits for an inline answer (default 4 min).\n *\n * All reads go through this module — do not read these variables via\n * `process.env` elsewhere. Values are read on every call (no caching) so tests\n * and long-lived processes observe changes.\n */\n\n/**\n * Question-generator budget. Sized against Railway's ~60 s edge timeout:\n * the discovery + evaluation + negotiate phases consume ~50 s on the slow\n * path, leaving ~10 s of headroom for the tail. 12 s is the larger end of\n * \"fits\"; the question step usually completes in 4-8 s, so most legitimate\n * calls finish well inside. Aborted calls return `null` (no questions);\n * the rest of the discovery payload still ships.\n */\nexport const DISCOVERY_QUESTIONS_TIMEOUT_MS_DEFAULT = 12_000;\nexport const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240_000;\n\n/**\n * Parse a positive integer env var, clamped to the safe-integer range so a\n * malformed env value cannot crash `AbortSignal.timeout` (which throws on\n * values outside `[0, MAX_SAFE_INTEGER]`).\n */\nfunction positiveIntEnv(name: string, fallback: number): number {\n  const raw = process.env[name];\n  if (!raw) return fallback;\n  const parsed = Number.parseInt(raw, 10);\n  if (!Number.isFinite(parsed) || parsed <= 0 || parsed > Number.MAX_SAFE_INTEGER) return fallback;\n  return parsed;\n}\n\n/** Master switch: is any background question generation enabled? */\nexport function isQuestionerEnabled(): boolean {\n  return process.env.QUESTIONER_ENABLED === \"true\";\n}\n\n/**\n * Per-surface switch: should chat/MCP opportunity discovery produce decision\n * questions? Hierarchical — always false when the master switch is off.\n */\nexport function isDiscoveryQuestionsEnabled(): boolean {\n  return isQuestionerEnabled() && process.env.QUESTIONER_DISCOVERY_ENABLED === \"true\";\n}\n\n/**\n * Input mode for the discovery question generator. Only `transcripts` is\n * implemented; any other value falls back to `transcripts` (startup.env.ts\n * warns on invalid values).\n */\nexport function discoveryQuestionsInputMode(): \"transcripts\" | \"insights\" {\n  return process.env.QUESTIONER_DISCOVERY_INPUT_MODE?.trim() === \"insights\"\n    ? \"insights\"\n    : \"transcripts\";\n}\n\n/** Per-call deadline for the discovery-questions LLM step. */\nexport function discoveryQuestionsTimeoutMs(): number {\n  return positiveIntEnv(\"QUESTIONER_DISCOVERY_TIMEOUT_MS\", DISCOVERY_QUESTIONS_TIMEOUT_MS_DEFAULT);\n}\n\n/** Wait budget for the blocking ask_user_question chat tool. */\nexport function chatQuestionWaitTimeoutMs(): number {\n  return positiveIntEnv(\"QUESTIONER_CHAT_WAIT_TIMEOUT_MS\", CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT);\n}\n"]}

package/dist/questioner/questioner.types.d.ts

@@ -85,6 +85,13 @@ export interface QuestionerInput {
     scopeType?: ToolScopeType;
     /** Scoped question id. When scopeType is `network`, this is the actor networkId. */
     scopeId?: string;
+    /**
+     * Intent that triggered the run that generated these questions. Persisted as
+     * `detection.triggeredBy` so intent-scoped surfaces (e.g. the intent page)
+     * can find them. Independent of `scopeType`/`scopeId`, which may carry a
+     * network scope at the same time.
+     */
+    triggeredByIntentId?: string;
     /** Conversation ID — set when the question originates from a chat session. Persisted on the question row for frontend filtering. */
     conversationId?: string;
     /** Assistant message ID — set when we know which message triggered the question. Stored in detection.messageId for inline anchoring. */

package/dist/questioner/questioner.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"questioner.types.d.ts","sourceRoot":"/","sources":["questioner/questioner.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;IACH,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAEvD,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErF,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,IAAI,EAAE,YAAY,CAAC;IACnB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kFAAkF;IAClF,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oIAAoI;IACpI,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wIAAwI;IACxI,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"questioner.types.d.ts","sourceRoot":"/","sources":["questioner/questioner.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;IACH,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAEvD,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErF,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,IAAI,EAAE,YAAY,CAAC;IACnB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kFAAkF;IAClF,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oIAAoI;IACpI,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wIAAwI;IACxI,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/questioner/questioner.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"questioner.types.js","sourceRoot":"/","sources":["questioner/questioner.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * QuestionerAgent input types. The `QuestionerInput` envelope carries a `mode`\n * field that selects a preset, plus a polymorphic `context` that varies per mode.\n *\n * Slice 1 defines all four context shapes but only `DiscoveryContext` has a\n * working preset implementation. The others are type stubs for future slices.\n */\nimport type { DiscoveryQuestionInput } from \"../opportunity/question.prompt.js\";\nimport type { ToolScopeType } from \"../shared/agent/tool.scope.js\";\nimport type { QuestionMode } from \"../shared/schemas/question.schema.js\";\n\n// ─── Per-mode context types ─────────────────────────────────────────────────\n\n/**\n * Discovery context — wraps the existing DiscoveryQuestionInput wholesale.\n * The discovery preset's buildPrompt delegates to the migrated builder.\n */\nexport type DiscoveryContext = DiscoveryQuestionInput;\n\n/** Intent context — data needed to generate questions about an intent. */\nexport interface IntentContext {\n  intentId: string;\n  payload: string;\n  summary?: string;\n  /** The user's global user_context paragraph (profile-replacing identity text). */\n  userContext?: string;\n}\n\n/** Profile context — data needed to generate questions to fill profile gaps. */\nexport interface ProfileContext {\n  /** The user's global user_context paragraph (profile-replacing identity text). */\n  userContext?: string;\n  gaps: string[];\n  /** Existing premise texts the user has already stated (e.g. \"I live in Berlin\"). */\n  existingPremises?: string[];\n}\n\n/** Negotiation context — data from a stalled or capped negotiation. */\nexport interface NegotiationContext {\n  negotiationId: string;\n  counterpartyHint: string;\n  indexContext: string;\n  outcomeReason: \"turn_cap\" | \"timeout\" | \"stalled\";\n  keyTake: string;\n  /** The user's global user_context paragraph (profile-replacing identity text). */\n  userContext?: string;\n}\n\n/**\n * Chat context — data for orchestrator-initiated mid-conversation questions\n * (the `ask_user_question` tool). The orchestrator states what it needs to\n * learn; the QuestionerAgent turns that into polished structured questions,\n * grounded in the recent conversation and the user's identity context.\n */\nexport interface ChatContext {\n  /** What the orchestrator needs to learn and why (authored by the chat model). */\n  purpose: string;\n  /** Draft questions proposed by the orchestrator. The agent refines these. */\n  draftQuestions?: Array<{\n    prompt: string;\n    options?: string[];\n    multiSelect?: boolean;\n  }>;\n  /** Recent conversation excerpt for grounding (most recent messages last). */\n  conversationExcerpt?: string;\n  /** The user's global user_context paragraph (profile-replacing identity text). */\n  userContext?: string;\n}\n\n/** Discriminated union: mode selects the context shape. */\nexport type QuestionerContext =\n  | DiscoveryContext\n  | IntentContext\n  | ProfileContext\n  | NegotiationContext\n  | ChatContext;\n\n/**\n * Payload shape accepted by the questionerEnqueue callback. Covers all\n * question modes — the composition root bridges this to the concrete\n * QuestionerQueue.\n */\nexport type QuestionerEnqueuePayload = QuestionerInput;\n\n/** Callback signature for async question generation enqueue. */\nexport type QuestionerEnqueueFn = (input: QuestionerEnqueuePayload) => Promise<void>;\n\n/** Top-level input envelope for QuestionerAgent.invoke(). */\nexport interface QuestionerInput {\n  /** Selects the preset (system prompt + builder). */\n  mode: QuestionMode;\n  /** User the questions are generated for. */\n  userId: string;\n  /** Entity type that triggered this (e.g. \"opportunity\", \"intent\", \"profile\"). */\n  sourceType: string;\n  /** ID of the triggering entity. */\n  sourceId: string;\n  /** Mode-specific context. Must align with the selected mode. */\n  context: QuestionerContext;\n  /** Scoped question context. Network scopes persist as QuestionActor.networkId. */\n  scopeType?: ToolScopeType;\n  /** Scoped question id. When scopeType is `network`, this is the actor networkId. */\n  scopeId?: string;\n  /** Conversation ID — set when the question originates from a chat session. Persisted on the question row for frontend filtering. */\n  conversationId?: string;\n  /** Assistant message ID — set when we know which message triggered the question. Stored in detection.messageId for inline anchoring. */\n  messageId?: string;\n}\n"]}
+{"version":3,"file":"questioner.types.js","sourceRoot":"/","sources":["questioner/questioner.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * QuestionerAgent input types. The `QuestionerInput` envelope carries a `mode`\n * field that selects a preset, plus a polymorphic `context` that varies per mode.\n *\n * Slice 1 defines all four context shapes but only `DiscoveryContext` has a\n * working preset implementation. The others are type stubs for future slices.\n */\nimport type { DiscoveryQuestionInput } from \"../opportunity/question.prompt.js\";\nimport type { ToolScopeType } from \"../shared/agent/tool.scope.js\";\nimport type { QuestionMode } from \"../shared/schemas/question.schema.js\";\n\n// ─── Per-mode context types ─────────────────────────────────────────────────\n\n/**\n * Discovery context — wraps the existing DiscoveryQuestionInput wholesale.\n * The discovery preset's buildPrompt delegates to the migrated builder.\n */\nexport type DiscoveryContext = DiscoveryQuestionInput;\n\n/** Intent context — data needed to generate questions about an intent. */\nexport interface IntentContext {\n  intentId: string;\n  payload: string;\n  summary?: string;\n  /** The user's global user_context paragraph (profile-replacing identity text). */\n  userContext?: string;\n}\n\n/** Profile context — data needed to generate questions to fill profile gaps. */\nexport interface ProfileContext {\n  /** The user's global user_context paragraph (profile-replacing identity text). */\n  userContext?: string;\n  gaps: string[];\n  /** Existing premise texts the user has already stated (e.g. \"I live in Berlin\"). */\n  existingPremises?: string[];\n}\n\n/** Negotiation context — data from a stalled or capped negotiation. */\nexport interface NegotiationContext {\n  negotiationId: string;\n  counterpartyHint: string;\n  indexContext: string;\n  outcomeReason: \"turn_cap\" | \"timeout\" | \"stalled\";\n  keyTake: string;\n  /** The user's global user_context paragraph (profile-replacing identity text). */\n  userContext?: string;\n}\n\n/**\n * Chat context — data for orchestrator-initiated mid-conversation questions\n * (the `ask_user_question` tool). The orchestrator states what it needs to\n * learn; the QuestionerAgent turns that into polished structured questions,\n * grounded in the recent conversation and the user's identity context.\n */\nexport interface ChatContext {\n  /** What the orchestrator needs to learn and why (authored by the chat model). */\n  purpose: string;\n  /** Draft questions proposed by the orchestrator. The agent refines these. */\n  draftQuestions?: Array<{\n    prompt: string;\n    options?: string[];\n    multiSelect?: boolean;\n  }>;\n  /** Recent conversation excerpt for grounding (most recent messages last). */\n  conversationExcerpt?: string;\n  /** The user's global user_context paragraph (profile-replacing identity text). */\n  userContext?: string;\n}\n\n/** Discriminated union: mode selects the context shape. */\nexport type QuestionerContext =\n  | DiscoveryContext\n  | IntentContext\n  | ProfileContext\n  | NegotiationContext\n  | ChatContext;\n\n/**\n * Payload shape accepted by the questionerEnqueue callback. Covers all\n * question modes — the composition root bridges this to the concrete\n * QuestionerQueue.\n */\nexport type QuestionerEnqueuePayload = QuestionerInput;\n\n/** Callback signature for async question generation enqueue. */\nexport type QuestionerEnqueueFn = (input: QuestionerEnqueuePayload) => Promise<void>;\n\n/** Top-level input envelope for QuestionerAgent.invoke(). */\nexport interface QuestionerInput {\n  /** Selects the preset (system prompt + builder). */\n  mode: QuestionMode;\n  /** User the questions are generated for. */\n  userId: string;\n  /** Entity type that triggered this (e.g. \"opportunity\", \"intent\", \"profile\"). */\n  sourceType: string;\n  /** ID of the triggering entity. */\n  sourceId: string;\n  /** Mode-specific context. Must align with the selected mode. */\n  context: QuestionerContext;\n  /** Scoped question context. Network scopes persist as QuestionActor.networkId. */\n  scopeType?: ToolScopeType;\n  /** Scoped question id. When scopeType is `network`, this is the actor networkId. */\n  scopeId?: string;\n  /**\n   * Intent that triggered the run that generated these questions. Persisted as\n   * `detection.triggeredBy` so intent-scoped surfaces (e.g. the intent page)\n   * can find them. Independent of `scopeType`/`scopeId`, which may carry a\n   * network scope at the same time.\n   */\n  triggeredByIntentId?: string;\n  /** Conversation ID — set when the question originates from a chat session. Persisted on the question row for frontend filtering. */\n  conversationId?: string;\n  /** Assistant message ID — set when we know which message triggered the question. Stored in detection.messageId for inline anchoring. */\n  messageId?: string;\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,EAAmE,MAAM,mBAAmB,CAAC;AAiBhJ,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,kBA6NzC;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;AAiBhJ,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,kBA+NzC;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC"}

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

@@ -72,7 +72,8 @@ export async function createChatTools(deps, preResolvedContext) {
      */
     function defineTool(opts) {
         return tool(async (query) => {
-            logger.info(`Tool: ${opts.name}`, {
+            logger.info('Tool invoked', {
+                toolName: opts.name,
                 context: { userId: resolvedContext.userId, scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId },
                 query: redactSensitiveFields(query),
             });
@@ -85,7 +86,8 @@ export async function createChatTools(deps, preResolvedContext) {
                 });
             }
             catch (err) {
-                logger.error(`${opts.name} failed`, {
+                logger.error('Tool failed', {
+                    toolName: opts.name,
                     error: err instanceof Error ? err.message : String(err),
                 });
                 const runtimeResult = toolRuntimeErrorToResult(err);

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 { EnrichmentGraphFactory } from \"../../enrichment/enrichment.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 { deriveAllowedNetworkIds, scopeFromNetworkId } from \"./tool.scope.js\";\nimport { invokeToolRuntime, toolRuntimeErrorToResult } from \"./tool.runtime.js\";\nimport { createEnrichmentTools } from \"../../enrichment/enrichment.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\";\nimport { createQuestionerTools } from \"../../questioner/questioner.tools.js\";\nimport { createAskUserQuestionTools } from \"../../questioner/questioner.ask.tool.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/network 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  const explicitScope = deps.scopeType && deps.scopeId\n    ? { scopeType: deps.scopeType, scopeId: deps.scopeId }\n    : scopeFromNetworkId(deps.networkId);\n\n  // ─── Resolve context from DB ───────────────────────────────────────────────\n  // resolveChatContext still accepts a networkId because it loads scoped index\n  // presentation metadata; the canonical request scope is explicitScope.\n  const resolvedContext =\n    preResolvedContext ??\n    (await resolveChatContext({\n      database,\n      userId: deps.userId,\n      networkId: explicitScope.scopeType === 'network' ? explicitScope.scopeId : deps.networkId,\n      sessionId: deps.sessionId,\n      contactsEnabled: deps.contactsEnabled,\n    }));\n\n  if (!preResolvedContext && explicitScope.scopeType && explicitScope.scopeId) {\n    resolvedContext.scopeType = explicitScope.scopeType;\n    resolvedContext.scopeId = explicitScope.scopeId;\n  }\n\n  const allowedNetworkIds = deriveAllowedNetworkIds({\n    memberships: resolvedContext.userNetworks,\n    ...(resolvedContext.scopeType && resolvedContext.scopeId\n      ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }\n      : {}),\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, scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId },\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 scoped/session context when available.\n  const sessionAwareEnqueue: QuestionerEnqueueFn | undefined = deps.questionerEnqueue\n    ? (input) => deps.questionerEnqueue!({\n        ...input,\n        ...(resolvedContext.scopeType && resolvedContext.scopeId && !input.scopeId\n          ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }\n          : {}),\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 EnrichmentGraphFactory(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 derives concrete allowed network IDs from the\n  // focused scope envelope plus memberships, rather than consuming a transported\n  // legacy indexScope array.\n  const userDb = deps.userDb ?? deps.createUserDatabase(database, resolvedContext.userId);\n  const systemDb = deps.systemDb ?? deps.createSystemDatabase(database, resolvedContext.userId, allowedNetworkIds, 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    enrichmentRuns: deps.enrichmentRuns,\n    enrichmentRunQueue: deps.enrichmentRunQueue,\n    mintConnectToken: deps.mintConnectToken,\n    mintConnectLink: deps.mintConnectLink,\n    frontendUrl: deps.frontendUrl,\n    apiBaseUrl: deps.apiBaseUrl,\n    ...(deps.chatSummary && { chatSummary: deps.chatSummary }),\n    ...(deps.questionGenerator && { questionGenerator: deps.questionGenerator }),\n    ...(sessionAwareEnqueue && { questionerEnqueue: sessionAwareEnqueue }),\n    ...(deps.findPendingQuestions && { findPendingQuestions: deps.findPendingQuestions }),\n    ...(deps.negotiationSummary && { negotiationSummary: deps.negotiationSummary }),\n    ...(deps.chatQuestions && { chatQuestions: deps.chatQuestions }),\n    ...(deps.chatSession && { chatSession: deps.chatSession }),\n    ...(deps.getUserContextText && { getUserContextText: deps.getUserContextText }),\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 = createEnrichmentTools(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  const questionerTools = createQuestionerTools(defineTool, toolDeps);\n  // Blocking mid-conversation questions — chat-only (never in the MCP registry),\n  // and only when the host provides the ChatQuestionsHost bridge.\n  const askUserQuestionTools = deps.chatQuestions\n    ? createAskUserQuestionTools(defineTool, toolDeps)\n    : [];\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    ...questionerTools,\n    ...askUserQuestionTools,\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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAIrE,OAAO,EAA6D,kBAAkB,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChJ,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAMrF,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAE3C,kFAAkF;AAClF,eAAe;AACf,kFAAkF;AAElF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAiB,EACjB,kBAAwC;IAExC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE7C,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO;QAClD,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;QACtD,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEvC,8EAA8E;IAC9E,6EAA6E;IAC7E,uEAAuE;IACvE,MAAM,eAAe,GACnB,kBAAkB;QAClB,CAAC,MAAM,kBAAkB,CAAC;YACxB,QAAQ;YACR,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,aAAa,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS;YACzF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC,CAAC,CAAC;IAEN,IAAI,CAAC,kBAAkB,IAAI,aAAa,CAAC,SAAS,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;QAC5E,eAAe,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;QACpD,eAAe,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;IAClD,CAAC;IAED,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;QAChD,WAAW,EAAE,eAAe,CAAC,YAAY;QACzC,GAAG,CAAC,eAAe,CAAC,SAAS,IAAI,eAAe,CAAC,OAAO;YACtD,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;YAC5E,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IAEH,8EAA8E;IAC9E;;;OAGG;IACH,SAAS,UAAU,CAAsB,IAKxC;QACC,OAAO,IAAI,CACT,KAAK,EAAE,KAAiB,EAAE,EAAE;YAC1B,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;gBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,OAAO,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;gBACnH,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC;aACpC,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,OAAO,MAAM,iBAAiB,CAAC;oBAC7B,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAmB,EAAE,CAAC,EAAE;oBACtG,OAAO,EAAE,eAAe;oBACxB,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE;oBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;gBACH,MAAM,aAAa,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;gBACpD,IAAI,aAAa;oBAAE,OAAO,aAAa,CAAC;gBACxC,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,OAAO,KAAK,CAAC,qBAAqB,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,8EAA8E;IAE9E,2EAA2E;IAC3E,MAAM,mBAAmB,GAAoC,IAAI,CAAC,iBAAiB;QACjF,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAkB,CAAC;YACjC,GAAG,KAAK;YACR,GAAG,CAAC,eAAe,CAAC,SAAS,IAAI,eAAe,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO;gBACxE,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;gBAC5E,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,eAAe,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7G,CAAC;QACJ,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,WAAW,EAAE,CAAC;IACpH,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/E,MAAM,YAAY,GAAG,IAAI,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IACnI,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IAC1C,MAAM,iBAAiB,GAAG,IAAI,gBAAgB,CAC5C,QAAwC,EACxC,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,CACd,CAAC,WAAW,EAAE,CAAC;IAChB,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe;QAC3C,CAAC,CAAC,IAAI,uBAAuB,CACzB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,uBAAuB,EAC5B,mBAAmB,CACpB,CAAC,WAAW,EAAE;QACjB,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,gBAAgB,GAAG,IAAI,uBAAuB,CAClD,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,SAAS,EAAE,sBAAsB;IACjC,SAAS,EAAE,oBAAoB;IAC/B,gBAAgB,EAChB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,sBAAsB,CAC5B,CAAC,WAAW,EAAE,CAAC;IAChB,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,MAAM,sBAAsB,GAAG,IAAI,6BAA6B,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACzF,MAAM,kBAAkB,GAAG,IAAI,yBAAyB,CAAC,QAAQ,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAEtG,8EAA8E;IAC9E,oFAAoF;IACpF,0FAA0F;IAC1F,iEAAiE;IACjE,EAAE;IACF,8EAA8E;IAC9E,+EAA+E;IAC/E,2BAA2B;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAE3H,8EAA8E;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACrC,MAAM,QAAQ,GAAa;QACzB,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,KAAK;QACL,WAAW;QACX,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;QACrD,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,6BAA6B,EAAE,IAAI,CAAC,6BAA6B;QACjE,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5E,GAAG,CAAC,mBAAmB,IAAI,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,EAAE,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACrF,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC/E,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC/E,MAAM,EAAE;YACN,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,YAAY;YACnB,iBAAiB,EAAE,sBAAsB;YACzC,WAAW,EAAE,kBAAkB;YAC/B,WAAW,EAAE,gBAAgB;YAC7B,OAAO,EAAE,YAAY;SACtB;KACF,CAAC;IAEF,6EAA6E;IAC7E,MAAM,YAAY,GAAG,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe;QAC3C,CAAC,CAAC,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC9C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACpE,+EAA+E;IAC/E,gEAAgE;IAChE,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa;QAC7C,CAAC,CAAC,0BAA0B,CAAC,UAAU,EAAE,QAAQ,CAAC;QAClD,CAAC,CAAC,EAAE,CAAC;IAEP,oFAAoF;IACpF,uCAAuC;IACvC,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC;QAC5C,8BAA8B;KAC/B,CAAC,CAAC;IACH,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,MAAM,CACrD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,6BAA6B,CAAC,GAAG,CAAE,CAAsB,CAAC,IAAI,CAAC,CACxE,CAAC;IAEF,OAAO;QACL,GAAG,YAAY;QACf,GAAG,WAAW;QACd,GAAG,YAAY;QACf,GAAG,uBAAuB;QAC1B,GAAG,YAAY;QACf,GAAG,gBAAgB;QACnB,GAAG,YAAY;QACf,GAAG,UAAU;QACb,GAAG,gBAAgB;QACnB,GAAG,YAAY;QACf,GAAG,eAAe;QAClB,GAAG,oBAAoB;KACxB,CAAC;AACJ,CAAC","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 { EnrichmentGraphFactory } from \"../../enrichment/enrichment.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 { deriveAllowedNetworkIds, scopeFromNetworkId } from \"./tool.scope.js\";\nimport { invokeToolRuntime, toolRuntimeErrorToResult } from \"./tool.runtime.js\";\nimport { createEnrichmentTools } from \"../../enrichment/enrichment.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\";\nimport { createQuestionerTools } from \"../../questioner/questioner.tools.js\";\nimport { createAskUserQuestionTools } from \"../../questioner/questioner.ask.tool.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/network 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  const explicitScope = deps.scopeType && deps.scopeId\n    ? { scopeType: deps.scopeType, scopeId: deps.scopeId }\n    : scopeFromNetworkId(deps.networkId);\n\n  // ─── Resolve context from DB ───────────────────────────────────────────────\n  // resolveChatContext still accepts a networkId because it loads scoped index\n  // presentation metadata; the canonical request scope is explicitScope.\n  const resolvedContext =\n    preResolvedContext ??\n    (await resolveChatContext({\n      database,\n      userId: deps.userId,\n      networkId: explicitScope.scopeType === 'network' ? explicitScope.scopeId : deps.networkId,\n      sessionId: deps.sessionId,\n      contactsEnabled: deps.contactsEnabled,\n    }));\n\n  if (!preResolvedContext && explicitScope.scopeType && explicitScope.scopeId) {\n    resolvedContext.scopeType = explicitScope.scopeType;\n    resolvedContext.scopeId = explicitScope.scopeId;\n  }\n\n  const allowedNetworkIds = deriveAllowedNetworkIds({\n    memberships: resolvedContext.userNetworks,\n    ...(resolvedContext.scopeType && resolvedContext.scopeId\n      ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }\n      : {}),\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 invoked', {\n          toolName: opts.name,\n          context: { userId: resolvedContext.userId, scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId },\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('Tool failed', {\n            toolName: opts.name,\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 scoped/session context when available.\n  const sessionAwareEnqueue: QuestionerEnqueueFn | undefined = deps.questionerEnqueue\n    ? (input) => deps.questionerEnqueue!({\n        ...input,\n        ...(resolvedContext.scopeType && resolvedContext.scopeId && !input.scopeId\n          ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }\n          : {}),\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 EnrichmentGraphFactory(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 derives concrete allowed network IDs from the\n  // focused scope envelope plus memberships, rather than consuming a transported\n  // legacy indexScope array.\n  const userDb = deps.userDb ?? deps.createUserDatabase(database, resolvedContext.userId);\n  const systemDb = deps.systemDb ?? deps.createSystemDatabase(database, resolvedContext.userId, allowedNetworkIds, 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    enrichmentRuns: deps.enrichmentRuns,\n    enrichmentRunQueue: deps.enrichmentRunQueue,\n    mintConnectToken: deps.mintConnectToken,\n    mintConnectLink: deps.mintConnectLink,\n    frontendUrl: deps.frontendUrl,\n    apiBaseUrl: deps.apiBaseUrl,\n    ...(deps.chatSummary && { chatSummary: deps.chatSummary }),\n    ...(deps.questionGenerator && { questionGenerator: deps.questionGenerator }),\n    ...(sessionAwareEnqueue && { questionerEnqueue: sessionAwareEnqueue }),\n    ...(deps.findPendingQuestions && { findPendingQuestions: deps.findPendingQuestions }),\n    ...(deps.negotiationSummary && { negotiationSummary: deps.negotiationSummary }),\n    ...(deps.chatQuestions && { chatQuestions: deps.chatQuestions }),\n    ...(deps.chatSession && { chatSession: deps.chatSession }),\n    ...(deps.getUserContextText && { getUserContextText: deps.getUserContextText }),\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 = createEnrichmentTools(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  const questionerTools = createQuestionerTools(defineTool, toolDeps);\n  // Blocking mid-conversation questions — chat-only (never in the MCP registry),\n  // and only when the host provides the ChatQuestionsHost bridge.\n  const askUserQuestionTools = deps.chatQuestions\n    ? createAskUserQuestionTools(defineTool, toolDeps)\n    : [];\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    ...questionerTools,\n    ...askUserQuestionTools,\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.registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.registry.d.ts","sourceRoot":"/","sources":["shared/agent/tool.registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmC,QAAQ,EAAqB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAmBpH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAwF/D"}
+{"version":3,"file":"tool.registry.d.ts","sourceRoot":"/","sources":["shared/agent/tool.registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmC,QAAQ,EAAqB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAmBpH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CA0F/D"}

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

@@ -32,7 +32,8 @@ export function createToolRegistry(deps) {
             description: opts.description,
             schema: opts.querySchema,
             handler: async (input) => {
-                logger.verbose(`Tool: ${opts.name}`, {
+                logger.verbose('Tool invoked', {
+                    toolName: opts.name,
                     context: { userId: input.context.userId, scopeType: input.context.scopeType, scopeId: input.context.scopeId },
                     query: redactSensitiveFields(input.query),
                 });
@@ -44,7 +45,8 @@ export function createToolRegistry(deps) {
                     if (abortSignal?.aborted) {
                         throw err;
                     }
-                    logger.error(`${opts.name} failed`, {
+                    logger.error('Tool failed', {
+                        toolName: opts.name,
                         error: err instanceof Error ? err.message : String(err),
                     });
                     return error(`Failed to execute ${opts.name}: ${err instanceof Error ? err.message : String(err)}`);
@@ -90,7 +92,7 @@ export function createToolRegistry(deps) {
     for (const [oldName, canonicalName] of DEPRECATED_TOOL_ALIASES) {
         const canonical = registry.get(canonicalName);
         if (!canonical) {
-            logger.warn(`Cannot register deprecated alias ${oldName}: canonical ${canonicalName} not found`);
+            logger.warn('Cannot register deprecated alias: canonical tool not found', { alias: oldName, canonicalName });
             continue;
         }
         registry.set(oldName, {
@@ -99,7 +101,7 @@ export function createToolRegistry(deps) {
             description: `[DEPRECATED — use \`${canonicalName}\` instead; this alias is retained for backward compatibility and will be removed.] ${canonical.description}`,
         });
     }
-    logger.verbose(`Tool registry created with ${registry.size} tools`);
+    logger.verbose('Tool registry created', { toolCount: registry.size });
     return registry;
 }
 //# sourceMappingURL=tool.registry.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool.registry.js","sourceRoot":"/","sources":["shared/agent/tool.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport type { DefineTool, ResolvedToolContext, ToolDeps, RawToolDefinition, ToolRegistry } from './tool.helpers.js';\nimport { error, redactSensitiveFields } from './tool.helpers.js';\nimport { createEnrichmentTools } from '../../enrichment/enrichment.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 { createChatTools } from '../../chat/chat.tools.js';\nimport { createPremiseTools } from '../../premise/premise.tools.js';\nimport { createQuestionerTools } from '../../questioner/questioner.tools.js';\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { requestContext } from '../observability/request-context.js';\n\nconst logger = protocolLogger('ToolRegistry');\n\n/**\n * Creates a tool registry containing all tool handlers indexed by name.\n * Handlers are raw async functions (not LangChain tool() wrappers) that\n * accept { context, query } and return a JSON string.\n *\n * @param deps - Shared tool dependencies (graphs, database, embedder, etc.)\n * @param context - Resolved user context for this request.\n * @returns Map of tool name to raw tool definition.\n */\nexport function createToolRegistry(deps: ToolDeps): ToolRegistry {\n  const registry: ToolRegistry = new Map();\n\n  // defineTool that captures raw handlers into the registry\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    const entry: RawToolDefinition = {\n      name: opts.name,\n      description: opts.description,\n      schema: opts.querySchema,\n      handler: async (input: { context: ResolvedToolContext; query: unknown }) => {\n        logger.verbose(`Tool: ${opts.name}`, {\n          context: { userId: input.context.userId, scopeType: input.context.scopeType, scopeId: input.context.scopeId },\n          query: redactSensitiveFields(input.query),\n        });\n        try {\n          return await opts.handler({ context: input.context, query: input.query as z.infer<T> });\n        } catch (err) {\n          const abortSignal = requestContext.getStore()?.abortSignal;\n          if (abortSignal?.aborted) {\n            throw err;\n          }\n          logger.error(`${opts.name} failed`, {\n            error: err instanceof Error ? err.message : String(err),\n          });\n          return error(`Failed to execute ${opts.name}: ${err instanceof Error ? err.message : String(err)}`);\n        }\n      },\n    };\n\n    registry.set(opts.name, entry);\n\n    // Return a dummy — create*Tools functions collect return values into arrays,\n    // but for the registry path we only need the side-effect on the Map.\n    return null as unknown;\n  }\n\n  // Create all tool domains -- each one calls defineTool() which populates the registry.\n  // The local defineTool is compatible with DefineTool (which returns any).\n  const dt = defineTool as DefineTool;\n  createEnrichmentTools(dt, deps);\n  createIntentTools(dt, deps);\n  createNetworkTools(dt, deps);\n  createOpportunityTools(dt, deps);\n  createUtilityTools(dt, deps);\n  createIntegrationTools(dt, deps);\n  createContactTools(dt, deps);\n  createAgentTools(dt, deps);\n  createNegotiationTools(dt, deps);\n  createPremiseTools(dt, deps);\n  createQuestionerTools(dt, deps);\n  if (deps.chatSession) {\n    createChatTools(dt, deps);\n  }\n\n  // Deprecated tool-name aliases (IND-371). The canonical implementations are now\n  // registered under their *_user_context / *_enrichment_run names; we expose the\n  // legacy *_user_profile / *_profile_run names as thin aliases that delegate to the\n  // exact same handler + schema, so existing MCP clients keep working while they\n  // migrate. The old names are removed in IND-373.\n  const DEPRECATED_TOOL_ALIASES: ReadonlyArray<readonly [oldName: string, canonicalName: string]> = [\n    [\"read_user_profiles\", \"read_user_contexts\"],\n    [\"create_user_profile\", \"create_user_context\"],\n    [\"update_user_profile\", \"update_user_context\"],\n    [\"confirm_user_profile\", \"confirm_user_context\"],\n    [\"preview_user_profile\", \"preview_user_context\"],\n    [\"get_profile_run\", \"get_enrichment_run\"],\n    [\"cancel_profile_run\", \"cancel_enrichment_run\"],\n  ];\n  for (const [oldName, canonicalName] of DEPRECATED_TOOL_ALIASES) {\n    const canonical = registry.get(canonicalName);\n    if (!canonical) {\n      logger.warn(`Cannot register deprecated alias ${oldName}: canonical ${canonicalName} not found`);\n      continue;\n    }\n    registry.set(oldName, {\n      ...canonical,\n      name: oldName,\n      description: `[DEPRECATED — use \\`${canonicalName}\\` instead; this alias is retained for backward compatibility and will be removed.] ${canonical.description}`,\n    });\n  }\n\n  logger.verbose(`Tool registry created with ${registry.size} tools`);\n  return registry;\n}\n"]}
+{"version":3,"file":"tool.registry.js","sourceRoot":"/","sources":["shared/agent/tool.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport type { DefineTool, ResolvedToolContext, ToolDeps, RawToolDefinition, ToolRegistry } from './tool.helpers.js';\nimport { error, redactSensitiveFields } from './tool.helpers.js';\nimport { createEnrichmentTools } from '../../enrichment/enrichment.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 { createChatTools } from '../../chat/chat.tools.js';\nimport { createPremiseTools } from '../../premise/premise.tools.js';\nimport { createQuestionerTools } from '../../questioner/questioner.tools.js';\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { requestContext } from '../observability/request-context.js';\n\nconst logger = protocolLogger('ToolRegistry');\n\n/**\n * Creates a tool registry containing all tool handlers indexed by name.\n * Handlers are raw async functions (not LangChain tool() wrappers) that\n * accept { context, query } and return a JSON string.\n *\n * @param deps - Shared tool dependencies (graphs, database, embedder, etc.)\n * @param context - Resolved user context for this request.\n * @returns Map of tool name to raw tool definition.\n */\nexport function createToolRegistry(deps: ToolDeps): ToolRegistry {\n  const registry: ToolRegistry = new Map();\n\n  // defineTool that captures raw handlers into the registry\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    const entry: RawToolDefinition = {\n      name: opts.name,\n      description: opts.description,\n      schema: opts.querySchema,\n      handler: async (input: { context: ResolvedToolContext; query: unknown }) => {\n        logger.verbose('Tool invoked', {\n          toolName: opts.name,\n          context: { userId: input.context.userId, scopeType: input.context.scopeType, scopeId: input.context.scopeId },\n          query: redactSensitiveFields(input.query),\n        });\n        try {\n          return await opts.handler({ context: input.context, query: input.query as z.infer<T> });\n        } catch (err) {\n          const abortSignal = requestContext.getStore()?.abortSignal;\n          if (abortSignal?.aborted) {\n            throw err;\n          }\n          logger.error('Tool failed', {\n            toolName: opts.name,\n            error: err instanceof Error ? err.message : String(err),\n          });\n          return error(`Failed to execute ${opts.name}: ${err instanceof Error ? err.message : String(err)}`);\n        }\n      },\n    };\n\n    registry.set(opts.name, entry);\n\n    // Return a dummy — create*Tools functions collect return values into arrays,\n    // but for the registry path we only need the side-effect on the Map.\n    return null as unknown;\n  }\n\n  // Create all tool domains -- each one calls defineTool() which populates the registry.\n  // The local defineTool is compatible with DefineTool (which returns any).\n  const dt = defineTool as DefineTool;\n  createEnrichmentTools(dt, deps);\n  createIntentTools(dt, deps);\n  createNetworkTools(dt, deps);\n  createOpportunityTools(dt, deps);\n  createUtilityTools(dt, deps);\n  createIntegrationTools(dt, deps);\n  createContactTools(dt, deps);\n  createAgentTools(dt, deps);\n  createNegotiationTools(dt, deps);\n  createPremiseTools(dt, deps);\n  createQuestionerTools(dt, deps);\n  if (deps.chatSession) {\n    createChatTools(dt, deps);\n  }\n\n  // Deprecated tool-name aliases (IND-371). The canonical implementations are now\n  // registered under their *_user_context / *_enrichment_run names; we expose the\n  // legacy *_user_profile / *_profile_run names as thin aliases that delegate to the\n  // exact same handler + schema, so existing MCP clients keep working while they\n  // migrate. The old names are removed in IND-373.\n  const DEPRECATED_TOOL_ALIASES: ReadonlyArray<readonly [oldName: string, canonicalName: string]> = [\n    [\"read_user_profiles\", \"read_user_contexts\"],\n    [\"create_user_profile\", \"create_user_context\"],\n    [\"update_user_profile\", \"update_user_context\"],\n    [\"confirm_user_profile\", \"confirm_user_context\"],\n    [\"preview_user_profile\", \"preview_user_context\"],\n    [\"get_profile_run\", \"get_enrichment_run\"],\n    [\"cancel_profile_run\", \"cancel_enrichment_run\"],\n  ];\n  for (const [oldName, canonicalName] of DEPRECATED_TOOL_ALIASES) {\n    const canonical = registry.get(canonicalName);\n    if (!canonical) {\n      logger.warn('Cannot register deprecated alias: canonical tool not found', { alias: oldName, canonicalName });\n      continue;\n    }\n    registry.set(oldName, {\n      ...canonical,\n      name: oldName,\n      description: `[DEPRECATED — use \\`${canonicalName}\\` instead; this alias is retained for backward compatibility and will be removed.] ${canonical.description}`,\n    });\n  }\n\n  logger.verbose('Tool registry created', { toolCount: registry.size });\n  return registry;\n}\n"]}

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

@@ -4,7 +4,7 @@ const FAST_TIMEOUT_MS = 10000;
 const BOUNDED_SLOW_TIMEOUT_MS = 45000;
 const ASYNC_CANDIDATE_TIMEOUT_MS = 50000;
 // Interactive tools deliberately block on human input (ask_user_question).
-// Must exceed the tool's own internal wait budget (CHAT_QUESTION_WAIT_TIMEOUT_MS,
+// Must exceed the tool's own internal wait budget (QUESTIONER_CHAT_WAIT_TIMEOUT_MS,
 // default 4 min) so the tool returns a graceful timeout result instead of
 // being killed by the runtime.
 const INTERACTIVE_TIMEOUT_MS = 300000;

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\" | \"interactive\";\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;\n// Interactive tools deliberately block on human input (ask_user_question).\n// Must exceed the tool's own internal wait budget (CHAT_QUESTION_WAIT_TIMEOUT_MS,\n// default 4 min) so the tool returns a graceful timeout result instead of\n// being killed by the runtime.\nconst INTERACTIVE_TIMEOUT_MS = 300_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 INTERACTIVE_TOOLS = new Set([\"ask_user_question\"]);\n\nconst ASYNC_CANDIDATE_TOOLS = new Set([\n  // Canonical *_user_context names (IND-371)\n  \"read_user_contexts\",\n  \"preview_user_context\",\n  \"create_user_context\",\n  \"update_user_context\",\n  // Deprecated *_user_profile aliases (kept until IND-373 retires them)\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    : INTERACTIVE_TOOLS.has(toolName)\n      ? \"interactive\"\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 \"interactive\":\n      classDefault = parsePositiveIntEnv(\"MCP_TOOL_TIMEOUT_INTERACTIVE_MS\", INTERACTIVE_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"]}
+{"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\" | \"interactive\";\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;\n// Interactive tools deliberately block on human input (ask_user_question).\n// Must exceed the tool's own internal wait budget (QUESTIONER_CHAT_WAIT_TIMEOUT_MS,\n// default 4 min) so the tool returns a graceful timeout result instead of\n// being killed by the runtime.\nconst INTERACTIVE_TIMEOUT_MS = 300_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 INTERACTIVE_TOOLS = new Set([\"ask_user_question\"]);\n\nconst ASYNC_CANDIDATE_TOOLS = new Set([\n  // Canonical *_user_context names (IND-371)\n  \"read_user_contexts\",\n  \"preview_user_context\",\n  \"create_user_context\",\n  \"update_user_context\",\n  // Deprecated *_user_profile aliases (kept until IND-373 retires them)\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    : INTERACTIVE_TOOLS.has(toolName)\n      ? \"interactive\"\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 \"interactive\":\n      classDefault = parsePositiveIntEnv(\"MCP_TOOL_TIMEOUT_INTERACTIVE_MS\", INTERACTIVE_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/interfaces/database.interface.d.ts

@@ -631,7 +631,7 @@ export interface Database {
      * // After graph outputs EXPIRE action
      * const result = await db.archiveIntent(action.id);
      * if (!result.success) {
-     *   console.error(`Failed to archive: ${result.error}`);
+     *   console.error('Failed to archive intent', { error: result.error });
      * }
      * ```
      */