@sema-agent/core 7.67.3 → 7.68.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 (496) hide show
  1. package/CHANGELOG.md +1516 -0
  2. package/README.md +18 -9
  3. package/README.zh-CN.md +16 -8
  4. package/dist/agents/agent-definition.d.ts +1 -1
  5. package/dist/agents/agent-definition.js +4 -1
  6. package/dist/agents/cascade.d.ts +2 -2
  7. package/dist/agents/cascade.js +3 -1
  8. package/dist/agents/cumulative-stats.d.ts +2 -1
  9. package/dist/agents/cumulative-stats.js +4 -1
  10. package/dist/agents/list-agents-tool.d.ts +30 -0
  11. package/dist/agents/list-agents-tool.js +45 -3
  12. package/dist/agents/peer-admission.d.ts +2 -2
  13. package/dist/agents/peer-session-drain.d.ts +2 -0
  14. package/dist/agents/peer-session-drain.js +1 -0
  15. package/dist/agents/repair-loop.js +3 -1
  16. package/dist/agents/retain-ledger.d.ts +61 -8
  17. package/dist/agents/retain-ledger.js +25 -3
  18. package/dist/agents/roster-store.d.ts +4 -2
  19. package/dist/agents/send-message-tool.d.ts +1 -1
  20. package/dist/agents/send-message-tool.js +20 -15
  21. package/dist/agents/subagent-steps.js +2 -10
  22. package/dist/agents/subagent.d.ts +3 -0
  23. package/dist/agents/subagent.js +106 -76
  24. package/dist/agents/tool-filter.d.ts +20 -11
  25. package/dist/agents/tool-filter.js +8 -4
  26. package/dist/agents/verify.d.ts +3 -1
  27. package/dist/agents/verify.js +2 -0
  28. package/dist/brain/anthropic.js +4 -4
  29. package/dist/brain/open-responses.js +3 -1
  30. package/dist/brain/openai.js +3 -1
  31. package/dist/brain/reasoning-request.d.ts +73 -19
  32. package/dist/brain/reasoning-request.js +164 -72
  33. package/dist/brain/reasoning-stamp.d.ts +26 -0
  34. package/dist/brain/reasoning-stamp.js +10 -0
  35. package/dist/brain/reasoning.d.ts +95 -162
  36. package/dist/brain/reasoning.js +31 -86
  37. package/dist/brain/route-adjudicator.d.ts +9 -7
  38. package/dist/brain/route-adjudicator.js +12 -10
  39. package/dist/brain/status-sink.d.ts +19 -64
  40. package/dist/brain/status-sink.js +5 -21
  41. package/dist/brain/stream-engine.d.ts +11 -2
  42. package/dist/brain/stream-engine.js +10 -0
  43. package/dist/core/a2a.d.ts +17 -5
  44. package/dist/core/a2a.js +11 -3
  45. package/dist/core/allow-entry.d.ts +35 -15
  46. package/dist/core/allow-entry.js +47 -60
  47. package/dist/core/ask-headline.d.ts +68 -0
  48. package/dist/core/ask-headline.js +23 -0
  49. package/dist/core/ask-origin.d.ts +36 -8
  50. package/dist/core/ask-origin.js +17 -10
  51. package/dist/core/ask-question.d.ts +34 -7
  52. package/dist/core/ask-question.js +10 -1
  53. package/dist/core/ask-unresolvable-notice.d.ts +7 -0
  54. package/dist/core/ask-unresolvable-notice.js +9 -3
  55. package/dist/core/auto-strip.d.ts +53 -0
  56. package/dist/core/auto-strip.js +76 -0
  57. package/dist/core/background-agent-store.d.ts +45 -5
  58. package/dist/core/background-agent-store.js +69 -15
  59. package/dist/core/background-shell.d.ts +2 -2
  60. package/dist/core/caller-text.js +2 -2
  61. package/dist/core/canonical-json.d.ts +13 -0
  62. package/dist/core/canonical-json.js +7 -0
  63. package/dist/core/checkpoint-features.d.ts +66 -20
  64. package/dist/core/checkpoint-features.js +12 -1
  65. package/dist/core/checkpoint-generation.d.ts +1 -1
  66. package/dist/core/checkpoint-queries.d.ts +1 -1
  67. package/dist/core/checkpoint-queries.js +4 -1
  68. package/dist/core/checkpoint-requirements.d.ts +25 -1
  69. package/dist/core/checkpoint-requirements.js +5 -1
  70. package/dist/core/checkpoint-row-verdict.d.ts +1 -0
  71. package/dist/core/checkpoint-row-verdict.js +4 -0
  72. package/dist/core/checkpoint-store.d.ts +66 -38
  73. package/dist/core/checkpoint-store.js +15 -6
  74. package/dist/core/child-clamp-seats.d.ts +6 -0
  75. package/dist/core/child-clamp-seats.js +1 -0
  76. package/dist/core/config-refusal-codes.d.ts +1 -1
  77. package/dist/core/config-refusal-codes.js +1 -0
  78. package/dist/core/delegation-frames.d.ts +9 -12
  79. package/dist/core/delegation-frames.js +9 -8
  80. package/dist/core/engine-capabilities.d.ts +21 -8
  81. package/dist/core/engine-capabilities.js +1 -1
  82. package/dist/core/engine-notice.d.ts +147 -34
  83. package/dist/core/engine-notice.js +27 -16
  84. package/dist/core/engine-storage-backend.d.ts +2 -1
  85. package/dist/core/env-budget.js +3 -3
  86. package/dist/core/env-knob-announce.d.ts +10 -10
  87. package/dist/core/env-knob-announce.js +3 -6
  88. package/dist/core/file-history-store.d.ts +29 -4
  89. package/dist/core/file-history-store.js +13 -0
  90. package/dist/core/frame-settlement.d.ts +2 -1
  91. package/dist/core/gate-fold.js +1 -1
  92. package/dist/core/gate-lanes.js +56 -49
  93. package/dist/core/governance-codes.d.ts +39 -3
  94. package/dist/core/governance-codes.js +61 -3
  95. package/dist/core/hooks.d.ts +29 -11
  96. package/dist/core/hooks.js +5 -2
  97. package/dist/core/human-input-projection.js +3 -3
  98. package/dist/core/input-author.d.ts +17 -3
  99. package/dist/core/input-author.js +15 -3
  100. package/dist/core/leg-identity.d.ts +10 -28
  101. package/dist/core/leg-identity.js +1 -21
  102. package/dist/core/lsp.d.ts +18 -13
  103. package/dist/core/lsp.js +30 -22
  104. package/dist/core/mailbox-store.d.ts +1 -1
  105. package/dist/core/mailbox-store.js +4 -4
  106. package/dist/core/mcp-connection-pool.d.ts +93 -4
  107. package/dist/core/mcp-connection-pool.js +104 -1
  108. package/dist/core/mcp-failure.d.ts +38 -12
  109. package/dist/core/mcp-failure.js +9 -13
  110. package/dist/core/mcp-probe.d.ts +4 -3
  111. package/dist/core/mcp-server-link.d.ts +4 -2
  112. package/dist/core/mcp-server-link.js +4 -5
  113. package/dist/core/mcp-server-spec.d.ts +3 -3
  114. package/dist/core/mcp-server-unavailable-notice.d.ts +22 -8
  115. package/dist/core/mcp-server-unavailable-notice.js +18 -4
  116. package/dist/core/mcp.d.ts +40 -6
  117. package/dist/core/mcp.js +39 -13
  118. package/dist/core/memory-engine/content-origin.js +2 -2
  119. package/dist/core/memory-engine/control-objects.d.ts +2 -4
  120. package/dist/core/memory-engine/control-objects.js +2 -10
  121. package/dist/core/memory-engine/delegation-settlement.js +6 -1
  122. package/dist/core/memory-engine/dual-root.js +3 -0
  123. package/dist/core/memory-engine/engine.d.ts +6 -4
  124. package/dist/core/memory-engine/engine.js +32 -29
  125. package/dist/core/memory-engine/file-backend.d.ts +20 -5
  126. package/dist/core/memory-engine/file-backend.js +21 -31
  127. package/dist/core/memory-engine/frontmatter.d.ts +2 -0
  128. package/dist/core/memory-engine/frontmatter.js +4 -0
  129. package/dist/core/memory-engine/layout.d.ts +114 -20
  130. package/dist/core/memory-engine/layout.js +340 -22
  131. package/dist/core/memory-engine/memory-deployment.d.ts +7 -5
  132. package/dist/core/memory-engine/mount-failed-notice.d.ts +19 -7
  133. package/dist/core/memory-engine/mount-failed-notice.js +43 -10
  134. package/dist/core/memory-engine/sync-client.js +4 -5
  135. package/dist/core/model-fallbacks.d.ts +5 -1
  136. package/dist/core/model-fallbacks.js +3 -3
  137. package/dist/core/model-receipt.d.ts +2 -1
  138. package/dist/core/model-receipt.js +12 -1
  139. package/dist/core/mods/kernel/dispatch.d.ts +2 -2
  140. package/dist/core/mods/kernel/dispatch.js +14 -6
  141. package/dist/core/mods/kernel/events.d.ts +8 -5
  142. package/dist/core/mods/kernel/events.js +2 -2
  143. package/dist/core/mods/kernel/index.d.ts +1 -1
  144. package/dist/core/mods/kernel/registration.d.ts +9 -0
  145. package/dist/core/mods/package.js +1 -1
  146. package/dist/core/mods/session-append.d.ts +4 -2
  147. package/dist/core/mods/session-append.js +3 -0
  148. package/dist/core/mods/stations.d.ts +7 -11
  149. package/dist/core/mods/stations.js +4 -7
  150. package/dist/core/mods/tool-call.d.ts +10 -8
  151. package/dist/core/mods/tool-call.js +15 -18
  152. package/dist/core/mounted-mcp.d.ts +0 -4
  153. package/dist/core/mounted-mcp.js +1 -1
  154. package/dist/core/park-noun.d.ts +24 -0
  155. package/dist/core/park-noun.js +21 -0
  156. package/dist/core/park-resumability.d.ts +60 -0
  157. package/dist/core/park-resumability.js +30 -0
  158. package/dist/core/permission-rule-provider.d.ts +24 -2
  159. package/dist/core/permission-rule-provider.js +11 -8
  160. package/dist/core/permission-rule-store.d.ts +8 -1
  161. package/dist/core/permission-rule-store.js +2 -3
  162. package/dist/core/permission-rules.d.ts +2 -1
  163. package/dist/core/permission-rules.js +8 -4
  164. package/dist/core/persisted-rule-arms.d.ts +3 -0
  165. package/dist/core/persisted-rule-arms.js +2 -1
  166. package/dist/core/present-plan-tool.d.ts +47 -3
  167. package/dist/core/present-plan-tool.js +62 -4
  168. package/dist/core/principal-name.d.ts +1 -1
  169. package/dist/core/principal-name.js +5 -5
  170. package/dist/core/process-identity.js +10 -5
  171. package/dist/core/protocol-http-auth.d.ts +20 -14
  172. package/dist/core/protocol-http-auth.js +70 -50
  173. package/dist/core/read-only-shell.js +9 -5
  174. package/dist/core/redaction-marks.d.ts +4 -26
  175. package/dist/core/redaction-marks.js +9 -21
  176. package/dist/core/remote-env.d.ts +43 -16
  177. package/dist/core/remote-env.js +1 -1
  178. package/dist/core/request-copy-projection.d.ts +1 -1
  179. package/dist/core/request-copy-projection.js +40 -50
  180. package/dist/core/resume-config-judge.js +1 -1
  181. package/dist/core/resume-startup-cause.d.ts +35 -18
  182. package/dist/core/resume-startup-cause.js +13 -10
  183. package/dist/core/retention.d.ts +167 -25
  184. package/dist/core/retention.js +100 -20
  185. package/dist/core/roles.d.ts +6 -0
  186. package/dist/core/roles.js +11 -5
  187. package/dist/core/rule-lane-reads.d.ts +3 -0
  188. package/dist/core/rule-lane-reads.js +5 -1
  189. package/dist/core/rule-store-fault.d.ts +70 -0
  190. package/dist/core/rule-store-fault.js +102 -0
  191. package/dist/core/runner/advertised-writable-dirs.js +16 -31
  192. package/dist/core/runner/announce-once-ledger.d.ts +19 -2
  193. package/dist/core/runner/announce-once-ledger.js +24 -2
  194. package/dist/core/runner/assemble-result.d.ts +6 -0
  195. package/dist/core/runner/assemble-result.js +1 -1
  196. package/dist/core/runner/auto-strip-notice.d.ts +36 -0
  197. package/dist/core/runner/auto-strip-notice.js +59 -0
  198. package/dist/core/runner/branch-window.d.ts +3 -0
  199. package/dist/core/runner/branch-window.js +37 -0
  200. package/dist/core/runner/caller-roster.d.ts +8 -3
  201. package/dist/core/runner/capability-withheld-seat.js +3 -9
  202. package/dist/core/runner/clock-and-limits.d.ts +22 -1
  203. package/dist/core/runner/clock-and-limits.js +30 -0
  204. package/dist/core/runner/contracts.d.ts +58 -35
  205. package/dist/core/runner/credential-refusal-seat.d.ts +2 -0
  206. package/dist/core/runner/credential-refusal-seat.js +47 -0
  207. package/dist/core/runner/cross-boundary-lane.js +6 -4
  208. package/dist/core/runner/decide-continuation.js +1 -1
  209. package/dist/core/runner/file-history-restore.d.ts +53 -2
  210. package/dist/core/runner/file-history-restore.js +29 -10
  211. package/dist/core/runner/forward-sink.d.ts +14 -1
  212. package/dist/core/runner/forward-sink.js +14 -12
  213. package/dist/core/runner/gate-exit.d.ts +8 -7
  214. package/dist/core/runner/gate-exit.js +13 -13
  215. package/dist/core/runner/git-status-frame.js +2 -4
  216. package/dist/core/runner/initial-run-state.js +1 -1
  217. package/dist/core/runner/main-call-account.d.ts +3 -1
  218. package/dist/core/runner/main-call-account.js +5 -3
  219. package/dist/core/runner/mcp-redial.d.ts +2 -5
  220. package/dist/core/runner/mcp-redial.js +2 -2
  221. package/dist/core/runner/nested-memory-content.d.ts +7 -1
  222. package/dist/core/runner/nested-memory-content.js +73 -13
  223. package/dist/core/runner/nested-memory-lane.d.ts +44 -19
  224. package/dist/core/runner/nested-memory-lane.js +152 -76
  225. package/dist/core/runner/park-commit.js +3 -1
  226. package/dist/core/runner/permission-rule-lanes.d.ts +8 -2
  227. package/dist/core/runner/permission-rule-lanes.js +29 -3
  228. package/dist/core/runner/person-path-rows.d.ts +3 -11
  229. package/dist/core/runner/person-path-rows.js +21 -24
  230. package/dist/core/runner/prepare-acquire-reconcile.js +3 -1
  231. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  232. package/dist/core/runner/prepare-artifact.js +20 -14
  233. package/dist/core/runner/prepare-ask-lane.d.ts +9 -6
  234. package/dist/core/runner/prepare-ask-lane.js +6 -5
  235. package/dist/core/runner/prepare-boundary-parks.d.ts +7 -1
  236. package/dist/core/runner/prepare-boundary-parks.js +27 -24
  237. package/dist/core/runner/prepare-caps-and-workflow.d.ts +5 -2
  238. package/dist/core/runner/prepare-caps-and-workflow.js +4 -3
  239. package/dist/core/runner/prepare-config-doors.d.ts +9 -24
  240. package/dist/core/runner/prepare-config-doors.js +58 -41
  241. package/dist/core/runner/prepare-context-lane.d.ts +2 -2
  242. package/dist/core/runner/prepare-context-lane.js +3 -5
  243. package/dist/core/runner/prepare-defer-classify.d.ts +1 -1
  244. package/dist/core/runner/prepare-defer-classify.js +1 -1
  245. package/dist/core/runner/prepare-delegation-surface.d.ts +2 -2
  246. package/dist/core/runner/prepare-delegation-surface.js +3 -2
  247. package/dist/core/runner/prepare-file-history.d.ts +62 -26
  248. package/dist/core/runner/prepare-file-history.js +117 -46
  249. package/dist/core/runner/prepare-gate-stations.d.ts +4 -0
  250. package/dist/core/runner/prepare-gate-stations.js +6 -5
  251. package/dist/core/runner/prepare-hands-readface.d.ts +9 -4
  252. package/dist/core/runner/prepare-hands-readface.js +8 -4
  253. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  254. package/dist/core/runner/prepare-inherited-gate.js +6 -6
  255. package/dist/core/runner/prepare-listings.d.ts +1 -1
  256. package/dist/core/runner/prepare-listings.js +1 -1
  257. package/dist/core/runner/prepare-memory.js +2 -2
  258. package/dist/core/runner/prepare-offload-wrappers.d.ts +1 -1
  259. package/dist/core/runner/prepare-offload-wrappers.js +1 -1
  260. package/dist/core/runner/prepare-park-ask.d.ts +10 -3
  261. package/dist/core/runner/prepare-park-ask.js +7 -9
  262. package/dist/core/runner/prepare-policy-chain.d.ts +18 -9
  263. package/dist/core/runner/prepare-policy-chain.js +18 -13
  264. package/dist/core/runner/prepare-project-context.d.ts +1 -1
  265. package/dist/core/runner/prepare-project-context.js +5 -3
  266. package/dist/core/runner/prepare-prompt-assembly.js +2 -1
  267. package/dist/core/runner/prepare-prompt-inputs.d.ts +2 -2
  268. package/dist/core/runner/prepare-prompt-inputs.js +1 -1
  269. package/dist/core/runner/prepare-protocol-tools.d.ts +4 -5
  270. package/dist/core/runner/prepare-protocol-tools.js +7 -7
  271. package/dist/core/runner/prepare-question-face.d.ts +4 -2
  272. package/dist/core/runner/prepare-run-refs.d.ts +7 -2
  273. package/dist/core/runner/prepare-run-refs.js +8 -7
  274. package/dist/core/runner/prepare-safety-scan.d.ts +4 -3
  275. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -7
  276. package/dist/core/runner/prepare-suspend-saga.js +4 -3
  277. package/dist/core/runner/prepare-task.js +66 -53
  278. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +3 -2
  279. package/dist/core/runner/prepare-tool-disclosure-mount.js +2 -1
  280. package/dist/core/runner/prepare-turn-wiring.d.ts +3 -1
  281. package/dist/core/runner/prepare-turn-wiring.js +1 -1
  282. package/dist/core/runner/prepare-wiring-manifest.d.ts +9 -4
  283. package/dist/core/runner/prepare-wiring-manifest.js +14 -6
  284. package/dist/core/runner/prepare-workspace-restore.d.ts +4 -4
  285. package/dist/core/runner/prepare-workspace-restore.js +15 -6
  286. package/dist/core/runner/remote-env-retry.d.ts +3 -3
  287. package/dist/core/runner/restore-seat.d.ts +41 -0
  288. package/dist/core/runner/restore-seat.js +38 -0
  289. package/dist/core/runner/resume-admission.js +1 -1
  290. package/dist/core/runner/resume-apply.js +4 -3
  291. package/dist/core/runner/resume-checkpoint-screen.js +2 -1
  292. package/dist/core/runner/resume-internals-and-config.js +2 -1
  293. package/dist/core/runner/resume-preflight.js +2 -1
  294. package/dist/core/runner/rewind-files.js +22 -6
  295. package/dist/core/runner/rule-store-unreadable-notice.d.ts +8 -0
  296. package/dist/core/runner/rule-store-unreadable-notice.js +11 -0
  297. package/dist/core/runner/run-brain-sinks.d.ts +3 -6
  298. package/dist/core/runner/run-brain-sinks.js +6 -6
  299. package/dist/core/runner/run-compaction-machinery.d.ts +2 -2
  300. package/dist/core/runner/run-git-lane.d.ts +2 -0
  301. package/dist/core/runner/run-git-lane.js +2 -1
  302. package/dist/core/runner/run-harness-handlers.js +5 -4
  303. package/dist/core/runner/run-identity-wiring.js +20 -12
  304. package/dist/core/runner/run-leg.js +31 -72
  305. package/dist/core/runner/run-notification-lane.d.ts +3 -0
  306. package/dist/core/runner/run-notification-lane.js +2 -4
  307. package/dist/core/runner/run-reasoning-seat.d.ts +5 -6
  308. package/dist/core/runner/run-reasoning-seat.js +13 -18
  309. package/dist/core/runner/run-settle-and-teardown.js +13 -9
  310. package/dist/core/runner/run-terminal-adoption.js +4 -8
  311. package/dist/core/runner/run-turn-boundary.js +6 -3
  312. package/dist/core/runner/runtask.d.ts +9 -4
  313. package/dist/core/runner/runtask.js +29 -22
  314. package/dist/core/runner/session-rule-policy.d.ts +11 -1
  315. package/dist/core/runner/shell-env-withheld.js +2 -7
  316. package/dist/core/runner/side-call-account.d.ts +5 -6
  317. package/dist/core/runner/side-call-account.js +2 -2
  318. package/dist/core/runner/stream-lifecycle-verbs.d.ts +3 -0
  319. package/dist/core/runner/stream-lifecycle-verbs.js +5 -3
  320. package/dist/core/runner/stream-settle-backstop.js +4 -6
  321. package/dist/core/runner/stream-steer-verb.d.ts +1 -1
  322. package/dist/core/runner/stream-steer-verb.js +4 -4
  323. package/dist/core/runner/sub-agent-deny-lists.d.ts +8 -3
  324. package/dist/core/runner/sub-agent-deny-lists.js +7 -4
  325. package/dist/core/runner/teardown-bounded.d.ts +7 -0
  326. package/dist/core/runner/teardown-bounded.js +7 -0
  327. package/dist/core/runner/terminal-account.js +41 -13
  328. package/dist/core/runner/terminal-projection.d.ts +1 -5
  329. package/dist/core/runner/tool-end-body.d.ts +9 -3
  330. package/dist/core/runner/tool-end-body.js +6 -3
  331. package/dist/core/runner/tool-output-projection.d.ts +13 -4
  332. package/dist/core/runner/tool-output-projection.js +10 -14
  333. package/dist/core/runner/turn-attachments.d.ts +3 -2
  334. package/dist/core/runner/turn-attachments.js +12 -5
  335. package/dist/core/runner-deps.d.ts +6 -6
  336. package/dist/core/runtime-caps.d.ts +2 -1
  337. package/dist/core/secret-env.d.ts +20 -3
  338. package/dist/core/secret-env.js +13 -15
  339. package/dist/core/session-checkout.d.ts +115 -15
  340. package/dist/core/session-checkout.js +435 -136
  341. package/dist/core/session-policy-store.js +21 -3
  342. package/dist/core/session-reconcile.js +1 -0
  343. package/dist/core/session-store.js +2 -0
  344. package/dist/core/session.d.ts +11 -1
  345. package/dist/core/shell-run-candidates.d.ts +1 -0
  346. package/dist/core/shell-run-candidates.js +1 -1
  347. package/dist/core/shutdown-debug.d.ts +6 -5
  348. package/dist/core/shutdown-debug.js +5 -1
  349. package/dist/core/skill-grant.js +4 -1
  350. package/dist/core/skills-directory.js +5 -3
  351. package/dist/core/spec-contract.d.ts +1 -1
  352. package/dist/core/store-contracts/checkpoint-store-contract.js +2 -7
  353. package/dist/core/store-contracts/file-history-store-contract.js +26 -2
  354. package/dist/core/store-contracts/session-deletion-cascade-contract.js +130 -14
  355. package/dist/core/store-contracts/task-list-store-contract.d.ts +2 -1
  356. package/dist/core/store-contracts/task-list-store-contract.js +28 -1
  357. package/dist/core/task-event.d.ts +48 -27
  358. package/dist/core/task-notification.d.ts +15 -9
  359. package/dist/core/task-notification.js +12 -0
  360. package/dist/core/task-registry-agent.d.ts +24 -22
  361. package/dist/core/task-registry-agent.js +65 -46
  362. package/dist/core/task-registry-shared.d.ts +17 -5
  363. package/dist/core/task-registry.d.ts +17 -6
  364. package/dist/core/task-registry.js +6 -1
  365. package/dist/core/task-result.d.ts +71 -25
  366. package/dist/core/task-spec-members.d.ts +0 -1
  367. package/dist/core/task-spec-members.js +1 -1
  368. package/dist/core/task-spec.d.ts +60 -52
  369. package/dist/core/task-stream.d.ts +45 -12
  370. package/dist/core/terminal-cause.d.ts +45 -8
  371. package/dist/core/terminal-cause.js +5 -0
  372. package/dist/core/tool-card-bound.d.ts +32 -0
  373. package/dist/core/tool-card-bound.js +33 -0
  374. package/dist/core/tool-catalog-entries.d.ts +9 -0
  375. package/dist/core/tool-catalog-entries.js +48 -0
  376. package/dist/core/tool-errors.d.ts +4 -3
  377. package/dist/core/tool-face.d.ts +3 -3
  378. package/dist/core/tool-mount-facts.d.ts +3 -2
  379. package/dist/core/tool-mount-facts.js +1 -1
  380. package/dist/core/tool-mount-static.js +7 -5
  381. package/dist/core/tool-policy.d.ts +21 -19
  382. package/dist/core/tool-policy.js +5 -6
  383. package/dist/core/tool-registry.d.ts +3 -1
  384. package/dist/core/tool-registry.js +15 -1
  385. package/dist/core/tool-result-store.d.ts +9 -3
  386. package/dist/core/tool-result-store.js +14 -1
  387. package/dist/core/tool-roster.d.ts +6 -0
  388. package/dist/core/tool-roster.js +18 -0
  389. package/dist/core/tool-spec.d.ts +17 -8
  390. package/dist/core/trace.d.ts +35 -31
  391. package/dist/core/types.d.ts +2 -2
  392. package/dist/core/untrusted-egress.d.ts +10 -9
  393. package/dist/core/untrusted-egress.js +9 -9
  394. package/dist/core/untrusted-text.d.ts +0 -18
  395. package/dist/core/untrusted-text.js +7 -3
  396. package/dist/core/user-attachment.d.ts +9 -6
  397. package/dist/core/user-attachment.js +12 -10
  398. package/dist/core/user-row-origin.d.ts +44 -25
  399. package/dist/core/user-row-origin.js +30 -20
  400. package/dist/core/wiring-manifest.d.ts +26 -7
  401. package/dist/core/wiring-manifest.js +14 -11
  402. package/dist/core/workspace-snapshot.d.ts +3 -1
  403. package/dist/core/workspace-snapshot.js +1 -0
  404. package/dist/engine/execution-env/node-execution-env.d.ts +23 -16
  405. package/dist/engine/execution-env/node-execution-env.js +127 -67
  406. package/dist/engine/harness/agent-harness.d.ts +4 -5
  407. package/dist/engine/harness/agent-harness.js +2 -7
  408. package/dist/engine/harness/types.d.ts +51 -19
  409. package/dist/engine/harness/types.js +28 -1
  410. package/dist/engine/llm/types.d.ts +26 -14
  411. package/dist/engine/llm/types.js +2 -2
  412. package/dist/engine/loop/agent-loop.d.ts +2 -2
  413. package/dist/engine/loop/agent-loop.js +51 -275
  414. package/dist/engine/loop/types.d.ts +0 -18
  415. package/dist/engine/session/import-validate.d.ts +3 -0
  416. package/dist/engine/session/import-validate.js +34 -2
  417. package/dist/engine/session/repo-utils.d.ts +42 -4
  418. package/dist/engine/session/repo-utils.js +33 -5
  419. package/dist/engine/session/session.d.ts +41 -14
  420. package/dist/engine/session/session.js +96 -25
  421. package/dist/index.d.ts +21 -16
  422. package/dist/index.js +16 -10
  423. package/dist/orchestration/run-spec.d.ts +1 -1
  424. package/dist/orchestration/run-workflow-tool.d.ts +12 -9
  425. package/dist/orchestration/run-workflow-tool.js +15 -19
  426. package/dist/orchestration/workflow-governance.js +13 -21
  427. package/dist/orchestration/workflow-observe.d.ts +4 -3
  428. package/dist/orchestration/workflow-primitives.d.ts +1 -1
  429. package/dist/orchestration/workflow-record-artifact.d.ts +14 -0
  430. package/dist/orchestration/workflow-record-artifact.js +32 -0
  431. package/dist/orchestration/workflow-script-store.d.ts +9 -0
  432. package/dist/orchestration/workflow-script-store.js +20 -1
  433. package/dist/orchestration/workflow-types.d.ts +33 -3
  434. package/dist/orchestration/workflow.d.ts +24 -14
  435. package/dist/orchestration/workflow.js +52 -23
  436. package/dist/prompt-assembly/artifact.js +4 -8
  437. package/dist/prompt-assembly/catalog/engine.d.ts +263 -0
  438. package/dist/prompt-assembly/catalog/engine.js +30 -0
  439. package/dist/prompt-assembly/catalog/index.d.ts +1 -1
  440. package/dist/prompt-assembly/catalog/index.js +2 -2
  441. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +1 -1
  442. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +29 -0
  443. package/dist/prompt-assembly/epoch.js +6 -8
  444. package/dist/prompt-assembly/turn-snapshot.js +8 -9
  445. package/dist/stores/file/background-agent-store.js +5 -6
  446. package/dist/stores/file/checkpoint-store.d.ts +0 -4
  447. package/dist/stores/file/checkpoint-store.js +7 -3
  448. package/dist/stores/file/file-history-store.d.ts +8 -0
  449. package/dist/stores/file/file-history-store.js +72 -0
  450. package/dist/stores/file/fs-atomic.js +17 -12
  451. package/dist/stores/file/index.js +11 -5
  452. package/dist/stores/file/mailbox-store.js +13 -4
  453. package/dist/stores/file/permission-rule-store.js +14 -13
  454. package/dist/stores/file/shared-ledger.d.ts +4 -0
  455. package/dist/stores/file/shared-ledger.js +4 -0
  456. package/dist/stores/file/task-list-store.js +12 -3
  457. package/dist/stores/file/workflow-run-store.js +1 -0
  458. package/dist/tools/fs/bash-program-position.d.ts +4 -2
  459. package/dist/tools/fs/bash-program-position.js +1 -1
  460. package/dist/tools/fs/bash-readonly-classifier.js +1 -1
  461. package/dist/tools/fs/bound-open.d.ts +97 -0
  462. package/dist/tools/fs/bound-open.js +103 -0
  463. package/dist/tools/fs/containment-face.d.ts +2 -2
  464. package/dist/tools/fs/fs-pdf.d.ts +7 -1
  465. package/dist/tools/fs/fs-pdf.js +31 -23
  466. package/dist/tools/fs/fs-read.d.ts +24 -17
  467. package/dist/tools/fs/fs-read.js +84 -53
  468. package/dist/tools/fs/fs-shared.d.ts +14 -12
  469. package/dist/tools/fs/fs-shared.js +5 -4
  470. package/dist/tools/fs/fs-write.d.ts +2 -2
  471. package/dist/tools/fs/fs-write.js +20 -12
  472. package/dist/tools/fs/index.d.ts +4 -4
  473. package/dist/tools/fs/index.js +2 -2
  474. package/dist/tools/fs/notebook.d.ts +1 -1
  475. package/dist/tools/fs/pdf.d.ts +12 -3
  476. package/dist/tools/fs/pdf.js +22 -9
  477. package/dist/tools/fs/read-deny-home.d.ts +3 -2
  478. package/dist/tools/fs/read-deny-home.js +8 -11
  479. package/dist/tools/fs/safety.d.ts +3 -2
  480. package/dist/tools/fs/shell-read-check.js +10 -9
  481. package/dist/tools/monitor.d.ts +6 -5
  482. package/dist/tools/task-list.d.ts +16 -6
  483. package/dist/tools/task-list.js +4 -0
  484. package/dist/tools/web.d.ts +9 -1
  485. package/dist/tools/web.js +8 -3
  486. package/dist/tools/worktree.d.ts +7 -5
  487. package/dist/tools/worktree.js +4 -3
  488. package/package.json +4 -3
  489. package/test/export-surface.snapshot.json +93 -7
  490. package/wire-changes/core-stores-sql@7.68.0.json +39 -0
  491. package/wire-changes/core@7.68.0.json +4257 -0
  492. package/wire-changes/mods-kernel@7.68.0.json +129 -0
  493. package/wire-changes/primitives@7.68.0.json +253 -0
  494. package/wire-changes/wiki-gate@7.68.0.json +39 -0
  495. package/dist/core/runner/credential-origin-seat.d.ts +0 -2
  496. package/dist/core/runner/credential-origin-seat.js +0 -20
