@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (561) hide show
  1. package/CHANGELOG.md +1841 -0
  2. package/IMPLEMENTATION.md +140 -181
  3. package/README.md +16 -20
  4. package/STABILITY.md +16 -11
  5. package/dist/{intents/intent.module.d.ts → capabilities/intents.d.ts} +182 -192
  6. package/dist/capabilities/intents.js +88 -0
  7. package/dist/capabilities/negotiations.d.ts +17 -0
  8. package/dist/capabilities/negotiations.js +16 -0
  9. package/dist/{networks/network.module.d.ts → capabilities/networks.d.ts} +33 -169
  10. package/dist/{networks/network.module.js → capabilities/networks.js} +6 -17
  11. package/dist/index.d.ts +57 -134
  12. package/dist/index.js +41 -105
  13. package/dist/internal/agents/agent.repository.port.d.ts +59 -0
  14. package/dist/internal/agents/agent.repository.port.js +7 -0
  15. package/dist/internal/agents/agent.types.d.ts +35 -0
  16. package/dist/{agents → internal/agents}/agent.types.js +1 -6
  17. package/dist/{intents → internal/intents}/graph/intent.graph.d.ts +142 -151
  18. package/dist/{intents → internal/intents}/graph/intent.graph.execute.d.ts +5 -1
  19. package/dist/{intents → internal/intents}/graph/intent.graph.execute.js +165 -46
  20. package/dist/internal/intents/graph/intent.graph.infer.d.ts +78 -0
  21. package/dist/internal/intents/graph/intent.graph.infer.js +122 -0
  22. package/dist/internal/intents/graph/intent.graph.js +108 -0
  23. package/dist/{intents → internal/intents}/graph/intent.graph.reconcile.d.ts +18 -9
  24. package/dist/internal/intents/graph/intent.graph.reconcile.js +173 -0
  25. package/dist/internal/intents/graph/intent.graph.shared.d.ts +55 -0
  26. package/dist/{intents → internal/intents}/graph/intent.graph.shared.js +25 -70
  27. package/dist/{intents → internal/intents}/graph/intent.graph.state.d.ts +96 -32
  28. package/dist/{intents → internal/intents}/graph/intent.graph.state.js +42 -31
  29. package/dist/internal/intents/intent.admission.d.ts +16 -0
  30. package/dist/internal/intents/intent.admission.js +30 -0
  31. package/dist/{intents → internal/intents}/intent.inferrer.d.ts +1 -40
  32. package/dist/{intents → internal/intents}/intent.inferrer.js +13 -49
  33. package/dist/internal/intents/intent.preparer.d.ts +52 -0
  34. package/dist/internal/intents/intent.preparer.js +87 -0
  35. package/dist/{intents → internal/intents}/intent.verifier.d.ts +3 -36
  36. package/dist/{intents → internal/intents}/intent.verifier.js +0 -17
  37. package/dist/{networks → internal/networks}/indexer.graph.d.ts +15 -200
  38. package/dist/{networks → internal/networks}/indexer.graph.js +19 -128
  39. package/dist/{networks → internal/networks}/indexer.state.d.ts +8 -63
  40. package/dist/internal/networks/indexer.state.js +70 -0
  41. package/dist/{networks → internal/networks}/membership.graph.d.ts +6 -6
  42. package/dist/{networks → internal/networks}/membership.graph.js +3 -3
  43. package/dist/{networks → internal/networks}/membership.state.d.ts +2 -2
  44. package/dist/{networks → internal/networks}/membership.state.js +2 -2
  45. package/dist/{networks → internal/networks}/network.graph.d.ts +9 -22
  46. package/dist/{networks → internal/networks}/network.graph.js +13 -27
  47. package/dist/{networks → internal/networks}/network.recommender.d.ts +2 -2
  48. package/dist/{networks → internal/networks}/network.recommender.js +2 -2
  49. package/dist/{networks → internal/networks}/network.state.d.ts +4 -7
  50. package/dist/{networks → internal/networks}/network.state.js +4 -4
  51. package/dist/internal/opportunities/negotiation-context.loader.d.ts +26 -0
  52. package/dist/internal/opportunities/negotiation-context.loader.js +36 -0
  53. package/dist/{opportunities → internal/opportunities}/opportunity.actor.d.ts +1 -1
  54. package/dist/{opportunities → internal/opportunities}/opportunity.actor.js +7 -1
  55. package/dist/internal/opportunities/opportunity.counterparties.d.ts +17 -0
  56. package/dist/internal/opportunities/opportunity.counterparties.js +19 -0
  57. package/dist/internal/opportunities/opportunity.events.d.ts +38 -0
  58. package/dist/internal/opportunities/opportunity.events.js +94 -0
  59. package/dist/{opportunities → internal/opportunities}/opportunity.feed-selection.d.ts +3 -9
  60. package/dist/internal/opportunities/opportunity.feed-selection.js +40 -0
  61. package/dist/internal/opportunities/opportunity.graph.modes.d.ts +39 -0
  62. package/dist/internal/opportunities/opportunity.graph.modes.js +138 -0
  63. package/dist/{opportunities → internal/opportunities}/opportunity.labels.d.ts +2 -3
  64. package/dist/internal/opportunities/opportunity.labels.js +9 -0
  65. package/dist/{opportunities → internal/opportunities}/opportunity.presentation.d.ts +17 -86
  66. package/dist/{opportunities → internal/opportunities}/opportunity.presentation.js +54 -447
  67. package/dist/{opportunities → internal/opportunities}/opportunity.update-admission.d.ts +2 -2
  68. package/dist/internal/opportunities/opportunity.utils.d.ts +105 -0
  69. package/dist/internal/opportunities/opportunity.utils.js +165 -0
  70. package/dist/{opportunities → internal/opportunities}/radar/radar.graph.d.ts +17 -17
  71. package/dist/{opportunities → internal/opportunities}/radar/radar.graph.js +41 -161
  72. package/dist/{opportunities → internal/opportunities}/radar/radar.state.d.ts +4 -11
  73. package/dist/{shared → internal/shared}/agent/model-signal.d.ts +1 -1
  74. package/dist/{shared → internal/shared}/agent/model-signal.js +1 -1
  75. package/dist/{shared → internal/shared}/agent/model.config.d.ts +28 -86
  76. package/dist/{shared → internal/shared}/agent/model.config.js +58 -69
  77. package/dist/internal/shared/agent/model.resolver.d.ts +33 -0
  78. package/dist/{shared → internal/shared}/agent/model.resolver.js +18 -33
  79. package/dist/internal/shared/agent/scope.d.ts +20 -0
  80. package/dist/internal/shared/agent/scope.js +24 -0
  81. package/dist/internal/shared/assignment/network-assignment.policy.d.ts +23 -0
  82. package/dist/internal/shared/assignment/network-assignment.policy.js +28 -0
  83. package/dist/{shared → internal/shared}/observability/log.d.ts +3 -6
  84. package/dist/{shared → internal/shared}/observability/log.js +9 -18
  85. package/dist/{shared → internal/shared}/observability/protocol.logger.d.ts +1 -1
  86. package/dist/{shared → internal/shared}/observability/protocol.logger.js +1 -1
  87. package/dist/internal/shared/observability/request-context.d.ts +29 -0
  88. package/dist/internal/shared/observability/request-context.js +17 -0
  89. package/dist/{shared → internal/shared}/utils/social-label.d.ts +2 -2
  90. package/dist/{shared → internal/shared}/utils/social-label.js +1 -1
  91. package/dist/platform/database/capabilities.d.ts +59 -0
  92. package/dist/{shared/interfaces/database.entities.d.ts → platform/database/entities.d.ts} +81 -121
  93. package/dist/{shared/interfaces/database.identity-queries.d.ts → platform/database/identity-queries.d.ts} +55 -20
  94. package/dist/platform/database/member-queries.d.ts +55 -0
  95. package/dist/platform/database/member-queries.js +4 -0
  96. package/dist/platform/database/negotiation.d.ts +38 -0
  97. package/dist/{shared/interfaces/database.network-queries.d.ts → platform/database/network-queries.d.ts} +66 -67
  98. package/dist/platform/database/network-queries.js +4 -0
  99. package/dist/{shared/interfaces/database.opportunity-queries.d.ts → platform/database/opportunity-queries.d.ts} +25 -109
  100. package/dist/{shared/interfaces/database.port.d.ts → platform/database/port.d.ts} +52 -117
  101. package/dist/{shared/interfaces/database.port.js → platform/database/port.js} +3 -5
  102. package/dist/platform/database.d.ts +23 -0
  103. package/dist/{shared/interfaces/database.interface.js → platform/database.js} +1 -1
  104. package/dist/{shared/interfaces/cache.interface.d.ts → platform/discovery/cache.d.ts} +2 -4
  105. package/dist/{shared/interfaces/cache.interface.js → platform/discovery/cache.js} +1 -1
  106. package/dist/platform/discovery/embedder.d.ts +31 -0
  107. package/dist/platform/runtime/errors.d.ts +6 -0
  108. package/dist/platform/runtime/errors.js +9 -0
  109. package/dist/platform/runtime/follow-up.d.ts +36 -0
  110. package/dist/platform/runtime/follow-up.js +4 -0
  111. package/dist/platform/runtime/observability.d.ts +34 -0
  112. package/dist/protocol/core.d.ts +11 -0
  113. package/dist/protocol/discovery.rules.d.ts +21 -0
  114. package/dist/protocol/discovery.rules.js +29 -0
  115. package/dist/protocol/negotiation.constants.d.ts +3 -0
  116. package/dist/protocol/negotiation.constants.js +3 -0
  117. package/dist/protocol/negotiation.rules.d.ts +73 -0
  118. package/dist/protocol/negotiation.rules.js +68 -0
  119. package/dist/protocol/protocol.prompt.d.ts +13 -0
  120. package/dist/protocol/protocol.prompt.js +190 -0
  121. package/dist/{shared → protocol}/schemas/discovery-question.schema.d.ts +13 -13
  122. package/dist/{shared → protocol}/schemas/discovery-question.schema.js +2 -2
  123. package/dist/{shared → protocol}/schemas/identity.schema.d.ts +4 -4
  124. package/dist/{shared → protocol}/schemas/identity.schema.js +4 -4
  125. package/dist/{shared → protocol}/schemas/network-assignment.schema.d.ts +11 -20
  126. package/dist/{shared → protocol}/schemas/network-assignment.schema.js +2 -9
  127. package/dist/protocol/schemas/underspecification.schema.d.ts +9 -0
  128. package/dist/protocol/schemas/underspecification.schema.js +12 -0
  129. package/package.json +7 -15
  130. package/dist/agents/agent.dispatcher.port.d.ts +0 -25
  131. package/dist/agents/agent.module.d.ts +0 -19
  132. package/dist/agents/agent.module.js +0 -11
  133. package/dist/agents/agent.repository.port.d.ts +0 -118
  134. package/dist/agents/agent.repository.port.js +0 -10
  135. package/dist/agents/agent.tools.d.ts +0 -16
  136. package/dist/agents/agent.tools.js +0 -351
  137. package/dist/agents/agent.tools.port.d.ts +0 -22
  138. package/dist/agents/agent.tools.port.js +0 -18
  139. package/dist/agents/agent.types.d.ts +0 -76
  140. package/dist/chat/chat-streaming.types.d.ts +0 -618
  141. package/dist/chat/chat-streaming.types.js +0 -297
  142. package/dist/chat/chat.agent.d.ts +0 -292
  143. package/dist/chat/chat.agent.js +0 -1010
  144. package/dist/chat/chat.graph.d.ts +0 -424
  145. package/dist/chat/chat.graph.js +0 -257
  146. package/dist/chat/chat.interrupt.classifier.d.ts +0 -25
  147. package/dist/chat/chat.interrupt.classifier.js +0 -64
  148. package/dist/chat/chat.persona.d.ts +0 -39
  149. package/dist/chat/chat.prompt.d.ts +0 -4
  150. package/dist/chat/chat.prompt.js +0 -12
  151. package/dist/chat/chat.prompt.modules.d.ts +0 -30
  152. package/dist/chat/chat.prompt.modules.js +0 -40
  153. package/dist/chat/chat.question-dedup.d.ts +0 -14
  154. package/dist/chat/chat.question-dedup.js +0 -17
  155. package/dist/chat/chat.state.d.ts +0 -135
  156. package/dist/chat/chat.state.js +0 -120
  157. package/dist/chat/chat.streamer.d.ts +0 -64
  158. package/dist/chat/chat.streamer.js +0 -217
  159. package/dist/chat/chat.suggester.d.ts +0 -23
  160. package/dist/chat/chat.suggester.js +0 -95
  161. package/dist/chat/chat.summarizer.d.ts +0 -20
  162. package/dist/chat/chat.summarizer.js +0 -97
  163. package/dist/chat/chat.title.generator.d.ts +0 -19
  164. package/dist/chat/chat.title.generator.js +0 -66
  165. package/dist/chat/chat.tools.d.ts +0 -5
  166. package/dist/chat/chat.tools.js +0 -62
  167. package/dist/chat/chat.utils.d.ts +0 -41
  168. package/dist/chat/chat.utils.js +0 -88
  169. package/dist/chat/negotiator.persona.d.ts +0 -74
  170. package/dist/chat/negotiator.persona.js +0 -154
  171. package/dist/chat/negotiator.prompt.d.ts +0 -45
  172. package/dist/chat/negotiator.prompt.js +0 -160
  173. package/dist/chat/negotiator.tools.d.ts +0 -42
  174. package/dist/chat/negotiator.tools.js +0 -134
  175. package/dist/chat/onboarding.persona.d.ts +0 -28
  176. package/dist/chat/onboarding.persona.js +0 -86
  177. package/dist/chat/onboarding.prompt.d.ts +0 -6
  178. package/dist/chat/onboarding.prompt.js +0 -63
  179. package/dist/chat/signal.persona.d.ts +0 -47
  180. package/dist/chat/signal.persona.js +0 -319
  181. package/dist/chat/signal.prompt.d.ts +0 -39
  182. package/dist/chat/signal.prompt.js +0 -136
  183. package/dist/contacts/contact.module.d.ts +0 -8
  184. package/dist/contacts/contact.module.js +0 -6
  185. package/dist/contacts/contact.repository.port.d.ts +0 -21
  186. package/dist/contacts/contact.repository.port.js +0 -12
  187. package/dist/contacts/contact.tools.d.ts +0 -17
  188. package/dist/contacts/contact.tools.js +0 -108
  189. package/dist/contacts/contact.tools.port.d.ts +0 -20
  190. package/dist/contacts/contact.tools.port.js +0 -16
  191. package/dist/contacts/contact.types.d.ts +0 -24
  192. package/dist/contacts/contact.types.js +0 -8
  193. package/dist/contexts/context.generator.d.ts +0 -95
  194. package/dist/contexts/context.generator.js +0 -127
  195. package/dist/contexts/context.module.d.ts +0 -13
  196. package/dist/contexts/context.module.js +0 -12
  197. package/dist/contexts/context.tools.port.d.ts +0 -9
  198. package/dist/discovery/hyde.documents.d.ts +0 -9
  199. package/dist/discovery/hyde.documents.js +0 -49
  200. package/dist/discovery/hyde.env.d.ts +0 -8
  201. package/dist/discovery/hyde.env.js +0 -9
  202. package/dist/discovery/hyde.frame.d.ts +0 -150
  203. package/dist/discovery/hyde.frame.js +0 -107
  204. package/dist/discovery/hyde.generator.d.ts +0 -38
  205. package/dist/discovery/hyde.generator.js +0 -103
  206. package/dist/discovery/hyde.graph.d.ts +0 -209
  207. package/dist/discovery/hyde.graph.js +0 -482
  208. package/dist/discovery/hyde.state.d.ts +0 -70
  209. package/dist/discovery/hyde.state.js +0 -85
  210. package/dist/discovery/hyde.strategies.d.ts +0 -17
  211. package/dist/discovery/hyde.strategies.js +0 -34
  212. package/dist/discovery/hyde.validator.d.ts +0 -78
  213. package/dist/discovery/hyde.validator.js +0 -48
  214. package/dist/discovery/index.d.ts +0 -26
  215. package/dist/discovery/index.js +0 -19
  216. package/dist/discovery/lens.inferrer.d.ts +0 -214
  217. package/dist/discovery/lens.inferrer.js +0 -152
  218. package/dist/enrichment/enrichment.generator.d.ts +0 -68
  219. package/dist/enrichment/enrichment.generator.js +0 -95
  220. package/dist/enrichment/enrichment.graph.d.ts +0 -544
  221. package/dist/enrichment/enrichment.graph.js +0 -695
  222. package/dist/enrichment/enrichment.state.d.ts +0 -141
  223. package/dist/enrichment/enrichment.state.js +0 -115
  224. package/dist/enrichment/enrichment.tools.context-read.d.ts +0 -10
  225. package/dist/enrichment/enrichment.tools.context-read.js +0 -353
  226. package/dist/enrichment/enrichment.tools.context-write.d.ts +0 -9
  227. package/dist/enrichment/enrichment.tools.context-write.js +0 -417
  228. package/dist/enrichment/enrichment.tools.d.ts +0 -13
  229. package/dist/enrichment/enrichment.tools.helpers.d.ts +0 -139
  230. package/dist/enrichment/enrichment.tools.helpers.js +0 -234
  231. package/dist/enrichment/enrichment.tools.js +0 -153
  232. package/dist/intents/graph/intent.graph.infer.d.ts +0 -44
  233. package/dist/intents/graph/intent.graph.infer.js +0 -97
  234. package/dist/intents/graph/intent.graph.js +0 -134
  235. package/dist/intents/graph/intent.graph.reconcile.js +0 -274
  236. package/dist/intents/graph/intent.graph.shared.d.ts +0 -68
  237. package/dist/intents/intake/intake.orchestrator.d.ts +0 -203
  238. package/dist/intents/intake/intake.orchestrator.js +0 -255
  239. package/dist/intents/intake/intake.pack.generator.d.ts +0 -57
  240. package/dist/intents/intake/intake.pack.generator.js +0 -90
  241. package/dist/intents/intent.clarifier.d.ts +0 -51
  242. package/dist/intents/intent.clarifier.js +0 -201
  243. package/dist/intents/intent.indexer.d.ts +0 -82
  244. package/dist/intents/intent.indexer.js +0 -170
  245. package/dist/intents/intent.module.js +0 -103
  246. package/dist/intents/intent.proposal.d.ts +0 -37
  247. package/dist/intents/intent.proposal.js +0 -14
  248. package/dist/intents/intent.reconciler.d.ts +0 -105
  249. package/dist/intents/intent.reconciler.js +0 -186
  250. package/dist/intents/intent.tools.d.ts +0 -27
  251. package/dist/intents/intent.tools.js +0 -808
  252. package/dist/maintenance/maintenance.graph.d.ts +0 -239
  253. package/dist/maintenance/maintenance.graph.js +0 -199
  254. package/dist/maintenance/maintenance.state.d.ts +0 -35
  255. package/dist/maintenance/maintenance.state.js +0 -55
  256. package/dist/mcp/elicitation.builder.d.ts +0 -53
  257. package/dist/mcp/elicitation.builder.js +0 -74
  258. package/dist/mcp/elicitation.dispatcher.d.ts +0 -36
  259. package/dist/mcp/elicitation.dispatcher.js +0 -86
  260. package/dist/mcp/mcp.authorization-policy.d.ts +0 -252
  261. package/dist/mcp/mcp.authorization-policy.js +0 -535
  262. package/dist/mcp/mcp.server.d.ts +0 -90
  263. package/dist/mcp/mcp.server.js +0 -631
  264. package/dist/negotiations/insight.generator.d.ts +0 -31
  265. package/dist/negotiations/insight.generator.js +0 -105
  266. package/dist/negotiations/negotiation.agent.d.ts +0 -130
  267. package/dist/negotiations/negotiation.agent.js +0 -396
  268. package/dist/negotiations/negotiation.answer-consumption.d.ts +0 -223
  269. package/dist/negotiations/negotiation.answer-consumption.js +0 -275
  270. package/dist/negotiations/negotiation.attribution.d.ts +0 -91
  271. package/dist/negotiations/negotiation.attribution.js +0 -109
  272. package/dist/negotiations/negotiation.candidates.d.ts +0 -83
  273. package/dist/negotiations/negotiation.candidates.js +0 -162
  274. package/dist/negotiations/negotiation.client-dm.d.ts +0 -50
  275. package/dist/negotiations/negotiation.client-dm.js +0 -66
  276. package/dist/negotiations/negotiation.consultation-policy.d.ts +0 -95
  277. package/dist/negotiations/negotiation.consultation-policy.js +0 -159
  278. package/dist/negotiations/negotiation.deadlock.contracts.d.ts +0 -10
  279. package/dist/negotiations/negotiation.deadlock.d.ts +0 -87
  280. package/dist/negotiations/negotiation.deadlock.js +0 -150
  281. package/dist/negotiations/negotiation.detail-reader.d.ts +0 -94
  282. package/dist/negotiations/negotiation.detail-reader.js +0 -91
  283. package/dist/negotiations/negotiation.expected-speaker.d.ts +0 -33
  284. package/dist/negotiations/negotiation.expected-speaker.js +0 -59
  285. package/dist/negotiations/negotiation.graph.d.ts +0 -694
  286. package/dist/negotiations/negotiation.graph.finalize.d.ts +0 -5
  287. package/dist/negotiations/negotiation.graph.finalize.js +0 -403
  288. package/dist/negotiations/negotiation.graph.init.d.ts +0 -54
  289. package/dist/negotiations/negotiation.graph.init.js +0 -256
  290. package/dist/negotiations/negotiation.graph.js +0 -94
  291. package/dist/negotiations/negotiation.graph.screen.d.ts +0 -23
  292. package/dist/negotiations/negotiation.graph.screen.js +0 -108
  293. package/dist/negotiations/negotiation.graph.shared.d.ts +0 -111
  294. package/dist/negotiations/negotiation.graph.shared.js +0 -168
  295. package/dist/negotiations/negotiation.graph.turn.d.ts +0 -134
  296. package/dist/negotiations/negotiation.graph.turn.js +0 -662
  297. package/dist/negotiations/negotiation.hermes-contract.d.ts +0 -31
  298. package/dist/negotiations/negotiation.hermes-contract.js +0 -72
  299. package/dist/negotiations/negotiation.intent-snapshot-provenance.d.ts +0 -21
  300. package/dist/negotiations/negotiation.intent-snapshot-provenance.js +0 -28
  301. package/dist/negotiations/negotiation.lifecycle-narration.d.ts +0 -18
  302. package/dist/negotiations/negotiation.lifecycle-narration.js +0 -87
  303. package/dist/negotiations/negotiation.memory.d.ts +0 -65
  304. package/dist/negotiations/negotiation.memory.js +0 -83
  305. package/dist/negotiations/negotiation.module.d.ts +0 -36
  306. package/dist/negotiations/negotiation.module.js +0 -23
  307. package/dist/negotiations/negotiation.protocol.d.ts +0 -1018
  308. package/dist/negotiations/negotiation.protocol.js +0 -224
  309. package/dist/negotiations/negotiation.question-safety.d.ts +0 -52
  310. package/dist/negotiations/negotiation.question-safety.js +0 -119
  311. package/dist/negotiations/negotiation.reflect.d.ts +0 -194
  312. package/dist/negotiations/negotiation.reflect.js +0 -145
  313. package/dist/negotiations/negotiation.scope.d.ts +0 -41
  314. package/dist/negotiations/negotiation.scope.js +0 -39
  315. package/dist/negotiations/negotiation.screen.contracts.d.ts +0 -88
  316. package/dist/negotiations/negotiation.screen.contracts.js +0 -58
  317. package/dist/negotiations/negotiation.screen.d.ts +0 -78
  318. package/dist/negotiations/negotiation.screen.js +0 -112
  319. package/dist/negotiations/negotiation.stall-gap.d.ts +0 -83
  320. package/dist/negotiations/negotiation.stall-gap.js +0 -152
  321. package/dist/negotiations/negotiation.stance.contracts.d.ts +0 -123
  322. package/dist/negotiations/negotiation.stance.contracts.js +0 -317
  323. package/dist/negotiations/negotiation.state.d.ts +0 -597
  324. package/dist/negotiations/negotiation.state.js +0 -286
  325. package/dist/negotiations/negotiation.summarizer.d.ts +0 -25
  326. package/dist/negotiations/negotiation.summarizer.js +0 -101
  327. package/dist/negotiations/negotiation.task-lock-policy.d.ts +0 -10
  328. package/dist/negotiations/negotiation.task-lock-policy.js +0 -22
  329. package/dist/negotiations/negotiation.tools.d.ts +0 -18
  330. package/dist/negotiations/negotiation.tools.js +0 -842
  331. package/dist/negotiations/negotiation.tools.port.d.ts +0 -17
  332. package/dist/negotiations/negotiation.turn-cap.d.ts +0 -9
  333. package/dist/negotiations/negotiation.turn-cap.js +0 -12
  334. package/dist/networks/indexer.state.js +0 -112
  335. package/dist/networks/network.tools.d.ts +0 -36
  336. package/dist/networks/network.tools.js +0 -594
  337. package/dist/opportunities/delivery-card.cache.d.ts +0 -25
  338. package/dist/opportunities/delivery-card.cache.js +0 -43
  339. package/dist/opportunities/discovery.env.d.ts +0 -20
  340. package/dist/opportunities/discovery.env.js +0 -109
  341. package/dist/opportunities/discriminator/discriminator.adjustments.d.ts +0 -90
  342. package/dist/opportunities/discriminator/discriminator.adjustments.js +0 -141
  343. package/dist/opportunities/discriminator/discriminator.assigner.d.ts +0 -78
  344. package/dist/opportunities/discriminator/discriminator.assigner.js +0 -153
  345. package/dist/opportunities/discriminator/discriminator.env.d.ts +0 -103
  346. package/dist/opportunities/discriminator/discriminator.env.js +0 -103
  347. package/dist/opportunities/discriminator/discriminator.miner.d.ts +0 -114
  348. package/dist/opportunities/discriminator/discriminator.miner.js +0 -228
  349. package/dist/opportunities/discriminator/discriminator.push.d.ts +0 -13
  350. package/dist/opportunities/discriminator/discriminator.push.js +0 -19
  351. package/dist/opportunities/discriminator/discriminator.question.d.ts +0 -58
  352. package/dist/opportunities/discriminator/discriminator.question.js +0 -155
  353. package/dist/opportunities/discriminator/discriminator.scorer.d.ts +0 -32
  354. package/dist/opportunities/discriminator/discriminator.scorer.js +0 -105
  355. package/dist/opportunities/discriminator/discriminator.shadow.d.ts +0 -32
  356. package/dist/opportunities/discriminator/discriminator.shadow.js +0 -90
  357. package/dist/opportunities/discriminator/discriminator.types.d.ts +0 -93
  358. package/dist/opportunities/discriminator/discriminator.types.js +0 -18
  359. package/dist/opportunities/negotiation-context.loader.d.ts +0 -59
  360. package/dist/opportunities/negotiation-context.loader.js +0 -90
  361. package/dist/opportunities/negotiation-evidence/negotiation-evidence.env.d.ts +0 -43
  362. package/dist/opportunities/negotiation-evidence/negotiation-evidence.env.js +0 -44
  363. package/dist/opportunities/negotiation-evidence/negotiation-evidence.extractor.d.ts +0 -24
  364. package/dist/opportunities/negotiation-evidence/negotiation-evidence.extractor.js +0 -188
  365. package/dist/opportunities/negotiation-evidence/negotiation-evidence.miner.d.ts +0 -26
  366. package/dist/opportunities/negotiation-evidence/negotiation-evidence.miner.js +0 -112
  367. package/dist/opportunities/negotiation-evidence/negotiation-evidence.shadow.d.ts +0 -19
  368. package/dist/opportunities/negotiation-evidence/negotiation-evidence.shadow.js +0 -61
  369. package/dist/opportunities/negotiation-evidence/negotiation-evidence.types.d.ts +0 -191
  370. package/dist/opportunities/negotiation-evidence/negotiation-evidence.types.js +0 -18
  371. package/dist/opportunities/negotiation-evidence/negotiation-evidence.verifier.d.ts +0 -34
  372. package/dist/opportunities/negotiation-evidence/negotiation-evidence.verifier.js +0 -91
  373. package/dist/opportunities/negotiation-summary.builder.d.ts +0 -37
  374. package/dist/opportunities/negotiation-summary.builder.js +0 -66
  375. package/dist/opportunities/opportunity.discovery-negotiation-summary.d.ts +0 -14
  376. package/dist/opportunities/opportunity.discovery-negotiation-summary.js +0 -46
  377. package/dist/opportunities/opportunity.enricher.d.ts +0 -71
  378. package/dist/opportunities/opportunity.enricher.js +0 -280
  379. package/dist/opportunities/opportunity.evaluator.d.ts +0 -289
  380. package/dist/opportunities/opportunity.evaluator.js +0 -516
  381. package/dist/opportunities/opportunity.evidence.d.ts +0 -22
  382. package/dist/opportunities/opportunity.evidence.js +0 -87
  383. package/dist/opportunities/opportunity.existing-negotiation.d.ts +0 -79
  384. package/dist/opportunities/opportunity.existing-negotiation.js +0 -118
  385. package/dist/opportunities/opportunity.feed-selection.js +0 -96
  386. package/dist/opportunities/opportunity.graph.d.ts +0 -1611
  387. package/dist/opportunities/opportunity.graph.discovery-strategies.d.ts +0 -109
  388. package/dist/opportunities/opportunity.graph.discovery-strategies.js +0 -451
  389. package/dist/opportunities/opportunity.graph.discovery.d.ts +0 -69
  390. package/dist/opportunities/opportunity.graph.discovery.js +0 -397
  391. package/dist/opportunities/opportunity.graph.evaluation.d.ts +0 -82
  392. package/dist/opportunities/opportunity.graph.evaluation.js +0 -608
  393. package/dist/opportunities/opportunity.graph.js +0 -193
  394. package/dist/opportunities/opportunity.graph.modes.d.ts +0 -538
  395. package/dist/opportunities/opportunity.graph.modes.js +0 -538
  396. package/dist/opportunities/opportunity.graph.negotiate.d.ts +0 -109
  397. package/dist/opportunities/opportunity.graph.negotiate.js +0 -392
  398. package/dist/opportunities/opportunity.graph.persist-node.d.ts +0 -93
  399. package/dist/opportunities/opportunity.graph.persist-node.js +0 -765
  400. package/dist/opportunities/opportunity.graph.prep.d.ts +0 -150
  401. package/dist/opportunities/opportunity.graph.prep.js +0 -381
  402. package/dist/opportunities/opportunity.graph.shared.d.ts +0 -173
  403. package/dist/opportunities/opportunity.graph.shared.js +0 -199
  404. package/dist/opportunities/opportunity.introducer-feature.d.ts +0 -2
  405. package/dist/opportunities/opportunity.introducer-feature.js +0 -4
  406. package/dist/opportunities/opportunity.introducer.d.ts +0 -77
  407. package/dist/opportunities/opportunity.introducer.js +0 -99
  408. package/dist/opportunities/opportunity.labels.js +0 -10
  409. package/dist/opportunities/opportunity.lifecycle.d.ts +0 -63
  410. package/dist/opportunities/opportunity.lifecycle.js +0 -181
  411. package/dist/opportunities/opportunity.module.d.ts +0 -54
  412. package/dist/opportunities/opportunity.module.js +0 -39
  413. package/dist/opportunities/opportunity.newborn-stamping.d.ts +0 -41
  414. package/dist/opportunities/opportunity.newborn-stamping.js +0 -81
  415. package/dist/opportunities/opportunity.owner-approval.d.ts +0 -118
  416. package/dist/opportunities/opportunity.owner-approval.js +0 -34
  417. package/dist/opportunities/opportunity.owner-provenance.d.ts +0 -6
  418. package/dist/opportunities/opportunity.owner-provenance.js +0 -28
  419. package/dist/opportunities/opportunity.persist.d.ts +0 -58
  420. package/dist/opportunities/opportunity.persist.js +0 -145
  421. package/dist/opportunities/opportunity.persistence-admission.d.ts +0 -39
  422. package/dist/opportunities/opportunity.persistence-admission.js +0 -59
  423. package/dist/opportunities/opportunity.state.d.ts +0 -451
  424. package/dist/opportunities/opportunity.state.js +0 -256
  425. package/dist/opportunities/opportunity.tools.cards.d.ts +0 -138
  426. package/dist/opportunities/opportunity.tools.cards.js +0 -212
  427. package/dist/opportunities/opportunity.tools.d.ts +0 -12
  428. package/dist/opportunities/opportunity.tools.js +0 -236
  429. package/dist/opportunities/opportunity.tools.list.d.ts +0 -10
  430. package/dist/opportunities/opportunity.tools.list.js +0 -489
  431. package/dist/opportunities/opportunity.tools.port.d.ts +0 -16
  432. package/dist/opportunities/opportunity.utils.d.ts +0 -217
  433. package/dist/opportunities/opportunity.utils.js +0 -395
  434. package/dist/opportunities/outcome/outcome.env.d.ts +0 -60
  435. package/dist/opportunities/outcome/outcome.env.js +0 -63
  436. package/dist/opportunities/outcome/outcome.hypotheses.d.ts +0 -29
  437. package/dist/opportunities/outcome/outcome.hypotheses.js +0 -117
  438. package/dist/opportunities/outcome/outcome.shadow.d.ts +0 -56
  439. package/dist/opportunities/outcome/outcome.shadow.js +0 -87
  440. package/dist/opportunities/outcome/outcome.types.d.ts +0 -110
  441. package/dist/opportunities/outcome/outcome.types.js +0 -26
  442. package/dist/opportunities/radar/radar.health.d.ts +0 -31
  443. package/dist/opportunities/radar/radar.health.js +0 -75
  444. package/dist/premises/premise.analyzer.d.ts +0 -35
  445. package/dist/premises/premise.analyzer.js +0 -115
  446. package/dist/premises/premise.decomposer.d.ts +0 -69
  447. package/dist/premises/premise.decomposer.js +0 -213
  448. package/dist/premises/premise.graph.d.ts +0 -345
  449. package/dist/premises/premise.graph.js +0 -278
  450. package/dist/premises/premise.indexer.d.ts +0 -35
  451. package/dist/premises/premise.indexer.js +0 -86
  452. package/dist/premises/premise.state.d.ts +0 -67
  453. package/dist/premises/premise.state.js +0 -94
  454. package/dist/premises/premise.tools.d.ts +0 -3
  455. package/dist/premises/premise.tools.js +0 -248
  456. package/dist/questions/question.env.d.ts +0 -27
  457. package/dist/questions/question.env.js +0 -27
  458. package/dist/questions/question.input.d.ts +0 -107
  459. package/dist/questions/question.module.d.ts +0 -30
  460. package/dist/questions/question.module.js +0 -28
  461. package/dist/questions/question.schema.d.ts +0 -1529
  462. package/dist/questions/question.schema.js +0 -420
  463. package/dist/shared/agent/activity-projection.d.ts +0 -271
  464. package/dist/shared/agent/activity-projection.js +0 -254
  465. package/dist/shared/agent/canonical-guidance.d.ts +0 -30
  466. package/dist/shared/agent/canonical-guidance.js +0 -246
  467. package/dist/shared/agent/model.resolver.d.ts +0 -48
  468. package/dist/shared/agent/tool.factory.d.ts +0 -17
  469. package/dist/shared/agent/tool.factory.js +0 -221
  470. package/dist/shared/agent/tool.helpers.d.ts +0 -482
  471. package/dist/shared/agent/tool.helpers.js +0 -232
  472. package/dist/shared/agent/tool.registry.d.ts +0 -25
  473. package/dist/shared/agent/tool.registry.js +0 -76
  474. package/dist/shared/agent/tool.runtime.d.ts +0 -28
  475. package/dist/shared/agent/tool.runtime.js +0 -194
  476. package/dist/shared/agent/tool.scope.d.ts +0 -44
  477. package/dist/shared/agent/tool.scope.js +0 -50
  478. package/dist/shared/agent/utility.tools.d.ts +0 -15
  479. package/dist/shared/agent/utility.tools.js +0 -322
  480. package/dist/shared/assignment/network-assignment.policy.d.ts +0 -61
  481. package/dist/shared/assignment/network-assignment.policy.js +0 -105
  482. package/dist/shared/interfaces/agent-dispatcher.interface.d.ts +0 -100
  483. package/dist/shared/interfaces/agent-dispatcher.interface.js +0 -12
  484. package/dist/shared/interfaces/auth.interface.d.ts +0 -37
  485. package/dist/shared/interfaces/auth.interface.js +0 -1
  486. package/dist/shared/interfaces/chat-message-writer.interface.d.ts +0 -18
  487. package/dist/shared/interfaces/chat-message-writer.interface.js +0 -1
  488. package/dist/shared/interfaces/chat-session.interface.d.ts +0 -23
  489. package/dist/shared/interfaces/chat-session.interface.js +0 -18
  490. package/dist/shared/interfaces/chat-summary.interface.d.ts +0 -16
  491. package/dist/shared/interfaces/chat-summary.interface.js +0 -1
  492. package/dist/shared/interfaces/database.capabilities.d.ts +0 -100
  493. package/dist/shared/interfaces/database.interface.d.ts +0 -16
  494. package/dist/shared/interfaces/database.member-queries.d.ts +0 -219
  495. package/dist/shared/interfaces/database.member-queries.js +0 -4
  496. package/dist/shared/interfaces/database.negotiation.d.ts +0 -329
  497. package/dist/shared/interfaces/database.negotiation.js +0 -26
  498. package/dist/shared/interfaces/database.network-queries.js +0 -4
  499. package/dist/shared/interfaces/database.opportunity-queries.js +0 -4
  500. package/dist/shared/interfaces/delivery-ledger.interface.d.ts +0 -40
  501. package/dist/shared/interfaces/delivery-ledger.interface.js +0 -5
  502. package/dist/shared/interfaces/embedder.interface.d.ts +0 -92
  503. package/dist/shared/interfaces/embedder.interface.js +0 -4
  504. package/dist/shared/interfaces/enrichment-run.interface.d.ts +0 -62
  505. package/dist/shared/interfaces/enrichment-run.interface.js +0 -1
  506. package/dist/shared/interfaces/enrichment.interface.js +0 -1
  507. package/dist/shared/interfaces/negotiation-events.interface.d.ts +0 -77
  508. package/dist/shared/interfaces/negotiation-events.interface.js +0 -6
  509. package/dist/shared/interfaces/negotiation-summary.interface.d.ts +0 -25
  510. package/dist/shared/interfaces/negotiation-summary.interface.js +0 -1
  511. package/dist/shared/interfaces/negotiator-memory.interface.d.ts +0 -58
  512. package/dist/shared/interfaces/negotiator-memory.interface.js +0 -11
  513. package/dist/shared/interfaces/queue.interface.d.ts +0 -23
  514. package/dist/shared/interfaces/queue.interface.js +0 -4
  515. package/dist/shared/interfaces/scraper.interface.js +0 -1
  516. package/dist/shared/interfaces/tool-request-context.interface.d.ts +0 -11
  517. package/dist/shared/interfaces/tool-request-context.interface.js +0 -1
  518. package/dist/shared/observability/request-context.d.ts +0 -27
  519. package/dist/shared/observability/request-context.js +0 -6
  520. package/dist/shared/schemas/mcp-auth.schema.d.ts +0 -87
  521. package/dist/shared/schemas/mcp-auth.schema.js +0 -56
  522. package/dist/shared/schemas/negotiation-digest.schema.d.ts +0 -58
  523. package/dist/shared/schemas/negotiation-digest.schema.js +0 -38
  524. package/dist/shared/schemas/negotiation-state.schema.d.ts +0 -343
  525. package/dist/shared/schemas/negotiation-state.schema.js +0 -81
  526. package/dist/shared/schemas/question-block.fixture.d.ts +0 -12
  527. package/dist/shared/schemas/question-block.fixture.js +0 -39
  528. package/dist/shared/schemas/question-block.schema.d.ts +0 -111
  529. package/dist/shared/schemas/question-block.schema.js +0 -124
  530. package/dist/shared/schemas/structured-question.schema.d.ts +0 -66
  531. package/dist/shared/schemas/structured-question.schema.js +0 -31
  532. package/dist/shared/schemas/underspecification.schema.d.ts +0 -13
  533. package/dist/shared/schemas/underspecification.schema.js +0 -16
  534. /package/dist/{opportunities → internal/opportunities}/opportunity.update-admission.js +0 -0
  535. /package/dist/{opportunities → internal/opportunities}/radar/radar.state.js +0 -0
  536. /package/dist/{shared → internal/shared}/network/metadata.renderer.d.ts +0 -0
  537. /package/dist/{shared → internal/shared}/network/metadata.renderer.js +0 -0
  538. /package/dist/{shared → internal/shared}/observability/debug-meta.sanitizer.d.ts +0 -0
  539. /package/dist/{shared → internal/shared}/observability/debug-meta.sanitizer.js +0 -0
  540. /package/dist/{shared → internal/shared}/observability/performance.d.ts +0 -0
  541. /package/dist/{shared → internal/shared}/observability/performance.js +0 -0
  542. /package/dist/{shared → internal/shared}/observability/trace.d.ts +0 -0
  543. /package/dist/{shared → internal/shared}/observability/trace.js +0 -0
  544. /package/dist/{shared → internal/shared}/utils/claim-safety.d.ts +0 -0
  545. /package/dist/{shared → internal/shared}/utils/claim-safety.js +0 -0
  546. /package/dist/{shared → internal/shared}/utils/telegram-handle.d.ts +0 -0
  547. /package/dist/{shared → internal/shared}/utils/telegram-handle.js +0 -0
  548. /package/dist/{shared/interfaces/database.capabilities.js → platform/database/capabilities.js} +0 -0
  549. /package/dist/{shared/interfaces/database.entities.js → platform/database/entities.js} +0 -0
  550. /package/dist/{shared/interfaces/database.identity-queries.js → platform/database/identity-queries.js} +0 -0
  551. /package/dist/{agents/agent.dispatcher.port.js → platform/database/negotiation.js} +0 -0
  552. /package/dist/{chat/chat.persona.js → platform/database/opportunity-queries.js} +0 -0
  553. /package/dist/{contexts/context.tools.port.js → platform/discovery/embedder.js} +0 -0
  554. /package/dist/{shared/interfaces/scraper.interface.d.ts → platform/discovery/scraper.d.ts} +0 -0
  555. /package/dist/{negotiations/negotiation.deadlock.contracts.js → platform/discovery/scraper.js} +0 -0
  556. /package/dist/{shared/interfaces/enrichment.interface.d.ts → platform/enrichment/ports.d.ts} +0 -0
  557. /package/dist/{negotiations/negotiation.tools.port.js → platform/enrichment/ports.js} +0 -0
  558. /package/dist/{opportunities/opportunity.tools.port.js → platform/runtime/observability.js} +0 -0
  559. /package/dist/{questions/question.input.js → protocol/core.js} +0 -0
  560. /package/dist/{shared → protocol}/schemas/chat-context.schema.d.ts +0 -0
  561. /package/dist/{shared → protocol}/schemas/chat-context.schema.js +0 -0
