@indexnetwork/protocol 6.12.0-rc.403.1 → 6.13.22-rc.405.1

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

@@ -1 +0,0 @@
-{"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.d.ts.map

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

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

@@ -1 +0,0 @@
-{"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/agent/tool.scope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool.scope.d.ts","sourceRoot":"/","sources":["shared/agent/tool.scope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAMD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAG1F;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAGxF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAE5G;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI;IAAE,SAAS,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAE1G;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE7F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAUhF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAQlF"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"tool.scope.js","sourceRoot":"/","sources":["shared/agent/tool.scope.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Request scope primitives for protocol tools.\n *\n * `scopeType`/`scopeId` describe the user's focused scope, not the full set of\n * networks a caller may read or write. Helper functions derive concrete network\n * id sets from the focused scope plus the caller's memberships.\n */\nexport type ToolScopeType = 'network' | 'intent';\n\nexport interface ToolScopeEnvelope {\n  scopeType?: ToolScopeType;\n  scopeId?: string;\n}\n\nexport interface ScopeMembership {\n  networkId: string;\n  isPersonal?: boolean | null;\n}\n\nexport interface DeriveNetworkScopeInput extends ToolScopeEnvelope {\n  memberships: ScopeMembership[];\n}\n\nfunction uniqueNetworkIds(ids: string[]): string[] {\n  return [...new Set(ids.map((id) => id.trim()).filter(Boolean))];\n}\n\nexport function scopeFromNetworkId(networkId: string | null | undefined): ToolScopeEnvelope {\n  const scopeId = networkId?.trim();\n  return scopeId ? { scopeType: 'network', scopeId } : {};\n}\n\nexport function scopeFromIntentId(intentId: string | null | undefined): ToolScopeEnvelope {\n  const scopeId = intentId?.trim();\n  return scopeId ? { scopeType: 'intent', scopeId } : {};\n}\n\nexport function hasNetworkScope(scope: ToolScopeEnvelope): scope is { scopeType: 'network'; scopeId: string } {\n  return scope.scopeType === 'network' && typeof scope.scopeId === 'string' && scope.scopeId.trim().length > 0;\n}\n\nexport function hasIntentScope(scope: ToolScopeEnvelope): scope is { scopeType: 'intent'; scopeId: string } {\n  return scope.scopeType === 'intent' && typeof scope.scopeId === 'string' && scope.scopeId.trim().length > 0;\n}\n\n/**\n * Returns the focused network id from the canonical scope envelope.\n *\n * This intentionally does not inspect legacy `networkId` fields; callers that\n * still need a transition fallback should pass `scopeFromNetworkId(networkId)`\n * at the boundary so tool logic remains envelope-driven.\n */\nexport function focusedNetworkId(scope: ToolScopeEnvelope): string | undefined {\n  return hasNetworkScope(scope) ? scope.scopeId.trim() : undefined;\n}\n\nexport function focusedIntentId(scope: ToolScopeEnvelope): string | undefined {\n  return hasIntentScope(scope) ? scope.scopeId.trim() : undefined;\n}\n\n/** Human-readable label for a focused scope, used in scope-restriction notes. */\nexport function focusedNetworkLabel(scope: ToolScopeEnvelope & { indexName?: string }): string {\n  return scope.indexName ?? focusedNetworkId(scope) ?? 'this network';\n}\n\nexport function deriveAllowedNetworkIds(input: DeriveNetworkScopeInput): string[] {\n  if (!hasNetworkScope(input)) {\n    return uniqueNetworkIds(input.memberships.map((membership) => membership.networkId));\n  }\n\n  return uniqueNetworkIds(\n    input.memberships\n      .filter((membership) => membership.networkId === input.scopeId || membership.isPersonal === true)\n      .map((membership) => membership.networkId),\n  );\n}\n\nexport function deriveDiscoveryNetworkIds(input: DeriveNetworkScopeInput): string[] {\n  if (!hasNetworkScope(input)) {\n    return uniqueNetworkIds(input.memberships.map((membership) => membership.networkId));\n  }\n\n  return input.memberships.some((membership) => membership.networkId === input.scopeId)\n    ? [input.scopeId]\n    : [];\n}\n"]}

package/dist/shared/agent/utility.tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utility.tools.d.ts","sourceRoot":"/","sources":["shared/agent/utility.tools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG9D,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,4BAsTxE"}

package/dist/shared/agent/utility.tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utility.tools.js","sourceRoot":"/","sources":["shared/agent/utility.tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { requestContext } from \"../observability/request-context.js\";\n\nimport type { DefineTool, ToolDeps } from \"./tool.helpers.js\";\nimport { success, error, normalizeUrl } from \"./tool.helpers.js\";\n\nexport function createUtilityTools(defineTool: DefineTool, deps: ToolDeps) {\n  const { scraper } = deps;\n\n  const scrapeUrl = defineTool({\n    name: \"scrape_url\",\n    description:\n      \"Extracts text content from a web URL — articles, LinkedIn/GitHub profiles, documentation, project pages, etc. \" +\n      \"Returns the page's text content (up to 10,000 characters) for use in subsequent tool calls.\\n\\n\" +\n      \"**When to use:**\\n\" +\n      \"- Before create_intent: when the user shares a URL and wants to create an intent from it. Scrape first, then synthesize into a description.\\n\" +\n      \"- Before create_user_context or update_user_context: when the user shares a profile URL to update their profile from.\\n\" +\n      \"- When the user asks about content at a URL.\\n\\n\" +\n      \"**URL format:** Bare domains work fine (e.g. 'github.com/user/repo') — protocol (https://) is added automatically.\\n\\n\" +\n      \"**Returns:** `{ url, contentLength, content }`. Content is truncated at 10,000 chars. \" +\n      \"Returns an error if the URL is unreachable, requires login, or has no extractable text.\",\n    querySchema: z.object({\n      url: z.string().describe(\"The URL to extract content from. Protocol is optional — 'github.com/user/repo', 'linkedin.com/in/name', and 'https://example.com' all work.\"),\n      objective: z.string().optional().describe(\"Why you're scraping — guides content extraction for better results. Examples: 'User wants to create an intent from this project page', 'User wants to update their profile from this LinkedIn page', 'Extract key information about this company'. Omit for generic text extraction.\"),\n    }),\n    handler: async ({ context: _context, query }) => {\n      const normalizedUrl = normalizeUrl(query.url);\n      if (!normalizedUrl) {\n        return error(\"Invalid URL format. Please provide a valid URL (e.g. 'github.com/user/repo' or 'https://example.com').\");\n      }\n\n      const content = await scraper.extractUrlContent(normalizedUrl, {\n        objective: query.objective?.trim() || undefined,\n        signal: requestContext.getStore()?.abortSignal,\n      });\n\n      if (!content) {\n        return error(\"Couldn't extract content from that URL. It may be blocked, require login, or have no extractable text.\");\n      }\n\n      const truncatedContent = content.length > 10000\n        ? content.substring(0, 10000) + \"\\n\\n[Content truncated...]\"\n        : content;\n\n      return success({\n        url: normalizedUrl,\n        contentLength: content.length,\n        content: truncatedContent,\n      });\n    },\n  });\n\n  const readDocs = defineTool({\n    name: \"read_docs\",\n    description:\n      \"Returns comprehensive documentation about the Index Network protocol — entity model, workflows, tool usage guidance, and domain concepts. \" +\n      \"This is the primary way for an external agent to bootstrap understanding of the system.\\n\\n\" +\n      \"**When to use:** Call this FIRST when starting a new session. MCP agents MUST call read_docs(topic='mcp_agent_guide') at the start of every conversation to learn proper output formatting and workflow rules.\\n\" +\n      \"Also call when you need to understand:\\n\" +\n      \"- What entities exist and how they relate (intents, indexes, opportunities, profiles, contacts)\\n\" +\n      \"- The discovery workflow (how intents become opportunities)\\n\" +\n      \"- Which tools to call in what order for common tasks\\n\" +\n      \"- Authentication and API patterns\\n\\n\" +\n      \"**Returns:** Markdown documentation. Pass `topic` to get a specific section, or omit for the full reference.\\n\\n\" +\n      \"**Available topics:** 'entities', 'intents', 'opportunities', 'indexes', 'profiles', 'contacts', 'discovery', 'workflows', 'authentication', 'mcp_agent_guide'\",\n    querySchema: z.object({\n      topic: z.string().optional().describe(\"Narrow to a specific topic: 'entities', 'intents', 'opportunities', 'indexes', 'profiles', 'contacts', 'discovery', 'workflows', or 'authentication'. Omit to get the full documentation.\"),\n    }),\n    handler: async ({ context: _context, query }) => {\n      const topic = query.topic?.trim().toLowerCase();\n\n      const sections: Record<string, string> = {\n        entities: `## Entity Model & Relationships\n\n- **Users**: People on the platform. Authenticated via API key (X-API-Key header) for MCP/external agents, or session-based (Better Auth) for the web app.\n- **Profiles**: A user's identity — name, bio, skills, interests, location, social links. Generated from account data or social URLs via enrichment. One profile per user.\n- **Indexes** (also called \"networks\"): Communities or groups where members share intents and discover opportunities. Each has a title, optional prompt (purpose description), join policy (anyone or invite_only), and an owner. The user's **personal network** (isPersonal=true) stores their contacts.\n- **Network Members**: Junction between Users and Indexes. Tracks permissions (owner, member, contact), join date, auto-assign setting, and optional member prompt.\n- **Intents**: Signals of interest/need — what a user is looking for (e.g. \"Looking for a React developer in Berlin\"). Each has a description (payload), summary, confidence score (0-1), inferenceType (explicit/implicit), source tracking, and vector embedding.\n- **IntentNetworks**: Many-to-many junction between Intents and Indexes. An intent can be in multiple indexes. Has a relevancyScore (0-1) indicating how well the intent fits the index's purpose.\n- **Opportunities**: Discovered connections between users based on complementary intents within shared networks. Have actors with roles (introducer, party), status lifecycle, match reasoning, confidence score, and presentation data.\n- **Contacts**: People in a user's personal network, stored as network members with 'contact' permission on the personal network. Can be real users or ghost users (placeholder accounts enriched from public data).\n- **Ghost Users**: Placeholder accounts created for contacts who aren't on the platform yet. Enriched with public profile data (LinkedIn, GitHub) and participate in opportunity matching.\n\n### Key Relationships\n- Users → Profiles (1:1)\n- Users → Indexes (many:many via Network Members)\n- Users → Intents (1:many, user owns intents)\n- Intents → Indexes (many:many via IntentNetworks with relevancyScore)\n- Opportunities → Users (many:many via actors with roles)\n- Opportunities → Indexes (scoped to shared network context)\n- Contacts → Personal Network (stored as members with 'contact' permission)`,\n\n        intents: `## Intent Lifecycle\n\nIntents are the core unit of discovery — they represent what users are seeking and drive semantic matching.\n\n1. **Creation** (create_intent): User describes what they're looking for. The system runs inference (extracting structured intents from free text) and verification (checking specificity, speech-act type). Returns a proposal for user approval.\n2. **Confidence & Classification**: Each intent gets a confidence score (0-1), inferenceType (explicit = user stated directly, implicit = system inferred), and speech act classification (commissive, directive, assertive).\n3. **Index Assignment**: After creation, the intent is automatically evaluated against all networks the user belongs to. The index's prompt is used as criteria. Matching indexes get linked via IntentNetworks with a relevancyScore (0-1).\n4. **Discovery Trigger**: Creating an intent triggers background opportunity detection — the system searches for other users in shared networks whose intents complement this one.\n5. **Source Tracking**: Intents track their origin via sourceType (file, integration, link, discovery_form, enrichment) and sourceId.\n6. **Update** (update_intent): Re-processes through inference/verification, recalculates embeddings and index assignments.\n7. **Archive** (delete_intent): Soft-deletes the intent. It stops participating in discovery but is not permanently removed.\n\n### Intent Best Practices\n- Be specific: \"Looking for a senior React developer for a 3-month contract in Berlin\" > \"Need a developer\"\n- One intent per need: don't combine multiple requests into one intent\n- Update rather than delete+create to preserve history`,\n\n        opportunities: `## Opportunity Lifecycle\n\nOpportunities represent discovered connections between users — potential matches worth pursuing.\n\n1. **Detection** (discover_opportunities): The opportunity graph finds users whose intents semantically complement each other within shared networks. Uses HyDE embeddings for retrieval and an LLM evaluator for scoring.\n2. **Roles**: Each opportunity assigns roles to actors:\n   - **introducer**: The person who triggered the introduction (may be the system or another user)\n   - **party**: The people being connected (typically 2)\n3. **Status Flow**: draft → pending → accepted/rejected/expired\n   - **draft**: Created but not sent. Only the creator/introducer sees it.\n   - **pending**: Sent to the other party. They're notified and can respond.\n   - **accepted**: Both parties agreed to connect.\n   - **rejected**: One party declined.\n   - **expired**: Timed out without response.\n4. **Creation Modes**:\n   - **Discovery**: Automatic — system finds matches based on intent overlap (discover_opportunities with searchQuery)\n   - **Introduction**: Manual — a user introduces two specific people (discover_opportunities with partyUserIds + entities)\n   - **Direct**: One-to-one — connect with a specific person (discover_opportunities with targetUserId)\n5. **Presentation**: Each opportunity includes personalized match reasoning, confidence score, and suggested next action.\n\n### Opportunity Workflow\n1. discover_opportunities(searchQuery=\"AI engineers\") → returns draft opportunity cards\n2. update_opportunity(opportunityId, status=\"pending\") → sends to other party\n3. Other party sees opportunity → calls update_opportunity(status=\"accepted\" or \"rejected\")`,\n\n        indexes: `## Index Mechanics\n\nIndexes (also called \"networks\") are communities where members share what they're looking for and the system discovers connections between them.\n\n- **Purpose prompt**: Each index has an optional prompt describing its purpose (e.g. \"AI/ML co-founders in Berlin\"). This prompt is used by the intent indexer to evaluate whether an intent belongs in this community. Networks without prompts accept all intents (relevancyScore defaults to 1.0).\n- **Join policy**: \"anyone\" (open — any user can self-join) or \"invite_only\" (only the owner can add members).\n- **Personal network**: Each user has exactly one personal network (isPersonal=true) created on registration. It stores their contacts. Cannot be deleted, renamed, or listed publicly.\n- **Membership**: Members can see all intents in the index. The **auto-assign** setting on a membership means new intents by that user are automatically evaluated against the index.\n- **Owner permissions**: Network owners can update settings (title, prompt, joinPolicy), add/remove members, and delete the network (if sole member).\n- **Discovery scope**: Opportunities are discovered within index boundaries — the system matches intents of members who share at least one index.\n\n### Index Workflow\n1. create_network(title, prompt) → creates new community, you become owner\n2. create_network_membership(networkId, userId) → invite members\n3. Members create intents → auto-assigned to the index based on prompt\n4. discover_opportunities(networkId) → discover matches within this community`,\n\n        profiles: `## Profile System\n\nProfiles are the user's identity on the platform, used for semantic matching in opportunity discovery.\n\n- **Structure**: name, bio, location, skills[], interests[], social links (LinkedIn, GitHub, Twitter, websites)\n- **Generation**: Auto-generated from account data (name, email, social links) via web enrichment. Can also be created from explicit user input (bioOrDescription).\n- **Enrichment**: The system scrapes public profiles (LinkedIn, GitHub, Twitter) to build a rich identity with skills, interests, and narrative context.\n- **Embeddings**: HyDE (Hypothetical Document Embedding) generates synthetic documents for semantic matching:\n  - Mirror: self-description of the person\n  - Reciprocal: what this person would look for in others\n  - Neighborhood: related community context\n- **Onboarding flow**: create_user_context() → preview → create_user_context(confirm=true) → complete_onboarding()\n- **Updates**: Use update_user_context for targeted changes, create_user_context for full regeneration.\n\n### Profile Best Practices\n- Richer profiles produce better opportunity matches\n- Social links enable enrichment — encourage users to add LinkedIn/GitHub\n- Profiles are recalculated when updated, which may surface new matches`,\n\n        contacts: `## Contact Management\n\nContacts are people in a user's personal network, stored as members of their personal network with 'contact' permission.\n\n- **Adding contacts**: Via import_contacts (bulk), add_contact (single email), or import_gmail_contacts (Google integration).\n- **Ghost users**: When a contact email doesn't match an existing account, a ghost user is created. Ghost users are enriched with public profile data and participate in opportunity matching — they can be discovered even before joining the platform.\n- **Personal network scope**: Pass the personal network networkId to discover_opportunities to scope discovery to just the user's contacts.\n- **Contact data**: Each contact has userId, name, email, avatar, and isGhost flag.\n\n### Contact Workflow\n1. import_contacts or import_gmail_contacts → bulk add to network\n2. list_contacts → view all contacts with userId\n3. discover_opportunities(networkId=personalIndexId) → find matches among contacts\n4. add_contact(email) → add individual contact\n5. remove_contact(contactUserId) → remove from network`,\n\n        discovery: `## Discovery Mechanics\n\nDiscovery is the process of finding meaningful connections between users based on their intents and profiles.\n\n### How Discovery Works\n1. **Trigger**: Runs automatically when an intent is created, or explicitly when discover_opportunities is called.\n2. **Pipeline**: Preparation (gather user context) → Scope (determine which indexes to search) → Candidate retrieval (semantic matching via HyDE embeddings) → Evaluation (LLM scores relevance and complementarity) → Ranking → Persist as opportunities.\n3. **Semantic matching**: Uses HyDE (Hypothetical Document Embeddings) to find candidate intents that complement the source. This goes beyond keyword matching — it understands conceptual relationships.\n4. **Evaluation**: An LLM evaluator agent scores each candidate match on relevance, complementarity, and actionability. Low-scoring matches are filtered out.\n5. **Results**: Persisted as draft opportunities with roles, reasoning, and confidence scores.\n6. **Background processing**: After intent creation, a queue job continues looking for matches asynchronously.\n7. **Pagination**: Large result sets are paginated. Use continueFrom with the discoveryId to evaluate more candidates.\n\n### Discovery Best Practices\n- More specific intents produce more relevant matches\n- Richer profiles improve matching quality\n- Scope to a specific index (networkId) for more targeted results\n- After discovery returns no results, suggest creating an intent to attract future matches`,\n\n        workflows: `## Common Tool Workflows\n\n### New User Setup\n1. create_user_context(linkedinUrl/githubUrl) → generate profile from social data\n2. complete_onboarding() → unlock full access\n3. read_networks() → see available communities\n4. create_network_membership(networkId) → join a community\n5. create_intent(description) → post what you're looking for\n6. discover_opportunities(searchQuery) → find matches\n\n### Finding Connections\n1. read_networks() → list user's communities (get networkId)\n2. discover_opportunities(searchQuery, networkId) → discover matches\n3. Review opportunity cards → update_opportunity(opportunityId, status=\"pending\") to send\n\n### Making an Introduction\n1. read_network_memberships(networkId) → find members in shared community\n2. read_user_contexts(userId) → get profiles of both parties\n3. read_intents(networkId, userId) → get intents of both parties\n4. discover_opportunities(partyUserIds=[id1,id2], entities=[...], hint=\"reason\") → create introduction\n\n### Managing Contacts\n1. import_gmail_contacts() or import_contacts([...]) → add contacts\n2. list_contacts() → view network\n3. discover_opportunities(networkId=personalIndexId) → find matches among contacts\n\n### Creating a Community\n1. create_network(title, prompt) → create network\n2. create_network_membership(networkId, userId) → invite members\n3. Members create intents → auto-indexed\n4. discover_opportunities(networkId) → discover connections within community`,\n\n        authentication: `## Authentication & API Access\n\n### For External AI Agents (MCP)\n- Authenticate via **X-API-Key** header with a valid API key\n- The API key is tied to a specific user account\n- All operations execute in the context of the authenticated user\n- Base URL: protocol.index.network/mcp\n\n### Key Constraints\n- Users can only read their own intents globally, or intents in indexes they belong to\n- Users can only read profiles of people in shared networks\n- Network-scoped operations are restricted to that index\n- Personal networks cannot be deleted or renamed\n- Only network owners can update settings, add/remove members (for invite_only networks)\n\n### Rate Limits & Best Practices\n- Avoid unnecessary read_intents/read_networks calls — cache results within a conversation\n- Use pagination (limit/page) for large result sets\n- Call read_docs once at the start to understand the domain`,\n\n        mcp_agent_guide: `## MCP Agent Integration Guide\n\n**IMPORTANT: Read this section if you are an AI agent accessing Index Network via MCP tools.**\n\n### Output Formatting\n- Tool results often contain structured JSON data (proposals, opportunities, cards). **Do NOT dump raw JSON to the user.** Parse the JSON and present information in natural language with clear formatting.\n- Some tool results contain interactive card markup (code blocks with \\`intent_proposal\\`, \\`opportunity_card\\` language tags). These are designed for the Index Network web UI. **As an MCP agent, ignore card markup.** Instead, extract the meaningful data from the JSON and present it conversationally.\n- When presenting opportunities or intents, use bullet points or short paragraphs — not raw JSON objects.\n\n### Intent Creation Workflow\n- **Always pass \\`autoApprove: true\\` when calling \\`create_intent\\`.** This persists intents directly without returning proposal cards that require manual UI approval.\n- The tool will return a list of created intents with their descriptions and confidence scores. Present these in natural language.\n- Do not tell the user to \"click on cards\" or \"approve above\" — there is no UI. Intents are created immediately with autoApprove.\n- After creating intents, proactively suggest or run discovery to find matches.\n\n### Discovery Workflow\n- After creating intents, proactively suggest running discovery: \\`discover_opportunities(searchQuery=...)\\`\n- Present discovered opportunities in natural language with the counterpart's name, match reasoning, and suggested next steps.\n- Do not reference \"cards\", \"panels\", or any web UI elements.\n\n### General MCP Agent Rules\n- You are operating via API tools, not a web interface. Never reference clicking, scrolling, cards, panels, or any visual UI elements.\n- Be proactive: if a logical next step exists (e.g., running discovery after creating intents), suggest or execute it.\n- Use \\`list_opportunities\\` to check existing matches, \\`list_negotiations\\` for ongoing negotiations.\n- Use \\`read_networks\\` to understand which communities the user belongs to before scoping operations.\n- When errors occur, provide clear technical context rather than vague \"backend issue\" messages.`,\n      };\n\n      if (topic) {\n        const matched = Object.entries(sections).find(([key]) => key.includes(topic) || topic.includes(key));\n        if (matched) {\n          return success({ topic: matched[0], content: matched[1] });\n        }\n        // If topic not found, return all\n      }\n\n      const fullDoc = Object.values(sections).join(\"\\n\\n\");\n      return success({ content: fullDoc });\n    },\n  });\n\n  const reportAgentActivity = defineTool({\n    name: \"report_agent_activity\",\n    description:\n      \"Reports grounded, aggregate-only activity for the authenticated user's agent over a recent time window. \" +\n      \"It includes live signal count, opportunities surfaced by the user's own signals, pending/answered question counts, \" +\n      \"and negotiation totals. It never returns counterpart identities, transcripts, or per-counterparty rows.\",\n    querySchema: z.object({\n      sinceHours: z.number().int().optional().default(24).describe(\"Look back this many hours; values are clamped to 1-168 (default 24).\"),\n    }).strict(),\n    handler: async ({ query }) => {\n      const sinceHours = Math.max(1, Math.min(168, query.sinceHours));\n      const summary = await deps.userDb.getAgentActivitySummary({ sinceHours });\n      return success(summary);\n    },\n  });\n\n  return [scrapeUrl, readDocs, reportAgentActivity] as const;\n}\n"]}

