@sema-agent/core 7.66.1 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -7,7 +7,10 @@ const G = SESSION_RULES_GRAMMAR;
7
7
  const A = "KitToolA";
8
8
  const B = "KitToolB";
9
9
  const fresh = () => `kit-2151-${randomUUID()}`;
10
+ const declared = (rules) => ({ ...rules, grammar: G });
11
+ const replayed = (row) => ({ ...row, grammar: row.grammar ?? 0 });
10
12
  const isLoosenRefusal = (e) => e instanceof SessionPolicyError && e.code === "loosen_forbidden";
13
+ const isGrammarRequired = (e) => e instanceof SessionPolicyError && e.code === "grammar_required";
11
14
  async function partOf(store, sessionId) {
12
15
  const row = await store.getRules(sessionId, OWNER);
13
16
  assert.ok(row !== null, "the row the case wrote must read back");
@@ -20,18 +23,18 @@ export async function sessionPolicyStoreContract(make, runAssertion) {
20
23
  run("a non-operator write over no row stamps an EMPTY operator part — the owner takes its own deny back", async () => {
21
24
  const store = make();
22
25
  const sid = fresh();
23
- await store.putRules(sid, OWNER, { toolDeny: [A] });
26
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A] }));
24
27
  assert.deepEqual(await partOf(store, sid), { grammar: G });
25
- const back = await store.putRules(sid, OWNER, {});
28
+ const back = await store.putRules(sid, OWNER, declared({}));
26
29
  assert.equal(back.toolDeny, undefined);
27
30
  assert.deepEqual(await partOf(store, sid), { grammar: G });
28
31
  });
29
32
  run("an operator write's whole value is the operator's: no part on the row, and the owner's drop of its entry is refused with nothing written", async () => {
30
33
  const store = make();
31
34
  const sid = fresh();
32
- const stored = await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
35
+ const stored = await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
33
36
  assert.equal(await partOf(store, sid), undefined);
34
- await assert.rejects(store.putRules(sid, OWNER, {}), isLoosenRefusal);
37
+ await assert.rejects(store.putRules(sid, OWNER, declared({})), isLoosenRefusal);
35
38
  const row = await store.getRules(sid, OWNER);
36
39
  assert.equal(row?.rev, stored.rev);
37
40
  assert.deepEqual(row?.toolDeny, [A]);
@@ -39,42 +42,42 @@ export async function sessionPolicyStoreContract(make, runAssertion) {
39
42
  run("an owner write over an operator row carries the operator's buckets as its part — above them it adds and takes back, below them it is refused", async () => {
40
43
  const store = make();
41
44
  const sid = fresh();
42
- await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
43
- await store.putRules(sid, OWNER, { toolDeny: [A, B] });
45
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
46
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A, B] }));
44
47
  assert.deepEqual(await partOf(store, sid), { toolDeny: [A], grammar: G });
45
- await store.putRules(sid, OWNER, { toolDeny: [A] });
48
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A] }));
46
49
  assert.deepEqual((await store.getRules(sid, OWNER))?.toolDeny, [A]);
47
- await assert.rejects(store.putRules(sid, OWNER, {}), isLoosenRefusal);
50
+ await assert.rejects(store.putRules(sid, OWNER, declared({})), isLoosenRefusal);
48
51
  assert.deepEqual(await partOf(store, sid), { toolDeny: [A], grammar: G });
49
52
  });
50
53
  run("the same entry from both writers: once an operator write carries it, the owner's drop is refused", async () => {
51
54
  const store = make();
52
55
  const sid = fresh();
53
- await store.putRules(sid, OWNER, { toolDeny: [A] });
54
- await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
55
- await assert.rejects(store.putRules(sid, OWNER, {}), isLoosenRefusal);
56
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A] }));
57
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
58
+ await assert.rejects(store.putRules(sid, OWNER, declared({})), isLoosenRefusal);
56
59
  assert.deepEqual((await store.getRules(sid, OWNER))?.toolDeny, [A]);
57
60
  });