@@ -1,34 +0,0 @@
1
- /**
2
- * HyDE (Hypothetical Document Embeddings) type definitions.
3
- *
4
- * The system is now role-agnostic: instead of hardcoded strategy names
5
- * (mirror, reciprocal, mentor, investor, collaborator, hiree), an LLM
6
- * infers free-text "lenses" dynamically. This file re-exports the lens
7
- * types and provides constants for the HyDE pipeline.
8
- */
9
- /** Default cache TTL for ephemeral HyDE documents (1 hour). */
10
- export const HYDE_DEFAULT_CACHE_TTL = 3600;
11
- /**
12
- * Prompt templates for HyDE document generation.
13
- * Keyed by target corpus — the lens label provides the semantic specificity.
14
- */
15
- export const HYDE_CORPUS_PROMPTS = {
16
- profiles: (sourceText, lens) => `
17
- Write a professional biography for someone who could fulfill this need: "${sourceText}".
18
- Focus on the specific expertise, background, and role described by: ${lens}.
19
-
20
- Write in first person. Include concrete skills, domain experience, and current professional focus that would make them a strong match.
21
- `,
22
- intents: (sourceText, lens) => `
23
- Write a goal or aspiration statement for someone who is: ${lens}.
24
- This person's needs would complement: "${sourceText}".
25
-
26
- Write in first person as if stating their own goal.
27
- `,
28
- premises: (sourceText, lens) => `
29
- Write a short self-description for someone whose identity, values, or worldview aligns with: "${sourceText}".
30
- Reflect the character described by: ${lens}.
31
-
32
- Write in first person as a stable statement of who this person is, not what they want.
33
- `,
34
- };
@@ -1,78 +0,0 @@
1
- import type { BaseLanguageModelInput } from '@langchain/core/language_models/base';
2
- import { z } from 'zod';
3
- import type { HydeSourceFrame } from './hyde.frame.js';
4
- import type { HydeTargetCorpus } from './lens.inferrer.js';
5
- export interface HydeValidationDocument {
6
- corpus: HydeTargetCorpus;
7
- text: string;
8
- }
9
- export interface HydeValidationInput {
10
- sourceText: string;
11
- sourceFrame: HydeSourceFrame;
12
- /** Generated documents keyed by opaque caller-supplied identifiers. */
13
- documents: Record<string, HydeValidationDocument>;
14
- }
15
- export interface HydeValidationVerdict {
16
- key: string;
17
- valid: boolean;
18
- unsupportedNamedEntities: string[];
19
- unsupportedHardConstraints: string[];
20
- reasoning: string;
21
- }
22
- export interface HydeValidationOutput {
23
- verdicts: HydeValidationVerdict[];
24
- }
25
- /** Structured-output schema for a single batch validation response. */
26
- export declare const HydeValidationResponseSchema: z.ZodObject<{
27
- verdicts: z.ZodArray<z.ZodObject<{
28
- key: z.ZodString;
29
- valid: z.ZodBoolean;
30
- unsupportedNamedEntities: z.ZodArray<z.ZodString, "many">;
31
- unsupportedHardConstraints: z.ZodArray<z.ZodString, "many">;
32
- reasoning: z.ZodString;
33
- }, "strip", z.ZodTypeAny, {
34
- reasoning: string;
35
- valid: boolean;
36
- key: string;
37
- unsupportedNamedEntities: string[];
38
- unsupportedHardConstraints: string[];
39
- }, {
40
- reasoning: string;
41
- valid: boolean;
42
- key: string;
43
- unsupportedNamedEntities: string[];
44
- unsupportedHardConstraints: string[];
45
- }>, "many">;
46
- }, "strip", z.ZodTypeAny, {
47
- verdicts: {
48
- reasoning: string;
49
- valid: boolean;
50
- key: string;
51
- unsupportedNamedEntities: string[];
52
- unsupportedHardConstraints: string[];
53
- }[];
54
- }, {
55
- verdicts: {
56
- reasoning: string;
57
- valid: boolean;
58
- key: string;
59
- unsupportedNamedEntities: string[];
60
- unsupportedHardConstraints: string[];
61
- }[];
62
- }>;
63
- /** Build a profile-free batch validation prompt. */
64
- export declare function buildHydeValidationPrompt(input: HydeValidationInput): string;
65
- /** Minimal structured model contract used for deterministic injection in tests. */
66
- export interface HydeValidatorStructuredModel {
67
- invoke(input: BaseLanguageModelInput, config?: {
68
- signal?: AbortSignal;
69
- }): Promise<unknown>;
70
- }
71
- /** Production structured-model batch validator for frame-v1 HyDE documents. */
72
- export declare class HydeValidator {
73
- private model?;
74
- constructor(model?: HydeValidatorStructuredModel);
75
- private getModel;
76
- /** Validate all generated documents in one structured-model call. */
77
- validate(input: HydeValidationInput): Promise<HydeValidationOutput>;
78
- }
@@ -1,48 +0,0 @@
1
- import { HumanMessage, SystemMessage } from '@langchain/core/messages';
2
- import { z } from 'zod';
3
- import { createStructuredModel } from '../shared/agent/model.config.js';
4
- import { invokeWithAbortSignal } from '../shared/agent/model-signal.js';
5
- /** Structured-output schema for a single batch validation response. */
6
- export const HydeValidationResponseSchema = z.object({
7
- verdicts: z.array(z.object({
8
- key: z.string().min(1),
9
- valid: z.boolean(),
10
- unsupportedNamedEntities: z.array(z.string()),
11
- unsupportedHardConstraints: z.array(z.string()),
12
- reasoning: z.string().min(1).describe('Concise explanation of the verdict'),
13
- })),
14
- });
15
- const VALIDATOR_SYSTEM_PROMPT = `You validate hypothetical retrieval documents against a sanitized source-grounded frame.
16
-
17
- A document is invalid only when it invents unsupported proper nouns/named entities or unsupported HARD constraints (location, time, numeric, credential, organization, or exclusivity constraints).
18
-
19
- Explicitly allowed and not grounds for rejection:
20
- - first-person target voice;
21
- - generic role or domain elaboration;
22
- - reciprocal or complementary inversion of source and target roles.
23
-
24
- Return exactly one verdict for each opaque key. Copy each key exactly. Mark valid=false when either unsupported list is non-empty. Keep reasoning concise.`;
25
- /** Build a profile-free batch validation prompt. */
26
- export function buildHydeValidationPrompt(input) {
27
- return `Source text:\n${input.sourceText}\n\nSanitized source frame:\n${JSON.stringify(input.sourceFrame)}\n\nGenerated documents:\n${JSON.stringify(input.documents)}`;
28
- }
29
- /** Production structured-model batch validator for frame-v1 HyDE documents. */
30
- export class HydeValidator {
31
- constructor(model) {
32
- this.model = model;
33
- }
34
- getModel() {
35
- this.model ?? (this.model = createStructuredModel('hydeValidator', HydeValidationResponseSchema, {
36
- name: 'hyde_validator',
37
- }));
38
- return this.model;
39
- }
40
- /** Validate all generated documents in one structured-model call. */
41
- async validate(input) {
42
- const result = await invokeWithAbortSignal(this.getModel(), [
43
- new SystemMessage(VALIDATOR_SYSTEM_PROMPT),
44
- new HumanMessage(buildHydeValidationPrompt(input)),
45
- ]);
46
- return HydeValidationResponseSchema.parse(result);
47
- }
48
- }
@@ -1,26 +0,0 @@
1
- /**
2
- * discovery — the capability's sole cross-capability surface.
3
- *
4
- * HyDE (Hypothetical Document Embeddings) is discovery machinery, not shared
5
- * infrastructure: it owns a graph, a generator, a lens inferrer, and a
6
- * validator. It lived under shared/ because two capabilities needed it, which
7
- * made shared/ the default home for anything with more than one consumer.
8
- *
9
- * Anything outside this capability imports from here and nowhere else.
10
- */
11
- export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration, } from "./hyde.documents.js";
12
- export { HYDE_FRAME_GENERATION_VERSION, getHydeGenerationMode, } from "./hyde.env.js";
13
- export type { HydeGenerationMode, } from "./hyde.env.js";
14
- export { HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, HydeSourceFrameSchema, } from "./hyde.frame.js";
15
- export type { HydeFrameHardConstraint, HydeFrameNamedEntity, HydeFrameRole, HydeFrameVocabulary, HydeSourceFrame, } from "./hyde.frame.js";
16
- export { HydeGenerator, } from "./hyde.generator.js";
17
- export type { HydeGenerateInput, HydeGeneratorOutput, } from "./hyde.generator.js";
18
- export { HydeGraphFactory, } from "./hyde.graph.js";
19
- export type { HydeGeneratorLike, HydeGraphOptions, HydeLensInferrerLike, HydeValidatorLike, } from "./hyde.graph.js";
20
- export { HydeGraphState, } from "./hyde.state.js";
21
- export type { HydeDocumentOrigin, HydeDocumentState, HydeValidationStatus, } from "./hyde.state.js";
22
- export { HYDE_CORPUS_PROMPTS, HYDE_DEFAULT_CACHE_TTL, } from "./hyde.strategies.js";
23
- export { HydeValidationResponseSchema, HydeValidator, buildHydeValidationPrompt, } from "./hyde.validator.js";
24
- export type { HydeValidationDocument, HydeValidationInput, HydeValidationOutput, HydeValidationVerdict, } from "./hyde.validator.js";
25
- export { FRAME_SYSTEM_PROMPT, FrameResponseSchema, LensInferrer, } from "./lens.inferrer.js";
26
- export type { HydeTargetCorpus, Lens, LensInferenceInput, LensInferenceOutput, } from "./lens.inferrer.js";
@@ -1,19 +0,0 @@
1
- /**
2
- * discovery — the capability's sole cross-capability surface.
3
- *
4
- * HyDE (Hypothetical Document Embeddings) is discovery machinery, not shared
5
- * infrastructure: it owns a graph, a generator, a lens inferrer, and a
6
- * validator. It lived under shared/ because two capabilities needed it, which
7
- * made shared/ the default home for anything with more than one consumer.
8
- *
9
- * Anything outside this capability imports from here and nowhere else.
10
- */
11
- export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration, } from "./hyde.documents.js";
12
- export { HYDE_FRAME_GENERATION_VERSION, getHydeGenerationMode, } from "./hyde.env.js";
13
- export { HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, HydeSourceFrameSchema, } from "./hyde.frame.js";
14
- export { HydeGenerator, } from "./hyde.generator.js";
15
- export { HydeGraphFactory, } from "./hyde.graph.js";
16
- export { HydeGraphState, } from "./hyde.state.js";
17
- export { HYDE_CORPUS_PROMPTS, HYDE_DEFAULT_CACHE_TTL, } from "./hyde.strategies.js";
18
- export { HydeValidationResponseSchema, HydeValidator, buildHydeValidationPrompt, } from "./hyde.validator.js";
19
- export { FRAME_SYSTEM_PROMPT, FrameResponseSchema, LensInferrer, } from "./lens.inferrer.js";
@@ -1,214 +0,0 @@
1
- /**
2
- * Lens Inferrer Agent: analyzes source text (intent or query) with optional
3
- * profile context and infers 1-N search lenses, each tagged with a target corpus.
4
- * Replaces the hardcoded HydeStrategy enum and regex-based selectStrategiesFromQuery.
5
- */
6
- import type { BaseLanguageModelInput } from '@langchain/core/language_models/base';
7
- import { z } from 'zod';
8
- import { type HydeSourceFrame } from './hyde.frame.js';
9
- export type HydeTargetCorpus = 'profiles' | 'intents' | 'premises';
10
- /** A single inferred lens — a search perspective the LLM decided is relevant. */
11
- export interface Lens {
12
- /** Free-text description (e.g. "crypto infrastructure VC"). */
13
- label: string;
14
- /** Which vector index to search: user profiles or user intents. */
15
- corpus: HydeTargetCorpus;
16
- /** Why this perspective is relevant (for logging/trace). */
17
- reasoning: string;
18
- }
19
- export interface LensInferenceInput {
20
- /** Intent payload or search query. */
21
- sourceText: string;
22
- /** User's profile summary for domain context (optional). */
23
- profileContext?: string;
24
- /** Maximum number of lenses to infer (default 3). */
25
- maxLenses?: number;
26
- /** Use the source-grounded frame-v1 inference path. */
27
- frameConstrained?: boolean;
28
- }
29
- export interface LensInferenceOutput {
30
- lenses: Lens[];
31
- /** Sanitized source frame, present only for frame-constrained inference. */
32
- sourceFrame?: HydeSourceFrame;
33
- }
34
- /** Source-grounded system prompt used only by frame extraction. */
35
- export declare 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.";
36
- /** Structured-output schema used only by source-frame extraction. */
37
- export declare const FrameResponseSchema: z.ZodObject<{
38
- sourceFrame: z.ZodObject<{
39
- sourceRoles: z.ZodArray<z.ZodObject<{
40
- role: z.ZodString;
41
- evidence: z.ZodString;
42
- }, "strip", z.ZodTypeAny, {
43
- role: string;
44
- evidence: string;
45
- }, {
46
- role: string;
47
- evidence: string;
48
- }>, "many">;
49
- counterpartRoles: z.ZodArray<z.ZodObject<{
50
- role: z.ZodString;
51
- evidence: z.ZodString;
52
- }, "strip", z.ZodTypeAny, {
53
- role: string;
54
- evidence: string;
55
- }, {
56
- role: string;
57
- evidence: string;
58
- }>, "many">;
59
- hardConstraints: z.ZodArray<z.ZodObject<{
60
- type: z.ZodEnum<["location", "time", "numeric", "credential", "organization", "exclusivity", "other"]>;
61
- value: z.ZodString;
62
- evidence: z.ZodString;
63
- }, "strip", z.ZodTypeAny, {
64
- value: string;
65
- type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
66
- evidence: string;
67
- }, {
68
- value: string;
69
- type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
70
- evidence: string;
71
- }>, "many">;
72
- namedEntities: z.ZodArray<z.ZodObject<{
73
- type: z.ZodEnum<["person", "organization", "product", "location", "event", "other"]>;
74
- name: z.ZodString;
75
- evidence: z.ZodString;
76
- }, "strip", z.ZodTypeAny, {
77
- name: string;
78
- type: "location" | "event" | "organization" | "other" | "person" | "product";
79
- evidence: string;
80
- }, {
81
- name: string;
82
- type: "location" | "event" | "organization" | "other" | "person" | "product";
83
- evidence: string;
84
- }>, "many">;
85
- domainVocabulary: z.ZodArray<z.ZodObject<{
86
- term: z.ZodString;
87
- evidence: z.ZodString;
88
- }, "strip", z.ZodTypeAny, {
89
- evidence: string;
90
- term: string;
91
- }, {
92
- evidence: string;
93
- term: string;
94
- }>, "many">;
95
- }, "strip", z.ZodTypeAny, {
96
- sourceRoles: {
97
- role: string;
98
- evidence: string;
99
- }[];
100
- counterpartRoles: {
101
- role: string;
102
- evidence: string;
103
- }[];
104
- hardConstraints: {
105
- value: string;
106
- type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
107
- evidence: string;
108
- }[];
109
- namedEntities: {
110
- name: string;
111
- type: "location" | "event" | "organization" | "other" | "person" | "product";
112
- evidence: string;
113
- }[];
114
- domainVocabulary: {
115
- evidence: string;
116
- term: string;
117
- }[];
118
- }, {
119
- sourceRoles: {
120
- role: string;
121
- evidence: string;
122
- }[];
123
- counterpartRoles: {
124
- role: string;
125
- evidence: string;
126
- }[];
127
- hardConstraints: {
128
- value: string;
129
- type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
130
- evidence: string;
131
- }[];
132
- namedEntities: {
133
- name: string;
134
- type: "location" | "event" | "organization" | "other" | "person" | "product";
135
- evidence: string;
136
- }[];
137
- domainVocabulary: {
138
- evidence: string;
139
- term: string;
140
- }[];
141
- }>;
142
- }, "strip", z.ZodTypeAny, {
143
- sourceFrame: {
144
- sourceRoles: {
145
- role: string;
146
- evidence: string;
147
- }[];
148
- counterpartRoles: {
149
- role: string;
150
- evidence: string;
151
- }[];
152
- hardConstraints: {
153
- value: string;
154
- type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
155
- evidence: string;
156
- }[];
157
- namedEntities: {
158
- name: string;
159
- type: "location" | "event" | "organization" | "other" | "person" | "product";
160
- evidence: string;
161
- }[];
162
- domainVocabulary: {
163
- evidence: string;
164
- term: string;
165
- }[];
166
- };
167
- }, {
168
- sourceFrame: {
169
- sourceRoles: {
170
- role: string;
171
- evidence: string;
172
- }[];
173
- counterpartRoles: {
174
- role: string;
175
- evidence: string;
176
- }[];
177
- hardConstraints: {
178
- value: string;
179
- type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
180
- evidence: string;
181
- }[];
182
- namedEntities: {
183
- name: string;
184
- type: "location" | "event" | "organization" | "other" | "person" | "product";
185
- evidence: string;
186
- }[];
187
- domainVocabulary: {
188
- evidence: string;
189
- term: string;
190
- }[];
191
- };
192
- }>;
193
- type ModelInput = BaseLanguageModelInput;
194
- /** Minimal structured model contract used for deterministic injection in tests. */
195
- export interface LensStructuredModel {
196
- invoke(input: ModelInput, config?: {
197
- signal?: AbortSignal;
198
- }): Promise<unknown>;
199
- }
200
- export interface LensInferrerOptions {
201
- legacyModel?: LensStructuredModel;
202
- frameModel?: LensStructuredModel;
203
- }
204
- /** Infers search lenses from source text and optional profile context. */
205
- export declare class LensInferrer {
206
- private legacyModel?;
207
- private frameModel?;
208
- constructor(options?: LensInferrerOptions);
209
- private getLegacyModel;
210
- private getFrameModel;
211
- /** Infer search lenses while preserving the legacy path unless explicitly enabled. */
212
- infer(input: LensInferenceInput): Promise<LensInferenceOutput>;
213
- }
214
- export {};
@@ -1,152 +0,0 @@
1
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
6
- };
7
- var __metadata = (this && this.__metadata) || function (k, v) {
8
- if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
- };
10
- import { HumanMessage, SystemMessage } from '@langchain/core/messages';
11
- import { z } from 'zod';
12
- import { createStructuredModel } from "../shared/agent/model.config.js";
13
- import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
14
- import { protocolLogger } from '../shared/observability/protocol.logger.js';
15
- import { Timed } from "../shared/observability/performance.js";
16
- import { HydeSourceFrameSchema, sanitizeHydeSourceFrame } from './hyde.frame.js';
17
- const SYSTEM_PROMPT = `You analyze goals and search queries to identify the most relevant perspectives for finding matching people in a professional network.
18
-
19
- For each perspective you identify, specify:
20
- 1. A clear, specific description of who or what to search for
21
- 2. Whether to search "profiles" (user bios, expertise, backgrounds), "intents" (stated goals, needs, aspirations), or "premises" (identity assertions, values, worldview)
22
- 3. A brief reason why this perspective is relevant
23
-
24
- Guidelines:
25
- - Be specific and domain-aware. "early-stage crypto infrastructure investor" is better than "investor".
26
- - Consider both sides: who can help the person AND whose goals complement theirs.
27
- - When user context is provided, tailor perspectives to their domain (e.g. a DePIN founder searching for "investors" needs crypto-native infra investors specifically).
28
- - Generate only perspectives that add distinct search value — don't repeat similar angles.
29
- - 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.
30
- - 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.
31
- - 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.`;
32
- /** Source-grounded system prompt used only by frame extraction. */
33
- export const FRAME_SYSTEM_PROMPT = `You extract a source-grounded frame for semantic retrieval from sourceText alone.
34
-
35
- Source-frame rules:
36
- - Extract evidence ONLY from sourceText.
37
- - Every frame element must include an evidence field copied as an exact substring of sourceText.
38
- - sourceRoles describe roles held or offered by the source side.
39
- - 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.
40
- - 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.
41
- - hardConstraints contain only explicit constraints and classify each as location, time, numeric, credential, organization, exclusivity, or other.
42
- - namedEntities contain only proper names explicitly present in sourceText and classify each as person, organization, product, location, event, or other.
43
- - domainVocabulary contains source domain terms worth preserving.`;
44
- const lensSchema = z.object({
45
- label: z.string().describe('Specific description of the search perspective'),
46
- corpus: z.enum(['profiles', 'intents', 'premises']).describe('Search user profiles, user intents, or user premises (identity/values)'),
47
- reasoning: z.string().describe('Why this perspective is relevant'),
48
- });
49
- const responseFormat = z.object({
50
- lenses: z.array(lensSchema).min(1).max(5).describe('Inferred search lenses'),
51
- });
52
- /** Structured-output schema used only by source-frame extraction. */
53
- export const FrameResponseSchema = z.object({
54
- sourceFrame: HydeSourceFrameSchema,
55
- });
56
- const logger = protocolLogger("LensInferrer");
57
- /** Infers search lenses from source text and optional profile context. */
58
- export class LensInferrer {
59
- constructor(options = {}) {
60
- // Preserve legacy construction behavior in production. Frame-only model
61
- // injection deliberately avoids constructing a provider-backed legacy model.
62
- this.legacyModel = options.legacyModel
63
- ?? (options.frameModel ? undefined : createStructuredModel("lensInferrer", responseFormat, { name: "lens_inferrer" }));
64
- this.frameModel = options.frameModel;
65
- }
66
- getLegacyModel() {
67
- this.legacyModel ?? (this.legacyModel = createStructuredModel("lensInferrer", responseFormat, {
68
- name: "lens_inferrer",
69
- }));
70
- return this.legacyModel;
71
- }
72
- getFrameModel() {
73
- this.frameModel ?? (this.frameModel = createStructuredModel("lensInferrer", FrameResponseSchema, {
74
- name: "lens_inferrer_frame_v1",
75
- }));
76
- return this.frameModel;
77
- }
78
- /** Infer search lenses while preserving the legacy path unless explicitly enabled. */
79
- async infer(input) {
80
- const { sourceText, profileContext, maxLenses = 3, frameConstrained = false } = input;
81
- logger.verbose('Inferring lenses', {
82
- sourceTextLength: sourceText.length,
83
- hasProfileContext: !!profileContext,
84
- maxLenses,
85
- frameConstrained,
86
- });
87
- let humanPrompt = `Identify up to ${maxLenses} search perspectives for finding relevant matches.\n\nSource: "${sourceText}"`;
88
- if (profileContext) {
89
- humanPrompt += `\n\nUser context: ${profileContext}`;
90
- }
91
- const messages = [
92
- new SystemMessage(SYSTEM_PROMPT),
93
- new HumanMessage(humanPrompt),
94
- ];
95
- if (!frameConstrained) {
96
- try {
97
- const result = await invokeWithAbortSignal(this.getLegacyModel(), messages);
98
- const parsed = responseFormat.parse(result);
99
- const lenses = parsed.lenses.slice(0, maxLenses);
100
- logger.verbose('Lenses inferred', {
101
- count: lenses.length,
102
- lenses: lenses.map(l => ({ label: l.label, corpus: l.corpus })),
103
- });
104
- return { lenses };
105
- }
106
- catch (error) {
107
- logger.error('Lens inference failed', { error });
108
- return { lenses: [] };
109
- }
110
- }
111
- const frameMessages = [
112
- new SystemMessage(FRAME_SYSTEM_PROMPT),
113
- new HumanMessage(`Extract the source frame.\n\nSource: "${sourceText}"`),
114
- ];
115
- const lensPromise = (async () => {
116
- const result = await invokeWithAbortSignal(this.getLegacyModel(), messages);
117
- return responseFormat.parse(result).lenses.slice(0, maxLenses);
118
- })();
119
- const framePromise = (async () => {
120
- const result = await invokeWithAbortSignal(this.getFrameModel(), frameMessages);
121
- const parsed = FrameResponseSchema.parse(result);
122
- return sanitizeHydeSourceFrame(sourceText, parsed.sourceFrame);
123
- })();
124
- const [lensResult, frameResult] = await Promise.allSettled([lensPromise, framePromise]);
125
- if (lensResult.status === 'rejected') {
126
- logger.error('Lens inference failed', { error: lensResult.reason });
127
- return { lenses: [] };
128
- }
129
- const lenses = lensResult.value;
130
- logger.verbose('Frame-constrained lenses inferred', { count: lenses.length });
131
- if (frameResult.status === 'rejected') {
132
- logger.error('Source frame extraction failed', { error: frameResult.reason });
133
- return {
134
- lenses,
135
- sourceFrame: {
136
- sourceRoles: [],
137
- counterpartRoles: [],
138
- hardConstraints: [],
139
- namedEntities: [],
140
- domainVocabulary: [],
141
- },
142
- };
143
- }
144
- return { lenses, sourceFrame: frameResult.value };
145
- }
146
- }
147
- __decorate([
148
- Timed(),
149
- __metadata("design:type", Function),
150
- __metadata("design:paramtypes", [Object]),
151
- __metadata("design:returntype", Promise)
152
- ], LensInferrer.prototype, "infer", null);
@@ -1,68 +0,0 @@
1
- import { z } from "zod/v4";
2
- declare const responseFormat: z.ZodObject<{
3
- identity: z.ZodObject<{
4
- name: z.ZodString;
5
- bio: z.ZodString;
6
- location: z.ZodString;
7
- }, z.core.$strip>;
8
- narrative: z.ZodObject<{
9
- context: z.ZodString;
10
- }, z.core.$strip>;
11
- attributes: z.ZodObject<{
12
- interests: z.ZodArray<z.ZodString>;
13
- skills: z.ZodArray<z.ZodString>;
14
- }, z.core.$strip>;
15
- }, z.core.$strip>;
16
- type Profile = z.infer<typeof responseFormat>;
17
- export type GeneratedProfile = Profile & {
18
- userId: string;
19
- };
20
- export declare class EnrichmentGenerator {
21
- private static sharedModel;
22
- private model;
23
- constructor();
24
- private toString;
25
- invoke(input: string, options?: {
26
- signal?: AbortSignal;
27
- }): Promise<{
28
- output: {
29
- identity: {
30
- name: string;
31
- bio: string;
32
- location: string;
33
- };
34
- narrative: {
35
- context: string;
36
- };
37
- attributes: {
38
- interests: string[];
39
- skills: string[];
40
- };
41
- };
42
- textToEmbed: string;
43
- }>;
44
- static asTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
45
- input: z.ZodString;
46
- }, z.core.$strip>, {
47
- input: string;
48
- }, {
49
- input: string;
50
- }, {
51
- output: {
52
- identity: {
53
- name: string;
54
- bio: string;
55
- location: string;
56
- };
57
- narrative: {
58
- context: string;
59
- };
60
- attributes: {
61
- interests: string[];
62
- skills: string[];
63
- };
64
- };
65
- textToEmbed: string;
66
- }, unknown, "profileGenerator">;
67
- }
68
- export {};