attention-manifest-protocol 0.4.2 → 0.4.4

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 (809) hide show
  1. package/CHANGELOG.md +341 -293
  2. package/CHANGELOG.zh-CN.md +41 -8
  3. package/README.md +250 -171
  4. package/README.zh-CN.md +251 -171
  5. package/lib/assignment/assign.d.ts +102 -0
  6. package/lib/assignment/assign.js +556 -0
  7. package/lib/assignment/binding.d.ts +103 -0
  8. package/lib/assignment/binding.js +575 -0
  9. package/lib/assignment/errors.d.ts +14 -0
  10. package/lib/assignment/errors.js +16 -0
  11. package/lib/assignment/guards.d.ts +18 -0
  12. package/lib/assignment/guards.js +28 -0
  13. package/lib/assignment/index.d.ts +10 -0
  14. package/lib/assignment/index.js +10 -0
  15. package/lib/assignment/types.d.ts +169 -0
  16. package/lib/assignment/types.js +1 -0
  17. package/lib/attention/budget.d.ts +1 -1
  18. package/lib/attention/budget.js +31 -9
  19. package/lib/bayes/engine.js +2 -1
  20. package/lib/bayes/reliability.js +25 -10
  21. package/lib/boundary/frame.d.ts +10 -4
  22. package/lib/boundary/frame.js +346 -109
  23. package/lib/boundary/kinds.d.ts +11 -0
  24. package/lib/boundary/kinds.js +33 -0
  25. package/lib/boundary/refTable.d.ts +19 -9
  26. package/lib/boundary/refTable.js +128 -30
  27. package/lib/boundary/toolCall.d.ts +22 -10
  28. package/lib/boundary/toolCall.js +798 -97
  29. package/lib/concept/conceptBudget.js +10 -1
  30. package/lib/concurrency/idempotency.d.ts +4 -3
  31. package/lib/concurrency/idempotency.js +57 -13
  32. package/lib/concurrency/retry.js +18 -3
  33. package/lib/context/agentContext.d.ts +13 -0
  34. package/lib/context/agentContext.js +14 -1
  35. package/lib/context/ast.d.ts +4 -1
  36. package/lib/context/ast.js +13 -3
  37. package/lib/context/contentStore.js +22 -9
  38. package/lib/context/contextBuilder.d.ts +457 -0
  39. package/lib/context/contextBuilder.js +1395 -0
  40. package/lib/context/contextPackage.d.ts +214 -0
  41. package/lib/context/contextPackage.js +191 -0
  42. package/lib/context/index.d.ts +14 -3
  43. package/lib/context/index.js +9 -1
  44. package/lib/context/relevance.d.ts +171 -0
  45. package/lib/context/relevance.js +250 -0
  46. package/lib/context/workspaceDiff.d.ts +105 -0
  47. package/lib/context/workspaceDiff.js +238 -0
  48. package/lib/context/workspaceService.d.ts +236 -1
  49. package/lib/context/workspaceService.js +1501 -73
  50. package/lib/cooperation/collaboration.d.ts +9 -0
  51. package/lib/cooperation/session.d.ts +4 -4
  52. package/lib/cooperation/session.js +3 -3
  53. package/lib/database/adapter/filesystemStore.d.ts +145 -0
  54. package/lib/database/adapter/filesystemStore.js +321 -0
  55. package/lib/database/adapter/index.d.ts +2 -0
  56. package/lib/database/adapter/index.js +2 -0
  57. package/lib/database/adapter/workspaceSessionStore.d.ts +118 -0
  58. package/lib/database/adapter/workspaceSessionStore.js +120 -0
  59. package/lib/database/entity/fileGraph.d.ts +53 -0
  60. package/lib/database/entity/fileGraph.js +15 -0
  61. package/lib/database/entity/fileTree.d.ts +76 -0
  62. package/lib/database/entity/fileTree.js +39 -0
  63. package/lib/database/entity/hook.d.ts +29 -0
  64. package/lib/database/entity/hook.js +18 -0
  65. package/lib/database/entity/index.d.ts +4 -0
  66. package/lib/database/entity/index.js +4 -0
  67. package/lib/database/entity/workspaceSession.d.ts +53 -0
  68. package/lib/database/entity/workspaceSession.js +28 -0
  69. package/lib/database/repository/fileAnnotationRepository.d.ts +75 -0
  70. package/lib/database/repository/fileAnnotationRepository.js +109 -0
  71. package/lib/database/repository/fileGraphRepository.d.ts +188 -0
  72. package/lib/database/repository/fileGraphRepository.js +648 -0
  73. package/lib/database/repository/fileNodeRepository.d.ts +116 -0
  74. package/lib/database/repository/fileNodeRepository.js +263 -0
  75. package/lib/database/repository/fileOutlineRepository.d.ts +40 -0
  76. package/lib/database/repository/fileOutlineRepository.js +104 -0
  77. package/lib/database/repository/fileWriteRepository.d.ts +41 -0
  78. package/lib/database/repository/fileWriteRepository.js +93 -0
  79. package/lib/database/repository/hookRepository.d.ts +67 -0
  80. package/lib/database/repository/hookRepository.js +150 -0
  81. package/lib/database/repository/index.d.ts +7 -0
  82. package/lib/database/repository/index.js +7 -0
  83. package/lib/database/repository/workspaceSessionRepository.d.ts +134 -0
  84. package/lib/database/repository/workspaceSessionRepository.js +327 -0
  85. package/lib/database/service/database.d.ts +14 -0
  86. package/lib/database/service/database.js +21 -0
  87. package/lib/database/sql/schema.js +187 -0
  88. package/lib/database/store/database.js +6 -1
  89. package/lib/delegate/team.d.ts +5 -0
  90. package/lib/delegate/team.js +83 -20
  91. package/lib/discover/classify.d.ts +20 -0
  92. package/lib/discover/classify.js +85 -0
  93. package/lib/discover/host.d.ts +20 -0
  94. package/lib/discover/host.js +89 -0
  95. package/lib/discover/index.d.ts +11 -0
  96. package/lib/discover/index.js +11 -0
  97. package/lib/discover/kinds.d.ts +14 -0
  98. package/lib/discover/kinds.js +23 -0
  99. package/lib/discover/tree.d.ts +7 -0
  100. package/lib/discover/tree.js +432 -0
  101. package/lib/discover/types.d.ts +115 -0
  102. package/lib/discover/types.js +1 -0
  103. package/lib/error/boundaryRejection.d.ts +1 -1
  104. package/lib/evaluation/agreement.js +2 -2
  105. package/lib/execution/handles.js +6 -0
  106. package/lib/execution/pin.js +2 -2
  107. package/lib/file/cfb.d.ts +56 -0
  108. package/lib/file/cfb.js +396 -0
  109. package/lib/file/dependency.d.ts +151 -0
  110. package/lib/file/dependency.js +568 -0
  111. package/lib/file/directory.d.ts +34 -0
  112. package/lib/file/directory.js +141 -0
  113. package/lib/file/errors.d.ts +20 -0
  114. package/lib/file/errors.js +18 -0
  115. package/lib/file/exportGraph.d.ts +31 -0
  116. package/lib/file/exportGraph.js +554 -0
  117. package/lib/file/file.d.ts +40 -0
  118. package/lib/file/file.js +339 -0
  119. package/lib/file/importGraph.d.ts +121 -0
  120. package/lib/file/importGraph.js +1022 -0
  121. package/lib/file/index.d.ts +45 -0
  122. package/lib/file/index.js +30 -0
  123. package/lib/file/metadata.d.ts +66 -0
  124. package/lib/file/metadata.js +470 -0
  125. package/lib/file/path.d.ts +60 -0
  126. package/lib/file/path.js +259 -0
  127. package/lib/file/read.d.ts +168 -0
  128. package/lib/file/read.js +541 -0
  129. package/lib/file/runtime.d.ts +95 -0
  130. package/lib/file/runtime.js +150 -0
  131. package/lib/file/service.d.ts +227 -0
  132. package/lib/file/service.js +663 -0
  133. package/lib/file/syntaxTree.d.ts +7 -0
  134. package/lib/file/syntaxTree.js +38 -0
  135. package/lib/file/time.d.ts +38 -0
  136. package/lib/file/time.js +44 -0
  137. package/lib/file/tree.d.ts +53 -0
  138. package/lib/file/tree.js +417 -0
  139. package/lib/file/types.d.ts +371 -0
  140. package/lib/file/types.js +1 -0
  141. package/lib/file/write.d.ts +159 -0
  142. package/lib/file/write.js +1028 -0
  143. package/lib/file/zip.d.ts +35 -0
  144. package/lib/file/zip.js +349 -0
  145. package/lib/fingerprint/algorithm.d.ts +97 -0
  146. package/lib/fingerprint/algorithm.js +271 -0
  147. package/lib/fingerprint/bytes.d.ts +18 -0
  148. package/lib/fingerprint/bytes.js +31 -0
  149. package/lib/fingerprint/error.d.ts +73 -0
  150. package/lib/fingerprint/error.js +86 -0
  151. package/lib/fingerprint/file.d.ts +71 -0
  152. package/lib/fingerprint/file.js +254 -0
  153. package/lib/fingerprint/index.d.ts +37 -0
  154. package/lib/fingerprint/index.js +12 -0
  155. package/lib/fingerprint/json.d.ts +41 -0
  156. package/lib/fingerprint/json.js +94 -0
  157. package/lib/fingerprint/number.d.ts +32 -0
  158. package/lib/fingerprint/number.js +95 -0
  159. package/lib/fingerprint/policy.d.ts +54 -0
  160. package/lib/fingerprint/policy.js +50 -0
  161. package/lib/fingerprint/preimage.d.ts +84 -0
  162. package/lib/fingerprint/preimage.js +133 -0
  163. package/lib/fingerprint/raw.d.ts +26 -0
  164. package/lib/fingerprint/raw.js +45 -0
  165. package/lib/fingerprint/ref.d.ts +39 -0
  166. package/lib/fingerprint/ref.js +178 -0
  167. package/lib/fingerprint/text.d.ts +42 -0
  168. package/lib/fingerprint/text.js +155 -0
  169. package/lib/fingerprint/tree.d.ts +56 -0
  170. package/lib/fingerprint/tree.js +288 -0
  171. package/lib/fingerprint/verify.d.ts +20 -0
  172. package/lib/fingerprint/verify.js +99 -0
  173. package/lib/global/filesystem.d.ts +43 -0
  174. package/lib/global/filesystem.js +75 -0
  175. package/lib/global/index.d.ts +8 -0
  176. package/lib/global/index.js +8 -0
  177. package/lib/global/service.d.ts +51 -0
  178. package/lib/global/service.js +98 -0
  179. package/lib/governance/transport.js +18 -6
  180. package/lib/hook/ast.d.ts +29 -0
  181. package/lib/hook/ast.js +22 -0
  182. package/lib/hook/code.d.ts +55 -0
  183. package/lib/hook/code.js +47 -0
  184. package/lib/hook/dependency.d.ts +45 -0
  185. package/lib/hook/dependency.js +28 -0
  186. package/lib/hook/diff.d.ts +114 -0
  187. package/lib/hook/diff.js +327 -0
  188. package/lib/hook/exportation.d.ts +31 -0
  189. package/lib/hook/exportation.js +24 -0
  190. package/lib/hook/file.d.ts +44 -0
  191. package/lib/hook/file.js +154 -0
  192. package/lib/hook/importation.d.ts +33 -0
  193. package/lib/hook/importation.js +22 -0
  194. package/lib/hook/index.d.ts +30 -0
  195. package/lib/hook/index.js +23 -0
  196. package/lib/hook/outline.d.ts +35 -0
  197. package/lib/hook/outline.js +27 -0
  198. package/lib/hook/project.d.ts +65 -0
  199. package/lib/hook/project.js +217 -0
  200. package/lib/hook/types.d.ts +114 -0
  201. package/lib/hook/types.js +407 -0
  202. package/lib/index.d.ts +9 -0
  203. package/lib/index.js +9 -0
  204. package/lib/lock/lease.js +28 -3
  205. package/lib/manifest/cardSign.d.ts +1 -1
  206. package/lib/manifest/cardSign.js +37 -7
  207. package/lib/manifest/federation.js +13 -6
  208. package/lib/manifest/trust.d.ts +2 -0
  209. package/lib/manifest/trust.js +27 -6
  210. package/lib/module/index.d.ts +4 -0
  211. package/lib/module/index.js +4 -0
  212. package/lib/module/mcp/client.js +21 -2
  213. package/lib/module/mcp/filesystemServer.d.ts +24 -0
  214. package/lib/module/mcp/filesystemServer.js +102 -0
  215. package/lib/module/mcp/http.js +32 -19
  216. package/lib/module/mcp/workspaceServer.js +20 -3
  217. package/lib/module/tool/filesystemExecutor.d.ts +18 -0
  218. package/lib/module/tool/filesystemExecutor.js +49 -0
  219. package/lib/module/tool/globalExecutor.d.ts +17 -0
  220. package/lib/module/tool/globalExecutor.js +39 -0
  221. package/lib/module/tool/globalFilesystemExecutor.d.ts +18 -0
  222. package/lib/module/tool/globalFilesystemExecutor.js +49 -0
  223. package/lib/module/tool/workspaceExecutor.d.ts +9 -0
  224. package/lib/module/tool/workspaceExecutor.js +16 -3
  225. package/lib/naming/aliases.d.ts +48 -0
  226. package/lib/naming/aliases.js +79 -0
  227. package/lib/naming/catalog.d.ts +117 -0
  228. package/lib/naming/catalog.js +108 -0
  229. package/lib/naming/grammar.d.ts +67 -0
  230. package/lib/naming/grammar.js +212 -0
  231. package/lib/naming/ids.d.ts +157 -0
  232. package/lib/naming/ids.js +119 -0
  233. package/lib/naming/index.d.ts +13 -0
  234. package/lib/naming/index.js +13 -0
  235. package/lib/outline/index.d.ts +9 -0
  236. package/lib/outline/index.js +8 -0
  237. package/lib/outline/office.d.ts +160 -0
  238. package/lib/outline/office.js +2375 -0
  239. package/lib/outline/officeBridge.d.ts +32 -0
  240. package/lib/outline/officeBridge.js +27 -0
  241. package/lib/outline/outline.d.ts +159 -0
  242. package/lib/outline/outline.js +837 -0
  243. package/lib/outline/outlineIndex.d.ts +97 -0
  244. package/lib/outline/outlineIndex.js +325 -0
  245. package/lib/outline/outlineKeywords.d.ts +59 -0
  246. package/lib/outline/outlineKeywords.js +143 -0
  247. package/lib/outline/outlineStrategies.d.ts +414 -0
  248. package/lib/outline/outlineStrategies.js +8324 -0
  249. package/lib/outline/reactOutline.d.ts +37 -0
  250. package/lib/outline/reactOutline.js +1070 -0
  251. package/lib/outline/shellOutline.d.ts +65 -0
  252. package/lib/outline/shellOutline.js +873 -0
  253. package/lib/outline/sqlOutline.d.ts +170 -0
  254. package/lib/outline/sqlOutline.js +1536 -0
  255. package/lib/outline/strategy.d.ts +46 -0
  256. package/lib/outline/strategy.js +1 -0
  257. package/lib/outline/types.d.ts +95 -0
  258. package/lib/outline/types.js +1 -0
  259. package/lib/outline/visualBasicOutline.d.ts +27 -0
  260. package/lib/outline/visualBasicOutline.js +750 -0
  261. package/lib/protocol/filesystem.d.ts +55 -0
  262. package/lib/protocol/filesystem.js +105 -0
  263. package/lib/protocol/global.d.ts +42 -0
  264. package/lib/protocol/global.js +63 -0
  265. package/lib/protocol/globalFilesystem.d.ts +40 -0
  266. package/lib/protocol/globalFilesystem.js +59 -0
  267. package/lib/protocol/index.d.ts +4 -0
  268. package/lib/protocol/index.js +4 -0
  269. package/lib/protocol/protocol.d.ts +4 -0
  270. package/lib/protocol/wire.js +5 -2
  271. package/lib/protocol/workspace.d.ts +305 -0
  272. package/lib/protocol/workspace.js +258 -0
  273. package/lib/receipt/receipt.d.ts +8 -0
  274. package/lib/registry/content.js +9 -3
  275. package/lib/runtime/kernelRuntime.js +9 -1
  276. package/lib/scenario/scenario.js +5 -4
  277. package/lib/semantic/canonical.d.ts +61 -0
  278. package/lib/semantic/canonical.js +135 -8
  279. package/lib/semantic/jsonValue.d.ts +31 -0
  280. package/lib/semantic/jsonValue.js +122 -0
  281. package/lib/semantic/sha256.js +3 -0
  282. package/lib/semantic/time.d.ts +14 -0
  283. package/lib/semantic/time.js +56 -0
  284. package/lib/session/context.d.ts +76 -0
  285. package/lib/session/context.js +419 -0
  286. package/lib/session/errors.d.ts +24 -0
  287. package/lib/session/errors.js +22 -0
  288. package/lib/session/identity.d.ts +24 -0
  289. package/lib/session/identity.js +56 -0
  290. package/lib/session/index.d.ts +14 -0
  291. package/lib/session/index.js +12 -0
  292. package/lib/session/registry.d.ts +130 -0
  293. package/lib/session/registry.js +908 -0
  294. package/lib/session/types.d.ts +227 -0
  295. package/lib/session/types.js +14 -0
  296. package/lib/structure/index.d.ts +1 -0
  297. package/lib/structure/index.js +1 -0
  298. package/lib/structure/trie.d.ts +88 -0
  299. package/lib/structure/trie.js +183 -0
  300. package/lib/syntax/byteIndex.d.ts +44 -0
  301. package/lib/syntax/byteIndex.js +148 -0
  302. package/lib/syntax/charset.d.ts +88 -0
  303. package/lib/syntax/charset.js +276 -0
  304. package/lib/syntax/index.d.ts +6 -0
  305. package/lib/syntax/index.js +5 -0
  306. package/lib/syntax/syntaxRegistry.d.ts +150 -0
  307. package/lib/syntax/syntaxRegistry.js +314 -0
  308. package/lib/syntax/syntaxTree.d.ts +106 -0
  309. package/lib/syntax/syntaxTree.js +668 -0
  310. package/lib/syntax/types.d.ts +15 -0
  311. package/lib/syntax/types.js +1 -0
  312. package/lib/types/common.d.ts +1 -1
  313. package/package.json +72 -193
  314. package/.editorconfig +0 -12
  315. package/.prettierignore +0 -17
  316. package/MCP-Token/347/250/216/344/270/216/344/270/213/344/270/200/344/273/243/345/267/245/345/205/267/345/215/217/350/256/256.html +0 -1763
  317. package/docs/annotation-campaign-A.csv +0 -54
  318. package/docs/annotation-campaign-B.csv +0 -54
  319. package/docs/annotation-campaign.csv +0 -54
  320. package/docs/eval/annotations-A.jsonl +0 -16
  321. package/docs/eval/annotations.json +0 -122
  322. package/docs/eval/recorded-labels.json +0 -12
  323. package/docs/eval/replay-cases.json +0 -14
  324. package/docs/eval/replay-labels-b.json +0 -14
  325. package/docs/examples/attention-request.json +0 -16
  326. package/docs/examples/checkpoint.json +0 -15
  327. package/docs/examples/claim.json +0 -66
  328. package/docs/examples/collaboration.json +0 -66
  329. package/docs/examples/concept-checkpoint.json +0 -15
  330. package/docs/examples/concept-prune-plan.json +0 -45
  331. package/docs/examples/federation.json +0 -126
  332. package/docs/examples/frame-chain.json +0 -77
  333. package/docs/examples/ledger-snapshot.json +0 -108
  334. package/docs/examples/manifest.json +0 -77
  335. package/docs/examples/message.json +0 -19
  336. package/docs/examples/other-model.json +0 -45
  337. package/docs/examples/plan.json +0 -50
  338. package/docs/examples/prune-plan.json +0 -48
  339. package/docs/examples/receipt.json +0 -22
  340. package/docs/examples/runtime-run.json +0 -573
  341. package/docs/examples/team.json +0 -66
  342. package/docs/examples/verb-note.json +0 -11
  343. package/docs/probes/bayes-scores.json +0 -1452
  344. package/docs/probes/calibration-imported.json +0 -141
  345. package/docs/probes/context-ast-deepseek.json +0 -1577
  346. package/docs/probes/deepseek-probe.json +0 -917
  347. package/docs/probes/eval-recorded-replay.json +0 -597
  348. package/docs/probes/eval-replay.json +0 -124
  349. package/docs/probes/eval-summary.json +0 -42
  350. package/docs/probes/runtime-eval.json +0 -4230
  351. package/eslint.config.mts +0 -96
  352. package/index.html +0 -13
  353. package/prettier.config.mts +0 -37
  354. package/public/favicon.svg +0 -1
  355. package/public/icons.svg +0 -24
  356. package/src/attention/attention.ts +0 -347
  357. package/src/attention/budget.ts +0 -72
  358. package/src/attention/cognition.ts +0 -519
  359. package/src/attention/index.ts +0 -8
  360. package/src/attention/interrupts.ts +0 -228
  361. package/src/attention/resource.ts +0 -316
  362. package/src/attention/social.ts +0 -217
  363. package/src/attention/socialTypes.ts +0 -115
  364. package/src/authz/authz.ts +0 -305
  365. package/src/authz/index.ts +0 -1
  366. package/src/bayes/calibration.ts +0 -204
  367. package/src/bayes/calibrationRegistry.ts +0 -111
  368. package/src/bayes/calibrationSelection.ts +0 -154
  369. package/src/bayes/engine.ts +0 -532
  370. package/src/bayes/index.ts +0 -6
  371. package/src/bayes/reliability.ts +0 -62
  372. package/src/bayes/scopedPriors.ts +0 -88
  373. package/src/boundary/frame.ts +0 -322
  374. package/src/boundary/ids.ts +0 -14
  375. package/src/boundary/index.ts +0 -12
  376. package/src/boundary/refTable.ts +0 -125
  377. package/src/boundary/toolCall.ts +0 -212
  378. package/src/concept/concept.ts +0 -75
  379. package/src/concept/conceptBudget.ts +0 -346
  380. package/src/concept/conceptBudgetTypes.ts +0 -79
  381. package/src/concept/index.ts +0 -3
  382. package/src/concurrency/idempotency.ts +0 -41
  383. package/src/concurrency/index.ts +0 -5
  384. package/src/concurrency/mutex.ts +0 -26
  385. package/src/concurrency/namedLocks.ts +0 -35
  386. package/src/concurrency/retry.ts +0 -50
  387. package/src/concurrency/worker.ts +0 -128
  388. package/src/context/agentContext.ts +0 -308
  389. package/src/context/ast.ts +0 -499
  390. package/src/context/contentStore.ts +0 -75
  391. package/src/context/context.ts +0 -65
  392. package/src/context/contextIndex.ts +0 -85
  393. package/src/context/document.ts +0 -137
  394. package/src/context/fileStorePath.ts +0 -14
  395. package/src/context/index.ts +0 -43
  396. package/src/context/lifecycle.ts +0 -221
  397. package/src/context/projections.ts +0 -151
  398. package/src/context/workspace.ts +0 -422
  399. package/src/context/workspaceProtocol.ts +0 -112
  400. package/src/context/workspaceService.ts +0 -423
  401. package/src/cooperation/board.ts +0 -104
  402. package/src/cooperation/collaboration.ts +0 -60
  403. package/src/cooperation/index.ts +0 -6
  404. package/src/cooperation/merge.ts +0 -190
  405. package/src/cooperation/metrics.ts +0 -57
  406. package/src/cooperation/session.ts +0 -131
  407. package/src/cooperation/unified.ts +0 -56
  408. package/src/counter.ts +0 -9
  409. package/src/database/adapter/adapters.ts +0 -35
  410. package/src/database/adapter/index.ts +0 -4
  411. package/src/database/adapter/runtimeSink.ts +0 -74
  412. package/src/database/adapter/sessionStore.ts +0 -32
  413. package/src/database/adapter/turnStore.ts +0 -23
  414. package/src/database/entity/agent.ts +0 -199
  415. package/src/database/entity/entity.ts +0 -1046
  416. package/src/database/entity/handle.ts +0 -79
  417. package/src/database/entity/index.ts +0 -32
  418. package/src/database/entity/message.ts +0 -74
  419. package/src/database/entity/meta.ts +0 -11
  420. package/src/database/entity/object.ts +0 -42
  421. package/src/database/entity/outbox.ts +0 -15
  422. package/src/database/entity/process.ts +0 -65
  423. package/src/database/entity/registry.ts +0 -155
  424. package/src/database/entity/runtimeApproval.ts +0 -30
  425. package/src/database/entity/runtimeSession.ts +0 -13
  426. package/src/database/entity/runtimeTurn.ts +0 -15
  427. package/src/database/entity/thread.ts +0 -85
  428. package/src/database/entity/window.ts +0 -85
  429. package/src/database/entity/worker.ts +0 -90
  430. package/src/database/index.ts +0 -6
  431. package/src/database/repository/addressSpaceRepository.ts +0 -72
  432. package/src/database/repository/agentRepository.ts +0 -460
  433. package/src/database/repository/base.ts +0 -41
  434. package/src/database/repository/executionRepository.ts +0 -477
  435. package/src/database/repository/handleRepository.ts +0 -64
  436. package/src/database/repository/index.ts +0 -20
  437. package/src/database/repository/messageRepository.ts +0 -52
  438. package/src/database/repository/objectRepository.ts +0 -69
  439. package/src/database/repository/outboxRepository.ts +0 -63
  440. package/src/database/repository/processRepository.ts +0 -58
  441. package/src/database/repository/registryRepository.ts +0 -119
  442. package/src/database/repository/repository.ts +0 -491
  443. package/src/database/repository/runtimeApprovalRepository.ts +0 -44
  444. package/src/database/repository/runtimeSessionRepository.ts +0 -27
  445. package/src/database/repository/runtimeTurnRepository.ts +0 -39
  446. package/src/database/repository/socialRepository.ts +0 -185
  447. package/src/database/repository/threadRepository.ts +0 -57
  448. package/src/database/repository/windowRepository.ts +0 -88
  449. package/src/database/repository/workerRepository.ts +0 -69
  450. package/src/database/service/database.ts +0 -90
  451. package/src/database/service/handleService.ts +0 -48
  452. package/src/database/service/index.ts +0 -16
  453. package/src/database/service/messageService.ts +0 -61
  454. package/src/database/service/objectService.ts +0 -59
  455. package/src/database/service/processService.ts +0 -61
  456. package/src/database/service/registryServices.ts +0 -88
  457. package/src/database/service/service.ts +0 -183
  458. package/src/database/service/stepService.ts +0 -53
  459. package/src/database/service/threadService.ts +0 -65
  460. package/src/database/service/windowService.ts +0 -30
  461. package/src/database/service/workerService.ts +0 -57
  462. package/src/database/sql/index.ts +0 -3
  463. package/src/database/sql/schema.ts +0 -418
  464. package/src/database/sql/sql.ts +0 -543
  465. package/src/database/store/database.ts +0 -210
  466. package/src/database/store/index.ts +0 -3
  467. package/src/database/store/store.ts +0 -266
  468. package/src/delegate/index.ts +0 -2
  469. package/src/delegate/team.ts +0 -268
  470. package/src/delegate/teamTypes.ts +0 -47
  471. package/src/diagnosis/checklist.ts +0 -74
  472. package/src/diagnosis/context.ts +0 -93
  473. package/src/diagnosis/frame.ts +0 -256
  474. package/src/diagnosis/index.ts +0 -5
  475. package/src/diagnosis/router.ts +0 -72
  476. package/src/diagnosis/types.ts +0 -89
  477. package/src/error/agentError.ts +0 -16
  478. package/src/error/ampError.ts +0 -20
  479. package/src/error/authzError.ts +0 -14
  480. package/src/error/boundaryRejection.ts +0 -20
  481. package/src/error/index.ts +0 -7
  482. package/src/error/kernelError.ts +0 -27
  483. package/src/error/mailboxError.ts +0 -9
  484. package/src/error/windowError.ts +0 -12
  485. package/src/evaluation/agreement.ts +0 -96
  486. package/src/evaluation/index.ts +0 -2
  487. package/src/evaluation/labels.ts +0 -241
  488. package/src/evidence/evidenceGraph.ts +0 -205
  489. package/src/evidence/index.ts +0 -4
  490. package/src/evidence/revalidation.ts +0 -191
  491. package/src/execution/exec.ts +0 -408
  492. package/src/execution/handles.ts +0 -65
  493. package/src/execution/index.ts +0 -3
  494. package/src/execution/pin.ts +0 -154
  495. package/src/frame/frame.ts +0 -70
  496. package/src/frame/index.ts +0 -1
  497. package/src/goal/goal.ts +0 -43
  498. package/src/goal/index.ts +0 -2
  499. package/src/goal/plan.ts +0 -196
  500. package/src/governance/attentionManifest.ts +0 -802
  501. package/src/governance/audit.ts +0 -362
  502. package/src/governance/budget.ts +0 -628
  503. package/src/governance/context.ts +0 -356
  504. package/src/governance/control.ts +0 -159
  505. package/src/governance/cooperation.ts +0 -479
  506. package/src/governance/credential.ts +0 -359
  507. package/src/governance/httpServer.ts +0 -99
  508. package/src/governance/index.ts +0 -32
  509. package/src/governance/legal.ts +0 -574
  510. package/src/governance/matrix.ts +0 -460
  511. package/src/governance/perspectives.ts +0 -406
  512. package/src/governance/signing.ts +0 -407
  513. package/src/governance/store.ts +0 -125
  514. package/src/governance/switching.ts +0 -459
  515. package/src/governance/toolPolicy.ts +0 -80
  516. package/src/governance/transport.ts +0 -204
  517. package/src/governance/types.ts +0 -380
  518. package/src/governance/workflow.ts +0 -743
  519. package/src/index.ts +0 -11
  520. package/src/interaction/index.ts +0 -1
  521. package/src/interaction/interaction.ts +0 -391
  522. package/src/ipc/index.ts +0 -4
  523. package/src/ipc/mailbox.ts +0 -132
  524. package/src/ipc/memorySocialStore.ts +0 -93
  525. package/src/ipc/social.ts +0 -93
  526. package/src/kernel/index.ts +0 -14
  527. package/src/kernel/scheduler.ts +0 -498
  528. package/src/ledger/checkpoint.ts +0 -304
  529. package/src/ledger/index.ts +0 -4
  530. package/src/ledger/ledger.ts +0 -31
  531. package/src/ledger/persistence.ts +0 -159
  532. package/src/ledger/share.ts +0 -80
  533. package/src/lock/index.ts +0 -2
  534. package/src/lock/lease.ts +0 -74
  535. package/src/main.ts +0 -199
  536. package/src/manifest/agentCard.ts +0 -72
  537. package/src/manifest/cardSign.ts +0 -87
  538. package/src/manifest/federation.ts +0 -237
  539. package/src/manifest/federationTypes.ts +0 -55
  540. package/src/manifest/index.ts +0 -8
  541. package/src/manifest/keys.ts +0 -643
  542. package/src/manifest/manifest.ts +0 -114
  543. package/src/manifest/sign.ts +0 -134
  544. package/src/manifest/trust.ts +0 -146
  545. package/src/mission/index.ts +0 -2
  546. package/src/mission/missionQueue.ts +0 -75
  547. package/src/module/index.ts +0 -9
  548. package/src/module/llm/deepseek.ts +0 -214
  549. package/src/module/llm/llm.ts +0 -84
  550. package/src/module/mcp/client.ts +0 -110
  551. package/src/module/mcp/http.ts +0 -102
  552. package/src/module/mcp/protocol.ts +0 -77
  553. package/src/module/mcp/server.ts +0 -148
  554. package/src/module/mcp/transport.ts +0 -30
  555. package/src/module/mcp/workspaceServer.ts +0 -111
  556. package/src/module/sandbox/sandbox.ts +0 -29
  557. package/src/module/tool/mcpExecutor.ts +0 -54
  558. package/src/module/tool/policy.ts +0 -52
  559. package/src/module/tool/redact.ts +0 -29
  560. package/src/module/tool/tool.ts +0 -53
  561. package/src/module/tool/workspaceExecutor.ts +0 -35
  562. package/src/policy/guard.ts +0 -240
  563. package/src/policy/index.ts +0 -2
  564. package/src/policy/policy.ts +0 -561
  565. package/src/process/agent.ts +0 -341
  566. package/src/process/agentService.ts +0 -236
  567. package/src/process/agentStore.ts +0 -378
  568. package/src/process/executionStore.ts +0 -151
  569. package/src/process/index.ts +0 -5
  570. package/src/process/process.ts +0 -240
  571. package/src/process/transitions.ts +0 -19
  572. package/src/progress/index.ts +0 -2
  573. package/src/progress/progress.ts +0 -85
  574. package/src/protocol/a2a.ts +0 -120
  575. package/src/protocol/channel.ts +0 -44
  576. package/src/protocol/envelope.ts +0 -655
  577. package/src/protocol/httpChannel.ts +0 -87
  578. package/src/protocol/index.ts +0 -6
  579. package/src/protocol/protocol.ts +0 -138
  580. package/src/protocol/wire.ts +0 -60
  581. package/src/receipt/index.ts +0 -1
  582. package/src/receipt/receipt.ts +0 -47
  583. package/src/registry/content.ts +0 -69
  584. package/src/registry/index.ts +0 -23
  585. package/src/registry/registry.ts +0 -599
  586. package/src/runtime/action.ts +0 -87
  587. package/src/runtime/behavior.ts +0 -330
  588. package/src/runtime/behaviorTuning.ts +0 -163
  589. package/src/runtime/cognitiveRuntime.ts +0 -703
  590. package/src/runtime/escalation.ts +0 -35
  591. package/src/runtime/governedTask.ts +0 -233
  592. package/src/runtime/index.ts +0 -15
  593. package/src/runtime/kernelRuntime.ts +0 -144
  594. package/src/runtime/operation.ts +0 -35
  595. package/src/runtime/replay.ts +0 -71
  596. package/src/runtime/routing.ts +0 -58
  597. package/src/runtime/safety.ts +0 -48
  598. package/src/runtime/session.ts +0 -341
  599. package/src/runtime/sessionStore.ts +0 -43
  600. package/src/runtime/telemetry.ts +0 -55
  601. package/src/runtime/turnStore.ts +0 -30
  602. package/src/scenario/index.ts +0 -1
  603. package/src/scenario/scenario.ts +0 -299
  604. package/src/semantic/canonical.ts +0 -24
  605. package/src/semantic/index.ts +0 -2
  606. package/src/semantic/sha256.ts +0 -82
  607. package/src/storage/appendLog.ts +0 -372
  608. package/src/storage/fileAppendSink.ts +0 -40
  609. package/src/storage/index.ts +0 -2
  610. package/src/store/bindCache.ts +0 -22
  611. package/src/store/cache.ts +0 -191
  612. package/src/store/context.ts +0 -31
  613. package/src/store/handleStore.ts +0 -31
  614. package/src/store/index.ts +0 -9
  615. package/src/store/messageStore.ts +0 -31
  616. package/src/store/objectStore.ts +0 -31
  617. package/src/store/processStore.ts +0 -31
  618. package/src/store/threadStore.ts +0 -31
  619. package/src/store/windowStore.ts +0 -31
  620. package/src/structure/abstractSyntaxTree.ts +0 -493
  621. package/src/structure/avlTree.ts +0 -408
  622. package/src/structure/binarySearchTree.ts +0 -352
  623. package/src/structure/binaryTree.ts +0 -525
  624. package/src/structure/bloomFilter.ts +0 -231
  625. package/src/structure/compare.ts +0 -110
  626. package/src/structure/cuckooFilter.ts +0 -337
  627. package/src/structure/deque.ts +0 -223
  628. package/src/structure/filterKey.ts +0 -36
  629. package/src/structure/hash.ts +0 -279
  630. package/src/structure/heap.ts +0 -268
  631. package/src/structure/index.ts +0 -20
  632. package/src/structure/iterator.ts +0 -22
  633. package/src/structure/lru.ts +0 -619
  634. package/src/structure/ordered.ts +0 -399
  635. package/src/structure/priority.ts +0 -915
  636. package/src/structure/queue.ts +0 -168
  637. package/src/structure/redBlackTree.ts +0 -680
  638. package/src/structure/segmentTree.ts +0 -248
  639. package/src/structure/stack.ts +0 -118
  640. package/src/structure/unordered.ts +0 -407
  641. package/src/style.css +0 -278
  642. package/src/thread/index.ts +0 -2
  643. package/src/thread/thread.ts +0 -176
  644. package/src/thread/transitions.ts +0 -17
  645. package/src/types/common.ts +0 -119
  646. package/src/types/index.ts +0 -23
  647. package/src/warrant/epistemic.ts +0 -154
  648. package/src/warrant/index.ts +0 -3
  649. package/src/warrant/inquiry.ts +0 -166
  650. package/src/warrant/warrant.ts +0 -179
  651. package/src/window/compaction.ts +0 -403
  652. package/src/window/compactionTypes.ts +0 -119
  653. package/src/window/index.ts +0 -7
  654. package/src/window/page.ts +0 -18
  655. package/src/window/window.ts +0 -244
  656. package/tools/_helpers.ts +0 -34
  657. package/tools/a2a-check.ts +0 -110
  658. package/tools/a2a-flow-check.ts +0 -78
  659. package/tools/agent-card-check.ts +0 -76
  660. package/tools/agent-check.ts +0 -236
  661. package/tools/agent-store-check.ts +0 -153
  662. package/tools/agreement-check.ts +0 -27
  663. package/tools/annotation-server-check.ts +0 -48
  664. package/tools/annotation-server.ts +0 -230
  665. package/tools/annotation-status.ts +0 -65
  666. package/tools/approval-access-check.ts +0 -66
  667. package/tools/arch-check.ts +0 -72
  668. package/tools/attention-core-check.ts +0 -48
  669. package/tools/attention-resource-check.ts +0 -169
  670. package/tools/audit-check.ts +0 -207
  671. package/tools/authority-check.ts +0 -124
  672. package/tools/authz-check.ts +0 -138
  673. package/tools/bayes-check.ts +0 -162
  674. package/tools/bayes-probe.ts +0 -154
  675. package/tools/behavior-tuning-check.ts +0 -53
  676. package/tools/board-check.ts +0 -87
  677. package/tools/boundary-check.ts +0 -199
  678. package/tools/bundle-trust-check.ts +0 -96
  679. package/tools/calibrate-imported.ts +0 -108
  680. package/tools/calibration-check.ts +0 -44
  681. package/tools/calibration-registry-check.ts +0 -40
  682. package/tools/calibration-sim.ts +0 -40
  683. package/tools/card-sign-check.ts +0 -71
  684. package/tools/card-trust-check.ts +0 -78
  685. package/tools/channel-check.ts +0 -86
  686. package/tools/checkpoint-check.ts +0 -620
  687. package/tools/cleanup-style-configs.ts +0 -29
  688. package/tools/cognition-check.ts +0 -648
  689. package/tools/cognitive-runtime-check.ts +0 -609
  690. package/tools/collaboration-demo.ts +0 -78
  691. package/tools/compaction-check.ts +0 -266
  692. package/tools/concept-check.ts +0 -260
  693. package/tools/concurrency-check.ts +0 -242
  694. package/tools/conformance-runtime.ts +0 -389
  695. package/tools/conformance.ts +0 -651
  696. package/tools/context-ast-check.ts +0 -90
  697. package/tools/context-ast-deepseek.ts +0 -242
  698. package/tools/context-graph-bench.ts +0 -50
  699. package/tools/context-graph-check.ts +0 -229
  700. package/tools/context-index-check.ts +0 -48
  701. package/tools/context-lifecycle-check.ts +0 -69
  702. package/tools/context-projection-check.ts +0 -73
  703. package/tools/context-scope-check.ts +0 -134
  704. package/tools/context-storage-check.ts +0 -113
  705. package/tools/cooperation-check.ts +0 -517
  706. package/tools/cooperation-http-check.ts +0 -125
  707. package/tools/deepseek-llm-check.ts +0 -147
  708. package/tools/deepseek-probe.ts +0 -494
  709. package/tools/diagnosis-check.ts +0 -109
  710. package/tools/diagnosis-router-check.ts +0 -50
  711. package/tools/document-context-check.ts +0 -237
  712. package/tools/envelope-check.ts +0 -659
  713. package/tools/eslint-rules/index.ts +0 -26
  714. package/tools/eslint-rules/rules/jsdoc-comment-format.ts +0 -105
  715. package/tools/eslint-rules/rules/no-function-keyword.ts +0 -60
  716. package/tools/eslint-rules/rules/no-multiline-parameters.ts +0 -71
  717. package/tools/eslint-rules/rules/no-multiline-type-parameters.ts +0 -57
  718. package/tools/eslint-rules/rules/no-undefined-comparison.ts +0 -115
  719. package/tools/eslint-rules/rules/prefer-template-for-string-conversion.ts +0 -97
  720. package/tools/eslint-rules/rules/require-typeof-parentheses.ts +0 -49
  721. package/tools/eslint-rules/rules/require-variable-type.ts +0 -36
  722. package/tools/eslint-rules/rules/variable-naming.ts +0 -175
  723. package/tools/eval-recorded-replay.ts +0 -215
  724. package/tools/eval-replay.ts +0 -139
  725. package/tools/eval-summary.ts +0 -136
  726. package/tools/evidence-revalidation-check.ts +0 -235
  727. package/tools/exec-check.ts +0 -217
  728. package/tools/federation-check.ts +0 -166
  729. package/tools/federation-demo.ts +0 -45
  730. package/tools/filter-check.ts +0 -243
  731. package/tools/governance-check.ts +0 -680
  732. package/tools/governance-store-check.ts +0 -131
  733. package/tools/governed-task-check.ts +0 -227
  734. package/tools/guard-check.ts +0 -122
  735. package/tools/http-channel-check.ts +0 -125
  736. package/tools/import-campaign.ts +0 -28
  737. package/tools/inquiry-check.ts +0 -126
  738. package/tools/interaction-check.ts +0 -171
  739. package/tools/interrupts-check.ts +0 -173
  740. package/tools/ipc-check.ts +0 -170
  741. package/tools/kernel-async-check.ts +0 -136
  742. package/tools/kernel-check.ts +0 -369
  743. package/tools/kernel-runtime-check.ts +0 -276
  744. package/tools/keys-check.ts +0 -559
  745. package/tools/label-audit.ts +0 -70
  746. package/tools/labels-workflow-check.ts +0 -49
  747. package/tools/linear-structure-check.ts +0 -524
  748. package/tools/live-exec.ts +0 -62
  749. package/tools/live-governance-eval.ts +0 -813
  750. package/tools/live-legacy.ts +0 -50
  751. package/tools/lru-check.ts +0 -182
  752. package/tools/make-annotation-campaign.ts +0 -57
  753. package/tools/mcp-executor-check.ts +0 -33
  754. package/tools/merge-annotations.ts +0 -32
  755. package/tools/merge-check.ts +0 -98
  756. package/tools/metrics-check.ts +0 -84
  757. package/tools/net-probe.ts +0 -107
  758. package/tools/oauth-probe.ts +0 -117
  759. package/tools/outbox-check.ts +0 -50
  760. package/tools/persistence-check.ts +0 -144
  761. package/tools/pin-check.ts +0 -116
  762. package/tools/platform-check.ts +0 -281
  763. package/tools/policy-check.ts +0 -514
  764. package/tools/prettier-plugin/index.mts +0 -84
  765. package/tools/priority-check.ts +0 -627
  766. package/tools/probe-context7.ts +0 -63
  767. package/tools/registry-check.ts +0 -252
  768. package/tools/reliability-check.ts +0 -25
  769. package/tools/retry-check.ts +0 -85
  770. package/tools/rewrite-declaration-extensions.ts +0 -98
  771. package/tools/runtime-check.ts +0 -165
  772. package/tools/runtime-deepseek-check.ts +0 -85
  773. package/tools/runtime-eval.ts +0 -358
  774. package/tools/scenario-check.ts +0 -161
  775. package/tools/scenario-incident.ts +0 -162
  776. package/tools/scoped-priors-check.ts +0 -35
  777. package/tools/scoped-priors-pooling.ts +0 -34
  778. package/tools/segment-ast-check.ts +0 -649
  779. package/tools/session-check.ts +0 -196
  780. package/tools/session-store-check.ts +0 -73
  781. package/tools/share-check.ts +0 -88
  782. package/tools/sign-check.ts +0 -95
  783. package/tools/signing-check.ts +0 -275
  784. package/tools/snapshot-demo.ts +0 -65
  785. package/tools/social-check.ts +0 -146
  786. package/tools/structure-compare-check.ts +0 -95
  787. package/tools/support/documentScanner.ts +0 -577
  788. package/tools/support/texScanner.ts +0 -631
  789. package/tools/support/workspaceScanner.ts +0 -476
  790. package/tools/team-check.ts +0 -163
  791. package/tools/team-demo.ts +0 -36
  792. package/tools/telemetry-check.ts +0 -44
  793. package/tools/tex-context-check.ts +0 -263
  794. package/tools/tool-gate-check.ts +0 -98
  795. package/tools/tree-structure-check.ts +0 -786
  796. package/tools/trust-flow-check.ts +0 -158
  797. package/tools/turn-store-check.ts +0 -57
  798. package/tools/unified-check.ts +0 -83
  799. package/tools/validate.ts +0 -309
  800. package/tools/wire-check.ts +0 -96
  801. package/tools/workspace-agent-check.ts +0 -486
  802. package/tools/workspace-agent-demo.ts +0 -62
  803. package/tools/workspace-agent-server.ts +0 -101
  804. package/tools/workspace-context-check.ts +0 -331
  805. package/tools/workspace-context.ts +0 -131
  806. package/tsconfig.build.json +0 -14
  807. package/tsconfig.json +0 -24
  808. package/tsconfig.tools.json +0 -31
  809. package/viz/context-ast.json +0 -1577
