attention-manifest-protocol 0.4.0 → 0.4.2

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 (627) hide show
  1. package/CHANGELOG.md +250 -226
  2. package/CHANGELOG.zh-CN.md +63 -39
  3. package/README.md +22 -1
  4. package/README.zh-CN.md +22 -1
  5. package/docs/probes/calibration-imported.json +141 -141
  6. package/docs/probes/eval-recorded-replay.json +597 -597
  7. package/docs/probes/eval-replay.json +124 -124
  8. package/docs/probes/eval-summary.json +42 -42
  9. package/docs/probes/runtime-eval.json +4230 -4230
  10. package/lib/attention/attention.d.ts +153 -0
  11. package/lib/attention/attention.js +209 -0
  12. package/lib/attention/budget.d.ts +31 -0
  13. package/lib/attention/budget.js +55 -0
  14. package/lib/attention/cognition.d.ts +230 -0
  15. package/lib/attention/cognition.js +245 -0
  16. package/lib/attention/index.d.ts +8 -0
  17. package/lib/attention/index.js +7 -0
  18. package/lib/attention/interrupts.d.ts +97 -0
  19. package/lib/attention/interrupts.js +151 -0
  20. package/lib/attention/resource.d.ts +167 -0
  21. package/lib/attention/resource.js +148 -0
  22. package/lib/attention/social.d.ts +74 -0
  23. package/lib/attention/social.js +153 -0
  24. package/lib/attention/socialTypes.d.ts +102 -0
  25. package/lib/attention/socialTypes.js +1 -0
  26. package/lib/authz/authz.d.ts +75 -0
  27. package/lib/authz/authz.js +176 -0
  28. package/lib/authz/index.d.ts +1 -0
  29. package/lib/authz/index.js +1 -0
  30. package/lib/bayes/calibration.d.ts +67 -0
  31. package/lib/bayes/calibration.js +114 -0
  32. package/lib/bayes/calibrationRegistry.d.ts +39 -0
  33. package/lib/bayes/calibrationRegistry.js +61 -0
  34. package/lib/bayes/calibrationSelection.d.ts +40 -0
  35. package/lib/bayes/calibrationSelection.js +89 -0
  36. package/lib/bayes/engine.d.ts +163 -0
  37. package/lib/bayes/engine.js +354 -0
  38. package/lib/bayes/index.d.ts +6 -0
  39. package/lib/bayes/index.js +6 -0
  40. package/lib/bayes/reliability.d.ts +27 -0
  41. package/lib/bayes/reliability.js +38 -0
  42. package/lib/bayes/scopedPriors.d.ts +34 -0
  43. package/lib/bayes/scopedPriors.js +70 -0
  44. package/lib/boundary/frame.d.ts +63 -0
  45. package/lib/boundary/frame.js +239 -0
  46. package/lib/boundary/ids.d.ts +8 -0
  47. package/lib/boundary/ids.js +12 -0
  48. package/lib/boundary/index.d.ts +12 -0
  49. package/lib/boundary/index.js +8 -0
  50. package/lib/boundary/refTable.d.ts +49 -0
  51. package/lib/boundary/refTable.js +92 -0
  52. package/lib/boundary/toolCall.d.ts +33 -0
  53. package/lib/boundary/toolCall.js +173 -0
  54. package/lib/concept/concept.d.ts +67 -0
  55. package/lib/concept/concept.js +1 -0
  56. package/lib/concept/conceptBudget.d.ts +56 -0
  57. package/lib/concept/conceptBudget.js +281 -0
  58. package/lib/concept/conceptBudgetTypes.d.ts +74 -0
  59. package/lib/concept/conceptBudgetTypes.js +1 -0
  60. package/lib/concept/index.d.ts +3 -0
  61. package/lib/concept/index.js +3 -0
  62. package/lib/concurrency/idempotency.d.ts +16 -0
  63. package/lib/concurrency/idempotency.js +21 -0
  64. package/lib/concurrency/index.d.ts +5 -0
  65. package/lib/concurrency/index.js +5 -0
  66. package/lib/concurrency/mutex.d.ts +13 -0
  67. package/lib/concurrency/mutex.js +26 -0
  68. package/lib/concurrency/namedLocks.d.ts +7 -0
  69. package/lib/concurrency/namedLocks.js +31 -0
  70. package/lib/concurrency/retry.d.ts +23 -0
  71. package/lib/concurrency/retry.js +38 -0
  72. package/lib/concurrency/worker.d.ts +42 -0
  73. package/lib/concurrency/worker.js +67 -0
  74. package/lib/context/agentContext.d.ts +58 -0
  75. package/lib/context/agentContext.js +197 -0
  76. package/lib/context/ast.d.ts +98 -0
  77. package/lib/context/ast.js +414 -0
  78. package/lib/context/contentStore.d.ts +16 -0
  79. package/lib/context/contentStore.js +61 -0
  80. package/lib/context/context.d.ts +15 -0
  81. package/lib/context/context.js +39 -0
  82. package/lib/context/contextIndex.d.ts +40 -0
  83. package/lib/context/contextIndex.js +64 -0
  84. package/lib/context/document.d.ts +102 -0
  85. package/lib/context/document.js +22 -0
  86. package/lib/context/fileStorePath.d.ts +1 -0
  87. package/lib/context/fileStorePath.js +13 -0
  88. package/lib/context/index.d.ts +22 -0
  89. package/lib/context/index.js +11 -0
  90. package/lib/context/lifecycle.d.ts +91 -0
  91. package/lib/context/lifecycle.js +163 -0
  92. package/lib/context/projections.d.ts +20 -0
  93. package/lib/context/projections.js +127 -0
  94. package/lib/context/workspace.d.ts +111 -0
  95. package/lib/context/workspace.js +318 -0
  96. package/lib/context/workspaceProtocol.d.ts +30 -0
  97. package/lib/context/workspaceProtocol.js +49 -0
  98. package/lib/context/workspaceService.d.ts +63 -0
  99. package/lib/context/workspaceService.js +352 -0
  100. package/lib/cooperation/board.d.ts +47 -0
  101. package/lib/cooperation/board.js +66 -0
  102. package/lib/cooperation/collaboration.d.ts +55 -0
  103. package/lib/cooperation/collaboration.js +1 -0
  104. package/lib/cooperation/index.d.ts +6 -0
  105. package/lib/cooperation/index.js +6 -0
  106. package/lib/cooperation/merge.d.ts +69 -0
  107. package/lib/cooperation/merge.js +109 -0
  108. package/lib/cooperation/metrics.d.ts +39 -0
  109. package/lib/cooperation/metrics.js +17 -0
  110. package/lib/cooperation/session.d.ts +75 -0
  111. package/lib/cooperation/session.js +74 -0
  112. package/lib/cooperation/unified.d.ts +38 -0
  113. package/lib/cooperation/unified.js +40 -0
  114. package/lib/database/adapter/adapters.d.ts +24 -0
  115. package/lib/database/adapter/adapters.js +31 -0
  116. package/lib/database/adapter/index.d.ts +4 -0
  117. package/lib/database/adapter/index.js +4 -0
  118. package/lib/database/adapter/runtimeSink.d.ts +20 -0
  119. package/lib/database/adapter/runtimeSink.js +50 -0
  120. package/lib/database/adapter/sessionStore.d.ts +11 -0
  121. package/lib/database/adapter/sessionStore.js +23 -0
  122. package/lib/database/adapter/turnStore.d.ts +10 -0
  123. package/lib/database/adapter/turnStore.js +15 -0
  124. package/lib/database/entity/agent.d.ts +133 -0
  125. package/lib/database/entity/agent.js +61 -0
  126. package/lib/database/entity/entity.d.ts +715 -0
  127. package/lib/database/entity/entity.js +372 -0
  128. package/lib/database/entity/handle.d.ts +31 -0
  129. package/lib/database/entity/handle.js +53 -0
  130. package/lib/database/entity/index.d.ts +32 -0
  131. package/lib/database/entity/index.js +22 -0
  132. package/lib/database/entity/message.d.ts +27 -0
  133. package/lib/database/entity/message.js +52 -0
  134. package/lib/database/entity/meta.d.ts +11 -0
  135. package/lib/database/entity/meta.js +1 -0
  136. package/lib/database/entity/object.d.ts +23 -0
  137. package/lib/database/entity/object.js +24 -0
  138. package/lib/database/entity/outbox.d.ts +9 -0
  139. package/lib/database/entity/outbox.js +5 -0
  140. package/lib/database/entity/process.d.ts +30 -0
  141. package/lib/database/entity/process.js +40 -0
  142. package/lib/database/entity/registry.d.ts +81 -0
  143. package/lib/database/entity/registry.js +91 -0
  144. package/lib/database/entity/runtimeApproval.d.ts +23 -0
  145. package/lib/database/entity/runtimeApproval.js +5 -0
  146. package/lib/database/entity/runtimeSession.d.ts +7 -0
  147. package/lib/database/entity/runtimeSession.js +5 -0
  148. package/lib/database/entity/runtimeTurn.d.ts +9 -0
  149. package/lib/database/entity/runtimeTurn.js +5 -0
  150. package/lib/database/entity/thread.d.ts +35 -0
  151. package/lib/database/entity/thread.js +55 -0
  152. package/lib/database/entity/window.d.ts +39 -0
  153. package/lib/database/entity/window.js +56 -0
  154. package/lib/database/entity/worker.d.ts +42 -0
  155. package/lib/database/entity/worker.js +58 -0
  156. package/lib/database/index.d.ts +6 -0
  157. package/lib/database/index.js +6 -0
  158. package/lib/database/repository/addressSpaceRepository.d.ts +18 -0
  159. package/lib/database/repository/addressSpaceRepository.js +40 -0
  160. package/lib/database/repository/agentRepository.d.ts +41 -0
  161. package/lib/database/repository/agentRepository.js +398 -0
  162. package/lib/database/repository/base.d.ts +31 -0
  163. package/lib/database/repository/base.js +23 -0
  164. package/lib/database/repository/executionRepository.d.ts +64 -0
  165. package/lib/database/repository/executionRepository.js +379 -0
  166. package/lib/database/repository/handleRepository.d.ts +35 -0
  167. package/lib/database/repository/handleRepository.js +57 -0
  168. package/lib/database/repository/index.d.ts +20 -0
  169. package/lib/database/repository/index.js +17 -0
  170. package/lib/database/repository/messageRepository.d.ts +33 -0
  171. package/lib/database/repository/messageRepository.js +45 -0
  172. package/lib/database/repository/objectRepository.d.ts +43 -0
  173. package/lib/database/repository/objectRepository.js +60 -0
  174. package/lib/database/repository/outboxRepository.d.ts +15 -0
  175. package/lib/database/repository/outboxRepository.js +51 -0
  176. package/lib/database/repository/processRepository.d.ts +31 -0
  177. package/lib/database/repository/processRepository.js +48 -0
  178. package/lib/database/repository/registryRepository.d.ts +72 -0
  179. package/lib/database/repository/registryRepository.js +95 -0
  180. package/lib/database/repository/repository.d.ts +322 -0
  181. package/lib/database/repository/repository.js +332 -0
  182. package/lib/database/repository/runtimeApprovalRepository.d.ts +14 -0
  183. package/lib/database/repository/runtimeApprovalRepository.js +35 -0
  184. package/lib/database/repository/runtimeSessionRepository.d.ts +9 -0
  185. package/lib/database/repository/runtimeSessionRepository.js +21 -0
  186. package/lib/database/repository/runtimeTurnRepository.d.ts +10 -0
  187. package/lib/database/repository/runtimeTurnRepository.js +32 -0
  188. package/lib/database/repository/socialRepository.d.ts +22 -0
  189. package/lib/database/repository/socialRepository.js +155 -0
  190. package/lib/database/repository/threadRepository.d.ts +29 -0
  191. package/lib/database/repository/threadRepository.js +48 -0
  192. package/lib/database/repository/windowRepository.d.ts +46 -0
  193. package/lib/database/repository/windowRepository.js +68 -0
  194. package/lib/database/repository/workerRepository.d.ts +38 -0
  195. package/lib/database/repository/workerRepository.js +61 -0
  196. package/lib/database/service/database.d.ts +55 -0
  197. package/lib/database/service/database.js +77 -0
  198. package/lib/database/service/handleService.d.ts +20 -0
  199. package/lib/database/service/handleService.js +34 -0
  200. package/lib/database/service/index.d.ts +16 -0
  201. package/lib/database/service/index.js +11 -0
  202. package/lib/database/service/messageService.d.ts +26 -0
  203. package/lib/database/service/messageService.js +40 -0
  204. package/lib/database/service/objectService.d.ts +32 -0
  205. package/lib/database/service/objectService.js +31 -0
  206. package/lib/database/service/processService.d.ts +22 -0
  207. package/lib/database/service/processService.js +45 -0
  208. package/lib/database/service/registryServices.d.ts +43 -0
  209. package/lib/database/service/registryServices.js +60 -0
  210. package/lib/database/service/service.d.ts +131 -0
  211. package/lib/database/service/service.js +153 -0
  212. package/lib/database/service/stepService.d.ts +23 -0
  213. package/lib/database/service/stepService.js +35 -0
  214. package/lib/database/service/threadService.d.ts +23 -0
  215. package/lib/database/service/threadService.js +48 -0
  216. package/lib/database/service/windowService.d.ts +15 -0
  217. package/lib/database/service/windowService.js +22 -0
  218. package/lib/database/service/workerService.d.ts +28 -0
  219. package/lib/database/service/workerService.js +34 -0
  220. package/lib/database/sql/index.d.ts +3 -0
  221. package/lib/database/sql/index.js +2 -0
  222. package/lib/database/sql/schema.d.ts +5 -0
  223. package/lib/database/sql/schema.js +416 -0
  224. package/lib/database/sql/sql.d.ts +290 -0
  225. package/lib/database/sql/sql.js +430 -0
  226. package/lib/database/store/database.d.ts +75 -0
  227. package/lib/database/store/database.js +143 -0
  228. package/lib/database/store/index.d.ts +3 -0
  229. package/lib/database/store/index.js +2 -0
  230. package/lib/database/store/store.d.ts +145 -0
  231. package/lib/database/store/store.js +192 -0
  232. package/lib/delegate/index.d.ts +2 -0
  233. package/lib/delegate/index.js +2 -0
  234. package/lib/delegate/team.d.ts +92 -0
  235. package/lib/delegate/team.js +200 -0
  236. package/lib/delegate/teamTypes.d.ts +43 -0
  237. package/lib/delegate/teamTypes.js +1 -0
  238. package/lib/diagnosis/checklist.d.ts +16 -0
  239. package/lib/diagnosis/checklist.js +61 -0
  240. package/lib/diagnosis/context.d.ts +19 -0
  241. package/lib/diagnosis/context.js +79 -0
  242. package/lib/diagnosis/frame.d.ts +34 -0
  243. package/lib/diagnosis/frame.js +230 -0
  244. package/lib/diagnosis/index.d.ts +5 -0
  245. package/lib/diagnosis/index.js +5 -0
  246. package/lib/diagnosis/router.d.ts +22 -0
  247. package/lib/diagnosis/router.js +47 -0
  248. package/lib/diagnosis/types.d.ts +78 -0
  249. package/lib/diagnosis/types.js +2 -0
  250. package/lib/error/agentError.d.ts +9 -0
  251. package/lib/error/agentError.js +13 -0
  252. package/lib/error/ampError.d.ts +14 -0
  253. package/lib/error/ampError.js +19 -0
  254. package/lib/error/authzError.d.ts +10 -0
  255. package/lib/error/authzError.js +11 -0
  256. package/lib/error/boundaryRejection.d.ts +16 -0
  257. package/lib/error/boundaryRejection.js +14 -0
  258. package/lib/error/index.d.ts +7 -0
  259. package/lib/error/index.js +7 -0
  260. package/lib/error/kernelError.d.ts +11 -0
  261. package/lib/error/kernelError.js +12 -0
  262. package/lib/error/mailboxError.d.ts +5 -0
  263. package/lib/error/mailboxError.js +6 -0
  264. package/lib/error/windowError.d.ts +8 -0
  265. package/lib/error/windowError.js +9 -0
  266. package/lib/evaluation/agreement.d.ts +22 -0
  267. package/lib/evaluation/agreement.js +82 -0
  268. package/lib/evaluation/index.d.ts +2 -0
  269. package/lib/evaluation/index.js +2 -0
  270. package/lib/evaluation/labels.d.ts +56 -0
  271. package/lib/evaluation/labels.js +206 -0
  272. package/lib/evidence/evidenceGraph.d.ts +37 -0
  273. package/lib/evidence/evidenceGraph.js +165 -0
  274. package/lib/evidence/index.d.ts +4 -0
  275. package/lib/evidence/index.js +2 -0
  276. package/lib/evidence/revalidation.d.ts +70 -0
  277. package/lib/evidence/revalidation.js +146 -0
  278. package/lib/execution/exec.d.ts +151 -0
  279. package/lib/execution/exec.js +282 -0
  280. package/lib/execution/handles.d.ts +25 -0
  281. package/lib/execution/handles.js +45 -0
  282. package/lib/execution/index.d.ts +3 -0
  283. package/lib/execution/index.js +3 -0
  284. package/lib/execution/pin.d.ts +60 -0
  285. package/lib/execution/pin.js +103 -0
  286. package/lib/frame/frame.d.ts +61 -0
  287. package/lib/frame/frame.js +1 -0
  288. package/lib/frame/index.d.ts +1 -0
  289. package/lib/frame/index.js +1 -0
  290. package/lib/goal/goal.d.ts +19 -0
  291. package/lib/goal/goal.js +21 -0
  292. package/lib/goal/index.d.ts +2 -0
  293. package/lib/goal/index.js +1 -0
  294. package/lib/goal/plan.d.ts +125 -0
  295. package/lib/goal/plan.js +60 -0
  296. package/lib/governance/attentionManifest.d.ts +279 -0
  297. package/lib/governance/attentionManifest.js +467 -0
  298. package/lib/governance/audit.d.ts +123 -0
  299. package/lib/governance/audit.js +263 -0
  300. package/lib/governance/budget.d.ts +219 -0
  301. package/lib/governance/budget.js +424 -0
  302. package/lib/governance/context.d.ts +159 -0
  303. package/lib/governance/context.js +229 -0
  304. package/lib/governance/control.d.ts +65 -0
  305. package/lib/governance/control.js +89 -0
  306. package/lib/governance/cooperation.d.ts +163 -0
  307. package/lib/governance/cooperation.js +350 -0
  308. package/lib/governance/credential.d.ts +117 -0
  309. package/lib/governance/credential.js +229 -0
  310. package/lib/governance/httpServer.d.ts +18 -0
  311. package/lib/governance/httpServer.js +74 -0
  312. package/lib/governance/index.d.ts +32 -0
  313. package/lib/governance/index.js +32 -0
  314. package/lib/governance/legal.d.ts +222 -0
  315. package/lib/governance/legal.js +371 -0
  316. package/lib/governance/matrix.d.ts +170 -0
  317. package/lib/governance/matrix.js +365 -0
  318. package/lib/governance/perspectives.d.ts +98 -0
  319. package/lib/governance/perspectives.js +340 -0
  320. package/lib/governance/signing.d.ts +131 -0
  321. package/lib/governance/signing.js +241 -0
  322. package/lib/governance/store.d.ts +33 -0
  323. package/lib/governance/store.js +89 -0
  324. package/lib/governance/switching.d.ts +183 -0
  325. package/lib/governance/switching.js +257 -0
  326. package/lib/governance/toolPolicy.d.ts +37 -0
  327. package/lib/governance/toolPolicy.js +42 -0
  328. package/lib/governance/transport.d.ts +76 -0
  329. package/lib/governance/transport.js +124 -0
  330. package/lib/governance/types.d.ts +218 -0
  331. package/lib/governance/types.js +72 -0
  332. package/lib/governance/workflow.d.ts +174 -0
  333. package/lib/governance/workflow.js +612 -0
  334. package/lib/index.d.ts +11 -0
  335. package/lib/index.js +11 -0
  336. package/lib/interaction/index.d.ts +1 -0
  337. package/lib/interaction/index.js +1 -0
  338. package/lib/interaction/interaction.d.ts +83 -0
  339. package/lib/interaction/interaction.js +256 -0
  340. package/lib/ipc/index.d.ts +4 -0
  341. package/lib/ipc/index.js +3 -0
  342. package/lib/ipc/mailbox.d.ts +37 -0
  343. package/lib/ipc/mailbox.js +77 -0
  344. package/lib/ipc/memorySocialStore.d.ts +14 -0
  345. package/lib/ipc/memorySocialStore.js +83 -0
  346. package/lib/ipc/social.d.ts +80 -0
  347. package/lib/ipc/social.js +1 -0
  348. package/lib/kernel/index.d.ts +2 -0
  349. package/lib/kernel/index.js +1 -0
  350. package/lib/kernel/scheduler.d.ts +195 -0
  351. package/lib/kernel/scheduler.js +334 -0
  352. package/lib/ledger/checkpoint.d.ts +116 -0
  353. package/lib/ledger/checkpoint.js +223 -0
  354. package/lib/ledger/index.d.ts +4 -0
  355. package/lib/ledger/index.js +4 -0
  356. package/lib/ledger/ledger.d.ts +21 -0
  357. package/lib/ledger/ledger.js +23 -0
  358. package/lib/ledger/persistence.d.ts +46 -0
  359. package/lib/ledger/persistence.js +106 -0
  360. package/lib/ledger/share.d.ts +29 -0
  361. package/lib/ledger/share.js +39 -0
  362. package/lib/lock/index.d.ts +2 -0
  363. package/lib/lock/index.js +1 -0
  364. package/lib/lock/lease.d.ts +23 -0
  365. package/lib/lock/lease.js +42 -0
  366. package/lib/manifest/agentCard.d.ts +35 -0
  367. package/lib/manifest/agentCard.js +38 -0
  368. package/lib/manifest/cardSign.d.ts +25 -0
  369. package/lib/manifest/cardSign.js +70 -0
  370. package/lib/manifest/federation.d.ts +64 -0
  371. package/lib/manifest/federation.js +187 -0
  372. package/lib/manifest/federationTypes.d.ts +51 -0
  373. package/lib/manifest/federationTypes.js +1 -0
  374. package/lib/manifest/index.d.ts +8 -0
  375. package/lib/manifest/index.js +8 -0
  376. package/lib/manifest/keys.d.ts +221 -0
  377. package/lib/manifest/keys.js +484 -0
  378. package/lib/manifest/manifest.d.ts +102 -0
  379. package/lib/manifest/manifest.js +1 -0
  380. package/lib/manifest/sign.d.ts +38 -0
  381. package/lib/manifest/sign.js +90 -0
  382. package/lib/manifest/trust.d.ts +54 -0
  383. package/lib/manifest/trust.js +87 -0
  384. package/lib/mission/index.d.ts +2 -0
  385. package/lib/mission/index.js +1 -0
  386. package/lib/mission/missionQueue.d.ts +19 -0
  387. package/lib/mission/missionQueue.js +62 -0
  388. package/lib/module/index.d.ts +9 -0
  389. package/lib/module/index.js +9 -0
  390. package/lib/module/llm/deepseek.d.ts +43 -0
  391. package/lib/module/llm/deepseek.js +162 -0
  392. package/lib/module/llm/llm.d.ts +64 -0
  393. package/lib/module/llm/llm.js +16 -0
  394. package/lib/module/mcp/client.d.ts +32 -0
  395. package/lib/module/mcp/client.js +84 -0
  396. package/lib/module/mcp/http.d.ts +32 -0
  397. package/lib/module/mcp/http.js +83 -0
  398. package/lib/module/mcp/protocol.d.ts +62 -0
  399. package/lib/module/mcp/protocol.js +20 -0
  400. package/lib/module/mcp/server.d.ts +22 -0
  401. package/lib/module/mcp/server.js +138 -0
  402. package/lib/module/mcp/transport.d.ts +19 -0
  403. package/lib/module/mcp/transport.js +16 -0
  404. package/lib/module/mcp/workspaceServer.d.ts +20 -0
  405. package/lib/module/mcp/workspaceServer.js +90 -0
  406. package/lib/module/sandbox/sandbox.d.ts +24 -0
  407. package/lib/module/sandbox/sandbox.js +5 -0
  408. package/lib/module/tool/mcpExecutor.d.ts +18 -0
  409. package/lib/module/tool/mcpExecutor.js +41 -0
  410. package/lib/module/tool/policy.d.ts +30 -0
  411. package/lib/module/tool/policy.js +23 -0
  412. package/lib/module/tool/redact.d.ts +9 -0
  413. package/lib/module/tool/redact.js +19 -0
  414. package/lib/module/tool/tool.d.ts +26 -0
  415. package/lib/module/tool/tool.js +24 -0
  416. package/lib/module/tool/workspaceExecutor.d.ts +12 -0
  417. package/lib/module/tool/workspaceExecutor.js +25 -0
  418. package/lib/policy/guard.d.ts +115 -0
  419. package/lib/policy/guard.js +154 -0
  420. package/lib/policy/index.d.ts +2 -0
  421. package/lib/policy/index.js +2 -0
  422. package/lib/policy/policy.d.ts +249 -0
  423. package/lib/policy/policy.js +364 -0
  424. package/lib/process/agent.d.ts +295 -0
  425. package/lib/process/agent.js +1 -0
  426. package/lib/process/agentService.d.ts +87 -0
  427. package/lib/process/agentService.js +128 -0
  428. package/lib/process/agentStore.d.ts +35 -0
  429. package/lib/process/agentStore.js +328 -0
  430. package/lib/process/executionStore.d.ts +79 -0
  431. package/lib/process/executionStore.js +71 -0
  432. package/lib/process/index.d.ts +5 -0
  433. package/lib/process/index.js +5 -0
  434. package/lib/process/process.d.ts +120 -0
  435. package/lib/process/process.js +111 -0
  436. package/lib/process/transitions.d.ts +11 -0
  437. package/lib/process/transitions.js +8 -0
  438. package/lib/progress/index.d.ts +2 -0
  439. package/lib/progress/index.js +1 -0
  440. package/lib/progress/progress.d.ts +26 -0
  441. package/lib/progress/progress.js +42 -0
  442. package/lib/protocol/a2a.d.ts +51 -0
  443. package/lib/protocol/a2a.js +79 -0
  444. package/lib/protocol/channel.d.ts +25 -0
  445. package/lib/protocol/channel.js +27 -0
  446. package/lib/protocol/envelope.d.ts +180 -0
  447. package/lib/protocol/envelope.js +495 -0
  448. package/lib/protocol/httpChannel.d.ts +33 -0
  449. package/lib/protocol/httpChannel.js +59 -0
  450. package/lib/protocol/index.d.ts +6 -0
  451. package/lib/protocol/index.js +6 -0
  452. package/lib/protocol/protocol.d.ts +120 -0
  453. package/lib/protocol/protocol.js +1 -0
  454. package/lib/protocol/wire.d.ts +12 -0
  455. package/lib/protocol/wire.js +55 -0
  456. package/lib/receipt/index.d.ts +1 -0
  457. package/lib/receipt/index.js +1 -0
  458. package/lib/receipt/receipt.d.ts +43 -0
  459. package/lib/receipt/receipt.js +1 -0
  460. package/lib/registry/content.d.ts +10 -0
  461. package/lib/registry/content.js +58 -0
  462. package/lib/registry/index.d.ts +4 -0
  463. package/lib/registry/index.js +2 -0
  464. package/lib/registry/registry.d.ts +109 -0
  465. package/lib/registry/registry.js +299 -0
  466. package/lib/runtime/action.d.ts +46 -0
  467. package/lib/runtime/action.js +39 -0
  468. package/lib/runtime/behavior.d.ts +110 -0
  469. package/lib/runtime/behavior.js +179 -0
  470. package/lib/runtime/behaviorTuning.d.ts +59 -0
  471. package/lib/runtime/behaviorTuning.js +95 -0
  472. package/lib/runtime/cognitiveRuntime.d.ts +189 -0
  473. package/lib/runtime/cognitiveRuntime.js +490 -0
  474. package/lib/runtime/escalation.d.ts +22 -0
  475. package/lib/runtime/escalation.js +15 -0
  476. package/lib/runtime/governedTask.d.ts +57 -0
  477. package/lib/runtime/governedTask.js +150 -0
  478. package/lib/runtime/index.d.ts +15 -0
  479. package/lib/runtime/index.js +15 -0
  480. package/lib/runtime/kernelRuntime.d.ts +33 -0
  481. package/lib/runtime/kernelRuntime.js +105 -0
  482. package/lib/runtime/operation.d.ts +30 -0
  483. package/lib/runtime/operation.js +1 -0
  484. package/lib/runtime/replay.d.ts +24 -0
  485. package/lib/runtime/replay.js +38 -0
  486. package/lib/runtime/routing.d.ts +12 -0
  487. package/lib/runtime/routing.js +44 -0
  488. package/lib/runtime/safety.d.ts +15 -0
  489. package/lib/runtime/safety.js +28 -0
  490. package/lib/runtime/session.d.ts +147 -0
  491. package/lib/runtime/session.js +214 -0
  492. package/lib/runtime/sessionStore.d.ts +24 -0
  493. package/lib/runtime/sessionStore.js +20 -0
  494. package/lib/runtime/telemetry.d.ts +24 -0
  495. package/lib/runtime/telemetry.js +33 -0
  496. package/lib/runtime/turnStore.d.ts +16 -0
  497. package/lib/runtime/turnStore.js +15 -0
  498. package/lib/scenario/index.d.ts +1 -0
  499. package/lib/scenario/index.js +1 -0
  500. package/lib/scenario/scenario.d.ts +52 -0
  501. package/lib/scenario/scenario.js +210 -0
  502. package/lib/semantic/canonical.d.ts +6 -0
  503. package/lib/semantic/canonical.js +22 -0
  504. package/lib/semantic/index.d.ts +2 -0
  505. package/lib/semantic/index.js +2 -0
  506. package/lib/semantic/sha256.d.ts +1 -0
  507. package/lib/semantic/sha256.js +66 -0
  508. package/lib/storage/appendLog.d.ts +145 -0
  509. package/lib/storage/appendLog.js +299 -0
  510. package/lib/storage/fileAppendSink.d.ts +7 -0
  511. package/lib/storage/fileAppendSink.js +34 -0
  512. package/lib/storage/index.d.ts +2 -0
  513. package/lib/storage/index.js +2 -0
  514. package/lib/store/bindCache.d.ts +9 -0
  515. package/lib/store/bindCache.js +18 -0
  516. package/lib/store/cache.d.ts +48 -0
  517. package/lib/store/cache.js +162 -0
  518. package/lib/store/context.d.ts +10 -0
  519. package/lib/store/context.js +27 -0
  520. package/lib/store/handleStore.d.ts +9 -0
  521. package/lib/store/handleStore.js +25 -0
  522. package/lib/store/index.d.ts +9 -0
  523. package/lib/store/index.js +8 -0
  524. package/lib/store/messageStore.d.ts +9 -0
  525. package/lib/store/messageStore.js +25 -0
  526. package/lib/store/objectStore.d.ts +9 -0
  527. package/lib/store/objectStore.js +25 -0
  528. package/lib/store/processStore.d.ts +9 -0
  529. package/lib/store/processStore.js +25 -0
  530. package/lib/store/threadStore.d.ts +9 -0
  531. package/lib/store/threadStore.js +25 -0
  532. package/lib/store/windowStore.d.ts +9 -0
  533. package/lib/store/windowStore.js +25 -0
  534. package/lib/structure/abstractSyntaxTree.d.ts +181 -0
  535. package/lib/structure/abstractSyntaxTree.js +400 -0
  536. package/lib/structure/avlTree.d.ts +125 -0
  537. package/lib/structure/avlTree.js +369 -0
  538. package/lib/structure/binarySearchTree.d.ts +125 -0
  539. package/lib/structure/binarySearchTree.js +306 -0
  540. package/lib/structure/binaryTree.d.ts +174 -0
  541. package/lib/structure/binaryTree.js +495 -0
  542. package/lib/structure/bloomFilter.d.ts +126 -0
  543. package/lib/structure/bloomFilter.js +177 -0
  544. package/lib/structure/compare.d.ts +55 -0
  545. package/lib/structure/compare.js +96 -0
  546. package/lib/structure/cuckooFilter.d.ts +149 -0
  547. package/lib/structure/cuckooFilter.js +267 -0
  548. package/lib/structure/deque.d.ts +117 -0
  549. package/lib/structure/deque.js +205 -0
  550. package/lib/structure/filterKey.d.ts +19 -0
  551. package/lib/structure/filterKey.js +28 -0
  552. package/lib/structure/hash.d.ts +129 -0
  553. package/lib/structure/hash.js +241 -0
  554. package/lib/structure/heap.d.ts +152 -0
  555. package/lib/structure/heap.js +227 -0
  556. package/lib/structure/index.d.ts +20 -0
  557. package/lib/structure/index.js +20 -0
  558. package/lib/structure/iterator.d.ts +6 -0
  559. package/lib/structure/iterator.js +16 -0
  560. package/lib/structure/lru.d.ts +235 -0
  561. package/lib/structure/lru.js +524 -0
  562. package/lib/structure/ordered.d.ts +89 -0
  563. package/lib/structure/ordered.js +336 -0
  564. package/lib/structure/priority.d.ts +499 -0
  565. package/lib/structure/priority.js +756 -0
  566. package/lib/structure/queue.d.ts +90 -0
  567. package/lib/structure/queue.js +154 -0
  568. package/lib/structure/redBlackTree.d.ts +142 -0
  569. package/lib/structure/redBlackTree.js +644 -0
  570. package/lib/structure/segmentTree.d.ts +129 -0
  571. package/lib/structure/segmentTree.js +205 -0
  572. package/lib/structure/stack.d.ts +77 -0
  573. package/lib/structure/stack.js +107 -0
  574. package/lib/structure/unordered.d.ts +99 -0
  575. package/lib/structure/unordered.js +341 -0
  576. package/lib/thread/index.d.ts +2 -0
  577. package/lib/thread/index.js +2 -0
  578. package/lib/thread/thread.d.ts +107 -0
  579. package/lib/thread/thread.js +81 -0
  580. package/lib/thread/transitions.d.ts +8 -0
  581. package/lib/thread/transitions.js +9 -0
  582. package/lib/types/common.d.ts +80 -0
  583. package/lib/types/common.js +5 -0
  584. package/lib/types/index.d.ts +23 -0
  585. package/lib/types/index.js +1 -0
  586. package/lib/warrant/epistemic.d.ts +141 -0
  587. package/lib/warrant/epistemic.js +1 -0
  588. package/lib/warrant/index.d.ts +3 -0
  589. package/lib/warrant/index.js +3 -0
  590. package/lib/warrant/inquiry.d.ts +69 -0
  591. package/lib/warrant/inquiry.js +119 -0
  592. package/lib/warrant/warrant.d.ts +46 -0
  593. package/lib/warrant/warrant.js +153 -0
  594. package/lib/window/compaction.d.ts +57 -0
  595. package/lib/window/compaction.js +334 -0
  596. package/lib/window/compactionTypes.d.ts +113 -0
  597. package/lib/window/compactionTypes.js +1 -0
  598. package/lib/window/index.d.ts +7 -0
  599. package/lib/window/index.js +3 -0
  600. package/lib/window/page.d.ts +16 -0
  601. package/lib/window/page.js +2 -0
  602. package/lib/window/window.d.ts +68 -0
  603. package/lib/window/window.js +194 -0
  604. package/package.json +22 -1
  605. package/src/authz/index.ts +1 -0
  606. package/src/concept/index.ts +3 -0
  607. package/src/concurrency/index.ts +5 -0
  608. package/src/cooperation/index.ts +6 -0
  609. package/src/delegate/index.ts +2 -0
  610. package/src/error/index.ts +7 -0
  611. package/src/evaluation/index.ts +2 -0
  612. package/src/execution/index.ts +3 -0
  613. package/src/frame/index.ts +1 -0
  614. package/src/index.ts +11 -0
  615. package/src/ledger/index.ts +4 -0
  616. package/src/manifest/index.ts +8 -0
  617. package/src/policy/index.ts +2 -0
  618. package/src/protocol/index.ts +6 -0
  619. package/src/receipt/index.ts +1 -0
  620. package/src/semantic/index.ts +2 -0
  621. package/src/storage/index.ts +2 -0
  622. package/src/structure/index.ts +20 -0
  623. package/src/thread/index.ts +2 -0
  624. package/src/warrant/index.ts +3 -0
  625. package/src/window/index.ts +7 -4
  626. package/tools/rewrite-declaration-extensions.ts +98 -0
  627. package/tsconfig.build.json +14 -0
