@sema-agent/core 7.66.0 → 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 (903) hide show
  1. package/CHANGELOG.md +3498 -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 +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
  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.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -3,7 +3,7 @@ import { isAbsolute, join, resolve } from "node:path";
3
3
  import { anchorSpelling, canonicalizeTarget, expandHomeTilde, isAbsoluteForFamily, isWinFormPath, pathFamilyOf, writeTargetPath } from "../tools/fs/safety.js";
4
4
  import { spelledExemptionOf } from "./write-protect.js";
5
5
  import { compileSegmentPattern, READ_FACE_BUILTIN_DENY_TABLE, readDenyPatternRun, SEGMENT_FOLDS, segmentGuardRow } from "../tools/fs/read-deny.js";
6
- import { guardHitReachClause, guardHitVia, judgePathRows } from "./path-guard-rows.js";
6
+ import { guardHitReachClause, guardHitVia, judgePathRows, spelledViews } from "./path-guard-rows.js";
7
7
  import { agentConfigDirSegments, agentConfigDirTail, checkedAgentConfigDir } from "./agent-config-dir.js";
8
8
  import { isProtectedWrite, protectivePathTargetOf } from "./tool-registry.js";
9
9
  import { pathTargetBaseOf } from "./effective-path-target.js";
@@ -115,13 +115,21 @@ function compilePatterns(patterns) {
115
115
  }
116
116
  return out;
117
117
  }
118
+ function sensitiveGuardRow(c) {
119
+ return segmentGuardRow(c, { faces: ["write"], polarity: "deny", exemptible: true, fold: CASE_INSENSITIVE_FS ? "host" : "exact", origin: "replacement" });
120
+ }
121
+ let recommendedRows;
122
+ export function sensitiveRowOf(spellings) {
123
+ recommendedRows ??= compilePatterns(RECOMMENDED_SENSITIVE_PATTERNS).map(sensitiveGuardRow);
124
+ return judgePathRows(recommendedRows, spelledViews(spellings), "tighten")?.row.name;
125
+ }
118
126
  const RETIRED_SENSITIVE_PATH_POLICY_KEYS = Object.freeze({
119
127
  dataRoot: "the data-root exemption reads the engine's one exempt root — a Runner resolves it once per leg from `RunnerDeps.memoryEngineDir` and stamps it on every request this policy judges (`ToolCallRequest.exemptRoots`); set the data root there and drop the option",
120
128
  });