@@ -0,0 +1,327 @@
1
+ import { canonical } from "../../semantic/canonical.js";
2
+ import { SessionContextTable, SessionRootTable, WorkspaceSessionTable } from "../entity/workspaceSession.js";
3
+ import { assertSqlIdentifier, TableSql } from "../sql/sql.js";
4
+ import { transaction } from "../store/database.js";
5
+ import { BaseRepository } from "./base.js";
6
+ /**
7
+ * Quote a column that is declared by the table metadata.
8
+ *
9
+ * Custom statements must never invent identifiers: the column is checked
10
+ * against {@link TableMeta.columns} before it reaches the SQL string.
11
+ *
12
+ * @param meta - Table metadata.
13
+ * @param column - Column name.
14
+ * @returns Double-quoted column name.
15
+ */
16
+ const quoted = (meta, column) => {
17
+ if (!meta.columns.includes(column)) {
18
+ throw new Error(`unknown column for ${meta.table}: ${column}`);
19
+ }
20
+ return `"${assertSqlIdentifier(column)}"`;
21
+ };
22
+ /**
23
+ * Build a bound `column = ?` conjunction from declared columns.
24
+ *
25
+ * @param meta - Table metadata.
26
+ * @param columns - Column names in bind order.
27
+ * @returns SQL fragment with one placeholder per column.
28
+ */
29
+ const conditions = (meta, columns) => columns.map((column) => `${quoted(meta, column)} = ?`).join(" AND ");
30
+ /**
31
+ * Validate the persisted lifecycle status against the closed set.
32
+ *
33
+ * @param value - Stored status text.
34
+ * @returns The validated status.
35
+ * @throws Error when the row holds a status the domain does not know.
36
+ */
37
+ const parseStatus = (value) => {
38
+ if (value === "active" || value === "suspended" || value === "revoked" || value === "expired") {
39
+ return value;
40
+ }
41
+ throw new Error(`invalid workspace session status: ${value}`);
42
+ };
43
+ /**
44
+ * Deterministic context primary key.
45
+ *
46
+ * NUL is the separator, so a component that contains NUL would alias another
47
+ * `(namespace, key)` pair on the primary key while differing on the unique
48
+ * triple. Such a component is rejected instead of silently renaming a row.
49
+ *
50
+ * @param sessionId - Session handle.
51
+ * @param namespace - Context namespace.
52
+ * @param key - Namespace-local key.
53
+ * @returns `sessionId\0namespace\0key`.
54
+ * @throws Error when a component contains NUL.
55
+ */
56
+ const entryId = (sessionId, namespace, key) => {
57
+ if (sessionId.includes("\u0000") || namespace.includes("\u0000") || key.includes("\u0000")) {
58
+ throw new Error("session context components must not contain U+0000");
59
+ }
60
+ return `${sessionId}\u0000${namespace}\u0000${key}`;
61
+ };
62
+ /**
63
+ * Reject a context byte count that cannot be a canonical size.
64
+ *
65
+ * @param value - Caller-supplied canonical UTF-8 size.
66
+ * @throws RangeError when the value is not a non-negative integer.
67
+ */
68
+ const assertBytes = (value) => {
69
+ if (!Number.isInteger(value) || value < 0) {
70
+ throw new RangeError("context bytes must be a non-negative integer");
71
+ }
72
+ };
73
+ /**
74
+ * Parse the persisted permission object.
75
+ *
76
+ * The row is written by this repository, so the shape is trusted on read; the
77
+ * cast keeps the column boundary in one place.
78
+ *
79
+ * @param json - Canonical JSON text.
80
+ * @returns Permission set.
81
+ */
82
+ const parsePermissions = (json) => JSON.parse(json);
83
+ /**
84
+ * Parse the persisted metadata object.
85
+ *
86
+ * @param json - Canonical JSON text.
87
+ * @returns Host metadata.
88
+ */
89
+ const parseMetadata = (json) => JSON.parse(json);
90
+ /**
91
+ * Parse the persisted exclusion list.
92
+ *
93
+ * @param json - Canonical JSON text.
94
+ * @returns Excluded sub-paths.
95
+ */
96
+ const parseExcludes = (json) => JSON.parse(json);
97
+ /**
98
+ * Repository for `workspace_sessions`, `session_roots` and `session_context`.
99
+ */
100
+ export class WorkspaceSessionRepository extends BaseRepository {
101
+ rootsSql;
102
+ contextSql;
103
+ /**
104
+ * Create the repository.
105
+ *
106
+ * @param db - Open SQLite connection.
107
+ */
108
+ constructor(db) {
109
+ super(db, WorkspaceSessionTable);
110
+ this.rootsSql = new TableSql(db, SessionRootTable);
111
+ this.contextSql = new TableSql(db, SessionContextTable);
112
+ }
113
+ /**
114
+ * Insert or replace one session descriptor and its roots in one transaction.
115
+ *
116
+ * `permissions` and `metadata` are persisted as canonical JSON; `status` is
117
+ * validated before the write. Roots are replaced (delete, then insert) so a
118
+ * removed grant cannot survive a resave.
119
+ *
120
+ * @param descriptor - Public session record.
121
+ * @param tokenHash - `sha256:<hex>` bearer digest; never the token itself.
122
+ * @throws Error when the status is outside the closed lifecycle.
123
+ */
124
+ save(descriptor, tokenHash) {
125
+ const status = parseStatus(descriptor.status);
126
+ const values = {
127
+ session_id: descriptor.id,
128
+ agent_id: descriptor.agentId,
129
+ label: descriptor.label,
130
+ status,
131
+ token_hash: tokenHash,
132
+ permissions_json: canonical(descriptor.permissions),
133
+ created_at: descriptor.createdAt,
134
+ expires_at: descriptor.expiresAt,
135
+ idle_expires_at: descriptor.idleExpiresAt,
136
+ revision: descriptor.revision,
137
+ parent_id: descriptor.parentId ?? null,
138
+ metadata_json: canonical(descriptor.metadata),
139
+ };
140
+ transaction(this.db, () => {
141
+ this.upsert(values);
142
+ this.rootsSql.deleteWhere(conditions(SessionRootTable, ["session_id"]), descriptor.id);
143
+ for (let index = 0; index < descriptor.roots.length; index += 1) {
144
+ const root = descriptor.roots[index];
145
+ this.rootsSql.insert({
146
+ root_id: root.id,
147
+ session_id: descriptor.id,
148
+ path: root.path,
149
+ writable: root.writable ? 1 : 0,
150
+ excludes_json: canonical(root.exclude),
151
+ });
152
+ }
153
+ });
154
+ }
155
+ /**
156
+ * Load one descriptor with its roots.
157
+ *
158
+ * @param sessionId - Session handle.
159
+ * @returns Descriptor, or `undefined` when the session is unknown.
160
+ */
161
+ load(sessionId) {
162
+ const row = this.findById(sessionId);
163
+ return row === (void 0) ? undefined : this.toDescriptor(row);
164
+ }
165
+ /**
166
+ * Read the persisted bearer digest for authentication after a restart.
167
+ *
168
+ * @param sessionId - Session handle.
169
+ * @returns Token hash, or `undefined` when the session is unknown.
170
+ */
171
+ loadSecret(sessionId) {
172
+ const row = this.findById(sessionId);
173
+ return row === (void 0) ? undefined : row.token_hash;
174
+ }
175
+ delete(sessionId) {
176
+ return transaction(this.db, () => {
177
+ this.deleteContextSession(sessionId);
178
+ this.rootsSql.deleteWhere(conditions(SessionRootTable, ["session_id"]), sessionId);
179
+ return this.queries.delete(sessionId) > 0;
180
+ });
181
+ }
182
+ /**
183
+ * List sessions, optionally narrowed to one agent.
184
+ *
185
+ * @param agentId - Optional host-assigned agent identity.
186
+ * @returns Descriptors ordered by creation time and id.
187
+ */
188
+ list(agentId) {
189
+ const orderBy = `ORDER BY ${quoted(WorkspaceSessionTable, "created_at")} ASC, ${quoted(WorkspaceSessionTable, "session_id")} ASC`;
190
+ const rows = agentId === (void 0)
191
+ ? this.queries.select({ orderBy })
192
+ : this.queries.select({ where: conditions(WorkspaceSessionTable, ["agent_id"]), params: [agentId], orderBy });
193
+ const descriptors = [];
194
+ for (let index = 0; index < rows.length; index += 1) {
195
+ descriptors.push(this.toDescriptor(rows[index]));
196
+ }
197
+ return descriptors;
198
+ }
199
+ /**
200
+ * Read the authorized roots of one session.
201
+ *
202
+ * @param sessionId - Session handle.
203
+ * @returns Roots ordered by host path.
204
+ */
205
+ findRoots(sessionId) {
206
+ const rows = this.rootsSql.select({
207
+ where: conditions(SessionRootTable, ["session_id"]),
208
+ params: [sessionId],
209
+ orderBy: `ORDER BY ${quoted(SessionRootTable, "path")} ASC`,
210
+ });
211
+ const roots = [];
212
+ for (let index = 0; index < rows.length; index += 1) {
213
+ const row = rows[index];
214
+ roots.push({
215
+ id: row.root_id,
216
+ path: row.path,
217
+ writable: row.writable === 1,
218
+ exclude: parseExcludes(row.excludes_json),
219
+ });
220
+ }
221
+ return roots;
222
+ }
223
+ /**
224
+ * Read every context entry of one session.
225
+ *
226
+ * @param sessionId - Session handle.
227
+ * @returns Entries ordered by namespace and key.
228
+ */
229
+ loadContext(sessionId) {
230
+ const rows = this.contextSql.select({
231
+ where: conditions(SessionContextTable, ["session_id"]),
232
+ params: [sessionId],
233
+ orderBy: `ORDER BY ${quoted(SessionContextTable, "namespace")} ASC, ${quoted(SessionContextTable, "context_key")} ASC`,
234
+ });
235
+ const entries = [];
236
+ for (let index = 0; index < rows.length; index += 1) {
237
+ const row = rows[index];
238
+ entries.push({
239
+ namespace: row.namespace,
240
+ key: row.context_key,
241
+ value: JSON.parse(row.value_json),
242
+ bytes: row.bytes,
243
+ updatedAt: row.updated_at,
244
+ });
245
+ }
246
+ return entries;
247
+ }
248
+ /**
249
+ * Insert or replace one context entry.
250
+ *
251
+ * The value is stored as canonical JSON; `bytes` is the caller's canonical
252
+ * size and is persisted as given so quota accounting stays reproducible.
253
+ *
254
+ * @param sessionId - Session handle.
255
+ * @param entry - Context entry.
256
+ * @throws Error when the session id, namespace or key contains NUL.
257
+ * @throws RangeError when `bytes` is not a non-negative integer.
258
+ * @throws TypeError when the value cannot round-trip through canonical JSON.
259
+ */
260
+ putContext(sessionId, entry) {
261
+ assertBytes(entry.bytes);
262
+ this.contextSql.upsert({
263
+ entry_id: entryId(sessionId, entry.namespace, entry.key),
264
+ session_id: sessionId,
265
+ namespace: entry.namespace,
266
+ context_key: entry.key,
267
+ value_json: canonical(entry.value),
268
+ bytes: entry.bytes,
269
+ updated_at: entry.updatedAt,
270
+ });
271
+ }
272
+ /**
273
+ * Delete one context entry.
274
+ *
275
+ * @param sessionId - Session handle.
276
+ * @param namespace - Context namespace.
277
+ * @param key - Namespace-local key.
278
+ * @returns `true` when an entry was removed.
279
+ */
280
+ deleteContext(sessionId, namespace, key) {
281
+ return this.contextSql.deleteWhere(conditions(SessionContextTable, ["session_id", "namespace", "context_key"]), sessionId, namespace, key) > 0;
282
+ }
283
+ /**
284
+ * Delete every context entry of one session.
285
+ *
286
+ * @param sessionId - Session handle.
287
+ */
288
+ deleteContextSession(sessionId) {
289
+ this.contextSql.deleteWhere(conditions(SessionContextTable, ["session_id"]), sessionId);
290
+ }
291
+ /**
292
+ * Atomically replace the whole context of one session.
293
+ *
294
+ * @param sessionId - Session handle.
295
+ * @param entries - Complete new entry set.
296
+ */
297
+ replaceContext(sessionId, entries) {
298
+ transaction(this.db, () => {
299
+ this.deleteContextSession(sessionId);
300
+ for (let index = 0; index < entries.length; index += 1) {
301
+ this.putContext(sessionId, entries[index]);
302
+ }
303
+ });
304
+ }
305
+ /**
306
+ * Convert one row plus its roots into the public descriptor.
307
+ *
308
+ * @param row - Session row.
309
+ * @returns Descriptor; `parentId` is present only when the row has a parent.
310
+ */
311
+ toDescriptor(row) {
312
+ const base = {
313
+ id: row.session_id,
314
+ agentId: row.agent_id,
315
+ label: row.label,
316
+ status: parseStatus(row.status),
317
+ roots: this.findRoots(row.session_id),
318
+ permissions: parsePermissions(row.permissions_json),
319
+ createdAt: row.created_at,
320
+ expiresAt: row.expires_at,
321
+ idleExpiresAt: row.idle_expires_at,
322
+ revision: row.revision,
323
+ metadata: parseMetadata(row.metadata_json),
324
+ };
325
+ return row.parent_id === null ? base : { ...base, parentId: row.parent_id };
326
+ }
327
+ }
@@ -7,9 +7,16 @@
7
7
  */