@@ -4,9 +4,10 @@ import { MARKED_BLOCK_AFTER_DATA, mintSystemReminder, openSystemReminder } from
4
4
  import { isCleared } from "./context-edit.js";
5
5
  import { pathConfinableWriteToolNames } from "./tool-registry.js";
6
6
  import { writeTargetPath } from "../tools/fs/safety.js";
7
- import { seededFileUnchangedReminder } from "../tools/fs/fs-shared.js";
8
7
  export const READ_TOOL_NAMES = new Set(["read", "Read", "read_file"]);
9
8
  const sha256 = (text) => createHash("sha256").update(text, "utf8").digest("hex");
9
+ const WHOLE_VIEW = "whole";
10
+ const wholeIdentity = (hash) => `w:${hash}`;
10
11
  const isRecord = (v) => typeof v === "object" && v !== null;
11
12
  const textOf = (content) => {
12
13
  if (typeof content === "string")
@@ -23,18 +24,18 @@ const textOf = (content) => {
23
24
  return out;
24
25
  };
25
26
  const RETIRED_READ_STUB = /^\[([\s\S]+): unchanged since you last read it \(lines (\d+)-(\d+) of (\d+)\); content omitted to save context\]$/;
27
+ const SEEDED_BODY = 'This file is already in your context (see "Contents of ';
28
+ const SEEDED_TAIL = '" above) and has not changed on disk. Use that content instead of re-reading.</system-reminder>';
26
29
  const BARE_OPEN = openSystemReminder(undefined);
27
- const [SEEDED_HEAD = "", SEEDED_TAIL = ""] = seededFileUnchangedReminder("\u0000", undefined).split("\u0000");
28
30
  function retiredSeededPath(text) {
29
- const body = SEEDED_HEAD.slice(BARE_OPEN.length);
30
- const at = text.indexOf(body);
31
+ const at = text.indexOf(SEEDED_BODY);
31
32
  if (at <= 0 || !text.endsWith(SEEDED_TAIL))
32
33
  return undefined;
33
34
  const open = text.slice(0, at);
34
35
  const mark = /^ mark="([^"]*)">$/.exec(open.slice(BARE_OPEN.length - 1))?.[1];
