@sema-agent/core 7.66.1 → 7.67.1

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 (904) hide show
  1. package/CHANGELOG.md +3518 -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 +169 -0
  71. package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
  362. package/dist/core/roles.js +148 -21
  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 +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -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 +126 -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 +64 -34
  730. package/dist/index.js +45 -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 +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -7,7 +7,7 @@ import { namesASetOfTools, ruleNameCovers } from "./namespaced-rule-name.js";
7
7
  import { peerReadingsOf, readsNameGlob, toolNameFaultOf } from "./tool-name-aliases.js";
8
8
  import { compileReadDeny } from "../tools/fs/read-deny.js";
9
9
  import { carriesShellRedirection, parseLeadingCommandName, splitShellCompoundSegments } from "../tools/fs/bash-readonly-classifier.js";
10
- import { INLINE_TRUNCATION_MARK, inlineUntrusted } from "./untrusted-text.js";
10
+ import { INLINE_TRUNCATION_MARK, inlineUntrusted, UNRENDERABLE_CHAR_CLASS } from "./untrusted-text.js";
11
11
  import { catalogRuleFaceOf, catalogToolNames, hostTargetOf, isShellFaceToolName, pathTargetOf, protectivePathTargetOf } from "./tool-registry.js";
12
12
  import { HOST_UNREADABLE_SENTENCE, hostPatternAdmits, readHostPattern, spelledHostPattern } from "./host-target.js";
13
13
  import { heldBy, heldValues, wireOf } from "./tool-name-readings.js";
@@ -352,7 +352,7 @@ function ruleLaneShapeOf(command, reading) {
352
352
  }
353
353
  return { segments: split.segments, names };
354
354
  }
355
- const CONTROL_CHARS_RE = /[\u0000-\u0008\u000A-\u001F\u007F-\u009F\p{Cf}\u2028\u2029]/u;
355
+ const CONTROL_CHARS_RE = new RegExp(`[${UNRENDERABLE_CHAR_CLASS}]`, "u");
356
356
  const CONTROL_CHARS_GLOBAL_RE = new RegExp(CONTROL_CHARS_RE.source, "gu");
357
357
  const RULE_SPELLING_REJECT_BYTES = "<>";
358
358
  const RULE_SPELLING_REJECT_RE = new RegExp(`[${RULE_SPELLING_REJECT_BYTES}]`);