8
8
  import type { DatabaseSync } from "node:sqlite";
9
9
  import { DatabaseAdapters } from "../adapter/adapters.js";
10
+ import { FileAnnotationRepository } from "../repository/fileAnnotationRepository.js";
11
+ import { FileGraphRepository } from "../repository/fileGraphRepository.js";
12
+ import { FileNodeRepository } from "../repository/fileNodeRepository.js";
13
+ import { FileOutlineRepository } from "../repository/fileOutlineRepository.js";
14
+ import { FileWriteRepository } from "../repository/fileWriteRepository.js";
10
15
  import { HandleRepository } from "../repository/handleRepository.js";
16
+ import { HookRepository } from "../repository/hookRepository.js";
11
17
  import { MessageRepository } from "../repository/messageRepository.js";
12
18
  import { ObjectRepository } from "../repository/objectRepository.js";
19
+ import { WorkspaceSessionRepository } from "../repository/workspaceSessionRepository.js";
13
20
  import { ProcessRepository } from "../repository/processRepository.js";
14
21
  import { AttestationRepository, ConceptRepository, ModuleRepository } from "../repository/registryRepository.js";
15
22
  import { StepRepository, WorkerRepository } from "../repository/workerRepository.js";
@@ -28,6 +35,13 @@ export declare class Database {
28
35
  readonly db: DatabaseSync;
29
36
  readonly adapters: DatabaseAdapters;
30
37
  readonly objects: ObjectRepository;
38
+ readonly workspaceSessions: WorkspaceSessionRepository;
39
+ readonly fileNodes: FileNodeRepository;
40
+ readonly fileAnnotations: FileAnnotationRepository;
41
+ readonly fileWrites: FileWriteRepository;
42
+ readonly fileOutlines: FileOutlineRepository;
43
+ readonly fileGraphs: FileGraphRepository;
44
+ readonly hookRuns: HookRepository;
31
45
  readonly processes: ProcessRepository;
32
46
  readonly threads: ThreadRepository;
33
47
  readonly handles: HandleRepository;
@@ -1,8 +1,15 @@
1
1
  import { closeStore, openStore, transaction } from "../store/database.js";
2
2
  import { DatabaseAdapters } from "../adapter/adapters.js";
3
+ import { FileAnnotationRepository } from "../repository/fileAnnotationRepository.js";
4
+ import { FileGraphRepository } from "../repository/fileGraphRepository.js";
5
+ import { FileNodeRepository } from "../repository/fileNodeRepository.js";
6
+ import { FileOutlineRepository } from "../repository/fileOutlineRepository.js";
7
+ import { FileWriteRepository } from "../repository/fileWriteRepository.js";
3
8
  import { HandleRepository } from "../repository/handleRepository.js";
9
+ import { HookRepository } from "../repository/hookRepository.js";
4
10
  import { MessageRepository } from "../repository/messageRepository.js";
5
11
  import { ObjectRepository } from "../repository/objectRepository.js";
12
+ import { WorkspaceSessionRepository } from "../repository/workspaceSessionRepository.js";
6
13
  import { ProcessRepository } from "../repository/processRepository.js";
7
14
  import { AttestationRepository, ConceptRepository, ModuleRepository } from "../repository/registryRepository.js";
8
15
  import { StepRepository, WorkerRepository } from "../repository/workerRepository.js";
@@ -21,6 +28,13 @@ export class Database {
21
28
  db;
22
29
  adapters;
23
30
  objects;
31
+ workspaceSessions;
32
+ fileNodes;
33
+ fileAnnotations;
34
+ fileWrites;
35
+ fileOutlines;
36
+ fileGraphs;
37
+ hookRuns;
24
38
  processes;
25
39
  threads;
26
40
  handles;
@@ -46,6 +60,13 @@ export class Database {
46
60
  this.db = openStore(path);
47
61
  this.adapters = new DatabaseAdapters(this.db);
48
62
  this.objects = new ObjectRepository(this.db);
63
+ this.workspaceSessions = new WorkspaceSessionRepository(this.db);
64
+ this.fileNodes = new FileNodeRepository(this.db);
65
+ this.fileAnnotations = new FileAnnotationRepository(this.db);
66
+ this.fileWrites = new FileWriteRepository(this.db);
67
+ this.fileOutlines = new FileOutlineRepository(this.db);
68
+ this.fileGraphs = new FileGraphRepository(this.db);
69
+ this.hookRuns = new HookRepository(this.db);
49
70
  this.processes = new ProcessRepository(this.db);
50
71
  this.threads = new ThreadRepository(this.db);
51
72
  this.handles = new HandleRepository(this.db);
@@ -413,4 +413,191 @@ CREATE TABLE IF NOT EXISTS runtime_approvals (
413
413
  created_at TEXT NOT NULL
414
414
  );
415
415
  CREATE INDEX IF NOT EXISTS runtime_approvals_pid ON runtime_approvals(pid, id DESC);
416
+
417
+ /* Workspace session identity. A session is the data-isolation boundary for one
418
+ agent's file work: roots, permissions, context and write journal are scoped
419
+ to it. The bearer token is never stored, only its sha256 digest. */
420
+ CREATE TABLE IF NOT EXISTS workspace_sessions (
421
+ session_id TEXT PRIMARY KEY,
422
+ agent_id TEXT NOT NULL,
423
+ label TEXT NOT NULL,
424
+ status TEXT NOT NULL CHECK(status IN ('active','suspended','revoked','expired')),
425
+ token_hash TEXT NOT NULL,
426
+ permissions_json TEXT NOT NULL,
427
+ created_at TEXT NOT NULL,
428
+ expires_at TEXT NOT NULL,
429
+ idle_expires_at TEXT NOT NULL,
430
+ revision INTEGER NOT NULL DEFAULT 0,
431
+ parent_id TEXT,
432
+ metadata_json TEXT NOT NULL DEFAULT '{}'
433
+ );
434
+ CREATE INDEX IF NOT EXISTS workspace_sessions_agent ON workspace_sessions(agent_id, status);
435
+ CREATE INDEX IF NOT EXISTS workspace_sessions_expiry ON workspace_sessions(status, expires_at);
436
+
437
+ /* Roots are normalized out of the descriptor so an authorization query never
438
+ has to parse JSON: the database itself can answer "which roots does this
439
+ session still have?" */
440
+ CREATE TABLE IF NOT EXISTS session_roots (
441
+ root_id TEXT PRIMARY KEY,
442
+ session_id TEXT NOT NULL REFERENCES workspace_sessions(session_id) ON DELETE CASCADE,
443
+ path TEXT NOT NULL,
444
+ writable INTEGER NOT NULL DEFAULT 0,
445
+ excludes_json TEXT NOT NULL DEFAULT '[]',
446
+ UNIQUE(session_id, path)
447
+ );
448
+ CREATE INDEX IF NOT EXISTS session_roots_session ON session_roots(session_id);
449
+
450
+ /* Per-session JSON context. entry_id is deterministic (session/namespace/key)
451
+ so an upsert is a single primary-key write and a fork can copy rows in one
452
+ statement. Quotas are enforced by the domain before the row is written. */
453
+ CREATE TABLE IF NOT EXISTS session_context (
454
+ entry_id TEXT PRIMARY KEY,
455
+ session_id TEXT NOT NULL REFERENCES workspace_sessions(session_id) ON DELETE CASCADE,
456
+ namespace TEXT NOT NULL,
457
+ context_key TEXT NOT NULL,
458
+ value_json TEXT NOT NULL,
459
+ bytes INTEGER NOT NULL,
460
+ updated_at TEXT NOT NULL,
461
+ UNIQUE(session_id, namespace, context_key)
462
+ );
463
+ CREATE INDEX IF NOT EXISTS session_context_session ON session_context(session_id, namespace);
464
+
465
+ /* Persisted file/directory tree. One row per node; parent_path is redundant with
466
+ path but makes direct-children queries an index seek. lines/bytes are decimal
467
+ TEXT because the domain uses bigint and SQLite INTEGER is signed 64-bit. */
468
+ CREATE TABLE IF NOT EXISTS file_nodes (
469
+ node_id TEXT PRIMARY KEY,
470
+ root_id TEXT NOT NULL,
471
+ path TEXT NOT NULL,
472
+ parent_path TEXT,
473
+ type TEXT NOT NULL CHECK(type IN ('File','Directory')),
474
+ name TEXT NOT NULL,
475
+ extension TEXT NOT NULL,
476
+ fingerprint TEXT NOT NULL,
477
+ charset TEXT NOT NULL,
478
+ lines TEXT NOT NULL,
479
+ bytes TEXT NOT NULL,
480
+ created_at TEXT NOT NULL,
481
+ modified_at TEXT NOT NULL,
482
+ description TEXT NOT NULL,
483
+ summary TEXT NOT NULL,
484
+ purpose TEXT NOT NULL,
485
+ revision TEXT NOT NULL,
486
+ updated_at TEXT NOT NULL,
487
+ UNIQUE(root_id, path)
488
+ );
489
+ CREATE INDEX IF NOT EXISTS file_nodes_parent ON file_nodes(root_id, parent_path);
490
+ CREATE INDEX IF NOT EXISTS file_nodes_type ON file_nodes(root_id, type);
491
+
492
+ /* Host annotation overrides derived metadata. Kept apart from file_nodes so a
493
+ re-index cannot overwrite a human/agent annotation silently. */
494
+ CREATE TABLE IF NOT EXISTS file_annotations (
495
+ annotation_id TEXT PRIMARY KEY,
496
+ root_id TEXT NOT NULL,
497
+ path TEXT NOT NULL,
498
+ description TEXT,
499
+ summary TEXT,
500
+ purpose TEXT,
501
+ source TEXT NOT NULL,
502
+ updated_at TEXT NOT NULL,
503
+ UNIQUE(root_id, path)
504
+ );
505
+
506
+ /* Append-only write journal. Metadata only: content lives in the workspace file
507
+ and, when configured, in the CAS. A session's history is (session_id, at). */
508
+ CREATE TABLE IF NOT EXISTS file_writes (
509
+ write_id INTEGER PRIMARY KEY AUTOINCREMENT,
510
+ session_id TEXT NOT NULL,
511
+ root_id TEXT NOT NULL,
512
+ path TEXT NOT NULL,
513
+ mode TEXT NOT NULL,
514
+ previous_fingerprint TEXT,
515
+ next_fingerprint TEXT NOT NULL,
516
+ bytes TEXT NOT NULL,
517
+ at TEXT NOT NULL
518
+ );
519
+ CREATE INDEX IF NOT EXISTS file_writes_session ON file_writes(session_id, write_id DESC);
520
+ CREATE INDEX IF NOT EXISTS file_writes_path ON file_writes(root_id, path);
521
+
522
+ /* Outline cache keyed by fingerprint, so an unchanged file never pays for the
523
+ parser again and a changed one cannot read a stale tree. */
524
+ CREATE TABLE IF NOT EXISTS file_outlines (
525
+ outline_id TEXT PRIMARY KEY,
526
+ root_id TEXT NOT NULL,
527
+ path TEXT NOT NULL,
528
+ fingerprint TEXT NOT NULL,
529
+ language TEXT NOT NULL,
530
+ charset TEXT NOT NULL,
531
+ data_json TEXT NOT NULL,
532
+ truncated INTEGER NOT NULL DEFAULT 0,
533
+ created_at TEXT NOT NULL
534
+ );
535
+ CREATE INDEX IF NOT EXISTS file_outlines_path ON file_outlines(root_id, path, fingerprint);
536
+
537
+ /* Static import edges. (root, from, fingerprint) scopes a generation; to_path is
538
+ the resolved path for internal edges and the bare specifier for external. */
539
+ CREATE TABLE IF NOT EXISTS file_imports (
540
+ import_id TEXT PRIMARY KEY,
541
+ root_id TEXT NOT NULL,
542
+ from_path TEXT NOT NULL,
543
+ to_path TEXT NOT NULL,
544
+ specifier TEXT NOT NULL,
545
+ kind TEXT NOT NULL,
546
+ line INTEGER NOT NULL,
547
+ resolved INTEGER NOT NULL,
548
+ external INTEGER NOT NULL,
549
+ fingerprint TEXT NOT NULL,
550
+ created_at TEXT NOT NULL
551
+ );
552
+ CREATE INDEX IF NOT EXISTS file_imports_from ON file_imports(root_id, from_path);
553
+ CREATE INDEX IF NOT EXISTS file_imports_to ON file_imports(root_id, to_path);
554
+
555
+ /* Exported symbols. reexport_from is set for "export ... from" edges. */
556
+ CREATE TABLE IF NOT EXISTS file_exports (
557
+ export_id TEXT PRIMARY KEY,
558
+ root_id TEXT NOT NULL,
559
+ path TEXT NOT NULL,
560
+ name TEXT NOT NULL,
561
+ kind TEXT NOT NULL,
562
+ line INTEGER NOT NULL,
563
+ signature TEXT NOT NULL,
564
+ reexport_from TEXT,
565
+ fingerprint TEXT NOT NULL,
566
+ created_at TEXT NOT NULL
567
+ );
568
+ CREATE INDEX IF NOT EXISTS file_exports_path ON file_exports(root_id, path, fingerprint);
569
+
570
+ /* Project-level directed dependency edges derived from imports, re-exports and
571
+ package manifests. Descriptive only; cycles are legal and reported, not
572
+ "repaired" by dropping edges. */
573
+ CREATE TABLE IF NOT EXISTS file_dependencies (
574
+ dependency_id TEXT PRIMARY KEY,
575
+ root_id TEXT NOT NULL,
576
+ from_path TEXT NOT NULL,
577
+ to_path TEXT NOT NULL,
578
+ kind TEXT NOT NULL,
579
+ method TEXT NOT NULL,
580
+ fingerprint TEXT NOT NULL,
581
+ created_at TEXT NOT NULL
582
+ );
583
+ CREATE INDEX IF NOT EXISTS file_dependencies_from ON file_dependencies(root_id, from_path);
584
+ CREATE INDEX IF NOT EXISTS file_dependencies_to ON file_dependencies(root_id, to_path);
585
+
586
+ /* Hook audit trail. A hook is a read-mostly composition over the filesystem
587
+ domain; the row records what it observed, not a copy of the file content. */
588
+ CREATE TABLE IF NOT EXISTS hook_runs (
589
+ run_id TEXT PRIMARY KEY,
590
+ session_id TEXT NOT NULL,
591
+ hook TEXT NOT NULL,
592
+ path TEXT,
593
+ status TEXT NOT NULL CHECK(status IN ('ready','error')),
594
+ error TEXT,
595
+ revision TEXT NOT NULL,
596
+ input_digest TEXT NOT NULL,
597
+ output_digest TEXT NOT NULL,
598
+ started_at TEXT NOT NULL,
599
+ duration_ms INTEGER NOT NULL,
600
+ meta_json TEXT NOT NULL DEFAULT '{}'
601
+ );
602
+ CREATE INDEX IF NOT EXISTS hook_runs_session ON hook_runs(session_id, started_at DESC);
416
603
  `;
@@ -75,7 +75,12 @@ export const transaction = (db, fn) => {
75
75
  return result;
76
76
  }
77
77
  catch (error) {
78
- db.exec("ROLLBACK");
78
+ try {
79
+ db.exec("ROLLBACK");
80
+ }
81
+ catch {
82
+ // Never mask the operation failure with a secondary rollback error.
83
+ }
79
84
  throw error;
80
85
  }
81
86
  };
@@ -3,6 +3,10 @@ import type { TeamManifest } from "./teamTypes.js";
3
3
  export interface Delegation {
4
4
  id: Id;
5
5
  parent?: Id;
6
+ /**
7
+ * Optional responsibility assignment that authorises this task transfer.
8
+ */
9
+ assignment?: Id;
6
10
  granter: Id;
7
11
  delegatee: Id;
8
12
  goalDigest: Digest;
@@ -59,6 +63,7 @@ export declare class TeamRuntime {
59
63
  private readonly activeByGoal;
60
64
  private readonly fences;
61
65
  private readonly reserved;
66
+ private readonly unsettled;
62
67
  private readonly spent;
63
68
  private readonly now;
64
69
  private seq;