58
61
  run("a part handed in with the value is no authority: the stored part is the judge's", async () => {
59
62
  const store = make();
60
63
  const sid = fresh();
61
- await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
62
- const forged = { toolDeny: [A, B], operatorRules: { grammar: G } };
64
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
65
+ const forged = { toolDeny: [A, B], grammar: G, operatorRules: { grammar: G } };
63
66
  await store.putRules(sid, OWNER, forged);
64
67
  assert.deepEqual(await partOf(store, sid), { toolDeny: [A], grammar: G });
65
- await assert.rejects(store.putRules(sid, OWNER, {}), isLoosenRefusal);
68
+ await assert.rejects(store.putRules(sid, OWNER, declared({})), isLoosenRefusal);
66
69
  });
67
70
  run("allowDirs: the owner's own confinement is the owner's to remove; an operator's is not", async () => {
68
71
  const store = make();
69
72
  const own = fresh();
70
- await store.putRules(own, OWNER, { allowDirs: ["/work/src"] });
71
- await store.putRules(own, OWNER, {});
73
+ await store.putRules(own, OWNER, declared({ allowDirs: ["/work/src"] }));
74
+ await store.putRules(own, OWNER, declared({}));
72
75
  assert.equal((await store.getRules(own, OWNER))?.allowDirs, undefined);
73
76
  const operators = fresh();
74
- await store.putRules(operators, OWNER, { allowDirs: ["/work"] }, { operator: true });
75
- await store.putRules(operators, OWNER, { allowDirs: ["/work/src"] });
76
- await store.putRules(operators, OWNER, { allowDirs: ["/work"] });
77
- await assert.rejects(store.putRules(operators, OWNER, {}), isLoosenRefusal);
77
+ await store.putRules(operators, OWNER, declared({ allowDirs: ["/work"] }), { operator: true });
78
+ await store.putRules(operators, OWNER, declared({ allowDirs: ["/work/src"] }));
79
+ await store.putRules(operators, OWNER, declared({ allowDirs: ["/work"] }));
80
+ await assert.rejects(store.putRules(operators, OWNER, declared({})), isLoosenRefusal);
78
81
  assert.deepEqual((await store.getRules(operators, OWNER))?.allowDirs, ["/work"]);
79
82
  });
