@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
@@ -1,16 +1,28 @@
1
1
  import { type ModBottomContext, type ModBus } from "./kernel/index.js";
2
2
  import type { ExtensionRequester } from "../task-event.js";
3
+ /** Which `$` call made the record: the door the extension came through. */
4
+ export type ExtensionDoor = "tool.call" | "agent.spawn";
3
5
  /** One extension's call while it runs. */
4
6
  export interface ExtensionCall {
5
7
  /** The leg bus the call was made on (the one {@link legBusOf} returned). */
6
8
  readonly bus: ModBus;
7
9
  readonly toolCallId: string;
10
+ /** The door: an extension's spawn is a record made by `$.agent.spawn` — a tool an extension calls through `$.tool.call` that
11
+ * runs the delegation inside its own body hands the delegation a tool call's record, and the delegation runs as it would
12
+ * for the model. */
13
+ readonly door: ExtensionDoor;
8
14
  /** The `$` call's context: the frames its pipeline's events are raised under, and its origin. */
9
15
  readonly caller: ModBottomContext;
10
16
  /** Cleared when the call's pipeline settles — the one reading of "this call is still running". */
11
17
  readonly live: boolean;
12
18
  /** The call's end projection refused it (its latest gate record is a refusal) — written once, by the leg's tool_end station. */
13
19
  readonly denied: boolean;
20
+ /** The subagent the call started (`$.agent.spawn`): its id and the model it was let start on — written once, by the delegation
21
+ * tool where it lets the subagent run; absent ⇒ none started (the call's result is never read for it). */
22
+ readonly launched?: {
23
+ readonly agentId: string;
24
+ readonly model: string;
25
+ };
14
26
  }
15
27
  /** The running extension call this chain carries for `bus`, when it is the call `toolCallId` names (or any, unnamed). */
16
28
  export declare function extensionCallOf(bus: object, toolCallId?: string): ExtensionCall | undefined;
@@ -21,8 +33,10 @@ export declare function requesterOf(bus: object, toolCallId: string): {
21
33
  };
22
34
  /** The leg's tool_end station says the call it is closing was refused (a no-op for any call that is not the running extension call). */
23
35
  export declare function noteExtensionCallDenied(bus: object, toolCallId: string): void;
36
+ /** The delegation tool says the extension's spawn it is running started its subagent (a no-op for any other call). */
37
+ export declare function noteExtensionCallLaunched(bus: object, toolCallId: string, launched: NonNullable<ExtensionCall["launched"]>): void;
24
38
  /** Run an extension's call: `pipeline` runs with the call's record in scope; the record stops being live when it settles. */
25
- export declare function runExtensionCall<T>(bus: ModBus, toolCallId: string, caller: ModBottomContext, pipeline: (call: ExtensionCall) => Promise<T>): Promise<T>;
39
+ export declare function runExtensionCall<T>(bus: ModBus, toolCallId: string, door: ExtensionDoor, caller: ModBottomContext, pipeline: (call: ExtensionCall) => Promise<T>): Promise<T>;
26
40
  /**
27
41
  * The leg bus every station raises on: a dispatch inside a running extension call made on it is raised under that call's
28
42
  * frames and origin (a raiser that names its own frames keeps them — they extend the call's); one raised under a call
@@ -14,8 +14,13 @@ export function noteExtensionCallDenied(bus, toolCallId) {
14
14
  if (c !== undefined && c.live && c.bus === bus && c.toolCallId === toolCallId)
15
15
  c.denied = true;
16
16
  }
17
- export async function runExtensionCall(bus, toolCallId, caller, pipeline) {
18
- const call = { bus, toolCallId, caller, live: true, denied: false };
17
+ export function noteExtensionCallLaunched(bus, toolCallId, launched) {
18
+ const c = store.getStore();
19
+ if (c !== undefined && c.live && c.bus === bus && c.toolCallId === toolCallId && c.launched === undefined)
20
+ c.launched = Object.freeze({ agentId: launched.agentId, model: launched.model });
21
+ }
22
+ export async function runExtensionCall(bus, toolCallId, door, caller, pipeline) {
23
+ const call = { bus, toolCallId, door, caller, live: true, denied: false };
19
24
  try {
20
25
  return await store.run(call, () => pipeline(call));
21
26
  }
@@ -1,6 +1,6 @@
1
1
  import { type ModBusSide, type ModEventName, type ModSeat } from "./events.js";
2
2
  import { type ModAdmissionRecord, type ModDollarBase, type ModOrigin, type ModSeats } from "./registration.js";
3
- import { type ModAnswerCheck, type ModAnswerRanks, type ModEventPayload, type ModFailureCause, type ModMatcher, type ModSkip, type ProxyProbe } from "./site-rules.js";
3
+ import { type ModAnswerCheck, type ModAnswerer, type ModAnswerRanks, type ModEventPayload, type ModFailureCause, type ModMatcher, type ModSkip, type ProxyProbe } from "./site-rules.js";
4
4
  /** A frame on the dispatch stack: a registration's own `$` call, or one of its handlers running. */
