@sema-agent/core 7.59.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 (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -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;
@@ -0,0 +1,141 @@
1
+ import { renderTaskNotificationXml } from "../task-notification.js";
2
+ import { describeThrown } from "../tool-policy.js";
3
+ import { extensionWords } from "../untrusted-egress.js";
4
+ import { ENGINE_ORIGIN } from "./kernel/index.js";
5
+ import { isPlainRecord } from "./kernel/receive.js";
6
+ import { classicEventBase, failedHandlerClause, seatHears } from "./stations.js";
7
+ export const SESSION_RECEIVE_ORIGIN_KINDS = Object.freeze(["task", "agent", "peer", "host", "engine"]);
8
+ const ENGINE = Object.freeze({ kind: "engine" });
9
+ export function receiveOriginOf(p) {
10
+ if (p.agentMessage !== undefined)
11
+ return Object.freeze({ kind: "agent", from: p.agentMessage.from });
12
+ if (p.crossSessionMessage !== undefined)
13
+ return Object.freeze({ kind: "peer", from: p.crossSessionMessage.from });
14
+ if (p.crossSessionNotice !== undefined || p.inboxNotice !== undefined)
15
+ return ENGINE;
16
+ if (p.task_type === "external")
17
+ return Object.freeze({ kind: "host", ...(p.source !== undefined ? { from: p.source } : {}) });
18
+ return Object.freeze({ kind: "task", taskType: p.task_type });
19
+ }
20
+ function eventOf(p) {
21
+ return Object.freeze({ taskId: p.task_id, taskType: p.task_type, status: p.status, ...(p.seq !== undefined ? { seq: p.seq } : {}) });
22
+ }
23
+ const FORM = "session.receive takes { text } (a non-blank string) or { consumed: <reason> }";
24
+ function readAnswer(a) {
25
+ if (!isPlainRecord(a))
26
+ return { why: FORM };
27
+ const keys = Object.keys(a);
28
+ if (keys.length === 1 && keys[0] === "consumed") {
29
+ const r = a["consumed"];
30
+ return typeof r === "string" && r.trim() !== "" ? { consumed: r } : { why: "a consumed that is not a reason (a non-empty string)" };
31
+ }
32
+ if (keys.length === 1 && keys[0] === "text") {
33
+ const t = a["text"];
34
+ return typeof t === "string" && t.trim() !== "" ? { text: t } : { why: "a text that is not a non-blank string (consume the frame instead)" };
35
+ }
36
+ return { why: FORM };
37
+ }
38
+ const RANKS = Object.freeze({ of: (a) => (isPlainRecord(a) && Object.hasOwn(a, "consumed") ? 1 : 0), top: 1 });
39
+ export function createReceiveSeat() {
40
+ let bound;
41
+ const consumed = (binding, frame, by, reason) => {
42
+ const verdict = Object.freeze({ kind: "consumed", by, reason });
43
+ binding.report(consumedFrameReport(frame, verdict));
44
+ return verdict;
45
+ };
46
+ const receiveBound = async (binding, payload) => {
47
+ const made = payload.received === undefined ? payload : (({ received: _r, ...rest }) => rest)(payload);
48
+ const text = renderTaskNotificationXml(made);
49
+ const e = { ...classicEventBase(binding.identity), origin: receiveOriginOf(made), event: eventOf(made), text };
50
+ const handOns = [];
51
+ const checkHandOn = (handed, by) => {
52
+ const t = handed["text"];
53
+ if (typeof t !== "string" || t.trim() === "")
54
+ return "next() handed on a text that is not a non-blank string";
55
+ handOns.push({ by: by.plugin, text: t });
56
+ return undefined;
57
+ };
58
+ const bottom = (handed) => Object.freeze({ text: handed["text"] });
59
+ const checkAnswer = (a) => {
60
+ const read = readAnswer(a);
61
+ return "why" in read ? read.why : undefined;
62
+ };
63
+ let outcome;
64
+ try {
65
+ outcome = await binding.bus.dispatch("session.receive", e, { bottom, checkAnswer, checkHandOn, ranks: RANKS, ...(binding.signal !== undefined ? { signal: binding.signal } : {}) });
66
+ }
67
+ catch (err) {
68
+ return consumed(binding, made, ENGINE_ORIGIN.plugin, `the session.receive station could not be raised (${describeThrown(err)}); the frame was not handed over (fail-closed)`);
69
+ }
70
+ if (outcome.kind === "aborted")
71
+ return Object.freeze({ kind: "arrived", payload: made });
72
+ if (outcome.kind === "failed")
73
+ return consumed(binding, made, outcome.registration, `a session.receive extension ${failedHandlerClause(outcome)}; the frame was not handed over (fail-closed)`);
74
+ const read = readAnswer(outcome.answer);
75
+ const by = outcome.answeredBy ?? ENGINE_ORIGIN.plugin;
76
+ if ("consumed" in read)
77
+ return consumed(binding, made, by, read.consumed);
78
+ if ("why" in read)
79
+ return consumed(binding, made, by, `extension "${extensionWords(by, 80)}" answered in a form session.receive does not take (${read.why}); the frame was not handed over (fail-closed)`);
80
+ if (read.text === text)
81
+ return Object.freeze({ kind: "arrived", payload: made });
82
+ const rewrittenBy = [];
83
+ let before = text;
84
+ for (const h of handOns) {
85
+ if (h.text !== before && !rewrittenBy.includes(h.by))
86
+ rewrittenBy.push(h.by);
87
+ before = h.text;
88
+ }
89
+ if (read.text !== before && !rewrittenBy.includes(by))
90
+ rewrittenBy.push(by);
91
+ return Object.freeze({ kind: "arrived", payload: { ...made, received: Object.freeze({ text: read.text, rewrittenBy: Object.freeze(rewrittenBy) }) } });
92
+ };
93
+ return {
94
+ listens: () => seatHears(bound, "session.receive"),
95
+ receive: async (payload) => {
96
+ const binding = bound;
97
+ if (!seatHears(binding, "session.receive"))
98
+ return Object.freeze({ kind: "arrived", payload });
99
+ try {
100
+ return await receiveBound(binding, payload);
101
+ }
102
+ catch (err) {
103
+ return consumed(binding, payload, ENGINE_ORIGIN.plugin, `the session.receive station could not judge the frame (${describeThrown(err)}); it was not handed over (fail-closed)`);
104
+ }
105
+ },
106
+ bind: (binding) => {
107
+ bound = binding;
108
+ },
109
+ };
110
+ }
111
+ export function createReceivingChain(seatOf) {
112
+ let tail;
113
+ return {
114
+ pass: (payload, arms) => {
115
+ const seat = seatOf();
116
+ if (!seat.listens())
117
+ return arms.handOver(payload);
118
+ tail = (tail ?? Promise.resolve())
119
+ .then(async () => {
120
+ const verdict = await seat.receive(payload);
121
+ if (verdict.kind === "arrived")
122
+ arms.handOver(verdict.payload);
123
+ else
124
+ arms.consumed?.(verdict);
125
+ })
126
+ .catch((err) => {
127
+ try {
128
+ arms.fault(err);
129
+ }
130
+ catch {
131
+ }
132
+ });
133
+ },
134
+ get settled() {
135
+ return tail;
136
+ },
137
+ };
138
+ }
139
+ export function consumedFrameReport(payload, verdict) {
140
+ return new Error(`session.receive: the ${payload.task_type} frame for ${extensionWords(payload.task_id, 80)} (${payload.status}) was not handed to the model — consumed by ${verdict.by === ENGINE_ORIGIN.plugin ? "the engine" : `extension "${extensionWords(verdict.by, 80)}"`}: ${extensionWords(verdict.reason, 300)}`);
141
+ }
@@ -0,0 +1,72 @@
1
+ /**
2
+ * The `session.send` station, and `$.session.send`'s host entry.
3
+ *
4
+ * THE RULE. A message the leg sends goes out through SendMessage, and SendMessage raises `session.send` once per message,
5
+ * after its own pre-delivery refusals (an empty address or message, a broadcast, a qualified name, an observer on either
6
+ * end) and before any delivery arm resolves the address — the peer-session arm, the `main` uplink and the agent ladder each
7
+ * resolve it their own way, so the one point before all of them is the point every message passes. A pure idle subscription
8
+ * (no message) raises nothing. With no handler on the event nothing is raised and the send goes on.
9
+ *
10
+ * `e = { origin, to, text, agentId? }` plus the identity envelope; every member is pinned — the address and the text are
11
+ * what the gate judged, so they are what goes (the reference lets a handler rewrite both: `Bu` (cli309.js:255554)).
12
+ * `origin` is `{ kind: "model" }`, or `{ kind: "plugin", name }` for an extension's own `$.session.send`.
13
+ *
14
+ * A handler answers:
15
+ * - `next(e)` — the send goes on: what comes up is the go-ahead (`{ to, text }`), and the answer is that go-ahead;
16
+ * - `{ isDelivered: false, reason }` — only in place of `next`: the message is not sent, and the call says so naming the
17
+ * extension. `{ isDelivered: true }` — a handler claiming it delivered the message itself — is a violation: the engine is
18
+ * the one that delivers (the reference takes it: `qa` (cli309.js:288155)).
19
+ * A failure refuses while the go-ahead has not been given, and once it has the send goes on (the table's column): the
20
+ * station is a go-ahead station, as `agent.spawn` is.
21
+ *
22
+ * `$.session.send({ to, text })` is the event called ({@link createSessionSendEntry}): the leg's SendMessage pipeline — the
23
+ * same entry `$.tool.call` runs, its gate and its stations — run as the caller's call, which raises `session.send` here
24
+ * under the caller's frames. It answers `{ isDelivered: true }` when SendMessage reports the message sent, else
25
+ * `{ isDelivered: false, reason }` (returned, not thrown); a session with no SendMessage mounted answers the latter at once.
26
+ */
27
+ import type { HookInvocationIdentity } from "../hooks.js";
28
+ import { type ModCallEntry } from "./kernel/index.js";
29
+ import { type LegModBus } from "./stations.js";
30
+ /** Who sends a message: the model (its SendMessage call), or an extension's own `$.session.send`. */
31
+ export declare const SESSION_SEND_ORIGIN_KINDS: readonly ["model", "plugin"];
32
+ export type SessionSendOrigin = {
33
+ readonly kind: "model";
34
+ } | {
35
+ readonly kind: "plugin";
36
+ readonly name: string;
37
+ };
38
+ /** What the station answers SendMessage: go on, or the refusal and who gave it. */
39
+ export type SendVerdict = {
40
+ readonly go: true;
41
+ } | {
42
+ readonly go: false;
43
+ readonly by: string;
44
+ readonly reason: string;
45
+ };
46
+ /** The leg's `session.send` station, as SendMessage reads it (a Runner-filled seat, never a model argument). */
47
+ export interface SendStation {
48
+ /** Whether a handler hangs on `session.send` (none ⇒ SendMessage raises nothing and awaits nothing). */
49
+ listens(): boolean;
50
+ /** Raise `session.send` for one message (no handler ⇒ nothing raised: the send goes on). */
51
+ send(facts: {
52
+ readonly to: string;
53
+ readonly text: string;
54
+ readonly toolCallId: string;
55
+ }, signal: AbortSignal | undefined): Promise<SendVerdict>;
56
+ }
57
+ export interface SendStationInput {
58
+ readonly bus: LegModBus;
59
+ /** The sending leg's identity (its `agentId`). */
60
+ readonly identity: HookInvocationIdentity | undefined;
61
+ }
62
+ /** The leg's `session.send` station over its bus. */
63
+ export declare function createSessionSendStation(input: SendStationInput): SendStation;
64
+ /** What the host entry reaches: the leg's `$.tool.call` entry (its one pipeline for a call of a mounted tool), the name the
65
+ * leg's SendMessage is mounted under, and the leg's mounted tools. */
66
+ export interface SessionSendEntryInput {
67
+ readonly toolCall: ModCallEntry;
68
+ readonly sendToolName: string;
69
+ readonly tools: () => readonly string[];
70
+ }
71
+ /** `$.session.send`'s host entry: the leg's SendMessage, run as the caller's call (the module header). */
72
+ export declare function createSessionSendEntry(input: SessionSendEntryInput): ModCallEntry;
@@ -0,0 +1,88 @@
1
+ import { describeThrown } from "../tool-policy.js";
2
+ import { extensionWords } from "../untrusted-egress.js";
3
+ import { extensionCallOf } from "./extension-call.js";
4
+ import { ENGINE_ORIGIN } from "./kernel/index.js";
5
+ import { isPlainRecord } from "./kernel/receive.js";
6
+ import { NEXT_IN_FLIGHT } from "./kernel/site-rules.js";
7
+ import { classicEventBase, failedHandlerClause, seatHears } from "./stations.js";
8
+ export const SESSION_SEND_ORIGIN_KINDS = Object.freeze(["model", "plugin"]);
9
+ const GO = Object.freeze({ go: true });
10
+ const FORM = "session.send takes next(e) or { isDelivered: false, reason } in place of it";
11
+ function refusalOf(a) {
12
+ if (!isPlainRecord(a) || a["isDelivered"] !== false || Object.keys(a).some((k) => k !== "isDelivered" && k !== "reason"))
13
+ return undefined;
14
+ const r = a["reason"];
15
+ return typeof r === "string" && r.trim() !== "" ? r : undefined;
16
+ }
17
+ const RANKS = Object.freeze({ of: (a) => (refusalOf(a) !== undefined ? 1 : 0), top: 1 });
18
+ export function createSessionSendStation(input) {
19
+ return {
20
+ listens: () => seatHears(input, "session.send"),
21
+ send: async (facts, signal) => {
22
+ if (!seatHears(input, "session.send"))
23
+ return GO;
24
+ const call = extensionCallOf(input.bus, facts.toolCallId);
25
+ const origin = call !== undefined ? Object.freeze({ kind: "plugin", name: call.caller.origin.plugin }) : Object.freeze({ kind: "model" });
26
+ const e = { ...classicEventBase(input.identity), origin, to: facts.to, text: facts.text };
27
+ const started = Object.freeze({ to: facts.to, text: facts.text });
28
+ const checkAnswer = (a, _e, _by, below, ran) => {
29
+ if (a === started)
30
+ return undefined;
31
+ if (isPlainRecord(a) && a["isDelivered"] === true)
32
+ return "a delivery claimed by a handler (isDelivered: true) — the engine delivers the message; next(e) lets it go";
33
+ if (refusalOf(a) === undefined)
34
+ return FORM;
35
+ if (ran.bottomStarted)
36
+ return "a refusal after the message was let go (refuse in place of next)";
37
+ if (below.includes(NEXT_IN_FLIGHT) || below.some((b) => refusalOf(b) === undefined))
38
+ return "a refusal while its next(e) still runs or after it was answered (refuse in place of next)";
39
+ return undefined;
40
+ };
41
+ let outcome;
42
+ try {
43
+ outcome = await input.bus.dispatch("session.send", e, { bottom: () => started, checkAnswer, ranks: RANKS, ...(signal !== undefined ? { signal } : {}) });
44
+ }
45
+ catch (err) {
46
+ return { go: false, by: ENGINE_ORIGIN.plugin, reason: `the session.send station could not be raised (${describeThrown(err)}); the message was not sent (fail-closed)` };
47
+ }
48
+ if (outcome.kind === "aborted")
49
+ return outcome.bottomStarted === true ? GO : { go: false, by: ENGINE_ORIGIN.plugin, reason: "the send was cancelled before the message went" };
50
+ if (outcome.kind === "failed")
51
+ return { go: false, by: outcome.registration, reason: `a session.send extension ${failedHandlerClause(outcome)} before the message went; it was not sent (fail-closed)` };
52
+ if (outcome.answer === started)
53
+ return GO;
54
+ const by = outcome.answeredBy ?? ENGINE_ORIGIN.plugin;
55
+ const reason = refusalOf(outcome.answer);
56
+ return {
57
+ go: false,
58
+ by,
59
+ reason: reason !== undefined ? `extension "${extensionWords(by, 80)}" refused this message before it went: ${extensionWords(reason, 300)}` : `extension "${extensionWords(by, 80)}" answered this message in a form session.send does not take; it was not sent (fail-closed)`,
60
+ };
61
+ },
62
+ };
63
+ }
64
+ const textOf = (content) => (Array.isArray(content) ? content.map((b) => (isPlainRecord(b) && b["type"] === "text" && typeof b["text"] === "string" ? b["text"] : "")).join("") : "");
65
+ export function createSessionSendEntry(input) {
66
+ return async (args, ctx) => {
67
+ const by = ctx.origin.plugin;
68
+ const refuse = (why) => new TypeError(`${by}: $.session.send: refused: ${why}`);
69
+ const extra = Object.keys(args).find((k) => k !== "to" && k !== "text");
70
+ if (extra !== undefined)
71
+ throw refuse(`takes { to, text }; "${extensionWords(extra, 40)}" is not one`);
72
+ const to = args["to"];
73
+ const text = args["text"];
74
+ if (typeof to !== "string" || to.trim() === "")
75
+ throw refuse("no { to } (a non-empty string)");
76
+ if (typeof text !== "string" || text.trim() === "")
77
+ throw refuse("no { text } (a non-empty string)");
78
+ if (!input.tools().includes(input.sendToolName))
79
+ return Object.freeze({ isDelivered: false, reason: "this session has no SendMessage tool (messaging between sessions and agents is not on here)" });
80
+ const answer = await input.toolCall({ tool: input.sendToolName, to, message: text }, ctx);
81
+ if (isPlainRecord(answer) && typeof answer["deny"] === "string")
82
+ return Object.freeze({ isDelivered: false, reason: answer["deny"] });
83
+ const result = isPlainRecord(answer) && isPlainRecord(answer["result"]) ? answer["result"] : undefined;
84
+ if (result === undefined)
85
+ return Object.freeze({ isDelivered: false, reason: "SendMessage did not answer" });
86
+ return result["isError"] === true ? Object.freeze({ isDelivered: false, reason: textOf(result["content"]) || "the message was not sent" }) : Object.freeze({ isDelivered: true });
87
+ };
88
+ }