80
83
  run("a stored row replayed by a non-operator onto a fresh or erased key keeps who may take what back (an import's replay)", async () => {
@@ -82,35 +85,36 @@ export async function sessionPolicyStoreContract(make, runAssertion) {
82
85
  const exported = async (sid) => {
83
86
  const records = store.listBySession !== undefined ? await store.listBySession(sid) : [{ principal: OWNER, rules: (await store.getRules(sid, OWNER)) }];
84
87
  assert.equal(records.length, 1);
85
- return records[0].rules;
88
+ return replayed(records[0].rules);
86
89
  };
87
90
  const opSid = fresh();
88
- await store.putRules(opSid, OWNER, { toolDeny: [A] }, { operator: true });
91
+ await store.putRules(opSid, OWNER, declared({ toolDeny: [A] }), { operator: true });
89
92
  const opRow = await exported(opSid);
90
- const replayed = fresh();
91
- await store.putRules(replayed, OWNER, opRow);
92
- await assert.rejects(store.putRules(replayed, OWNER, {}), isLoosenRefusal);
93
+ const replay = fresh();
94
+ await store.putRules(replay, OWNER, opRow);
95
+ await assert.rejects(store.putRules(replay, OWNER, declared({})), isLoosenRefusal);
93
96
  const mixedSid = fresh();
94
- await store.putRules(mixedSid, OWNER, { toolDeny: [A] }, { operator: true });
95
- await store.putRules(mixedSid, OWNER, { toolDeny: [A, B] });
97
+ await store.putRules(mixedSid, OWNER, declared({ toolDeny: [A] }), { operator: true });
98
+ await store.putRules(mixedSid, OWNER, declared({ toolDeny: [A, B] }));
96
99
  const mixed = await exported(mixedSid);
97
100
  const target = fresh();
98
101
  await store.putRules(target, OWNER, mixed);
99
102
  assert.deepEqual(await partOf(store, target), { toolDeny: [A], grammar: G });
100
- await store.putRules(target, OWNER, { toolDeny: [A] });
101
- await assert.rejects(store.putRules(target, OWNER, {}), isLoosenRefusal);
103
+ await store.putRules(target, OWNER, declared({ toolDeny: [A] }));
104
+ await assert.rejects(store.putRules(target, OWNER, declared({})), isLoosenRefusal);
102
105
  if (store.deleteBySession !== undefined) {
103
- await store.deleteBySession(replayed);
104
- await store.putRules(replayed, OWNER, opRow);
105
- await assert.rejects(store.putRules(replayed, OWNER, {}), isLoosenRefusal);
106
+ await store.deleteBySession(replay);
107
+ await store.putRules(replay, OWNER, opRow);
108
+ await assert.rejects(store.putRules(replay, OWNER, declared({})), isLoosenRefusal);
106
109
  }
107
110
  });
108
111
  run("a value built on the no-row record (`{ rev: 0 }`, what a read of an unwritten key answers) is written now: the owner takes back what it added through it", async () => {
109
112
  const store = make();
110
113
  const sid = fresh();
111
- await store.putRules(sid, OWNER, { rev: 0, toolDeny: [A] });
114
+ const noRowRecord = { rev: 0, toolDeny: [A], grammar: G };
115
+ await store.putRules(sid, OWNER, noRowRecord);
112
116
  assert.deepEqual(await partOf(store, sid), { grammar: G });
113
- const back = await store.putRules(sid, OWNER, {});
117
+ const back = await store.putRules(sid, OWNER, declared({}));
114
118
  assert.equal(back.toolDeny, undefined);
115
119
  });
116
120
  run("the part rides the session's enumeration (an export carries who may take what back)", async () => {
@@ -118,13 +122,30 @@ export async function sessionPolicyStoreContract(make, runAssertion) {
118
122
  if (store.listBySession === undefined)
119
123
  return;
120
124
  const sid = fresh();
121
- await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
122
- await store.putRules(sid, OWNER, { toolDeny: [A, B] });
125
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
126
+ await store.putRules(sid, OWNER, declared({ toolDeny: [A, B] }));
123
127
  const records = await store.listBySession(sid);
124
128
  assert.equal(records.length, 1);
125
129
  const read = readSessionRulesShape(records[0].rules);
126
130
  assert.ok(!("fault" in read));
127
131
  assert.deepEqual(read.rules.operatorRules, { toolDeny: [A], grammar: G });
128
132
  });
133
+ run("a write that declares no grammar is refused `grammar_required` with nothing written — on a fresh key, as an operator, and over a row", async () => {
134
+ const store = make();
135
+ const undeclaredStore = store;
136
+ const sid = fresh();
137
+ await assert.rejects(undeclaredStore.putRules(sid, OWNER, { toolDeny: [A] }), isGrammarRequired);
138
+ await assert.rejects(undeclaredStore.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true }), isGrammarRequired);
139
+ assert.equal(await store.getRules(sid, OWNER), null);
140
+ const stored = await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
141
+ const { grammar: _stamp, ...unstamped } = stored;
142
+ void _stamp;
143
+ await assert.rejects(undeclaredStore.putRules(sid, OWNER, unstamped, { operator: true }), isGrammarRequired);
144
+ const stampSaysNothing = { ...stored, grammar: undefined };
145
+ await assert.rejects(undeclaredStore.putRules(sid, OWNER, stampSaysNothing, { operator: true }), isGrammarRequired);
146
+ const row = await store.getRules(sid, OWNER);
147
+ assert.equal(row?.rev, stored.rev);
148
+ assert.deepEqual(row?.toolDeny, [A]);
149
+ });
129
150
  await settle();
130
151
  }
@@ -1,5 +1,5 @@
1
1
  import { strict as assert } from "node:assert";
