@sema-agent/core 7.66.1 → 7.67.1

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 (904) hide show
  1. package/CHANGELOG.md +3518 -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 +169 -0
  71. package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
  362. package/dist/core/roles.js +148 -21
  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 +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -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 +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -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 +6 -5
  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 +19 -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 +126 -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 +64 -34
  730. package/dist/index.js +45 -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 +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -3,11 +3,14 @@ import { homedir } from "node:os";
3
3
  import { argsReadFrom, carryArgsReadFrom, withArgsReading } from "./effective-path-target.js";
4
4
  import { editRewrittenSentence, readRejudge, rewriteChasedSentence } from "./rewrite-rejudge.js";
5
5
  import { brandPolicyAskClass } from "./ask-class.js";
6
- import { decisionAskClassesOf, headlessDenialMessage, joinAskReasons, unresolvedAskDenialMessage } from "./ask-origin.js";
6
+ import { ASK_CLASSES, decisionAskClassesOf, headlessDenialMessage, joinAskReasons, MODE_ARBITRATION, unresolvedAskDenialMessage } from "./ask-origin.js";
7
7
  import { attest, attestationOf, engineSentenceOf, isEngineAttestation, mergeAttestation, mintAttestation, withAttestation } from "./engine-attestation.js";
8
8
  import { ownReadRootCandidate, readRootGrantSeat } from "./read-root-grant-screen.js";
9
+ import { liveWordsOf } from "./approval-words.js";
9
10
  import { DECIDED_VIA, decidersNote, isDecidedVia, policyDeciderOf, settledByDecider } from "./gate-outcome.js";
10
11
  import { unjudgedAllowRefused } from "./real-approval.js";
12
+ import { receiveMembers } from "./own-property-receipt.js";
13
+ import { isBlankInput } from "./input-author.js";
11
14
  export { policyCannotAnswer, rowDemandsAPerson } from "./real-approval.js";
12
15
  import { sanitizeAutoModeArmingRecipe } from "./auto-mode-arming.js";
13
16
  import { join, normalize as normalizePath, sep } from "node:path";
