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,141 @@
1
+ /**
2
+ * AMP v0.1 — Warrant Ledger objects: claim | hypothesis | unknown.
3
+ * Mirrors docs/schemas/epistemic.schema.json.
4
+ *
5
+ * Note: `confidence` is DERIVED by the Warrant Engine from `tier` + evidence.
6
+ * It is modelled here for display, never as a field the model may author.
7
+ */
8
+ import type { Budget, Confidence, Digest, Id, Provenance, Ref, Tier, Timestamp, Trust } from "../types/common.js";
9
+ export type ClaimScope = "associational" | "interventional" | "counterfactual" | "definitional";
10
+ export type ClaimStatus = "conjecture" | "held" | "doubted" | "contested" | "retracted";
11
+ export type EvidenceKind = "observation" | "test" | "document" | "testimony" | "memory" | "inference";
12
+ export type Inference = "observation" | "deduction" | "induction" | "abduction" | "testimony" | "simulation";
13
+ export interface EvidenceItem {
14
+ id: Id;
15
+ kind: EvidenceKind;
16
+ trust: Trust;
17
+ /**
18
+ * 0 = same origin as another item, 1 = fully independent. Duplicates are not corroboration.
19
+ */
20
+ independence: Confidence;
21
+ /**
22
+ * Whether this evidence helps, undercuts, or contradicts the claim.
23
+ */
24
+ relation?: "supports" | "undercuts" | "contradicts";
25
+ /**
26
+ * T1 requires `true`: the source must entail the claim, not merely mention it.
27
+ */
28
+ entails?: boolean;
29
+ /**
30
+ * Provenance root; items sharing an origin count as one effective source.
31
+ */
32
+ origin?: string;
33
+ ref?: Ref;
34
+ excerpt?: string;
35
+ digest?: Digest;
36
+ at: Timestamp;
37
+ }
38
+ export interface Warrant {
39
+ evidence: EvidenceItem[];
40
+ inference: Inference;
41
+ /**
42
+ * Duhem–Quine: a refutation always hits a conjunction. Empty array is malformed for a negative result.
43
+ */
44
+ auxiliary_assumptions?: string[];
45
+ strength: Confidence;
46
+ }
47
+ export interface CausalClaim {
48
+ assignment_mechanism: "observed" | "assigned" | "randomized" | "natural_experiment";
49
+ identification_strategy?: string;
50
+ identifying_assumption?: string;
51
+ adjustment_set?: string[];
52
+ dag_digest?: Digest;
53
+ }
54
+ export interface Alternative {
55
+ statement: string;
56
+ confidence: Confidence;
57
+ reason_rejected?: string;
58
+ }
59
+ export interface BaseRate {
60
+ value: Confidence;
61
+ source?: string;
62
+ }
63
+ export interface Claim {
64
+ amp: "0.1";
65
+ kind: "claim";
66
+ id: Id;
67
+ statement: string;
68
+ structured?: {
69
+ subject?: Ref;
70
+ relation?: string;
71
+ value?: unknown;
72
+ };
73
+ claim_scope?: ClaimScope;
74
+ tier: Tier;
75
+ confidence?: Confidence;
76
+ status: ClaimStatus;
77
+ would_be_false_if?: string;
78
+ check_run_id?: string;
79
+ causal?: CausalClaim;
80
+ warrant: Warrant;
81
+ alternatives?: Alternative[];
82
+ disconfirming?: Ref[];
83
+ base_rate?: BaseRate;
84
+ looks?: number;
85
+ scope?: string;
86
+ provenance: Provenance;
87
+ created: Timestamp;
88
+ expires?: Timestamp;
89
+ supersedes?: Ref;
90
+ revision?: {
91
+ reason: string;
92
+ at: Timestamp;
93
+ };
94
+ }
95
+ export type HypothesisStatus = "proposed" | "testing" | "supported" | "refuted" | "inconclusive" | "out_of_scope";
96
+ export interface Prereg {
97
+ hash: Digest;
98
+ registered_at: Timestamp;
99
+ metric: string;
100
+ stopping: string;
101
+ exclusions?: string[];
102
+ looks?: number;
103
+ }
104
+ export interface TestSpec {
105
+ method: string;
106
+ observation: string;
107
+ cost?: Budget;
108
+ }
109
+ export interface Hypothesis {
110
+ amp: "0.1";
111
+ kind: "hypothesis";
112
+ id: Id;
113
+ question: Ref;
114
+ statement: string;
115
+ prediction: string;
116
+ /**
117
+ * The observation that would overturn it. Without this, it is a position, not a hypothesis.
118
+ */
119
+ refutes_if: string;
120
+ auxiliary_assumptions?: string[];
121
+ prereg?: Prereg;
122
+ test?: TestSpec;
123
+ labels?: Array<"confirmatory" | "exploratory" | "replication">;
124
+ status: HypothesisStatus;
125
+ evidence?: Ref[];
126
+ created: Timestamp;
127
+ closed?: Timestamp;
128
+ }
129
+ export interface UnknownItem {
130
+ amp: "0.1";
131
+ kind: "unknown";
132
+ id: Id;
133
+ question: string;
134
+ importance: Confidence;
135
+ blocking: boolean;
136
+ since: Timestamp;
137
+ resolve_cost?: Budget;
138
+ attempts?: Ref[];
139
+ status?: "open" | "probing" | "assumed" | "resolved" | "abandoned";
140
+ }
141
+ export type EpistemicObject = Claim | Hypothesis | UnknownItem;
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,3 @@
1
+ export * from "./epistemic.js";
2
+ export * from "./inquiry.js";
3
+ export * from "./warrant.js";
@@ -0,0 +1,3 @@
1
+ export * from "./epistemic.js";
2
+ export * from "./inquiry.js";
3
+ export * from "./warrant.js";
@@ -0,0 +1,69 @@
1
+ import type { Digest, Id, Timestamp } from "../types/common.js";
2
+ import type { Hypothesis } from "./epistemic.js";
3
+ export interface ExperimentLook {
4
+ value: number;
5
+ at: Timestamp;
6
+ }
7
+ export interface Experiment {
8
+ id: Id;
9
+ hypothesis: Id;
10
+ preregHash: Digest;
11
+ metric: string;
12
+ stopping: string;
13
+ exclusions: string[];
14
+ registeredAt: Timestamp;
15
+ status: "registered" | "running" | "completed" | "abandoned";
16
+ looks: ExperimentLook[];
17
+ verdict?: "supported" | "refuted" | "inconclusive";
18
+ warnings: string[];
19
+ }
20
+ export interface RunContext {
21
+ runId: string;
22
+ seed: string;
23
+ origin: string;
24
+ environment?: string;
25
+ }
26
+ export interface ReplicationVerdict {
27
+ ok: boolean;
28
+ reasons: string[];
29
+ tier: "T3" | "T4";
30
+ }
31
+ /**
32
+ * Content the pre-registration hash must cover. Order is fixed by canonical(); shape is not.
33
+ */
34
+ export declare function preregHashOf(input: {
35
+ statement: string;
36
+ metric: string;
37
+ stopping: string;
38
+ exclusions?: string[];
39
+ }): Digest;
40
+ /**
41
+ * Inquiry log: registration happens before observation, and re-asking is
42
+ * recorded as another look rather than as a fresh, clean experiment.
43
+ */
44
+ export declare class InquiryLog {
45
+ private readonly experiments;
46
+ private readonly now;
47
+ private seq;
48
+ constructor(options: {
49
+ now: () => Timestamp;
50
+ });
51
+ register(hypothesis: Hypothesis, options?: {
52
+ exclusions?: string[];
53
+ }): Experiment;
54
+ /**
55
+ * A look is any observation of the outcome. Recording it is mandatory, not optional.
56
+ */
57
+ observe(experimentId: Id, value: number): Experiment;
58
+ conclude(experimentId: Id, verdict: "supported" | "refuted" | "inconclusive"): Experiment;
59
+ /**
60
+ * Tier earned by the experiment itself: T3 only when it ran and was pre-registered.
61
+ */
62
+ tierOf(experimentId: Id): "T2" | "T3";
63
+ experiment(id: Id): Experiment;
64
+ list(): Experiment[];
65
+ }
66
+ /**
67
+ * T4 needs an independent re-run: different run, different seed, different origin.
68
+ */
69
+ export declare function replicationCheck(original: RunContext, replica: RunContext): ReplicationVerdict;
@@ -0,0 +1,119 @@
1
+ import { digestOf } from "../semantic/canonical.js";
2
+ /**
3
+ * Content the pre-registration hash must cover. Order is fixed by canonical(); shape is not.
4
+ */
5
+ export function preregHashOf(input) {
6
+ return digestOf({
7
+ statement: input.statement,
8
+ metric: input.metric,
9
+ stopping: input.stopping,
10
+ exclusions: input.exclusions ?? [],
11
+ });
12
+ }
13
+ /**
14
+ * Inquiry log: registration happens before observation, and re-asking is
15
+ * recorded as another look rather than as a fresh, clean experiment.
16
+ */
17
+ export class InquiryLog {
18
+ experiments = new Map();
19
+ now;
20
+ seq = 0;
21
+ constructor(options) {
22
+ this.now = options.now;
23
+ }
24
+ register(hypothesis, options = {}) {
25
+ if (!hypothesis.prereg) {
26
+ throw new Error("hypothesis must be pre-registered before an experiment can start");
27
+ }
28
+ const expected = preregHashOf({
29
+ statement: hypothesis.statement,
30
+ metric: hypothesis.prereg.metric,
31
+ stopping: hypothesis.prereg.stopping,
32
+ exclusions: hypothesis.prereg.exclusions ?? options.exclusions ?? [],
33
+ });
34
+ if (expected !== hypothesis.prereg.hash) {
35
+ throw new Error("prereg hash does not match its content: the hypothesis changed after registration");
36
+ }
37
+ this.seq += 1;
38
+ const experiment = {
39
+ id: `ex.${this.seq}`,
40
+ hypothesis: hypothesis.id,
41
+ preregHash: hypothesis.prereg.hash,
42
+ metric: hypothesis.prereg.metric,
43
+ stopping: hypothesis.prereg.stopping,
44
+ exclusions: hypothesis.prereg.exclusions ?? options.exclusions ?? [],
45
+ registeredAt: hypothesis.prereg.registered_at,
46
+ status: "running",
47
+ looks: [],
48
+ warnings: [],
49
+ };
50
+ this.experiments.set(experiment.id, experiment);
51
+ return experiment;
52
+ }
53
+ /**
54
+ * A look is any observation of the outcome. Recording it is mandatory, not optional.
55
+ */
56
+ observe(experimentId, value) {
57
+ const experiment = this.experiment(experimentId);
58
+ if (experiment.status === "completed") {
59
+ throw new Error("experiment already completed");
60
+ }
61
+ if (experiment.status === "abandoned") {
62
+ throw new Error("experiment abandoned");
63
+ }
64
+ if (experiment.stopping === "fixed_n_10m" && experiment.looks.length >= 1) {
65
+ experiment.warnings.push("extra look beyond the pre-registered fixed-n design");
66
+ }
67
+ experiment.looks.push({ value, at: this.now() });
68
+ return experiment;
69
+ }
70
+ conclude(experimentId, verdict) {
71
+ const experiment = this.experiment(experimentId);
72
+ if (experiment.looks.length === 0) {
73
+ throw new Error("cannot conclude without a single look");
74
+ }
75
+ experiment.verdict = verdict;
76
+ experiment.status = "completed";
77
+ return experiment;
78
+ }
79
+ /**
80
+ * Tier earned by the experiment itself: T3 only when it ran and was pre-registered.
81
+ */
82
+ tierOf(experimentId) {
83
+ const experiment = this.experiment(experimentId);
84
+ return experiment.status === "completed" ? "T3" : "T2";
85
+ }
86
+ experiment(id) {
87
+ const found = this.experiments.get(id);
88
+ if (!found) {
89
+ throw new Error(`unknown experiment: ${id}`);
90
+ }
91
+ return found;
92
+ }
93
+ list() {
94
+ return [...this.experiments.values()];
95
+ }
96
+ }
97
+ /**
98
+ * T4 needs an independent re-run: different run, different seed, different origin.
99
+ */
100
+ export function replicationCheck(original, replica) {
101
+ const reasons = [];
102
+ if (!original.runId || !replica.runId) {
103
+ reasons.push("run ids are required");
104
+ }
105
+ if (original.runId === replica.runId) {
106
+ reasons.push("same run: re-asking is not replication");
107
+ }
108
+ if (original.seed === replica.seed) {
109
+ reasons.push("same seed: not an independent sample");
110
+ }
111
+ if (original.origin === replica.origin) {
112
+ reasons.push("same origin: not independent testimony");
113
+ }
114
+ if (replica.environment !== (void 0) && original.environment === replica.environment) {
115
+ reasons.push("same environment: weaker replication (allowed, but not sufficient alone for T4)");
116
+ }
117
+ const fatal = reasons.filter((reason) => !reason.startsWith("same environment"));
118
+ return { ok: fatal.length === 0, reasons, tier: fatal.length === 0 ? "T4" : "T3" };
119
+ }
@@ -0,0 +1,46 @@
1
+ import type { Claim, EvidenceItem, Hypothesis } from "./epistemic.js";
2
+ import type { Tier } from "../types/common.js";
3
+ /**
4
+ * Distinct origins, not distinct URLs. Ten retellings of one source are one source.
5
+ */
6
+ export declare const effectiveOrigins: (evidence: EvidenceItem[]) => number;
7
+ /**
8
+ * Confidence is DERIVED (M-1), never authored by the model.
9
+ * Tier sets the base, evidence quality moves it, the weakest source caps it.
10
+ */
11
+ export declare const deriveConfidence: (claim: Pick<Claim, "tier" | "warrant">) => number;
12
+ /**
13
+ * Tier inflation is a validation failure, not a style issue (W-5).
14
+ * Returns human-readable violations; empty means admissible.
15
+ */
16
+ export declare const validateClaim: (claim: Claim) => string[];
17
+ /**
18
+ * A hypothesis without a refutation condition is a position, not a hypothesis (W-2).
19
+ */
20
+ export declare const validateHypothesis: (hypothesis: Hypothesis) => string[];
21
+ type HypothesisClass = "confirmatory" | "exploratory";
22
+ /**
23
+ * Registered before data access → confirmatory; otherwise → exploratory (no HARKing).
24
+ */
25
+ export declare const classifyHypothesis: (hypothesis: Hypothesis) => HypothesisClass;
26
+ /**
27
+ * Contested or doubted claims may enter a Frame but must not authorize effects.
28
+ * Returns false whenever the claim is not carried beyond reasonable doubt.
29
+ */
30
+ export declare const canAuthorizeEffect: (claim: Claim, minTier: Tier) => boolean;
31
+ type ClaimReviser = (previous: Claim, patch: Partial<Claim>, reason: string, at: string) => Claim;
32
+ /**
33
+ * Minimal-change revision: the old claim is kept and referenced, never overwritten (W-3).
34
+ */
35
+ export declare const reviseClaim: ClaimReviser;
36
+ /**
37
+ * Suggested tier for a claim — used only to warn, never to promote silently.
38
+ */
39
+ export declare const suggestTier: (evidence: EvidenceItem[]) => Tier;
40
+ type PressureGuard = (existing: Claim | undefined, evidence: EvidenceItem[], underPressure: boolean) => boolean;
41
+ /**
42
+ * Social pressure without new evidence must not change confidence (W-5).
43
+ * The runtime calls this before appending a claim.
44
+ */
45
+ export declare const pressureBlocked: PressureGuard;
46
+ export {};
@@ -0,0 +1,153 @@
1
+ const TierBase = {
2
+ T0: 0.35,
3
+ T1: 0.55,
4
+ T2: 0.72,
5
+ T3: 0.85,
6
+ T4: 0.92,
7
+ };
8
+ /**
9
+ * A chain is as strong as its weakest source, so the cap is the minimum.
10
+ */
11
+ const TrustCap = {
12
+ self: 0.9,
13
+ verified: 0.95,
14
+ trusted: 0.85,
15
+ asserted: 0.7,
16
+ inferred: 0.6,
17
+ external: 0.5,
18
+ };
19
+ const TierOrder = ["T0", "T1", "T2", "T3", "T4"];
20
+ const round = (n) => Math.round(n * 1000) / 1000;
21
+ /**
22
+ * Distinct origins, not distinct URLs. Ten retellings of one source are one source.
23
+ */
24
+ export const effectiveOrigins = (evidence) => {
25
+ return new Set(evidence.map((e) => e.origin ?? e.id)).size;
26
+ };
27
+ /**
28
+ * Confidence is DERIVED (M-1), never authored by the model.
29
+ * Tier sets the base, evidence quality moves it, the weakest source caps it.
30
+ */
31
+ export const deriveConfidence = (claim) => {
32
+ const base = TierBase[claim.tier];
33
+ const evidence = claim.warrant.evidence;
34
+ if (evidence.length === 0) {
35
+ return round(Math.min(base, 0.6));
36
+ }
37
+ const origins = effectiveOrigins(evidence);
38
+ const avgIndependence = evidence.reduce((sum, e) => sum + (e.independence ?? 0.5), 0) / evidence.length;
39
+ const corroboration = Math.min(1, (origins - 1) / 2);
40
+ const support = evidence.reduce((sum, e) => {
41
+ const weight = e.independence ?? 0.5;
42
+ if (e.relation === "contradicts") {
43
+ return sum - weight;
44
+ }
45
+ if (e.relation === "undercuts") {
46
+ return sum - 0.5 * weight;
47
+ }
48
+ return sum + weight;
49
+ }, 0) / evidence.length;
50
+ const cap = Math.min(...evidence.map((e) => TrustCap[e.trust]));
51
+ const raw = base + 0.12 * corroboration + 0.1 * avgIndependence + 0.08 * support;
52
+ return round(Math.max(0, Math.min(raw, cap)));
53
+ };
54
+ /**
55
+ * Tier inflation is a validation failure, not a style issue (W-5).
56
+ * Returns human-readable violations; empty means admissible.
57
+ */
58
+ export const validateClaim = (claim) => {
59
+ const problems = [];
60
+ const evidence = claim.warrant.evidence;
61
+ if (claim.tier !== "T0" && evidence.length === 0) {
62
+ problems.push(`${claim.tier} requires at least one evidence item`);
63
+ }
64
+ if (claim.tier === "T1" && !evidence.some((e) => e.entails === true)) {
65
+ problems.push("T1 requires a source that entails the claim (entails: true)");
66
+ }
67
+ if (claim.tier === "T2" && !evidence.some((e) => e.trust === "self" || e.trust === "verified")) {
68
+ problems.push("T2 requires an observation recorded by this agent");
69
+ }
70
+ if (claim.tier === "T3") {
71
+ if (!claim.causal || claim.causal.assignment_mechanism === "observed") {
72
+ problems.push("T3 requires an intervention, randomization, or named identification strategy");
73
+ }
74
+ }
75
+ if (claim.tier === "T4" && effectiveOrigins(evidence) < 2) {
76
+ problems.push("T4 requires an independent replication (at least two origins)");
77
+ }
78
+ if (claim.causal && claim.causal.assignment_mechanism === "observed" && claim.claim_scope === "interventional") {
79
+ problems.push("observational data cannot support an interventional claim without an identification strategy");
80
+ }
81
+ return problems;
82
+ };
83
+ /**
84
+ * A hypothesis without a refutation condition is a position, not a hypothesis (W-2).
85
+ */
86
+ export const validateHypothesis = (hypothesis) => {
87
+ const problems = [];
88
+ if (!hypothesis.refutes_if || hypothesis.refutes_if.trim().length === 0) {
89
+ problems.push("refutes_if is required");
90
+ }
91
+ if (!hypothesis.prediction || hypothesis.prediction.trim().length === 0) {
92
+ problems.push("prediction is required");
93
+ }
94
+ return problems;
95
+ };
96
+ /**
97
+ * Registered before data access → confirmatory; otherwise → exploratory (no HARKing).
98
+ */
99
+ export const classifyHypothesis = (hypothesis) => {
100
+ return hypothesis.prereg ? "confirmatory" : "exploratory";
101
+ };
102
+ /**
103
+ * Contested or doubted claims may enter a Frame but must not authorize effects.
104
+ * Returns false whenever the claim is not carried beyond reasonable doubt.
105
+ */
106
+ export const canAuthorizeEffect = (claim, minTier) => {
107
+ if (claim.status !== "held") {
108
+ return false;
109
+ }
110
+ if (TierOrder.indexOf(claim.tier) < TierOrder.indexOf(minTier)) {
111
+ return false;
112
+ }
113
+ const confidence = claim.confidence ?? deriveConfidence(claim);
114
+ return confidence >= 0.6;
115
+ };
116
+ /**
117
+ * Minimal-change revision: the old claim is kept and referenced, never overwritten (W-3).
118
+ */
119
+ export const reviseClaim = (previous, patch, reason, at) => {
120
+ return {
121
+ ...previous,
122
+ ...patch,
123
+ id: `${previous.id}.r${(previous.revision ? 1 : 0) + 1}`,
124
+ supersedes: { kind: "claim", id: previous.id },
125
+ revision: { reason, at },
126
+ created: previous.created,
127
+ };
128
+ };
129
+ /**
130
+ * Suggested tier for a claim — used only to warn, never to promote silently.
131
+ */
132
+ export const suggestTier = (evidence) => {
133
+ if (evidence.length === 0) {
134
+ return "T0";
135
+ }
136
+ if (effectiveOrigins(evidence) >= 2 && evidence.some((e) => e.trust === "verified")) {
137
+ return "T4";
138
+ }
139
+ if (evidence.some((e) => e.trust === "self" || e.trust === "verified")) {
140
+ return "T2";
141
+ }
142
+ if (evidence.some((e) => e.entails === true)) {
143
+ return "T1";
144
+ }
145
+ return "T0";
146
+ };
147
+ /**
148
+ * Social pressure without new evidence must not change confidence (W-5).
149
+ * The runtime calls this before appending a claim.
150
+ */
151
+ export const pressureBlocked = (existing, evidence, underPressure) => {
152
+ return underPressure && existing !== (void 0) && evidence.length === 0;
153
+ };
@@ -0,0 +1,57 @@
1
+ import type { ChainEntry, LedgerSnapshot } from "../ledger/persistence.js";
2
+ import type { Checkpoint, PrunePlan, PrunePolicy } from "./compactionTypes.js";
3
+ export interface PruneResult {
4
+ plan: PrunePlan;
5
+ /**
6
+ * The view itself: retained entries in chain order.
7
+ */
8
+ keep: ChainEntry[];
9
+ }
10
+ /**
11
+ * Build a view of a verified snapshot.
12
+ *
13
+ * Order of work: the retention floor, then per-kind eligibility, then the
14
+ * reference closure. The closure runs last and wins: a superseded claim that a
15
+ * retained plan still cites is kept, because dropping it would leave the
16
+ * citation dangling.
17
+ */
18
+ export declare function planPrune(snapshot: LedgerSnapshot, overrides?: Partial<PrunePolicy>): PruneResult;
19
+ export interface Compaction {
20
+ checkpoint: Checkpoint;
21
+ /**
22
+ * The part of the chain that remains in storage, continuing from `checkpoint.tip`.
23
+ */
24
+ tail: LedgerSnapshot;
25
+ /**
26
+ * The entries the checkpoint covers. Kept here so the commitment is checkable.
27
+ */
28
+ removed: ChainEntry[];
29
+ }
30
+ export declare class CompactionRefused extends Error {
31
+ readonly pinned: string[];
32
+ constructor(message: string, pinned?: string[]);
33
+ }
34
+ export interface CompactionOptions {
35
+ keepRecent?: number;
36
+ now?: string;
37
+ }
38
+ /**
39
+ * Replace the cold prefix with a checkpoint.
40
+ *
41
+ * Refuses when the retained tail still references an entry in the prefix: the
42
+ * checkpoint would commit to data the agent can no longer read, which is how a
43
+ * ledger becomes unusable while claiming to be intact.
44
+ */
45
+ export declare function compactLedger(snapshot: LedgerSnapshot, options?: CompactionOptions): Compaction;
46
+ /**
47
+ * Check a compaction without trusting any of it.
48
+ *
49
+ * The root cannot be recomputed from the tail alone — that is the point of
50
+ * compaction — so the caller must supply the removed entries. What this proves
51
+ * is that *these* entries are the ones the checkpoint committed to, and that
52
+ * the tail continues the same chain.
53
+ */
54
+ export declare function verifyCompaction(compaction: Compaction): {
55
+ ok: boolean;
56
+ reasons: string[];
57
+ };