2
- import { sessionLogMarkOf } from "../../internal/harness.js";
2
+ import { readSessionRepoRowCells, sessionLogMarkOf } from "../../internal/harness.js";
3
3
  import { TtlSessionStore } from "../session-store.js";
4
4
  import { beginContract } from "./contract-harness.js";
5
5
  const SESSION_ENTRY = (id, parentId) => ({
@@ -12,6 +12,7 @@ const SESSION_ENTRY = (id, parentId) => ({
12
12
  export async function sessionRepoContract(make, runAssertion) {
13
13
  const { run, settle } = beginContract(runAssertion);
14
14
  const A = "0198fa00-0000-7000-8000-00000000000a";
15
+ const cellsOf = (repo) => readSessionRepoRowCells("the repo under the session repo contract", repo.rowCells);
15
16
  run("RB-360 create({id}) on an id that ALREADY has history is an idempotent REOPEN — never a wipe", async () => {
16
17
  const repo = make();
17
18
  const sess = await repo.create({ id: A });
@@ -198,7 +199,7 @@ export async function sessionRepoContract(make, runAssertion) {
198
199
  assert.equal(again.owner, "kit-alice", "the owner changes only through a write of the row");
199
200
  assert.equal(again.incarnation, token);
200
201
  if (repo.headOf !== undefined)
201
- assert.deepEqual(await repo.headOf(A), { owner: "kit-alice", incarnation: token, leafId: null });
202
+ assert.deepEqual(await repo.headOf(A), { owner: "kit-alice", ...(token === undefined ? {} : { incarnation: token }), leafId: null });
202
203
  });
203
204
  run("headOf (where the repo answers it): no row ⇒ undefined; a row ⇒ its owner, occupant and active leaf, as open() reads them", async () => {
204
205
  const repo = make();
@@ -210,12 +211,17 @@ export async function sessionRepoContract(make, runAssertion) {
210
211
  await sess.getStorage().appendEntry(SESSION_ENTRY("e2", "e1"));
211
212
  await sess.getStorage().setLeafId("e1");
212
213
  const opened = await repo.open({ id: A, createdAt: "" });
213
- assert.deepEqual(await repo.headOf(A), { owner: "kit-alice", incarnation: (await opened.getMetadata()).incarnation, leafId: await opened.getStorage().getLeafId() });
214
+ {
215
+ const inc = (await opened.getMetadata()).incarnation;
216
+ assert.deepEqual(await repo.headOf(A), { owner: "kit-alice", ...(inc === undefined ? {} : { incarnation: inc }), leafId: await opened.getStorage().getLeafId() });
217
+ }
214
218
  await repo.delete({ id: A, createdAt: "" });
215
219
  assert.equal(await repo.headOf(A), undefined, "a deleted row has no head");
216
220
  });
217
221
  run("the store over a repo: a row replaced behind a cached session (deleted, then created again naming another owner) — the store's next acquire serves the new row, never the cached transcript", async () => {
218
222
  const repo = make();
223
+ if (cellsOf(repo) === "host")
224
+ return;
219
225
  const store = new TtlSessionStore({ repo });
220
226
  try {
221
227
  if (store.headOf === undefined)
@@ -297,7 +303,13 @@ export async function sessionRepoContract(make, runAssertion) {
297
303
  assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: before.head } })), "conflict", "the row was deleted since the read");
298
304
  assert.equal(await logIds(repo, A), undefined, "and no row was created");
299
305
  await repo.create({ id: A, owner: "kit-alice" });
300
- assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: before.head } })), "conflict", "the row was created again: another occupant, same owner");
306
+ if (cellsOf(repo) === "engine") {
307
+ assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: before.head } })), "conflict", "the row was created again: another occupant, same owner");
308
+ }
309
+ else {
310
+ assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: before.head, log: sessionLogMarkOf(before.entries) } })), "conflict", "the row was created again: its log is not the one read");
311
+ await assert.rejects(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: { owner: "kit-alice", incarnation: "kit-occupant" } } }), TypeError, "an expectation naming an occupant, to a repo that holds none");
312
+ }
301
313
  assert.deepEqual(await logIds(repo, A), [], "the new row's log is untouched");