35
36
  if (open !== BARE_OPEN && (mark === undefined || open !== openSystemReminder(mark)))
36
37
  return undefined;
37
- const path = text.slice(at + body.length, text.length - SEEDED_TAIL.length);
38
+ const path = text.slice(at + SEEDED_BODY.length, text.length - SEEDED_TAIL.length);
38
39
  return path.length > 0 ? path : undefined;
39
40
  }
40
41
  export function isRetiredDedupStub(m) {
@@ -96,8 +97,9 @@ function mintCopy(m) {
96
97
  return undefined;
97
98
  const view = obs.entry.view;
98
99
  const whole = obs.entry.truncated === false;
99
- const identity = frame.kind === "notebook" ? `nbf:${obs.entry.hash}` : whole ? `w:${obs.entry.hash}` : `fr:${obs.entry.hash}:${view?.start ?? 0}-${view?.end ?? 0}`;
100
- return { carrier: "frame", attachment: frame, identity, paths: [frame.label, obs.key], ...(whole && frame.kind === "text" ? { wholeHash: obs.entry.hash } : {}) };
100
+ const identity = frame.kind === "notebook" ? `nbf:${obs.entry.hash}` : whole ? wholeIdentity(obs.entry.hash) : `fr:${obs.entry.hash}:${view?.start ?? 0}-${view?.end ?? 0}`;
101
+ const shown = frame.kind === "notebook" ? "nbf" : whole ? WHOLE_VIEW : `fr:${view?.start ?? 0}-${view?.end ?? 0}`;
102
+ return { carrier: "frame", attachment: frame, identity, view: shown, paths: [frame.label, obs.key] };
101
103
  }
102
104
  if (m.role !== "toolResult" || m.isError === true || typeof m.toolName !== "string" || !READ_TOOL_NAMES.has(m.toolName))
103
105
  return undefined;
@@ -117,12 +119,12 @@ function mintCopy(m) {
117
119
  const end = start + numLines - 1;
118
120
  const hash = sha256(content);
119
121
  const whole = start === 1 && end === total;
120
- return { carrier: "read", filePath, window: { start, end, total }, identity: whole ? `w:${hash}` : `rr:${hash}:${start}-${end}:${total}`, paths: [filePath], ...(whole ? { wholeHash: hash } : {}) };
122
+ return { carrier: "read", filePath, window: { start, end, total }, identity: whole ? wholeIdentity(hash) : `rr:${hash}:${start}-${end}:${total}`, view: whole ? WHOLE_VIEW : `rr:${start}-${end}`, paths: [filePath] };
121
123
  }
122
124
  if (details.type === "notebook") {
123
125
  if (!Array.isArray(file.cells) || file.cells.length === 0)
124
126
  return undefined;
125
- return { carrier: "read", filePath, identity: `nbr:${sha256(JSON.stringify(m.content))}`, paths: [filePath] };
127
+ return { carrier: "read", filePath, identity: `nbr:${sha256(JSON.stringify(m.content))}`, view: "nbr", paths: [filePath] };
126
128
  }
127
129
  return undefined;
128
130
  }