@@ -0,0 +1,229 @@
1
+ import { GovernanceError } from "./types.js";
2
+ import { perspective } from "./perspectives.js";
3
+ import { digestOf } from "../semantic/canonical.js";
4
+ const ReadersOfEverything = ["general-manager", "board", "supervisory", "legal"];
5
+ export class ContextLayers {
6
+ core;
7
+ now;
8
+ privateContexts = new Map();
9
+ receipts = [];
10
+ active;
11
+ counter = 0;
12
+ constructor(options) {
13
+ if (typeof (options.now) !== "function") {
14
+ throw new TypeError("ContextLayers requires a clock");
15
+ }
16
+ this.now = options.now;
17
+ this.core = copyCore(options.core);
18
+ }
19
+ /**
20
+ * The default view: summary only, no full board record.
21
+ */
22
+ global(viewer) {
23
+ perspective(viewer);
24
+ return {
25
+ goal: this.core.goal,
26
+ strategyVersion: this.core.strategy.version,
27
+ strategyDigest: this.core.strategy.digest,
28
+ strategySummary: this.core.strategy.summary,
29
+ constraints: [...this.core.constraints],
30
+ priorities: [...this.core.priorities],
31
+ taskState: this.core.taskState,
32
+ scenario: this.core.scenario,
33
+ modes: { ...this.core.modes },
34
+ budget: { ...this.core.budget },
35
+ version: this.core.version,
36
+ };
37
+ }
38
+ /**
39
+ * Expand the full board record on demand. The access is not hidden: the
40
+ * caller records it in its own receipt.
41
+ */
42
+ expandGlobal(viewer) {
43
+ perspective(viewer);
44
+ return copyCore(this.core);
45
+ }
46
+ /**
47
+ * Only the board or a human may write the global core. The change bumps
48
+ * the version so every perspective can detect that its assumption is stale.
49
+ */
50
+ writeGlobal(by, patch, approval) {
51
+ if (by !== "human" && by !== "board") {
52
+ throw new GovernanceError("context-denied", `${by} may not write the global core`);
53
+ }
54
+ if (by === "board" && approval !== (void 0) && (approval.granted !== true || approval.subject !== "board.write" || approval.by !== "board")) {
55
+ throw new GovernanceError("context-denied", "the board write approval is not valid");
56
+ }
57
+ this.core = copyCore({ ...this.core, ...patch, version: this.core.version + 1 });
58
+ return copyCore(this.core);
59
+ }
60
+ /**
61
+ * Open a perspective's private context and seal the previously active one.
62
+ * The caller cannot keep reading the old view through this object.
63
+ */
64
+ openPerspective(id, manifest) {
65
+ if (this.active !== (void 0) && this.active !== id) {
66
+ this.seal(this.active);
67
+ }
68
+ this.active = id;
69
+ const existing = this.privateContexts.get(id);
70
+ if (existing !== (void 0)) {
71
+ existing.manifest = { ...manifest };
72
+ existing.sealed = false;
73
+ return copyPrivate(existing);
74
+ }
75
+ const context = {
76
+ perspective: id,
77
+ manifest: { ...manifest },
78
+ notes: [],
79
+ openedAt: this.now(),
80
+ sealed: false,
81
+ };
82
+ this.privateContexts.set(id, context);
83
+ return copyPrivate(context);
84
+ }
85
+ seal(id) {
86
+ if (id === (void 0)) {
87
+ return;
88
+ }
89
+ const context = this.privateContexts.get(id);
90
+ if (context !== (void 0)) {
91
+ context.sealed = true;
92
+ }
93
+ if (this.active === id) {
94
+ this.active = undefined;
95
+ }
96
+ }
97
+ /**
98
+ * Append a private note. Only the owner of an open context may write it.
99
+ */
100
+ writePrivate(id, note) {
101
+ const context = this.privateContexts.get(id);
102
+ if (context === (void 0) || context.sealed) {
103
+ throw new GovernanceError("context-denied", `${id} has no open private context`);
104
+ }
105
+ if (this.active !== id) {
106
+ throw new GovernanceError("context-denied", `${id} is not the active perspective`);
107
+ }
108
+ context.notes.push({ ...note, ...(note.refs === (void 0) ? {} : { refs: note.refs.map((ref) => ({ ...ref })) }) });
109
+ return copyPrivate(context);
110
+ }
111
+ /**
112
+ * Read a private context. Only the owner may read it, sealed or not.
113
+ */
114
+ readPrivate(id, viewer) {
115
+ if (id !== viewer) {
116
+ throw new GovernanceError("context-denied", `${viewer} may not read ${id}'s private context`);
117
+ }
118
+ const context = this.privateContexts.get(id);
119
+ return context === (void 0) ? undefined : copyPrivate(context);
120
+ }
121
+ /**
122
+ * Write one receipt to the shared blackboard. The writer must be the active
123
+ * perspective and the receipt must match its manifest version.
124
+ */
125
+ writeReceipt(from, input) {
126
+ if (this.active !== from) {
127
+ throw new GovernanceError("context-denied", `${from} is not the active perspective`);
128
+ }
129
+ if (input.conclusion.trim().length === 0) {
130
+ throw new GovernanceError("context-denied", "a receipt needs a conclusion");
131
+ }
132
+ if (!Number.isFinite(input.confidence) || input.confidence < 0 || input.confidence > 1) {
133
+ throw new GovernanceError("context-denied", "confidence must be in [0, 1]");
134
+ }
135
+ const manifest = this.privateContexts.get(from);
136
+ if (manifest !== (void 0) && (manifest.manifest.id !== input.manifest.id || manifest.manifest.version !== input.manifest.version)) {
137
+ throw new GovernanceError("manifest-version-conflict", `receipt cites ${input.manifest.id} v${input.manifest.version}`);
138
+ }
139
+ this.counter += 1;
140
+ const unsigned = {
141
+ id: `rcp.${this.counter}`,
142
+ from,
143
+ at: this.now(),
144
+ conclusion: input.conclusion,
145
+ evidence: input.evidence.map((ref) => ({ ...ref })),
146
+ confidence: input.confidence,
147
+ budget: { ...input.budget },
148
+ manifest: { ...input.manifest },
149
+ scenario: input.scenario,
150
+ modes: { ...input.modes },
151
+ openQuestions: [...(input.openQuestions ?? [])],
152
+ ...(input.escalation === (void 0) ? {} : { escalation: { ...input.escalation } }),
153
+ ...(input.audience === (void 0) ? {} : { audience: [...input.audience] }),
154
+ };
155
+ const receipt = { ...unsigned, digest: digestOf(unsigned) };
156
+ this.receipts.push(receipt);
157
+ return copyReceipt(receipt);
158
+ }
159
+ /**
160
+ * The blackboard is not public: the management and audit perspectives see
161
+ * everything, execution perspectives see their own receipts and receipts
162
+ * addressed to them.
163
+ */
164
+ readReceipts(viewer) {
165
+ const all = ReadersOfEverything.includes(viewer);
166
+ return this.receipts.filter((receipt) => all || receipt.from === viewer || (receipt.audience ?? []).includes(viewer)).map(copyReceipt);
167
+ }
168
+ readReceipt(id, viewer) {
169
+ const receipt = this.receipts.find((entry) => entry.id === id);
170
+ if (receipt === (void 0)) {
171
+ return undefined;
172
+ }
173
+ const all = ReadersOfEverything.includes(viewer);
174
+ if (!all && receipt.from !== viewer && !(receipt.audience ?? []).includes(viewer)) {
175
+ throw new GovernanceError("context-denied", `${viewer} may not read ${id}`);
176
+ }
177
+ return copyReceipt(receipt);
178
+ }
179
+ /**
180
+ * Receipts that requested escalation, used by the workflow's escalation
181
+ * phase.
182
+ */
183
+ escalations() {
184
+ return this.receipts.filter((receipt) => receipt.escalation !== (void 0)).map(copyReceipt);
185
+ }
186
+ snapshot() {
187
+ return {
188
+ core: copyCore(this.core),
189
+ privateContexts: [...this.privateContexts.values()].map((context) => ({
190
+ perspective: context.perspective,
191
+ notes: context.notes.length,
192
+ sealed: context.sealed,
193
+ })),
194
+ receipts: this.receipts.map(copyReceipt),
195
+ version: this.core.version,
196
+ };
197
+ }
198
+ }
199
+ const copyCore = (core) => ({
200
+ goal: core.goal,
201
+ strategy: { ...core.strategy },
202
+ constraints: [...core.constraints],
203
+ priorities: [...core.priorities],
204
+ taskState: core.taskState,
205
+ scenario: core.scenario,
206
+ modes: { ...core.modes },
207
+ budget: { ...core.budget },
208
+ version: core.version,
209
+ });
210
+ const copyReceipt = (receipt) => ({
211
+ ...receipt,
212
+ evidence: receipt.evidence.map((ref) => ({ ...ref })),
213
+ budget: { ...receipt.budget },
214
+ manifest: { ...receipt.manifest },
215
+ modes: { ...receipt.modes },
216
+ openQuestions: [...receipt.openQuestions],
217
+ ...(receipt.escalation === (void 0) ? {} : { escalation: { ...receipt.escalation } }),
218
+ ...(receipt.audience === (void 0) ? {} : { audience: [...receipt.audience] }),
219
+ });
220
+ const copyPrivate = (context) => ({
221
+ perspective: context.perspective,
222
+ manifest: { ...context.manifest },
223
+ notes: context.notes.map((note) => ({
224
+ ...note,
225
+ ...(note.refs === (void 0) ? {} : { refs: note.refs.map((ref) => ({ ...ref })) }),
226
+ })),
227
+ openedAt: context.openedAt,
228
+ sealed: context.sealed,
229
+ });
@@ -0,0 +1,65 @@
1
+ /**
2
+ * The Bayesian control layer (spec section 6).
3
+ *
4
+ * The posterior does not generate text. It routes attention: it changes mode
5
+ * weights, shrinks or expands the focus set, assigns budget to the observation
6
+ * with the highest information value, and decides when to stop or escalate.
7
+ *
8
+ * Posterior uncertainty raises divergence; confidence raises convergence;
9
+ * evidence conflict raises thinking and may be forced by legal. Probabilities
10
+ * are clamped to [0.001, 0.999] so no single observation can claim certainty.
11
+ */
12
+ import type { BetaBelief } from "../bayes/engine.js";
13
+ import type { ModeId, ModeWeights, PerspectiveId, ScenarioId } from "./types.js";
14
+ export interface ControlObservation {
15
+ scenario: ScenarioId;
16
+ modes: ModeWeights;
17
+ /**
18
+ * The posterior over "this turn is adequate". Alpha/beta counts.
19
+ */
20
+ posterior: BetaBelief;
21
+ /**
22
+ * Set when two evidence items disagree materially.
23
+ */
24
+ conflict?: boolean;
25
+ /**
26
+ * Legal can force the thinking mode on regardless of the posterior.
27
+ */
28
+ legalOverride?: boolean;
29
+ /**
30
+ * Estimated value of the next observation, in [0, 1].
31
+ */
32
+ voi?: number;
33
+ frame?: number;
34
+ openQuestions?: number;
35
+ }
36
+ export interface ControlBudget {
37
+ nextObservationShare: number;
38
+ reason: string;
39
+ }
40
+ export interface ControlDecision {
41
+ modes: ModeWeights;
42
+ action: "expand" | "hold" | "shrink";
43
+ stop: boolean;
44
+ escalate: boolean;
45
+ escalateTo?: PerspectiveId;
46
+ budget: ControlBudget;
47
+ approvalRequired: boolean;
48
+ mean: number;
49
+ uncertainty: number;
50
+ rationale: string[];
51
+ }
52
+ export interface ProbabilityRange {
53
+ min: number;
54
+ max: number;
55
+ }
56
+ export declare const ProbabilityClamp: ProbabilityRange;
57
+ /**
58
+ * One control step. Pure: the caller applies the weights through the manifest
59
+ * update path, where approvals are enforced.
60
+ */
61
+ export declare const decideControl: (observation: ControlObservation) => ControlDecision;
62
+ /**
63
+ * The mode with the largest positive change, for receipts and audit lines.
64
+ */
65
+ export declare const changedMode: (from: ModeWeights, to: ModeWeights) => ModeId;
@@ -0,0 +1,89 @@
1
+ import { betaMean, betaVariance } from "../bayes/engine.js";
2
+ import { GovernanceError, ModeIds } from "./types.js";
3
+ import { driftRequiresApproval, normalizeModeWeights } from "./matrix.js";
4
+ export const ProbabilityClamp = { min: 0.001, max: 0.999 };
5
+ const clampProbability = (value) => Math.max(ProbabilityClamp.min, Math.min(ProbabilityClamp.max, Number.isFinite(value) ? value : ProbabilityClamp.min));
6
+ /**
7
+ * One control step. Pure: the caller applies the weights through the manifest
8
+ * update path, where approvals are enforced.
9
+ */
10
+ export const decideControl = (observation) => {
11
+ if (!Number.isFinite(observation.posterior.alpha) ||
12
+ !Number.isFinite(observation.posterior.beta) ||
13
+ observation.posterior.alpha <= 0 ||
14
+ observation.posterior.beta <= 0) {
15
+ throw new GovernanceError("probability-invalid", "the posterior alpha and beta must be finite and positive");
16
+ }
17
+ const mean = clampProbability(betaMean(observation.posterior));
18
+ const variance = betaVariance(observation.posterior);
19
+ const uncertainty = Math.min(1, Math.max(0, Math.sqrt(Math.max(0, Number.isFinite(variance) ? variance : 0)) * 2));
20
+ const next = { ...observation.modes };
21
+ const rationale = [`posterior mean ${mean.toFixed(2)}, uncertainty ${uncertainty.toFixed(2)}`];
22
+ if (uncertainty > 0.2) {
23
+ const delta = 0.1 * Math.min(1, uncertainty * 2.5);
24
+ next.diverge += delta;
25
+ rationale.push(`uncertainty ${uncertainty.toFixed(2)} raises divergence by ${delta.toFixed(2)}`);
26
+ }
27
+ if (mean > 0.8 && uncertainty < 0.2) {
28
+ next.converge += 0.1;
29
+ rationale.push(`confidence ${mean.toFixed(2)} raises convergence by 0.10`);
30
+ }
31
+ if (observation.conflict === true) {
32
+ next.think += 0.15;
33
+ rationale.push("evidence conflict raises thinking by 0.15; the posterior overrides the prior");
34
+ }
35
+ const forced = observation.legalOverride === true;
36
+ if (forced) {
37
+ next.think += 0.2;
38
+ rationale.push("legal forced the thinking mode on");
39
+ }
40
+ const modes = normalizeModeWeights(next);
41
+ const approvalRequired = driftRequiresApproval(observation.modes, modes);
42
+ if (approvalRequired) {
43
+ rationale.push("the adjustment exceeds 0.15 and needs the general manager's approval");
44
+ }
45
+ const action = uncertainty > 0.2 ? "expand" : mean > 0.8 && uncertainty < 0.2 ? "shrink" : "hold";
46
+ const voi = Math.max(0, Math.min(1, observation.voi ?? 0));
47
+ const share = action === "expand" ? Math.max(0.1, Math.min(0.5, 0.1 + voi * 0.4)) : 0.05;
48
+ const stop = mean >= 0.9 && uncertainty < 0.1 && (observation.openQuestions ?? 0) === 0 && voi < 0.05;
49
+ if (stop) {
50
+ rationale.push("high confidence, no open question and low information value: stop");
51
+ }
52
+ const escalate = forced || uncertainty > 0.45 || (observation.conflict === true && mean < 0.6);
53
+ let escalateTo;
54
+ if (escalate) {
55
+ escalateTo = forced ? "legal" : uncertainty > 0.45 ? "supervisory" : "general-manager";
56
+ rationale.push(`escalate to ${escalateTo}: ${forced ? "legal override" : uncertainty > 0.45 ? "residual uncertainty" : "unresolved evidence conflict"}`);
57
+ }
58
+ return {
59
+ modes,
60
+ action,
61
+ stop,
62
+ escalate,
63
+ ...(escalateTo === (void 0) ? {} : { escalateTo }),
64
+ budget: {
65
+ nextObservationShare: share,
66
+ reason: action === "expand" ? `information value ${voi.toFixed(2)} keeps an exploratory share` : "confidence allows a narrow share",
67
+ },
68
+ approvalRequired,
69
+ mean,
70
+ uncertainty,
71
+ rationale,
72
+ };
73
+ };
74
+ /**
75
+ * The mode with the largest positive change, for receipts and audit lines.
76
+ */
77
+ export const changedMode = (from, to) => {
78
+ let best = ModeIds[0];
79
+ let delta = -1;
80
+ for (let index = 0; index < ModeIds.length; index += 1) {
81
+ const mode = ModeIds[index];
82
+ const change = to[mode] - from[mode];
83
+ if (change > delta) {
84
+ best = mode;
85
+ delta = change;
86
+ }
87
+ }
88
+ return best;
89
+ };
@@ -0,0 +1,163 @@
1
+ /**
2
+ * Multi-agent cooperation (spec section 13).
3
+ *
4
+ * Perspectives become independent agents. What crosses an agent boundary is a
5
+ * structured message: a manifest summary, refs, a credential reference, a
6
+ * receipt summary and scenario/mode labels. Private reasoning, raw context and
7
+ * full payloads stay inside the sender; the receiver validates the credential
8
+ * before it reads anything.
9
+ *
10
+ * The bus also prunes the communication graph. A candidate is scored by its
11
+ * posterior reliability times the information value of talking to it, so a
12
+ * flaky agent is not consulted just because it is reachable.
13
+ */
14
+ import type { Digest, Id, Ref, Timestamp } from "../types/common.js";
15
+ import type { BetaBelief } from "../bayes/engine.js";
16
+ import type { EvidenceFloor, ManifestRef, ModeWeights, PerspectiveId, ScenarioId } from "./types.js";
17
+ import type { AttentionManifest } from "./attentionManifest.js";
18
+ import type { SwitchCredential } from "./credential.js";
19
+ import type { BudgetAccount } from "./budget.js";
20
+ import type { LegalGate } from "./legal.js";
21
+ export interface ManifestSummary {
22
+ id: Id;
23
+ version: number;
24
+ scenario: ScenarioId;
25
+ modes: ModeWeights;
26
+ evidenceFloor: EvidenceFloor;
27
+ focus: number;
28
+ digest: Digest;
29
+ }
30
+ export interface RegisteredAgent {
31
+ agentId: Id;
32
+ perspective: PerspectiveId;
33
+ manifest: AttentionManifest;
34
+ /**
35
+ * The agent's own ledger, usually `scope: "agent"`.
36
+ */
37
+ budget: BudgetAccount;
38
+ reliability: BetaBelief;
39
+ }
40
+ export type MessageKind = "manifest" | "task" | "receipt" | "escalation" | "audit-request";
41
+ export interface ReceiptSummary {
42
+ conclusion: string;
43
+ confidence: number;
44
+ evidence: Ref[];
45
+ manifest: ManifestRef;
46
+ }
47
+ export interface AgentMessageInput {
48
+ from: Id;
49
+ to: Id;
50
+ kind: MessageKind;
51
+ at: Timestamp;
52
+ /**
53
+ * One or two sentences. No private reasoning, no raw context.
54
+ */
55
+ summary?: string;
56
+ refs?: Ref[];
57
+ credential?: SwitchCredential;
58
+ receipt?: ReceiptSummary;
59
+ escalation?: {
60
+ reason: string;
61
+ evidence: Ref[];
62
+ target: PerspectiveId;
63
+ };
64
+ }
65
+ export interface AgentMessage extends AgentMessageInput {
66
+ id: Id;
67
+ manifest: ManifestSummary;
68
+ openQuestions?: string[];
69
+ digest: Digest;
70
+ }
71
+ export type DeliveryCode = "delivered" | "unknown-sender" | "unknown-recipient" | "self-send" | "manifest-invalid" | "credential-missing" | "credential-invalid" | "scope-escape" | "payload-too-large" | "receipt-invalid" | "legal-blocked" | "transport-error";
72
+ export interface Delivery {
73
+ ok: boolean;
74
+ code: DeliveryCode;
75
+ detail: string;
76
+ message?: AgentMessage;
77
+ }
78
+ export interface RouteOptions {
79
+ voi?: Record<Id, number>;
80
+ limit?: number;
81
+ }
82
+ export interface ScoredCandidate {
83
+ id: Id;
84
+ score: number;
85
+ }
86
+ export interface CooperationOptions {
87
+ now: () => Timestamp;
88
+ legal?: LegalGate;
89
+ /**
90
+ * Maximum refs per message; a structured receipt replaces a payload.
91
+ */
92
+ maxRefs?: number;
93
+ /**
94
+ * Maximum characters in `summary`.
95
+ */
96
+ maxSummary?: number;
97
+ }
98
+ export declare const manifestSummaryOf: (manifest: AttentionManifest) => ManifestSummary;
99
+ /**
100
+ * Verify a message digest after transport.
101
+ */
102
+ export declare const verifyAgentMessage: (message: AgentMessage) => boolean;
103
+ export declare class CooperationBus {
104
+ private readonly now;
105
+ private readonly legal?;
106
+ private readonly maxRefs;
107
+ private readonly maxSummary;
108
+ private readonly agents;
109
+ private readonly inboxes;
110
+ private readonly seen;
111
+ private readonly board;
112
+ private counter;
113
+ constructor(options: CooperationOptions);
114
+ register(agent: RegisteredAgent): void;
115
+ /**
116
+ * Replace an agent's manifest after a legitimate re-derivation.
117
+ */
118
+ refresh(agentId: Id, manifest: AttentionManifest): void;
119
+ unregister(agentId: Id): boolean;
120
+ agent(agentId: Id): RegisteredAgent | undefined;
121
+ agentsOf(perspective: PerspectiveId): RegisteredAgent[];
122
+ /**
123
+ * Broadcast a manifest summary. This is the only message that needs no
124
+ * credential: it contains no payload and no private context.
125
+ */
126
+ announce(from: Id, at: Timestamp): Delivery[];
127
+ /**
128
+ * Send one structured message. The sender's manifest and, for task or
129
+ * escalation messages, the credential are validated before delivery.
130
+ */
131
+ send(input: AgentMessageInput): Delivery;
132
+ /**
133
+ * Admit a message that arrived over a transport. The receiver re-verifies
134
+ * the digest, the sender's current manifest, the credential and the receipt
135
+ * version before the message enters the inbox.
136
+ */
137
+ receive(message: AgentMessage): Delivery;
138
+ inbox(agentId: Id, at: Timestamp): Delivery[];
139
+ /**
140
+ * Prune the communication graph: reliability x information value.
141
+ */
142
+ route(from: Id, candidates: readonly Id[], options?: RouteOptions): Id[];
143
+ /**
144
+ * Update a recipient's reliability from an observed outcome.
145
+ */
146
+ observe(agentId: Id, success: boolean, weight?: number): BetaBelief;
147
+ /**
148
+ * The shared, structured board. It contains message summaries, not private
149
+ * reasoning, so supervisory audit can read it without inheriting execution
150
+ * context.
151
+ */
152
+ boardEntries(): AgentMessage[];
153
+ /**
154
+ * An independent audit request: evidence refs only, no receipt body and no
155
+ * private context. The supervisory agent can trace by reference.
156
+ */
157
+ auditRequest(from: Id, evidence: readonly Ref[], at: Timestamp): Delivery;
158
+ /**
159
+ * Convenience: hand a task to a target with a credential.
160
+ */
161
+ handoff(from: Id, to: Id, credential: SwitchCredential, refs: readonly Ref[], at: Timestamp, summary?: string): Delivery;
162
+ nowValue(): Timestamp;
163
+ }