5
5
  export type ModFrame = {
6
6
  readonly kind: "dollar";
@@ -73,8 +73,9 @@ export interface ModDispatchOptions {
73
73
  /** The raiser's reading of an answer; an answer it refuses is a violation of the site. */
74
74
  readonly checkAnswer?: ModAnswerCheck;
75
75
  /** The raiser's reading of what a handler hands on (a payload other than the dispatch's own `e`, received, its pinned keys
76
- * judged); a payload it refuses is a violation of the site — the other direction of {@link checkAnswer}. */
77
- readonly checkHandOn?: (payload: ModEventPayload) => string | undefined;
76
+ * judged), with the handler that hands it on; a payload it refuses is a violation of the site — the other direction of
77
+ * {@link checkAnswer}. */
78
+ readonly checkHandOn?: (payload: ModEventPayload, by: ModAnswerer) => string | undefined;
78
79
  /** The station's ranking of its answers — named by every dispatch of an event whose failure column refuses (one that
79
80
  * names none is not run), and read by the seat-trust law. */
80
81
  readonly ranks?: ModAnswerRanks;
@@ -371,13 +371,13 @@ function createBus(side, mounted, bottoms, entries, report, records, describe, i
371
371
  let found;
372
372
  return () => (found ??= sealedObjects([e0]));
373
373
  })();
