@sema-agent/core 7.60.0 → 7.61.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 (482) hide show
  1. package/CHANGELOG.md +605 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +61 -10
  6. package/dist/agents/cascade.js +60 -20
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -0,0 +1,311 @@
1
+ import { noteHostRewrite } from "../frame-settlement.js";
2
+ import { describeThrown } from "../tool-policy.js";
3
+ import { extensionWords } from "../untrusted-egress.js";
4
+ import { isPlainRecord } from "./kernel/receive.js";
5
+ import { NEXT_IN_FLIGHT, receiveEvent, sameModData } from "./kernel/site-rules.js";
6
+ import { classicEventBase, seatHears } from "./stations.js";
7
+ export const SESSION_APPEND_DOORS = Object.freeze(["prompt", "note", "delivery", "attachment", "response", "tool-result"]);
8
+ export const SESSION_APPEND_ORIGIN_KINDS = Object.freeze(["host", "engine", "model", "tool", "plugin"]);
9
+ export function doorOf(row) {
10
+ switch (row.role) {
11
+ case "assistant":
12
+ return "response";
13
+ case "toolResult":
14
+ return "tool-result";
15
+ case "user":
16
+ if (row.attachment !== undefined)
17
+ return "attachment";
18
+ if (row.engineNoteKey !== undefined)
19
+ return "delivery";
20
+ return row.provenance === "engine-note" || row.engineMinted === true ? "note" : "prompt";
21
+ default:
22
+ return "note";
23
+ }
24
+ }
25
+ const HOST = Object.freeze({ kind: "host" });
26
+ const ENGINE = Object.freeze({ kind: "engine" });
27
+ export function originOf(row) {
28
+ switch (row.role) {
29
+ case "assistant":
30
+ return Object.freeze({ kind: "model", model: row.model });
31
+ case "toolResult":
32
+ return Object.freeze({ kind: "tool", tool: row.toolName });
33
+ case "user":
34
+ return doorOf(row) === "prompt" || (row.attachment !== undefined && row.attachment.origin === undefined) ? HOST : ENGINE;
35
+ default:
36
+ return ENGINE;
37
+ }
38
+ }
39
+ function viewOf(row) {
40
+ switch (row.role) {
41
+ case "user":
42
+ case "assistant":
43
+ return { role: row.role, content: row.content };
44
+ case "toolResult":
45
+ return { role: row.role, toolCallId: row.toolCallId, toolName: row.toolName, content: row.content, isError: row.isError };
46
+ case "custom":
47
+ return { role: row.role, customType: row.customType, content: row.content };
48
+ default:
49
+ return { role: row.role };
50
+ }
51
+ }
52
+ const NAMING_MEMBERS = ["role", "toolCallId", "toolName", "customType"];
53
+ function contentHeldWhy(row) {
54
+ if (row.role === "user") {
55
+ if (row.attachment !== undefined)
56
+ return "its attachment record indexes its content";
57
+ if (row.enginePrefixChars !== undefined || row.engineSegments !== undefined || row.engineMinted === true)
58
+ return "the engine's frames in it are read by their exact text";
59
+ }
60
+ return undefined;
61
+ }
62
+ const PINNED_BLOCKS = "its blocks other than text are pinned (the same blocks, in the same order)";
63
+ function rewrittenContent(original, handed) {
64
+ if (typeof original === "string") {
65
+ if (typeof handed !== "string")
66
+ return { why: "its content is a string, and a rewrite keeps the content's form" };
67
+ return handed.trim() === "" ? { why: "its text is blank" } : { content: handed };
68
+ }
69
+ if (!Array.isArray(handed) || handed.length === 0)
70
+ return { why: "its content is a list of blocks, and a rewrite keeps the content's form" };
71
+ const blocks = Array.isArray(original) ? original : [];
72
+ const others = blocks.filter((b) => b.type !== "text");
73
+ const texts = blocks.filter((b) => b.type === "text");
74
+ const out = [];
75
+ let other = 0;
76
+ let text = 0;
77
+ const items = handed;
78
+ for (const b of items) {
79
+ if (!isPlainRecord(b))
80
+ return { why: "its content is a list of blocks, and a rewrite keeps the content's form" };
81
+ if (b["type"] === "text") {
82
+ const was = texts[text++];
83
+ const t = b["text"];
84
+ if (was !== undefined && was["text"] === t)
85
+ out.push(was);
86
+ else if (typeof t === "string" && t.trim() !== "")
87
+ out.push({ type: "text", text: t });
88
+ else
89
+ return { why: "a text block's text is blank" };
90
+ continue;
91
+ }
92
+ const was = others[other++];
93
+ if (was === undefined || !sameModData(was, b))
94
+ return { why: PINNED_BLOCKS };
95
+ out.push(was);
96
+ }
97
+ return other === others.length ? { content: out } : { why: PINNED_BLOCKS };
98
+ }
99
+ function rewrite(row, view, handed, by) {
100
+ const held = contentHeldWhy(row);
101
+ if (held !== undefined)
102
+ return held;
103
+ for (const k of new Set([...Object.keys(view), ...Object.keys(handed)])) {
104
+ if (k !== "content" && !sameModData(view[k], handed[k]))
105
+ return Object.hasOwn(view, k) ? `its ${k} is pinned` : `a row has no ${k} to set`;
106
+ }
107
+ if (!Object.hasOwn(view, "content"))
108
+ return "it has no content to rewrite";
109
+ const next = rewrittenContent(view["content"], handed["content"]);
110
+ if ("why" in next)
111
+ return next.why;
112
+ const target = row;
113
+ target.content = next.content;
114
+ target.rewrittenBy = Object.freeze([...by]);
115
+ return undefined;
116
+ }
117
+ function keptAnswer(row) {
118
+ const received = receiveEvent({ message: viewOf(row) });
119
+ if ("refusal" in received)
120
+ throw new TypeError(`session.append: the kept row cannot be handed up: ${received.refusal}`);
121
+ return received.payload;
122
+ }
123
+ const isDeny = (a) => isPlainRecord(a) && Object.hasOwn(a, "deny");
124
+ function keepAsMade(row, raised) {
125
+ if (raised !== undefined)
126
+ raised.outcome = { kind: "kept", answer: keptAnswer(row) };
127
+ return true;
128
+ }
129
+ export function createRowSeat() {
130
+ let bound;
131
+ const raisings = new WeakMap();
132
+ const admitOne = async (row, raised) => {
133
+ const keep = () => keepAsMade(row, raised);
134
+ const binding = bound;
135
+ if (!seatHears(binding, "session.append"))
136
+ return keep();
137
+ const door = raised !== undefined ? "note" : doorOf(row);
138
+ try {
139
+ const view = viewOf(row);
140
+ const origin = raised !== undefined ? Object.freeze({ kind: "plugin", name: raised.ctx.origin.plugin }) : originOf(row);
141
+ const e = { ...classicEventBase(binding.identity), door, origin, message: view };
142
+ const handOns = [];
143
+ let kept;
144
+ const checkHandOn = (payload, by) => {
145
+ const message = payload["message"];
146
+ if (!isPlainRecord(message))
147
+ return "next() handed on a message that is not a row";
148
+ const changed = NAMING_MEMBERS.find((k) => !sameModData(view[k], message[k]));
149
+ if (changed !== undefined)
150
+ return `a changed message.${changed}`;
151
+ const content = message["content"];
152
+ if (Object.hasOwn(view, "content") && typeof content !== "string" && !(Array.isArray(content) && content.every((b) => isPlainRecord(b) && typeof b["type"] === "string"))) {
153
+ return "next() handed on a content that is neither a string nor a list of blocks";
154
+ }
155
+ handOns.push({ by: by.plugin, message });
156
+ return undefined;
157
+ };
158
+ const bottom = (handed) => {
159
+ if (kept !== undefined)
160
+ return kept;
161
+ const message = handed["message"];
162
+ if (isPlainRecord(message) && !sameModData(view, message)) {
163
+ const by = [];
164
+ let before = view;
165
+ for (const h of handOns) {
166
+ if (!sameModData(before, h.message) && !by.includes(h.by))
167
+ by.push(h.by);
168
+ before = h.message;
169
+ }
170
+ const why = rewrite(row, view, message, by);
171
+ if (why === undefined && row.role === "toolResult" && binding.frameSettlement !== undefined)
172
+ noteHostRewrite(binding.frameSettlement, row.toolCallId);
173
+ if (why !== undefined) {
174
+ binding.report(new Error(`session.append: a rewrite of a ${door} row is not kept (${why}); the row is kept as made — rewritten by ${by.map((b) => `"${extensionWords(b, 80)}"`).join(", ") || "an extension"}`));
175
+ }
176
+ }
177
+ kept = keptAnswer(row);
178
+ return kept;
179
+ };
180
+ const checkAnswer = (a, _e, _by, below) => {
181
+ if (kept !== undefined && a === kept)
182
+ return undefined;
183
+ if (isDeny(a)) {
184
+ const reason = a["deny"];
185
+ if (Object.keys(a).length !== 1)
186
+ return "session.append takes next(e), the row next answered, or { deny: <reason> }";
187
+ if (below.some((b) => !isDeny(b)))
188
+ return "a deny after next kept the row (refuse in place of next)";
189
+ if (below.some((b) => isDeny(b) && b["deny"] === reason))
190
+ return undefined;
191
+ if (raised === undefined)
192
+ return "a deny of a row the engine adds (only an extension's own note is refused)";
193
+ return typeof reason === "string" && reason.trim() !== "" ? undefined : "a deny with no reason (a non-empty string)";
194
+ }
195
+ if (below.length === 0)
196
+ return "an answer without next (the row is kept; next(e) keeps it)";
197
+ let last;
198
+ for (let i = below.length - 1; i >= 0 && last === undefined; i--)
199
+ if (!isDeny(below[i]))
200
+ last = below[i];
201
+ if (last === undefined)
202
+ return "a row after next refused it (nothing was kept)";
203
+ if (last === NEXT_IN_FLIGHT)
204
+ return "a row while its next(e) still runs (the answer is the row as kept)";
205
+ return sameModData(a, last) ? undefined : "a row other than what next answered (the answer is the row as kept)";
206
+ };
207
+ let outcome;
208
+ try {
209
+ outcome = await binding.bus.dispatch("session.append", e, {
210
+ bottom,
211
+ checkAnswer,
212
+ checkHandOn,
213
+ ...(raised !== undefined ? { frames: raised.ctx.frames, origin: raised.ctx.origin, signal: raised.ctx.signal } : {}),
214
+ });
215
+ }
216
+ catch (err) {
217
+ binding.report(new Error(`session.append: the ${door} row is kept as made — the dispatch could not be raised (${describeThrown(err)})`));
218
+ return keep();
219
+ }
220
+ if (kept !== undefined) {
221
+ if (raised !== undefined)
222
+ raised.outcome = { kind: "kept", answer: kept };
223
+ return true;
224
+ }
225
+ if (raised !== undefined && outcome.kind === "answered" && isDeny(outcome.answer)) {
226
+ raised.outcome = { kind: "denied", reason: String(outcome.answer["deny"]) };
227
+ return false;
228
+ }
229
+ if (raised !== undefined && outcome.kind === "aborted") {
230
+ raised.outcome = { kind: "cancelled" };
231
+ return false;
232
+ }
233
+ if (outcome.kind === "failed")
234
+ binding.report(new Error(`session.append: the ${door} row is kept as made — ${outcome.reason}`));
235
+ return keep();
236
+ }
237
+ catch (err) {
238
+ binding.report(new Error(`session.append: the ${door} row is kept as made — ${describeThrown(err)}`));
239
+ return keep();
240
+ }
241
+ };
242
+ const admitAll = async (rows, raised) => {
243
+ const out = [];
244
+ for (const row of rows)
245
+ if (await admitOne(row, raised))
246
+ out.push(row);
247
+ return out;
248
+ };
249
+ return {
250
+ admitRows: (rows, raising) => {
251
+ const raised = raising !== undefined ? raisings.get(raising) : undefined;
252
+ if (seatHears(bound, "session.append"))
253
+ return admitAll(rows, raised);
254
+ return new Promise((resolve) => resolve(rows.filter((row) => keepAsMade(row, raised))));
255
+ },
256
+ bind: (binding) => {
257
+ bound = binding;
258
+ },
259
+ raise: (ctx) => {
260
+ const token = Object.freeze({ door: "note" });
261
+ raisings.set(token, { ctx });
262
+ return token;
263
+ },
264
+ outcomeOf: (raising) => raisings.get(raising)?.outcome,
265
+ };
266
+ }
267
+ function noteContentOf(args, agentId, by) {
268
+ const refuse = (why) => new TypeError(`${by}: $.session.append: refused: ${why}`);
269
+ const extra = Object.keys(args).find((k) => k !== "message" && k !== "agentId");
270
+ if (extra !== undefined)
271
+ throw refuse(`takes { message, agentId? }; "${extensionWords(extra, 40)}" is not one`);
272
+ if (Object.hasOwn(args, "agentId") && (agentId === undefined || args["agentId"] !== agentId))
273
+ throw refuse("agentId names a leg other than this one");
274
+ const message = args["message"];
275
+ if (!isPlainRecord(message))
276
+ throw refuse("takes message, { role: \"user\", content }");
277
+ if (message["role"] === "system")
278
+ throw refuse("a system row (the engine keeps no row outside the conversation the model reads)");
279
+ if (message["role"] !== "user" || Object.keys(message).some((k) => k !== "role" && k !== "content"))
280
+ throw refuse("takes message, { role: \"user\", content }");
281
+ const content = message["content"];
282
+ if (typeof content === "string") {
283
+ if (content.trim() === "")
284
+ throw refuse("the note's text is blank");
285
+ return content;
286
+ }
287
+ if (!Array.isArray(content) || content.length === 0)
288
+ throw refuse("content is a string or a non-empty list of text blocks");
289
+ return content.map((b) => {
290
+ if (!isPlainRecord(b) || b["type"] !== "text" || typeof b["text"] !== "string" || Object.keys(b).some((k) => k !== "type" && k !== "text"))
291
+ throw refuse("each block is { type: \"text\", text }");
292
+ if (b["text"].trim() === "")
293
+ throw refuse("a block's text is blank");
294
+ return { type: "text", text: b["text"] };
295
+ });
296
+ }
297
+ export function createSessionAppendEntry(input) {
298
+ return async (args, ctx) => {
299
+ const by = ctx.origin.plugin;
300
+ const content = noteContentOf(args, input.agentId, by);
301
+ const row = { role: "user", content, timestamp: input.now(), provenance: "engine-note" };
302
+ const raising = input.seat.raise(ctx);
303
+ await input.harness.appendMessage(row, raising);
304
+ const outcome = input.seat.outcomeOf(raising);
305
+ if (outcome === undefined)
306
+ throw new Error(`${by}: $.session.append: the note was not admitted`);
307
+ if (outcome.kind === "cancelled")
308
+ throw new Error(`${by}: $.session.append: aborted`);
309
+ return outcome.kind === "denied" ? Object.freeze({ deny: outcome.reason }) : outcome.answer;
310
+ };
311
+ }
@@ -0,0 +1,48 @@
1
+ import { type MaybeCompactOptions, type maybeCompact } from "../auto-compaction.js";
2
+ import type { HookInvocationIdentity } from "../hooks.js";
3
+ import type { CompactOutcome, ExtensionRequester } from "../task-event.js";
4
+ import { type ModBottomContext, type ModCallEntry } from "./kernel/index.js";
5
+ import { type LegModBus } from "./stations.js";
6
+ type CompactResult = Awaited<ReturnType<typeof maybeCompact>>;
7
+ /** What a pass hands the station: the instructions its manual request named, and — for `$.session.compact` — the call's
8
+ * context (the pass is raised under the caller's frames and origin, so the caller's own handlers stay out of it). */
9
+ export interface CompactPass {
10
+ readonly instructions?: string;
11
+ readonly call?: ModBottomContext;
12
+ }
13
+ /** The boundary's in-place pass, as `$.session.compact` reaches it: run one manual pass now, asked for by `requestedBy`. */
14
+ export type CompactWindowPass = (request: {
15
+ readonly instructions?: string;
16
+ readonly requestedBy: ExtensionRequester;
17
+ readonly call: ModBottomContext;
18
+ }) => Promise<CompactOutcome>;
19
+ /** What the leg binds the station to once its bus is admitted. */
20
+ export interface CompactStationBinding {
21
+ readonly bus: LegModBus;
22
+ readonly identity: HookInvocationIdentity | undefined;
23
+ readonly report: (err: Error) => void;
24
+ }
25
+ /** The leg's `session.compact` station (see the module header). */
26
+ export interface CompactStation {
27
+ bind(binding: CompactStationBinding): void;
28
+ /** One compaction pass through the station: `run` is the lane's `maybeCompact`, handed the options with the station's
29
+ * seats in place (no handler ⇒ the options as they came). */
30
+ compact(opts: MaybeCompactOptions, run: (opts: MaybeCompactOptions) => Promise<CompactResult>, pass?: CompactPass): Promise<CompactResult>;
31
+ /** Run `raise` (the boundary's `turn.complete`) with `$.session.compact` open: a direct call from one of its handlers runs
32
+ * `pass` in place, and `window` answers once that pass has ended too. */
33
+ window<T>(pass: CompactWindowPass, raise: () => Promise<T>): Promise<T>;
34
+ /** `$.session.compact`'s seat: the in-place pass, or the refusal. */
35
+ call(instructions: string | undefined, ctx: ModBottomContext): Promise<CompactOutcome>;
36
+ }
37
+ /** The leg's `session.compact` station. */
38
+ export declare function createCompactStation(): CompactStation;
39
+ /** The extension the last `$.session.compact` request among `waiters` came from (requests coalesce onto one pass), as the
40
+ * member the pass's ending frame spreads; empty when no extension asked. */
41
+ export declare function requesterOf(waiters: ReadonlyArray<{
42
+ readonly requestedBy?: ExtensionRequester;
43
+ }>): {
44
+ readonly requestedBy?: ExtensionRequester;
45
+ };
46
+ /** `$.session.compact`'s host entry: `{ instructions? }`, a manual pass at the turn boundary in place (the module header). */
47
+ export declare function createSessionCompactEntry(station: Pick<CompactStation, "call">): ModCallEntry;
48
+ export {};
@@ -0,0 +1,194 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ import { isCompactionManualCancel } from "../auto-compaction.js";
3
+ import { describeThrown } from "../tool-policy.js";
4
+ import { extensionWords } from "../untrusted-egress.js";
5
+ import { ENGINE_ORIGIN } from "./kernel/index.js";
6
+ import { isPlainRecord } from "./kernel/receive.js";
7
+ import { NEXT_IN_FLIGHT, sameModData } from "./kernel/site-rules.js";
8
+ import { classicEventBase, failedHandlerClause, seatHears } from "./stations.js";
9
+ const FORM = "session.compact takes next(e), the outcome next answered, or { skip: <reason> } / { summary: <text> } in place of next";
10
+ const onlyString = (a, key) => {
11
+ if (!isPlainRecord(a) || Object.keys(a).length !== 1 || !Object.hasOwn(a, key))
12
+ return undefined;
13
+ const v = a[key];
14
+ return typeof v === "string" && v.trim() !== "" ? v : undefined;
15
+ };
16
+ const skipOf = (a) => onlyString(a, "skip");
17
+ const summaryOf = (a) => onlyString(a, "summary");
18
+ const RANKS = Object.freeze({ of: (a) => (skipOf(a) !== undefined ? 1 : 0), top: 1 });
19
+ function outcomeView(result, outcome) {
20
+ return Object.freeze({
21
+ outcome,
22
+ ...(result?.compacted === true && result.tokensBefore !== undefined ? { tokensBefore: result.tokensBefore } : {}),
23
+ ...(result?.compacted === true && result.freedTokens !== undefined ? { freedTokens: result.freedTokens } : {}),
24
+ });
25
+ }
26
+ const outcomeOf = (r) => (r.compacted ? "compacted" : r.blocked === true ? "blocked" : r.disabled === true ? "disabled" : "noop");
27
+ export function createCompactStation() {
28
+ let bound;
29
+ const windows = new AsyncLocalStorage();
30
+ const compactBound = async (binding, opts, run, pass) => {
31
+ let settle;
32
+ const settled = new Promise((resolve) => (settle = resolve));
33
+ let dispatch;
34
+ let handed;
35
+ let view;
36
+ const innerPre = opts.preCompact;
37
+ const innerPost = opts.postCompact;
38
+ const preCompact = async (ctx) => {
39
+ let started;
40
+ const go = new Promise((resolve) => (started = resolve));
41
+ const e = { ...classicEventBase(binding.identity), trigger: ctx.trigger, ...(pass?.instructions !== undefined ? { instructions: pass.instructions } : {}) };
42
+ const bottom = async () => {
43
+ let r;
44
+ try {
45
+ r = innerPre !== undefined ? ((await innerPre(ctx)) ?? undefined) : undefined;
46
+ }
47
+ finally {
48
+ started(r);
49
+ }
50
+ return settled;
51
+ };
52
+ const checkAnswer = (a, _e, _by, below, ran) => {
53
+ if (view !== undefined && (a === view || sameModData(a, view)))
54
+ return undefined;
55
+ const skip = skipOf(a) !== undefined;
56
+ const summary = summaryOf(a) !== undefined;
57
+ if (!skip && !summary)
58
+ return below.length === 0 ? FORM : "an answer other than the outcome next answered (the answer is the pass's outcome)";
59
+ if (below.includes(NEXT_IN_FLIGHT))
60
+ return "an answer while its next(e) still runs";
61
+ if (ran.bottomStarted || below.some((b) => skipOf(b) === undefined && summaryOf(b) === undefined))
62
+ return skip ? "a skip after next() compacted (the compaction happened beneath it; skip before calling next, or hand its outcome up)" : "a summary after next() (hand the summary in place of next)";
63
+ return undefined;
64
+ };
65
+ try {
66
+ dispatch = binding.bus.dispatch("session.compact", e, {
67
+ bottom,
68
+ checkAnswer,
69
+ ranks: RANKS,
70
+ ...(pass?.call !== undefined ? { frames: pass.call.frames, origin: pass.call.origin, signal: pass.call.signal } : opts.signal !== undefined ? { signal: opts.signal } : {}),
71
+ });
72
+ }
73
+ catch (err) {
74
+ return refused(ctx, `the session.compact station could not be raised (${describeThrown(err)})`, true);
75
+ }
76
+ const first = await Promise.race([go.then((r) => ({ kind: "go", r })), dispatch.then((o) => ({ kind: "ended", o }))]);
77
+ if (first.kind === "go")
78
+ return first.r;
79
+ const o = first.o;
80
+ if (o.kind === "aborted")
81
+ return opts.signal?.aborted === true ? undefined : refused(ctx, "the session.compact dispatch was cancelled before the compaction ran", false);
82
+ if (o.kind === "failed")
83
+ return refused(ctx, `a session.compact extension ${failedHandlerClause(o)} before the compaction ran`, o.cause === "violation");
84
+ const by = o.answeredBy ?? ENGINE_ORIGIN.plugin;
85
+ const skip = skipOf(o.answer);
86
+ if (skip !== undefined)
87
+ return refused(ctx, `extension "${extensionWords(by, 80)}" skipped this compaction: ${extensionWords(skip, 300)}`, false);
88
+ const summary = summaryOf(o.answer);
89
+ if (summary !== undefined) {
90
+ handed = { summary, by };
91
+ return undefined;
92
+ }
93
+ return refused(ctx, `extension "${extensionWords(by, 80)}" answered in a form session.compact does not take`, true);
94
+ };
95
+ const refused = async (ctx, why, unsaid) => {
96
+ if (ctx.trigger !== "forced") {
97
+ if (unsaid)
98
+ binding.report(new Error(`session.compact: ${why} — the compaction was blocked (fail-closed)`));
99
+ return { block: why };
100
+ }
101
+ binding.report(new Error(`session.compact: ${why} — ignored: a forced compaction (prompt-too-long recovery or trim pressure) is not optional`));
102
+ return innerPre !== undefined ? ((await innerPre(ctx)) ?? undefined) : undefined;
103
+ };
104
+ const station = {
105
+ ...opts,
106
+ preCompact,
107
+ summaryProvider: (input) => (handed !== undefined ? handed.summary : (opts.summaryProvider?.(input) ?? undefined)),
108
+ ...(innerPost !== undefined ? { postCompact: (ctx) => (handed !== undefined ? undefined : innerPost(ctx)) } : {}),
109
+ };
110
+ let result;
111
+ try {
112
+ result = await run(station);
113
+ view = outcomeView(result, outcomeOf(result));
114
+ if (handed !== undefined && result.compacted && result.reused !== true) {
115
+ binding.report(new Error(`session.compact: the summary extension "${extensionWords(handed.by, 80)}" handed was not used — this pass could not take a summary in place of its own (a split turn, or the summary seat's reuse cap), so the model summarized`));
116
+ }
117
+ return result;
118
+ }
119
+ catch (err) {
120
+ view = outcomeView(undefined, isCompactionManualCancel(err) || opts.signal?.aborted === true ? "mooted" : "failed");
121
+ throw err;
122
+ }
123
+ finally {
124
+ settle(view ?? outcomeView(undefined, "failed"));
125
+ if (dispatch !== undefined)
126
+ await dispatch.catch(() => undefined);
127
+ }
128
+ };
129
+ const refuseCall = (by, why) => {
130
+ const sentence = `${by}: $.session.compact: ${why}`;
131
+ bound?.report(new Error(sentence));
132
+ throw new Error(sentence);
133
+ };
134
+ return {
135
+ bind: (binding) => {
136
+ bound = binding;
137
+ },
138
+ compact: (opts, run, pass) => {
139
+ const binding = bound;
140
+ return seatHears(binding, "session.compact") ? compactBound(binding, opts, run, pass) : run(opts);
141
+ },
142
+ window: async (pass, raise) => {
143
+ const w = { pass, open: true, running: undefined };
144
+ try {
145
+ return await windows.run(w, raise);
146
+ }
147
+ finally {
148
+ w.open = false;
149
+ if (w.running !== undefined)
150
+ await w.running.catch(() => undefined);
151
+ }
152
+ },
153
+ call: async (instructions, ctx) => {
154
+ const by = ctx.origin.plugin;
155
+ const w = windows.getStore();
156
+ const direct = ctx.frames.length >= 2 && ctx.frames.at(-1)?.kind === "dollar" && ctx.frames.slice(0, -1).every((f) => f.kind === "handler");
157
+ if (w === undefined || !direct)
158
+ return refuseCall(by, "not called from a turn.complete handler; the conversation compacts between turns, so call it from turn.complete or later");
159
+ if (!w.open)
160
+ return refuseCall(by, "called after the turn.complete dispatch it was made in had ended; the conversation compacts between turns, so call it from turn.complete or later");
161
+ if (w.running !== undefined)
162
+ return refuseCall(by, "a compaction is already running at this boundary");
163
+ const running = w.pass({ ...(instructions !== undefined ? { instructions } : {}), requestedBy: Object.freeze({ kind: "extension", name: by }), call: ctx });
164
+ w.running = running;
165
+ try {
166
+ return await running;
167
+ }
168
+ finally {
169
+ w.running = undefined;
170
+ }
171
+ },
172
+ };
173
+ }
174
+ export function requesterOf(waiters) {
175
+ for (let i = waiters.length - 1; i >= 0; i--) {
176
+ const by = waiters[i]?.requestedBy;
177
+ if (by !== undefined)
178
+ return { requestedBy: by };
179
+ }
180
+ return {};
181
+ }
182
+ export function createSessionCompactEntry(station) {
183
+ return async (args, ctx) => {
184
+ const by = ctx.origin.plugin;
185
+ const extra = Object.keys(args).find((k) => k !== "instructions");
186
+ if (extra !== undefined)
187
+ throw new TypeError(`${by}: $.session.compact takes { instructions } (a string) or nothing; "${extensionWords(extra, 40)}" is not one`);
188
+ const instructions = args["instructions"];
189
+ if (instructions !== undefined && typeof instructions !== "string")
190
+ throw new TypeError(`${by}: $.session.compact takes { instructions } (a string) or nothing`);
191
+ const outcome = await station.call(instructions, ctx);
192
+ return Object.freeze({ outcome });
193
+ };
194
+ }
@@ -0,0 +1,93 @@
1
+ /**
2
+ * The `session.receive` station: the session's one receiving station ({@link FrameReceiver}).
3
+ *
4
+ * THE RULE. A frame reaches the model by one of three faces — PUSHED on the live lane (a producer's injection: a task's
5
+ * notification, a teammate's message, a host's `notify`; a frame routed in from another run of the session; a peer letter
6
+ * the box drain injects), REDELIVERED at a run's turn open (what was parked while the session sat idle), or PULLED by
7
+ * `ReadInbox` — and every face hands it to this station before the hand-over, once, and hands over what it answers. With
8
+ * a handler on `session.receive` the station raises the event; with none, or before the leg's bus is bound, the frame
9
+ * passes as made and nothing is raised (each face keeps its own synchronous path).
10
+ *
11
+ * `e = { origin, event, text, agentId? }` plus the identity envelope; `origin`, `event` and `agentId` are pinned. `origin`
12
+ * is read off the frame's own typed facts ({@link receiveOriginOf}); `event` names it (`taskId`, `taskType`, `status`,
13
+ * `seq`); `text` is what the model would read — the frame as the engine renders it.
14
+ *
15
+ * A handler answers (the reference's forms: `Du` (cli309.js:255554)):
16
+ * - `next(e)` / `next({ ...e, text })` — what comes up is `{ text }`, the text as handed on; a handler answers it, or
17
+ * `{ text }` of its own — the frame is handed over with the text of the answer that stands;
18
+ * - `{ consumed: <reason> }` — the frame is not handed over: the model never sees it, and it is not owed again (a peer
19
+ * letter's sender is sent a `refused` receipt naming the extension). `next` has no effect here, so a consume after it
20
+ * stands as well.
21
+ * A text that is not a non-blank string is a violation.
22
+ *
23
+ * A failure refuses (the table's column): a handler that throws, runs past its budget or breaks the event's form leaves the
24
+ * frame consumed — an input station that can keep a frame from the model fails closed. So does an engine fault of the
25
+ * dispatch. A cancel (the leg is stopping) hands the frame over as made: the face's own lossless path takes it from there.
26
+ *
27
+ * What the station does not hold: the host's `task_notification` event for a pushed or redelivered frame is emitted when
28
+ * the frame arrives, before the station answers — it records the frame as made, and a frame the station then consumed is
29
+ * on the stream, not in the conversation.
30
+ */
31
+ import type { HookInvocationIdentity } from "../hooks.js";
32
+ import { type FrameReceiver, type ReceivedFrame, type TaskNotificationPayload } from "../task-notification.js";
33
+ import { type LegModBus } from "./stations.js";
34
+ /** Who a frame comes from: read off the frame ({@link receiveOriginOf}). */
35
+ export declare const SESSION_RECEIVE_ORIGIN_KINDS: readonly ["task", "agent", "peer", "host", "engine"];
36
+ export type SessionReceiveOrigin = {
37
+ readonly kind: "task";
38
+ readonly taskType: TaskNotificationPayload["task_type"];
39
+ } | {
40
+ readonly kind: "agent";
41
+ readonly from: string;
42
+ } | {
43
+ readonly kind: "peer";
44
+ readonly from: string;
45
+ } | {
46
+ readonly kind: "host";
47
+ readonly from?: string;
48
+ } | {
49
+ readonly kind: "engine";
50
+ };
51
+ /** A frame's origin, from its typed facts: an agent's message (`agentMessage`), another session's letter
52
+ * (`crossSessionMessage`), a line the engine composed about the lane itself (a delivery or idle notice, the inbox notice),
53
+ * a host's own injection (the `external` lane, with its attribution label when it carries one), else a task's notification. */
54
+ export declare function receiveOriginOf(p: TaskNotificationPayload): SessionReceiveOrigin;
55
+ /** What the leg binds the station to once its bus is admitted. */
56
+ export interface ReceiveSeatBinding {
57
+ readonly bus: LegModBus;
58
+ readonly identity: HookInvocationIdentity | undefined;
59
+ /** The leg's report sink (handler failures and the station's own disclosures). */
60
+ readonly report: (err: Error) => void;
61
+ /** The leg's abort: a dispatch is cancelled with the leg. */
62
+ readonly signal?: AbortSignal;
63
+ }
64
+ /** The leg's receiving station: a {@link FrameReceiver} bound to the leg's bus once it is admitted. */
65
+ export interface ReceiveSeat extends FrameReceiver {
66
+ bind(binding: ReceiveSeatBinding): void;
67
+ }
68
+ /** The leg's receiving station (see the module header). */
69
+ export declare function createReceiveSeat(): ReceiveSeat;
70
+ /** What a face does with one frame's answer: hand over what the station answered, settle a consumed frame, and answer a
71
+ * link that threw (said, or the frame re-pended — the face's own lossless path). */
72
+ export interface ReceivingArms {
73
+ readonly handOver: (shown: TaskNotificationPayload) => void;
74
+ readonly consumed?: (verdict: Extract<ReceivedFrame, {
75
+ kind: "consumed";
76
+ }>) => void;
77
+ readonly fault: (err: unknown) => void;
78
+ }
79
+ /** A face that hands frames over one at a time as they come (the live lane, the turn-open redelivery). */
80
+ export interface ReceivingChain {
81
+ /** Hand `payload` over through the station: at once, as made, with no handler listening; else once the station has
82
+ * answered it and every frame passed before it. */
83
+ pass(payload: TaskNotificationPayload, arms: ReceivingArms): void;
84
+ /** Settles once every frame passed so far has been answered; `undefined` while none has waited on the station. */
85
+ readonly settled: Promise<void> | undefined;
86
+ }
87
+ /** One chain per face: a frame never overtakes one that arrived before it, and a link that throws does not stop the next.
88
+ * `seatOf` is read per frame (a face can be wired before the leg's station exists). */
89
+ export declare function createReceivingChain(seatOf: () => FrameReceiver): ReceivingChain;
90
+ /** The sentence a consumed frame's report carries: which frame, by whom, why. */
91
+ export declare function consumedFrameReport(payload: TaskNotificationPayload, verdict: Extract<ReceivedFrame, {
92
+ kind: "consumed";
93
+ }>): Error;