121
129
  export function createSensitivePathPolicy(opts) {
122
130
  assertNoRetiredKeys(opts, RETIRED_SENSITIVE_PATH_POLICY_KEYS, "createSensitivePathPolicy option");
123
131
  const compiled = compilePatterns(opts.patterns);
124
- const rowOf = (c) => segmentGuardRow(c, { faces: ["write"], polarity: "deny", exemptible: true, fold: CASE_INSENSITIVE_FS ? "host" : "exact", origin: "replacement" });
132
+ const rowOf = sensitiveGuardRow;
125
133
  const guardRows = compiled.map(rowOf);
126
134
  const configRoot = checkedAgentConfigDir(opts.agentConfigDir, "createSensitivePathPolicy agentConfigDir");
127
135
  const configRows = configRoot === undefined ? [] : opts.patterns.flatMap((raw) => {
@@ -1,4 +1,6 @@
1
- import type { ExecutionEnv, Session, SessionCheckoutCell, SessionCheckoutDeclared, SessionCheckoutRecord } from "../internal/harness-types.js";
1
+ import type { ExecutionEnv, Session, SessionCheckoutDeclared, SessionCheckoutRecord } from "../internal/harness-types.js";
2
+ import { type ReleasedTree } from "./git-worktree-env.js";
3
+ import type { WorkspaceSnapshot } from "./workspace-snapshot.js";
2
4
  /** One declared code source: the root it is for, the repository URL (`https` only), the full commit id the session's code
3
5
  * starts from, and a display label. */
4
6
  export interface WorkspaceSourceDeclaration {
@@ -27,7 +29,7 @@ export interface WorkspaceDeclaration {
27
29
  readonly sources?: readonly WorkspaceSourceDeclaration[];
28
30
  }
29
31
  /** Why a checkout cannot get a managed tree here — the probe's closed set. */
30
- export declare const WORKTREE_INCAPABLE_REASONS: readonly ["git_unavailable", "not_a_repository", "bare_repository", "no_commit", "managed_parent_symlinked", "parent_not_writable", "name_in_use"];
32
+ export declare const WORKTREE_INCAPABLE_REASONS: readonly ["name_invalid", "git_unavailable", "not_a_repository", "bare_repository", "no_commit", "managed_parent_symlinked", "parent_not_writable", "name_in_use"];
31
33
  export type WorktreeIncapableReason = (typeof WORKTREE_INCAPABLE_REASONS)[number];
32
34
  /** What {@link probeWorktreeCapability} answered. `gitRoot` = the repository root the managed parent hangs at (present once
33
35
  * the location is known to be a repository). */
@@ -38,27 +40,23 @@ export interface WorktreeCapability {
38
40
  /** One human sentence for the refusal; absent when capable. */
39
41
  readonly detail?: string;
40
42
  }
41
- /** The release outcome of one tree. `branch` is present while the tree's branch still exists after the release. */
42
- export interface ReleasedTree {
43
- readonly path: string;
44
- readonly removed: boolean;
45
- readonly branch?: string;
46
- readonly kept?: "dirty" | "ignored" | "commits" | "unverifiable" | "requested" | "not_owned";
47
- readonly detail?: string;
48
- }
43
+ export type { ReleasedTree } from "./git-worktree-env.js";
49
44
  /**
50
45
  * THE shape judge of `TaskSpec.workspace` — `undefined` for an absent declaration, else the normalized declaration the record
51
- * stores and every later leg is compared on. Refused (`config.session_workspace_invalid`): a non-object, an unknown key, a word
52
- * outside a closed set, `baseRef` / `name` without `isolation`, a name outside the managed grammar, an empty or oversized
46
+ * stores and every later leg is compared on. Read once as data ({@link DECLARATION_DATA}), then judged on that copy. Refused
47
+ * (`config.session_workspace_invalid`): a non-object, a value that is not plain data (a Proxy, an accessor, a class instance, a
48
+ * member that is not an enumerable data property), an unknown key, a word outside a closed set, `baseRef` / `name` without `isolation`, a name outside the managed grammar, an empty or oversized
53
49
  * `sources`, two sources for one root, a source for the isolated task root together with `baseRef`, a declaration that declares
54
50
  * nothing.
55
51
  */
56
52
  export declare function screenWorkspaceDeclaration(value: unknown): SessionCheckoutDeclared | undefined;
57
53
  /**
58
- * THE capability judge of a managed tree for the checkout at `cwd`: git runs, `cwd` is inside a non-bare work tree with a
59
- * commit, no level of the managed parent is a symlink, the managed parent can be written, and — with `name` — that name's
60
- * directory and branch are free. The first failing check answers, in that order. Reads only (no git write); a host calls it
61
- * before offering isolation, and a session's first leg calls it before minting.
54
+ * THE capability judge of a managed tree for the checkout at `cwd`: — with `name` — that name is a managed name (the declaration's
55
+ * own grammar, {@link worktreeNameProblem}; a pure judgment of the argument, asked before anything is read, its `detail` the
56
+ * grammar's own sentence), git runs, `cwd` is inside a non-bare work tree with a commit, no level of the managed parent is a
57
+ * symlink, the managed parent can be written, and the name's directory and branch are free. The first failing check answers,
58
+ * in that order. Reads only (no git write); a host calls it before offering isolation, and a session's first leg calls it
59
+ * before minting.
62
60
  */
63
61
  export declare function probeWorktreeCapability(env: ExecutionEnv, cwd: string, opts?: {
64
62
  readonly name?: string;
@@ -74,6 +72,8 @@ export interface OpenSessionCheckoutInput {
74
72
  readonly baseRoot: string;
75
73
  /** The leg's `TaskSpec.additionalDirectories` (declared spellings). */
76
74
  readonly additionalDirectories: readonly string[] | undefined;
75
+ /** The working directory a durable resume restores (the checkpoint's `handsCwd`); absent on a leg that resumes nothing. */
76
+ readonly restoredCwd?: string;
77
77
  }
78
78
  export interface OpenedSessionCheckout {
79
79
  /** The leg's task root: the task root's place in the session's tree when the task root's repository is isolated, else `baseRoot`. */
@@ -82,11 +82,11 @@ export interface OpenedSessionCheckout {
82
82
  readonly record?: SessionCheckoutRecord;
83
83
  }
84
84
  /**
85
- * THE per-leg judge of a session's checkout (see the module header): reads the record, compares the leg's declaration with it,
86
- * mints the allocation on the session's first leg, and answers the leg's task root. Throws a coded refusal; the first leg's
87
- * allocation records nothing unless everything succeeded (every path check runs before the mint; a tree minted for a refused
88
- * allocation is removed while still clean only when its allocation mark is proved absent, else kept and named; the record is
89
- * written only once everything succeeded — immediately, not at settle).
85
+ * THE per-leg judge of a session's checkout (see the module header): reads the record, reads the leg's declaration against it
86
+ * ({@link legWorkspaceOf}), mints the allocation on the session's first leg, and answers the leg's task root. Throws a coded
87
+ * refusal; the first leg's allocation records nothing unless everything succeeded (every path check runs before the mint; a
88
+ * tree minted for a refused allocation is removed while still clean only when its allocation mark is proved absent, else kept
89
+ * and named; the record is written only once everything succeeded — immediately, not at settle).
90
90
  */
91
91
  export declare function openSessionCheckout(input: OpenSessionCheckoutInput): Promise<OpenedSessionCheckout>;
92
92
  /**
@@ -120,7 +120,9 @@ export interface OrphanSessionTree {
120
120
  readonly allocationId: string;
121
121
  /** The commit it was minted at (its mark). */
122
122
  readonly baseSha: string;
123
- /** `unrecorded`: the host's lookup says that session does not exist, or its log holds no checkout record · `record_unreadable`:
123
+ /** `unrecorded`: the host's lookup says that session does not exist, or the id now names another occupant than the one the tree
124
+ * was minted for (the session deleted and registered again, a log imported into a new row), or its log holds no checkout record ·
125
+ * `record_unreadable`:
124
126
  * the lookup threw, the session's record cannot be read, or its log is loaded from a bounded window that may hold the record
125
127
  * below its floor · `record_elsewhere`: the session's record holds another allocation (a first leg refused while another leg
126
128
  * recorded kept the tree it minted). */
@@ -134,9 +136,11 @@ export interface OrphanSessionTree {
134
136
  * The host's lookup of a session by id, handed to the orphan doors.
135
137
  *
136
138
  * @contract session_checkout.session_of.absence_is_authority — `undefined` asserts that the host's DURABLE session store holds no
137
- * session with that id (a cache miss is not absence), and the lookup throws whenever it cannot tell. The doors read `undefined` as
138
- * "no leg of that session will take the tree back" (the host never reuses a session id) and a throw as `record_unreadable`, which
139
- * neither door removes.
139
+ * session with that id (a cache miss is not absence), and the lookup throws whenever it cannot tell. A session it answers is the
140
+ * id's CURRENT occupant: its row as the durable store holds it now, never a cached view of a row deleted since. The doors read
141
+ * `undefined` as "no leg of that session will take the tree back", a session of another occupant than the tree's mark names the
142
+ * same way (an earlier occupant's tree is an orphan, whatever the id names now), and a throw as `record_unreadable`, which neither
143
+ * door removes.
140
144
  */
141
145
  export type OrphanSessionLookup = (sessionId: string) => Promise<Session | undefined>;
142
146
  /**
@@ -164,5 +168,6 @@ export declare function listOrphanSessionTrees(env: ExecutionEnv, root: string,
164
168
  export declare function releaseOrphanSessionTree(env: ExecutionEnv, path: string, opts: {
165
169
  readonly sessionOf: OrphanSessionLookup;
166
170
  }): Promise<ReleasedTree>;
167
- /** The frame's `session` member: the record's cells as the leg reports them (`undefined` when the session has no checkout). */
168
- export declare function sessionFrameOf(record: SessionCheckoutRecord | undefined): ReadonlyArray<SessionCheckoutCell> | undefined;
171
+ /** The frame's checkout members, present together (none when the session has no checkout): `session`, the record's cells as the
172
+ * leg reports them, and `declaration`, the record's normalized declaration — what every later leg sends. */
173
+ export declare function sessionFrameOf(record: SessionCheckoutRecord | undefined): Pick<WorkspaceSnapshot, "session" | "declaration">;
@@ -1,10 +1,14 @@
1
1
  import { randomUUID } from "node:crypto";
2
+ import { types } from "node:util";
2
3
  import { appendSessionCheckout, readSessionCheckout } from "../engine/session/session.js";
4
+ import { sameOccupant } from "../engine/session/repo-utils.js";
3
5
  import { isSensitiveRecordKey } from "@sema-agent/primitives";
4
- import { managedAnchorOf, managedWorktreeBaseOf, managedWorktreeBranchOf, managedWorktreeDir, mintManagedWorktree, removeManagedWorktree, repositoryRootOf, resolveBaseCommit, shq, symlinkedLevel, WORKTREE_PARENT, worktreeNameProblem, } from "./git-worktree-env.js";
6
+ import { branchLeftOf, managedAnchorOf, managedWorktreeBaseOf, managedWorktreeBranchOf, managedWorktreeDir, mintManagedWorktree, removeManagedWorktree, removeTreeIfClean, repositoryRootOf, resolveBaseCommit, shq, symlinkedLevel, WORKTREE_PARENT, worktreeNameProblem, } from "./git-worktree-env.js";
7
+ import { describeFault, receive } from "./mods/kernel/receive.js";
5
8
  import { strayMembersOf } from "./own-property-receipt.js";
6
9
  import { thrownText } from "./thrown-value.js";
7
10
  export const WORKTREE_INCAPABLE_REASONS = Object.freeze([
11
+ "name_invalid",
8
12
  "git_unavailable",
9
13
  "not_a_repository",
10
14
  "bare_repository",
@@ -19,6 +23,23 @@ const FULL_SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
19
23
  const SOURCE_MAX = 64;
20
24
  const DECLARATION_MEMBERS = Object.freeze(["isolation", "baseRef", "name", "sources"]);
21
25
  const SOURCE_MEMBERS = Object.freeze(["root", "remote", "sha", "ref"]);
26
+ const DECLARATION_DATA = Object.freeze({ accessors: "refuse", depth: 4, others: "refuse", isProxy: (v) => types.isProxy(v) });
27
+ const UNRESERVED_CHARACTER = /^[A-Za-z0-9\-._~]$/;
28
+ function canonicalEscapes(path) {
29
+ return path.replace(/%([0-9A-Fa-f]{2})/g, (escape, hex) => {
30
+ const character = String.fromCharCode(parseInt(hex, 16));
31
+ return UNRESERVED_CHARACTER.test(character) ? character : escape.toUpperCase();
32
+ });
33
+ }
34
+ function repositoryPathOf(host, path) {
35
+ for (;;) {
36
+ const bare = canonicalEscapes(path).replace(/\/{2,}/g, "/").replace(/\/+$/, "").replace(/\.git$/, "");
37
+ const next = bare === "" ? "" : new URL(`https://${host}${bare}`).pathname;
38
+ if (next === path)
39
+ return path;
40
+ path = next;
41
+ }
42
+ }
22
43
  function normalizeRemote(remote, at) {
23
44
  if (typeof remote !== "string" || remote.length === 0 || remote.length > 2048)
24
45
  throw invalid(`${at}.remote must be an https repository URL`);
@@ -40,10 +61,11 @@ function normalizeRemote(remote, at) {
40
61
  throw invalid(`${at}.remote carries a credential parameter (${url.origin}); credentials never ride the declaration`);
41
62
  }
42
63
  }
43
- const path = url.pathname.replace(/\/+$/, "").replace(/\.git$/, "");
64
+ const host = url.host.toLowerCase();
65
+ const path = repositoryPathOf(host, url.pathname);
44
66
  if (path === "" || path === "/")
45
67
  throw invalid(`${at}.remote names no repository (${url.origin})`);
46
- return `https://${url.host.toLowerCase()}${path}`;
68
+ return `https://${host}${path}`;
47
69
  }
48
70
  function screenRoot(root, at) {
49
71
  if (root === "taskRoot")
@@ -62,7 +84,10 @@ export function screenWorkspaceDeclaration(value) {
62
84
  return undefined;
63
85
  if (value === null || typeof value !== "object" || Array.isArray(value))
64
86
  throw invalid("must be an object");
65
- const v = value;
87
+ const data = receive(value, DECLARATION_DATA);
88
+ if (!data.ok)
89
+ throw invalid(`must be plain data — ${describeFault(data.fault)}`);
90
+ const v = data.value;
66
91
  const stray = strayMembersOf(v, { subject: "TaskSpec.workspace", unit: "member", moment: "when the leg starts" }, DECLARATION_MEMBERS);
67
92
  if (stray !== undefined)
68
93
  throw refusal("config.session_workspace_invalid", stray.sentence);
@@ -116,7 +141,13 @@ export function screenWorkspaceDeclaration(value) {
116
141
  ...(sources !== undefined ? { sources } : {}),
117
142
  };
118
143
  }
119
- const declaredDigest = (d) => JSON.stringify(d === undefined ? null : [d.isolation ?? null, d.baseRef ?? null, d.name ?? null, (d.sources ?? []).map((s) => [rootKey(s.root), s.remote, s.sha, s.ref ?? null])]);
144
+ const declaredDigest = (d) => JSON.stringify([d.isolation ?? null, d.baseRef ?? null, d.name ?? null, (d.sources ?? []).map((s) => [rootKey(s.root), s.remote, s.sha, s.ref ?? null])]);
145
+ function legWorkspaceOf(raw) {
146
+ if (raw === null)
147
+ return { kind: "none" };
148
+ const declared = screenWorkspaceDeclaration(raw);
149
+ return declared === undefined ? { kind: "inherit" } : { kind: "declared", declared };
150
+ }
120
151
  async function run(env, command, cwd) {
121
152
  try {
122
153
  const r = await env.exec(command, { cwd });
@@ -132,6 +163,11 @@ function sessionTreeName(sessionId) {
132
163
  }
133
164
  export async function probeWorktreeCapability(env, cwd, opts) {
134
165
  const no = (reason, detail, gitRoot) => ({ worktreeCapable: false, reason, detail, ...(gitRoot !== undefined ? { gitRoot } : {}) });
166
+ if (opts?.name !== undefined) {
167
+ const problem = worktreeNameProblem(opts.name);
168
+ if (problem !== undefined)
169
+ return no("name_invalid", problem);
170
+ }
135
171
  const version = await run(env, "git --version", cwd);
136
172
  if (version === undefined || version.exitCode !== 0)
137
173
  return no("git_unavailable", "git cannot be run in this environment");
@@ -194,15 +230,25 @@ async function readBirthMark(env, dir) {
194
230
  return text.error.code === "not_found" ? { kind: "absent" } : unreadable(`its allocation mark cannot be read (${thrownText(text.error).slice(0, 200)})`);
195
231
  try {
196
232
  const v = JSON.parse(text.value);
197
- if (typeof v.allocationId === "string" && typeof v.sessionId === "string" && typeof v.baseSha === "string" && FULL_SHA.test(v.baseSha) && typeof v.declared === "string") {
198
- return { kind: "marked", mark: { allocationId: v.allocationId, sessionId: v.sessionId, baseSha: v.baseSha, declared: v.declared } };
233
+ const occupant = v.incarnation === undefined || (typeof v.incarnation === "string" && v.incarnation !== "");
234
+ if (occupant && typeof v.allocationId === "string" && typeof v.sessionId === "string" && typeof v.baseSha === "string" && FULL_SHA.test(v.baseSha) && typeof v.declared === "string") {
235
+ const incarnation = typeof v.incarnation === "string" ? { incarnation: v.incarnation } : {};
236
+ return { kind: "marked", mark: { allocationId: v.allocationId, sessionId: v.sessionId, ...incarnation, baseSha: v.baseSha, declared: v.declared } };
199
237
  }
200
238
  }
201
239
  catch {
202
240
  }
203
241
  return unreadable("its allocation mark is not a valid record");
204
242
  }
205
- const recordHoldsMark = (holder, mark) => holder.allocationId === mark.allocationId;
243
+ const recordHoldsMark = (holder, mark) => holder.allocationId === mark.allocationId && sameOccupant(mark.incarnation, holder.occupant);
244
+ async function sessionRowOf(session, unread) {
245
+ try {
246
+ return await session.getMetadata();
247
+ }
248
+ catch (err) {
249
+ throw refusal("workspace.checkout_unavailable", `This session's row cannot be read (${thrownText(err).slice(0, 300)}), so whose session tree is whose cannot be told; ${unread}`);
250
+ }
251
+ }
206
252
  const overlaps = (path, top) => path === top || path.startsWith(`${top}/`) || top.startsWith(`${path === "/" ? "" : path}/`);
207
253
  async function refuseOverlap(env, base, additional) {
208
254
  const top = await canonicalOf(env, base);
@@ -229,33 +275,53 @@ async function placeInTree(env, root, dir) {
229
275
  }
230
276
  export async function openSessionCheckout(input) {
231
277
  const { session, sessionId } = input;
232
- const declared = screenWorkspaceDeclaration(input.declaration);
233
- const observedLeaf = declared !== undefined ? await session.getStorage().getLeafId() : null;
278
+ const leg = legWorkspaceOf(input.declaration);
279
+ const observedLeaf = leg.kind === "declared" ? await session.getStorage().getLeafId() : null;
234
280
  const read = await readSessionCheckout(session, sessionId);
235
281
  if (read.kind === "unreadable") {
236
282
  throw refusal("workspace.checkout_unavailable", `This session's checkout record cannot be read (${read.detail}); the leg was not started rather than run outside the session's checkout.`);
237
283
  }
238
284
  if (read.kind === "record")
239
- return reopen(input, declared, read.record);
240
- if (declared === undefined)
285
+ return reopen(input, leg, read.record);
286
+ if (leg.kind !== "declared")
241
287
  return { taskRoot: input.baseRoot };
288
+ const declared = leg.declared;
242
289
  const forked = (await session.getMetadata()).forkedFrom !== undefined;
243
290
  if (!forked && (await session.getStorage().findEntries("message")).length > 0) {
244
291
  throw refusal("config.session_workspace_changed", "TaskSpec.workspace is declared on a session that already ran without it; a session's workspace is fixed by its first leg. Start a new session to work in a declared workspace.");
245
292
  }
246
293
  return allocate(input, declared, observedLeaf);
247
294
  }
248
- async function reopen(input, declared, record) {
295
+ async function treeHoldingCwd(env, cwd, record) {
296
+ const where = await canonicalOf(env, cwd);
297
+ for (const cell of record.checkouts) {
298
+ if (cell.dir === undefined)
299
+ continue;
300
+ const tree = await canonicalOf(env, cell.dir);
301
+ if (where === tree || where.startsWith(`${tree}/`))
302
+ return cell.dir;
303
+ }
304
+ return undefined;
305
+ }
306
+ async function reopen(input, leg, record) {
249
307
  const env = input.env;
250
308
  if (record.released === true) {
251
309
  throw refusal("config.session_workspace_changed", "This session's checkout was released; a released session runs no further leg. Start a new session.");
252
310
  }
253
- if (declaredDigest(declared) !== declaredDigest(record.declared)) {
254
- throw refusal("config.session_workspace_changed", `TaskSpec.workspace differs from the declaration this session's checkout was opened under (allocation ${record.allocationId}); a session's workspace is fixed by its first leg. Send the same declaration on every leg, or start a new session.`);
311
+ if (leg.kind === "none") {
312
+ const standing = input.restoredCwd === undefined ? undefined : await treeHoldingCwd(env, input.restoredCwd, record);
313
+ if (standing !== undefined) {
314
+ throw refusal("config.session_workspace_changed", `TaskSpec.workspace is null on a resumed leg whose pending action stands in the session's tree ${standing} (the checkpoint's working directory); it would run there while the leg reports no checkout. Resume it with the session's workspace (omit it, or send the declaration); send null on a leg that starts fresh.`);
315
+ }
316
+ return { taskRoot: input.baseRoot };
317
+ }
318
+ if (leg.kind === "declared" && declaredDigest(leg.declared) !== declaredDigest(record.declared)) {
319
+ throw refusal("config.session_workspace_changed", `TaskSpec.workspace differs from the declaration this session's checkout was opened under (allocation ${record.allocationId}); a session's workspace is fixed by its first leg. Omit it (the leg takes the session's), send the same declaration, send null for a leg that wants no tree, or start a new session.`);
255
320
  }
256
321
  for (const cell of record.checkouts)
257
322
  if (cell.dir !== undefined)
258
323
  await refuseOverlap(env, cell.repository, input.additionalDirectories ?? []);
324
+ const holder = record.checkouts.some((cell) => cell.dir !== undefined) ? { allocationId: record.allocationId, occupant: (await sessionRowOf(input.session, "the leg was not started.")).incarnation } : undefined;
259
325
  let taskRoot = input.baseRoot;
260
326
  for (const cell of record.checkouts) {
261
327
  if (cell.dir === undefined)
@@ -270,8 +336,8 @@ async function reopen(input, declared, record) {
270
336
  if (info.value.kind !== "directory")
271
337
  throw refusal("workspace.checkout_missing", `This session's tree ${cell.dir} is no longer a directory; the leg was not started.`);
272
338
  const birth = await readBirthMark(env, cell.dir);
273
- if (birth.kind !== "marked" || !recordHoldsMark(record, birth.mark)) {
274
- throw refusal("workspace.checkout_missing", `This session's tree ${cell.dir} is no longer the tree this session minted (its allocation mark is missing or names another allocation); the leg was not started. Release the session's checkout and start a new session.`);
339
+ if (birth.kind !== "marked" || holder === undefined || !recordHoldsMark(holder, birth.mark)) {
340
+ throw refusal("workspace.checkout_missing", `This session's tree ${cell.dir} is no longer the tree this session minted (its allocation mark is missing, or names another allocation or another occupant of this session id); the leg was not started. Release the session's checkout and start a new session.`);
275
341
  }
276
342
  if (cell.root === "taskRoot") {
277
343
  const placed = await placeInTree(env, input.baseRoot, cell.dir);
@@ -322,6 +388,7 @@ async function allocate(input, declared, observedLeaf) {
322
388
  let taskRoot = baseRoot;
323
389
  if (declared.isolation === "worktree") {
324
390
  const name = declared.name ?? sessionTreeName(sessionId);
391
+ const occupant = (await sessionRowOf(input.session, "the leg was not started.")).incarnation;
325
392
  const probe = await probeWorktreeCapability(env, baseRoot);
326
393
  if (!probe.worktreeCapable || probe.gitRoot === undefined) {
327
394
  throw refusal("workspace.isolation_unavailable", `The session's tree cannot be made for ${baseRoot}: ${probe.detail ?? "the checkout cannot hold a managed tree"} (${probe.reason ?? "unknown"}). The leg was not started in the base checkout instead.`);
@@ -336,7 +403,7 @@ async function allocate(input, declared, observedLeaf) {
336
403
  if (existing.ok || existing.error.code !== "not_found") {
337
404
  const read = await readBirthMark(env, dir);
338
405
  const birth = read.kind === "marked" ? read.mark : undefined;
339
- if (birth === undefined || birth.sessionId !== sessionId) {
406
+ if (birth === undefined || birth.sessionId !== sessionId || !sameOccupant(birth.incarnation, occupant)) {
340
407
  throw refusal("workspace.isolation_unavailable", `The session's tree cannot be made: a tree named "${name}" already exists at ${dir} and was not minted by this session (name_in_use). Declare another name — or, when no session's record holds that tree, release it with releaseOrphanSessionTree (listOrphanSessionTrees lists such trees).`);
341
408
  }
342
409
  if (birth.declared !== declaredDigest(declared)) {
@@ -378,7 +445,7 @@ async function allocate(input, declared, observedLeaf) {
378
445
  return undo(`The session's tree is not at the declared commit${taskRootSource !== undefined ? ` ${taskRootSource.sha}` : ""}; the leg was not started.`, taskRootSource !== undefined ? "workspace.source_mismatch" : "workspace.isolation_unavailable");
379
446
  }
380
447
  const birthAt = await birthRecordPath(env, minted.worktreeDir);
381
- const wrote = birthAt === undefined ? undefined : await env.writeFile(birthAt, JSON.stringify({ allocationId, sessionId, baseSha: minted.baseSha, declared: declaredDigest(declared) }));
448
+ const wrote = birthAt === undefined ? undefined : await env.writeFile(birthAt, JSON.stringify({ allocationId, sessionId, ...(typeof occupant === "string" && occupant !== "" ? { incarnation: occupant } : {}), baseSha: minted.baseSha, declared: declaredDigest(declared) }));
382
449
  if (wrote === undefined || !wrote.ok)
383
450
  return undo("The session's tree could not be marked as this session's; the leg was not started.", "workspace.isolation_unavailable");
384
451
  tree = { dir: minted.worktreeDir, branch: minted.branch, baseSha: minted.baseSha, baseRef: taskRootSource !== undefined ? "source" : declared.baseRef ?? "fresh", allocationId };
@@ -418,8 +485,8 @@ export async function releaseSessionCheckout(env, session, opts) {
418
485
  if (onExit !== "keep-if-dirty" && onExit !== "keep") {
419
486
  throw refusal("config.invalid_argument", `releaseSessionCheckout: onExit must be "keep-if-dirty" or "keep" (a removal that discards changes is not offered)`);
420
487
  }
421
- const sessionId = (await session.getMetadata()).id;
422
- const read = await readSessionCheckout(session, sessionId);
488
+ const row = await sessionRowOf(session, "nothing was removed.");
489
+ const read = await readSessionCheckout(session, row.id);
423
490
  if (read.kind === "unreadable")
424
491
  throw refusal("workspace.checkout_unavailable", `This session's checkout record cannot be read (${read.detail}); nothing was removed.`);
425
492
  if (read.kind === "none")
@@ -429,28 +496,18 @@ export async function releaseSessionCheckout(env, session, opts) {
429
496
  for (const cell of record.checkouts) {
430
497
  if (cell.dir === undefined || cell.branch === undefined)
431
498
  continue;
432
- trees.push(await releaseTree(env, { path: cell.dir, repository: cell.repository, branch: cell.branch, baseSha: cell.baseSha }, record, onExit));
499
+ trees.push(await releaseTree(env, { path: cell.dir, repository: cell.repository, branch: cell.branch, baseSha: cell.baseSha }, { allocationId: record.allocationId, occupant: row.incarnation }, onExit));
433
500
  }
434
501
  if (record.released !== true)
435
502
  await appendSessionCheckout(session, { ...record, released: true });
436
503
  return { trees };
437
504
  }
438
- const IGNORED_NAMED = 5;
439
- function ignoredDetail(paths) {
440
- const named = paths.slice(0, IGNORED_NAMED).map((p) => p.slice(0, 120)).join(", ");
441
- const more = paths.length > IGNORED_NAMED ? ` and ${paths.length - IGNORED_NAMED} more` : "";
442
- return `the tree holds files git ignores (${named}${more}), which removing it would delete — delete or move them, then release again`;
443
- }
444
- async function branchLeftOf(env, tree) {
445
- const ref = await run(env, `git rev-parse --verify --quiet ${shq(`refs/heads/${tree.branch}`)}`, tree.repository);
446
- return ref !== undefined && ref.exitCode === 0 ? { branch: tree.branch } : {};
447
- }
448
505
  async function goneTree(env, tree) {
449
506
  await run(env, "git worktree prune", tree.repository);
450
- return { path: tree.path, removed: true, ...(await branchLeftOf(env, tree)) };
507
+ return { path: tree.path, removed: true, ...(await branchLeftOf(env, tree.repository, tree.branch)) };
451
508
  }
452
509
  async function releaseTree(env, tree, holder, onExit) {
453
- const { path, repository, branch, baseSha } = tree;
510
+ const { path, repository, branch } = tree;
454
511
  const at = await env.fileInfo(path);
455
512
  if (!at.ok) {
456
513
  if (at.error.code !== "not_found")
@@ -461,30 +518,12 @@ async function releaseTree(env, tree, holder, onExit) {
461
518
  const mark = await readBirthMark(env, path);
462
519
  return mark.kind === "marked" && recordHoldsMark(holder, mark.mark);
463
520
  };
521
+ const notOwned = async () => ({ path, removed: false, kept: "not_owned", ...(await branchLeftOf(env, repository, branch)) });
464
522
  if (!(await held()))
465
- return { path, removed: false, kept: "not_owned", ...(await branchLeftOf(env, tree)) };
523
+ return notOwned();
466
524
  if (onExit === "keep")
467
525
  return { path, removed: false, kept: "requested", branch };
468
- const status = await run(env, "git status --porcelain --ignored --untracked-files=normal", path);
469
- if (status === undefined || status.exitCode !== 0)
470
- return { path, removed: false, kept: "unverifiable", branch };
471
- const entries = status.stdout.split("\n").filter((line) => line !== "");
472
- if (entries.some((line) => !line.startsWith("!! ")))
473
- return { path, removed: false, kept: "dirty", branch };
474
- if (entries.length > 0)
475
- return { path, removed: false, kept: "ignored", branch, detail: ignoredDetail(entries.map((line) => line.slice(3))) };
476
- const ahead = await run(env, `git rev-list --count ${shq(`${baseSha}..HEAD`)}`, path);
477
- const commits = ahead !== undefined && ahead.exitCode === 0 ? Number.parseInt(ahead.stdout.trim(), 10) : Number.NaN;
478
- if (!Number.isFinite(commits))
479
- return { path, removed: false, kept: "unverifiable", branch };
480
- if (commits > 0)
481
- return { path, removed: false, kept: "commits", branch };
482
- if (!(await held()))
483
- return { path, removed: false, kept: "not_owned", ...(await branchLeftOf(env, tree)) };
484
- const removed = await removeManagedWorktree(env, repository, path, { name: branch, baseSha }, undefined, "clean");
485
- if (!removed.ok)
486
- return { path, removed: false, kept: "unverifiable", branch, detail: removed.detail.trim().slice(0, 300) };
487
- return { path, removed: true, ...(await branchLeftOf(env, tree)) };
526
+ return removeTreeIfClean(env, tree, undefined, async () => ((await held()) ? undefined : notOwned()));
488
527
  }
489
528
  async function standingOf(env, dir, sessionOf) {
490
529
  const read = await readBirthMark(env, dir);
@@ -493,10 +532,14 @@ async function standingOf(env, dir, sessionOf) {
493
532
  const mark = read.mark;
494
533
  const orphan = (why, detail) => ({ kind: "orphan", mark, why, ...(detail !== undefined ? { detail: detail.slice(0, 300) } : {}) });
495
534
  let checkout;
535
+ let occupant;
496
536
  try {
497
537
  const session = await sessionOf(mark.sessionId);
498
538
  if (session === undefined)
499
539
  return orphan("unrecorded");
540
+ occupant = (await session.getMetadata()).incarnation;
541
+ if (!sameOccupant(mark.incarnation, occupant))
542
+ return orphan("unrecorded", `the session id ${mark.sessionId} now names another occupant than the one the tree was minted for`);
500
543
  checkout = await readSessionCheckout(session, mark.sessionId);
501
544
  }
502
545
  catch (err) {
@@ -507,7 +550,7 @@ async function standingOf(env, dir, sessionOf) {
507
550
  if (checkout.kind === "none") {
508
551
  return checkout.window === undefined ? orphan("unrecorded") : orphan("record_unreadable", `the session's log is loaded from a bounded window (floor ${checkout.window.floor}); a checkout record below the floor cannot be ruled out`);
509
552
  }
510
- return recordHoldsMark(checkout.record, mark) ? { kind: "held", mark } : orphan("record_elsewhere", `the session's record holds allocation ${checkout.record.allocationId}`);
553
+ return recordHoldsMark({ allocationId: checkout.record.allocationId, occupant }, mark) ? { kind: "held", mark } : orphan("record_elsewhere", `the session's record holds allocation ${checkout.record.allocationId}`);
511
554
  }
512
555
  function lookupOf(door, opts) {
513
556
  const sessionOf = opts !== null && typeof opts === "object" ? opts.sessionOf : undefined;
@@ -539,7 +582,7 @@ export async function listOrphanSessionTrees(env, root, opts) {
539
582
  const branch = managedWorktreeBranchOf(path);
540
583
  trees.push({
541
584
  path,
542
- ...(branch !== undefined ? await branchLeftOf(env, { repository, branch }) : {}),
585
+ ...(branch !== undefined ? await branchLeftOf(env, repository, branch) : {}),
543
586
  sessionId: mark.sessionId,
544
587
  allocationId: mark.allocationId,
545
588
  baseSha: mark.baseSha,
@@ -563,17 +606,22 @@ export async function releaseOrphanSessionTree(env, path, opts) {
563
606
  const standing = await standingOf(env, path, sessionOf);
564
607
  if (standing.kind === "unmarked") {
565
608
  return standing.read.kind === "absent"
566
- ? { path, removed: false, kept: "not_owned", ...(await branchLeftOf(env, { repository, branch })), detail: "it carries no allocation mark: it is no session tree" }
609
+ ? { path, removed: false, kept: "not_owned", ...(await branchLeftOf(env, repository, branch)), detail: "it carries no allocation mark: it is no session tree" }
567
610
  : { path, removed: false, kept: "unverifiable", branch, detail: standing.read.detail };
568
611
  }
569
612
  if (standing.kind === "held")
570
613
  return { path, removed: false, kept: "not_owned", branch, detail: "a session's record holds this tree; releaseSessionCheckout releases it" };
571
614
  if (standing.why === "record_unreadable")
572
615
  return { path, removed: false, kept: "unverifiable", branch, ...(standing.detail !== undefined ? { detail: standing.detail } : {}) };
573
- return releaseTree(env, { path, repository, branch, baseSha: standing.mark.baseSha }, standing.mark, "keep-if-dirty");
616
+ return releaseTree(env, { path, repository, branch, baseSha: standing.mark.baseSha }, { allocationId: standing.mark.allocationId, occupant: standing.mark.incarnation }, "keep-if-dirty");
574
617
  }
618
+ const rootCopy = (root) => (root === "taskRoot" ? "taskRoot" : { directory: root.directory });
575
619
  export function sessionFrameOf(record) {
576
620
  if (record === undefined || record.checkouts.length === 0)
577
- return undefined;
578
- return record.checkouts.map((cell) => ({ ...cell, root: cell.root === "taskRoot" ? "taskRoot" : { directory: cell.root.directory }, ...(cell.source !== undefined ? { source: { ...cell.source } } : {}) }));
621
+ return {};
622
+ const d = record.declared;
623
+ return {
624
+ session: record.checkouts.map((cell) => ({ ...cell, root: rootCopy(cell.root), ...(cell.source !== undefined ? { source: { ...cell.source } } : {}) })),
625
+ declaration: { ...d, ...(d.sources !== undefined ? { sources: d.sources.map((source) => ({ ...source, root: rootCopy(source.root) })) } : {}) },
626
+ };
579
627
  }
@@ -1,5 +1,6 @@
1
1
  import { SessionError, StreamingImportValidator, importRowCells, ownerCell, sessionLogMarkOf, uuidv7 } from "../internal/harness.js";
2
2
  import { optionKeys, receiptRefusal, receiveMembers } from "./own-property-receipt.js";
3
+ import { callerText } from "./caller-text.js";
3
4
  import { thrownText } from "./thrown-value.js";
4
5
  const EXPORT_WORDS = { subject: "SessionLogExportOptions", unit: "member", moment: "at SessionLogTransfer.exportStream" };
5
6
  const BEGIN_WORDS = { subject: "SessionLogTransfer.beginReplace options", unit: "member", moment: "at SessionLogTransfer.beginReplace" };
@@ -21,7 +22,7 @@ function committedHead(sessionId, answer) {
21
22
  function readRecord(raw, words, keys) {
22
23
  if (typeof raw !== "object" || raw === null)
23
24
  throw receiptRefusal(`${words.subject} must be an object, got ${raw === null ? "null" : typeof raw}`);
24
- return receiveMembers(raw, words, keys, (_, [stray]) => receiptRefusal(`${words.subject} carries "${String(stray)}" — not a member this face reads`));
25
+ return receiveMembers(raw, words, keys, (_, [stray]) => receiptRefusal(`${words.subject} carries ${callerText(stray)} — not a member this face reads (its members are ${keys.map((k) => JSON.stringify(k)).join(", ")})`));
25
26
  }
26
27
  function isIntegerFrom(value, floor) {
27
28
  return typeof value === "number" && Number.isSafeInteger(value) && value >= floor;
@@ -24,6 +24,10 @@
24
24
  * every station reads a row's entries in the grammar the row carries ({@link readSessionRulesShape}) — an entry keeps the meaning
25
25
  * its writer's grammar gave it, one that grammar could not read takes this engine's, and a row whose entries the two grammars
26
26
  * read differently is announced ({@link earlierGrammarReads}).
27
+ * - **a writer declares its grammar**: a write body carries the `grammar` its entries are written in, and the engine never
28
+ * supplies one — a body without it is refused `grammar_required` before anything is read ({@link judgeSessionRulesWrite}), a
29
+ * stored row handed back included (an unstamped one was stored in grammar 0, and its writer says so). An entry the writer's
30
+ * grammar reads as no rule is then refused as such, rather than reborn as a rule by a reading the writer never made.
27
31
  * - **rules are read as rules or not at all**: rules whose shape cannot be read, or whose toolDeny holds an entry no grammar
28
32
  * reads ({@link unreadableDenyEntries}), refuse every call until an operator writes them afresh — never read as fewer.
29
33
  * - **NOT A SANDBOX**: a shell command rule reads the command line the call carries (every program run in its connector
@@ -159,12 +163,14 @@ export interface SessionRuleEntryRefusal extends AllowEntryInertDetail {
159
163
  * = a non-operator write tried to relax what an operator wrote; `corrupt` = a backend could not read what it stored (a row, or the
160
164
  * erase-surviving rev mark of {@link SessionPolicyStore.deleteBySession}) and refuses rather than read it as fewer rules or
161
165
  * stamp an unproven rev; `invalid_shape` = the rules value is not an object of buckets, each a list of strings
162
- * ({@link readSessionRulesShape}); `inert_entry` = a bucket holds an entry the entry reader reads as nothing. `detail` is
163
- * present on the last two codes and only on them ({@link SessionRuleShapeRefusal}, {@link SessionRuleEntryRefusal}). */
166
+ * ({@link readSessionRulesShape}); `inert_entry` = a bucket holds an entry the entry reader reads as nothing;
167
+ * `grammar_required` = the write body declares no rule grammar (a write names the grammar its entries are written in — the
168
+ * engine never supplies one; no `detail`). `detail` is present on `invalid_shape` and `inert_entry` and only on them
169
+ * ({@link SessionRuleShapeRefusal}, {@link SessionRuleEntryRefusal}). */
164
170
  export declare class SessionPolicyError extends Error {
165
- readonly code: "conflict" | "loosen_forbidden" | "corrupt" | "invalid_shape" | "inert_entry";
171
+ readonly code: "conflict" | "loosen_forbidden" | "corrupt" | "invalid_shape" | "inert_entry" | "grammar_required";
166
172
  readonly detail?: (SessionRuleShapeRefusal | SessionRuleEntryRefusal) | undefined;
167
- constructor(code: "conflict" | "loosen_forbidden" | "corrupt" | "invalid_shape" | "inert_entry", message: string, detail?: (SessionRuleShapeRefusal | SessionRuleEntryRefusal) | undefined);
173
+ constructor(code: "conflict" | "loosen_forbidden" | "corrupt" | "invalid_shape" | "inert_entry" | "grammar_required", message: string, detail?: (SessionRuleShapeRefusal | SessionRuleEntryRefusal) | undefined);
168
174
  }
169
175
  /** Construction options both bundled stores take. */
170
176
  export interface SessionPolicyStoreOptions {
@@ -193,14 +199,17 @@ export interface SessionRulesRecord {
193
199
  export interface SessionPolicyStore {
194
200
  getRules(sessionId: string, principal?: string): Promise<StoredSessionRules | null>;
195
201
  /** Write the rules for a key through the one write judge ({@link judgeSessionRulesWrite}): CAS on `expectedRev`, the
202
+ * declared grammar (`rules.grammar` — the rule grammar the writer wrote the entries in; absent is `grammar_required`), the
196
203
  * shape, every entry's reading (operator writes included), then, for a non-operator write, the check against the row's
197
204
  * operator part — each refusal a {@link SessionPolicyError}, and nothing is written. The same call is the delete port: a
198
205
  * value without an entry takes it out of every gate that reads the row. */
199
- putRules(sessionId: string, principal: string | undefined, rules: SessionPermissionRules, opts?: PutRulesOptions): Promise<StoredSessionRules>;
206
+ putRules(sessionId: string, principal: string | undefined, rules: SessionRulesInGrammar, opts?: PutRulesOptions): Promise<StoredSessionRules>;
200
207
  /**
201
208
  * 2c session-sync: every (principal, rules) record for `sessionId` across ALL principals — `getRules`
202
209
  * is per-(sessionId, principal), but a cross-backend session EXPORT must bundle the WHOLE session's policy.
203
- * The importer replays each via `putRules(sessionId, record.principal, record.rules)`. Optional — a backend
210
+ * The importer replays each via `putRules(sessionId, record.principal, record.rules)` — the record's own `grammar` stamp
211
+ * rides along (a record stored before the stamp has none: the importer declares it grammar 0, the reading such a row was
212
+ * stored under, and a write of it is otherwise refused `grammar_required`). Optional — a backend
204
213
  * that supports cross-backend policy export implements it (local backend uses the in-memory/file impl).
205
214
  */
206
215
  listBySession?(sessionId: string): Promise<SessionRulesRecord[]>;
@@ -328,7 +337,8 @@ export type EarlierGrammarReader = "no_rule" | "named_no_tool" | "grammar_revise
328
337
  * audience `user` — the session's rules are what the person's calls are judged by): the message is {@link earlierGrammarAdvisory}
329
338
  * verbatim, and `detail` carries the same facts for a machine — `bucket` (the field), `storedGrammar` (the row's), `entries` (every
330
339
  * entry, each as `noticeRuleText` hands rule text to a notice, with its reader's word), `rewrite` (the way out: an operator write of
331
- * a new value without the stored row's rev, which stamps `stampsGrammar`), `rulesSessionId` (whose rules — an ancestor's on a
340
+ * a new value without the stored row's rev, which stamps `stampsGrammar` — the grammar its writer declares on it, a write
341
+ * that declares none being refused `grammar_required`), `rulesSessionId` (whose rules — an ancestor's on a
332
342
  * delegated child's inherited layer) and `sessionId` (the run that read them).
333
343
  */
334
344
  export declare function earlierGrammarNotice(input: {
@@ -350,12 +360,15 @@ export declare function earlierGrammarAnnouncer(sink: ((entries: readonly string
350
360
  /**
351
361
  * THE ONE WRITE JUDGE every store applies before it stamps a row (both bundled stores, and a durable backend at the same point):
352
362
  * the rules to stamp, or a {@link SessionPolicyError}, in this order — `conflict` (a stale `expectedRev` against `prior`'s rev),
353
- * `invalid_shape` ({@link normalizeRules}), `inert_entry` (an entry that reads as nothing in the grammar the rules are written
354
- * in; operator writes included — a rule that names nothing guards nothing whoever writes it), then, for a non-operator write
363
+ * `grammar_required` (the value declares no `grammar` — read before anything else of it: the writer names the grammar its
364
+ * entries are written in and the engine never supplies one, so a value without the stamp is no reading at all, a stored row
365
+ * handed back included), `invalid_shape` ({@link normalizeRules}), `inert_entry` (an entry that reads as nothing in the grammar
366
+ * the rules DECLARE they are written in; operator writes included — a rule that names nothing guards nothing whoever writes
367
+ * it), then, for a non-operator write
355
368
  * over a row, `loosen_forbidden` ({@link loosenReasons}) against the row's OPERATOR PART ({@link StoredSessionRules.operatorRules};
356
369
  * absent, the whole row) — or `corrupt` when that prior cannot be read as rules, which the comparison never reads as fewer.
357
370
  * Over no row there is no rev to compare and no tighten gate, and a judge called with `prior = null` (a host's pre-read of a
358
- * value's shape and entries) answers only those two content refusals. Below what an operator wrote nothing moves; above it,
371
+ * value's shape and entries) answers only those three content refusals. Below what an operator wrote nothing moves; above it,
359
372
  * a non-operator takes back what non-operator writes added. The
360
373
  * rules to stamp carry `grammar` = {@link SESSION_RULES_GRAMMAR} — what passed the judge means the same in this engine's
361
374
  * grammar — and, from a non-operator write, the operator part it was judged against: over no row, the value's own when it is a
@@ -419,7 +432,7 @@ export declare class InMemorySessionPolicyStore implements SessionPolicyStore {
419
432
  private readonly highWater;
420
433
  private key;
421
434
  getRules(sessionId: string, principal?: string): Promise<StoredSessionRules | null>;
422
- putRules(sessionId: string, principal: string | undefined, rules: SessionPermissionRules, opts?: PutRulesOptions): Promise<StoredSessionRules>;
435
+ putRules(sessionId: string, principal: string | undefined, rules: SessionRulesInGrammar, opts?: PutRulesOptions): Promise<StoredSessionRules>;
423
436
  listBySession(sessionId: string): Promise<SessionRulesRecord[]>;
424
437
  deleteBySession(sessionId: string): Promise<void>;
425
438
  }