@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,8 +1,8 @@
1
1
  /**
2
2
  * Database operations for profiles, intents, and their vector search.
3
3
  */
4
- import type { UserIdentity } from '../schemas/identity.schema.js';
5
- import type { ActiveIntent, ActiveNetworkMembershipPair, ArchiveResult, CreateIntentData, CreatedIntent, IntentRecord, NetworkMembership, OnboardingState, SimilarIntent, SimilarIntentSearchOptions, UpdateIntentData, UserRecord, UserSocial } from './database.entities.js';
4
+ import type { UserIdentity } from '../../protocol/schemas/identity.schema.js';
5
+ import type { ActiveIntent, ActiveNetworkMembershipPair, ArchiveResult, CreateIntentData, CreatedIntent, IntentLifecycleStatus, IntentRecord, NetworkMembership, OnboardingState, SimilarIntent, SimilarIntentSearchOptions, TransitionLifecycleResult, UpdateIntentData, UserRecord, UserSocial } from './entities.js';
6
6
  /** Profile, intent-lifecycle and retrieval operations. */
7
7
  export interface DatabaseIdentityQueries {
8
8
  /**
@@ -26,8 +26,6 @@ export interface DatabaseIdentityQueries {
26
26
  /**
27
27
  * Updates user account fields (name, location, socials).
28
28
  * Merges socials with existing values (does not overwrite the whole object).
29
- * Used by create_user_context tool to persist user-provided info before
30
- * invoking the Profile Graph in generate mode.
31
29
  *
32
30
  * @param userId - The unique identifier of the user
33
31
  * @param data - Partial user fields to update
@@ -62,17 +60,17 @@ export interface DatabaseIdentityQueries {
62
60
  */
63
61
  getActiveIntents(userId: string): Promise<ActiveIntent[]>;
64
62
  /**
65
- * Get active intents that belong to the user and are assigned to a specific index.
66
- * Caller must be a member of that index; only the user's own intents are returned.
63
+ * Get active intents that belong to the user and are assigned to a specific network.
64
+ * Caller must be a member of that network; only the user's own intents are returned.
67
65
  *
68
- * @param userId - The user requesting (must be a member of the index)
69
- * @param indexNameOrId - Network UUID or display name (e.g. "Commons")
70
- * @returns Array of active intents in that index for the user, or empty if not a member / no match
66
+ * @param userId - The user requesting (must be a member of the network)
67
+ * @param networkNameOrId - Network UUID or display name (e.g. "Commons")
68
+ * @returns Array of active intents in that network for the user, or empty if not a member / no match
71
69
  */
72
- getIntentsInIndexForMember(userId: string, indexNameOrId: string): Promise<ActiveIntent[]>;
70
+ getIntentsInNetworkForMember(userId: string, networkNameOrId: string): Promise<ActiveIntent[]>;
73
71
  /**
74
72
  * Creates a new intent with full processing pipeline.
75
- * Handles summarization, embedding generation, and index association.
73
+ * Handles summarization, embedding generation, and network association.
76
74
  *
77
75
  * Called when the reconciler outputs a "create" action.
78
76
  *
@@ -131,6 +129,44 @@ export interface DatabaseIdentityQueries {
131
129
  * ```
132
130
  */
133
131
  archiveIntent(intentId: string): Promise<ArchiveResult>;
132
+ /**
133
+ * Atomically transition an owned intent between ACTIVE and PAUSED.
134
+ * Terminal/archived intents and out-of-scope requests are rejected.
135
+ * Idempotent: re-requesting the current status reports `changed: false`.
136
+ *
137
+ * Called when the reconciler outputs a "transition" action.
138
+ */
139
+ transitionIntentLifecycle(input: {
140
+ intentId: string;
141
+ userId: string;
142
+ status: 'ACTIVE' | 'PAUSED';
143
+ networkScopeId?: string | null;
144
+ }): Promise<TransitionLifecycleResult>;
145
+ /**
146
+ * Compare-and-set a resume back to PAUSED when its discovery-enqueue
147
+ * acknowledgement failed. A concurrent lifecycle write is never overwritten.
148
+ */
149
+ compensateFailedResume(input: {
150
+ intentId: string;
151
+ userId: string;
152
+ lifecycleVersionMs: number;
153
+ networkScopeId?: string | null;
154
+ }): Promise<{
155
+ status: IntentLifecycleStatus;
156
+ lifecycleVersionMs: number;
157
+ } | null>;
158
+ /**
159
+ * Deletes every intent–network association for an archived intent.
160
+ * Called as part of the "expire" action's cleanup.
161
+ */
162
+ deleteIntentNetworkAssociations(intentId: string): Promise<void>;
163
+ /**
164
+ * Expires every non-expired opportunity where this intent appears as an actor.
165
+ * Called as part of the "expire" action's cleanup.
166
+ *
167
+ * @returns The number of opportunities expired.
168
+ */
169
+ expireOpportunitiesByIntentActor(intentId: string): Promise<number>;
134
170
  /**
135
171
  * Retrieves a single intent by ID.
136
172
  *
@@ -166,30 +202,30 @@ export interface DatabaseIdentityQueries {
166
202
  getIntentWithOwnership(intentId: string, userId: string): Promise<IntentRecord | null>;
167
203
  /**
168
204
  * Gets Network IDs where the user has auto-assign membership enabled.
169
- * Used for determining which indexes to associate new intents with.
205
+ * Used for determining which networks to associate new intents with.
170
206
  *
171
207
  * @param userId - The unique identifier of the user
172
208
  * @returns Array of network IDs
173
209
  *
174
210
  * @example
175
211
  * ```typescript
176
- * const networkIds = await db.getUserIndexIds(userId);
212
+ * const networkIds = await db.getUserNetworkIds(userId);
177
213
  * if (networkIds.length > 0) {
178
214
  * await db.associateIntentWithNetworks(intentId, networkIds);
179
215
  * }
180
216
  * ```
181
217
  */
182
- getUserIndexIds(userId: string): Promise<string[]>;
218
+ getUserNetworkIds(userId: string): Promise<string[]>;
183
219
  /**
184
220
  * Retrieves all networks the user is a member of with full details.
185
- * Used for displaying network memberships in chat (index_query).
221
+ * Used for displaying network memberships in chat.
186
222
  *
187
223
  * @param userId - The unique identifier of the user
188
224
  * @returns Array of network memberships with details
189
225
  */
190
226
  getNetworkMemberships(userId: string): Promise<NetworkMembership[]>;
191
227
  /**
192
- * Get a single network membership by index and user.
228
+ * Get a single network membership by network and user.
193
229
  * Used when the preloaded memberships list may not contain this network (e.g. after isNetworkMember check).
194
230
  *
195
231
  * @param networkId - The network ID
@@ -199,12 +235,11 @@ export interface DatabaseIdentityQueries {
199
235
  getNetworkMembership(networkId: string, userId: string): Promise<NetworkMembership | null>;
200
236
  /**
201
237
  * Return only requested user/network pairs backed by a live membership row
202
- * and a non-deleted network. Permissions are intentionally not filtered:
203
- * personal-network contacts are valid discovery participants.
238
+ * and a non-deleted network. Permissions are intentionally not filtered.
204
239
  */
205
240
  getActiveNetworkMembershipPairs(pairs: ActiveNetworkMembershipPair[]): Promise<ActiveNetworkMembershipPair[]>;
206
241
  /**
207
- * Get index by ID with core fields. Used for opportunity presentation and context rendering.
242
+ * Get network by ID with core fields. Used for opportunity presentation and context rendering.
208
243
  */
209
244
  getNetwork(networkId: string): Promise<{
210
245
  id: string;
@@ -215,7 +250,7 @@ export interface DatabaseIdentityQueries {
215
250
  permissions?: Record<string, unknown> | null;
216
251
  } | null>;
217
252
  /**
218
- * Get index by ID with permissions (e.g. joinPolicy). Used by chat tools for create_index_membership.
253
+ * Get network by ID with permissions (e.g. joinPolicy). Used when a member joins a community.
219
254
  */
220
255
  getNetworkWithPermissions(networkId: string): Promise<{
221
256
  id: string;
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Database operations for user contexts.
3
+ */
4
+ /** User-context operations. */
5
+ export interface DatabaseMemberQueries {
6
+ /**
7
+ * Finds an existing DM conversation between two users, or creates one.
8
+ * Uses a unique `dmPair` column (sorted user IDs joined by ':') to
9
+ * prevent duplicate DMs under concurrency. Used by the Start Chat flow
10
+ * (Plan B Task 8) to atomically surface the h2h conversation when
11
+ * accepting an opportunity.
12
+ */
13
+ getOrCreateDM(userA: string, userB: string, participantType?: 'user' | 'agent'): Promise<{
14
+ id: string;
15
+ }>;
16
+ /**
17
+ * Clears hiddenAt for a user on a conversation, making it visible in their
18
+ * conversation list again. Called by startChat when reusing an existing DM
19
+ * that the user had previously hidden.
20
+ */
21
+ unhideConversation(userId: string, conversationId: string): Promise<void>;
22
+ /** Find a user by email. */
23
+ getUserByEmail(email: string): Promise<{
24
+ id: string;
25
+ name: string;
26
+ email: string;
27
+ } | null>;
28
+ /**
29
+ * Profile text for a user (sourced from the users row). Used by discovery.
30
+ */
31
+ getUserContext(userId: string, networkId: string | null): Promise<{
32
+ id: string;
33
+ text: string;
34
+ embedding: number[];
35
+ generatedAt: Date;
36
+ } | null>;
37
+ /**
38
+ * Cosine similarity search against intent embeddings using a context embedding.
39
+ * Restores the profile→intent cross-search deleted when Path B was removed.
40
+ */
41
+ searchIntentsByContextEmbedding(params: {
42
+ embedding: number[];
43
+ networkIds: string[];
44
+ excludeUserId: string;
45
+ limit: number;
46
+ minScore?: number;
47
+ }): Promise<Array<{
48
+ intentId: string;
49
+ userId: string;
50
+ networkId: string;
51
+ payload: string;
52
+ summary: string | null;
53
+ similarity: number;
54
+ }>>;
55
+ }
@@ -0,0 +1,4 @@
1
+ /**
2
+ * Database operations for user contexts.
3
+ */
4
+ export {};
@@ -0,0 +1,38 @@
1
+ import type { NegotiationDecision, NegotiationState, NegotiationTurn } from '../../protocol/negotiation.rules.js';
2
+ /** A host must evaluate the supplied policy against locked, current data and apply its transition atomically. */
3
+ export interface NegotiationDatabase {
4
+ readNegotiationState(id: string, userId: string): Promise<NegotiationState | null>;
5
+ commitNegotiationTurn(id: string, userId: string, turn: NegotiationTurn, decide: (state: NegotiationState | null) => NegotiationDecision): Promise<NegotiationDecision>;
6
+ }
7
+ /**
8
+ * The host's read of a negotiation record.
9
+ *
10
+ * Index is the server for every negotiation, so a graph never assembles a
11
+ * transcript from messages — it asks the host for the turn log of one
12
+ * opportunity's negotiation, already projected onto the reading seat.
13
+ */
14
+ /** What one seat decided, and what it said about it. */
15
+ export interface NegotiationContextTurn {
16
+ action: 'propose' | 'counter' | 'accept' | 'decline';
17
+ message: string;
18
+ /** True when the viewer's own seat authored this turn. */
19
+ own: boolean;
20
+ }
21
+ /** How a negotiation ended, once it has. */
22
+ export type NegotiationContextOutcome = 'agreed' | 'declined' | 'closed';
23
+ /** One negotiation, from the reading seat's side. */
24
+ export interface NegotiationContextRecord {
25
+ outcome: NegotiationContextOutcome | null;
26
+ turns: NegotiationContextTurn[];
27
+ }
28
+ /** The one thing a host must do for negotiation-grounded presentation. */
29
+ export interface NegotiationContextDatabase {
30
+ /**
31
+ * The negotiation attached to an opportunity, as one seat sees it.
32
+ *
33
+ * @param opportunityId - The opportunity.
34
+ * @param viewerUserId - The reading seat's owner.
35
+ * @returns The record, or null when there is none or the viewer holds no seat.
36
+ */
37
+ readNegotiationContext(opportunityId: string, viewerUserId: string): Promise<NegotiationContextRecord | null>;
38
+ }
@@ -1,13 +1,13 @@
1
1
  /**
2
- * Database operations for intent-network assignment and index ownership.
2
+ * Database operations for intent-network assignment and network ownership.
3
3
  */
4
- import type { UserIdentity } from '../schemas/identity.schema.js';
5
- import type { NetworkAssignmentMetadata } from '../schemas/network-assignment.schema.js';
6
- import type { ActiveIntent, AssignmentNetworkMembership, Id, IndexMemberDetails, IndexedIntentDetails, IntentNetworkFinalAssignmentResult, NetworkAssignmentContext, OwnedIndex, UpdateIndexSettingsData } from './database.entities.js';
7
- /** Network assignment and owner-only index operations. */
4
+ import type { UserIdentity } from '../../protocol/schemas/identity.schema.js';
5
+ import type { NetworkAssignmentMetadata } from '../../protocol/schemas/network-assignment.schema.js';
6
+ import type { ActiveIntent, AssignmentNetworkMembership, Id, IntentNetworkFinalAssignmentResult, NetworkAssignmentContext, NetworkIntentDetails, NetworkMemberDetails, OwnedNetwork, UpdateNetworkSettingsData } from './entities.js';
7
+ /** Network assignment and owner-only network operations. */
8
8
  export interface DatabaseNetworkQueries {
9
9
  /**
10
- * Intent fields needed for index appropriateness evaluation.
10
+ * Intent fields needed for network appropriateness evaluation.
11
11
  */
12
12
  getIntentForIndexing(intentId: string): Promise<{
13
13
  id: string;
@@ -17,19 +17,18 @@ export interface DatabaseNetworkQueries {
17
17
  sourceId: string | null;
18
18
  } | null>;
19
19
  /**
20
- * Index + member prompts for a user in an index (only when member has autoAssign).
20
+ * Network + member prompts for a user in a network (only when member has autoAssign).
21
21
  * Returns null if user is not a member or autoAssign is false.
22
22
  */
23
23
  getNetworkMemberContext(networkId: string, userId: string): Promise<NetworkAssignmentContext | null>;
24
24
  /**
25
25
  * Network memberships that should be considered for assignment policy. Unlike
26
- * getUserIndexIds, this is not gated by network_members.autoAssign and carries
27
- * personal-index metadata so scoped writes can include the user's personal network.
26
+ * getUserNetworkIds, this is not gated by network_members.autoAssign.
28
27
  */
29
28
  getAssignmentNetworkMembershipsForUser(userId: string): Promise<AssignmentNetworkMembership[]>;
30
29
  /**
31
30
  * Network IDs that should be considered for assignment policy. Unlike
32
- * getUserIndexIds, this is not gated by network_members.autoAssign.
31
+ * getUserNetworkIds, this is not gated by network_members.autoAssign.
33
32
  * @deprecated Prefer getAssignmentNetworkMembershipsForUser for scope-aware assignment.
34
33
  */
35
34
  getAssignmentNetworkIdsForUser(userId: string): Promise<string[]>;
@@ -39,11 +38,11 @@ export interface DatabaseNetworkQueries {
39
38
  */
40
39
  getNetworkAssignmentContext(networkId: string, userId: string): Promise<NetworkAssignmentContext | null>;
41
40
  /**
42
- * Whether the intent is currently assigned to the index.
41
+ * Whether the intent is currently assigned to the network.
43
42
  */
44
- isIntentAssignedToIndex(intentId: string, networkId: string): Promise<boolean>;
43
+ isIntentAssignedToNetwork(intentId: string, networkId: string): Promise<boolean>;
45
44
  /**
46
- * Assigns an intent to an index (inserts intent_indexes row).
45
+ * Assigns an intent to a network (inserts intent_networks row).
47
46
  */
48
47
  assignIntentToNetwork(intentId: string, networkId: string, relevancyScore?: number, assignmentMetadata?: NetworkAssignmentMetadata): Promise<void>;
49
48
  /**
@@ -53,29 +52,29 @@ export interface DatabaseNetworkQueries {
53
52
  */
54
53
  assignIntentToNetworkIfMember(userId: string, intentId: string, networkId: string, relevancyScore?: number, assignmentMetadata?: NetworkAssignmentMetadata): Promise<IntentNetworkFinalAssignmentResult>;
55
54
  /**
56
- * Returns per-index relevancy scores for an intent's index assignments.
55
+ * Returns per-network relevancy scores for an intent's network assignments.
57
56
  */
58
- getIntentIndexScores(intentId: string): Promise<Array<{
57
+ getIntentNetworkScores(intentId: string): Promise<Array<{
59
58
  networkId: string;
60
59
  relevancyScore: number | null;
61
60
  assignmentMetadata?: NetworkAssignmentMetadata | null;
62
61
  }>>;
63
62
  /**
64
- * Removes an intent from an index (deletes intent_indexes row).
63
+ * Removes an intent from a network (deletes intent_networks row).
65
64
  */
66
- unassignIntentFromIndex(intentId: string, networkId: string): Promise<void>;
65
+ unassignIntentFromNetwork(intentId: string, networkId: string): Promise<void>;
67
66
  /**
68
67
  * Returns all network IDs that an intent is registered to.
69
68
  */
70
69
  getNetworkIdsForIntent(intentId: string): Promise<string[]>;
71
70
  /**
72
- * Get indexes where the user has owner permissions.
73
- * Returns full index details with member and intent counts.
71
+ * Get networks where the user has owner permissions.
72
+ * Returns full network details with member and intent counts.
74
73
  *
75
74
  * @param userId - The user ID to check ownership for
76
- * @returns Array of owned indexes with counts
75
+ * @returns Array of owned networks with counts
77
76
  */
78
- getOwnedIndexes(userId: string): Promise<OwnedIndex[]>;
77
+ getOwnedNetworks(userId: string): Promise<OwnedNetwork[]>;
79
78
  /**
80
79
  * Get public networks (joinPolicy 'anyone') that the user has not joined.
81
80
  * Used for discovering communities available to join.
@@ -83,7 +82,7 @@ export interface DatabaseNetworkQueries {
83
82
  * @param userId - The user ID to check memberships against
84
83
  * @returns Object containing array of public networks with owner info
85
84
  */
86
- getPublicIndexesNotJoined(userId: string): Promise<{
85
+ getPublicNetworksNotJoined(userId: string): Promise<{
87
86
  networks: Array<{
88
87
  id: string;
89
88
  title: string;
@@ -97,59 +96,59 @@ export interface DatabaseNetworkQueries {
97
96
  }>;
98
97
  }>;
99
98
  /**
100
- * Check if user is an owner of a specific index.
99
+ * Check if user is an owner of a specific network.
101
100
  *
102
- * @param networkId - The index to check
101
+ * @param networkId - The network to check
103
102
  * @param userId - The user to verify ownership for
104
103
  * @returns True if user is an owner
105
104
  */
106
- isIndexOwner(networkId: string, userId: string): Promise<boolean>;
105
+ isNetworkOwner(networkId: string, userId: string): Promise<boolean>;
107
106
  /**
108
- * Check if user is a member of a specific index.
107
+ * Check if user is a member of a specific network.
109
108
  *
110
- * @param networkId - The index to check
109
+ * @param networkId - The network to check
111
110
  * @param userId - The user to verify membership for
112
111
  * @returns True if user is a member
113
112
  */
114
113
  isNetworkMember(networkId: string, userId: string): Promise<boolean>;
115
114
  /**
116
- * Get all members of an index with their details.
115
+ * Get all members of a network with their details.
117
116
  * **OWNER ONLY** - throws if user is not an owner.
118
117
  *
119
- * @param networkId - The index to get members for
118
+ * @param networkId - The network to get members for
120
119
  * @param requestingUserId - The user requesting (must be owner)
121
120
  * @returns Array of member details with intent counts
122
121
  * @throws Error if requestingUserId is not an owner
123
122
  */
124
- getNetworkMembersForOwner(networkId: string, requestingUserId: string): Promise<IndexMemberDetails[]>;
123
+ getNetworkMembersForOwner(networkId: string, requestingUserId: string): Promise<NetworkMemberDetails[]>;
125
124
  /**
126
- * Get all members of an index with their details.
127
- * **MEMBER ONLY** - any member of the index can list members (not just owners).
125
+ * Get all members of a network with their details.
126
+ * **MEMBER ONLY** - any member of the network can list members (not just owners).
128
127
  * Returns same shape as getNetworkMembersForOwner; email may be omitted for privacy.
129
128
  *
130
- * @param networkId - The index to get members for
131
- * @param requestingUserId - The user requesting (must be a member of the index)
129
+ * @param networkId - The network to get members for
130
+ * @param requestingUserId - The user requesting (must be a member of the network)
132
131
  * @returns Array of member details with intent counts
133
- * @throws Error if requestingUserId is not a member of the index
132
+ * @throws Error if requestingUserId is not a member of the network
134
133
  */
135
- getNetworkMembersForMember(networkId: string, requestingUserId: string): Promise<IndexMemberDetails[]>;
134
+ getNetworkMembersForMember(networkId: string, requestingUserId: string): Promise<NetworkMemberDetails[]>;
136
135
  /**
137
136
  * Get all members from every network the user is a member of (deduplicated).
138
- * Used for mentionable-users: anyone who shares at least one index with the requesting user.
137
+ * Used for mentionable-users: anyone who shares at least one network with the requesting user.
139
138
  *
140
139
  * @param userId - The signed-in user
141
140
  * @returns Array of member summaries (id, name, avatar only; no email)
142
141
  */
143
- getMembersFromUserIndexes(userId: Id<'users'>): Promise<{
142
+ getMembersFromUserNetworks(userId: Id<'users'>): Promise<{
144
143
  userId: Id<'users'>;
145
144
  name: string;
146
145
  avatar: string | null;
147
146
  }[]>;
148
147
  /**
149
- * Get all indexed intents for an index.
148
+ * Get all assigned intents for a network.
150
149
  * **OWNER ONLY** - throws if user is not an owner.
151
150
  *
152
- * @param networkId - The index to get intents for
151
+ * @param networkId - The network to get intents for
153
152
  * @param requestingUserId - The user requesting (must be owner)
154
153
  * @param options - Pagination options
155
154
  * @returns Array of intent details with owner info
@@ -158,60 +157,60 @@ export interface DatabaseNetworkQueries {
158
157
  getNetworkIntentsForOwner(networkId: string, requestingUserId: string, options?: {
159
158
  limit?: number;
160
159
  offset?: number;
161
- }): Promise<IndexedIntentDetails[]>;
160
+ }): Promise<NetworkIntentDetails[]>;
162
161
  /**
163
- * Get all indexed intents for an index.
164
- * **MEMBER ONLY** - any member of the index can list intents (not just owners).
162
+ * Get all assigned intents for a network.
163
+ * **MEMBER ONLY** - any member of the network can list intents (not just owners).
165
164
  *
166
- * @param networkId - The index to get intents for
167
- * @param requestingUserId - The user requesting (must be a member of the index)
165
+ * @param networkId - The network to get intents for
166
+ * @param requestingUserId - The user requesting (must be a member of the network)
168
167
  * @param options - Pagination options
169
168
  * @returns Array of intent details with owner info
170
- * @throws Error if requestingUserId is not a member of the index
169
+ * @throws Error if requestingUserId is not a member of the network
171
170
  */
172
171
  getNetworkIntentsForMember(networkId: string, requestingUserId: string, options?: {
173
172
  limit?: number;
174
173
  offset?: number;
175
- }): Promise<IndexedIntentDetails[]>;
174
+ }): Promise<NetworkIntentDetails[]>;
176
175
  /**
177
- * Get the caller's own active intents across a set of indexes.
176
+ * Get the caller's own active intents across a set of networks.
178
177
  * Returns intents owned by `userId` that are linked (via intent_networks)
179
- * to at least one of `indexIds`. Used by network-scoped agents to honor
180
- * indexScope without falling back to global getActiveIntents (which would
181
- * include intents in indexes outside scope).
178
+ * to at least one of `networkIds`. Used by network-scoped agents to honor
179
+ * networkScope without falling back to global getActiveIntents (which would
180
+ * include intents in networks outside scope).
182
181
  *
183
182
  * @param userId - The intent owner (always the caller).
184
- * @param indexIds - The set of network IDs to filter on. Empty → empty result.
185
- * @returns Active intents owned by userId in any of indexIds, deduped by intent id.
183
+ * @param networkIds - The set of network IDs to filter on. Empty → empty result.
184
+ * @returns Active intents owned by userId in any of networkIds, deduped by intent id.
186
185
  */
187
- getActiveIntentsAcrossIndexes(userId: string, indexIds: string[]): Promise<ActiveIntent[]>;
186
+ getActiveIntentsAcrossNetworks(userId: string, networkIds: string[]): Promise<ActiveIntent[]>;
188
187
  /**
189
- * Update index settings.
188
+ * Update network settings.
190
189
  * **OWNER ONLY** - throws if user is not an owner.
191
190
  *
192
- * @param networkId - The index to update
191
+ * @param networkId - The network to update
193
192
  * @param requestingUserId - The user requesting (must be owner)
194
193
  * @param data - The settings to update
195
- * @returns The updated index
194
+ * @returns The updated network
196
195
  * @throws Error if requestingUserId is not an owner
197
196
  */
198
- updateIndexSettings(networkId: string, requestingUserId: string, data: UpdateIndexSettingsData): Promise<OwnedIndex>;
197
+ updateNetworkSettings(networkId: string, requestingUserId: string, data: UpdateNetworkSettingsData): Promise<OwnedNetwork>;
199
198
  /**
200
199
  * Soft-delete a network (set deletedAt).
201
- * Caller must ensure network is not personal and has no other members.
200
+ * Caller must ensure the network has no other members.
202
201
  *
203
202
  * @param networkId - The network to soft-delete
204
203
  */
205
204
  softDeleteNetwork(networkId: string): Promise<void>;
206
205
  /**
207
206
  * Delete a user's profile (removes profile row).
208
- * Used after confirmation in chat tools.
207
+ * Used after the owner confirms the assignment.
209
208
  *
210
209
  * @param userId - User whose profile to delete
211
210
  */
212
211
  deleteProfile(userId: string): Promise<void>;
213
212
  /**
214
- * Get a user's profile including its row id (for update_user_context validation).
213
+ * Get a user's profile including its row id.
215
214
  *
216
215
  * @param userId - The user whose profile to fetch
217
216
  * @returns Profile with id, or null if not found
@@ -220,7 +219,7 @@ export interface DatabaseNetworkQueries {
220
219
  id: string;
221
220
  }) | null>;
222
221
  /**
223
- * Create a new index and return its record.
222
+ * Create a new network and return its record.
224
223
  *
225
224
  * @param data - Title, optional prompt, optional imageUrl, optional joinPolicy
226
225
  * @returns The created network with id, title, prompt, imageUrl, permissions
@@ -243,9 +242,9 @@ export interface DatabaseNetworkQueries {
243
242
  };
244
243
  }>;
245
244
  /**
246
- * Count members in an index (for delete guard).
245
+ * Count members in a network (for delete guard).
247
246
  *
248
- * @param networkId - The index to count
247
+ * @param networkId - The network to count
249
248
  * @returns Number of members
250
249
  */
251
250
  getNetworkMemberCount(networkId: string): Promise<number>;
@@ -262,14 +261,14 @@ export interface DatabaseNetworkQueries {
262
261
  alreadyMember?: boolean;
263
262
  }>;
264
263
  /**
265
- * Removes a user from an index.
264
+ * Removes a user from a network.
266
265
  * Only the network owner can remove members. Cannot remove the owner.
267
266
  *
268
- * @param networkId - The index to remove from
267
+ * @param networkId - The network to remove from
269
268
  * @param userId - The user to remove
270
269
  * @returns success, or wasOwner/notMember if removal failed
271
270
  */
272
- removeMemberFromIndex(networkId: string, userId: string): Promise<{
271
+ removeMemberFromNetwork(networkId: string, userId: string): Promise<{
273
272
  success: boolean;
274
273
  wasOwner?: boolean;
275
274
  notMember?: boolean;
@@ -0,0 +1,4 @@
1
+ /**
2
+ * Database operations for intent-network assignment and network ownership.
3
+ */
4
+ export {};