302
314
  const noShape = { row: before.head, log: "a mark of no shape" };
303
315
  await assert.rejects(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: noShape }), TypeError, "an expectation of no shape is refused, never read as none");
@@ -315,7 +327,13 @@ export async function sessionRepoContract(make, runAssertion) {
315
327
  assert.deepEqual(await logIds(repo, A), ["e1", "e2"]);
316
328
  await repo.delete({ id: A, createdAt: "" });
317
329
  await repo.create({ id: A, owner: "kit-alice" });
318
- assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, { row: read.head })), "conflict", "another occupant under the id: not deleted");
330
+ if (cellsOf(repo) === "engine") {
331
+ assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, { row: read.head })), "conflict", "another occupant under the id: not deleted");
332
+ }
333
+ else {
334
+ assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, { row: read.head, log: sessionLogMarkOf(read.entries) })), "conflict", "the row created again under the id: its log is not the one read, not deleted");
335
+ await assert.rejects(() => repo.delete({ id: A, createdAt: "" }, { row: { owner: "kit-alice", incarnation: "kit-occupant" } }), TypeError, "an expectation naming an occupant, to a repo that holds none");
336
+ }
319
337
  assert.deepEqual(await logIds(repo, A), [], "the new occupant stands");
320
338
  const current = (await repo.readRow(A));
321
339
  await (await repo.open({ id: A, createdAt: "" })).getStorage().appendEntry(SESSION_ENTRY("f1", null));
@@ -327,6 +345,8 @@ export async function sessionRepoContract(make, runAssertion) {
327
345
  });