@@ -905,36 +905,56 @@ const NOT_REACHED = { reach: "not_reached" };
905
905
  export function programRunReachOf(rule, command) {
906
906
  if (!isCommandMatch(rule.match))
907
907
  return NOT_REACHED;
908
+ const lineReach = lineReachOf(rule);
909
+ return lineReach === undefined ? NOT_REACHED : withSubstitutedLines(readCommandMemo(command), lineReach);
910
+ }
911
+ function lineReachOf(rule) {
908
912
  if (rule.match === "pattern") {
909
913
  const pattern = commandGlobOf(rule.command, "words");
910
- return pattern === undefined ? NOT_REACHED : anySegmentReach(readCommandMemo(command), (argv) => globArgvReachOf(pattern, argv));
914
+ return pattern === undefined ? undefined : (shape) => anySegmentReach(shape, (argv) => globArgvReachOf(pattern, argv));
911
915
  }
912
916
  const body = readRuleBody(rule.command);
913
917
  if (body === undefined)
914
- return NOT_REACHED;
915
- const shape = readCommandMemo(command);
918
+ return undefined;
916
919
  const exact = rule.match === "exact";
917
- if (body.segments.length > 1) {
918
- const broken = shape.segments.find((s) => s.unreadable !== undefined);
919
- if (broken !== undefined)
920
- return { reach: "unreadable", reason: broken.unreadable };
921
- const hidden = shape.segments.find((s) => s.peelUnreadable !== undefined);
922
- const shaped = !shape.grouped && shape.segments.length === body.segments.length && shape.connectors.every((c, i) => c === body.connectors[i]);
923
- if (!shaped)
924
- return hidden === undefined ? NOT_REACHED : { reach: "unreadable", reason: hidden.peelUnreadable };
925
- let outcome = REACHED;
926
- for (let i = 0; i < body.segments.length; i++) {
927
- const bodyArgv = body.segments[i].argv;
928
- const r = segmentReachOf(shape.segments[i], (argv) => argvReachOf(bodyArgv, argv, exact || i < body.segments.length - 1));
929
- if (r.reach === "not_reached")
930
- return hidden === undefined ? NOT_REACHED : { reach: "unreadable", reason: hidden.peelUnreadable };
931
- if (r.reach === "unreadable")
920
+ if (body.segments.length > 1)
921
+ return (shape) => chainReachOf(body, shape, exact);
922
+ const bodyArgv = body.segments[0].argv;
923
+ return (shape) => anySegmentReach(shape, (argv) => argvReachOf(bodyArgv, argv, exact));
924
+ }
925
+ function withSubstitutedLines(shape, lineReach) {
926
+ let outcome = lineReach(shape);
927
+ if (outcome.reach === "reached")
928
+ return REACHED;
929
+ for (const segment of shape.segments) {
930
+ for (const line of segment.substituted ?? []) {
931
+ const r = withSubstitutedLines(line, lineReach);
932
+ if (r.reach === "reached")
933
+ return REACHED;
934
+ if (r.reach === "unreadable" && outcome.reach === "not_reached")
932
935
  outcome = r;
933
936
  }
934
- return outcome;
935
937
  }
936
- const bodyArgv = body.segments[0].argv;
937
- return anySegmentReach(shape, (argv) => argvReachOf(bodyArgv, argv, exact));
938
+ return outcome;
939
+ }
940
+ function chainReachOf(body, shape, exact) {
941
+ const broken = shape.segments.find((s) => s.unreadable !== undefined);
942
+ if (broken !== undefined)
943
+ return { reach: "unreadable", reason: broken.unreadable };
944
+ const hidden = shape.segments.find((s) => s.peelUnreadable !== undefined);
945
+ const shaped = !shape.grouped && shape.segments.length === body.segments.length && shape.connectors.every((c, i) => c === body.connectors[i]);
946
+ if (!shaped)
947
+ return hidden === undefined ? NOT_REACHED : { reach: "unreadable", reason: hidden.peelUnreadable };
948
+ let outcome = REACHED;
949
+ for (let i = 0; i < body.segments.length; i++) {
950
+ const bodyArgv = body.segments[i].argv;
951
+ const r = segmentReachOf(shape.segments[i], (argv) => argvReachOf(bodyArgv, argv, exact || i < body.segments.length - 1));
952
+ if (r.reach === "not_reached")
953
+ return hidden === undefined ? NOT_REACHED : { reach: "unreadable", reason: hidden.peelUnreadable };
954
+ if (r.reach === "unreadable")
955
+ outcome = r;
956
+ }
957
+ return outcome;
938
958
  }
939
959
  function anySegmentReach(shape, reachOf) {
940
960
  let unreadable;
@@ -377,22 +377,31 @@ export declare function assertDeleteDeltaCarriesNoAdd(delta: RuleDeleteDelta): v
377
377
  * (the `assertDeleteDeltaCarriesNoAdd` doctrine: the check is executed, not merely intended, because a
378
378
  * union does not constrain a JavaScript caller's payload).
379
379
  *
380
- * A `redemption-add` whose scope — or a `tighten-delete` whose tombstone's scope — is a session scope
381
- * refuses LOUDLY with the typed code `unsupported.session_scope_store`: a session authorization's home
382
- * is the session's own overlay, and a session TOMBSTONE is equally unspellable here — session rows are
383
- * not individually deletable (they die with their session, design/382 §10), so a tombstone naming one
384
- * is either a foreign writer's fabrication or a caller wiring fault, and both deserve the loud arm.
385
- * The third arm (`sync-join`) is NOT gated here: its session rows are per-row DROPPED AND DISCLOSED by
386
- * {@link screenRuleSyncState} (a peer's damage must not veto a whole round the way a local caller's
387
- * bug must), and a session-scoped QUARANTINE instruction throws inside {@link applySyncJoin} itself.
388
- *
389
- * The session member is the LOUD, typed arm; the rest of the face is executed too. A scope that is
390
- * neither member in well-formed shape — `{kind:"project", root:""}` above all, which `pathWithinRoot`
391
- * turns into base `/` so the row crosses every project boundary — is a caller wiring fault, refused
392
- * with the untyped loud arm the sibling {@link assertDeleteDeltaCarriesNoAdd} uses (no closed-set code
393
- * names it: it is nobody's supported request). The sync arm already refuses the same shape inbound
394
- * ({@link applySyncJoin} runs {@link isValidDurableScope} on every joined row), so this closes the
395
- * matching direct-write door rather than inventing a new rule.
380
+ * A `redemption-add` or `tighten-add` whose scope — or a `tighten-delete` whose tombstone's scope — is a
381
+ * session scope refuses LOUDLY with the typed code `unsupported.session_scope_store`: a session
382
+ * authorization's home is the session's own overlay, and a session TOMBSTONE is equally unspellable here —
383
+ * session rows are not individually deletable (they die with their session, design/382 §10) and the store
384
+ * never holds one, so a tombstone naming one is either a foreign writer's fabrication or a caller wiring
385
+ * fault, and both deserve the loud arm. The third arm (`sync-join`) is NOT gated here: its session rows are
386
+ * per-row DROPPED AND DISCLOSED by {@link screenRuleSyncState} (a peer's damage must not veto a whole round
387
+ * the way a local caller's bug must), and a session-scoped QUARANTINE instruction throws inside
388
+ * {@link applySyncJoin} itself.
389
+ *
390
+ * The session member is the LOUD, typed arm; the rest of the face is executed too, on the ADD arms: a scope
391
+ * that is neither member in well-formed shape — `{kind:"project", root:""}` above all, which `pathWithinRoot`
392
+ * turns into base `/` so the row crosses every project boundary, and a root that is not a complete absolute
393
+ * path, whose row the read face drops — is a caller wiring fault, refused with the untyped loud arm the
394
+ * sibling {@link assertDeleteDeltaCarriesNoAdd} uses (no closed-set code names it: it is nobody's supported
395
+ * request). The sync arm already refuses the same shape inbound ({@link applySyncJoin} runs
396
+ * {@link isValidDurableScope} on every joined row), so this closes the matching direct-write door rather
397
+ * than inventing a new rule.
398
+ *
399
+ * A TOMBSTONE is not judged by that second half. It adds no row: it names one that is already in the store —
400
+ * written by a foreign writer or a hand edit, a row the read face leaves out of every check and tells the
401
+ * person to remove — and the scope it carries is that row's own, the identity the tombstone matches by. Refusing
402
+ * the removal because the row is malformed closes the one way out the notice offers. What a tombstone must still
403
+ * do is name an identity: `global`, or `project` with a root string of any spelling — a missing or rootless scope
404
+ * would be retained and then read by every comparison of the store.
396
405
  *
397
406
  * Exported with the backend contract for the same OPEN-SET duty {@link isValidDurableScope} names:
398
407
  * any lane — host-side import doors included — that writes rows into a persisted store carries the
@@ -726,6 +735,12 @@ export type RemoveResult =
726
735
  * Removal is the TIGHTENING direction, so it needs no approval-record ceremony: a host may narrow on a
727
736
  * user's behalf, it may not widen. The asymmetry is the point — minting takes a human's click, revoking
728
737
  * does not.
738
+ *
739
+ * The row a removal names is read from what the bucket HOLDS (the write face's raw rows, tombstones
740
+ * applied), not from the effective view: the view answers whether a row is honored in a run today, and a
741
+ * row the read face leaves out — a project row whose root is not a complete absolute path, which a run's
742
+ * notice asks the person to remove — is a row that can be named all the same. The `stillLive` word of every
743
+ * arm is read from the same rows.
729
744
  */
730
745
  export declare function removePersistedRule(opts: {
731
746
  /** The identity's behavior member — `removePersistedRule({ behavior: "allow", … })` for a standing
@@ -2,6 +2,7 @@ import { randomBytes } from "node:crypto";
2
2
  import { canonicalize } from "./canonical-json.js";
3
3
  import { escapeForDisclosure, isRuleBehavior, isRuleLive, parseRuleText } from "./permission-rule-model.js";
4
4
  import { readRuleOwner } from "./rule-owner.js";
5
+ import { PRINCIPAL_NAME_SPELLING } from "./principal-name.js";
5
6
  import { thrownText } from "./thrown-value.js";
6
7
  import { validatePath } from "./effective-path-target.js";
7
8
  export const PERMISSION_RULES_LATER_GRAMMAR_CODE = "permission_rules.later_grammar";
@@ -135,13 +136,20 @@ export function assertWriteDeltaScopeDurable(delta) {
135
136
  e.code = "unsupported.session_scope_store";
136
137
  throw e;
137
138
  }
139
+ if (delta.kind === "tighten-delete") {
140
+ if (!namesAScopeIdentity(scope)) {
141
+ throw new Error("a tighten-delete must carry a tombstone whose scope names a global scope or a project scope with a root string (design/382 §4.3) — refusing the write");
142
+ }
143
+ return;
144
+ }
138
145
  if (!isValidDurableScope(scope)) {
139
- throw new Error(delta.kind === "tighten-delete"
140
- ?
141
- "a tighten-delete must carry a tombstone whose scope is a well-formed durable scope (design/382 §4.3: the face is {global, project-with-a-root}) — refusing the write"
142
- : `a ${delta.kind} whose scope is not a well-formed durable scope cannot enter the persisted store (design/382 §4.3: the face is {global, project-with-a-root}) — refusing the write`);
146
+ throw new Error(`a ${delta.kind} whose scope is not a well-formed durable scope cannot enter the persisted store (design/382 §4.3: the face is {global, project-with-a-root}) — refusing the write`);
143
147
  }
144
148
  }
149
+ function namesAScopeIdentity(scope) {
150
+ const sc = scope;
151
+ return sc?.kind === "global" || (sc?.kind === "project" && typeof sc.root === "string");
152
+ }
145
153
  export function isValidConsentScope(scope) {
146
154
  const sc = scope;
147
155
  return (sc?.kind === "global" ||
@@ -501,6 +509,12 @@ function resolveRuleWriter(store) {
501
509
  function ruleIdentityStands(rules, identity) {
502
510
  return rules.some((r) => sameRuleIdentity(r, identity) && isRuleLive(r));
503
511
  }
512
+ function heldRowsOf(raw, identity) {
513
+ return applyTombstones(raw.rules, raw.tombstones).filter((r) => sameRuleIdentity(r, identity));
514
+ }
515
+ function rowsStand(raw, identity) {
516
+ return ruleIdentityStands(heldRowsOf(raw, identity), identity);
517
+ }
504
518
  async function witnessRuleAdd(store, writer, delta) {
505
519
  const identity = { behavior: delta.behavior, rule: delta.rule, scope: delta.scope };
506
520
  const dot = delta.add.dot;
@@ -520,19 +534,16 @@ async function witnessRuleAdd(store, writer, delta) {
520
534
  return { unreadable: errText(err) };
521
535
  }
522
536
  }
523
- async function readRuleLiveness(store, identity) {
537
+ async function readRuleLiveness(writer, identity) {
524
538
  try {
525
- const after = await store.effective();
526
- if (after.unreadable !== undefined)
527
- throw new Error(after.unreadable);
528
- return ruleIdentityStands(after.rules, identity) ? "yes" : "no";
539
+ return rowsStand(await writer.readRaw(), identity) ? "yes" : "no";
529
540
  }
530
541
  catch {
531
542
  return "unknown";
532
543
  }
533
544
  }
534
545
  const REMOVE_MAX_ATTEMPTS = 8;
535
- const NO_TARGET_OWNER = "the principal given is neither a principal name (a string with a visible character, no control or separator character, and no format character but a joiner) nor an owner (a principal owner names a principal name; the local owner is { kind: \"local-owner\" })";
546
+ const NO_TARGET_OWNER = `the principal given is neither a principal name (${PRINCIPAL_NAME_SPELLING}) nor an owner (a principal owner names a principal name; the local owner is { kind: "local-owner" })`;
536
547
  function persistedRuleTargetOwner(target) {
537
548
  return readRuleOwner(typeof target === "string" ? { kind: "principal", principal: target } : target);
538
549
  }
@@ -566,18 +577,16 @@ export async function removePersistedRule(opts) {
566
577
  }
567
578
  const writer = face.writer;
568
579
  let snapshot;
580
+ let removedDots;
569
581
  try {
570
- snapshot = await store.effective();
582
+ snapshot = await writer.readRaw();
583
+ removedDots = heldRowsOf(snapshot, identity).flatMap((r) => r.adds.map((a) => a.dot));
571
584
  }
572
585
  catch (err) {
573
586
  return { status: "failed", error: `could not read the permission-rule store: ${errText(err)}`, committed: "no" };
574
587
  }
575
- if (snapshot.unreadable !== undefined)
576
- return { status: "failed", error: `could not read the permission-rule store: ${snapshot.unreadable}`, committed: "no" };
577
- const live = snapshot.rules.filter((r) => sameRuleIdentity(r, identity));
578
- const removedDots = live.flatMap((r) => r.adds.map((a) => a.dot));
579
588
  if (removedDots.length === 0)
580
- return { status: "no-op", rev: snapshot.rev, stillLive: await readRuleLiveness(store, identity) };
589
+ return { status: "no-op", rev: snapshot.rev, stillLive: await readRuleLiveness(writer, identity) };
581
590
  let deletedBy;
582
591
  try {
583
592
  deletedBy = await writer.nextDot();
@@ -601,7 +610,7 @@ export async function removePersistedRule(opts) {
601
610
  break;
602
611
  }
603
612
  if (reading.kind === "landed") {
604
- return { status: "removed", rev: reading.rev, stillLive: await readRuleLiveness(store, identity) };
613
+ return { status: "removed", rev: reading.rev, stillLive: await readRuleLiveness(writer, identity) };
605
614
  }
606
615
  expectedRev = reading.rev;
607
616
  }
@@ -621,7 +630,7 @@ export async function removePersistedRule(opts) {
621
630
  const after = await writer.readRaw();
622
631
  const landed = after.tombstones.some((t) => t.deletedBy.actor === tombstone.deletedBy.actor && t.deletedBy.counter === tombstone.deletedBy.counter);
623
632
  if (landed) {
624
- return { status: "removed", rev: after.rev, stillLive: ruleIdentityStands(applyTombstones(after.rules, after.tombstones), identity) ? "yes" : "no" };
633
+ return { status: "removed", rev: after.rev, stillLive: rowsStand(after, identity) ? "yes" : "no" };
625
634
  }
626
635
  return {
627
636
  status: "failed",
@@ -40,5 +40,10 @@ export interface ReviewRequest {
40
40
  * and signals the engine to pause with a `plan_review` checkpoint at the next safe turn boundary. The tool has
41
41
  * NO side effect (`effect:"read"`); the actual pause/mint is the engine's, gated on a wired `checkpointStore`.
42
42
  * `requestReview` is the prepare-task closure (the same primitive `ctx.requestReview` exposes to caller tools).
43
+ * `suspendGap` is the run's one "no suspend target" fact (absent: the park has a target, or the pause is not this run's to make);
44
+ * where it is set the tool answers that the run is NOT pausing instead of saying it is: the per-task execution env is in neither
45
+ * suspend target (the clause {@link import("./remote-env.js").suspendTargetGapOf} names — the one reading the park itself refuses
46
+ * on), so the plan was not submitted, the run goes on, and no approval will come. The request is still made, so the engine's own
47
+ * refusal stands on the deployment's error face as before.
43
48
  */
44
- export declare function createPresentPlanTool(requestReview: (opts?: ReviewRequest) => void, planFile?: PlanFileSource): ToolSpec;
49
+ export declare function createPresentPlanTool(requestReview: (opts?: ReviewRequest) => void, planFile?: PlanFileSource, suspendGap?: string): ToolSpec;
@@ -78,7 +78,8 @@ Ensure your plan is complete and unambiguous:
78
78
  - Once your plan is finalized, use THIS tool to request approval
79
79
 
80
80
  **Important:** Do NOT separately ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.`;
81
- function createPresentPlanFileTool(requestReview, planFile) {
81
+ const PAUSE_GAP_MAX = 400;
82
+ function createPresentPlanFileTool(requestReview, planFile, notPausing) {
82
83
  return {
83
84
  name: PRESENT_PLAN_TOOL_NAME,
84
85
  ...toolFace("exit-plan-mode-file"),
@@ -93,6 +94,8 @@ function createPresentPlanFileTool(requestReview, planFile) {
93
94
  return errorResult(`No plan file found at ${planFile.shown}. Please write your plan to this file before calling ExitPlanMode.`);
94
95
  const plan = read.text;
95
96
  requestReview({ reason: "ExitPlanMode" });
97
+ if (notPausing !== undefined)
98
+ return notPausing();
96
99
  return {
97
100
  content: `Plan presented for human review (from ${planFile.shown}):\n\n${delimitUntrusted("plan", plan)}\n\n` +
98
101
  "(The run is pausing for approval — you will continue once the plan is approved, edited, or rejected.)",
@@ -101,9 +104,12 @@ function createPresentPlanFileTool(requestReview, planFile) {
101
104
  },
102
105
  };
103
106
  }
104
- export function createPresentPlanTool(requestReview, planFile) {
107
+ export function createPresentPlanTool(requestReview, planFile, suspendGap) {
108
+ const notPausing = suspendGap === undefined
109
+ ? undefined
110
+ : () => errorResult(`The plan was NOT submitted for approval and the run is not pausing: the per-task execution env ${inlineUntrusted(suspendGap, PAUSE_GAP_MAX)}, so its workspace could not be restored on resume. You remain in plan mode; present the plan to the user in your reply instead.`);
105
111
  if (planFile !== undefined)
106
- return createPresentPlanFileTool(requestReview, planFile);
112
+ return createPresentPlanFileTool(requestReview, planFile, notPausing);
107
113
  return {
108
114
  name: PRESENT_PLAN_TOOL_NAME,
109
115
  ...toolFace("exit-plan-mode"),
@@ -117,6 +123,8 @@ export function createPresentPlanTool(requestReview, planFile) {
117
123
  execute: async (args, ctx) => {
118
124
  const { plan } = args;
119
125
  requestReview({ reason: "ExitPlanMode", ...(typeof ctx?.toolCallId === "string" && ctx.toolCallId !== "" ? { requestedByCallId: ctx.toolCallId } : {}) });
126
+ if (notPausing !== undefined)
127
+ return notPausing();
120
128
  return {
121
129
  content: `Plan presented for human review:\n\n${delimitUntrusted("plan", plan)}\n\n` +
122
130
  "(The run is pausing for approval — you will continue once the plan is approved, edited, or rejected.)",
@@ -2,7 +2,7 @@
2
2
  * Cost computation (1.37). core never hardcodes provider pricing — a deployment injects it via
3
3
  * `RunnerDeps.pricing` or each `Model.cost`. All prices are **absolute per-1M-token USD**, not
4
4
  * multipliers: each provider's adapter precomputes its discount into an absolute value
5
- * (OpenAI/DeepSeek: the cache-hit price; Anthropic: base×0.1 read / ×1.25 5min-write / ×2.0 1h-write).
5
+ * (OpenAI/DeepSeek: the cache-hit price; Anthropic's published prompt-caching rates: base×0.1 read / ×1.25 5min-write / ×2.0 1h-write).
6
6
  */
7
7
  /** Per-1M-token absolute prices (USD) for a model. */
8
8
  export interface ModelPricing {
@@ -10,15 +10,16 @@ export interface ModelPricing {
10
10
  outputPer1M: number;
11
11
  /** Cache-read (hit) absolute price per 1M. Default 0 (treated as full-price input if absent). */
12
12
  cacheReadPer1M?: number;
13
- /** Cache-write 5-min-TTL absolute price per 1M (Anthropic ~1.25× base). 0 elsewhere. */
13
+ /** Cache-write 5-min-TTL absolute price per 1M (Anthropic's published rate: 1.25× the base input price). 0 elsewhere. */
14
14
  cacheWritePer1M?: number;
15
- /** Cache-write 1-hour-TTL absolute price per 1M (Anthropic ~2.0× base). 0 elsewhere. */
15
+ /** Cache-write 1-hour-TTL absolute price per 1M (Anthropic's published rate: 2× the base input price). 0 elsewhere. */
16
16
  cacheWriteLongPer1M?: number;
17
17
  }
18
18
  /**
19
19
  * Unified token counts for one task/turn, **already normalized** so `totalInputTokens` INCLUDES all
20
20
  * cache tokens (matching OTel `gen_ai.usage.input_tokens`). `cacheReadTokens`/`cacheWriteTokens`/
21
- * `cacheWriteTokensLong` are mutually exclusive subsets of `totalInputTokens`.
21
+ * `cacheWriteTokensLong` are mutually exclusive PRICING BUCKETS of `totalInputTokens` — not the usage counts: a provider's write count
22
+ * covers both lifetimes and its one-hour part is a subset of it, and the accounting seat (`usageCostMicroUsd`) splits it into these.
22
23
  */
23
24
  export interface TokenCounts {
24
25
  totalInputTokens: number;
@@ -61,11 +62,12 @@ export declare function isModelPriced(model: {
61
62
  * into a silent default.
62
63
  */
63
64
  export declare function malformedPricingField(pricing: ModelPricing): string | undefined;
64
- /** Map a vendor `Model.cost` (already per-1M absolute) to `ModelPricing`. We don't emit 1h cache
65
- * writes, so `cacheWriteLongPer1M` defaults to the 5-min write price (irrelevant while that count is 0). */
65
+ /** Map a vendor `Model.cost` (already per-1M absolute) to `ModelPricing`. A model that declares no one-hour write price
66
+ * (`cacheWriteLong`) gets its five-minute write price there: one-hour writes are priced like five-minute ones until a price says otherwise. */
66
67
  export declare function modelCostToPricing(cost: {
67
68
  input?: number;
68
69
  output?: number;
69
70
  cacheRead?: number;
70
71
  cacheWrite?: number;
72
+ cacheWriteLong?: number;
71
73
  } | undefined): ModelPricing;
@@ -35,6 +35,6 @@ export function modelCostToPricing(cost) {
35
35
  outputPer1M: cost?.output ?? 0,
36
36
  cacheReadPer1M: cost?.cacheRead,
37
37
  cacheWritePer1M: cost?.cacheWrite,
38
- cacheWriteLongPer1M: cost?.cacheWrite,
38
+ cacheWriteLongPer1M: cost?.cacheWriteLong ?? cost?.cacheWrite,
39
39
  };
40
40
  }
@@ -1,3 +1,16 @@
1
+ /** The longest name any face keeps, in UTF-16 units: the principal's name rule and the box's name spelling (a receipt id, a lease owner, a
2
+ * decision move's holder) read this one number. */
3
+ export declare const NAME_MAX_CHARS = 256;
4
+ /** The name rule as one clause for a refusal sentence that restates it ("must be a principal name (…)"): said once, so a face that spells the
5
+ * rule out never drifts from {@link principalNameOf}. */
6
+ export declare const PRINCIPAL_NAME_SPELLING = "a string with a visible character, no control or separator character, no format character but a joiner, and at most 256 characters";
7
+ /**
8
+ * Does the string have VISIBLE content — something left once white space and every Unicode format character (the joiners, the zero-width
9
+ * spaces, the bidirectional controls, the byte order mark) are taken away? The first clause of a name, read here once so that every face
10
+ * that keeps a name as an opaque key (a mailbox's receipt id, lease owner and holder) and every face that needs the whole name rule
11
+ * ({@link principalNameOf}) read "blank" the same way: a string of nothing but joiners is blank to both.
12
+ */
13
+ export declare function hasVisibleContent(raw: string): boolean;
1
14
  export declare function principalNameOf(raw: unknown): string | undefined;
2
15
  /** What a value offered as THE principal of a task or of a lookup is — read once, here, so no face decides it on its own. */
3
16
  export type PrincipalReading = {
@@ -1,7 +1,12 @@
1
1
  const NOT_IN_A_NAME = /[\p{Cc}\p{Zl}\p{Zp}]|(?![\u200c\u200d])\p{Cf}/u;
2
2
  const NOT_VISIBLE = /[\s\p{Cf}]+/gu;
3
+ export const NAME_MAX_CHARS = 256;
4
+ export const PRINCIPAL_NAME_SPELLING = `a string with a visible character, no control or separator character, no format character but a joiner, and at most ${NAME_MAX_CHARS} characters`;
5
+ export function hasVisibleContent(raw) {
6
+ return raw.replace(NOT_VISIBLE, "") !== "";
7
+ }
3
8
  export function principalNameOf(raw) {
4
- return typeof raw === "string" && raw.replace(NOT_VISIBLE, "") !== "" && !NOT_IN_A_NAME.test(raw) ? raw : undefined;
9
+ return typeof raw === "string" && raw.length <= NAME_MAX_CHARS && hasVisibleContent(raw) && !NOT_IN_A_NAME.test(raw) ? raw : undefined;
5
10
  }
6
11
  export function readPrincipal(raw) {
7
12
  if (raw === undefined || raw === "")
@@ -16,7 +21,9 @@ export function principalNameFault(raw) {
16
21
  return "an empty string";
17
22
  if (raw.trim() === "")
18
23
  return "a blank string";
19
- if (raw.replace(NOT_VISIBLE, "") === "")
24
+ if (!hasVisibleContent(raw))
20
25
  return "a string with no visible character";
26
+ if (raw.length > NAME_MAX_CHARS)
27
+ return `a string longer than ${NAME_MAX_CHARS} characters`;
21
28
  return "a string holding a control, separator or format character";
22
29
  }
@@ -0,0 +1,140 @@
1
+ /**
2
+ * Process identity — the ONE judgment of "is the process this record names still the one that wrote it".
3
+ *
4
+ * Every durable record that names a process owes this judgment: a file store's directory lock, a run's
5
+ * claim, a memory writer's session account. A pid alone is not an identity (the OS hands the number out
6
+ * again once its holder exits), and a pid is only meaningful inside the process table it was read from
7
+ * (another host's, another container's pid names nothing here). So the judgment has two halves, asked in
8
+ * this order:
9
+ *
10
+ * 1. COMPARABILITY — was the record written against THIS process table? Same host name, and the same pid
11
+ * namespace where this host can name one. A record that is not comparable is never judged: its pid is
12
+ * a number from somewhere else.
13
+ * 2. IDENTITY — in this table, does the pid still exist (only ESRCH says it does not), and has the start
14
+ * time the record carries been falsified by the process that holds the pid now?
15
+ *
16
+ * The asymmetry is the whole safety argument, and every degrade lands on it: a false "gone" hands a working
17
+ * process's directory, claim or uncommitted edits to someone else, while a false "live" costs a refusal
18
+ * that names its cause and its remedy. So anything this module cannot establish reads as live.
19
+ */
20
+ /**
21
+ * A process identity that survives PID REUSE: a pid, WHEN that pid's process started, and the process
22
+ * table the observation was made in (the host, and its pid namespace where one can be named).
23
+ *
24
+ * The start time is carried TWICE, against two different clocks, and that is the whole robustness of the
25
+ * thing. Both numbers come from ONE reading of the process's elapsed time, but one is subtracted from the
26
+ * WALL clock and the other from the host's UPTIME — and a platform that leaves one of them unmoved when
27
+ * the wall clock is corrected moves the other. (Where `ps` measures elapsed time against the boot clock, a
28
+ * corrected wall clock shifts the derived wall-clock start and leaves the uptime-relative one alone; where
29
+ * it measures against a stored absolute start, the reverse holds.) A comparison that insists on
30
+ * BOTH before calling a record stale therefore cannot be talked into a reclaim by a clock correction.
31
+ * See {@link processCensus}.
32
+ *
33
+ * Both are `null` when this host cannot produce a start time (no `ps`, a cut-down `ps` that rejects the
34
+ * query, a probe too slow for its own reading to be worth anything). That is a plain "unknown" — never a
35
+ * zero and never a guess — and every reader treats an unobtainable fingerprint as UNFALSIFIABLE.
36
+ */
37
+ export interface ProcessFingerprint {
38
+ /** The process id the rest of the record is about. */
39
+ readonly pid: number;
40
+ /** Start of that pid's process against the WALL clock, to the second; `null` when unobtainable here. */
41
+ readonly startedAtMs: number | null;
42
+ /** The same start against this host's UPTIME (ms after boot), to the second; `null` likewise. */
43
+ readonly startedSinceBootMs: number | null;
44
+ /** The host both were read on — a fingerprint from ANOTHER host is comparable to nothing here. */
45
+ readonly host: string;
46
+ /**
47
+ * The pid namespace the pid was read in (Linux: the `/proc/self/ns/pid` link, e.g. `pid:[4026531836]`).
48
+ * ABSENT where this host has no namespace it can name (macOS; a Linux whose `/proc` cannot be read) —
49
+ * there the host name alone decides comparability. Two containers can share a host name (a restarted
50
+ * container keeps its name) while their pids live in different tables, and the namespace is what tells
51
+ * them apart; a record that names no namespace, read on a host that has one, is therefore not
52
+ * comparable (it may come from either table) and is never judged gone.
53
+ */
54
+ readonly pidNs?: string;
55
+ }
56
+ /** What a record carries about a process — a {@link ProcessFingerprint}, any part of which an older or
57
+ * foreign spelling may lack (`null` and absent mean the same: not recorded). */
58
+ export interface ProcessRecord {
59
+ readonly pid: number;
60
+ readonly startedAtMs?: number | null;
61
+ readonly startedSinceBootMs?: number | null;
62
+ readonly host?: string | null;
63
+ readonly pidNs?: string | null;
64
+ }
65
+ /** Why a record could not be judged from here — each one a reason it may still be running. */
66
+ export type ProcessUncheckable =
67
+ /** Written on another host: its pid names a process in another process table. */
68
+ "another_host"
69
+ /** Written in another pid namespace (another container), or in one this process cannot name its own against. */
70
+ | "another_pid_namespace"
71
+ /** Written without naming its pid namespace (an older engine, or a writer that could not read it), and read
72
+ * on a host that has one: it may come from any process table that shares this host name. */
73
+ | "pid_namespace_unrecorded"
74
+ /** The pid exists, but no start time could be compared: a process now holding that number cannot be told
75
+ * apart from the one that wrote the record. */
76
+ | "start_time_unknown"
77
+ /** The process table answered the signal probe with something other than "no such process" or "exists". */
78
+ | "probe_refused";
79
+ /** The judgment of one record: proven gone, proven still running, or not judgeable from here (and why). */
80
+ export type ProcessVerdict = {
81
+ readonly state: "gone";
82
+ } | {
83
+ readonly state: "running";
84
+ } | {
85
+ readonly state: "uncheckable";
86
+ readonly why: ProcessUncheckable;
87
+ };
88
+ /** One question session over the process table. */
89
+ export interface ProcessCensus {
90
+ /** The verdict on one record. Within one census each pid is signalled at most once and its start time is
91
+ * probed at most once, however many records name it. */
92
+ verdict(record: ProcessRecord): ProcessVerdict;
93
+ }
94
+ /** The sentence fragment naming why a record could not be judged from here. */
95
+ export declare function uncheckableProcessText(why: ProcessUncheckable): string;
96
+ /**
97
+ * The fingerprint of a process: this one when called with no pid, any other pid when named. The process
98
+ * table it names is this one — the pid is read in this host's (and this namespace's) table.
99
+ *
100
+ * ONE derivation for both halves of the mechanism — the record a holder WRITES and the probe a later reader
101
+ * verifies it with — on purpose. Deriving our own start time from `process.uptime()` instead would be
102
+ * cheaper, but it measures from Node's own initialisation rather than from the kernel's `exec`, so a busy
103
+ * machine can put the two derivations seconds apart, and a reader comparing across them would read a
104
+ * healthy holder as gone. One derivation makes the tolerance a rounding allowance instead of a guess.
105
+ *
106
+ * The self case is memoized: our start time cannot change, the probe is a subprocess, and a process pays
107
+ * for it at most once, whatever records it writes.
108
+ */
109
+ export declare function processFingerprint(pid?: number): ProcessFingerprint;
110
+ /**
111
+ * A question session over the process table: judge any number of records, signalling each pid at most once
112
+ * and probing each pid's start time at most once (the probe is a subprocess, bounded at 2 s × 3 attempts, so
113
+ * a census that re-asked per record would multiply that by the record count).
114
+ *
115
+ * The verdict, in order:
116
+ * 1. COMPARABLE? A record written on another host, or in a pid namespace that is not provably this one
117
+ * (it names another; it names one and this process cannot name its own; it names none and this host has
118
+ * one), is `uncheckable` — and the pid is never signalled: a number from another table names nothing
119
+ * here, and signalling it would judge whatever unrelated process happens to hold it. With no namespace
120
+ * on either side (macOS), the host name decides alone. A record naming no host at all (a pre-fingerprint
121
+ * spelling) is compared on the namespace alone.
122
+ * 2. EXISTS? `kill(pid, 0)`: only ESRCH is `gone`. EPERM is a process that exists; any other error is the
123
+ * table refusing the question — `uncheckable`, never `gone`.
124
+ * 3. SAME PROCESS? The record's start time against the one observed now. One-sided: whatever holds a
125
+ * recycled pid necessarily started AFTER the record's writer did (the number was not free until it
126
+ * exited), so only a LATER observation can falsify, beyond {@link START_TIME_TOLERANCE_MS}. And BOTH
127
+ * clocks have to condemn the record: the wall-derived start and the uptime-derived one each move under a
128
+ * clock correction on exactly the platform where the other does not, so one alone never authorises a
129
+ * "gone". The uptime measure has a second way to condemn, a proof rather than a comparison: a start beyond
130
+ * this host's own uptime names a boot that is over. A record and an observation sharing no measure at all
131
+ * are `uncheckable` (`start_time_unknown`); otherwise the process is `running`.
132
+ */
133
+ export declare function processCensus(): ProcessCensus;
134
+ /**
135
+ * Is the process a record names possibly still the one that wrote it? `false` ONLY when it is proven gone
136
+ * (see {@link processCensus}): a record from another process table, a pid the table will not answer about,
137
+ * and a fingerprint nothing can falsify all read as live — a false "gone" hands a working process's
138
+ * directory or claim to someone else, while a false "live" costs a refusal an operator can act on.
139
+ */
140
+ export declare function isProcessLive(record: ProcessRecord): boolean;