374
- const handOn = (passed) => {
374
+ const handOn = (passed, h) => {
375
375
  if (passed === e0)
376
376
  return { snap: e0 };
377
377
  const handed = handedOn(st.pinned, e0, passed, engines(), isProxy);
378
378
  if ("violation" in handed)
379
379
  return handed;
380
- const why = handOnViolation(handed.payload, options.checkHandOn);
380
+ const why = handOnViolation(handed.payload, options.checkHandOn, answererOf(h));
381
381
  return why !== undefined ? { violation: why } : { snap: handed.payload };
382
382
  };
383
383
  const trustFloors = new Map();
@@ -516,7 +516,7 @@ function createBus(side, mounted, bottoms, entries, report, records, describe, i
516
516
  state.violated ??= "next() already called (a handler calls next once; its first run's answer stands)";
517
517
  return Promise.reject(new Error(`${name}: next() already called`));
518
518
  }
519
- const handed = handOn(passed);
519
+ const handed = handOn(passed, h);
520
520
  if ("violation" in handed) {
521
521
  state.violated ??= handed.violation;
522
522
  return Promise.reject(new Error(`${name}: ${state.violated}`));
@@ -634,7 +634,7 @@ function createBus(side, mounted, bottoms, entries, report, records, describe, i
634
634
  running.then(resume, resume);
635
635
  return running;
636
636
  }
637
- const handed = handOn(passed);
637
+ const handed = handOn(passed, h);
638
638
  if ("violation" in handed) {
639
639
  violated ??= handed.violation;
640
640
  return Promise.reject(new Error(`${h.reg.name}: ${violated}`));
@@ -30,8 +30,11 @@
30
30
  * go, before its subagent starts — every argument pinned, a refusal its only answer), `turn.complete` (a model turn ended)
31
31
  * and `session.end` (a leg ended) have stations; `tool.call`'s failure column is `refuse` — a failure once the body has
32
32
  * started withholds the result (under `refuse_until_run`, its column until 5, the result stood).
33
+ * 7: `session.receive` (a frame arriving for the model), `session.append` (a row entering the conversation), `session.send` (a
34
+ * message the leg sends) and `session.compact` (a compaction about to run) have stations; `agent.spawn` has a `call` column,
35
+ * and so do `session.append`, `session.send` and `session.compact` — a `$` call of each reaches the host's entry.
33
36
  */
34
- export declare const KERNEL_CONTRACT_VERSION = 6;
37
+ export declare const KERNEL_CONTRACT_VERSION = 7;
35
38
  /** The five tiers in run order (CC names). `builtin` and `core` are the engine's own. */
36
39
  export declare const MOD_TIERS: readonly ["prepend", "user", "append", "builtin", "core"];
37
40
  export type ModTier = (typeof MOD_TIERS)[number];
@@ -1,4 +1,4 @@
1
- export const KERNEL_CONTRACT_VERSION = 6;
1
+ export const KERNEL_CONTRACT_VERSION = 7;
2
2
  export const MOD_TIERS = Object.freeze(["prepend", "user", "append", "builtin", "core"]);
3
3
  export const MOD_SEATS = Object.freeze(["deployment", "task"]);
4
4
  export const MOD_EVENT_SIDES = Object.freeze(["engine", "surface", "both"]);
@@ -93,7 +93,7 @@ export const MOD_EVENT_TABLE = Object.freeze({
93
93
  "ui.scroll": surface(station("skip", "grace", ["component", "requestId", "by", "bodyRows", "contentRows", "origin", "pointer"], { call: true })),
94
94
  "ui.focus": surface(station("skip", "grace", ["component", "requestId", "plugin", "origin", "element"], { call: true })),
95
95
  "agent.offer": engine(station("skip", "grace", ["agent", "provider"])),
96
- "agent.spawn": engine(station("refuse_until_run", "immediate", AGENT_SPAWN_PINNED)),
96
+ "agent.spawn": engine(station("refuse_until_run", "immediate", AGENT_SPAWN_PINNED, { call: true })),
97
97
  "prompt.submit": engine(),
98
98
  "prompt.fill": surface(station("skip", "grace", ["origin", "mode"], { call: true })),
99
99
  "prompt.suggest": surface(station("skip", "grace", ["origin"], { call: true })),
@@ -114,10 +114,10 @@ export const MOD_EVENT_TABLE = Object.freeze({
114
114
  "skill.prompt": engine(),
115
115
  "attribution.text": engine(),
116
116
  "session.start": engine(),
117
- "session.receive": engine(),
118
- "session.append": engine(),
119
- "session.send": engine(),
120
- "session.compact": engine(),
117
+ "session.receive": engine(station("refuse", "immediate", ["origin", "event", "agentId"])),
118
+ "session.append": engine(station("skip", "grace", ["door", "origin", "agentId"], { call: true })),
119
+ "session.send": engine(station("refuse_until_run", "immediate", ["origin", "agentId", "to", "text"], { call: true })),
120
+ "session.compact": engine(station("refuse_until_run", "immediate", ["trigger", "agentId", "instructions"], { call: true })),
121
121
  "session.attach": engine(),
122
122
  "session.detach": engine(),
123
123
  "session.measure": engine(),
@@ -23,6 +23,9 @@ export interface ModOrigin {
23
23
  }
24
24
  /** The engine's own origin; its `plugin` word is reserved (no registration may take it). */
25
25
  export declare const ENGINE_ORIGIN: ModOrigin;
26
+ /** The form of a registration name: 1–64 of letters, digits, `.`, `_`, `:` and `-` (`:` is the separator of the `skill:<name>` spelling a skill's registrations use). The one rule — a name reaches sentences a person or
27
+ * a model reads (`extension "<name>"`), so a name that could quote, bracket or fold a sentence is refused where it enters. */
28
+ export declare const MOD_REGISTRATION_NAME: RegExp;
26
29
  /** The extension a refusal names: the registration's own name — never the engine's origin word (a raise the engine could not run
27
30
  * names no extension), never an absent one. The one reading of "who refused" for every station that refuses a call at the hook
28
31
  * layer (`GateDisposition.extension`). Module-level: not part of the kernel's entry. */
@@ -3,6 +3,7 @@ import { resolveModBudgetMs } from "./budget.js";
3
3
  export const MODS_INVALID_CODE = "config.mods_invalid";
4
4
  export const MODS_REGISTRATION_REFUSED_CODE = "mods.registration_refused";
5
5
  export const ENGINE_ORIGIN = Object.freeze({ plugin: "engine", tier: "core" });
6
+ export const MOD_REGISTRATION_NAME = /^[A-Za-z0-9._:-]{1,64}$/;
6
7
  export function namedRegistration(registration) {
7
8
  return registration === undefined || registration === ENGINE_ORIGIN.plugin ? undefined : registration;
8
9
  }
@@ -37,8 +38,12 @@ function screenOne(item, seat, side, report) {
37
38
  if (!isRegistration(item))
38
39
  throw modsInvalid(`a ${seat} mods entry is ${describe(item)}; a registration has a name and a register function`);
39
40
  const name = item.name;
41
+ if (typeof name !== "string")
42
+ throw modsInvalid(`a ${seat} registration's name is ${describe(name)}; a registration name is a string`);
40
43
  if (name === "")
41
44
  throw modsInvalid(`a ${seat} registration has an empty name`);
45
+ if (!MOD_REGISTRATION_NAME.test(name))
46
+ throw modsInvalid(`a ${seat} registration's name (${name.length} characters) is outside the form of a registration name — 1 to 64 of letters, digits, ".", "_", ":" and "-"`);
42
47
  if (name === ENGINE_ORIGIN.plugin)
43
48
  throw modsInvalid(`a ${seat} registration is named "${name}", the engine's own origin word — choose another name`);
44
49
  const tier = tierOf(item.tier, seat, name);
@@ -74,6 +74,9 @@ export interface PinnedKeyBreak {
74
74
  * ({@link sameModValue}): the engine's own fact handed on as is, or a copy of it, is not a change.
75
75
  */
76
76
  export declare function pinnedKeyChanged(pinned: readonly string[], received: ModEventPayload, passed: ModEventPayload): PinnedKeyBreak | undefined;
77
+ /** Whether `b` is the same data as `a`, by the one comparison a pinned key is judged by ({@link sameModValue}): a copy is the
78
+ * value it copies. A pair the walk cannot finish (past the depth bound, or a read that throws) is not proven the same. */
79
+ export declare function sameModData(a: unknown, b: unknown): boolean;
77
80
  /** {@link engineObjects} of a dispatch's own event, found the first time it is asked and the same set every time after:
78
81
  * the event is frozen, so one finding serves every receipt of the dispatch. */
79
82
  export declare function engineObjectsOnce(held: ModEventPayload): () => ReadonlySet<object>;
@@ -109,9 +112,9 @@ export declare function pinnedHandOn(pinned: readonly string[], held: ModEventPa
109
112
  };
110
113
  /** Why a handler's answer breaks the site, or undefined. No answer at all is never an answer. */
111
114
  export declare function answerViolation(answer: unknown, check: ModAnswerCheck | undefined, e: ModEventPayload, by: ModAnswerer, below: readonly unknown[], run: ModDispatchRun): string | undefined;
112
- /** A station's reading of what a handler hands on: its sentence, or undefined (no check, or the payload passes). A check that
113
- * throws is a sentence too — the station could not read the payload, so it is not handed on. */
114
- export declare function handOnViolation(payload: ModEventPayload, check: ((payload: ModEventPayload) => string | undefined) | undefined): string | undefined;
115
+ /** A station's reading of what a handler hands on (and of who hands it on): its sentence, or undefined (no check, or the
116
+ * payload passes). A check that throws is a sentence too — the station could not read the payload, so it is not handed on. */
117
+ export declare function handOnViolation(payload: ModEventPayload, check: ((payload: ModEventPayload, by: ModAnswerer) => string | undefined) | undefined, by: ModAnswerer): string | undefined;
115
118
  /**
116
119
  * A `$` method's answer form: `{ value }` (the call's result) or `{ deny }` (the call throws). A `{ deny }` given after
117
120
  * the handler's `next` was answered with something that is not a deny — or while that `next` is still running — breaks
@@ -81,6 +81,14 @@ export function pinnedKeyChanged(pinned, received, passed) {
81
81
  const compared = comparePinned(pinned, received, passed);
82
82
  return "broke" in compared ? compared.broke : undefined;
83
83
  }
84
+ export function sameModData(a, b) {
85
+ try {
86
+ return sameModValue(a, b, new Map(), 1, new Map()) !== false;
87
+ }
88
+ catch {
89
+ return false;
90
+ }
91
+ }
84
92
  function comparePinned(pinned, received, passed) {
85
93
  const paired = new Map();
86
94
  const homes = new Map();
@@ -203,11 +211,11 @@ export function answerViolation(answer, check, e, by, below, run) {
203
211
  return "returned an answer the station cannot read";
204
212
  }
205
213
  }
206
- export function handOnViolation(payload, check) {
214
+ export function handOnViolation(payload, check, by) {
207
215
  if (check === undefined)
208
216
  return undefined;
209
217
  try {
210
- return check(payload);
218
+ return check(payload, by);
211
219
  }
212
220
  catch {
213
221
  return "handed on an event the station cannot read";
@@ -0,0 +1,115 @@
1
+ /**
2
+ * The `session.append` station, and the one seat every conversation row passes on its way in ({@link RowSeat}).
3
+ *
4
+ * THE RULE. A row enters the conversation at one point: its first commit point, before the live context reads it again and
5
+ * before the store keeps it. Every writer calls the seat there, once — the harness for the rows it commits (a row the loop
6
+ * ends, the record of an API failure, a row handed to its port), every direct writer of the leg through
7
+ * `appendAdmittedRow` (`row-admission.ts`). With a handler on `session.append` the seat raises the event once per row; with none, or before
8
+ * the leg's bus is bound, the row passes as made and nothing is raised.
9
+ *
10
+ * `e = { door, origin, agentId?, message }` plus the identity envelope; `door`, `origin` and `agentId` are pinned. `door` and
11
+ * `origin` are read off the row's own typed facts ({@link doorOf}, {@link originOf}) — no writer names them; an extension's
12
+ * own note (raised through `$.session.append`) is door `note`, origin `{ kind: "plugin", name }`. `message` is a frozen data
13
+ * view of the row: its role, the members that name it, and its content.
14
+ *
15
+ * A handler answers:
16
+ * - `next(e)` — the row is kept as made; what comes up is `{ message }`, the row as kept;
17
+ * - `next({ ...e, message })` — the row is kept with its content rewritten: only text changes (a text block's text, or a
18
+ * string content); every other block stays, the same blocks in the same order, and every member beside `content` is
19
+ * pinned. The rewrite is made on the row itself, in place — the same object, so every account kept by identity (the
20
+ * live context, a frame's settlement, the prompt's receipt) settles on it — and the row records who rewrote it
21
+ * (`rewrittenBy`). A rewrite that changes a pinned part, or of a row whose content another reader holds by its exact text
22
+ * (a row the engine composed its frames into, an attachment's row), is not kept: the row is kept as made, and the leg's
23
+ * report sink says so (the reference's form: `appendCoreOf` (cli309.js:296238));
24
+ * - `{ deny: <reason> }` — only before `next`, only of an extension's own note: the note is not kept.
25
+ * The answer is the row as kept: what `next` answered, or a copy of it. Anything else is a violation (the reference's
26
+ * sentences: `Nu` (cli309.js:255554)). A handler may not change `message.role`, nor the members that name the row.
27
+ *
28
+ * A failure skips the handler (the table's column): before `next`, what is below it runs in its place, so the row is kept as
29
+ * made; after it, the row as kept stands. No row is dropped and none is kept twice: an engine row cannot be refused, an
30
+ * extension's own note only by a deny before `next` (a note whose handler failed is kept — the reference refuses it:
31
+ * `ee` (cli309.js:256939)). An engine fault of the dispatch keeps the row as made and is said on the report sink.
32
+ *
33
+ * `$.session.append({ message: { role: "user", content }, agentId? })` is the event called ({@link createSessionAppendEntry}):
34
+ * the leg's harness takes the note through its own port, the seat raises it here under the caller's frames and origin, and
35
+ * the call answers `{ message }` (the note as admitted) or `{ deny: <reason> }` (returned, not thrown): the note is in the
36
+ * conversation the leg goes on with — stored by the port (`AgentHarness.appendMessage`), or carried by a durable park's row
37
+ * (`heldRows`); once the park is taken, or may have been, the call throws `$.session.append: refused: …`.
38
+ */
39
+ import type { AgentMessage, RowAdmission, RowRaising } from "../../internal/harness-types.js";
40
+ import type { AgentHarness } from "../../internal/harness.js";
41
+ import { type FrameSettlement } from "../frame-settlement.js";
42
+ import type { HookInvocationIdentity } from "../hooks.js";
43
+ import type { ModBottomContext, ModCallEntry } from "./kernel/index.js";
44
+ import { type LegModBus } from "./stations.js";
45
+ /** Where a row comes in: read off the row ({@link doorOf}); an extension's own note is `note`. The doors the leg's commit
46
+ * points produce — a compaction's summary is kept as its own entry, not a conversation row, and the engine writes no
47
+ * command row. */
48
+ export declare const SESSION_APPEND_DOORS: readonly ["prompt", "note", "delivery", "attachment", "response", "tool-result"];
49
+ export type SessionAppendDoor = (typeof SESSION_APPEND_DOORS)[number];
50
+ /** Who made a row: read off the row ({@link originOf}); an extension's own note is `plugin`. */
51
+ export declare const SESSION_APPEND_ORIGIN_KINDS: readonly ["host", "engine", "model", "tool", "plugin"];
52
+ export type SessionAppendOrigin = {
53
+ readonly kind: "host";
54
+ } | {
55
+ readonly kind: "engine";
56
+ } | {
57
+ readonly kind: "model";
58
+ readonly model: string;
59
+ } | {
60
+ readonly kind: "tool";
61
+ readonly tool: string;
62
+ } | {
63
+ readonly kind: "plugin";
64
+ readonly name: string;
65
+ };
66
+ /** A row's door, from its typed facts: a person's (or the host's) input is a `prompt`; what the engine adds for the model to
67
+ * read is a `note` (a user-lane note, or a row of its own kind), a `delivery` (a frame with its delivery key) or an
68
+ * `attachment`; the model's turn is a `response`, a tool's answer a `tool-result`. */
69
+ export declare function doorOf(row: AgentMessage): SessionAppendDoor;
70
+ /** A row's maker, from its typed facts: the model, the tool that answered, the host (a prompt, an attachment the host
71
+ * declared), else the engine. */
72
+ export declare function originOf(row: AgentMessage): SessionAppendOrigin;
73
+ /** What the leg binds the seat to once its bus is admitted. */
74
+ export interface RowSeatBinding {
75
+ readonly bus: LegModBus;
76
+ readonly identity: HookInvocationIdentity | undefined;
77
+ /** The leg's report sink (handler failures and the seat's own disclosures). */
78
+ readonly report: (err: Error) => void;
79
+ /** The leg's settlement seam: a tool result an extension rewrote is a host-side decision of what the model reads
80
+ * (`noteHostRewrite`), so a frame the rewrite took out is withheld by the host side, never owed again. */
81
+ readonly frameSettlement?: FrameSettlement;
82
+ }
83
+ /** What became of an extension's own note: kept (the answer its call returns), refused by a deny, or cancelled with its call. */
84
+ export type RaisedRowOutcome = {
85
+ readonly kind: "kept";
86
+ readonly answer: object;
87
+ } | {
88
+ readonly kind: "denied";
89
+ readonly reason: string;
90
+ } | {
91
+ readonly kind: "cancelled";
92
+ };
93
+ /** The leg's one admission seat. */
94
+ export interface RowSeat {
95
+ /** What every writer calls at a row's first commit point (`AgentHarnessOptions.admitRows`). */
96
+ readonly admitRows: RowAdmission;
97
+ /** Bind the leg's bus. Until then every row passes as made. */
98
+ bind(binding: RowSeatBinding): void;
99
+ /** The token an extension's own note is handed to the harness with: its dispatch runs under `ctx` (the `$` call's frames,
100
+ * origin and signal). Known by identity; a token this seat did not mint is no raising. */
101
+ raise(ctx: ModBottomContext): RowRaising;
102
+ /** What became of the note a token was handed with — once the seat has admitted it. */
103
+ outcomeOf(raising: RowRaising): RaisedRowOutcome | undefined;
104
+ }
105
+ /** A leg's admission seat (see the module header). */
106
+ export declare function createRowSeat(): RowSeat;
107
+ /** What the host entry reaches: the leg's seat, its harness's port, the leg's `agentId` (a delegated leg's), its clock. */
108
+ export interface SessionAppendEntryInput {
109
+ readonly seat: RowSeat;
110
+ readonly harness: Pick<AgentHarness, "appendMessage">;
111
+ readonly agentId: string | undefined;
112
+ readonly now: () => number;
113
+ }
114
+ /** `$.session.append`'s host entry: an extension's own note, through the harness's port and this station (the module header). */
115
+ export declare function createSessionAppendEntry(input: SessionAppendEntryInput): ModCallEntry;