328
346
  run("the store over a repo answers headOf exactly when the repo does: present ⇒ the repo's own answer; absent ⇒ no headOf on the store, which still works", async () => {
329
347
  const repo = make();
348
+ if (cellsOf(repo) === "host")
349
+ return;
330
350
  const store = new TtlSessionStore({ repo });
331
351
  try {
332
352
  assert.equal(typeof store.headOf, typeof repo.headOf === "function" ? "function" : "undefined");
@@ -355,5 +375,110 @@ export async function sessionRepoContract(make, runAssertion) {
355
375
  over.dispose();
356
376
  }
357
377
  });
378
+ run("the occupant cells by mode: an engine repo writes a row's occupant on create, fork (the source's as forkedFromIncarnation) and an import onto an absent id, and every read hands it out; a host repo writes neither cell and no read hands either out", async () => {
379
+ const repo = make();
380
+ const B = "0198fa00-0000-7000-8000-00000000000b";
381
+ const C = "0198fa00-0000-7000-8000-00000000000c";
382
+ const src = await repo.create({ id: A, owner: "kit-alice" });
383
+ await src.getStorage().appendEntry(SESSION_ENTRY("e1", null));
384
+ const forked = await repo.fork({ id: A, createdAt: "" }, { id: B });
385
+ const createdMeta = await src.getMetadata();
386
+ const forkedMeta = await forked.getMetadata();
387
+ const created = [["the session create returned", createdMeta], ["the session fork returned", forkedMeta]];
388
+ assert.equal(forkedMeta.forkedFrom, A, "the lineage's id is the repo's in either mode");
389
+ const imported = repo.importEntries === undefined ? undefined : await repo.importEntries(C, "kit-alice", [SESSION_ENTRY("e1", null)]);
390
+ const ids = imported === undefined ? [A, B] : [A, B, C];
391
+ const metasOf = async (id) => {
392
+ const out = [[`open(${id})`, await (await repo.open({ id, createdAt: "" })).getMetadata()]];
393
+ const listed = (await repo.list()).find((m) => m.id === id);
394
+ assert.ok(listed !== undefined, `list() answers row ${id}`);
395
+ out.push([`list() row ${id}`, listed]);
396
+ if (repo.readRow !== undefined)
397
+ out.push([`readRow(${id}).metadata`, (await repo.readRow(id)).metadata]);
398
+ return out;
399
+ };
400
+ const headsOf = async (id) => {
401
+ const out = [];
402
+ if (repo.headOf !== undefined)
403
+ out.push([`headOf(${id})`, (await repo.headOf(id))]);
404
+ if (repo.readRow !== undefined)
405
+ out.push([`readRow(${id}).head`, (await repo.readRow(id)).head]);
406
+ if (imported !== undefined && id === C)
407
+ out.push(["the head the import answered", imported]);
408
+ return out;
409
+ };
410
+ if (cellsOf(repo) === "engine") {
411
+ const tokenA = createdMeta.incarnation;
412
+ const tokenB = forkedMeta.incarnation;
413
+ assert.ok(typeof tokenA === "string" && tokenA !== "", "create writes the row's occupant");
414
+ assert.ok(typeof tokenB === "string" && tokenB !== "" && tokenB !== tokenA, "a fork row is an occupant of its own");
415
+ assert.equal(forkedMeta.forkedFromIncarnation, tokenA, "and records the source's occupant as its lineage");
416
+ const want = new Map([[A, tokenA], [B, tokenB]]);
417
+ if (imported !== undefined) {
418
+ assert.ok(typeof imported.incarnation === "string" && imported.incarnation !== "" && imported.incarnation !== tokenA && imported.incarnation !== tokenB, "an import onto an absent id writes an occupant of its own");
419
+ want.set(C, imported.incarnation);
420
+ }
421
+ for (const id of ids) {
422
+ for (const [what, meta] of await metasOf(id))
423
+ assert.equal(meta.incarnation, want.get(id), `${what} hands out the row's occupant`);
424
+ for (const [what, head] of await headsOf(id))
425
+ assert.equal(head.incarnation, want.get(id), `${what} hands out the row's occupant`);
426
+ }
427
+ for (const [what, meta] of await metasOf(B))
428
+ assert.equal(meta.forkedFromIncarnation, tokenA, `${what} hands out the fork's lineage occupant`);
429
+ return;
430
+ }
431
+ for (const [what, meta] of created) {
432
+ assert.equal(meta.incarnation, undefined, `${what}: no occupant`);
433
+ assert.equal(meta.forkedFromIncarnation, undefined, `${what}: no lineage occupant`);
434
+ }
435
+ for (const id of ids) {
436
+ for (const [what, meta] of await metasOf(id)) {
437
+ assert.equal(meta.incarnation, undefined, `${what}: no occupant handed out`);
438
+ assert.equal(meta.forkedFromIncarnation, undefined, `${what}: no lineage occupant handed out`);
439
+ }
440
+ for (const [what, head] of await headsOf(id))
441
+ assert.equal(head.incarnation, undefined, `${what}: no occupant handed out`);
442
+ }
443
+ });
444
+ run("a conditional write by mode: an engine repo judges the occupant an expectation names (another ⇒ conflict); a host repo judges the owner and the log and refuses an expectation naming any occupant (a TypeError, nothing written); in either mode the row as read is written", async () => {
445
+ const repo = make();
446
+ if (repo.readRow === undefined)
447
+ return;
448
+ const sess = await repo.create({ id: A, owner: "kit-alice" });
449
+ await sess.getStorage().appendEntry(SESSION_ENTRY("e1", null));
450
+ const read = (await repo.readRow(A));
451
+ const named = { row: { owner: "kit-alice", incarnation: "kit-occupant" } };
452
+ if (cellsOf(repo) === "engine") {
453
+ assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, named)), "conflict", "an occupant that is not the row's: not deleted");
454
+ if (repo.importEntries !== undefined)
455
+ assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: named })), "conflict", "an occupant that is not the row's: not written");
456
+ }
457
+ else {
458
+ assert.equal(read.head.incarnation, undefined, "the head this repo reads names no occupant");
459
+ await assert.rejects(() => repo.delete({ id: A, createdAt: "" }, named), TypeError, "a delete naming an occupant");
460
+ if (repo.importEntries !== undefined)
461
+ await assert.rejects(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: named }), TypeError, "an import naming an occupant");
462
+ const otherOwner = { row: { owner: "kit-bob", incarnation: undefined } };
463
+ assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, otherOwner)), "conflict", "another owner: not deleted");
464
+ const moved = { row: read.head, log: { length: read.entries.length + 1, lastEntryId: "kit-other" } };
465
+ assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, moved)), "conflict", "another log: not deleted");
466
+ }
467
+ assert.deepEqual(await logIds(repo, A), ["e1"], "the refused writes wrote nothing");
468
+ if (repo.importEntries !== undefined) {
469
+ await repo.importEntries(A, "kit-alice", [SESSION_ENTRY("n1", null)], { expect: { row: read.head, log: sessionLogMarkOf(read.entries) } });
470
+ assert.deepEqual(await logIds(repo, A), ["n1"], "the row and log as read: written");
471
+ }
472
+ const now = (await repo.readRow(A));
473
+ await repo.delete({ id: A, createdAt: "" }, { row: now.head, log: sessionLogMarkOf(now.entries) });
474
+ assert.equal(await logIds(repo, A), undefined, "the row and log as read: deleted");
475
+ });
476
+ run("TtlSessionStore over a repo whose host holds the occupant cells is refused at construction, coded config.invalid_argument and naming the missing occupant source — never a store whose every occupant comparison reads \"same\"", async () => {
477
+ const repo = make();
478
+ if (cellsOf(repo) === "engine")
479
+ return;
480
+ assert.throws(() => new TtlSessionStore({ repo }).dispose(), /this layer has no occupant source/);
481
+ assert.equal(await conflictOf(async () => new TtlSessionStore({ repo }).dispose()), "config.invalid_argument");
482
+ });
358
483
  await settle();