@@ -148,13 +150,18 @@ function writtenNames(m) {
148
150
  }
149
151
  return out;
150
152
  }
153
+ const sameFile = (spelling, key) => spelling === key || baseName(spelling) === baseName(key);
154
+ const holds = (h, spelling) => h.paths.has(spelling) || (h.seed === true && [...h.paths].some((key) => sameFile(spelling, key)));
151
155
  class CopyWalk {
152
156
  input;
153
157
  heads = new Map();
154
- seedBroken = new Set();
155
158
  told = new Set();
156
159
  constructor(input) {
157
160
  this.input = input;
161
+ for (const [key, hash] of input.seeded ?? []) {
162
+ const identity = wholeIdentity(hash);
163
+ this.heads.set(identity, [...(this.heads.get(identity) ?? []), { paths: new Set([key]), pointer: false, view: WHOLE_VIEW, seed: true }]);
164
+ }
158
165
  }
159
166
  toldBefore(f) {
160
167
  const key = `${f.mtimeMs}\u0000${f.path}`;
@@ -163,60 +170,43 @@ class CopyWalk {
163
170
  this.told.add(key);
164
171
  return false;
165
172
  }
166
- write(names) {
167
- if (names.length === 0)
168
- return;
169
- const hit = new Set(names);
173
+ end(ends) {
170
174
  for (const [identity, list] of this.heads) {
171
- const kept = list.filter((h) => ![...h.paths].some((p) => hit.has(baseName(p))));
175
+ const kept = list.filter((h) => !ends(h));
172
176
  if (kept.length === 0)
173
177
  this.heads.delete(identity);
174
- else
178
+ else if (kept.length < list.length)
175
179
  this.heads.set(identity, kept);
176
180
  }
177
- for (const n of names)
178
- this.seedBroken.add(`name:${n}`);
181
+ }
182
+ write(names) {
183
+ if (names.length === 0)
184
+ return;
185
+ const hit = new Set(names);
186
+ this.end((h) => [...h.paths].some((p) => hit.has(baseName(p))));
179
187
  }
180
188
  decide(d) {
181
189
  if ("retired" in d)
182
190
  return "pointer";
183
- const seeded = seededKeyOf(d, this.input.seeded);
184
- if (seeded !== undefined && !this.seedBroken.has(seeded) && !this.seedBroken.has(`name:${baseName(seeded)}`))
185
- return "seeded";
186
- for (const key of this.input.seeded?.keys() ?? [])
187
- if (d.paths.some((p) => sameFile(p, key)) && this.input.seeded?.get(key) !== d.wholeHash)
188
- this.seedBroken.add(key);
191
+ const standsFor = d.carrier === "frame";
192
+ const pointer = this.input.degraded?.has(d.identity) === true;
189
193
  const list = this.heads.get(d.identity) ?? [];
190
- const head = list.find((h) => d.paths.some((p) => h.paths.has(p)));
194
+ const head = list.find((h) => d.paths.some((p) => holds(h, p)));
191
195
  if (head !== undefined) {
192
- for (const p of d.paths)
193
- head.paths.add(p);
194
- return head.pointer ? "pointer" : "not_repeated";
196
+ if (head.seed !== true)
197
+ for (const p of d.paths)
198
+ head.paths.add(p);
199
+ if (!standsFor)
200
+ return pointer ? "pointer" : "contents";
201
+ return head.seed === true ? "seeded" : head.pointer ? "pointer" : "not_repeated";
195
202
  }
196
- const pointer = this.input.degraded?.has(d.identity) === true;
197
- this.heads.set(d.identity, [...list, { paths: new Set(d.paths), pointer }]);
203
+ this.end((h) => h.view === d.view && d.paths.some((p) => holds(h, p)));
204
+ this.heads.set(d.identity, [...(this.heads.get(d.identity) ?? []), { paths: new Set(d.paths), pointer, view: d.view }]);
198
205
  return pointer ? "pointer" : "contents";
199
206
  }
200
207
  }
201
- const sameFile = (spelling, key) => spelling === key || baseName(spelling) === baseName(key);
202
- function seededKeyOf(d, seeded) {
203
- if (seeded === undefined || d.wholeHash === undefined)
204
- return undefined;
205
- for (const [key, hash] of seeded)
206
- if (hash === d.wholeHash && d.paths.some((p) => sameFile(p, key)))
207
- return key;
208
- return undefined;
209
- }
210
- function readSentence(d, rendering, input) {
211
- const r = d;
212
- if (rendering === "seeded")
213
- return seededFileUnchangedReminder(seededKeyOf(d, input.seeded) ?? r.filePath, input.mark);
208
+ function readPointerSentence(r) {
214
209
  const w = r.window;
215
- if (rendering === "not_repeated") {
216
- return w !== undefined
217
- ? `[${r.filePath}: unchanged since you last read it (lines ${w.start}-${w.end} of ${w.total}); content omitted to save context]`
218
- : `[${r.filePath}: unchanged since you last read it (the whole notebook); content omitted to save context]`;
219
- }
220
210
  return w !== undefined
221
211
  ? `[${r.filePath}: lines ${w.start}-${w.end} of ${w.total} — contents not included in this result; read the file again if you need them]`
222
212
  : `[${r.filePath}: contents not included in this result; read the file again if you need them]`;
@@ -277,7 +267,7 @@ function renderOne(m, walk, input) {
277
267
  const d = deliveryOf(p);
278
268
  const rendering = d === undefined ? "contents" : walk.decide(d);
279
269
  const own = isRecord(p) && Array.isArray(p.content) ? p.content : [];
280
- return rendering === "contents" || d === undefined ? own : [{ type: "text", text: readSentence(d, rendering, input) }];
270
+ return rendering === "contents" || d?.carrier !== "read" ? own : [{ type: "text", text: readPointerSentence(d) }];
281
271
  });
282
272
  if (parts.every((p, i) => segments[i] === (isRecord(p) && Array.isArray(p.content) ? p.content : undefined)))
283
273
  return m;
@@ -292,7 +282,7 @@ function renderOne(m, walk, input) {
292
282
  return m;
293
283
  if (d.carrier === "frame")
294
284
  return renderFrame(m, d.attachment, rendering, input);
295
- return Object.assign({}, m, { content: [{ type: "text", text: readSentence(d, rendering, input) }], details: undefined });
285
+ return Object.assign({}, m, { content: [{ type: "text", text: readPointerSentence(d) }], details: undefined });
296
286
  }
297
287
  const NOTICE_SEPARATOR_MAX = 2;
298
288
  const untoldFilesOf = (n, walk) => n.files.filter((f) => !walk.toldBefore(f));
@@ -61,7 +61,7 @@ export function resumeConfigVerdictOf(question, seats) {
61
61
  const supplied = readResumeConfig(question.taskConfig);
62
62
  const internals = snapshotResumeInternals(bag);
63
63
  resolveResumeStore(supplied, seats.deps);
64
- const config = refuseResumeDoors(supplied, seats.deps, seats.sessions, internals?.holder);
64
+ const config = refuseResumeDoors(supplied, seats.deps, seats.sessions, internals);
65
65
  refuseRecordedAndMountedToolNames(row, internals, config.tools);
66
66
  refuseRetiredInheritedConstraints(internals);
67
67
  refuseScopesOffInheritedIsolationScope(row.isolationScope || undefined, config.isolationScope || undefined, config);
@@ -6,8 +6,8 @@
6
6
  * terminal code — never from its sentence; a code this table does not name reads as ABSENT (not known),
7
7
  * which each consumer answers in its own documented way rather than with a guessed cause.
8
8
  *
9
- * · `environment` — the leg's infrastructure failed (the workspace restore, an abort): the decision is
10
- * untouched, and a retry replays it;
9
+ * · `environment` — the leg's infrastructure failed (the workspace restore, an abort, an `env.*` refusal of the
10
+ * execution environment): the decision is untouched, and a retry replays it;
11
11
  * · `session_gone` — the resumed agent's transcript session is missing;
12
12
  * · `transcript_corrupt` — the resumed agent's transcript session is THERE but cannot be read as a session
13
13
  * (`corrupt_session`): its log has no header its store wrote, or its entry tree does not hold together — a leaf,
@@ -25,7 +25,7 @@
25
25
  */
26
26
  import type { AssertAllKeysHandled } from "./ask-origin.js";
27
27
  import type { Checkpoint, CheckpointStore, CheckpointToken } from "./checkpoint-store.js";
28
- import type { TerminalFailureDetail } from "./terminal-cause.js";
28
+ import type { TerminalFailureDetail, UnstartedRowOutcome } from "./terminal-cause.js";
29
29
  /**
30
30
  * design/80 D-1: why a consumed checkpoint was {@link import("./checkpoint-store.js").CheckpointStore.reopen | reopened}
31
31
  * (resolved → pending). The reason drives re-resume validation (§3 invariant #1): an `env_failed` reopen is a SYSTEM
@@ -52,7 +52,10 @@ export type ReopenReason = (typeof REOPEN_REASONS)[number];
52
52
  export declare const RESUME_STARTUP_CAUSES: readonly ["environment", "session_gone", "transcript_corrupt", "tool_unavailable", "configuration", "decision_rejected"];
53
53
  export type ResumeStartupCause = (typeof RESUME_STARTUP_CAUSES)[number];
54
54
  /** The cause a resume failure's code names; `undefined` when the code is absent or the table does not
55
- * name it. Every `config.*` code is a configuration door's refusal. */
55
+ * name it. Every `config.*` code is a configuration door's refusal; every `env.*` code is the execution environment's
56
+ * own (a refusal its adapter answered when the leg established it, or the engine's `env.lifetime_expired`). The
57
+ * terminal code table files the same namespace under `WorkerErrorClass` `config` — that answers which class and what
58
+ * to change; this answers why the resume could not run. */
56
59
  export declare function resumeStartupCauseOf(code: string | undefined): ResumeStartupCause | undefined;
57
60
  /**
58
61
  * The members of a resume refusal's `detail` the parked-resume receipt carries beside its `cause` — the three a
@@ -86,22 +89,32 @@ export type ReopenReasonTableCoversEveryCause = AssertAllKeysHandled<Exclude<Res
86
89
  * decision is untouched, and the retry replays it.
87
90
  */
88
91
  export declare function reopenReasonOf(cause: ResumeStartupCause | undefined): ReopenReason;
92
+ /** The facts each {@link UnstartedRowOutcome} word carries in the engine's own record — a table over the one word set, total both ways. */
93
+ interface UnstartedRowFacts {
94
+ /** the reason the row was reopened under (pending again) */
95
+ readonly reopened: {
96
+ readonly reason: ReopenReason;
97
+ };
98
+ /** the store's `reopen` answered `false`: the row is no longer the resolved row this leg claimed — missing, expired, its decided
99
+ * action already disposed, or pending again — which the boolean does not say */
100
+ readonly declined: object;
101
+ /** what the reopen threw, when the row does not show it landed: the write may have committed and only its acknowledgement been
102
+ * lost, so the row's state cannot be proven from here */
103
+ readonly unknown: {
104
+ readonly thrown: unknown;
105
+ };
106
+ }
107
+ export type UnstartedRowFactsCoverEveryOutcome = AssertAllKeysHandled<Exclude<UnstartedRowOutcome, keyof UnstartedRowFacts> | Exclude<keyof UnstartedRowFacts, UnstartedRowOutcome>>;
89
108
  /**
90
109
  * What happened to a claimed row whose approved action never started — the one closed outcome every exit of such a leg reports
91
- * (the thrown-prepare backstop, the returned-leg settle, the post-claim abort): `reopened` under a reason (the row is pending again),
92
- * `declined` (the store's `reopen` answered `false`: the row is no longer the resolved row this leg claimed — missing, expired, its
93
- * decided action already disposed, or pending again — which the boolean does not say), `unknown` (the reopen threw and the row does not
94
- * show that it landed: the write may have committed and only its acknowledgement been lost, so the row's state cannot be proven from here).
110
+ * (the thrown-prepare backstop, the returned-leg settle, the post-claim abort), its word ({@link UnstartedRowOutcome}, the one
111
+ * declaration every carrier reads) beside the facts that word carries ({@link UnstartedRowFacts}).
95
112
  */
96
113
  export type UnstartedRow = {
97
- readonly kind: "reopened";
98
- readonly reason: ReopenReason;
99
- } | {
100
- readonly kind: "declined";
101
- } | {
102
- readonly kind: "unknown";
103
- readonly thrown: unknown;
104
- };
114
+ [K in UnstartedRowOutcome]: {
115
+ readonly kind: K;
116
+ } & UnstartedRowFacts[K];
117
+ }[UnstartedRowOutcome];
105
118
  /**
106
119
  * THE compensation of a claimed leg whose approved action never started: the claim's reversal (`reopen`, bound to the row) asked once,
107
120
  * under `reason`, and read into {@link UnstartedRow} — its answer, never a code sniffed off whatever it threw (a store's own error may
@@ -117,6 +130,10 @@ export declare function compensateUnstarted(reopen: (reason: ReopenReason) => Pr
117
130
  * reopen having landed. A pending row at the claim's own generation is a read older than the claim, and proves nothing.
118
131
  */
119
132
  export declare function claimedRowPendingOf(store: Pick<CheckpointStore, "get">, token: CheckpointToken, claimed: Pick<Checkpoint, "rev">): () => Promise<boolean>;
120
- /** The sentence for {@link UnstartedRow} — one per outcome, the same on every exit; the exit puts its own lead before it. */
121
- export declare function unstartedRowSentence(row: UnstartedRow): string;
133
+ /** The sentence for {@link UnstartedRow} — one per outcome, the same on every exit; the exit puts its own lead before it. What
134
+ * never started and what the person gave are named by the kind of pause the claimed row was ({@link parkNounOf}): a wake is
135
+ * not an approval. Each says what happened, whether the pause is still waiting, and what to do — `declined` (the engine asked to put
136
+ * the pause back and was told it no longer is the one the resume took) and `unknown` (the attempt failed partway: it may or may not
137
+ * be waiting) differ in the one thing a reader must not do: ask for a new grant while the old one may still be usable. */
138
+ export declare function unstartedRowSentence(row: UnstartedRow, parked: Pick<Checkpoint, "pendingAction"> | undefined): string;
122
139
  export {};
@@ -1,4 +1,5 @@
1
1
  import { checkpointRevOf } from "./checkpoint-generation.js";
2
+ import { parkNounOf } from "./park-noun.js";
2
3
  import { egressThrownText } from "./untrusted-egress.js";
3
4
  export const REOPEN_REASONS = Object.freeze(["env_failed", "tool_unavailable", "constraint_rejected", "config_refused"]);
4
5
  export const RESUME_STARTUP_CAUSES = Object.freeze(["environment", "session_gone", "transcript_corrupt", "tool_unavailable", "configuration", "decision_rejected"]);
@@ -23,7 +24,7 @@ const CAUSE_OF_CODE = new Map([
23
24
  export function resumeStartupCauseOf(code) {
24
25
  if (code === undefined)
25
26
  return undefined;
26
- return CAUSE_OF_CODE.get(code) ?? (code.startsWith("config.") ? "configuration" : undefined);
27
+ return CAUSE_OF_CODE.get(code) ?? (code.startsWith("config.") ? "configuration" : code.startsWith("env.") ? "environment" : undefined);
27
28
  }
28
29
  export const RESUME_REFUSAL_MEMBERS = Object.freeze(["code", "field", "reason"]);
29
30
  export function resumeRefusalDetailOf(account) {
@@ -64,25 +65,27 @@ export function claimedRowPendingOf(store, token, claimed) {
64
65
  return row !== null && row.status === "pending" && checkpointRevOf(row) > claimedRev;
65
66
  };
66
67
  }
67
- export function unstartedRowSentence(row) {
68
+ export function unstartedRowSentence(row, parked) {
69
+ const noun = parkNounOf(parked);
68
70
  switch (row.kind) {
69
71
  case "reopened":
70
- return reopenedUnstartedSentence(row.reason);
72
+ return reopenedUnstartedSentence(row.reason, noun);
71
73
  case "declined":
72
- return "the approved action never started, and the store DECLINED to reopen the checkpoint — it is no longer the resolved row this leg claimed (missing, expired, its decided action already disposed, or pending again): read the row before deciding; if it is resolved or gone, a retry needs a fresh approval";
74
+ return `${noun.started} never started, and ${noun.waiting} could not be put back to waiting: it is no longer the one this resume took (it is gone, has expired, was already used, or is waiting again). Check where it stands now before deciding anything: if it is waiting again, ${noun.again}; if it is gone or already used, carrying on needs a fresh ${noun.grant}`;
73
75
  case "unknown":
74
- return `the approved action never started, and reopening the checkpoint FAILED IN FLIGHT (${egressThrownText("same-principal", row.thrown)}) — its state UNKNOWN, unprovable from here: re-read it before deciding; do NOT issue a fresh approval on the assumption the old one is dead`;
76
+ return `${noun.started} never started, and putting ${noun.waiting} back to waiting failed partway (${egressThrownText("same-principal", row.thrown)}), so it is not known whether it is waiting now. Check where it stands before deciding anything, and do not ask for a fresh ${noun.grant} until that is known: the old one may still be usable`;
75
77
  }
76
78
  }
77
- function reopenedUnstartedSentence(reason) {
79
+ function reopenedUnstartedSentence(reason, noun) {
80
+ const lead = `${noun.started} never started, so the checkpoint was REOPENED (pending)`;
78
81
  switch (reason) {
79
82
  case "env_failed":
80
- return "the approved action never started, so the checkpoint was REOPENED (pending): the same approval can be resumed again, do not ask for a fresh one";
83
+ return `${lead}: the same ${noun.grant} can be resumed again — ${noun.again}; do not ask for a fresh one`;
81
84
  case "config_refused":
82
- return "the approved action never started, so the checkpoint was REOPENED (pending): the deployment's configuration refused the resumed leg, so resuming under the same configuration fails the same way — correct the configuration, then resume, or decide afresh";
85
+ return `${lead}: the deployment's configuration refused the resumed leg, so resuming under the same configuration fails the same way — correct the configuration, then ${noun.again}, or decide afresh`;
83
86
  case "tool_unavailable":
84
- return "the approved action never started, so the checkpoint was REOPENED (pending): the approved tool is not available to the resumed leg, so this approval cannot run — decide afresh";
87
+ return `${lead}: the tool it needs is not available to the resumed leg, so this ${noun.grant} cannot run — decide afresh`;
85
88
  case "constraint_rejected":
86
- return "the approved action never started, so the checkpoint was REOPENED (pending): the decided input was refused, so decide afresh";
89
+ return `${lead}: the decided input was refused, so decide afresh`;
87
90
  }
88
91
  }