@@ -38,6 +41,16 @@ export function advertisedWritableRootsSeat(seat) {
38
41
  export function exemptRootsSeat(exemptRoots) {
39
42
  return { exemptRoots };
40
43
  }
44
+ export function callFactsSeat(f) {
45
+ return {
46
+ ...(f.cwd !== undefined ? { cwd: f.cwd } : {}),
47
+ ...(f.root !== undefined ? { root: f.root } : {}),
48
+ ...(f.face !== undefined ? { face: f.face } : {}),
49
+ ...(f.budget !== undefined ? { budget: f.budget } : {}),
50
+ ...advertisedWritableRootsSeat(f.advertisedWritableDirs),
51
+ ...(f.exemptRoots !== undefined ? exemptRootsSeat(f.exemptRoots) : {}),
52
+ };
53
+ }
41
54
  function settledByNobody(kind) {
42
55
  return { kind, who: { party: "none" }, when: Date.now() };
43
56
  }
@@ -79,6 +92,9 @@ export function screenApproverAttribution(v) {
79
92
  if (APPROVER_REFUSED_CHARS_RE.test(v)) {
80
93
  return { defect: "an approver attribution carries control characters, line separators or bidirectional overrides; an identifier whose bytes can forge a line — or reorder what a reader sees — in whatever renders it is refused" };
81
94
  }
95
+ if (isBlankInput(v)) {
96
+ return { defect: "an approver attribution of only whitespace names nobody; give an identifier with a visible character, or none at all (an empty string reads as none)" };
97
+ }
82
98
  return { approver: v };
83
99
  }
84
100
  export function screenDecidedVia(v, word) {
@@ -524,7 +540,7 @@ export function createApprovalPolicy(opts) {
524
540
  if (signal?.aborted)
525
541
  return abortedSeatDeny(req, `approval aborted for "${req.toolName}" (run or turn interrupted)`, "policy");
526
542
  if (typeof ok === "object" && ok !== null) {
527
- const reading = readApproverOutcomeObject(ok, req.toolName, "none");
543
+ const reading = readApproverOutcomeObject(ok, req.toolName, { editLane: "none", takesWords: false, isPolicy: false });
528
544
  if (reading.kind === "refused")
529
545
  return attest({ action: "deny", message: reading.message }, reading.settlement);
530
546
  if (reading.kind === "deny") {
@@ -777,17 +793,12 @@ export function createUnverifiableDeletePolicy(opts) {
777
793
  if (typeof command !== "string")
778
794
  return ALLOW;
779
795
  const removal = removalReadingOf(command, req, opts?.removalSeat, safeRoots);
780
- return removal === undefined ? ALLOW : removal.judge(signal).then((found) => (found === undefined ? ALLOW : removalAsk(req, found.guard, found.text)));
796
+ return removal === undefined ? ALLOW : removal.judge(signal).then((found) => (found === undefined ? ALLOW : removalAsk(req, found)));
781
797
  },
782
798
  }, "external_authority");
783
799
  }
784
- function removalAsk(req, guard, text) {
785
- const messages = {
786
- dangerous_delete: `Dangerous removal: ${text}. No permission mode, allow rule or classifier clears this — only a person confirming this call does.`,
787
- unverifiable_delete: `Unverifiable recursive delete (fail-closed unless cleared): ${text}. Re-run the delete with the resolved literal path written into the command itself (or assign the variable a literal path in the same command, e.g. \`DIR=/exact/path; rm -rf "$DIR"\`) so the target can be verified.`,
788
- unverifiable_shell_text: `Unverifiable shell text (fail-closed unless cleared): ${text}.`,
789
- };
790
- return attest({ action: "ask", decisionReason: "safety", requiresRealApproval: true, message: messages[guard] }, req, { guards: [guard] });
800
+ function removalAsk(req, verdict) {
801
+ return attest({ action: "ask", decisionReason: "safety", requiresRealApproval: true, message: verdict.text }, req, { guards: [verdict.guard], sentence: { text: verdict.text, guard: verdict.guard } });
791
802
  }
792
803
  function pathSegments(p) {
793
804
  return p.split(/[\\/]/).filter(Boolean);
@@ -856,15 +867,13 @@ export function createTranscriptIntegrityPolicy(opts) {
856
867
  }
857
868
  return false;
858
869
  };
859
- const askReason = (req, what) => attest({
860
- action: "ask",
861
- decisionReason: "safety",
862
- requiresRealApproval: true,
863
- message: `Session-transcript write (fail-closed unless cleared): ${what}. Session transcripts (the .jsonl files ` +
870
+ const askReason = (req, what) => {
871
+ const message = `Session-transcript write (fail-closed unless cleared): ${what}. Session transcripts (the .jsonl files ` +
864
872
  `under the agent data dir's sessions/ directory) are harness-written session state, not agent working ` +
865
873
  `files — modifying or deleting them tampers with the run's own audit trail. Reading them (ls/cat/grep ` +
866
- `as a single simple command) is fine.`,
867
- }, req, { guards: ["transcript_write"] });
874
+ `as a single simple command) is fine.`;
875
+ return attest({ action: "ask", decisionReason: "safety", requiresRealApproval: true, message }, req, { guards: ["transcript_write"], sentence: { text: message, guard: "transcript_write" } });
876
+ };
868
877
  return brandPolicyAskClass({
869
878
  check(req) {
870
879
  if (shellToolsListHolds(shellTools, req)) {
@@ -892,17 +901,71 @@ export function createTranscriptIntegrityPolicy(opts) {
892
901
  }, "external_authority");
893
902
  }
894
903
  const delegatedApproverRoot = new WeakMap();
895
- export function withDelegationProvenance(onAsk, delegation) {
904
+ export function wrapApprover(onAsk, wrap) {
896
905
  if (typeof onAsk !== "function")
897
906
  return onAsk;
898
- const wrapper = (req, signal) => req.delegation !== undefined ? onAsk(req, signal) : onAsk({ ...req, delegation }, signal);
907
+ const wrapper = wrap(onAsk);
899
908
  delegatedApproverRoot.set(wrapper, askApproverIdentity(onAsk));
900
909
  return wrapper;
901
910
  }
911
+ export function withDelegationProvenance(onAsk, delegation) {
912
+ return wrapApprover(onAsk, (approver) => (req, signal) => (req.delegation !== undefined ? approver(req, signal) : approver({ ...req, delegation }, signal)));
913
+ }
914
+ const policyApprovers = new WeakSet();
915
+ export function asPolicyApprover(fn) {
916
+ if (typeof fn !== "function")
917
+ throw new TypeError(`asPolicyApprover takes an approver function, not ${fn === null ? "null" : typeof fn}`);
918
+ policyApprovers.add(askApproverIdentity(fn));
919
+ return fn;
920
+ }
921
+ export function isPolicyApprover(v) {
922
+ return typeof v === "function" && policyApprovers.has(askApproverIdentity(v));
923
+ }
924
+ const classAnswerTables = new WeakMap();
925
+ const CLASS_ANSWER_KEYS = Object.freeze(["classes", "approver"]);
926
+ const CLASS_ANSWER_WORDS = Object.freeze({ subject: "declareClassAnswers's answers", unit: "member", moment: "at the declaration" });
927
+ export function declareClassAnswers(seat, answers) {
928
+ if (typeof seat !== "function")
929
+ throw new TypeError(`declareClassAnswers takes an approver function, not ${seat === null ? "null" : typeof seat}`);
930
+ if (typeof answers !== "object" || answers === null || Array.isArray(answers))
931
+ throw new TypeError(`declareClassAnswers takes { classes, approver }, not ${answers === null ? "null" : Array.isArray(answers) ? "an array" : typeof answers}`);
932
+ const { classes: declared, approver: named } = receiveMembers(answers, CLASS_ANSWER_WORDS, CLASS_ANSWER_KEYS, (message) => new TypeError(`declareClassAnswers: ${message}`));
933
+ if (!Array.isArray(declared) || declared.length === 0)
934
+ throw new TypeError("declareClassAnswers: `classes` must be a non-empty array of ask classes");
935
+ const listed = Array.from(declared);
936
+ for (const c of listed) {
937
+ if (typeof c !== "string" || !ASK_CLASSES.includes(c))
938
+ throw new TypeError(`declareClassAnswers: ${describeRejectedValue(c)} is not an ask class (ASK_CLASSES)`);
939
+ if (!MODE_ARBITRATION[c].ruleMayClear)
940
+ throw new TypeError(`declareClassAnswers: the ask class "${c}" is one no standing rule may clear (MODE_ARBITRATION.${c}.ruleMayClear is false); a class table may hold only the classes the allow layer itself may answer`);
941
+ }
942
+ const screened = screenApproverAttribution(named);
943
+ if (screened.defect !== undefined)
944
+ throw new TypeError(`declareClassAnswers: \`approver\` refused — ${screened.defect}`);
945
+ if (screened.approver === undefined)
946
+ throw new TypeError("declareClassAnswers: `approver` must name the seat that answers (a non-empty closed word the host owns)");
947
+ const table = Object.freeze({ classes: Object.freeze(ASK_CLASSES.filter((c) => listed.includes(c))), approver: screened.approver });
948
+ const minted = (req, signal) => declaredClassAnswer(minted, req.classes) ?? seat(req, signal);
949
+ classAnswerTables.set(minted, table);
950
+ return minted;
951
+ }
952
+ export function declaredClassAnswer(onAsk, classes) {
953
+ if (typeof onAsk !== "function")
954
+ return undefined;
955
+ const table = classAnswerTables.get(askApproverIdentity(onAsk));
956
+ if (table === undefined || !Array.isArray(classes) || classes.length === 0)
957
+ return undefined;
958
+ if (!classes.every((c) => table.classes.includes(c)))
959
+ return undefined;
960
+ return { allow: true, settledBy: "policy", approver: table.approver };
961
+ }
962
+ export function declaredAnswerClassesOf(onAsk) {
963
+ return typeof onAsk === "function" ? classAnswerTables.get(askApproverIdentity(onAsk))?.classes : undefined;
964
+ }
902
965
  export function askApproverIdentity(onAsk) {
903
966
  return typeof onAsk === "function" ? (delegatedApproverRoot.get(onAsk) ?? onAsk) : onAsk;
904
967
  }
905
- export function isLiveApproverSeat(onAsk) {
968
+ export function isAnsweringSeat(onAsk) {
906
969
  return typeof onAsk === "function";
907
970
  }
908
971
  export const DURABLE_MANDATE_SOURCES = Object.freeze(["force_durable_gate", "durable_approval"]);
@@ -910,12 +973,20 @@ Object.freeze(DURABLE_MANDATE_SOURCES);
910
973
  export function durableMandateSourceOf(args) {
911
974
  if (args.forceDurableGate)
912
975
  return "force_durable_gate";
913
- if (args.durableApprovalDeclared && !isLiveApproverSeat(args.onAsk))
976
+ if (args.durableApprovalDeclared && !isAnsweringSeat(args.onAsk))
914
977
  return "durable_approval";
915
978
  return undefined;
916
979
  }
917
980
  export function durableParkOptInDeclared(args) {
918
- return args.forceDurableGate || args.durableApprovalDeclared;
981
+ return !args.approvalParkNotResumable && (args.durableApprovalDeclared || args.forceDurableGate);
982
+ }
983
+ export function approvalParkNotResumableOf(leg) {
984
+ return leg.delegated && !leg.durableApprovalDeclared;
985
+ }
986
+ export function effectiveDurableApprovalOf(args) {
987
+ if (!durableParkOptInDeclared({ forceDurableGate: args.forceDurableGate, durableApprovalDeclared: args.declared !== undefined, approvalParkNotResumable: args.approvalParkNotResumable }))
988
+ return undefined;
989
+ return args.declared ?? { scope: args.scope };
919
990
  }
920
991
  export function tryCloneArgs(v) {
921
992
  try {
@@ -1131,15 +1202,23 @@ export function carriesBidiControls(value, limits) {
1131
1202
  return false;
1132
1203
  }
1133
1204
  }
1205
+ export function cardCarriesBidiControls(card) {
1206
+ return carriesBidiControls(card.args) || carriesBidiControls(card.preview) || carriesBidiControls(card.existingTarget);
1207
+ }
1134
1208
  export async function resolveAsk(req, onAsk, signal, onLateSettlement) {
1135
1209
  return resolveAskFor(req, onAsk, signal, onLateSettlement, undefined);
1136
1210
  }
1137
- export async function resolveAskFor(req, onAsk, signal, onLateSettlement, asked) {
1211
+ export async function resolveAskFor(req, onAsk, signal, onLateSettlement, asked, onApproverDefect, approvalWords) {
1138
1212
  const askedDigest = exactBoundInputHashOf(req.toolName, req.args);
1139
1213
  const question = asked !== undefined ? engineSentenceOf(asked, req) : undefined;
1140
- const { settlement, bindingRefusal, quotesQuestion, ...r } = await resolveAskArms(req, onAsk, signal, onLateSettlement);
1214
+ const { settlement, bindingRefusal, quotesQuestion, feedback: words, ...r } = await resolveAskArms(req, onAsk, signal, onLateSettlement, approvalWords !== undefined);
1215
+ if (words !== undefined)
1216
+ await approvalWords?.(words);
1141
1217
  if (settlement === undefined)
1142
1218
  return r;
1219
+ if (onApproverDefect !== undefined && (settlement.kind === "approver_error" || settlement.kind === "approver_contract")) {
1220
+ onApproverDefect({ cause: settlement.kind === "approver_error" ? "threw" : "out_of_contract", seat: isPolicyApprover(onAsk) ? "policy" : "approver" });
1221
+ }
1143
1222
  const echoed = quotesQuestion === true && question?.echoed !== undefined && req.message === question.text && r.message !== undefined ? question.echoed : undefined;
1144
1223
  const licensedDigest = r.action === "allow" && r.updatedInput !== undefined ? exactBoundInputHashOf(req.toolName, r.updatedInput) : r.presentedInput !== undefined ? exactBoundInputHashOf(req.toolName, r.presentedInput) : askedDigest;
1145
1224
  return attest(r, req, { settlement, ...(req.origin !== undefined ? { origin: req.origin } : {}), ...(req.classes !== undefined ? { classes: req.classes } : {}), ...(licensedDigest !== undefined ? { inputDigest: licensedDigest } : {}), ...(bindingRefusal !== undefined ? { bindingRefusal } : {}), ...(echoed !== undefined ? { sentence: { text: r.message, echoed } } : {}) });
@@ -1189,7 +1268,7 @@ function detachLateAskWait(wait, onLate) {
1189
1268
  })
1190
1269
  .catch(() => undefined);
1191
1270
  }
1192
- function readApproverOutcomeObject(ok, toolName, editLane) {
1271
+ function readApproverOutcomeObject(ok, toolName, seat) {
1193
1272
  const refused = (message, settlement) => ({ kind: "refused", message, settlement });
1194
1273
  let supplied;
1195
1274
  let allowed;
@@ -1197,6 +1276,7 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
1197
1276
  let suppliedApprover;
1198
1277
  let suppliedVia;
1199
1278
  let grant;
1279
+ let feedback;
1200
1280
  try {
1201
1281
  supplied = ok.settledBy;
1202
1282
  allowed = ok.allow;
@@ -1204,6 +1284,7 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
1204
1284
  suppliedApprover = ok.approver;
1205
1285
  suppliedVia = ok.decidedVia;
1206
1286
  grant = ok.readRootGrant;
1287
+ feedback = ok.feedback;
1207
1288
  }
1208
1289
  catch (err) {
1209
1290
  return refused(`the approver's outcome for "${toolName}" could not be read (${describeThrown(err)}) — denied fail-closed`, settledByNobody("approver_contract"));
@@ -1225,10 +1306,14 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
1225
1306
  if (via.defect !== undefined) {
1226
1307
  return refused(`the approver for "${toolName}" reported a decidedVia this seam refuses: ${via.defect}; denied fail-closed`, settledByNobody("approver_contract"));
1227
1308
  }
1228
- if (editLane === "none" && grant !== undefined) {
1309
+ if (seat.editLane === "none" && grant !== undefined) {
1229
1310
  return refused(`the approver for "${toolName}" attached a readRootGrant on a seat that offers no directory — denied fail-closed (a grant answers an approval card's readRootCandidate)`, settledByNobody("approver_contract"));
1230
1311
  }
1231
1312
  const decider = settledWord === "policy" ? "policy" : settledWord === "human" ? "person" : undefined;
1313
+ const live = liveWordsOf(feedback, { toolName, allowed, byPerson: decider === "person" && !seat.isPolicy, hasCarrier: seat.takesWords });
1314
+ if (live.kind === "refused")
1315
+ return refused(live.message, settledByNobody("approver_contract"));
1316
+ const words = live.words;
1232
1317
  if (allowed !== true) {
1233
1318
  let reasonText;
1234
1319
  try {
@@ -1258,8 +1343,8 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
1258
1343
  `(report "${settledWord}" with allow:false; a person's allow is settledBy "human"/omitted, the deployment policy's is "policy")`, settledByNobody("approver_contract"));
1259
1344
  }
1260
1345
  if (suppliedEdit === undefined)
1261
- return { kind: "allow", edit: undefined, settlement: settledByDecider(decider, "allowed", attribution.approver), grant };
1262
- if (editLane === "none") {
1346
+ return { kind: "allow", edit: undefined, settlement: settledByDecider(decider, "allowed", attribution.approver), grant, words };
1347
+ if (seat.editLane === "none") {
1263
1348
  return refused(`the approver for "${toolName}" attached an edit (updatedInput) on a seat that has no lane to adjudicate one — ` +
1264
1349
  `this seat's answer is the deployment POLICY's verdict, and an edit arriving through it would execute without the ` +
1265
1350
  `re-adjudication an approver's edit gets; denied fail-closed (approve or refuse what was shown, and route edits ` +
@@ -1268,9 +1353,9 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
1268
1353
  const edit = bindableArgsOf(toolName, suppliedEdit);
1269
1354
  if (!edit.ok)
1270
1355
  return { kind: "refused", message: edit.refusal, settlement: settledByNobody("presentation_failed"), binding: true };
1271
- return { kind: "allow", edit: { value: edit.value }, settlement: settledByDecider(decider, "allowed", attribution.approver), grant };
1356
+ return { kind: "allow", edit: { value: edit.value }, settlement: settledByDecider(decider, "allowed", attribution.approver), grant, words };
1272
1357
  }
1273
- async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
1358
+ async function resolveAskArms(req, onAsk, signal, onLateSettlement, takesWords = false) {
1274
1359
  if (onAsk === "allow") {
1275
1360
  if (req.requiresRealApproval === true)
1276
1361
  return { ...unjudgedAllowRefused(req, "blanket"), ...quotingQuestion };
@@ -1293,48 +1378,52 @@ async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
1293
1378
  if (!presented.ok)
1294
1379
  return { action: "deny", message: presented.refusal, decisionReason: "mode", settlement: settledByNobody("presentation_failed"), bindingRefusal: presented.refusal };
1295
1380
  const offered = ownReadRootCandidate(req.readRootCandidate);
1381
+ const declared = declaredClassAnswer(onAsk, req.classes);
1296
1382
  let ok;
1297
- try {
1298
- const approverView = { value: structuredClone(presented.value) };
1299
- const reconciliationHash = exactBoundInputHashOf(req.toolName, presented.value);
1300
- const bidi = carriesBidiControls(presented.value) || carriesBidiControls(req.preview);
1301
- const { hasBidiControls: _carried, boundInputHash: _claimed, ...bare } = req;
1302
- const wait = Promise.resolve(onAsk({
1303
- ...bare,
1304
- ...(reconciliationHash !== undefined ? { boundInputHash: reconciliationHash } : {}),
1305
- args: approverView.value,
1306
- ...(bidi ? { hasBidiControls: true } : {}),
1307
- ...(offered !== undefined ? { readRootCandidate: { ...offered } } : {}),
1308
- }, signal));
1309
- const windowMs = req.denialLimitFallback !== undefined && req.denialLimitFallback.autoDenyAfterMs > 0 ? req.denialLimitFallback.autoDenyAfterMs : undefined;
1310
- const raced = await withTimeout(raceAskWaitAgainstSignal(wait, signal), windowMs, () => DEADLINE_ELAPSED);
1311
- if (raced === DEADLINE_ELAPSED) {
1312
- detachLateAskWait(wait, onLateSettlement);
1383
+ if (declared !== undefined)
1384
+ ok = declared;
1385
+ else
1386
+ try {
1387
+ const approverView = { value: structuredClone(presented.value) };
1388
+ const reconciliationHash = exactBoundInputHashOf(req.toolName, presented.value);
1389
+ const bidi = cardCarriesBidiControls({ args: presented.value, preview: req.preview, existingTarget: req.existingTarget });
1390
+ const { hasBidiControls: _carried, boundInputHash: _claimed, ...bare } = req;
1391
+ const wait = Promise.resolve(onAsk({
1392
+ ...bare,
1393
+ ...(reconciliationHash !== undefined ? { boundInputHash: reconciliationHash } : {}),
1394
+ args: approverView.value,
1395
+ ...(bidi ? { hasBidiControls: true } : {}),
1396
+ ...(offered !== undefined ? { readRootCandidate: { ...offered } } : {}),
1397
+ }, signal));
1398
+ const windowMs = req.denialLimitFallback !== undefined && req.denialLimitFallback.autoDenyAfterMs > 0 ? req.denialLimitFallback.autoDenyAfterMs : undefined;
1399
+ const raced = await withTimeout(raceAskWaitAgainstSignal(wait, signal), windowMs, () => DEADLINE_ELAPSED);
1400
+ if (raced === DEADLINE_ELAPSED) {
1401
+ detachLateAskWait(wait, onLateSettlement);
1402
+ return {
1403
+ action: "deny",
1404
+ message: `no one answered the classifier denial-limit approval for "${req.toolName}" — the ${String(windowMs)}ms window ` +
1405
+ `elapsed with no answer; auto-denied: ${req.message}`,
1406
+ decisionReason: "mode",
1407
+ settlement: { kind: "denial_limit_window_expired", who: { party: "engine", window: "denial_limit" }, when: Date.now() },
1408
+ ...quotingQuestion,
1409
+ };
1410
+ }
1411
+ if (raced.tag === "aborted") {
1412
+ detachLateAskWait(wait, onLateSettlement);
1413
+ return { action: "deny", message: `approval aborted for "${req.toolName}" (run or turn interrupted)`, decisionReason: "mode", settlement: settledByNobody("task_aborted") };
1414
+ }
1415
+ if (raced.tag === "threw")
1416
+ throw raced.error;
1417
+ ok = raced.value;
1418
+ }
1419
+ catch (err) {
1313
1420
  return {
1314
1421
  action: "deny",
1315
- message: `no one answered the classifier denial-limit approval for "${req.toolName}" — the ${String(windowMs)}ms window ` +
1316
- `elapsed with no answer; auto-denied: ${req.message}`,
1422
+ message: `approval errored for "${req.toolName}": ${describeThrown(err)}`,
1317
1423
  decisionReason: "mode",
1318
- settlement: { kind: "denial_limit_window_expired", who: { party: "engine", window: "denial_limit" }, when: Date.now() },
1319
- ...quotingQuestion,
1424
+ settlement: settledByNobody("approver_error"),
1320
1425
  };
1321
1426
  }
1322
- if (raced.tag === "aborted") {
1323
- detachLateAskWait(wait, onLateSettlement);
1324
- return { action: "deny", message: `approval aborted for "${req.toolName}" (run or turn interrupted)`, decisionReason: "mode", settlement: settledByNobody("task_aborted") };
1325
- }
1326
- if (raced.tag === "threw")
1327
- throw raced.error;
1328
- ok = raced.value;
1329
- }
1330
- catch (err) {
1331
- return {
1332
- action: "deny",
1333
- message: `approval errored for "${req.toolName}": ${describeThrown(err)}`,
1334
- decisionReason: "mode",
1335
- settlement: settledByNobody("approver_error"),
1336
- };
1337
- }
1338
1427
  if (signal?.aborted) {
1339
1428
  return { action: "deny", message: `approval aborted for "${req.toolName}" (run or turn interrupted)`, decisionReason: "mode", settlement: settledByNobody("task_aborted") };
1340
1429
  }
@@ -1348,11 +1437,12 @@ async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
1348
1437
  ...quotingQuestion,
1349
1438
  };
1350
1439
  }
1440
+ const allowWithoutAPerson = (party) => req.requiresRealApproval === true && (party === "policy" || isPolicyApprover(onAsk));
1351
1441
  if (typeof ok === "object" && ok !== null) {
1352
- const reading = readApproverOutcomeObject(ok, req.toolName, "readjudicated");
1442
+ const reading = readApproverOutcomeObject(ok, req.toolName, { editLane: "readjudicated", takesWords, isPolicy: isPolicyApprover(onAsk) });
1353
1443
  if (reading.kind === "refused")
1354
1444
  return { action: "deny", message: reading.message, decisionReason: "mode", settlement: reading.settlement, ...(reading.binding === true ? { bindingRefusal: reading.message } : {}) };
1355
- if (reading.kind === "allow" && reading.settlement.who.party === "policy" && req.requiresRealApproval === true) {
1445
+ if (reading.kind === "allow" && allowWithoutAPerson(reading.settlement.who.party)) {
1356
1446
  return { ...unjudgedAllowRefused(req, "policy"), ...quotingQuestion, ...readRootGrantSeat(reading.grant, offered, false) };
1357
1447
  }
1358
1448
  const grantSeat = readRootGrantSeat(reading.grant, offered, reading.kind === "allow");
@@ -1370,13 +1460,17 @@ async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
1370
1460
  ...grantSeat,
1371
1461
  };
1372
1462
  }
1463
+ const words = reading.words !== undefined ? { feedback: reading.words } : {};
1373
1464
  if (reading.edit === undefined)
1374
- return { action: "allow", decisionReason: "mode", presentedInput: presented.value, settlement: reading.settlement, ...grantSeat };
1375
- return { action: "allow", updatedInput: reading.edit.value, decisionReason: "mode", settlement: reading.settlement, ...grantSeat };
1465
+ return { action: "allow", decisionReason: "mode", presentedInput: presented.value, settlement: reading.settlement, ...grantSeat, ...words };
1466
+ return { action: "allow", updatedInput: reading.edit.value, decisionReason: "mode", settlement: reading.settlement, ...grantSeat, ...words };
1376
1467
  }
1377
1468
  const okRaw = ok;
1378
- if (okRaw === true)
1469
+ if (okRaw === true) {
1470
+ if (allowWithoutAPerson("person"))
1471
+ return { ...unjudgedAllowRefused(req, "policy"), ...quotingQuestion };
1379
1472
  return { action: "allow", decisionReason: "mode", presentedInput: presented.value, settlement: settledByDecider("person", "allowed", undefined) };
1473
+ }
1380
1474
  if (okRaw !== false) {
1381
1475
  return {
1382
1476
  action: "deny",
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * The static tool catalog's READ FACE (design/388 §2.1): `describeToolCatalog()` and the predicates
3
3
  * every former name table is now DERIVED from. Readable without an env, a deps object or a tool
4
- * instance — a host predicts a leg's roster from it (`predictMountedToolNames`), a policy module
5
- * derives its covered set from it, a shell renders it.
4
+ * instance — a policy module derives its covered set from it, a shell renders it. (Which definitions a leg MOUNTS is the
5
+ * mount table's answer, `describeStaticWiring(deps, spec).toolPlan`, not the catalog's.)
6
6
  *
7
7
  * Every predicate here answers over DEFINITIONS and folds to names with "any definition under this
8
8
  * name matches" — the rule that pins the two fail-open shapes a per-name table had (one name, two
@@ -10,7 +10,7 @@
10
10
  *
11
11
  * Layer-0 vocabulary: depends on the leaf catalog and the face vocabulary only.
12
12
  */
13
- import { type ToolCallPathTarget, type ToolCatalogEntry, type ToolFamily, type ToolHostTarget, type ToolMountTag, type ToolPathAccess } from "./tool-face.js";
13
+ import { type ToolCallPathTarget, type ToolCatalogEntry, type ToolFamily, type ToolHostTarget, type ToolPathAccess } from "./tool-face.js";
14
14
  /** The whole static catalog, one frozen row per definition (design/388 §2.1 `describeToolCatalog()`).
15
15
  * Replaces the retired name-keyed exports `HAND_TOOL_EFFECTS` / `DEFAULT_BUDGET_EXEMPT_TOOLS` /
16
16
  * `COMPACTABLE_TOOLS`: filter this instead (`e.mountedBy.includes("hands")`, `e.face.budgetExempt`,
@@ -21,7 +21,7 @@ export declare function catalogEntriesNamed(name: string): readonly ToolCatalogE
21
21
  /** Every wire name the catalog knows, aliases included (a set — the two shells fold to one name). */
22
22
  export declare function catalogToolNames(): ReadonlySet<string>;
23
23
  /** A-11/12/13/14 — tools this engine can CONFINE BY PATH on a write: `pathTarget.access ≠ read`.
24
- * Today {Write, Edit, NotebookEdit}. */
24
+ * Today {Write, Edit, NotebookEdit, SaveToolResult}. */
25
25
  export declare function pathConfinableWriteToolNames(): ReadonlySet<string>;
26
26
  /**
27
27
  * What the persistence judge reads off ONE tool: its name and the three face members (all optional — a mounted
@@ -191,13 +191,6 @@ export declare function handBandEffects(): ReadonlyMap<string, NonNullable<ToolC
191
191
  /** A-3 / L4 — every `details.type` card the engine owns: the catalog's per-definition cards plus the
192
192
  * engine-minted ones (protocol channels, fs refusals). */
193
193
  export declare function engineCardTypes(): ReadonlySet<string>;
194
- /**
195
- * L3 — the STATIC PREDICTION of a leg's core-mounted names for a set of active mount conditions:
196
- * every definition listed under at least one active tag. `scenario` and `optional` definitions mount
197
- * only when the vector names their tag (a host factory / a per-task opt-in decides them). Names are
198
- * folded (the two shells predict one `Bash`).
199
- */
200
- export declare function predictMountedToolNames(active: ReadonlySet<ToolMountTag>): ReadonlySet<string>;
201
194
  /** The closed set as a Set, for callers that validate a tag read off the wire. */
202
195
  export declare const TOOL_MOUNT_TAG_SET: ReadonlySet<string>;
203
196
  export { HANDS_BAND_TAGS, MOUNT_TAG_IN_HANDS_BAND } from "./tool-face.js";
@@ -167,8 +167,5 @@ export function engineCardTypes() {
167
167
  out.add(card);
168
168
  return out;
169
169
  }
170
- export function predictMountedToolNames(active) {
171
- return names((e) => e.mountedBy.some((t) => active.has(t)));
172
- }
173
170
  export const TOOL_MOUNT_TAG_SET = new Set(TOOL_MOUNT_TAGS);
174
171
  export { HANDS_BAND_TAGS, MOUNT_TAG_IN_HANDS_BAND } from "./tool-face.js";
@@ -0,0 +1,94 @@
1
+ /**
2
+ * Bytes a tool result carried that the model cannot receive as content, kept as an entry of the run's offload store (its byte
3
+ * arm, `ToolResultStore.putBytes`) and named to the model by ref: the same holder, the same lifetime (the session's deletion, the
4
+ * store's age bound, its orphan leg) and the same reference form as an offloaded text result. Two suppliers reach the one keep:
5
+ * a media block the tool-result seat refused for its SIZE (`image-admission.ts`), and an MCP server's binary content that is not
6
+ * media the model reads (an audio block, a resource blob of another type; `mcp.ts`).
7
+ *
8
+ * A keep answers one of two things: kept (the ref), or not kept for one reason of a closed set. The line the model reads is made
9
+ * of those words only — never a store's error text, which names the store's own paths; that text goes to the operator's account.
10
+ * Nothing falls back to a directory of the engine's host: a second holder is a second lifetime nobody deletes.
11
+ *
12
+ * A leaf (no value import): the media admission reaches the keep through a {@link ToolResultBytesKeeper} it is handed, so its
13
+ * evaluation stays below the store, the tools and the prompt assembly the store's own tool face loads.
14
+ */
15
+ import type { ToolResultStore } from "./tool-result-store.js";
16
+ /** The longest claimed media type a sentence repeats; a longer one is named by its length. Long enough for the registered names a
17
+ * binary result really carries (office document types run to 73 characters, their part types past 80), short enough that a
18
+ * "type" carries no paragraph. */
19
+ export declare const MEDIA_TYPE_ECHO_MAX = 100;
20
+ /**
21
+ * A claimed media type as a sentence may repeat it: only when it can be one (RFC 6838 restricted names: no space, at most
22
+ * 127 characters a side) and is at most {@link MEDIA_TYPE_ECHO_MAX} characters — a "type" is never a carrier for text.
23
+ * `undefined` otherwise.
24
+ */
25
+ export declare function mediaTypeEcho(mime: unknown): string | undefined;
26
+ /** A claimed media type in a sentence: the type itself when {@link mediaTypeEcho} repeats it, else its length, else
27
+ * `unknown type` when none was claimed. */
28
+ export declare function mediaTypePhrase(mime: unknown): string;
29
+ /** The largest single piece of bytes a run keeps (100 MiB, the reference's per-blob persist bound); a larger one is not kept. */
30
+ export declare const TOOL_RESULT_BYTES_KEEP_LIMIT = 104857600;
31
+ /** The tool that writes kept bytes into a file of the run's environment (mounted beside the run's write tools). */
32
+ export declare const SAVE_TOOL_RESULT_NAME = "SaveToolResult";
33
+ /** Why bytes were not kept — the closed set every model-visible "not kept" line is made of:
34
+ * `no_byte_store` (the run has no offload store, or its store has no byte arm), `over_limit` (over
35
+ * {@link TOOL_RESULT_BYTES_KEEP_LIMIT}), `store_failed` (the store's write threw). */
36
+ export type BytesNotKeptReason = "no_byte_store" | "over_limit" | "store_failed";
37
+ /** What keeping one piece of bytes came to, as the operator's account carries it: its size, its claimed type when
38
+ * {@link mediaTypeEcho} repeats it, and either the ref it is kept under or why it is not (with the store's own error text when
39
+ * the store refused it — that text is the operator's, never the model's). */
40
+ export type KeptBytes = {
41
+ readonly bytes: number;
42
+ readonly mimeType?: string;
43
+ readonly ref: string;
44
+ } | {
45
+ readonly bytes: number;
46
+ readonly mimeType?: string;
47
+ readonly notKept: "no_byte_store" | "over_limit";
48
+ } | {
49
+ readonly bytes: number;
50
+ readonly mimeType?: string;
51
+ readonly notKept: "store_failed";
52
+ readonly saveError: string;
53
+ };
54
+ /** Whether the run's model can write kept bytes into a file: {@link SAVE_TOOL_RESULT_NAME} callable now, mounted but not active yet
55
+ * (behind the tool search), or not mounted at all (no offload store with a byte arm, no write hands, or the leg's valve). */
56
+ export type SaveToolResultReach = "callable" | "deferred" | "absent";
57
+ /** The reach of {@link SAVE_TOOL_RESULT_NAME} over a run's tools as its valve leaves them (`mounted`) and the set callable now
58
+ * (`callable`; `undefined` when the run defers nothing, so every mounted tool is callable). */
59
+ export declare function saveToolResultReach(mounted: readonly {
60
+ readonly name: string;
61
+ }[], callable: ReadonlySet<string> | undefined): SaveToolResultReach;
62
+ /**
63
+ * Where a run keeps bytes: the offload store and the session its refs are minted under (absent store ⇒ nothing is kept), and how
64
+ * the run's model can write kept bytes to a file (absent ⇒ it cannot). Plain data — a library caller wiring a tool surface itself
65
+ * hands its own store here; a seat it does not hand over keeps nothing.
66
+ */
67
+ export interface ToolResultBytesSeat {
68
+ readonly store?: ToolResultStore;
69
+ readonly sessionId: string;
70
+ readonly saveReach?: () => SaveToolResultReach;
71
+ }
72
+ /** The facts every {@link KeptBytes} carries for one piece: its size, and its claimed type when {@link mediaTypeEcho} repeats it. */
73
+ export declare function keptBytesFacts(bytes: Uint8Array, mimeType: unknown): {
74
+ readonly bytes: number;
75
+ readonly mimeType?: string;
76
+ };
77
+ /** The clause a model-visible line ends with for bytes that were NOT kept — the reason's closed words and numbers only (the
78
+ * kept clause, which names the ref and how the run can write it to a file, is `keptBytesClause` in `tool-result-store.ts`). */
79
+ export declare function notKeptClause(kept: Exclude<KeptBytes, {
80
+ readonly ref: string;
81
+ }>): string;
82
+ /** What keeping one piece of bytes came to, and the clause the line naming it ends with. */
83
+ export interface KeptBytesAnswer {
84
+ readonly kept: KeptBytes;
85
+ readonly clause: string;
86
+ }
87
+ /**
88
+ * One call's keep, as a supplier of bytes reaches it: keep a piece (claimed `mimeType`) and answer what came of it. The one
89
+ * keeper is `toolResultBytesKeeper(seat, toolCallId)` (`tool-result-store.ts`), which binds the one keep and the one wording to a
90
+ * run's seat and the call the bytes came back from; a supplier handed none keeps nothing ({@link keepBytesWith}).
91
+ */
92
+ export type ToolResultBytesKeeper = (bytes: Uint8Array, mimeType: unknown) => Promise<KeptBytesAnswer>;
93
+ /** What `keeper` answers for `bytes` — or, with no keeper, that they were not kept for want of a byte store. */
94
+ export declare function keepBytesWith(keeper: ToolResultBytesKeeper | undefined, bytes: Uint8Array, mimeType: unknown): Promise<KeptBytesAnswer>;
@@ -0,0 +1,34 @@
1
+ export const MEDIA_TYPE_ECHO_MAX = 100;
2
+ export function mediaTypeEcho(mime) {
3
+ return typeof mime === "string" && mime.length <= MEDIA_TYPE_ECHO_MAX && /^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}$/.test(mime) ? mime : undefined;
4
+ }
5
+ export function mediaTypePhrase(mime) {
6
+ const echo = mediaTypeEcho(mime);
7
+ if (echo !== undefined)
8
+ return echo;
9
+ return typeof mime === "string" && mime !== "" ? `a ${[...mime].length}-character type` : "unknown type";
10
+ }
11
+ export const TOOL_RESULT_BYTES_KEEP_LIMIT = 104_857_600;
12
+ export const SAVE_TOOL_RESULT_NAME = "SaveToolResult";
13
+ export function saveToolResultReach(mounted, callable) {
14
+ if (!mounted.some((t) => t.name === SAVE_TOOL_RESULT_NAME))
15
+ return "absent";
16
+ return callable === undefined || callable.has(SAVE_TOOL_RESULT_NAME) ? "callable" : "deferred";
17
+ }
18
+ export function keptBytesFacts(bytes, mimeType) {
19
+ const echo = mediaTypeEcho(mimeType);
20
+ return { bytes: bytes.byteLength, ...(echo !== undefined ? { mimeType: echo } : {}) };
21
+ }
22
+ export function notKeptClause(kept) {
23
+ if (kept.notKept === "no_byte_store")
24
+ return "its bytes were not kept: this run keeps no binary tool results";
25
+ if (kept.notKept === "over_limit")
26
+ return `its bytes were not kept: ${kept.bytes} bytes is over the ${TOOL_RESULT_BYTES_KEEP_LIMIT}-byte keep limit`;
27
+ return "its bytes were not kept: the tool-result store could not take them";
28
+ }
29
+ export function keepBytesWith(keeper, bytes, mimeType) {
30
+ if (keeper !== undefined)
31
+ return keeper(bytes, mimeType);
32
+ const kept = { ...keptBytesFacts(bytes, mimeType), notKept: "no_byte_store" };
33
+ return Promise.resolve({ kept, clause: notKeptClause(kept) });
34
+ }