359
484
  }
@@ -41,7 +41,7 @@ export interface SessionStoreContractHooks {
41
41
  /** Optional faces (plus the replica hook, and `requireExisting` — absent = the store rejects the option, its other
42
42
  * legal mode) a run verified or found absent; reported per judging case, after its assertions held. */
43
43
  onOptionalMember?: (report: {
44
- member: "requireExisting" | "forget" | "fork" | "list" | "noteTaskRun" | "listPlaced" | "placements" | "headOf" | "ownership" | "replica" | "logTransfer" | "delete";
44
+ member: "requireExisting" | "forget" | "fork" | "list" | "noteTaskRun" | "listPlaced" | "placements" | "headOf" | "ownership" | "replica" | "logTransfer" | "delete" | "deleteUnreadable";
45
45
  status: "verified" | "absent";
46
46
  }) => void;
47
47
  }
@@ -183,6 +183,7 @@ async function runSessionStoreContract(make, hooks) {
183
183
  replica: () => hooks.replica !== undefined,
184
184
  logTransfer: (s) => hasHead(s) && typeof s.logTransfer === "object" && s.logTransfer !== null,
185
185
  delete: (s) => hasHead(s) && typeof s.delete === "function",
186
+ deleteUnreadable: (s) => hasHead(s) && typeof s.deleteUnreadable === "function",
186
187
  };
