@sema-agent/core 7.66.0 → 7.67.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 (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
package/LICENSE CHANGED
@@ -5,7 +5,8 @@ Parameters
5
5
  Licensor: clay (github.com/clayboby)
6
6
  Licensed Work: @sema-agent/core (sema-core) and the satellite packages
7
7
  published from this repository (currently
8
- @sema-agent/mods-kernel, @sema-agent/primitives and @sema-agent/core-stores-sql)
8
+ @sema-agent/mods-kernel, @sema-agent/primitives,
9
+ @sema-agent/core-stores-sql and @sema-agent/wiki-gate)
9
10
  (formerly published as @sema-ai/core)
10
11
  The Licensed Work is (c) 2026 clay.
11
12
  Additional Use Grant: You may make production use of the Licensed Work for
@@ -1,3 +1,4 @@
1
+ import { describeRejectedValue } from "../core/tool-search-setting.js";
1
2
  import { snapshotToolNameList } from "../core/tool-name-list.js";
2
3
  import { snapshotAndValidateMcpEntries } from "../core/locked-config.js";
3
4
  export function snapshotDefinitionLists(def) {
@@ -17,7 +18,7 @@ export function defineAgent(def) {
17
18
  throw e;
18
19
  }
19
20
  if (def.memoryPersistenceCapable !== undefined && typeof def.memoryPersistenceCapable !== "boolean") {
20
- const e = new Error(`defineAgent("${def.name}"): memoryPersistenceCapable must be a boolean when present — got ${JSON.stringify(def.memoryPersistenceCapable)} (a string "false" would silently read as capable).`);
21
+ const e = new Error(`defineAgent("${def.name}"): memoryPersistenceCapable must be a boolean when present — got ${describeRejectedValue(def.memoryPersistenceCapable)} (a string "false" would silently read as capable).`);
21
22
  e.code = "config.agent.invalid";
22
23
  throw e;
23
24
  }
@@ -36,7 +36,7 @@ export interface AgentTranscriptToolOptions {
36
36
  * not_found, on a mount whose transcript tier declares transcript durability (`full`). Announced once
37
37
  * per (handle, process); absent ⇒ the honest per-call degrade alone. */
38
38
  onTranscriptIntegrityGap?: (handle: string, scope: string | undefined) => void;
39
- /** The run's checkpoint seat — where a PARKED agent's approval card is read from for the state line
39
+ /** The run's checkpoint seat — where a PARKED agent's park card is read from for the state line
40
40
  * (the same seat the Agent tool parks children into). Absent ⇒ the ctx seat
41
41
  * (`checkpointStoreForChildren`) when the mount's ctx builder supplies one, else the card reads
42
42
  * `unreadable`. */
@@ -10,6 +10,7 @@ import { REPORT_FIELD_MAX } from "./subagent.js";
10
10
  import { getSessionRetainLedger } from "./retain-ledger.js";
11
11
  import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
12
12
  import { thrownText } from "../core/thrown-value.js";
13
+ import { callScopeOf } from "../core/isolation-scope.js";
13
14
  export const AGENT_TRANSCRIPT_TOOL_NAME = "AgentTranscript";
14
15
  const AGENT_TRANSCRIPT_DEFAULT_N = 20;
15
16
  const AGENT_TRANSCRIPT_MAX_N = 50;
@@ -34,8 +35,8 @@ export function createAgentTranscriptTool(opts) {
34
35
  `the agent. Works for agents this run retained (retainSubagentSessions) and for agents whose durable ` +
35
36
  `record preserved their transcript session; when neither holds you get an honest error. ` +
36
37
  `The first line states the agent's current state: its status (running / parked / completed / failed / killed …), ` +
37
- `when it last did anything, and — only for an agent parked on a durable approval — that approval's card id, ` +
38
- `state and deadline. Each step shows how long ago it happened; a call still waiting for its result shows ` +
38
+ `when it last did anything, and — only for a parked agent — what its park waits on (a person's approval, or a yield ` +
39
+ `that continues when its owner runs again), the card id, state and deadline. Each step shows how long ago it happened; a call still waiting for its result shows ` +
39
40
  `"started <age> ago, no result yet" (an approval answered in-process while the agent runs is not visible ` +
40
41
  `here — such a wait shows only as that unfinished call). Report what these lines say rather than estimating progress.`,
41
42
  parameters: Type.Object({
@@ -50,7 +51,7 @@ export function createAgentTranscriptTool(opts) {
50
51
  const lastN = typeof a.lastN === "number" && Number.isFinite(a.lastN) ? Math.max(1, Math.min(AGENT_TRANSCRIPT_MAX_N, Math.floor(a.lastN))) : AGENT_TRANSCRIPT_DEFAULT_N;
51
52
  const access = {
52
53
  owner: ctx.taskId ?? opts.owner,
53
- scope: ctx.principal ?? opts.scope,
54
+ scope: callScopeOf(ctx, opts),
54
55
  ...((ctx.sessionId ?? opts.sessionId) !== undefined ? { sessionId: ctx.sessionId ?? opts.sessionId } : {}),
55
56
  };
56
57
  const seat = opts.checkpointSeat ?? ctx.checkpointStoreForChildren;
@@ -11,6 +11,8 @@ import type { AgentDefinition } from "../core/types.js";
11
11
  * coordinates and the drift re-checks live in the parity register, not here.
12
12
  *
13
13
  * sema adaptations (deliberate, each recorded):
14
+ * - The deny set also denies SaveToolResult (sema's writer of kept bytes, no reference counterpart): its write half is the
15
+ * reference's three plus every other write tool the catalog declares, held equal to the catalog's confinable writes by test.
14
16
  * - De-branding (prompt-sovereignty / SUBAGENT_PROMPT precedent): CC's persona first sentences name the
15
17
  * product ("… for Claude Code, Anthropic's official CLI for Claude." / "… for Claude Code.") — sema
16
18
  * stays provider-neutral, the brand clause is dropped; every other byte is unchanged.
@@ -22,10 +24,10 @@ import type { AgentDefinition } from "../core/types.js";
22
24
  * model (identical semantics). CC's Explore firstParty opus UPGRADE (`GAe`, 409162-409171: built-in
23
25
  * Explore may upshift to opus on first-party subscriptions) is a CC-subscription ladder concern —
24
26
  * NOT ported (sema is provider-neutral; inherit is the base arm both sides share).
25
- * - `omitClaudeMd:!0` (422063: drops the CLAUDE.md user-context layer for these types) — NOT ported this
26
- * round: sema's project-context layer is assembled in prepare-task (design/113 C4), a concurrent-batch
27
- * conflict domain at port time. Recorded as the F7 residual; the deployment `loadProjectMemory` seam
28
- * already receives `isSubagent`/`agentName` and can trim today.
27
+ * - `omitClaudeMd:!0` (422063: drops the CLAUDE.md user-context layer for these types) — NOT ported:
28
+ * a child inherits the task's instruction family (the parent spec seat) and reads the task root's
29
+ * instructions through the same lane; a type that should go without them is spawned with
30
+ * `projectMemory: "disabled"`. Recorded as the F7 residual.
29
31
  * - `disallowedTools` → `denyTools` (sema name), with the DELEGATION-tool entry tracking the deployment's
30
32
  * actual tool name (default "Agent"). "Artifact" (mounted on the `RunnerDeps.artifactHost`
31
33
  * seat) and "ExitPlanMode" (present_plan's canonical name) both name first-party sema tools — the deny bites
@@ -42,9 +44,10 @@ export declare const EXPLORE_SYSTEM_PROMPT = "You are a file search specialist.
42
44
  /** Plan persona, unix arm, first sentence de-branded. */
43
45
  export declare const PLAN_SYSTEM_PROMPT = "You are a software architect and planning specialist. Your role is to explore the codebase and design implementation plans.\n\n=== CRITICAL: READ-ONLY MODE - NO FILE MODIFICATIONS ===\nThis is a READ-ONLY planning task. You are STRICTLY PROHIBITED from:\n- Creating new files (no Write, touch, or file creation of any kind)\n- Modifying existing files (no Edit operations)\n- Deleting files (no rm or deletion)\n- Moving or copying files (no mv or cp)\n- Creating temporary files anywhere, including /tmp\n- Using redirect operators (>, >>, |) or heredocs to write to files\n- Running ANY commands that change system state\n\nYour role is EXCLUSIVELY to explore the codebase and design implementation plans. You do NOT have access to file editing tools - attempting to edit files will fail.\n\nYou will be provided with a set of requirements and optionally a perspective on how to approach the design process.\n\n## Your Process\n\n1. **Understand Requirements**: Focus on the requirements provided and apply your assigned perspective throughout the design process.\n\n2. **Explore Thoroughly**:\n - Read any files provided to you in the initial prompt\n - Find existing patterns and conventions using Glob, Grep, and Read\n - Understand the current architecture\n - Identify similar features as reference\n - Trace through relevant code paths\n - Use Bash ONLY for read-only operations (ls, git status, git log, git diff, find, cat, head, tail)\n - NEVER use Bash for: mkdir, touch, rm, cp, mv, git add, git commit, npm install, pip install, or any file creation/modification\n\n3. **Design Solution**:\n - Create implementation approach based on your assigned perspective\n - Consider trade-offs and architectural decisions\n - Follow existing patterns where appropriate\n\n4. **Detail the Plan**:\n - Provide step-by-step implementation strategy\n - Identify dependencies and sequencing\n - Anticipate potential challenges\n\n## Required Output\n\nEnd your response with:\n\n### Critical Files for Implementation\nList 3-5 files most critical for implementing this plan:\n- path/to/file1.ts\n- path/to/file2.ts\n- path/to/file3.ts\n\nREMEMBER: You can ONLY explore and plan. You CANNOT and MUST NOT write, edit, or modify any files. You do NOT have access to file editing tools.";
44
46
  /**
45
- * The six-tool deny set shared by both read-only built-ins: Agent, Artifact, ExitPlanMode, Edit, Write, NotebookEdit.
46
- * The delegation-tool entry is parameterized on the deployment's actual tool
47
- * name (default = "Agent").
47
+ * The deny set shared by both read-only built-ins: Agent, Artifact, ExitPlanMode, Edit, Write, NotebookEdit (the reference's,
48
+ * verbatim) and SaveToolResult — every tool that writes a file by its path, the catalog's confinable writes (a test holds the
49
+ * write half equal to them, so a write tool the catalog gains is a red here, not a read-only child that can write).
50
+ * The delegation-tool entry is parameterized on the deployment's actual tool name (default = "Agent").
48
51
  */
49
52
  export declare const BUILTIN_READONLY_DENY_TOOLS: (delegationToolName?: string) => string[];
50
53
  /**
@@ -92,6 +92,7 @@ export const BUILTIN_READONLY_DENY_TOOLS = (delegationToolName = DEFAULT_DELEGAT
92
92
  "Edit",
93
93
  "Write",
94
94
  "NotebookEdit",
95
+ "SaveToolResult",
95
96
  ];
96
97
  export function builtinAgentDefinitions(delegationToolName = DEFAULT_DELEGATION_TOOL_NAME) {
97
98
  const denyTools = BUILTIN_READONLY_DENY_TOOLS(delegationToolName);
@@ -127,14 +127,22 @@ export interface CascadeAttempt {
127
127
  }
128
128
  export interface CascadeRunResult extends TaskResult {
129
129
  /**
130
- * The cascade's conclusion, **distinct from the inherited `status`**: `"passed"` = some rung passed the
131
- * gate; `"exhausted"` = the cascade ended with no rung passing (the last rung's result is returned, and its
132
- * `status` may still be "completed" — judge the cascade by `cascadeOutcome`, not `status`). It ends that way
133
- * when the ladder ran out, when a guard stopped it (escalation cap, cost ceiling, wall-clock budget, the
134
- * caller's signal), when a rung durably parked (`failed.nestedPause` is on the terminal: {@link resumeCascade}
135
- * continues it), or when a resumed rung's approved action never started (`failed.unstartedRow`).
130
+ * The cascade's conclusion, **distinct from the inherited `status`**, in three words:
131
+ * - `"passed"` — some rung passed the gate.
132
+ * - `"exhausted"` — the cascade ended with no rung passing and nothing left to continue (the last rung's result is
133
+ * returned, and its `status` may still be "completed" — judge the cascade by `cascadeOutcome`, not `status`): the ladder
134
+ * ran out, a guard stopped it (escalation cap, cost ceiling, wall-clock budget, the caller's signal), or a resumed rung's
135
+ * approved action never started and its card is not pending again (`failed.unstartedRow` is `"declined"` — the store
136
+ * declined to reopen it — or `"unknown"` — its state is unproven): nothing continues that ladder, it ends as it stands.
137
+ * - `"suspended"` — the cascade is parked, not finished, and the host's token continues it: a rung durably parked
138
+ * (`failed.nestedPause` is on the terminal and the parked leg's session is held), or a resumed rung's approved action
139
+ * never started and its card is pending again (`failed.unstartedRow` is `"reopened"`). {@link resumeCascade} continues the
140
+ * ladder from the token. The rung's own code stays on `attempts[].errorCode` (`unexpected.suspended` for an approval /
141
+ * resource / platform park, `unexpected.needs_review` for a park that awaits a reviewer, the leg's own code for a resumed
142
+ * rung that never started) — the outcome says the ladder waits on the host, the code says which pause or why the resume
143
+ * did not start.
136
144
  */
137
- cascadeOutcome: "passed" | "exhausted";
145
+ cascadeOutcome: "passed" | "exhausted" | "suspended";
138
146
  /** F4: present when a finite `costCeilingMicroUsd` was configured but some rung's spend was unpriced —
139
147
  * the ceiling could not be enforced over unknown cost, so the ladder STOPPED escalating (fail-closed)
140
148
  * instead of riding an unbindable budget. Judge spend by the absent cost fields, not by 0. */
@@ -203,7 +211,10 @@ export declare function runCascade(runner: RunnerSelfSeat, spec: TaskSpec, confi
203
211
  * carrying `placementRoot` = the fixed point that rung's result reports (`TaskResult.placementRoot`)
204
212
  * unless the caller's object already resolves there (`placementRoot`, else `rootSessionId`: the
205
213
  * ladder's fixed point), and `placementTarget` = that rung's target when it reported one (a later rung
206
- * minted on another device is refused `config.placement_not_honored`).
214
+ * minted on another device is refused `config.placement_not_honored`). When the caller's object carries
215
+ * no fixed point and the spec names its session (`spec.sessionId`), rung 0 is dispatched with that
216
+ * session as `placementRoot`: the ladder is placed where a plain run of the spec would be — on the
217
+ * session a host binds its devices and cards to — not on a session minted for rung 0.
207
218
  *
208
219
  * The COMPOSITION-LEG delta: when the caller's spec names its session (`spec.sessionId`, which no rung
209
220
  * runs in — every rung is a cold re-run in its own), every rung is dispatched with a copy carrying
@@ -219,7 +230,7 @@ internals?: RunInternals): Promise<CascadeRunResult>;
219
230
  /**
220
231
  * Continue a cascade from a rung's parked card, then climb the rest of the ladder: the resume entry beside {@link runCascade},
221
232
  * as {@link import("./verify.js").resumeWithVerification} is beside its fresh-run entry. A rung that durably parks ends the
222
- * ladder (`cascadeOutcome`, `failed.nestedPause`) — the host holds the token, and the card's
233
+ * ladder (`cascadeOutcome: "suspended"`, `failed.nestedPause`) — the host holds the token, and the card's
223
234
  * `CheckpointState.compositionLeg` says which rung parked and which host session it belongs to. Once the pause is decided,
224
235
  * the host calls this with the token, the outcome, the ORIGINAL task spec, the ladder config and that `compositionLeg` as the
225
236
  * card records it.
@@ -240,8 +251,10 @@ internals?: RunInternals): Promise<CascadeRunResult>;
240
251
  * refused by the escalation cap, the cost ceiling or the wall-clock budget, and the deadline does not cut it; it is run under
241
252
  * the caller's `spec.signal` alone. Its result is gated exactly like a fresh rung: a pass ends the ladder `passed`, a fail
242
253
  * escalates to the next rung, a re-park ends it again with that rung's own card. A resumed rung whose approved action never
243
- * started (`resume.reopened_unstarted` / `resume.reopen_failed_unstarted`: the card is pending again, or its state unproven)
244
- * is never escalated: the ladder ends there with its result as is, the session kept, and the same token resumes it again.
254
+ * started (`resume.reopened_unstarted` / `resume.reopen_failed_unstarted`: the card is pending again, or the store declined to
255
+ * reopen it, or its state is unproven) is never escalated: the ladder ends there with its result as is and the session kept.
256
+ * Only a card that is pending again (`unstartedRow: "reopened"`) is the same park standing — `cascadeOutcome: "suspended"`, and
257
+ * the same token resumes it again; a declined or unproven one ends the ladder `exhausted`, and the host reads the row first.
245
258
  * - **Accounting covers this call**: `attempts` starts at the resumed rung (`index: parkedLeg.leg`), and the cumulative stats,
246
259
  * the escalations counted against `maxEscalations`, the cost ceiling and `totalTimeoutMs` cover only the rungs this call
247
260
  * dispatched. The resumed rung's stats are the engine's own report of that leg — never added to the stats of the call that
@@ -1,10 +1,13 @@
1
1
  import { terminalProjection } from "../core/runner/terminal-projection.js";
2
2
  import { releaseSession } from "./session-util.js";
3
3
  import { mapNestedSuspend, isDurablePause, resumeNeverStarted } from "./suspend-guard.js";
4
- import { buildCumulativeStats } from "./cumulative-stats.js";
4
+ import { buildCumulativeStats, emptyCumulativeUsageFacts, foldUsageFacts } from "./cumulative-stats.js";
5
+ import { foldIntake, withIntake } from "../core/task-intake.js";
5
6
  import { createSafeNotifier } from "../core/safe-notify.js";
6
7
  import { compositionPlacement } from "./composition-placement.js";
8
+ import { withLegIdentity } from "./leg-label.js";
7
9
  import { thrownText } from "../core/thrown-value.js";
10
+ import { withoutSessionBinding } from "../core/task-spec-members.js";
8
11
  const CASCADE_ON_RUNG_SITE = "cascade.onRung";
9
12
  const CASCADE_CONFIG_ERROR_CODE = "config.cascade_invalid";
10
13
  const CASCADE_NO_DISPATCH_ERROR_CODE = "cascade.budget_exhausted";
@@ -68,11 +71,12 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
68
71
  let ownTokens = 0, ownTurns = 0, ownPrompt = 0, ownCached = 0, ownOutput = 0, ownCostMicro = 0;
69
72
  let ownTotalInput = 0;
70
73
  let ownCacheWrite = 0, ownCacheWriteLong = 0;
74
+ const ownUsageFacts = emptyCumulativeUsageFacts();
71
75
  let nestedTokens = 0, nestedTurns = 0, nestedTasks = 0, nestedCostMicro = 0;
72
76
  let ownLlmRootMicro = 0, ownCompactionMicro = 0;
73
77
  let ownSideCallMicro;
74
78
  let anyRungUnpriced = false;
75
- let hrCount = 0, hrWaitMs = 0;
79
+ let hrKept = false, hrCount = 0, hrWaitMs = 0;
76
80
  const hrGates = [];
77
81
  const cumulativeStats = (baseStats) => buildCumulativeStats(baseStats, {
78
82
  tokens: ownTokens,
@@ -89,14 +93,16 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
89
93
  compactionMicroUsd: ownCompactionMicro,
90
94
  ...(ownSideCallMicro !== undefined ? { sideCallMicroUsd: ownSideCallMicro } : {}),
91
95
  nested: { tokens: nestedTokens, turns: nestedTurns, tasks: nestedTasks, costMicroUsd: nestedCostMicro },
92
- humanReview: { count: hrCount, totalWaitMs: hrWaitMs, gates: hrGates },
96
+ humanReview: { kept: hrKept, count: hrCount, totalWaitMs: hrWaitMs, gates: hrGates },
97
+ usageFacts: ownUsageFacts,
93
98
  });
94
99
  let lastResult;
95
100
  let passedRung = -1;
96
101
  let firstLegResult;
97
102
  let finalRung = -1;
98
- const placement = compositionPlacement(internals);
99
- const { sessionId: _drop, ...specBase } = spec;
103
+ const rungIntakes = [];
104
+ const placement = compositionPlacement(internals, opening.kind === "fresh" ? opening.hostSessionId : undefined);
105
+ const specBase = withoutSessionBinding(spec);
100
106
  const rungSpecOf = (rung, signal) => ({ ...specBase, model: rung.model, ...(rung.overrides ?? {}), ...(signal ? { signal } : {}) });
101
107
  const resumeConfigOf = (task) => {
102
108
  const { objective: _objective, userAttachments: _attachments, runOrigin: _origin, ...config } = task;
@@ -131,9 +137,10 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
131
137
  let result;
132
138
  const placed = firstLegResult === undefined ? placement.firstLeg : placement.laterLeg(firstLegResult);
133
139
  const compositionLeg = resumed !== undefined ? resumed.parked : legOf(i);
134
- const rungInternals = compositionLeg === undefined ? placed : { ...placed, compositionLeg };
135
140
  const rungTask = rungSpecOf(rung, rungSignal);
141
+ let rungInternals;
136
142
  try {
143
+ rungInternals = withLegIdentity(compositionLeg === undefined ? placed : { ...placed, compositionLeg }, { kind: "rung", round: i }, internals, resumed !== undefined ? "resumeStream" : "runTaskStream");
137
144
  result = resumed !== undefined ? await runner.resume(resumed.token, resumed.outcome, resumeConfigOf(rungTask), rungInternals) : await runner.runTask(rungTask, rungInternals);
138
145
  }
139
146
  finally {
@@ -141,6 +148,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
141
148
  clearTimeout(deadlineTimer);
142
149
  }
143
150
  lastResult = result;
151
+ rungIntakes.push(result.intake);
144
152
  finalRung = i;
145
153
  firstLegResult ??= result;
146
154
  const s = result.stats;
@@ -157,6 +165,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
157
165
  ownOutput += s.outputTokens ?? 0;
158
166
  ownCacheWrite += s.cacheWriteTokens ?? 0;
159
167
  ownCacheWriteLong += s.cacheWriteTokensLong ?? 0;
168
+ foldUsageFacts(ownUsageFacts, s);
160
169
  ownCostMicro += s.costMicroUsd ?? 0;
161
170
  if (s.costMicroUsd === undefined)
162
171
  anyRungUnpriced = true;
@@ -167,6 +176,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
167
176
  ownSideCallMicro = (ownSideCallMicro ?? 0) + s.costBreakdown.sideCallMicroUsd;
168
177
  }
169
178
  if (s.humanReview) {
179
+ hrKept = true;
170
180
  hrCount += s.humanReview.count;
171
181
  hrWaitMs += s.humanReview.totalWaitMs;
172
182
  hrGates.push(...s.humanReview.gates);
@@ -178,12 +188,13 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
178
188
  nestedCostMicro += s.nested.costMicroUsd ?? 0;
179
189
  }
180
190
  if (isDurablePause(result.terminal) || resumeNeverStarted(result)) {
191
+ const continuable = isDurablePause(result.terminal) || (result.terminal.kind === "failed" && result.terminal.unstartedRow === "reopened");
181
192
  const mapped = mapNestedSuspend(result, { door: "resumeCascade", legFrom: rungInternals?.compositionLeg === undefined ? "caller" : "card" });
182
193
  attempts.push({ index: i, model: rung.model, passed: false, costMicroUsd: rungCost, status: attemptTerminal(result).status, errorCode: attemptTerminal(mapped).errorCode });
183
194
  return {
184
- ...mapped,
195
+ ...withIntake(mapped, foldIntake(rungIntakes)),
185
196
  stats: cumulativeStats(result.stats),
186
- cascadeOutcome: "exhausted",
197
+ cascadeOutcome: continuable ? "suspended" : "exhausted",
187
198
  ...(config.costCeilingMicroUsd != null && !ceilingCostKnown ? { costCeilingUnenforceable: true } : {}),
188
199
  escalated: i > 0,
189
200
  finalRung: i,
@@ -248,6 +259,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
248
259
  taskId: spec.taskId ?? "",
249
260
  sessionId: "",
250
261
  result: `runCascade: the overall wall-clock budget (totalTimeoutMs ${config.totalTimeoutMs}ms) was already spent when the ladder was entered — no rung dispatched`, resultEntryIds: [],
262
+ intake: { committed: false },
251
263
  terminal: { kind: "failed", code: CASCADE_NO_DISPATCH_ERROR_CODE },
252
264
  stats: { tokens: 0, turns: 0, costMicroUsd: 0 },
253
265
  cascadeOutcome: "exhausted",
@@ -258,7 +270,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
258
270
  }
259
271
  const base = lastResult;
260
272
  return {
261
- ...base,
273
+ ...withIntake(base, foldIntake(rungIntakes)),
262
274
  stats: cumulativeStats(base.stats),
263
275
  cascadeOutcome: passedRung >= 0 ? "passed" : "exhausted",
264
276
  ...(config.costCeilingMicroUsd != null && !ceilingCostKnown ? { costCeilingUnenforceable: true } : {}),
@@ -1,4 +1,5 @@
1
1
  import { terminalProjection } from "../core/runner/terminal-projection.js";
2
+ import type { TerminalFailureDetail } from "../core/terminal-cause.js";
2
3
  import type { TerminalCause } from "../core/types.js";
3
4
  import { type Egress } from "../core/untrusted-egress.js";
4
5
  /** A child run's failure words can carry a credential: every parent-facing reader takes them from here, each through the
@@ -6,4 +7,33 @@ import { type Egress } from "../core/untrusted-egress.js";
6
7
  * its thrown value (every string member, not the message alone). */
7
8
  export declare const childTerminalFace: (terminal: TerminalCause) => ReturnType<typeof terminalProjection>;
8
9
  export declare const childThrownText: (err: unknown) => Egress<"same-principal">;
10
+ /** A delegated child's failure code, read once per failure: the failure account's `code` and the `detail` of the same link (one
11
+ * walk of the thrown value's `cause` chain, the walk a failed terminal reads), and the string `errorKind` the thrower declared. A
12
+ * settled child has no thrown value: its account is `{ code: terminal.code }`. */
13
+ export interface ChildFailure {
14
+ readonly code?: string;
15
+ readonly errorKind?: string;
16
+ readonly detail?: TerminalFailureDetail;
17
+ }
18
+ export declare function childFailureOf(err: unknown): ChildFailure;
19
+ /** A rejected child run, read once: the sentence its faces carry and its failure account. */
20
+ export interface RejectedChild {
21
+ readonly text: Egress<"same-principal">;
22
+ readonly failure: ChildFailure;
23
+ }
24
+ export declare const rejectedChildOf: (err: unknown) => RejectedChild;
25
+ /** The ROW face of a child's failure — a background row, its notice and poll, a parked resume's cause: the code as it stands
26
+ * (a platform's word too: the host's own redaction, counting and alerts read the original), else the declared kind. */
27
+ export declare const childRowCode: (f: ChildFailure) => string | undefined;
28
+ /** The ANSWER face of a child's failure — a tool result the parent's model and frame read: the account's code when it is an
29
+ * engine word, else the declared kind. Only the account's item is screened: a declared `errorKind` is the thrower's
30
+ * statement, lifted as declared, the way every tool's is. */
31
+ export declare const childAnswerCode: (f: ChildFailure) => string | undefined;
32
+ /**
33
+ * A rejected child run's thrown value, as the parent's tool layer receives it: the `same-principal` snapshot (every own member
34
+ * kept), with its `details.code` set to the answer face's account item — the engine word of its failure account, or no `code`
35
+ * member at all. The snapshot is what is read, so the thrown value is read once and the answer describes the copy the parent
36
+ * receives (a member that serializes itself is read as the copy reads it). Its `errorKind` stands, so the frame's lift
37
+ * (`details.code`, else `errorKind`) answers {@link childAnswerCode}.
38
+ */
9
39
  export declare const childRejection: (err: unknown) => unknown;
@@ -1,8 +1,32 @@
1
+ import { thrownFailureOf } from "../core/runner/terminal-account.js";
1
2
  import { terminalProjection } from "../core/runner/terminal-projection.js";
3
+ import { isPlainRecord } from "../core/mods/kernel/receive.js";
4
+ import { isEngineCodeShape, readMember, thrownMarksOf } from "../core/thrown-value.js";
2
5
  import { egressText, egressThrownText, egressValue } from "../core/untrusted-egress.js";
3
6
  export const childTerminalFace = (terminal) => {
4
7
  const face = terminalProjection(terminal);
5
8
  return typeof face.errorMessage === "string" ? { ...face, errorMessage: egressText("same-principal", face.errorMessage) } : face;
6
9
  };
7
10
  export const childThrownText = (err) => egressThrownText("same-principal", err);
8
- export const childRejection = (err) => egressValue("same-principal", err);
11
+ export function childFailureOf(err) {
12
+ const { code, detail } = thrownFailureOf(err, "");
13
+ const errorKind = thrownMarksOf(err)?.errorKind;
14
+ return { ...(code !== undefined ? { code } : {}), ...(typeof errorKind === "string" ? { errorKind } : {}), ...(detail !== undefined ? { detail } : {}) };
15
+ }
16
+ export const rejectedChildOf = (err) => ({ text: childThrownText(err), failure: childFailureOf(err) });
17
+ export const childRowCode = (f) => f.code ?? f.errorKind;
18
+ const engineCodeOf = (f) => (f.code !== undefined && isEngineCodeShape(f.code) ? f.code : undefined);
19
+ export const childAnswerCode = (f) => engineCodeOf(f) ?? f.errorKind;
20
+ export const childRejection = (err) => {
21
+ const snapshot = egressValue("same-principal", err);
22
+ if (snapshot === null || typeof snapshot !== "object")
23
+ return snapshot;
24
+ const code = engineCodeOf(childFailureOf(snapshot));
25
+ const details = readMember(snapshot, "details");
26
+ if (!isPlainRecord(details) && code === undefined)
27
+ return snapshot;
28
+ const bag = isPlainRecord(details) ? details : {};
29
+ const { code: _stated, ...rest } = bag;
30
+ Object.defineProperty(snapshot, "details", { value: code !== undefined ? { ...rest, code } : rest, enumerable: true, writable: true, configurable: true });
31
+ return snapshot;
32
+ };
@@ -7,7 +7,11 @@ import type { TaskResult } from "../core/types.js";
7
7
  * · the tree's fixed point (`RunInternals.placementRoot`): every later leg lands where the first leg landed — the first leg's
8
8
  * own report of the fixed point its prepare resolved (`TaskResult.placementRoot`). It is minted into the copy unless the
9
9
  * caller's object already resolves there by prepare's fold (`placementRoot`, else `rootSessionId`); on a fresh entry it
10
- * always does whenever the caller carries a fixed point, so that caller's object rides unchanged. The first leg is the one
10
+ * always does whenever the caller carries a fixed point, so that caller's object rides unchanged. A fresh entry whose caller
11
+ * carries none, over a task that names a host session, gives its first leg that session as the fixed point (the one value
12
+ * the first leg's own prepare would otherwise take from the leg it runs in, which is a session of its own when the entry
13
+ * strips the host's): the work is placed where a plain run of the same task would have been, and every later leg and every
14
+ * card reads it back from the first leg's report. A resume entry gives none — its card records the fixed point. The first leg is the one
11
15
  * the entry drove first: a resume entry's resumed leg reports the fixed point its parked row recorded, which outranks a
12
16
  * supplied `rootSessionId` there, so a caller whose `rootSessionId` names another session still sees every leg after it land
13
17
  * where the composition's work was placed, not at that session or the resumed leg's own. A first leg that reported none (a
@@ -26,4 +30,4 @@ export interface CompositionPlacement {
26
30
  /** The internals a later leg is dispatched with, given the first leg's result (its self-reported fixed point). */
27
31
  laterLeg(firstLeg: Pick<TaskResult, "placementRoot">): RunInternals | undefined;
28
32
  }
29
- export declare function compositionPlacement(internals: RunInternals | undefined): CompositionPlacement;
33
+ export declare function compositionPlacement(internals: RunInternals | undefined, hostSessionId?: string): CompositionPlacement;
@@ -1,8 +1,12 @@
1
- export function compositionPlacement(internals) {
1
+ export function compositionPlacement(internals, hostSessionId) {
2
2
  let observed = false;
3
3
  let firstTarget;
4
+ const declaredRoot = (bag) => bag?.placementRoot ?? bag?.rootSessionId ?? undefined;
5
+ const entry = internals === undefined ? undefined : { ...internals };
6
+ const hosted = declaredRoot(entry) === undefined ? hostSessionId : undefined;
4
7
  const firstLeg = {
5
- ...internals,
8
+ ...entry,
9
+ ...(hosted !== undefined ? { placementRoot: hosted } : {}),
6
10
  onWorkspaceResolved: (workspace) => {
7
11
  if (!observed) {
8
12
  observed = true;
@@ -15,7 +19,7 @@ export function compositionPlacement(internals) {
15
19
  firstLeg,
16
20
  laterLeg(first) {
17
21
  const landed = first.placementRoot;
18
- const root = landed !== undefined && (internals?.placementRoot ?? internals?.rootSessionId) !== landed ? landed : undefined;
22
+ const root = landed !== undefined && declaredRoot(internals) !== landed ? landed : undefined;
19
23
  if (root === undefined && firstTarget === undefined)
20
24
  return internals;
21
25
  return { ...internals, ...(root !== undefined ? { placementRoot: root } : {}), ...(firstTarget !== undefined ? { placementTarget: firstTarget } : {}) };
@@ -70,6 +70,14 @@ export declare function isCanonicalPeerAddress(address: string): boolean;
70
70
  /** design/385 §4.2 — the canonical `from-scope` attribute form of a raw scope string.
71
71
  * @throws CrossSessionCodecError on a non-string or a string with an unpaired surrogate. */
72
72
  export declare function encodeScopeAttribute(rawScope: string): string;
73
+ /**
74
+ * Can this raw scope be spelled as a `from-scope` attribute — a well-formed string (no unpaired surrogate) that is a NAME by the
75
+ * engine's one name reading ({@link principalNameOf}: visible content, no control or line / paragraph separator, no format character
76
+ * but the two joiners; a scope is a principal's storage scope, so it is judged as the principal it came from was), and at most
77
+ * the attribute's byte bound once percent-encoded? The ONE judgment the envelope builder and parser apply, exported so a host that
78
+ * admits a scope at its own entrance asks the same question instead of restating the rule or the bound (the bound itself stays private).
79
+ */
80
+ export declare function isSpellableFromScope(rawScope: string): boolean;
73
81
  /** Inverse of {@link encodeScopeAttribute}; `undefined` when the bytes are not valid percent-encoded
74
82
  * UTF-8 (the parser refuses the whole envelope on that). */
75
83
  export declare function decodeScopeAttribute(encoded: string): string | undefined;
@@ -102,7 +110,8 @@ export interface CrossSessionEnvelopeFields {
102
110
  */
103
111
  export declare function buildCrossSessionEnvelope(fields: CrossSessionEnvelopeFields, body: string): string;
104
112
  /** Why a parse refused: `not_an_envelope` (the strict grammar did not match at all), `bad_scope_encoding`
105
- * (a `from-scope` that is not valid percent-encoded UTF-8), `roundtrip_mismatch` (the grammar matched
113
+ * (a `from-scope` the codec cannot carry: not valid percent-encoded UTF-8, or one that decodes to a string
114
+ * {@link isSpellableFromScope} refuses — no name can be spelled that way), `roundtrip_mismatch` (the grammar matched
106
115
  * but the canonical re-serialization differs — a near-miss / non-canonical form). All three mean
107
116
  * "treat the text as ordinary data". */
108
117
  export type CrossSessionEnvelopeRefusal = "not_an_envelope" | "bad_scope_encoding" | "roundtrip_mismatch";
@@ -1,4 +1,5 @@
1
1
  import { ENGINE_AUTHORITY_ENVELOPE_TAGS, escapeEnvelopeTag, sanitizeUntrustedText } from "../core/untrusted-text.js";
2
+ import { principalNameOf } from "../core/principal-name.js";
2
3
  export const CROSS_SESSION_MESSAGE_TAG = "cross-session-message";
3
4
  const PEER_BODY_ENVELOPE_TAGS = [...ENGINE_AUTHORITY_ENVELOPE_TAGS];
4
5
  export function neutralizePeerBody(body) {
@@ -69,6 +70,9 @@ export function encodeScopeAttribute(rawScope) {
69
70
  assert(isScalarString(rawScope), "cross_session.invalid_from_scope", `a raw scope must be a well-formed string`);
70
71
  return percentEncode(rawScope, /[^A-Za-z0-9._-]/gu);
71
72
  }
73
+ export function isSpellableFromScope(rawScope) {
74
+ return isScalarString(rawScope) && principalNameOf(rawScope) !== undefined && FROM_SCOPE_ENCODED_RE.test(percentEncode(rawScope, /[^A-Za-z0-9._-]/gu));
75
+ }
72
76
  export function decodeScopeAttribute(encoded) {
73
77
  try {
74
78
  return decodeURIComponent(encoded);
@@ -107,7 +111,7 @@ export function buildCrossSessionEnvelope(fields, body) {
107
111
  }
108
112
  if (fields.fromScope !== undefined) {
109
113
  const encoded = encodeScopeAttribute(fields.fromScope);
110
- assert(FROM_SCOPE_ENCODED_RE.test(encoded), "cross_session.invalid_from_scope", `"from-scope" must be 1..${FROM_SCOPE_ENCODED_MAX_BYTES} bytes once percent-encoded`);
114
+ assert(isSpellableFromScope(fields.fromScope), "cross_session.invalid_from_scope", `"from-scope" must be a name (visible content, no control, separator or format character but the joiners) of 1..${FROM_SCOPE_ENCODED_MAX_BYTES} bytes once percent-encoded`);
111
115
  attrs.push(`from-scope="${encoded}"`);
112
116
  }
113
117
  const safeBody = escapeEnvelopeTag(CROSS_SESSION_MESSAGE_TAG, neutralizePeerBody(body));
@@ -129,7 +133,7 @@ export function parseCrossSessionEnvelope(text) {
129
133
  let fromScope;
130
134
  if (fromScopeEncoded !== undefined) {
131
135
  fromScope = decodeScopeAttribute(fromScopeEncoded);
132
- if (fromScope === undefined)
136
+ if (fromScope === undefined || !isSpellableFromScope(fromScope))
133
137
  return { ok: false, reason: "bad_scope_encoding" };
134
138
  }
135
139
  const fields = {
@@ -131,7 +131,13 @@ export declare function judgeCrossSessionInbound(input: CrossSessionInboundInput
131
131
  * blanket answering seat — the adapter's own reading of "nobody is watching");
132
132
  * · `"unknown"` — otherwise, when the ask derivation is `unresolved` (the judge fails closed on it);
133
133
  * · `prompting` — otherwise: an ask reaches a human or parks for one (`human_reachable`, `park_only`),
134
- * and — CC's literal rule for a never-prompting-never-bypassing mode — `auto_deny`.
134
+ * and — CC's literal rule for a never-prompting-never-bypassing mode — `auto_deny`; and the deployment's approval
135
+ * policy (`policy_reachable`), under that seat's contract: a policy approver gives no new allow — it relays an answer a
136
+ * person gave before, refuses, or answers `"unavailable"` so the ask parks for a person (a deployment that answers every
137
+ * ask yes installs the blanket `onAsk: "allow"`, which folds `bypass`). The real-approval demand enforces the contract
138
+ * mechanically on the asks that carry it; on the others it is the deployment's word. A seat that declares a class table
139
+ * ({@link import("../core/tool-policy.js").declareClassAnswers}) folds by its form like any seat — `prompting`: it answers
140
+ * the classes it declares by itself, and every other ask still reaches a person or parks for one.
135
141
  * `effective` absent (a leg with no mode fact) reads the ask derivation alone.
136
142
  *
137
143
  * WHAT THE CLASS IS: `fromMode` is a presence LABEL — whether a person is watching this session's approvals —
@@ -171,6 +171,7 @@ export function foldPermissionModeClass(effective, askEffective) {
171
171
  case "auto_allow":
172
172
  return "bypass";
173
173
  case "human_reachable":
174
+ case "policy_reachable":
174
175
  case "park_only":
175
176
  case "auto_deny":
176
177
  return "prompting";
@@ -1,4 +1,5 @@
1
1
  import type { TaskResult } from "../core/types.js";
2
+ import type { UsageLane } from "../core/runner/side-call-account.js";
2
3
  import type { CompositionSpend } from "./composition-allowance.js";
3
4
  /**
4
5
  * Shared CUMULATIVE-STATS constructor for the multi-leg agent compositions (cascade rungs, repair-loop
@@ -27,10 +28,38 @@ export interface CumulativeNestedTotals {
27
28
  * {@link TaskResult}, so a leg's entry passes through with `toolName`/`toolArg` intact.
28
29
  */
29
30
  export interface CumulativeHumanReviewTotals {
31
+ /** Some leg's result carried a ledger — the operation's result carries the sum then, `count: 0` included. */
32
+ kept: boolean;
30
33
  count: number;
31
34
  totalWaitMs: number;
32
35
  gates: NonNullable<TaskResult["stats"]["humanReview"]>["gates"];
33
36
  }
37
+ /** The usage sums a leg's stats may publish — each summed over the legs, and published on the cumulative stats exactly when some
38
+ * leg published it (a leg's 0 is a measured 0 and is kept; a member no leg published stays absent). */
39
+ declare const USAGE_SUM_KEYS: readonly ["promptTokens", "totalInputTokens", "cachedTokens", "outputTokens", "cacheWriteTokens", "cacheWriteTokensLong"];
40
+ type UsageSumKey = (typeof USAGE_SUM_KEYS)[number];
41
+ /**
42
+ * What the legs said about their usage beyond the sums, folded leg by leg ({@link foldUsageFacts}): which sums any leg published,
43
+ * the knownness marks — each the UNION over the legs (one leg that did not report makes the operation's figure unknown in the
44
+ * same way) — and the lanes a leg left out of its cache-hit rate, merged per lane with what they contributed. Held by every
45
+ * composition's fold (the tracker below, cascade, repair-loop), so the marks cannot be read off the last leg alone.
46
+ */
47
+ export interface CumulativeUsageFacts {
48
+ readonly published: Set<UsageSumKey>;
49
+ usageMissing: boolean;
50
+ cacheReadUnreported: boolean;
51
+ cacheWriteUnreported: boolean;
52
+ readonly cacheHitRateExcludes: Map<UsageLane, {
53
+ cachedTokens: number;
54
+ totalInputTokens: number;
55
+ }>;
56
+ /** Some leg published the rate's denominator (`totalInputTokens`) without its numerator (`cachedTokens`): the operation's
57
+ * cached-token sum is short by an unknown amount, so no rate is derived. */
58
+ rateNumeratorShort: boolean;
59
+ }
60
+ export declare function emptyCumulativeUsageFacts(): CumulativeUsageFacts;
61
+ /** Fold ONE leg's usage facts (call once per leg, beside the leg's sums). */
62
+ export declare function foldUsageFacts(facts: CumulativeUsageFacts, s: TaskResult["stats"]): void;
34
63
  /**
35
64
  * The running totals a multi-leg composition accumulates. Every field is REQUIRED: an optional field here
36
65
  * would re-open the exact "forgot to override one" hole this module exists to close — a caller that has
@@ -75,13 +104,17 @@ export interface CumulativeStatsAccumulator {
75
104
  sideCallMicroUsd?: number;
76
105
  nested: CumulativeNestedTotals;
77
106
  humanReview: CumulativeHumanReviewTotals;
107
+ /** The legs' usage facts beyond the sums (published members, the knownness marks, the lanes left out of a hit rate). */
108
+ usageFacts: CumulativeUsageFacts;
78
109
  }
79
110
  /**
80
111
  * Build the cumulative stats over a base (the FINAL leg's stats — it carries the non-accumulated fields
81
112
  * such as `model`) with every accumulated field overridden.
82
113
  *
83
- * `cacheHitRate` is RE-DERIVED from the cumulative cached/total-input totals rather than spread from the
84
- * base: a ratio is not additive, so the last leg's rate is never the operation's rate.
114
+ * `cacheHitRate` is RE-DERIVED from the cumulative totals rather than spread from the base: a ratio is not additive, so the
115
+ * last leg's rate is never the operation's rate. It is derived by the one identity a leg's rate obeys: the totals minus what
116
+ * the lanes left out contributed — a lane is left out where a leg left it out (that leg's calls on it did not report the
117
+ * ratio's operands); the same lane's calls in a leg that reported them all stay in.
85
118
  */
86
119
  export declare function buildCumulativeStats(base: TaskResult["stats"], acc: CumulativeStatsAccumulator): TaskResult["stats"];
87
120
  /** A running {@link CumulativeStatsAccumulator} with the per-leg fold built in. */
@@ -113,3 +146,4 @@ export interface CumulativeStatsTracker {
113
146
  * OWN and NESTED stay DISJOINT here too: `add` never folds a leg's `nested.*` into the own totals.
114
147
  */
115
148
  export declare function createCumulativeStatsTracker(): CumulativeStatsTracker;
149
+ export {};