package/dist/shared/assignment/network-assignment.policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"network-assignment.policy.d.ts","sourceRoot":"/","sources":["shared/assignment/network-assignment.policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEpO,yEAAyE;AACzE,eAAO,MAAM,oCAAoC,MAAM,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,yBAAyB,GAAG,eAAe,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,iCAAkC,SAAQ,iBAAiB;IAC1E,WAAW,EAAE,yBAAyB,EAAE,CAAC;IACzC,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kCAAmC,SAAQ,mBAAmB;IAC7E,YAAY,EAAE,6BAA6B,CAAC;IAC5C,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,SAAS,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,yBAAyB,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,+BAA+B,CAOlG;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,iCAAiC,GAAG,MAAM,EAAE,CAW/F;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,kCAAkC,GAAG,yBAAyB,CAiBlH;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,0BAA0B,EACrC,cAAc,EAAE,+BAA+B,GAC9C,MAAM,CAcR"}

package/dist/shared/assignment/network-assignment.policy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"network-assignment.policy.js","sourceRoot":"/","sources":["shared/assignment/network-assignment.policy.ts"],"names":[],"mappings":"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","sourcesContent":["import { deriveAllowedNetworkIds, scopeFromNetworkId } from \"../agent/tool.scope.js\";\nimport type { ScopeMembership, ToolScopeEnvelope } from \"../agent/tool.scope.js\";\nimport type { NetworkAssignmentMetadata, NetworkAssignmentMode, NetworkAssignmentPromptPresence, NetworkAssignmentRawScores, NetworkAssignmentResourceType, NetworkAssignmentScope } from \"../schemas/network-assignment.schema.js\";\n\n/** Centralized default for unified premise/intent network assignment. */\nexport const DEFAULT_NETWORK_ASSIGNMENT_THRESHOLD = 0.7;\n\nexport interface PromptPresenceInput {\n  indexPrompt?: string | null;\n  memberPrompt?: string | null;\n}\n\nexport type AssignmentScopeMembership = ScopeMembership | string;\n\nexport interface ResolveAssignmentNetworkScopeArgs extends ToolScopeEnvelope {\n  memberships: AssignmentScopeMembership[];\n  /** @deprecated Use `scopeType: 'network'` + `scopeId`. */\n  networkScopeId?: string;\n}\n\nexport interface BuildNetworkAssignmentDecisionArgs extends PromptPresenceInput {\n  resourceType: NetworkAssignmentResourceType;\n  mode: NetworkAssignmentMode;\n  scope: NetworkAssignmentScope;\n  rawScores?: NetworkAssignmentRawScores | null;\n  threshold?: number;\n  evaluator?: string;\n  source?: string;\n  reason?: string;\n  createdAt?: string;\n}\n\nexport interface NetworkAssignmentDecision {\n  assigned: boolean;\n  finalScore: number;\n  metadata: NetworkAssignmentMetadata;\n}\n\n/**\n * Classifies whether a network/member prompt pair can filter a resource.\n *\n * @param input - Network and member prompt values to inspect.\n * @returns Prompt-presence classification for assignment policy decisions.\n */\nexport function classifyPromptPresence(input: PromptPresenceInput): NetworkAssignmentPromptPresence {\n  const hasIndex = !!input.indexPrompt?.trim();\n  const hasMember = !!input.memberPrompt?.trim();\n  if (hasIndex && hasMember) return \"both\";\n  if (hasIndex) return \"index\";\n  if (hasMember) return \"member\";\n  return \"none\";\n}\n\n/**\n * Resolves the networks to evaluate: all memberships in global scope, or the\n * focused network plus personal memberships in network scope. The focused\n * network must also be a membership to avoid broadening scope accidentally.\n *\n * @param args - User memberships plus optional active network scope.\n * @returns Network IDs that assignment should evaluate.\n */\nexport function resolveAssignmentNetworkScope(args: ResolveAssignmentNetworkScopeArgs): string[] {\n  const memberships = args.memberships.map((membership) => (\n    typeof membership === \"string\"\n      ? { networkId: membership, isPersonal: false }\n      : membership\n  ));\n  const scope = args.scopeType && args.scopeId\n    ? { scopeType: args.scopeType, scopeId: args.scopeId }\n    : scopeFromNetworkId(args.networkScopeId);\n\n  return deriveAllowedNetworkIds({ memberships, ...scope });\n}\n\n/**\n * Builds a unified assignment decision and metadata envelope.\n *\n * @param args - Assignment resource, scope, prompt, score, and provenance inputs.\n * @returns Assignment decision and explainability metadata.\n */\nexport function buildNetworkAssignmentDecision(args: BuildNetworkAssignmentDecisionArgs): NetworkAssignmentDecision {\n  const threshold = clampScore(args.threshold ?? DEFAULT_NETWORK_ASSIGNMENT_THRESHOLD);\n  const promptPresence = classifyPromptPresence(args);\n\n  if (args.mode === \"manual_override\") {\n    const finalScore = 1.0;\n    return buildDecision(args, promptPresence, threshold, finalScore, true, args.reason ?? \"Explicit manual override.\");\n  }\n\n  if (promptPresence === \"none\") {\n    const finalScore = 1.0;\n    return buildDecision(args, promptPresence, threshold, finalScore, true, args.reason ?? \"No prompts configured; network has no dynamic filtration.\");\n  }\n\n  const finalScore = combineAssignmentScores(args.rawScores ?? {}, promptPresence);\n  const assigned = finalScore >= threshold;\n  return buildDecision(args, promptPresence, threshold, finalScore, assigned, args.reason);\n}\n\n/**\n * Combines index/member scores according to available prompt filtration.\n *\n * @param rawScores - Optional normalized index and member scores.\n * @param promptPresence - Which prompts are present for this assignment decision.\n * @returns Final normalized score in the 0..1 range.\n */\nexport function combineAssignmentScores(\n  rawScores: NetworkAssignmentRawScores,\n  promptPresence: NetworkAssignmentPromptPresence,\n): number {\n  const indexScore = clampScore(rawScores.indexScore ?? 0);\n  const memberScore = clampScore(rawScores.memberScore ?? 0);\n\n  switch (promptPresence) {\n    case \"both\":\n      return clampScore(indexScore * 0.6 + memberScore * 0.4);\n    case \"index\":\n      return indexScore;\n    case \"member\":\n      return memberScore;\n    case \"none\":\n      return 1.0;\n  }\n}\n\nfunction buildDecision(\n  args: BuildNetworkAssignmentDecisionArgs,\n  promptPresence: NetworkAssignmentPromptPresence,\n  threshold: number,\n  finalScore: number,\n  assigned: boolean,\n  reason?: string,\n): NetworkAssignmentDecision {\n  return {\n    assigned,\n    finalScore,\n    metadata: {\n      resourceType: args.resourceType,\n      mode: args.mode,\n      scope: args.scope,\n      policy: \"unified-threshold-v1\",\n      threshold,\n      promptPresence,\n      ...(args.rawScores ? { rawScores: args.rawScores } : {}),\n      finalScore,\n      assigned,\n      ...(reason ? { reason } : {}),\n      ...(args.evaluator ? { evaluator: args.evaluator } : {}),\n      ...(args.source ? { source: args.source } : {}),\n      ...(args.createdAt ? { createdAt: args.createdAt } : {}),\n    },\n  };\n}\n\nfunction clampScore(score: number): number {\n  if (!Number.isFinite(score)) return 0;\n  return Math.max(0, Math.min(1, score));\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.documents.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.documents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEvF,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpE;AAoBD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,YAAY,EAAE,EACzB,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,MAAM,GACjB,YAAY,EAAE,CAyBhB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.documents.js","sourceRoot":"/","sources":["shared/hyde/hyde.documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC,OAAO,EAAE,6BAA6B,EAA2B,MAAM,eAAe,CAAC;AAEvF,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,6BAA6B,GAAG,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAsB,EAAE,cAAsB;IAC/E,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,OAAO,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC;WACpC,OAAO,EAAE,qBAAqB,KAAK,6BAA6B;WAChE,OAAO,CAAC,gBAAgB,KAAK,OAAO;WACpC,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;WACrC,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;WAC5B,OAAO,OAAO,CAAC,gBAAgB,KAAK,QAAQ;WAC5C,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;WACnC,OAAO,CAAC,cAAc,KAAK,cAAc;WACzC,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;WACvC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,SAAyB,EACzB,IAAwB,EACxB,UAAkB;IAElB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CACnC,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC;eAChC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,KAAK,6BAA6B,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,cAAc,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,yBAAyB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;IACrG,IAAI,iBAAqC,CAAC;IAC1C,IAAI,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAE/C,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;QAClD,IAAI,OAAO,WAAW,KAAK,QAAQ;YAAE,SAAS;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,SAAS,GAAG,eAAe,EAAE,CAAC;YAChC,eAAe,GAAG,SAAS,CAAC;YAC5B,iBAAiB,GAAG,WAAW,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO,iBAAiB;QACtB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,KAAK,iBAAiB,CAAC;QACpF,CAAC,CAAC,EAAE,CAAC;AACT,CAAC","sourcesContent":["import { createHash } from 'crypto';\n\nimport type { HydeDocument } from '../interfaces/database.interface.js';\nimport { HYDE_FRAME_GENERATION_VERSION, type HydeGenerationMode } from './hyde.env.js';\n\n/** Hash source text without persisting the source itself in frame metadata. */\nexport function computeHydeSourceTextHash(sourceText: string): string {\n  return createHash('sha256').update(sourceText).digest('hex');\n}\n\nfunction isFrameStrategy(strategy: string): boolean {\n  return strategy.startsWith(`${HYDE_FRAME_GENERATION_VERSION}:`);\n}\n\nfunction hasFrameMetadataForSource(document: HydeDocument, sourceTextHash: string): boolean {\n  const context = document.context;\n  return isFrameStrategy(document.strategy)\n    && context?.hydeGenerationVersion === HYDE_FRAME_GENERATION_VERSION\n    && context.validationStatus === 'valid'\n    && typeof context.lensLabel === 'string'\n    && context.lensLabel.length > 0\n    && typeof context.frameFingerprint === 'string'\n    && context.frameFingerprint.length > 0\n    && context.sourceTextHash === sourceTextHash\n    && typeof context.generatedAt === 'string'\n    && Number.isFinite(Date.parse(context.generatedAt));\n}\n\n/**\n * Select persisted documents that belong to the currently active generation\n * mode and, for frame-v1, the newest generation marker group.\n */\nexport function selectHydeDocumentsForGeneration(\n  documents: HydeDocument[],\n  mode: HydeGenerationMode,\n  sourceText: string,\n): HydeDocument[] {\n  if (mode === 'legacy') {\n    return documents.filter((document) =>\n      !isFrameStrategy(document.strategy)\n      && document.context?.hydeGenerationVersion !== HYDE_FRAME_GENERATION_VERSION);\n  }\n\n  const sourceTextHash = computeHydeSourceTextHash(sourceText);\n  const eligible = documents.filter((document) => hasFrameMetadataForSource(document, sourceTextHash));\n  let newestGeneratedAt: string | undefined;\n  let newestTimestamp = Number.NEGATIVE_INFINITY;\n\n  for (const document of eligible) {\n    const generatedAt = document.context?.generatedAt;\n    if (typeof generatedAt !== 'string') continue;\n    const timestamp = Date.parse(generatedAt);\n    if (timestamp > newestTimestamp) {\n      newestTimestamp = timestamp;\n      newestGeneratedAt = generatedAt;\n    }\n  }\n\n  return newestGeneratedAt\n    ? eligible.filter((document) => document.context?.generatedAt === newestGeneratedAt)\n    : [];\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.env.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.env.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,eAAO,MAAM,6BAA6B,EAAG,UAAmB,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,6BAA6B,CAAC;AAEjF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,GAAE,MAAM,GAAG,SAAsD,GACrE,kBAAkB,CAEpB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.env.js","sourceRoot":"/","sources":["shared/hyde/hyde.env.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAmB,CAAC;AAIjE;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA4B,OAAO,CAAC,GAAG,CAAC,8BAA8B;IAEtE,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrE,CAAC","sourcesContent":["/** HyDE generation modes. */\nexport const HYDE_FRAME_GENERATION_VERSION = 'frame-v1' as const;\n\nexport type HydeGenerationMode = 'legacy' | typeof HYDE_FRAME_GENERATION_VERSION;\n\n/**\n * Resolve the HyDE generation mode from the feature flag.\n * Only the exact literal `true` enables frame-constrained generation.\n */\nexport function getHydeGenerationMode(\n  value: string | undefined = process.env.HYDE_FRAME_CONSTRAINTS_ENABLED,\n): HydeGenerationMode {\n  return value === 'true' ? HYDE_FRAME_GENERATION_VERSION : 'legacy';\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.frame.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.frame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,0BAA0B,gGAQ7B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,uBAAuB,8EAO1B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,eAAe,EAAE,uBAAuB,EAAE,CAAC;IAC3C,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAwBD,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAwDH;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CAenG"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.frame.js","sourceRoot":"/","sources":["shared/hyde/hyde.frame.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\n/** Source-grounded role supported by an exact span from the source text. */\nexport interface HydeFrameRole {\n  role: string;\n  evidence: string;\n}\n\nexport const HYDE_HARD_CONSTRAINT_TYPES = [\n  'location',\n  'time',\n  'numeric',\n  'credential',\n  'organization',\n  'exclusivity',\n  'other',\n] as const;\n\nexport type HydeHardConstraintType = (typeof HYDE_HARD_CONSTRAINT_TYPES)[number];\n\n/** Explicit hard constraint supported by an exact span from the source text. */\nexport interface HydeFrameHardConstraint {\n  type: HydeHardConstraintType;\n  value: string;\n  evidence: string;\n}\n\nexport const HYDE_NAMED_ENTITY_TYPES = [\n  'person',\n  'organization',\n  'product',\n  'location',\n  'event',\n  'other',\n] as const;\n\nexport type HydeNamedEntityType = (typeof HYDE_NAMED_ENTITY_TYPES)[number];\n\n/** Named entity supported by an exact span from the source text. */\nexport interface HydeFrameNamedEntity {\n  type: HydeNamedEntityType;\n  name: string;\n  evidence: string;\n}\n\n/** Domain term supported by an exact span from the source text. */\nexport interface HydeFrameVocabulary {\n  term: string;\n  evidence: string;\n}\n\n/**\n * Source-grounded controls for frame-constrained HyDE generation.\n * Counterpart roles may be reciprocal/complementary inferences, but their\n * evidence must still be an exact span from the source text.\n */\nexport interface HydeSourceFrame {\n  sourceRoles: HydeFrameRole[];\n  counterpartRoles: HydeFrameRole[];\n  hardConstraints: HydeFrameHardConstraint[];\n  namedEntities: HydeFrameNamedEntity[];\n  domainVocabulary: HydeFrameVocabulary[];\n}\n\nconst roleSchema = z.object({\n  role: z.string().min(1),\n  evidence: z.string().min(1).describe('Exact evidence span copied from sourceText'),\n});\n\nconst hardConstraintSchema = z.object({\n  type: z.enum(HYDE_HARD_CONSTRAINT_TYPES),\n  value: z.string().min(1),\n  evidence: z.string().min(1).describe('Exact evidence span copied from sourceText'),\n});\n\nconst namedEntitySchema = z.object({\n  type: z.enum(HYDE_NAMED_ENTITY_TYPES),\n  name: z.string().min(1),\n  evidence: z.string().min(1).describe('Exact evidence span copied from sourceText'),\n});\n\nconst vocabularySchema = z.object({\n  term: z.string().min(1),\n  evidence: z.string().min(1).describe('Exact evidence span copied from sourceText'),\n});\n\n/** Structured-output schema for source-grounded frames. */\nexport const HydeSourceFrameSchema = z.object({\n  sourceRoles: z.array(roleSchema),\n  counterpartRoles: z.array(roleSchema),\n  hardConstraints: z.array(hardConstraintSchema),\n  namedEntities: z.array(namedEntitySchema),\n  domainVocabulary: z.array(vocabularySchema),\n});\n\nfunction escapeRegularExpression(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/** Case-insensitive literal matching bounded by Unicode letters and numbers. */\nfunction containsAlphanumericSpanCaseInsensitive(container: string, value: string): boolean {\n  const needle = value.trim();\n  if (!needle) return false;\n  return new RegExp(\n    `(?<![\\\\p{L}\\\\p{M}\\\\p{N}])${escapeRegularExpression(needle)}(?![\\\\p{L}\\\\p{M}\\\\p{N}])`,\n    'iu',\n  ).test(container);\n}\n\nfunction hasExactEvidence(sourceText: string, evidence: string): boolean {\n  return containsAlphanumericSpanCaseInsensitive(sourceText, evidence);\n}\n\nconst GENERIC_ROLE_TOKENS = new Set([\n  'advisor', 'analyst', 'attendee', 'borrower', 'builder', 'buyer', 'candidate',\n  'capitalist', 'ceo', 'cfo', 'client', 'cmo', 'cofounder', 'collaborator',\n  'consultant', 'coo', 'creator', 'cto', 'customer', 'designer', 'developer',\n  'director', 'employer', 'engineer', 'entrepreneur', 'executive', 'expert',\n  'founder', 'funder', 'hire', 'hiring', 'investor', 'leader', 'lender',\n  'manager', 'mentor', 'operator', 'organizer', 'owner', 'partner', 'practitioner',\n  'professional', 'provider', 'recruiter', 'researcher', 'scientist', 'seller',\n  'speaker', 'specialist', 'sponsor', 'strategist', 'supplier', 'technologist',\n  'vendor', 'vp',\n]);\n\nconst GENERIC_ROLE_MODIFIERS = new Set([\n  'business', 'co', 'commercial', 'community', 'creative', 'early', 'experienced',\n  'growth', 'independent', 'industry', 'junior', 'lead', 'local', 'nonprofit',\n  'operations', 'product', 'professional', 'public', 'senior', 'stage',\n  'startup', 'technical', 'venture',\n]);\n\nfunction roleTokens(role: string): string[] {\n  return role.toLowerCase().match(/[\\p{L}\\p{M}\\d]+/gu) ?? [];\n}\n\nfunction hasUnsupportedSourceRoleMaterial(role: string, evidence: string): boolean {\n  const substantiveTokens = roleTokens(role).filter((token) => !GENERIC_ROLE_MODIFIERS.has(token));\n  return substantiveTokens.length === 0\n    || substantiveTokens.some((token) => !containsAlphanumericSpanCaseInsensitive(evidence, token));\n}\n\nfunction hasUnsupportedCounterpartRoleMaterial(role: string, evidence: string): boolean {\n  return roleTokens(role).some((token) =>\n    !GENERIC_ROLE_TOKENS.has(token)\n    && !GENERIC_ROLE_MODIFIERS.has(token)\n    && !containsAlphanumericSpanCaseInsensitive(evidence, token));\n}\n\n/**\n * Remove frame elements that cross the source-evidence boundary. Structured\n * payloads must occur inside their evidence span. Source roles require grounded\n * substantive tokens; counterpart roles may add generic inferred role language.\n */\nexport function sanitizeHydeSourceFrame(sourceText: string, frame: HydeSourceFrame): HydeSourceFrame {\n  const grounded = <T extends { evidence: string }>(items: T[]): T[] =>\n    items.filter((item) => hasExactEvidence(sourceText, item.evidence));\n  return {\n    sourceRoles: grounded(frame.sourceRoles)\n      .filter((item) => !hasUnsupportedSourceRoleMaterial(item.role, item.evidence)),\n    counterpartRoles: grounded(frame.counterpartRoles)\n      .filter((item) => !hasUnsupportedCounterpartRoleMaterial(item.role, item.evidence)),\n    hardConstraints: grounded(frame.hardConstraints)\n      .filter((item) => containsAlphanumericSpanCaseInsensitive(item.evidence, item.value)),\n    namedEntities: grounded(frame.namedEntities)\n      .filter((item) => containsAlphanumericSpanCaseInsensitive(item.evidence, item.name)),\n    domainVocabulary: grounded(frame.domainVocabulary)\n      .filter((item) => containsAlphanumericSpanCaseInsensitive(item.evidence, item.term)),\n  };\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.generator.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAQnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAoB3D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,gBAAgB,CAAC;IACzB,kFAAkF;IAClF,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,mFAAmF;AACnF,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5F;AAMD,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAAE,WAAW,EAAE,eAAe,CAAA;CAAE,GAAG,MAAM,CA0BxG;AAED,qFAAqF;AACrF,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAC,CAA+B;gBAEjC,KAAK,CAAC,EAAE,4BAA4B;IAQhD,OAAO,CAAC,QAAQ;IAOhB,2EAA2E;IAErE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAuBvE"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.generator.js","sourceRoot":"/","sources":["shared/hyde/hyde.generator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HyDE Generator Agent: pure LLM agent for generating hypothetical documents\n * in the target corpus voice. Uses free-text lens labels instead of enum strategies.\n */\nimport type { BaseLanguageModelInput } from '@langchain/core/language_models/base';\nimport { HumanMessage, SystemMessage } from '@langchain/core/messages';\nimport { z } from 'zod';\n\nimport { createStructuredModel } from \"../agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../agent/model-signal.js\";\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { Timed } from \"../observability/performance.js\";\nimport type { HydeSourceFrame } from './hyde.frame.js';\nimport { HYDE_CORPUS_PROMPTS } from './hyde.strategies.js';\nimport type { HydeTargetCorpus } from './lens.inferrer.js';\n\nconst logger = protocolLogger(\"HydeGenerator\");\n\nconst SYSTEM_PROMPT = `You are a Hypothetical Document Generator for semantic search.\n\nYour task: Given a source statement (e.g. an intent or goal), write a short hypothetical document in the voice of the TARGET side—the kind of person or statement that would be an ideal match for that source.\n\nRules:\n- Write in first person as the target.\n- Be concrete and specific so the text is good for vector similarity search.\n- Output only the hypothetical document text, no meta-commentary.\n- Keep length to a few sentences or one short paragraph.`;\n\nconst responseFormat = z.object({\n  hypotheticalDocument: z\n    .string()\n    .describe('The hypothetical document text in the target voice, suitable for embedding and retrieval'),\n});\n\nexport interface HydeGeneratorOutput {\n  text: string;\n}\n\nexport interface HydeGenerateInput {\n  /** Original intent or query text. */\n  sourceText: string;\n  /** Free-text lens label from LensInferrer (e.g. \"crypto infra VC\"). */\n  lens: string;\n  /** Which corpus voice to generate in. */\n  corpus: HydeTargetCorpus;\n  /** Sanitized source-grounded frame. Absence preserves the exact legacy prompt. */\n  sourceFrame?: HydeSourceFrame;\n}\n\n/** Minimal structured model contract used for deterministic injection in tests. */\nexport interface HydeGeneratorStructuredModel {\n  invoke(input: BaseLanguageModelInput, config?: { signal?: AbortSignal }): Promise<unknown>;\n}\n\nfunction renderList(items: string[]): string {\n  return items.length > 0 ? items.join('; ') : '(none)';\n}\n\n/** Build the frame-v1 generation prompt from sanitized source evidence. */\nexport function buildFrameHydePrompt(input: HydeGenerateInput & { sourceFrame: HydeSourceFrame }): string {\n  const { sourceText, corpus, sourceFrame } = input;\n  const corpusInstruction = {\n    profiles: 'Write a first-person professional biography in the target profile voice.',\n    intents: 'Write a first-person goal or aspiration in the target intent voice.',\n    premises: 'Write a first-person stable identity, values, or worldview statement in the target premise voice.',\n  }[corpus];\n\n  return `${corpusInstruction}\n\nSource text: \"${sourceText}\"\n\nSanitized source frame:\n- Source roles: ${renderList(sourceFrame.sourceRoles.map((item) => `${item.role} [evidence: \"${item.evidence}\"]`))}\n- Counterpart/complementary roles: ${renderList(sourceFrame.counterpartRoles.map((item) => `${item.role} [evidence: \"${item.evidence}\"]`))}\n- Explicit hard constraints: ${renderList(sourceFrame.hardConstraints.map((item) => `${item.type}: ${item.value} [evidence: \"${item.evidence}\"]`))}\n- Named entities: ${renderList(sourceFrame.namedEntities.map((item) => `${item.type}: ${item.name} [evidence: \"${item.evidence}\"]`))}\n- Domain vocabulary: ${renderList(sourceFrame.domainVocabulary.map((item) => `${item.term} [evidence: \"${item.evidence}\"]`))}\n\nGeneration constraints:\n- You MAY elaborate generic roles and generic domain language.\n- You MAY use reciprocal/complementary inversion and write in the target voice.\n- You MUST NOT introduce any new proper noun or named entity.\n- You MUST NOT introduce any new hard location, time, numeric, credential, organization, or exclusivity constraint.\n- Preserve explicit source-frame constraints when they apply to the reciprocal target.\n- Output only a few sentences or one short paragraph.`;\n}\n\n/** Generates hypothetical documents in a target corpus voice for semantic search. */\nexport class HydeGenerator {\n  private model?: HydeGeneratorStructuredModel;\n\n  constructor(model?: HydeGeneratorStructuredModel) {\n    // Preserve the legacy production model construction path; injected models\n    // keep prompt tests provider-free.\n    this.model = model ?? createStructuredModel(\"hydeGenerator\", responseFormat, {\n      name: \"hyde_generator\",\n    });\n  }\n\n  private getModel(): HydeGeneratorStructuredModel {\n    this.model ??= createStructuredModel(\"hydeGenerator\", responseFormat, {\n      name: \"hyde_generator\",\n    });\n    return this.model;\n  }\n\n  /** Generate a hypothetical document for the given source text and lens. */\n  @Timed()\n  async generate(input: HydeGenerateInput): Promise<HydeGeneratorOutput> {\n    const promptText = input.sourceFrame\n      ? buildFrameHydePrompt(input as HydeGenerateInput & { sourceFrame: HydeSourceFrame })\n      : HYDE_CORPUS_PROMPTS[input.corpus](input.sourceText, input.lens);\n\n    const messages = [\n      new SystemMessage(SYSTEM_PROMPT),\n      new HumanMessage(promptText),\n    ];\n\n    const result = await invokeWithAbortSignal(this.getModel(), messages);\n    const parsed = responseFormat.parse(result);\n    const text = parsed.hypotheticalDocument ?? '';\n\n    logger.verbose('Generated HyDE document', {\n      lens: input.lens,\n      corpus: input.corpus,\n      textLength: text.length,\n      frameConstrained: !!input.sourceFrame,\n    });\n\n    return { text };\n  }\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.graph.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.graph.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAK9E,OAAO,EAAwD,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAiB,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAA8B,MAAM,qBAAqB,CAAC;AAUrI,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChE;AAED,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClE;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,gBAAgB;IAC/B,sFAAsF;IACtF,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAsID,wFAAwF;AACxF,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;gBALP,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,gBAAqB;IAGxC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiZZ"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.graph.js","sourceRoot":"/","sources":["shared/hyde/hyde.graph.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HyDE Graph: cache-aware hypothetical document generation with lens inference.\n *\n * Legacy flow: infer_lenses → check_cache → generate_missing? → embed → cache_results.\n * Frame-v1 flow adds one batch validate_generated node before embed.\n */\nimport { createHash } from 'crypto';\nimport { END, START, StateGraph } from '@langchain/langgraph';\n\nimport type { DebugMetaAgent } from '../../chat/chat-streaming.types.js';\nimport { getAbortSignalConfig } from '../agent/model-signal.js';\nimport type { HydeCache } from '../interfaces/cache.interface.js';\nimport type { HydeGraphDatabase } from '../interfaces/database.interface.js';\nimport type { EmbeddingGenerator } from '../interfaces/embedder.interface.js';\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { timed } from '../observability/performance.js';\nimport { requestContext } from \"../observability/request-context.js\";\nimport { computeHydeSourceTextHash } from './hyde.documents.js';\nimport { getHydeGenerationMode, HYDE_FRAME_GENERATION_VERSION, type HydeGenerationMode } from './hyde.env.js';\nimport { sanitizeHydeSourceFrame, type HydeSourceFrame } from './hyde.frame.js';\nimport type { HydeGenerateInput, HydeGeneratorOutput } from './hyde.generator.js';\nimport { HydeGraphState, type HydeDocumentState } from './hyde.state.js';\nimport type { LensInferenceInput, LensInferenceOutput } from './lens.inferrer.js';\nimport { HYDE_DEFAULT_CACHE_TTL } from './hyde.strategies.js';\nimport { HydeValidator, type HydeValidationInput, type HydeValidationOutput, type HydeValidationVerdict } from './hyde.validator.js';\n\nconst logger = protocolLogger(\"HyDEGraphFactory\");\nlet lastGenerationTimestamp = 0;\n\nfunction nextGenerationMarker(): string {\n  lastGenerationTimestamp = Math.max(Date.now(), lastGenerationTimestamp + 1);\n  return new Date(lastGenerationTimestamp).toISOString();\n}\n\n/** Narrow lens inferrer contract accepted by the graph. */\nexport interface HydeLensInferrerLike {\n  infer(input: LensInferenceInput): Promise<LensInferenceOutput>;\n}\n\n/** Narrow document generator contract accepted by the graph. */\nexport interface HydeGeneratorLike {\n  generate(input: HydeGenerateInput): Promise<HydeGeneratorOutput>;\n}\n\n/** Narrow batch validator contract accepted by the graph. */\nexport interface HydeValidatorLike {\n  validate(input: HydeValidationInput): Promise<HydeValidationOutput>;\n}\n\nexport interface HydeGraphOptions {\n  /** Test override. Production derives the mode from HYDE_FRAME_CONSTRAINTS_ENABLED. */\n  mode?: HydeGenerationMode;\n  validator?: HydeValidatorLike;\n}\n\n/** Hash a lens label (+ optional corpus) to a short key for cache/DB indexing. */\nfunction lensHash(label: string, corpus?: string): string {\n  const input = corpus\n    ? `${label.toLowerCase().trim()}:${corpus}`\n    : label.toLowerCase().trim();\n  return createHash('sha256').update(input).digest('hex').slice(0, 16);\n}\n\nfunction entityCacheKey(sourceId: string | undefined, sourceText: string): string {\n  return sourceId ?? `q:${createHash('sha256').update(sourceText).digest('hex').slice(0, 16)}`;\n}\n\nfunction sortedFrame(frame: HydeSourceFrame): HydeSourceFrame {\n  const sort = <T>(items: T[]): T[] => [...items].sort((left, right) => {\n    const leftJson = JSON.stringify(left);\n    const rightJson = JSON.stringify(right);\n    return leftJson < rightJson ? -1 : leftJson > rightJson ? 1 : 0;\n  });\n  return {\n    sourceRoles: sort(frame.sourceRoles),\n    counterpartRoles: sort(frame.counterpartRoles),\n    hardConstraints: sort(frame.hardConstraints),\n    namedEntities: sort(frame.namedEntities),\n    domainVocabulary: sort(frame.domainVocabulary),\n  };\n}\n\n/** Deterministic identity for the source content and sanitized frame. */\nfunction computeHydeFrameFingerprint(sourceText: string, sourceFrame: HydeSourceFrame): string {\n  return createHash('sha256')\n    .update(sourceText)\n    .update('\\0')\n    .update(JSON.stringify(sortedFrame(sourceFrame)))\n    .digest('hex');\n}\n\nfunction requireFrameFingerprint(frameFingerprint: string | undefined): string {\n  if (!frameFingerprint) throw new Error('frame-v1 HyDE requires a frame fingerprint');\n  return frameFingerprint;\n}\n\n/** Preserve the exact legacy Redis key and isolate frame-v1 data by namespace. */\nfunction cacheKey(\n  mode: HydeGenerationMode,\n  sourceType: string,\n  sourceId: string | undefined,\n  sourceText: string,\n  lens: string,\n  corpus?: string,\n  frameFingerprint?: string,\n): string {\n  const entityKey = entityCacheKey(sourceId, sourceText);\n  if (mode === 'legacy') return `hyde:${sourceType}:${entityKey}:${lensHash(lens, corpus)}`;\n  return `hyde:${HYDE_FRAME_GENERATION_VERSION}:${sourceType}:${entityKey}:${requireFrameFingerprint(frameFingerprint)}:${lensHash(lens, corpus)}`;\n}\n\n/** Preserve legacy identity and use a stable frame-v1 identity per lens/corpus. */\nfunction dbStrategy(mode: HydeGenerationMode, label: string, corpus?: string): string {\n  const hash = lensHash(label, corpus);\n  return mode === 'legacy' ? hash : `${HYDE_FRAME_GENERATION_VERSION}:${hash}`;\n}\n\nfunction isValidGenerationMarker(value: unknown): value is string {\n  return typeof value === 'string' && Number.isFinite(Date.parse(value));\n}\n\nfunction isFrameCacheDocument(\n  doc: HydeDocumentState,\n  lensLabel: string,\n  frameFingerprint: string,\n  sourceTextHash: string,\n): boolean {\n  return doc.hydeGenerationVersion === HYDE_FRAME_GENERATION_VERSION\n    && doc.validationStatus === 'valid'\n    && doc.lens === lensLabel\n    && doc.frameFingerprint === frameFingerprint\n    && doc.sourceTextHash === sourceTextHash\n    && isValidGenerationMarker(doc.generatedAt);\n}\n\ninterface FrameDbContext extends Record<string, unknown> {\n  hydeGenerationVersion: typeof HYDE_FRAME_GENERATION_VERSION;\n  lensLabel: string;\n  validationStatus: 'valid';\n  frameFingerprint: string;\n  sourceTextHash: string;\n  generatedAt: string;\n}\n\nfunction isFrameDbContext(\n  context: Record<string, unknown> | null,\n  lensLabel: string,\n  frameFingerprint: string,\n  sourceTextHash: string,\n): context is FrameDbContext {\n  return context?.hydeGenerationVersion === HYDE_FRAME_GENERATION_VERSION\n    && context.lensLabel === lensLabel\n    && context.validationStatus === 'valid'\n    && context.frameFingerprint === frameFingerprint\n    && context.sourceTextHash === sourceTextHash\n    && isValidGenerationMarker(context.generatedAt);\n}\n\nfunction emptyFrame(): HydeSourceFrame {\n  return {\n    sourceRoles: [],\n    counterpartRoles: [],\n    hardConstraints: [],\n    namedEntities: [],\n    domainVocabulary: [],\n  };\n}\n\nfunction opaqueDocumentKey(doc: HydeDocumentState): string {\n  return `d-${createHash('sha256')\n    .update(`${doc.lens}\\0${doc.targetCorpus}\\0${doc.hydeText}`)\n    .digest('hex')\n    .slice(0, 16)}`;\n}\n\nfunction isRuntimeVerdict(value: unknown): value is HydeValidationVerdict {\n  if (!value || typeof value !== 'object') return false;\n  const verdict = value as Partial<HydeValidationVerdict>;\n  return typeof verdict.key === 'string'\n    && typeof verdict.valid === 'boolean'\n    && Array.isArray(verdict.unsupportedNamedEntities)\n    && verdict.unsupportedNamedEntities.every((item) => typeof item === 'string')\n    && Array.isArray(verdict.unsupportedHardConstraints)\n    && verdict.unsupportedHardConstraints.every((item) => typeof item === 'string')\n    && typeof verdict.reasoning === 'string';\n}\n\n/** Factory for the HyDE generation graph. Existing five-argument calls remain valid. */\nexport class HydeGraphFactory {\n  constructor(\n    private database: HydeGraphDatabase,\n    private embedder: EmbeddingGenerator,\n    private cache: HydeCache,\n    private inferrer: HydeLensInferrerLike,\n    private generator: HydeGeneratorLike,\n    private options: HydeGraphOptions = {},\n  ) {}\n\n  createGraph() {\n    const self = this;\n    const mode = this.options.mode ?? getHydeGenerationMode();\n    const validator = mode === HYDE_FRAME_GENERATION_VERSION\n      ? (this.options.validator ?? new HydeValidator())\n      : undefined;\n\n    /** Node 1: Infer lenses from source text + optional profile context. */\n    const inferLensesNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.inferLenses\", async () => {\n        const { sourceText, profileContext, maxLenses } = state;\n        const agentTimingsAccum: DebugMetaAgent[] = [];\n\n        try {\n          const traceEmitter = requestContext.getStore()?.traceEmitter;\n          const inferrerStart = Date.now();\n          traceEmitter?.({ type: \"agent_start\", name: \"lens-inferrer\" });\n          const result = await self.inferrer.infer({\n            sourceText,\n            profileContext,\n            maxLenses,\n            ...(mode === HYDE_FRAME_GENERATION_VERSION ? { frameConstrained: true } : {}),\n          });\n          const durationMs = Date.now() - inferrerStart;\n          agentTimingsAccum.push({ name: 'lens.inferrer', durationMs });\n          traceEmitter?.({ type: \"agent_end\", name: \"lens-inferrer\", durationMs, summary: result.lenses.length > 0 ? `Inferred ${result.lenses.length} lens(es)` : \"lens-inferrer completed\" });\n\n          if (mode === HYDE_FRAME_GENERATION_VERSION) {\n            const sourceFrame = sanitizeHydeSourceFrame(sourceText, result.sourceFrame ?? emptyFrame());\n            return {\n              lenses: result.lenses,\n              sourceFrame,\n              frameFingerprint: computeHydeFrameFingerprint(sourceText, sourceFrame),\n              sourceTextHash: computeHydeSourceTextHash(sourceText),\n              generatedAt: nextGenerationMarker(),\n              agentTimings: agentTimingsAccum,\n            };\n          }\n\n          return { lenses: result.lenses, agentTimings: agentTimingsAccum };\n        } catch (error) {\n          logger.error('Lens inference failed in graph node', { error });\n          if (mode === HYDE_FRAME_GENERATION_VERSION) {\n            const sourceFrame = emptyFrame();\n            return {\n              lenses: [],\n              sourceFrame,\n              frameFingerprint: computeHydeFrameFingerprint(sourceText, sourceFrame),\n              sourceTextHash: computeHydeSourceTextHash(sourceText),\n              generatedAt: nextGenerationMarker(),\n              agentTimings: agentTimingsAccum,\n            };\n          }\n          return { lenses: [], agentTimings: agentTimingsAccum };\n        }\n      });\n    };\n\n    /** Node 2: Check the mode-isolated cache/DB for matching documents. */\n    const checkCacheNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.checkCache\", async () => {\n        const { sourceType, sourceId, sourceText, lenses, forceRegenerate } = state;\n\n        if (forceRegenerate) return { hydeDocuments: {} };\n\n        const frameFingerprint = mode === HYDE_FRAME_GENERATION_VERSION\n          ? requireFrameFingerprint(state.frameFingerprint)\n          : undefined;\n        const sourceTextHash = mode === HYDE_FRAME_GENERATION_VERSION\n          ? state.sourceTextHash ?? computeHydeSourceTextHash(sourceText)\n          : undefined;\n        const cached: Record<string, HydeDocumentState> = {};\n        for (const lens of lenses) {\n          const key = cacheKey(\n            mode,\n            sourceType,\n            sourceId ?? undefined,\n            sourceText,\n            lens.label,\n            lens.corpus,\n            frameFingerprint,\n          );\n          const fromCache = await self.cache.get<HydeDocumentState>(key);\n          const cacheAccepted = fromCache?.hydeText\n            && fromCache.hydeEmbedding?.length\n            && (mode === 'legacy' || isFrameCacheDocument(fromCache, lens.label, frameFingerprint!, sourceTextHash!));\n          if (cacheAccepted && fromCache) {\n            cached[lens.label] = {\n              ...fromCache,\n              ...(mode === HYDE_FRAME_GENERATION_VERSION ? { origin: 'cache' as const } : {}),\n            };\n            continue;\n          }\n\n          if (sourceId) {\n            const fromDb = await self.database.getHydeDocument(\n              sourceType,\n              sourceId,\n              dbStrategy(mode, lens.label, lens.corpus),\n            );\n            const frameDbContext = mode === HYDE_FRAME_GENERATION_VERSION && fromDb\n              ? fromDb.context\n              : null;\n            if (fromDb && (mode === 'legacy' || isFrameDbContext(frameDbContext, lens.label, frameFingerprint!, sourceTextHash!))) {\n              cached[lens.label] = {\n                lens: lens.label,\n                targetCorpus: fromDb.targetCorpus as HydeDocumentState['targetCorpus'],\n                hydeText: fromDb.hydeText,\n                hydeEmbedding: fromDb.hydeEmbedding,\n                ...(mode === HYDE_FRAME_GENERATION_VERSION\n                  ? {\n                    origin: 'db' as const,\n                    validationStatus: 'valid' as const,\n                    hydeGenerationVersion: HYDE_FRAME_GENERATION_VERSION,\n                    frameFingerprint,\n                    sourceTextHash,\n                    generatedAt: (frameDbContext as FrameDbContext).generatedAt,\n                  }\n                  : {}),\n              };\n            }\n          }\n        }\n\n        if (mode === HYDE_FRAME_GENERATION_VERSION) {\n          const newestTimestamp = Math.max(\n            ...Object.values(cached).map((doc) => Date.parse(doc.generatedAt ?? '')),\n          );\n          if (Number.isFinite(newestTimestamp)) {\n            return {\n              hydeDocuments: Object.fromEntries(Object.entries(cached).filter(([, doc]) =>\n                Date.parse(doc.generatedAt ?? '') === newestTimestamp)),\n            };\n          }\n        }\n\n        return { hydeDocuments: cached };\n      });\n    };\n\n    const shouldGenerate = (state: typeof HydeGraphState.State): string =>\n      state.lenses.some((lens) => !state.hydeDocuments[lens.label]) ? 'generate' : 'skip';\n\n    /** Node 3: Generate all missing documents and return a complete snapshot. */\n    const generateMissingNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.generateMissing\", async () => {\n        const { sourceText, sourceFrame, lenses, hydeDocuments } = state;\n        const missing = lenses.filter((lens) => !hydeDocuments[lens.label]);\n        const agentTimingsAccum: DebugMetaAgent[] = [];\n        const generated: Record<string, HydeDocumentState> = {};\n        const sourceTextHash = mode === HYDE_FRAME_GENERATION_VERSION\n          ? state.sourceTextHash ?? computeHydeSourceTextHash(sourceText)\n          : undefined;\n        const generatedAt = mode === HYDE_FRAME_GENERATION_VERSION\n          ? state.generatedAt ?? nextGenerationMarker()\n          : undefined;\n\n        await Promise.all(missing.map(async (lens) => {\n          const traceEmitter = requestContext.getStore()?.traceEmitter;\n          const generatorStart = Date.now();\n          traceEmitter?.({ type: \"agent_start\", name: \"hyde-generator\" });\n          const out = await self.generator.generate({\n            sourceText,\n            lens: lens.label,\n            corpus: lens.corpus,\n            ...(mode === HYDE_FRAME_GENERATION_VERSION && sourceFrame ? { sourceFrame } : {}),\n          });\n          const durationMs = Date.now() - generatorStart;\n          agentTimingsAccum.push({ name: 'hyde.generator', durationMs });\n          traceEmitter?.({ type: \"agent_end\", name: \"hyde-generator\", durationMs, summary: `Generated: ${lens.label}` });\n          generated[lens.label] = {\n            lens: lens.label,\n            targetCorpus: lens.corpus,\n            hydeText: out.text,\n            hydeEmbedding: [],\n            ...(mode === HYDE_FRAME_GENERATION_VERSION\n              ? {\n                origin: 'generated' as const,\n                frameFingerprint: requireFrameFingerprint(state.frameFingerprint),\n                sourceTextHash,\n                generatedAt,\n              }\n              : {}),\n          };\n        }));\n\n        const retained = mode === HYDE_FRAME_GENERATION_VERSION\n          ? Object.fromEntries(Object.entries(hydeDocuments).map(([label, doc]) => [\n            label,\n            {\n              ...doc,\n              frameFingerprint: requireFrameFingerprint(state.frameFingerprint),\n              sourceTextHash,\n              generatedAt,\n            },\n          ]))\n          : hydeDocuments;\n\n        return { hydeDocuments: { ...retained, ...generated }, agentTimings: agentTimingsAccum };\n      });\n    };\n\n    /** Frame-v1 only: validate newly generated docs in one batch. */\n    const validateGeneratedNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.validateGenerated\", async () => {\n        const generated = Object.values(state.hydeDocuments).filter((doc) => doc.origin === 'generated');\n        if (generated.length === 0 || !validator) return { hydeDocuments: state.hydeDocuments };\n\n        const frame = sanitizeHydeSourceFrame(state.sourceText, state.sourceFrame ?? emptyFrame());\n        const documents: HydeValidationInput['documents'] = {};\n        const lensByDocumentKey = new Map<string, string>();\n        for (const doc of generated) {\n          const key = opaqueDocumentKey(doc);\n          documents[key] = { corpus: doc.targetCorpus, text: doc.hydeText };\n          lensByDocumentKey.set(key, doc.lens);\n        }\n\n        const updated = { ...state.hydeDocuments };\n        const agentTimingsAccum: DebugMetaAgent[] = [];\n        const traceEmitter = requestContext.getStore()?.traceEmitter;\n        const validatorStart = Date.now();\n        let validCount = 0;\n        let rejectedCount = 0;\n        let failedOpenCount = 0;\n        traceEmitter?.({ type: 'agent_start', name: 'hyde-validator' });\n\n        try {\n          const output = await validator.validate({\n            sourceText: state.sourceText,\n            sourceFrame: frame,\n            documents,\n          });\n          const rawVerdicts: unknown[] = Array.isArray((output as { verdicts?: unknown }).verdicts)\n            ? (output as { verdicts: unknown[] }).verdicts\n            : [];\n\n          for (const key of Object.keys(documents)) {\n            const lensLabel = lensByDocumentKey.get(key);\n            if (!lensLabel) continue;\n            const matching = rawVerdicts.filter((value) =>\n              !!value && typeof value === 'object' && (value as { key?: unknown }).key === key);\n            const doc = updated[lensLabel];\n            if (!doc) continue;\n\n            if (matching.length !== 1 || !isRuntimeVerdict(matching[0])) {\n              failedOpenCount += 1;\n              updated[lensLabel] = { ...doc, validationStatus: 'failed_open', hydeGenerationVersion: HYDE_FRAME_GENERATION_VERSION };\n              continue;\n            }\n\n            const verdict = matching[0];\n            const hasUnsupportedGrounding = verdict.unsupportedNamedEntities.length > 0\n              || verdict.unsupportedHardConstraints.length > 0;\n            const contradictory = verdict.valid === hasUnsupportedGrounding;\n            if (contradictory) {\n              failedOpenCount += 1;\n              updated[lensLabel] = { ...doc, validationStatus: 'failed_open', hydeGenerationVersion: HYDE_FRAME_GENERATION_VERSION };\n            } else if (!verdict.valid) {\n              rejectedCount += 1;\n              delete updated[lensLabel];\n            } else {\n              validCount += 1;\n              updated[lensLabel] = { ...doc, validationStatus: 'valid', hydeGenerationVersion: HYDE_FRAME_GENERATION_VERSION };\n            }\n          }\n        } catch (error) {\n          logger.error('HyDE validation failed open', { error });\n          validCount = 0;\n          rejectedCount = 0;\n          failedOpenCount = generated.length;\n          for (const doc of generated) {\n            updated[doc.lens] = { ...doc, validationStatus: 'failed_open', hydeGenerationVersion: HYDE_FRAME_GENERATION_VERSION };\n          }\n        } finally {\n          const durationMs = Date.now() - validatorStart;\n          agentTimingsAccum.push({ name: 'hyde.validator', durationMs });\n          traceEmitter?.({\n            type: 'agent_end',\n            name: 'hyde-validator',\n            durationMs,\n            summary: `${validCount} valid, ${rejectedCount} rejected, ${failedOpenCount} failed open`,\n          });\n        }\n\n        return { hydeDocuments: updated, agentTimings: agentTimingsAccum };\n      });\n    };\n\n    /** Embed all accepted/cached documents that do not have embeddings. */\n    const embedNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.embed\", async () => {\n        const toEmbed: { label: string; doc: HydeDocumentState }[] = [];\n        const updated: Record<string, HydeDocumentState> = {};\n        const hydeEmbeddings: Record<string, number[]> = {};\n\n        for (const [label, doc] of Object.entries(state.hydeDocuments)) {\n          if (doc.hydeEmbedding?.length) {\n            updated[label] = doc;\n            hydeEmbeddings[label] = doc.hydeEmbedding;\n          } else {\n            toEmbed.push({ label, doc });\n          }\n        }\n\n        if (toEmbed.length > 0) {\n          const embeddings = await self.embedder.generate(\n            toEmbed.map((item) => item.doc.hydeText),\n            undefined,\n            getAbortSignalConfig(),\n          );\n          const embeddingArray = Array.isArray(embeddings[0]) ? embeddings as number[][] : [embeddings as number[]];\n          for (let i = 0; i < toEmbed.length; i++) {\n            const { label, doc } = toEmbed[i];\n            const embedding = embeddingArray[i] ?? [];\n            updated[label] = { ...doc, hydeEmbedding: embedding };\n            hydeEmbeddings[label] = embedding;\n          }\n        }\n\n        return { hydeDocuments: updated, hydeEmbeddings };\n      });\n    };\n\n    /** Cache/persist only legacy docs or successfully validated frame-v1 docs. */\n    const cacheResultsNode = async (state: typeof HydeGraphState.State) => {\n      return timed(\"HydeGraph.cacheResults\", async () => {\n        const { sourceType, sourceId, sourceText, hydeDocuments } = state;\n        const frameFingerprint = mode === HYDE_FRAME_GENERATION_VERSION\n          ? requireFrameFingerprint(state.frameFingerprint)\n          : undefined;\n        const sourceTextHash = mode === HYDE_FRAME_GENERATION_VERSION\n          ? state.sourceTextHash ?? computeHydeSourceTextHash(sourceText)\n          : undefined;\n        for (const [label, doc] of Object.entries(hydeDocuments)) {\n          if (mode === HYDE_FRAME_GENERATION_VERSION\n            && !isFrameCacheDocument(doc, label, frameFingerprint!, sourceTextHash!)) continue;\n\n          const key = cacheKey(\n            mode,\n            sourceType,\n            sourceId ?? undefined,\n            sourceText,\n            label,\n            doc.targetCorpus,\n            frameFingerprint,\n          );\n          await self.cache.set(key, doc, { ttl: HYDE_DEFAULT_CACHE_TTL });\n\n          if (sourceId) {\n            await self.database.saveHydeDocument({\n              sourceType,\n              sourceId,\n              strategy: dbStrategy(mode, label, doc.targetCorpus),\n              targetCorpus: doc.targetCorpus,\n              hydeText: doc.hydeText,\n              hydeEmbedding: doc.hydeEmbedding,\n              ...(mode === HYDE_FRAME_GENERATION_VERSION ? {\n                context: {\n                  hydeGenerationVersion: HYDE_FRAME_GENERATION_VERSION,\n                  lensLabel: label,\n                  validationStatus: 'valid',\n                  frameFingerprint: doc.frameFingerprint,\n                  sourceTextHash: doc.sourceTextHash,\n                  generatedAt: doc.generatedAt,\n                },\n              } : {}),\n            });\n          }\n        }\n        return {};\n      });\n    };\n\n    const workflow = new StateGraph(HydeGraphState)\n      .addNode('infer_lenses', inferLensesNode)\n      .addNode('check_cache', checkCacheNode)\n      .addNode('generate_missing', generateMissingNode)\n      .addNode('embed', embedNode)\n      .addNode('cache_results', cacheResultsNode)\n      .addEdge(START, 'infer_lenses')\n      .addEdge('infer_lenses', 'check_cache')\n      .addConditionalEdges('check_cache', shouldGenerate, {\n        generate: 'generate_missing',\n        skip: 'embed',\n      });\n\n    if (mode === HYDE_FRAME_GENERATION_VERSION) {\n      workflow\n        .addNode('validate_generated', validateGeneratedNode)\n        .addEdge('generate_missing', 'validate_generated')\n        .addEdge('validate_generated', 'embed');\n    } else {\n      workflow.addEdge('generate_missing', 'embed');\n    }\n\n    workflow\n      .addEdge('embed', 'cache_results')\n      .addEdge('cache_results', END);\n\n    return workflow.compile();\n  }\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.state.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,IAAI,GAAG,WAAW,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;AAEvE,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2CAA2C;AAC3C,eAAO,MAAM,cAAc;IAGzB,mEAAmE;;;;;;IAGnE,4EAA4E;;IAM5E,qFAAqF;;;;;;IAGrF,4EAA4E;;IAM5E,qDAAqD;;IAMrD,0DAA0D;;IAQ1D,mDAAmD;;IAMnD,sEAAsE;;IAMtE,4EAA4E;;IAM5E,6EAA6E;;IAM7E,kFAAkF;;IAMlF;;;OAGG;;IAMH;;;OAGG;;IAMH,+BAA+B;;IAM/B,sEAAsE;;EAKtE,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.state.js","sourceRoot":"/","sources":["shared/hyde/hyde.state.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HyDE Graph state: cache-aware hypothetical document generation.\n * Used by the HyDE graph for infer_lenses → check_cache → generate_missing → embed → cache_results.\n */\n\nimport { Annotation } from '@langchain/langgraph';\nimport type { Id } from '../interfaces/database.interface.js';\nimport type { Lens, HydeTargetCorpus } from './lens.inferrer.js';\nimport type { HydeSourceFrame } from './hyde.frame.js';\nimport type { DebugMetaAgent } from '../../chat/chat-streaming.types.js';\n\nexport type HydeDocumentOrigin = 'cache' | 'db' | 'generated';\nexport type HydeValidationStatus = 'valid' | 'invalid' | 'failed_open';\n\n/** Single HyDE document (text + embedding) for one lens. */\nexport interface HydeDocumentState {\n  lens: string;\n  targetCorpus: HydeTargetCorpus;\n  hydeText: string;\n  hydeEmbedding: number[];\n  origin?: HydeDocumentOrigin;\n  validationStatus?: HydeValidationStatus;\n  hydeGenerationVersion?: 'frame-v1';\n  frameFingerprint?: string;\n  sourceTextHash?: string;\n  generatedAt?: string;\n}\n\n/** State for the HyDE generation graph. */\nexport const HydeGraphState = Annotation.Root({\n  // ─── Inputs ─────────────────────────────────────────────────────────────\n\n  /** Source type: intent, profile, user context, or ad-hoc query. */\n  sourceType: Annotation<'intent' | 'query' | 'context'>,\n\n  /** Source entity ID (e.g. intent ID, user ID). Omitted for ad-hoc query. */\n  sourceId: Annotation<Id<'intents'> | Id<'users'> | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Source text to generate HyDE from (intent payload, profile summary, or query). */\n  sourceText: Annotation<string>,\n\n  /** Optional profile context for lens inference (user's profile summary). */\n  profileContext: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Maximum number of lenses to infer (default 3). */\n  maxLenses: Annotation<number>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => 3,\n  }),\n\n  /** When true, skip cache/DB and regenerate all lenses. */\n  forceRegenerate: Annotation<boolean>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => false,\n  }),\n\n  // ─── Intermediate / output ─────────────────────────────────────────────\n\n  /** Inferred lenses from the LensInferrer agent. */\n  lenses: Annotation<Lens[]>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => [],\n  }),\n\n  /** Sanitized source-grounded frame produced by frame-v1 inference. */\n  sourceFrame: Annotation<HydeSourceFrame | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Exact sourceText + sanitized sourceFrame identity for frame-v1 reuse. */\n  frameFingerprint: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Hash of the exact source text for persisted frame-v1 freshness checks. */\n  sourceTextHash: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Shared cohort marker assigned when this run generates any missing document. */\n  generatedAt: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /**\n   * Complete HyDE document snapshot keyed by lens label. Writers replace the\n   * snapshot so rejected documents can be removed before embedding.\n   */\n  hydeDocuments: Annotation<Record<string, HydeDocumentState>>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => ({}),\n  }),\n\n  /**\n   * Final embeddings per lens (convenience output for search).\n   * Populated by embed node; used by opportunity graph.\n   */\n  hydeEmbeddings: Annotation<Record<string, number[]>>({\n    reducer: (curr, next) => (next ? { ...curr, ...next } : curr),\n    default: () => ({}),\n  }),\n\n  /** Non-fatal error message. */\n  error: Annotation<string | undefined>({\n    reducer: (curr, next) => next ?? curr,\n    default: () => undefined,\n  }),\n\n  /** Timing records for each agent invocation within this graph run. */\n  agentTimings: Annotation<DebugMetaAgent[]>({\n    reducer: (acc, val) => [...acc, ...val],\n    default: () => [],\n  }),\n});\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.strategies.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE1G,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAmBtG,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.strategies.js","sourceRoot":"/","sources":["shared/hyde/hyde.strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2E;IACzG,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;+EAC6C,UAAU;0EACf,IAAI;;;GAG3E;IACD,OAAO,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;+DAC8B,IAAI;6CACtB,UAAU;;;GAGpD;IACD,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;oGACkE,UAAU;0CACpE,IAAI;;;GAG3C;CACF,CAAC","sourcesContent":["/**\n * HyDE (Hypothetical Document Embeddings) type definitions.\n *\n * The system is now role-agnostic: instead of hardcoded strategy names\n * (mirror, reciprocal, mentor, investor, collaborator, hiree), an LLM\n * infers free-text \"lenses\" dynamically. This file re-exports the lens\n * types and provides constants for the HyDE pipeline.\n */\n\nimport type { HydeTargetCorpus } from './lens.inferrer.js';\n\nexport type { Lens, HydeTargetCorpus, LensInferenceInput, LensInferenceOutput } from './lens.inferrer.js';\n\n/** Default cache TTL for ephemeral HyDE documents (1 hour). */\nexport const HYDE_DEFAULT_CACHE_TTL = 3600;\n\n/**\n * Prompt templates for HyDE document generation.\n * Keyed by target corpus — the lens label provides the semantic specificity.\n */\nexport const HYDE_CORPUS_PROMPTS: Record<HydeTargetCorpus, (sourceText: string, lens: string) => string> = {\n  profiles: (sourceText, lens) => `\n    Write a professional biography for someone who could fulfill this need: \"${sourceText}\".\n    Focus on the specific expertise, background, and role described by: ${lens}.\n\n    Write in first person. Include concrete skills, domain experience, and current professional focus that would make them a strong match.\n  `,\n  intents: (sourceText, lens) => `\n    Write a goal or aspiration statement for someone who is: ${lens}.\n    This person's needs would complement: \"${sourceText}\".\n\n    Write in first person as if stating their own goal.\n  `,\n  premises: (sourceText, lens) => `\n    Write a short self-description for someone whose identity, values, or worldview aligns with: \"${sourceText}\".\n    Reflect the character described by: ${lens}.\n\n    Write in first person as a stable statement of who this person is, not what they want.\n  `,\n};\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.validator.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAEnF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,eAAe,CAAC;IAC7B,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,uEAAuE;AACvE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQvC,CAAC;AAaH,oDAAoD;AACpD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAE5E;AAED,mFAAmF;AACnF,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5F;AAED,+EAA+E;AAC/E,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAC,CAA+B;gBAEjC,KAAK,CAAC,EAAE,4BAA4B;IAIhD,OAAO,CAAC,QAAQ;IAOhB,qEAAqE;IAC/D,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAO1E"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"hyde.validator.js","sourceRoot":"/","sources":["shared/hyde/hyde.validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AA4BjE,uEAAuE;AACvE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACzB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;QAClB,wBAAwB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7C,0BAA0B,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KAC5E,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG;;;;;;;;;2JAS2H,CAAC;AAE5J,oDAAoD;AACpD,MAAM,UAAU,yBAAyB,CAAC,KAA0B;IAClE,OAAO,iBAAiB,KAAK,CAAC,UAAU,gCAAgC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,6BAA6B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AAC1K,CAAC;AAOD,+EAA+E;AAC/E,MAAM,OAAO,aAAa;IAGxB,YAAY,KAAoC;QAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,KAAK,KAAV,IAAI,CAAC,KAAK,GAAK,qBAAqB,CAAC,eAAe,EAAE,4BAA4B,EAAE;YAClF,IAAI,EAAE,gBAAgB;SACvB,CAAC,EAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,QAAQ,CAAC,KAA0B;QACvC,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE;YAC1D,IAAI,aAAa,CAAC,uBAAuB,CAAC;YAC1C,IAAI,YAAY,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;SACnD,CAAC,CAAC;QACH,OAAO,4BAA4B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;CACF","sourcesContent":["import type { BaseLanguageModelInput } from '@langchain/core/language_models/base';\nimport { HumanMessage, SystemMessage } from '@langchain/core/messages';\nimport { z } from 'zod';\n\nimport { createStructuredModel } from '../agent/model.config.js';\nimport { invokeWithAbortSignal } from '../agent/model-signal.js';\nimport type { HydeSourceFrame } from './hyde.frame.js';\nimport type { HydeTargetCorpus } from './lens.inferrer.js';\n\nexport interface HydeValidationDocument {\n  corpus: HydeTargetCorpus;\n  text: string;\n}\n\nexport interface HydeValidationInput {\n  sourceText: string;\n  sourceFrame: HydeSourceFrame;\n  /** Generated documents keyed by opaque caller-supplied identifiers. */\n  documents: Record<string, HydeValidationDocument>;\n}\n\nexport interface HydeValidationVerdict {\n  key: string;\n  valid: boolean;\n  unsupportedNamedEntities: string[];\n  unsupportedHardConstraints: string[];\n  reasoning: string;\n}\n\nexport interface HydeValidationOutput {\n  verdicts: HydeValidationVerdict[];\n}\n\n/** Structured-output schema for a single batch validation response. */\nexport const HydeValidationResponseSchema = z.object({\n  verdicts: z.array(z.object({\n    key: z.string().min(1),\n    valid: z.boolean(),\n    unsupportedNamedEntities: z.array(z.string()),\n    unsupportedHardConstraints: z.array(z.string()),\n    reasoning: z.string().min(1).describe('Concise explanation of the verdict'),\n  })),\n});\n\nconst VALIDATOR_SYSTEM_PROMPT = `You validate hypothetical retrieval documents against a sanitized source-grounded frame.\n\nA document is invalid only when it invents unsupported proper nouns/named entities or unsupported HARD constraints (location, time, numeric, credential, organization, or exclusivity constraints).\n\nExplicitly allowed and not grounds for rejection:\n- first-person target voice;\n- generic role or domain elaboration;\n- reciprocal or complementary inversion of source and target roles.\n\nReturn exactly one verdict for each opaque key. Copy each key exactly. Mark valid=false when either unsupported list is non-empty. Keep reasoning concise.`;\n\n/** Build a profile-free batch validation prompt. */\nexport function buildHydeValidationPrompt(input: HydeValidationInput): string {\n  return `Source text:\\n${input.sourceText}\\n\\nSanitized source frame:\\n${JSON.stringify(input.sourceFrame)}\\n\\nGenerated documents:\\n${JSON.stringify(input.documents)}`;\n}\n\n/** Minimal structured model contract used for deterministic injection in tests. */\nexport interface HydeValidatorStructuredModel {\n  invoke(input: BaseLanguageModelInput, config?: { signal?: AbortSignal }): Promise<unknown>;\n}\n\n/** Production structured-model batch validator for frame-v1 HyDE documents. */\nexport class HydeValidator {\n  private model?: HydeValidatorStructuredModel;\n\n  constructor(model?: HydeValidatorStructuredModel) {\n    this.model = model;\n  }\n\n  private getModel(): HydeValidatorStructuredModel {\n    this.model ??= createStructuredModel('hydeValidator', HydeValidationResponseSchema, {\n      name: 'hyde_validator',\n    });\n    return this.model;\n  }\n\n  /** Validate all generated documents in one structured-model call. */\n  async validate(input: HydeValidationInput): Promise<HydeValidationOutput> {\n    const result = await invokeWithAbortSignal(this.getModel(), [\n      new SystemMessage(VALIDATOR_SYSTEM_PROMPT),\n      new HumanMessage(buildHydeValidationPrompt(input)),\n    ]);\n    return HydeValidationResponseSchema.parse(result);\n  }\n}\n"]}

package/dist/shared/hyde/lens.inferrer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lens.inferrer.d.ts","sourceRoot":"/","sources":["shared/hyde/lens.inferrer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAEnF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAAkD,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvG,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnE,iFAAiF;AACjF,MAAM,WAAW,IAAI;IACnB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,EAAE,gBAAgB,CAAC;IACzB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAkBD,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,8mCAUkC,CAAC;AAYnE,qEAAqE;AACrE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9B,CAAC;AAEH,KAAK,UAAU,GAAG,sBAAsB,CAAC;AAEzC,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAID,0EAA0E;AAC1E,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAC,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAsB;gBAE7B,OAAO,GAAE,mBAAwB;IAQ7C,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAOrB,sFAAsF;IAEhF,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA8ErE"}

package/dist/shared/hyde/lens.inferrer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lens.inferrer.js","sourceRoot":"/","sources":["shared/hyde/lens.inferrer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Lens Inferrer Agent: analyzes source text (intent or query) with optional\n * profile context and infers 1-N search lenses, each tagged with a target corpus.\n * Replaces the hardcoded HydeStrategy enum and regex-based selectStrategiesFromQuery.\n */\nimport type { BaseLanguageModelInput } from '@langchain/core/language_models/base';\nimport { HumanMessage, SystemMessage } from '@langchain/core/messages';\nimport { z } from 'zod';\n\nimport { createStructuredModel } from \"../agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../agent/model-signal.js\";\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { Timed } from \"../observability/performance.js\";\nimport { HydeSourceFrameSchema, sanitizeHydeSourceFrame, type HydeSourceFrame } from './hyde.frame.js';\n\nexport type HydeTargetCorpus = 'profiles' | 'intents' | 'premises';\n\n/** A single inferred lens — a search perspective the LLM decided is relevant. */\nexport interface Lens {\n  /** Free-text description (e.g. \"crypto infrastructure VC\"). */\n  label: string;\n  /** Which vector index to search: user profiles or user intents. */\n  corpus: HydeTargetCorpus;\n  /** Why this perspective is relevant (for logging/trace). */\n  reasoning: string;\n}\n\nexport interface LensInferenceInput {\n  /** Intent payload or search query. */\n  sourceText: string;\n  /** User's profile summary for domain context (optional). */\n  profileContext?: string;\n  /** Maximum number of lenses to infer (default 3). */\n  maxLenses?: number;\n  /** Use the source-grounded frame-v1 inference path. */\n  frameConstrained?: boolean;\n}\n\nexport interface LensInferenceOutput {\n  lenses: Lens[];\n  /** Sanitized source frame, present only for frame-constrained inference. */\n  sourceFrame?: HydeSourceFrame;\n}\n\nconst SYSTEM_PROMPT = `You analyze goals and search queries to identify the most relevant perspectives for finding matching people in a professional network.\n\nFor each perspective you identify, specify:\n1. A clear, specific description of who or what to search for\n2. Whether to search \"profiles\" (user bios, expertise, backgrounds), \"intents\" (stated goals, needs, aspirations), or \"premises\" (identity assertions, values, worldview)\n3. A brief reason why this perspective is relevant\n\nGuidelines:\n- Be specific and domain-aware. \"early-stage crypto infrastructure investor\" is better than \"investor\".\n- Consider both sides: who can help the person AND whose goals complement theirs.\n- When user context is provided, tailor perspectives to their domain (e.g. a DePIN founder searching for \"investors\" needs crypto-native infra investors specifically).\n- Generate only perspectives that add distinct search value — don't repeat similar angles.\n- Use \"profiles\" when looking for a type of person (expert, advisor, leader). Use \"intents\" when looking for a complementary goal or need (someone raising, someone hiring, someone seeking collaboration). Use \"premises\" when looking for someone whose identity, values, or worldview aligns — stable traits rather than transient goals.\n- Always include at least one \"profiles\" perspective when the source describes a need that a specific type of professional could fulfill. Most intents benefit from profile-based discovery.\n- LOCATION AWARENESS: When the source text or user context mentions a specific location (city, region, country), incorporate it into lens descriptions. For example, \"investors in San Francisco\" should produce a lens like \"SF-based early-stage investor\" rather than just \"early-stage investor\". This helps the hypothetical document generator produce location-specific search documents, improving retrieval quality.`;\n\n/** Source-grounded system prompt used only by frame extraction. */\nexport const FRAME_SYSTEM_PROMPT = `You extract a source-grounded frame for semantic retrieval from sourceText alone.\n\nSource-frame rules:\n- Extract evidence ONLY from sourceText.\n- Every frame element must include an evidence field copied as an exact substring of sourceText.\n- sourceRoles describe roles held or offered by the source side.\n- sourceRoles and counterpartRoles MUST use generic lower-case role labels only (for example, \"founder\", \"investor\", or \"technical advisor\"). Never put a person, organization, product, location, time, number, credential, or exclusivity detail in a role label.\n- counterpartRoles describe reciprocal or complementary target roles. A generic role may be inferred, but its evidence must be an exact sourceText span that supports the inference.\n- hardConstraints contain only explicit constraints and classify each as location, time, numeric, credential, organization, exclusivity, or other.\n- namedEntities contain only proper names explicitly present in sourceText and classify each as person, organization, product, location, event, or other.\n- domainVocabulary contains source domain terms worth preserving.`;\n\nconst lensSchema = z.object({\n  label: z.string().describe('Specific description of the search perspective'),\n  corpus: z.enum(['profiles', 'intents', 'premises']).describe('Search user profiles, user intents, or user premises (identity/values)'),\n  reasoning: z.string().describe('Why this perspective is relevant'),\n});\n\nconst responseFormat = z.object({\n  lenses: z.array(lensSchema).min(1).max(5).describe('Inferred search lenses'),\n});\n\n/** Structured-output schema used only by source-frame extraction. */\nexport const FrameResponseSchema = z.object({\n  sourceFrame: HydeSourceFrameSchema,\n});\n\ntype ModelInput = BaseLanguageModelInput;\n\n/** Minimal structured model contract used for deterministic injection in tests. */\nexport interface LensStructuredModel {\n  invoke(input: ModelInput, config?: { signal?: AbortSignal }): Promise<unknown>;\n}\n\nexport interface LensInferrerOptions {\n  legacyModel?: LensStructuredModel;\n  frameModel?: LensStructuredModel;\n}\n\nconst logger = protocolLogger(\"LensInferrer\");\n\n/** Infers search lenses from source text and optional profile context. */\nexport class LensInferrer {\n  private legacyModel?: LensStructuredModel;\n  private frameModel?: LensStructuredModel;\n\n  constructor(options: LensInferrerOptions = {}) {\n    // Preserve legacy construction behavior in production. Frame-only model\n    // injection deliberately avoids constructing a provider-backed legacy model.\n    this.legacyModel = options.legacyModel\n      ?? (options.frameModel ? undefined : createStructuredModel(\"lensInferrer\", responseFormat, { name: \"lens_inferrer\" }));\n    this.frameModel = options.frameModel;\n  }\n\n  private getLegacyModel(): LensStructuredModel {\n    this.legacyModel ??= createStructuredModel(\"lensInferrer\", responseFormat, {\n      name: \"lens_inferrer\",\n    });\n    return this.legacyModel;\n  }\n\n  private getFrameModel(): LensStructuredModel {\n    this.frameModel ??= createStructuredModel(\"lensInferrer\", FrameResponseSchema, {\n      name: \"lens_inferrer_frame_v1\",\n    });\n    return this.frameModel;\n  }\n\n  /** Infer search lenses while preserving the legacy path unless explicitly enabled. */\n  @Timed()\n  async infer(input: LensInferenceInput): Promise<LensInferenceOutput> {\n    const { sourceText, profileContext, maxLenses = 3, frameConstrained = false } = input;\n\n    logger.verbose('Inferring lenses', {\n      sourceTextLength: sourceText.length,\n      hasProfileContext: !!profileContext,\n      maxLenses,\n      frameConstrained,\n    });\n\n    let humanPrompt = `Identify up to ${maxLenses} search perspectives for finding relevant matches.\\n\\nSource: \"${sourceText}\"`;\n\n    if (profileContext) {\n      humanPrompt += `\\n\\nUser context: ${profileContext}`;\n    }\n\n    const messages = [\n      new SystemMessage(SYSTEM_PROMPT),\n      new HumanMessage(humanPrompt),\n    ];\n\n    if (!frameConstrained) {\n      try {\n        const result = await invokeWithAbortSignal(this.getLegacyModel(), messages);\n        const parsed = responseFormat.parse(result);\n        const lenses = parsed.lenses.slice(0, maxLenses);\n\n        logger.verbose('Lenses inferred', {\n          count: lenses.length,\n          lenses: lenses.map(l => ({ label: l.label, corpus: l.corpus })),\n        });\n\n        return { lenses };\n      } catch (error: unknown) {\n        logger.error('Lens inference failed', { error });\n        return { lenses: [] };\n      }\n    }\n\n    const frameMessages = [\n      new SystemMessage(FRAME_SYSTEM_PROMPT),\n      new HumanMessage(`Extract the source frame.\\n\\nSource: \"${sourceText}\"`),\n    ];\n    const lensPromise = (async () => {\n      const result = await invokeWithAbortSignal(this.getLegacyModel(), messages);\n      return responseFormat.parse(result).lenses.slice(0, maxLenses);\n    })();\n    const framePromise = (async () => {\n      const result = await invokeWithAbortSignal(this.getFrameModel(), frameMessages);\n      const parsed = FrameResponseSchema.parse(result);\n      return sanitizeHydeSourceFrame(sourceText, parsed.sourceFrame);\n    })();\n    const [lensResult, frameResult] = await Promise.allSettled([lensPromise, framePromise]);\n\n    if (lensResult.status === 'rejected') {\n      logger.error('Lens inference failed', { error: lensResult.reason });\n      return { lenses: [] };\n    }\n\n    const lenses = lensResult.value;\n    logger.verbose('Frame-constrained lenses inferred', { count: lenses.length });\n\n    if (frameResult.status === 'rejected') {\n      logger.error('Source frame extraction failed', { error: frameResult.reason });\n      return {\n        lenses,\n        sourceFrame: {\n          sourceRoles: [],\n          counterpartRoles: [],\n          hardConstraints: [],\n          namedEntities: [],\n          domainVocabulary: [],\n        },\n      };\n    }\n\n    return { lenses, sourceFrame: frameResult.value };\n  }\n}\n"]}

package/dist/shared/interfaces/agent-dispatcher.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-dispatcher.interface.d.ts","sourceRoot":"/","sources":["shared/interfaces/agent-dispatcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACtH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAC5F,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAE9E,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,EAAE,sBAAsB,CAAC;IAClC,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,YAAY,EAAE,OAAO,CAAC;IACtB,gHAAgH;IAChH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC3C,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,8BAA8B,CAAC;IACrD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;CACzC;AAED,oCAAoC;AACpC,MAAM,MAAM,mBAAmB,GAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACxC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;CAAE,GAClD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9D,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;OAIG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7D,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}

package/dist/shared/interfaces/agent-dispatcher.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-dispatcher.interface.js","sourceRoot":"/","sources":["shared/interfaces/agent-dispatcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * AgentDispatcher interface for the negotiation graph.\n *\n * The graph calls dispatch() per turn and receives a result.\n * It never knows about webhooks, MCP, transports, or agent resolution.\n * The concrete implementation lives in the host application.\n */\n\nimport type { NegotiationTurn, UserNegotiationContext, SeedAssessment } from '../schemas/negotiation-state.schema.js';\nimport type { NegotiatorMemoryEntry } from '../../negotiation/negotiation.memory.js';\nimport type { AttributedPriorDialogue } from '../../negotiation/negotiation.attribution.js';\nimport type { NegotiationPrivateConsultation } from './database.interface.js';\n\n/** Payload sent to the dispatcher for each negotiation turn. */\nexport interface NegotiationTurnPayload {\n  negotiationId: string;\n  ownUser: UserNegotiationContext;\n  otherUser: UserNegotiationContext;\n  indexContext: { networkId: string; prompt?: string };\n  seedAssessment: SeedAssessment;\n  history: NegotiationTurn[];\n  isFinalTurn: boolean;\n  /** Whether ownUser is the party that initiated the discovery. */\n  isDiscoverer: boolean;\n  /** The explicit search query that triggered this discovery (if any). Takes priority over background intents. */\n  discoveryQuery?: string;\n  /** The acting user's seat under the v2 client-advocate protocol (`initiator` | `counterparty`). */\n  seat?: string;\n  /** Negotiation protocol version for this task (`v1` | `v2`). */\n  protocolVersion?: string;\n  /** Actions the acting seat may submit on this turn (seat + version + final-turn scoped). */\n  allowedActions?: string[];\n  /**\n   * The acting user's OWN negotiator memories (P5.3 read path) — private\n   * context for the dispatched agent. Never contains the counterparty's\n   * memory; absent when `NEGOTIATOR_MEMORY_INJECT` is off or nothing was\n   * retrieved.\n   */\n  negotiatorMemory?: NegotiatorMemoryEntry[];\n  /** Recipient-private ask-user consultation, present only for that recipient's turn. */\n  privateConsultation?: NegotiationPrivateConsultation;\n  /**\n   * Prior dialogue with this counterparty, grouped and labeled per opportunity\n   * (IND-569). Present only on continuations; lets an external agent see which\n   * prior turns belonged to already-concluded OTHER opportunities versus the\n   * one under negotiation now. Absent → no attributed prior dialogue available.\n   */\n  priorDialogue?: AttributedPriorDialogue;\n}\n\n/** Result of a dispatch attempt. */\nexport type AgentDispatchResult =\n  | { handled: true; turn: NegotiationTurn }\n  | { handled: false; reason: 'no_agent' | 'timeout' }\n  | { handled: false; reason: 'waiting'; resumeToken: string };\n\n/**\n * Dispatches a negotiation turn to the appropriate agent.\n * Tries external (poller) agents first, falls back to system agent.\n */\nexport interface AgentDispatcher {\n  /**\n   * Attempt to dispatch a negotiation turn to an external (poller) agent.\n   * @param userId - The user whose agent should handle this turn\n   * @param scope - Permission scope for agent resolution\n   * @param payload - Turn context (users, history, seed assessment)\n   * @param options - Timeout configuration\n   * @returns Handled result with turn, or unhandled result with reason\n   */\n  dispatch(\n    userId: string,\n    scope: { action: string; scopeType: string; scopeId?: string },\n    payload: NegotiationTurnPayload,\n    options: { timeoutMs: number },\n  ): Promise<AgentDispatchResult>;\n\n  /**\n   * Check whether a user has an authorized external (poller) agent for the given\n   * scope. Used at init to determine scenario-based turn caps. Type-only by design\n   * (no heartbeat freshness) — see IND-410.\n   */\n  hasExternalAgent(\n    userId: string,\n    scope: { action: string; scopeType: string; scopeId?: string },\n  ): Promise<boolean>;\n}\n"]}

package/dist/shared/interfaces/agent.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.interface.d.ts","sourceRoot":"/","sources":["shared/interfaces/agent.interface.ts"],"names":[],"mappings":"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"}

package/dist/shared/interfaces/agent.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.interface.js","sourceRoot":"/","sources":["shared/interfaces/agent.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6LH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB,EAAE,sCAAsC;IACxD,UAAU,EAAE,sCAAsC;CAC1C,CAAC","sourcesContent":["/**\n * Database adapter interface for agent registry operations.\n * Implemented by the host application and injected via ProtocolDeps.\n */\n\nexport interface AgentRecord {\n  id: string;\n  ownerId: string;\n  name: string;\n  description: string | null;\n  type: 'personal' | 'external' | 'system';\n  status: 'active' | 'inactive';\n  metadata: Record<string, unknown>;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport interface AgentTransportRecord {\n  id: string;\n  agentId: string;\n  channel: 'mcp';\n  config: Record<string, unknown>;\n  priority: number;\n  active: boolean;\n  failureCount: number;\n}\n\nexport interface AgentPermissionRecord {\n  id: string;\n  agentId: string;\n  userId: string;\n  scope: 'global' | 'node' | 'network';\n  scopeId: string | null;\n  actions: string[];\n  createdAt: Date;\n}\n\nexport interface AgentWithRelations extends AgentRecord {\n  transports: AgentTransportRecord[];\n  permissions: AgentPermissionRecord[];\n}\n\nexport interface CreateAgentInput {\n  ownerId: string;\n  name: string;\n  description?: string;\n  /** Required: personal rows are auto-provisioned negotiators; tool/registration paths create 'external'. */\n  type: 'personal' | 'external' | 'system';\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CreateTransportInput {\n  agentId: string;\n  channel: 'mcp';\n  config?: Record<string, unknown>;\n  priority?: number;\n}\n\nexport interface GrantPermissionInput {\n  agentId: string;\n  userId: string;\n  scope?: 'global' | 'node' | 'network';\n  scopeId?: string;\n  actions: string[];\n}\n\n/**\n * Database adapter interface for agent registry operations.\n *\n * Handles CRUD for agents, their transports, and permission grants.\n * Implemented by the host application (backend) and injected into the\n * protocol layer via constructor injection at the composition root.\n */\nexport interface AgentDatabase {\n  /**\n   * Creates a new agent record.\n   * @param input - Agent creation parameters.\n   * @returns The persisted agent record.\n   */\n  createAgent(input: CreateAgentInput): Promise<AgentRecord>;\n\n  /**\n   * Retrieves an agent by its ID.\n   * @param agentId - The agent UUID.\n   * @returns The agent record, or null if not found.\n   */\n  getAgent(agentId: string): Promise<AgentRecord | null>;\n\n  /**\n   * Retrieves an agent along with its transports and permissions.\n   * @param agentId - The agent UUID.\n   * @returns The agent with relations, or null if not found.\n   */\n  getAgentWithRelations(agentId: string): Promise<AgentWithRelations | null>;\n\n  /**\n   * Updates mutable fields on an agent.\n   * @param agentId - The agent UUID.\n   * @param updates - Partial set of fields to update.\n   * @returns The updated agent record, or null if not found.\n   */\n  updateAgent(\n    agentId: string,\n    updates: Partial<Pick<AgentRecord, 'name' | 'description' | 'status' | 'metadata'>>,\n  ): Promise<AgentRecord | null>;\n\n  /**\n   * Deletes an agent and its associated transports and permissions.\n   * @param agentId - The agent UUID.\n   */\n  deleteAgent(agentId: string): Promise<void>;\n\n  /**\n   * Lists all agents owned by a user, including their relations.\n   * @param userId - The owner's user ID.\n   * @returns Array of agents with transports and permissions.\n   */\n  listAgentsForUser(userId: string): Promise<AgentWithRelations[]>;\n\n  /**\n   * Creates a transport channel for an agent.\n   * @param input - Transport creation parameters.\n   * @returns The persisted transport record.\n   */\n  createTransport(input: CreateTransportInput): Promise<AgentTransportRecord>;\n\n  /**\n   * Deletes a transport channel.\n   * @param transportId - The transport UUID.\n   */\n  deleteTransport(transportId: string): Promise<void>;\n\n  /**\n   * Increments the failure counter for a transport channel.\n   * @param transportId - The transport UUID.\n   */\n  recordTransportFailure(transportId: string): Promise<void>;\n\n  /**\n   * Resets the failure counter for a transport channel after a successful delivery.\n   * @param transportId - The transport UUID.\n   */\n  recordTransportSuccess(transportId: string): Promise<void>;\n\n  /**\n   * Grants a permission to an agent for a given user and scope.\n   * @param input - Permission grant parameters.\n   * @returns The persisted permission record.\n   */\n  grantPermission(input: GrantPermissionInput): Promise<AgentPermissionRecord>;\n\n  /**\n   * Revokes a permission by its ID.\n   * @param permissionId - The permission UUID.\n   */\n  revokePermission(permissionId: string): Promise<void>;\n\n  /**\n   * Checks whether an agent holds a specific permission for a user.\n   * @param agentId - The agent UUID.\n   * @param userId - The user whose permission is being checked.\n   * @param action - The action string to verify (e.g. `\"read\"`, `\"write\"`).\n   * @param scope - Optional scope restriction; defaults to global if omitted.\n   * @returns True if the permission exists, false otherwise.\n   */\n  hasPermission(\n    agentId: string,\n    userId: string,\n    action: string,\n    scope?: { type: 'global' | 'node' | 'network'; id?: string },\n  ): Promise<boolean>;\n\n  /**\n   * Returns all agents authorized for a user and action, optionally within a scope.\n   * @param userId - The user to check authorization for.\n   * @param action - The action string (e.g. `\"read\"`, `\"write\"`).\n   * @param scope - Optional scope restriction.\n   * @returns Array of authorized agents with their relations.\n   */\n  findAuthorizedAgents(\n    userId: string,\n    action: string,\n    scope?: { type: 'global' | 'node' | 'network'; id?: string },\n  ): Promise<AgentWithRelations[]>;\n\n  /**\n   * Returns the well-known IDs for built-in system agents.\n   * @returns Object mapping system agent roles to their fixed UUIDs.\n   */\n  getSystemAgentIds(): { chatOrchestrator: string; negotiator: string };\n}\n\n/**\n * Fixed UUIDs for built-in system agents.\n *\n * These are seeded into the database on first run and must never change,\n * as they are referenced by foreign keys and hard-coded in protocol logic.\n */\nexport const SYSTEM_AGENT_IDS = {\n  chatOrchestrator: '00000000-0000-0000-0000-000000000001',\n  negotiator: '00000000-0000-0000-0000-000000000002',\n} as const;\n"]}

package/dist/shared/interfaces/auth.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.interface.d.ts","sourceRoot":"/","sources":["shared/interfaces/auth.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;QAC5C,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,aAAa,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;KACpC,CAAC,CAAC;IAEH;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD"}

package/dist/shared/interfaces/auth.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.interface.js","sourceRoot":"/","sources":["shared/interfaces/auth.interface.ts"],"names":[],"mappings":"","sourcesContent":["import type { McpAuthInput } from '../schemas/mcp-auth.schema.js';\n\n/**\n * Resolves the authenticated MCP identity from an auth input DTO.\n * The DTO is extracted from the transport at the edge (e.g. from HTTP Request\n * headers) before the protocol layer is called. New auth paths stay free of\n * platform-specific `Request` coupling; `resolveUserId` remains only as a\n * deprecated compatibility bridge while callers migrate to `resolveIdentity`.\n */\nexport interface McpAuthResolver {\n  /**\n   * Extracts and validates the authenticated identity from the auth input.\n   *\n   * @param input - Transport-neutral auth input DTO with credential fields\n   *   extracted at the MCP transport edge.\n   * @returns The authenticated user's UUID, optional agent UUID, auth method,\n   *   `networkScopeId` if the caller's API key is bound to a network-scoped\n   *   agent, and `clientSurface` declaring which kind of UI is rendering the\n   *   MCP response (drives connect-link redirect choice at click time).\n   *\n   *   When `networkScopeId` is set, the MCP server promotes it into the\n   *   canonical `{ scopeType: 'network', scopeId }` envelope. Downstream tools\n   *   derive concrete allowed network IDs from that envelope plus memberships.\n   *\n   *   `isSessionAuth` is true for OAuth/JWT bearer sessions — the agent-\n   *   registration gate in the MCP server is skipped for these callers.\n   *\n   *   `clientSurface` is passed through from the DTO. Only `'telegram'`\n   *   activates the t.me redirect path on `/c/{code}` clicks.\n   *\n   * @throws Error if authentication fails (no token, invalid token, etc.)\n   */\n  resolveIdentity(input: McpAuthInput): Promise<{\n    userId: string;\n    agentId?: string;\n    isSessionAuth?: boolean;\n    networkScopeId?: string | null;\n    clientSurface?: 'telegram' | 'web';\n  }>;\n\n  /**\n   * Deprecated HTTP Request bridge retained for compatibility with older\n   * callers. New transport code must extract `McpAuthInput` at the edge and\n   * call `resolveIdentity` instead.\n   *\n   * @deprecated Use resolveIdentity instead.\n   */\n  resolveUserId(request: Request): Promise<string>;\n}\n"]}

package/dist/shared/interfaces/cache.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.interface.d.ts","sourceRoot":"/","sources":["shared/interfaces/cache.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,KAAK;IACpB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAE/C;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAMD,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAEzE,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC"}