187
188
  const faceRun = (name, needs, fn) => run(name, async (store, open) => {
188
189
  const missing = [];
@@ -1257,6 +1258,22 @@ async function runSessionStoreContract(make, hooks) {
1257
1258
  assert.equal(await store.delete(id, { owner: null }), false);
1258
1259
  assert.ok((await headOf(store, id)) !== undefined, "the placed row stands");
1259
1260
  });
1261
+ faceRun("[deleteUnreadable] a row that reads is not unreadable: an anonymous row (and an owned one, where the store keeps owners) and an id with no row answer false and delete nothing", ["deleteUnreadable"], async (store) => {
1262
+ const anonymous = freshId();
1263
+ await append((await store.acquire(anonymous)).session, userEntry("u1", null));
1264
+ assert.equal(await store.deleteUnreadable(anonymous), false, "an anonymous row reads: it is not unreadable");
1265
+ assert.ok((await headOf(store, anonymous)) !== undefined, "the anonymous row stands");
1266
+ assert.deepEqual(await entryIds((await store.acquire(anonymous)).session), ["u1"], "and keeps its log");
1267
+ if (hasOwnership(store)) {
1268
+ const owned = freshId();
1269
+ await store.register(owned, "kit-alice");
1270
+ assert.equal(await store.deleteUnreadable(owned), false, "an owned row reads: it is not unreadable");
1271
+ assert.equal(await ownerOf(store, owned, "after the refused operator delete"), "kit-alice");
1272
+ }
1273
+ const none = freshId();
1274
+ assert.equal(await store.deleteUnreadable(none), false, "no row ⇒ false");
1275
+ assert.equal(await headOf(store, none), undefined, "and nothing is created under the id");
1276
+ });
1260
1277
  await settle();
1261
1278
  }
1262
1279
  function firstTextBlock(entry) {
@@ -0,0 +1,32 @@
1
+ import { type TaskListStore } from "../../tools/task-list.js";
2
+ import { type ContractAssertionRunner } from "./contract-harness.js";
3
+ /**
4
+ * The cross-backend {@link TaskListStore} contract kit (vitest-free; see `contract-harness.ts` for the runner seam). A task list has
5
+ * two bundled backends (`createMemoryTaskListStore`, `createFileTaskListStore`) and a deployment's own (a database twin); this kit is
6
+ * the semantics every one of them runs, so no backend drifts on what a valid entry is, what the list order is, or what a stored entry
7
+ * that does not read answers. Assertions describe landed behaviour only; the authoritative text is the `TaskListStore` contract in
8
+ * `src/tools/task-list.ts`. A backend that goes red here is in breach — the contract is not loosened to make it green.
9
+ *
10
+ * Tiers:
11
+ * - core (every backend): CRUD round trip, detached copies both ways, the entry table's write gate (absent dependency lists stored
12
+ * as `[]`, a present one that is no list refused), the metadata guard, `allocateId` unique and never reused, the list order (id
13
+ * ascending, stable), unknown-id answers, single-call atomicity under concurrent writes;
14
+ * - durable (`reopen` given — the backend outlives one object): cross-instance visibility and high-water mark, `mutate` as the
15
+ * transaction boundary, no lost update across instances;
16
+ * - damaged entries (`plantRow` given): an entry a foreign writer left that does not read is LISTED as its id and verdict, `get`
17
+ * of it refuses in {@link TASK_LIST_ROW_MALFORMED_CODE} without handing the planted bytes back, deletion by its id works, and
18
+ * through the tools it counts as open — it keeps blocking the task that depends on it, and no new edge to it is written.
19
+ * A backend with no bytes a foreign writer could damage declares `unplantable` (with its reason) instead; one of the two is
20
+ * required, so "forgot" never reads as "nothing to plant".
21
+ */
22
+ export interface TaskListStoreContractHooks {
23
+ /** A fresh, empty store each call. */
24
+ readonly make: () => TaskListStore;
25
+ /** Another instance over the SAME backend (a restart, a second assembly). Absent = the backend is the object itself. */
26
+ readonly reopen?: (from: TaskListStore) => TaskListStore;
27
+ /** Plant one stored entry under `id` as these raw values, bypassing `set` — the shape a foreign writer leaves. */
28
+ readonly plantRow?: (store: TaskListStore, id: string, raw: unknown) => Promise<void> | void;
29
+ /** Declared instead of `plantRow`, once, by a backend that keeps no bytes a foreign writer could damage: why. */
30
+ readonly unplantable?: string;
31
+ }
32
+ export declare function taskListStoreContract(hooks: TaskListStoreContractHooks, runAssertion?: ContractAssertionRunner): Promise<void>;