@sema-agent/core 7.66.1 → 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 (899) hide show
  1. package/CHANGELOG.md +3483 -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 +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 +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.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -26,8 +26,11 @@ import { type StoreDurability } from "./checkpoint-store.js";
26
26
  import type { ModAdmissionRecord } from "./mods/kernel/index.js";
27
27
  import type { McpAuthorization, McpDelivered, McpFailureKind, McpServerLiveness } from "./mcp-failure.js";
28
28
  import type { WriteProtectionTargetView } from "./write-protect.js";
29
- import type { OnAsk } from "./tool-policy.js";
29
+ import { type OnAsk } from "./tool-policy.js";
30
+ import type { ApprovalRoute } from "./approval-route.js";
30
31
  import { type RunOrigin } from "./run-origin.js";
32
+ import { type StaticToolPlanDeps, type StaticToolPlanSpec } from "./tool-mount-static.js";
33
+ import type { ToolMountPlan } from "./tool-mount-plan.js";
31
34
  export type { StoreDurability };
32
35
  /** The manifest-face projection of {@link StoreDurability}: `"declared_durable"` (the name says it —
33
36
  * a DECLARATION relayed, not a verification) vs `"process_local"` (declared so, or fail-closed
@@ -39,16 +42,19 @@ export type ManifestDurability = "declared_durable" | "process_local";
39
42
  * child's manifest rides the CHILD's event stream and is deliberately not in the parent-forwarding
40
43
  * whitelist — a host that wants a child's assembly evidence subscribes to the child. */
41
44
  export type WiringLegKind = "root" | "child" | "resume";
42
- /** The shape of the resolved permission-ask seat ({@link resolveAskSeat}): a live approver callback, a blanket
43
- * `"allow"`/`"deny"` policy setting, nothing at all, or `"declared_none"` — the run declared that nobody on it can be
44
- * asked (`TaskSpec.approvalReach: "none"`), so a callback beside the declaration is not this run's approver. `"deny"` (a
45
- * deliberate policy) and `"absent"` (no seat supplied a value — a degrade to the headless auto-deny default) are DISTINCT
46
- * on purpose — design/173 — and so are `"absent"` and `"declared_none"`: one says nothing was wired, the other that
47
- * the run said nobody can answer. */
48
- export type AskSeamForm = "callback" | "allow" | "deny" | "absent" | "declared_none";
45
+ /** The shape of the resolved permission-ask seat ({@link resolveAskSeat}): an approver callback (`"callback"` — read as a
46
+ * person's channel), an approver callback the deployment declared a POLICY (`"policy_callback"`, `asPolicyApprover` — it
47
+ * answers on the deployment's behalf: relays an answer a person gave before, refuses, or answers `"unavailable"` so the ask
48
+ * parks), a blanket `"allow"`/`"deny"` policy setting, nothing at all, or `"declared_none"` — the run declared that nobody
49
+ * on it can be asked (`TaskSpec.approvalReach: "none"`), so a person's callback beside the declaration is not this run's
50
+ * approver. `"deny"` (a deliberate policy) and `"absent"` (no seat supplied a value — a degrade to the headless auto-deny
51
+ * default) are DISTINCT on purpose — design/173 — and so are `"absent"` and `"declared_none"`: one says nothing was wired,
52
+ * the other that the run said nobody can answer. */
53
+ export type AskSeamForm = "callback" | "policy_callback" | "allow" | "deny" | "absent" | "declared_none";
49
54
  /**
50
55
  * The closed set of a run's approval-reach declaration (`TaskSpec.approvalReach`): `"none"` — nobody on this run can be
51
- * asked to approve. It removes the one seat that could be a person (a callback); it never approves or releases anything.
56
+ * asked to approve. It removes the one seat that could be a person (a `"callback"`; a `"policy_callback"` is not a person
57
+ * and stays); it never approves or releases anything.
52
58
  * There is no positive word: "a person is reachable" is the `interactionPosture: "interactive"` promise, which has its own
53
59
  * door.
54
60
  */
@@ -62,9 +68,11 @@ export declare function isApprovalReach(v: unknown): v is ApprovalReach;
62
68
  * "nobody may"). Prepare, the static half and a resume's pre-claim screen call this one function.
63
69
  */
64
70
  export declare function screenApprovalReach(v: unknown): ApprovalReach | undefined;
65
- /** What a policy `ask` actually reaches under this assembly. `"unresolved"` = not computable from
66
- * the facts at hand (the static half's park-dependent arm). */
67
- export type AskEffective = "human_reachable" | "auto_allow" | "auto_deny" | "park_only" | "unresolved";
71
+ /** What a policy `ask` actually reaches under this assembly. `"policy_reachable"` = the deployment's approval policy
72
+ * answers it (a `"policy_callback"` seat — whose answer cannot be known ahead: a relayed earlier answer, a refusal, or
73
+ * `"unavailable"` and a park). `"unresolved"` = not computable from the facts at hand (the static half's park-dependent
74
+ * arm). */
75
+ export type AskEffective = "human_reachable" | "policy_reachable" | "auto_allow" | "auto_deny" | "park_only" | "unresolved";
68
76
  /**
69
77
  * The content-question channel, three-valued (design/173 §8.2 — a derived enum, not a bare
70
78
  * boolean): `"wired"` (a resolved `onQuestion` face exists), `"absent"` (none), or
@@ -81,6 +89,14 @@ export type QuestionChannelState = "wired" | "absent" | "stripped_bg_lane";
81
89
  export type SeamProvenance = "spec" | "deps";
82
90
  /** Machine-readable reason codes for a park lane that is not (or not provably) effective. */
83
91
  export type ParkLaneReason = "no_checkpoint_store" | "no_durable_approval_opt_in" | "no_force_durable_gate" | "no_armed_safety_vocabulary" | "await_runtime_caps" | "await_tool_vocabulary";
92
+ /**
93
+ * Why a leg cannot suspend durably ({@link WiringManifest.suspendLane}) — every missing piece of the
94
+ * infrastructure the external causes (a scheduler's yield, a usage window, an env lifetime) and the opted-in
95
+ * task axes suspend on: no checkpoint store; tool-result offload into a volatile store; a per-task execution
96
+ * env in neither suspend target (not a remote env / no `capabilities.suspendable` declaration / a declared
97
+ * snapshot whose adapter lacks the restore surface).
98
+ */
99
+ export type SuspendLaneReason = "no_checkpoint_store" | "volatile_tool_results" | "env_not_remote" | "env_suspend_undeclared" | "env_restore_incomplete";
84
100
  /**
85
101
  * The closed set of auto-mode ARMING outcomes a leg's manifest reports
86
102
  * ({@link WiringManifest.autoMode}). Minted from the arming predicate's own three-arm read, as the
@@ -110,6 +126,9 @@ export interface AutoModeArmFact {
110
126
  reason: AutoModeArmReason;
111
127
  deniedSource?: import("./runtime-caps.js").AutoModeDenySource;
112
128
  }
129
+ /** The most tool names one MCP row lists ({@link WiringManifestMcpEntry.toolNames}) — the one bound on the list's size; a row holding more
130
+ * lists the first of them in roster order and says so ({@link WiringManifestMcpEntry.toolNamesTruncated}). */
131
+ export declare const MCP_ENTRY_TOOL_NAMES_MAX = 64;
113
132
  /**
114
133
  * One declared MCP server's materialization result for THIS leg — the per-server connection-state
115
134
  * read face on {@link WiringManifest.mcp}. `status` is the connect-time verdict of this leg's
@@ -137,6 +156,15 @@ export interface WiringManifestMcpEntry {
137
156
  * `toolFaces` overlay applied — a tool either one leaves off is not counted), or, for `probeMcpServers` (no run, so no lists),
138
157
  * what its own dial would mount. `0` on `failed` and on `skipped` (no connection, so nothing held). */
139
158
  toolCount: number;
159
+ /** The names of the tools `toolCount` counts, as the roster holds them (the model-facing `mcp__<server>__<tool>` spelling, in roster
160
+ * order) — read off the same roster by the same call, so the two cannot disagree about what the run holds. PRESENT IFF the row is
161
+ * `connected` and at least one held name is listable: a name the provider's tool-name charset and length refuse is never listed.
162
+ * At most {@link MCP_ENTRY_TOOL_NAMES_MAX} names; when the list holds fewer names than `toolCount`, {@link WiringManifestMcpEntry.toolNamesTruncated}
163
+ * says so — a list is never cut silently. Absent on `failed` and `skipped` (nothing is held) and on a connected server that holds none. */
164
+ toolNames?: string[];
165
+ /** Present, and `true`, iff `toolNames` holds fewer names than `toolCount` (over the bound, or a held name that was not listable);
166
+ * absent otherwise — never written `false`. A consumer that wants the rest asks the roster (`WiringManifest.tools`). */
167
+ toolNamesTruncated?: true;
140
168
  /**
141
169
  * The engine's last liveness OBSERVATION about this server as of this leg's materialize — a per-leg
142
170
  * snapshot of the record described on `McpServerStatus.liveness`, refreshed when a leg emits its
@@ -212,6 +240,11 @@ export interface WiringManifest {
212
240
  /** OMITTED on the static half (design/173 §8.4): the absent-form arm depends on the park lane,
213
241
  * which the static half cannot always resolve. Always present on the effective half. */
214
242
  effective?: AskEffective;
243
+ /** The classes the resolved seat answers by itself, by its declared class table
244
+ * ({@link import("./tool-policy.js").declareClassAnswers}; in `ASK_CLASSES` order): an ask whose whole class set
245
+ * is among them is allowed as the deployment's policy, reaching nobody. Present ⇔ the seat carries a table — on
246
+ * either half, beside whatever `effective` says of the asks outside it. */
247
+ answeredClasses?: readonly import("./ask-origin.js").AskClass[];
215
248
  };
216
249
  question: {
217
250
  /** Three-valued channel state — see {@link QuestionChannelState}. The field keeps the frozen
@@ -258,6 +291,25 @@ export interface WiringManifest {
258
291
  * §1 names, and it must be reportable. Present iff `capable`. */
259
292
  checkpointDurability?: ManifestDurability;
260
293
  };
294
+ /**
295
+ * Effective half only — whether this leg CAN suspend durably at a clean turn boundary, the readiness every
296
+ * external cause and every opted-in task axis suspends on. A statement about readiness, never about one
297
+ * request's outcome: a ready leg can still have one suspend refused at run time (the environment declines
298
+ * the snapshot, the store refuses the write) — that request's own disclosure names it.
299
+ * - `ready` — a scheduler's yield (`TaskSpec.preemptSignal`) parks this leg at its next clean boundary; not
300
+ * ready ⇒ the yield is answered by continuing, said once on the deployment's error face.
301
+ * - `reasons` — the missing pieces (empty ⇔ ready).
302
+ * - `recoverableAcrossProcesses` — ready AND both the checkpoint store and the session store DECLARE
303
+ * durability, so a park minted here can be continued by another process (a drain hand-off). False ⇒ only
304
+ * this process can continue it. Derived from the same declarations `parkLane.checkpointDurability` and
305
+ * `session.store` report; a screening parent-constraint chain still has to be re-supplied by the host that
306
+ * resumes on a fresh Runner (the park's own disclosure says so).
307
+ */
308
+ suspendLane?: {
309
+ ready: boolean;
310
+ reasons: readonly SuspendLaneReason[];
311
+ recoverableAcrossProcesses: boolean;
312
+ };
261
313
  /** The session store's DECLARED durability (declaration relayed verbatim — never class-name
262
314
  * sniffing; absent declaration reads fail-closed as `process_local`). */
263
315
  session: {
@@ -357,13 +409,25 @@ export interface WiringManifest {
357
409
  * design/388 §2.5 — EFFECTIVE half only, and ALWAYS present on an engine-minted effective manifest:
358
410
  * the leg's TOOL ROSTER — one row per mounted instance in wire order, every declared axis, the
359
411
  * engine-minted identity (`capabilityId`), the schema-derived `inputKeys` / rule vocabulary and the
360
- * roster `digest`. The static half has no roster to report (it mounts nothing). NOT part of
412
+ * roster `digest`. The static half has no roster (it mounts nothing); what it can say about the set is
413
+ * {@link toolPlan}. NOT part of
361
414
  * {@link configFingerprint}: a roster is per-leg by construction (a child leg mounts a different set
362
415
  * under the same assembly), so hashing it would break the cross-leg equality the fingerprint
363
416
  * advertises — the roster carries its own digest for that. A run-time change to the set arrives as a
364
417
  * `tool_roster_delta` event, never as a re-emitted manifest.
365
418
  */
366
419
  tools?: import("./tool-roster.js").ToolRoster;
420
+ /**
421
+ * BOTH halves: the leg's mount plan — every definition the mount table names, by the row that mounts it, read over the
422
+ * facts this half can see. A tool is on a leg's roster if and only if its row in the mount table holds over that leg's
423
+ * facts. On the STATIC half (`half: "static"`) the rows are read over the facts a deployment knows before any task:
424
+ * `mounted` members mount on every top-level leg those deps run for that spec; `conditional` members name the per-task,
425
+ * per-principal or live facts that decide them (`when`); absent definitions name the facts that keep them off
426
+ * (`because`). The plan never guesses a fact it cannot read. On the EFFECTIVE half (`half: "effective"`) every fact is
427
+ * read, so the members are exactly the roster's, all `mounted`, and `absent` names the definitions the leg left off.
428
+ * NOT part of {@link configFingerprint}, for the roster's reason.
429
+ */
430
+ toolPlan?: ToolMountPlan;
367
431
  /**
368
432
  * EFFECTIVE half only: the leg's mods admission — one record per registration of the two seats, in run order: a
369
433
  * mounted one with the patterns it actually hung (`events`), the ones among them it only watches (`observe`: every
@@ -483,14 +547,39 @@ export interface WiringManifest {
483
547
  */
484
548
  fileHistory?: "on" | "disabled";
485
549
  /**
486
- * EFFECTIVE half only, ALWAYS present on an engine-minted effective manifest: did this leg read the deployment's project context, and if not,
487
- * which half kept it out — one word per state. `"on"` — its prepare called `RunnerDeps.loadProjectMemory` (what the seam answered, content or
488
- * nothing, is the deployment's). `"disabled"` — a seam is wired and the request turned it off (`TaskSpec.projectMemory: "disabled"`).
489
- * `"absent"` — no seam is wired (the manifest's word for a seat nothing supplied, as `ask` / `question` spell it), whatever the request said.
490
- * The member missing = an older mint or an external derivation, never a state. Out of {@link configFingerprint}: the request word is a
491
- * per-task seat (`fileHistory` reasoning).
550
+ * EFFECTIVE half only, present iff the task's command sandbox requirement is in force (`TaskSpec.sandbox.enabled`): `"armed"` —
551
+ * the leg's environment keeps a command sandbox and every command its shell faces start runs in it (or is not started);
552
+ * `"unavailable"` — it keeps none and the task allowed that (`failIfUnavailable: false`), so the commands run unsandboxed
553
+ * (`reason` says why; the run's `config.command_sandbox_unavailable` notice says the same). Absent = no requirement in force (a
554
+ * requirement the environment cannot meet under `failIfUnavailable` refuses the run, so no manifest says it). Out of
555
+ * {@link configFingerprint}: the requirement is a per-task seat (a child runs under its parent's merged with its own).
556
+ */
557
+ commandSandbox?: {
558
+ readonly state: "armed";
559
+ } | {
560
+ readonly state: "unavailable";
561
+ readonly reason: string;
562
+ };
563
+ /**
564
+ * EFFECTIVE half only, ALWAYS present on an engine-minted effective manifest: does this leg read the project's instruction files, and if
565
+ * not, which half kept them out — one word per state, read off the task's declaration alone. `"on"` — the task declares an instruction
566
+ * family (`TaskSpec.instructionFamily`) and the request left it on: the instruction-file lane reads it at the task root and below (on a leg
567
+ * with hands; {@link WiringManifest.instructions} says what it holds). `"disabled"` — a family is declared and the request turned it off
568
+ * (`TaskSpec.projectMemory: "disabled"`; the lane is not seated). `"absent"` — no family is declared (the manifest's word for a seat nothing
569
+ * supplied, as `ask` / `question` spell it), whatever the request said. The member missing = an older mint or an external derivation, never
570
+ * a state. Out of {@link configFingerprint}: the request word is a per-task seat (`fileHistory` reasoning).
492
571
  */
493
572
  projectMemory?: "on" | "disabled" | "absent";
573
+ /**
574
+ * EFFECTIVE half only — the task root's instruction files this leg holds as it starts. Present ⇔ the instruction-file lane is seated (a
575
+ * family declared and left on, hands mounted). `selected` = the root's family members the conversation holds, or the leg's first load has
576
+ * on its way to the leg's first request — relative to the task root, `/`-separated, the declared names first in declaration order, then
577
+ * the rules by path; a member the model may not read, or that holds nothing, is not in it. The manifest goes out after that first load and
578
+ * before the first request. Out of {@link configFingerprint}: a per-leg read.
579
+ */
580
+ instructions?: {
581
+ readonly selected: readonly string[];
582
+ };
494
583
  /**
495
584
  * EFFECTIVE half only, ALWAYS present on an engine-minted effective manifest: are the legs THIS leg delegates (sync,
496
585
  * background, forked, workflow, retained, resumed and observer-sidecar legs, at any depth) bound by a rule written to this
@@ -544,6 +633,8 @@ export interface WiringFacts {
544
633
  peerPresence?: import("../agents/peer-directory.js").PeerPresence;
545
634
  askForm: AskSeamForm;
546
635
  askProvenance?: SeamProvenance;
636
+ /** See {@link WiringManifest.ask.answeredClasses}. */
637
+ askAnsweredClasses?: readonly import("./ask-origin.js").AskClass[];
547
638
  questionWired: boolean;
548
639
  questionProvenance?: SeamProvenance;
549
640
  /** The engine-minted strip flag (trusted RunInternals channel) — effective half only; the static
@@ -567,6 +658,9 @@ export interface WiringFacts {
567
658
  /** Present iff `parkCapable` (the resolved checkpoint store's declaration). */
568
659
  checkpointDurability?: StoreDurability;
569
660
  sessionDurability: StoreDurability;
661
+ /** Effective half: the durable-suspend infrastructure's missing pieces (empty ⇔ ready), relayed from the one
662
+ * derivation the suspend lanes are exposed on. Absent on the static half (the per-task env is a prepare-time fact). */
663
+ suspendLaneReasons?: readonly SuspendLaneReason[];
570
664
  backgroundAgentStoreWired: boolean;
571
665
  /** Subagent transcript persistence — the declared delegation-transcript tier (see
572
666
  * {@link WiringManifest.fleet}). Optional for external `deriveWiringManifest` callers: absent
@@ -599,6 +693,8 @@ export interface WiringFacts {
599
693
  mcp?: readonly WiringManifestMcpEntry[];
600
694
  /** Effective half only — the leg's minted tool roster (see {@link WiringManifest.tools}). */
601
695
  tools?: import("./tool-roster.js").ToolRoster;
696
+ /** Both halves — the leg's mount plan (see {@link WiringManifest.toolPlan}); its own `half` must be the manifest's. */
697
+ toolPlan?: ToolMountPlan;
602
698
  /** Effective half only — the leg's mods admission records ({@link WiringManifest.mods}); an empty array and an absent value derive the same thing (no section). */
603
699
  mods?: readonly ModAdmissionRecord[];
604
700
  /** Effective half only — the LSP seam ({@link WiringManifest.lsp}); absent ⇒ no manager wired. */
@@ -625,6 +721,15 @@ export interface WiringFacts {
625
721
  autoConsolidationOnRecommendation?: boolean;
626
722
  /** Effective half only — the file-history phase's word ({@link WiringManifest.fileHistory}); the engine always passes it. */
627
723
  fileHistory?: "on" | "disabled";
724
+ /** Effective half only — the run's command sandbox ({@link WiringManifest.commandSandbox}), relayed from its one judgment; absent or `off` ⇒ no cell. */
725
+ commandSandbox?: {
726
+ readonly state: "off";
727
+ } | {
728
+ readonly state: "armed";
729
+ } | {
730
+ readonly state: "unavailable";
731
+ readonly reason: string;
732
+ };
628
733
  /** Effective half only — the project-context phase's word ({@link WiringManifest.projectMemory}); the engine always passes it. */
629
734
  projectMemory?: WiringManifest["projectMemory"];
630
735
  /** Effective half only — {@link WiringManifest.sessionRules}`.childrenReadLive`: this leg's session-rule layer published its key for its children's chain. Read off that wiring, never a constant. */
@@ -646,9 +751,9 @@ export interface WiringAdvisorFact {
646
751
  }
647
752
  /** Named view of the deps seats the static half reads (a `Pick` of the real {@link RunnerDeps} —
648
753
  * single-source shapes, no parallel hand-copied interface). */
649
- export type StaticWiringDeps = Pick<RunnerDeps, "onAsk" | "onQuestion" | "interactionPosture" | "onElicit" | "checkpointStore" | "sessionStore" | "backgroundAgentStore" | "onBackgroundChildEvent" | "lockedConfig" | "compliancePostureResolver" | "memoryScopeAdmission" | "retentionPolicy" | "permissionRuleStore" | "permissionRuleSyncWired">;
754
+ export type StaticWiringDeps = Pick<RunnerDeps, "onAsk" | "onQuestion" | "interactionPosture" | "onElicit" | "checkpointStore" | "sessionStore" | "backgroundAgentStore" | "onBackgroundChildEvent" | "lockedConfig" | "compliancePostureResolver" | "memoryScopeAdmission" | "retentionPolicy" | "permissionRuleStore" | "permissionRuleSyncWired"> & StaticToolPlanDeps;
650
755
  /** Named view of the spec seats the static half reads (a `Pick` of the real {@link TaskSpec}). */
651
- export type StaticWiringSpec = Pick<TaskSpec, "onAsk" | "approvalReach" | "onQuestion" | "checkpointStore" | "durableApproval" | "mcp" | "interactiveTools" | "interactionPosture">;
756
+ export type StaticWiringSpec = Pick<TaskSpec, "onAsk" | "approvalReach" | "onQuestion" | "checkpointStore" | "durableApproval" | "mcp" | "interactiveTools" | "interactionPosture"> & StaticToolPlanSpec;
652
757
  /**
653
758
  * Read a store's {@link StoreDurability} declaration: absent ⇒ `"process-local"` (fail-closed —
654
759
  * under-promise, never over-promise), a declared value passes through, and an UNPARSEABLE value is
@@ -701,6 +806,8 @@ export declare function resolveSubagentTranscriptTier(agentStoreWired: boolean,
701
806
  * hook's own ask beside no rule or safety ask is handed on, and that is the hook lane's decision, not a policy
702
807
  * `ask`), so no seat answers one — whatever the seat and the park lane say, the word is `auto_deny`;
703
808
  * - a live approver callback ⇒ `human_reachable` (regardless of the park lane);
809
+ * - an approver callback the deployment declared a policy ⇒ `policy_reachable` (regardless of the park lane, like any
810
+ * callback: it is asked first, and an ask parks only when it answers `"unavailable"`);
704
811
  * - blanket `"allow"`/`"deny"` ⇒ the park lane decides first: a string seat is NOT a live approver,
705
812
  * so on an armed park lane the ask parks and the honest report is `park_only` — reporting the
706
813
  * blanket as what the ask "reaches" would be a false fact of exactly the kind this module refuses.
@@ -718,31 +825,33 @@ export declare function deriveAskEffective(form: AskSeamForm, parkEffective: boo
718
825
  * `dontAsk` start's refusal into the leg's later modes.
719
826
  */
720
827
  export declare function askSeatEffective(manifest: Pick<WiringManifest, "ask" | "parkLane">): AskEffective;
721
- /**
722
- * WHERE an ask carrying `requiresRealApproval` goes from a station — the closed set of the ONE approval-seat decision:
723
- * `live_approver` (a live approver callback answers it now), `durable_park` (it parks for a person to answer later),
724
- * `none` (nobody can: a blanket policy seat, no seat, or a run that declared nobody can be asked — each only when no park
725
- * lane is armed, since an armed park is the deployment's own statement that an answer can wait for a person — or a word that cannot be
726
- * resolved — the fail-closed reading).
727
- */
728
- export declare const APPROVAL_ROUTES: readonly ["live_approver", "durable_park", "none"];
729
- export type ApprovalRoute = (typeof APPROVAL_ROUTES)[number];
828
+ export { APPROVAL_ROUTES, isApprovalRoute, type ApprovalRoute } from "./approval-route.js";
730
829
  /**
731
830
  * The APPROVAL SEAT as a route, read off the ONE ask derivation above, never re-derived: `human_reachable` ⇒
732
- * `live_approver`; `park_only` ⇒ `durable_park` (where the park cannot take the ask, a blanket seat behind it refuses the
733
- * bit); `auto_allow`, `auto_deny` and `unresolved` ⇒ `none`. Every station that forks on "does a handed-on ask reach a
734
- * person" reads this word — the leg's gate from the leg's seat word ({@link askSeatEffective}), an ancestor's frozen seat
735
- * through {@link frozenApproverRoute} — and the fork, its observer and the sentence a person reads all read the same word.
831
+ * `live_approver`; `policy_reachable` ⇒ `policy_seat`; `park_only` ⇒ `durable_park` (where the park cannot take the ask, a
832
+ * blanket seat behind it refuses the bit); `auto_allow`, `auto_deny` and `unresolved` ⇒ `none`. Every station that forks on
833
+ * "does a handed-on ask reach a decider" reads this word — the leg's gate from the leg's seat word ({@link askSeatEffective}),
834
+ * an ancestor's frozen seat through {@link frozenApproverRoute} — and the fork, its observer and the sentence a person reads
835
+ * all read the same word.
736
836
  */
737
837
  export declare function approvalRouteOf(ask: {
738
838
  readonly effective?: AskEffective;
739
839
  }): ApprovalRoute;
740
840
  /**
741
841
  * The route from an ancestor's FROZEN approver (the inherited fold's station): the same table read with that seat's own
742
- * form and no park — the inherited station resolves at the frozen seat, whose only road to a person is a live callback
743
- * (the leg's park is reached only through a live approver's `unavailable`), so a blanket or absent frozen seat is `none`.
842
+ * form and no park — the inherited station resolves at the frozen seat, whose only roads to a decider are its callbacks
843
+ * (a person's, or a policy's; the leg's park is reached only through a callback's `unavailable`), so a blanket or absent
844
+ * frozen seat is `none`.
744
845
  */
745
846
  export declare function frozenApproverRoute(onAsk: OnAsk | undefined): ApprovalRoute;
847
+ /** The seat form of a seat VALUE: a function is a callback — a policy's when the deployment marked it one
848
+ * ({@link isPolicyApprover}), else a person's — the two blanket words are themselves, nothing is `absent`; anything else is
849
+ * no form at all (`undefined` — {@link resolveAskSeat} refuses it loudly). */
850
+ export declare function askSeamFormOf(v: unknown): Exclude<AskSeamForm, "declared_none"> | undefined;
851
+ /** Which seat forms `approvalReach: "none"` sets aside: the one that could be a person — a `"callback"`. A policy callback
852
+ * and a blanket policy stay (neither ever claimed to be a person). The ONE reading of the declaration's reach: the run's
853
+ * own seat ({@link resolveAskSeat}) and the ancestor seats a declared-none leg sees on its chain both read it. */
854
+ export declare function reachSetsAside(form: AskSeamForm | undefined): boolean;
746
855
  export declare function deriveWiringManifest(facts: WiringFacts): WiringManifest;
747
856
  /** A run's approval seat as its one resolution froze it: the value every reader that needs the approver itself reads
748
857
  * (`undefined` when nothing on this run can be asked), the form the manifest reports and every reader of the word derives
@@ -761,18 +870,24 @@ export interface AskSeat {
761
870
  * spec `null` is a junk value, never a fall-through to the deployment). A value outside the `OnAsk` union is refused
762
871
  * loudly (`config.interaction_wiring`), a declaration outside {@link APPROVAL_REACH} too (`config.approval_reach_invalid`).
763
872
  *
764
- * `approvalReach: "none"` is one sentence here: a blanket `"allow"` / `"deny"` stays what it is (a policy setting never
765
- * claimed to be a person); a callback, or no seat, becomes `declared_none` with NO value — so the readers of the value
873
+ * `approvalReach: "none"` is one sentence here ({@link reachSetsAside}): a blanket `"allow"` / `"deny"` stays what it is, and
874
+ * so does an approver the deployment declared a policy (`policy_callback` — neither ever claimed to be a person); a person's
875
+ * callback, or no seat, becomes `declared_none` with NO value — so the readers of the value
766
876
  * (the approver lane, the park's sync-first decline, the durable-mandate source, a child's inherited seat) and the readers
767
877
  * of the word ({@link deriveAskEffective}) cannot disagree about whether a person is there.
768
878
  */
769
879
  export declare function resolveAskSeat(spec: Pick<TaskSpec, "onAsk" | "approvalReach">, deps: Pick<RunnerDeps, "onAsk">): AskSeat;
770
880
  /** The form and provenance half of {@link resolveAskSeat} — the projection the manifest's two halves and a server's
771
- * per-leg judgment read (hand it the request's `approvalReach` beside the seat). */
881
+ * per-leg judgment read (hand it the request's `approvalReach` beside the seat) — and the classes the resolved seat's
882
+ * declared table answers ({@link askAnsweredClassesOf}). */
772
883
  export declare function resolveAskSeamForm(spec: Pick<TaskSpec, "onAsk" | "approvalReach">, deps: Pick<RunnerDeps, "onAsk">): {
773
884
  form: AskSeamForm;
774
885
  provenance?: SeamProvenance;
886
+ answeredClasses?: readonly import("./ask-origin.js").AskClass[];
775
887
  };
888
+ /** The manifest's `ask.answeredClasses` fact for a resolved seat: the classes its value's declared table answers
889
+ * ({@link declaredAnswerClassesOf}) — none for a seat the declaration set aside, which holds no value. Both halves read it. */
890
+ export declare function askAnsweredClassesOf(seat: Pick<AskSeat, "value">): readonly import("./ask-origin.js").AskClass[] | undefined;
776
891
  /** The one question-seat resolution (`spec` wins over `deps`), shared by both halves. Review fold
777
892
  * r2-F2: a NON-FUNCTION present value (a JS caller passing `onQuestion: null`/junk) is refused
778
893
  * loudly — the engine's `??` resolution would keep it, the mount's presence check would count it,
@@ -801,5 +916,12 @@ export declare function resolveElicitSeam(deps: Pick<RunnerDeps, "onElicit">): b
801
916
  * (per-principal runtime caps, the safety-tool vocabulary) derive `"unresolved"`; `ask.effective`
802
917
  * is omitted entirely (see the module doc). This is DISCLOSURE, not verification — see the §0
803
918
  * guarantee boundary above. `spec` may be omitted for a spec-less deployment self-check.
919
+ *
920
+ * `toolPlan` is the mount table read over the facts this half can read (tool-mount-static.ts): a member it calls
921
+ * `mounted` mounts on every top-level leg `(deps, spec)` runs, a definition it calls absent on none, and a member a
922
+ * per-task, per-principal or live fact decides is `conditional` and names that fact. Reading it runs the doors prepare
923
+ * runs over the same values (the permission-mode doors, the tool lists and selector, the locked-config preflight of the
924
+ * declared peers, a named model), so a spec prepare would refuse is refused here — after the seat resolutions above it,
925
+ * before the screens `deriveWiringManifest` runs over the assembled facts.
804
926
  */
805
927
  export declare function describeStaticWiring(deps: StaticWiringDeps, spec?: StaticWiringSpec): WiringManifest;
@@ -5,8 +5,10 @@ import { canonicalize } from "./canonical-json.js";
5
5
  import { resolveCheckpointStore } from "./checkpoint-store.js";
6
6
  import { isLiveQuestionFace } from "./ask-question.js";
7
7
  import { AUTO_MODE_DENY_SOURCES, isAutoModeDenySource } from "./runtime-caps.js";
8
+ import { declaredAnswerClassesOf, isPolicyApprover } from "./tool-policy.js";
8
9
  import { describeRejectedValue } from "./tool-search-setting.js";
9
10
  import { RUN_ORIGINS } from "./run-origin.js";
11
+ import { planStaticToolMounts } from "./tool-mount-static.js";
10
12
  export const APPROVAL_REACH = Object.freeze(["none"]);
11
13
  const APPROVAL_REACH_SET = new Set(APPROVAL_REACH);
12
14
  export function isApprovalReach(v) {
@@ -23,6 +25,7 @@ export function screenApprovalReach(v) {
23
25
  throw e;
24
26
  }
25
27
  export const AUTO_MODE_ARM_REASONS = Object.freeze(["armed", "no_intent", "no_face", "denied", "resolver_fault"]);
28
+ export const MCP_ENTRY_TOOL_NAMES_MAX = 64;
26
29
  export const LSP_LANES = Object.freeze(["tool", "diagnostics", "tool_and_diagnostics"]);
27
30
  export function deriveHandsSeam(handsMounted) {
28
31
  return handsMounted ? { mounted: true } : { mounted: false, reason: "no_execution_env" };
@@ -65,6 +68,8 @@ export function deriveAskEffective(form, parkEffective, mode) {
65
68
  switch (form) {
66
69
  case "callback":
67
70
  return "human_reachable";
71
+ case "policy_callback":
72
+ return "policy_reachable";
68
73
  case "allow":
69
74
  return parkEffective === true ? "park_only" : parkEffective === "unresolved" ? "unresolved" : "auto_allow";
70
75
  case "deny":
@@ -82,12 +87,14 @@ export function deriveAskEffective(form, parkEffective, mode) {
82
87
  export function askSeatEffective(manifest) {
83
88
  return deriveAskEffective(manifest.ask.form, manifest.parkLane.effective);
84
89
  }
85
- export const APPROVAL_ROUTES = Object.freeze(["live_approver", "durable_park", "none"]);
90
+ export { APPROVAL_ROUTES, isApprovalRoute } from "./approval-route.js";
86
91
  export function approvalRouteOf(ask) {
87
92
  const effective = ask.effective ?? "unresolved";
88
93
  switch (effective) {
89
94
  case "human_reachable":
90
95
  return "live_approver";
96
+ case "policy_reachable":
97
+ return "policy_seat";
91
98
  case "park_only":
92
99
  return "durable_park";
93
100
  case "auto_allow":
@@ -104,8 +111,11 @@ export function approvalRouteOf(ask) {
104
111
  export function frozenApproverRoute(onAsk) {
105
112
  return approvalRouteOf({ effective: deriveAskEffective(askSeamFormOf(onAsk) ?? "absent", false) });
106
113
  }
107
- function askSeamFormOf(v) {
108
- return typeof v === "function" ? "callback" : v === "allow" ? "allow" : v === "deny" ? "deny" : v === undefined ? "absent" : undefined;
114
+ export function askSeamFormOf(v) {
115
+ return typeof v === "function" ? (isPolicyApprover(v) ? "policy_callback" : "callback") : v === "allow" ? "allow" : v === "deny" ? "deny" : v === undefined ? "absent" : undefined;
116
+ }
117
+ export function reachSetsAside(form) {
118
+ return form === "callback";
109
119
  }
110
120
  function deriveParkLane(facts) {
111
121
  if (!facts.parkCapable) {
@@ -137,6 +147,12 @@ function readAutoModeFact(fact) {
137
147
  }
138
148
  return { armed, reason, ...(deniedSource !== undefined ? { deniedSource } : {}) };
139
149
  }
150
+ function readToolPlanFact(plan, half) {
151
+ const planHalf = plan.half;
152
+ if (planHalf !== half)
153
+ throw new Error(`the tool mount plan is the ${JSON.stringify(planHalf)} reading, not the ${JSON.stringify(half)} half's — a plan is published only on the half that read it`);
154
+ return plan;
155
+ }
140
156
  function readPermissionModeFact(fact) {
141
157
  const { requested, effective, foldedBy } = typeof fact === "object" && fact !== null ? fact : { requested: undefined, effective: undefined, foldedBy: undefined };
142
158
  if (!isPermissionMode(effective) || (requested !== undefined && !isPermissionMode(requested)) || (foldedBy !== undefined && !PERMISSION_MODE_FOLD_REASONS.includes(foldedBy))) {
@@ -185,6 +201,7 @@ export function deriveWiringManifest(facts) {
185
201
  form: facts.askForm,
186
202
  ...(facts.askProvenance !== undefined ? { provenance: facts.askProvenance } : {}),
187
203
  ...(facts.half === "effective" ? { effective: deriveAskEffective(facts.askForm, parkLane.effective, facts.permissionMode?.effective) } : {}),
204
+ ...(facts.askAnsweredClasses !== undefined ? { answeredClasses: facts.askAnsweredClasses } : {}),
188
205
  },
189
206
  question: {
190
207
  wired: questionChannel,
@@ -194,6 +211,15 @@ export function deriveWiringManifest(facts) {
194
211
  interaction: { posture: facts.interactionPosture ?? "absent" },
195
212
  elicit: { seamWired: facts.elicitSeamWired, serversOptedIn: facts.elicitServersOptedIn },
196
213
  parkLane,
214
+ ...(facts.half === "effective" && facts.suspendLaneReasons !== undefined
215
+ ? {
216
+ suspendLane: {
217
+ ready: facts.suspendLaneReasons.length === 0,
218
+ reasons: [...facts.suspendLaneReasons],
219
+ recoverableAcrossProcesses: facts.suspendLaneReasons.length === 0 && facts.checkpointDurability === "durable" && facts.sessionDurability === "durable",
220
+ },
221
+ }
222
+ : {}),
197
223
  session: { store: manifestDurabilityOf(facts.sessionDurability) },
198
224
  fleet: {
199
225
  backgroundAgentStore: facts.backgroundAgentStoreWired,
@@ -216,6 +242,7 @@ export function deriveWiringManifest(facts) {
216
242
  ...(facts.half === "effective" && facts.autoMode !== undefined ? { autoMode: readAutoModeFact(facts.autoMode) } : {}),
217
243
  ...(facts.half === "effective" && facts.mcp !== undefined ? { mcp: facts.mcp.map((e) => ({ ...e })) } : {}),
218
244
  ...(facts.half === "effective" && facts.tools !== undefined ? { tools: facts.tools } : {}),
245
+ ...(facts.toolPlan !== undefined ? { toolPlan: readToolPlanFact(facts.toolPlan, facts.half) } : {}),
219
246
  ...(facts.half === "effective" && facts.mods !== undefined && facts.mods.length > 0 ? { mods: [...facts.mods] } : {}),
220
247
  ...(facts.half === "effective" && facts.lsp !== undefined ? { lsp: { ...facts.lsp } } : {}),
221
248
  ...(facts.half === "effective" && facts.hands !== undefined ? { hands: readHandsFact(facts.hands) } : {}),
@@ -226,6 +253,9 @@ export function deriveWiringManifest(facts) {
226
253
  : {}),
227
254
  ...(facts.half === "effective" && facts.autoConsolidationOnRecommendation === true ? { autoConsolidation: { onRecommendation: true } } : {}),
228
255
  ...(facts.half === "effective" && facts.fileHistory !== undefined ? { fileHistory: readWordFact(facts.fileHistory, ["on", "disabled"], "file-history") } : {}),
256
+ ...(facts.half === "effective" && facts.commandSandbox !== undefined && facts.commandSandbox.state !== "off"
257
+ ? { commandSandbox: facts.commandSandbox.state === "armed" ? { state: "armed" } : { state: "unavailable", reason: facts.commandSandbox.reason } }
258
+ : {}),
229
259
  ...(facts.half === "effective" && facts.projectMemory !== undefined ? { projectMemory: readWordFact(facts.projectMemory, ["on", "disabled", "absent"], "project-memory") } : {}),
230
260
  ...(facts.half === "effective" && facts.sessionRulesChildrenReadLive !== undefined ? { sessionRules: readSessionRulesFact(facts.sessionRulesChildrenReadLive) } : {}),
231
261
  ...(facts.half === "effective" && facts.advisor !== undefined ? { advisor: { ...facts.advisor, ...(facts.advisor.hold !== undefined ? { hold: { ...facts.advisor.hold } } : {}) } } : {}),
@@ -236,7 +266,7 @@ export function deriveWiringManifest(facts) {
236
266
  : {}),
237
267
  };
238
268
  if (facts.half === "effective") {
239
- const { leg: _leg, mcp: _mcp, tools: _tools, lsp: _lsp, mods: _mods, teamRole: _teamRole, peerPresence: _peerPresence, fileHistory: _fileHistory, projectMemory: _projectMemory, permissionMode: _permissionMode, sessionRules: _sessionRules, advisor: _advisor, ...assembly } = manifest;
269
+ const { leg: _leg, mcp: _mcp, tools: _tools, toolPlan: _toolPlan, lsp: _lsp, mods: _mods, teamRole: _teamRole, peerPresence: _peerPresence, fileHistory: _fileHistory, projectMemory: _projectMemory, commandSandbox: _commandSandbox, permissionMode: _permissionMode, sessionRules: _sessionRules, advisor: _advisor, suspendLane: _suspendLane, ...assembly } = manifest;
240
270
  const { provenance: _askSeat, ...askForHash } = assembly.ask;
241
271
  const { provenance: _questionSeat, ...questionForHash } = assembly.question;
242
272
  manifest.configFingerprint = createHash("sha256")
@@ -260,13 +290,17 @@ export function resolveAskSeat(spec, deps) {
260
290
  e.code = "config.interaction_wiring";
261
291
  throw e;
262
292
  }
263
- if (reach !== undefined && form === "callback")
293
+ if (reach !== undefined && reachSetsAside(form))
264
294
  return Object.freeze({ value: undefined, form: "declared_none", provenance: seat.provenance, reach });
265
295
  return Object.freeze({ value: v, form, provenance: seat.provenance, ...(reach !== undefined ? { reach } : {}) });
266
296
  }
267
297
  export function resolveAskSeamForm(spec, deps) {
268
298
  const seat = resolveAskSeat(spec, deps);
269
- return { form: seat.form, ...(seat.provenance !== undefined ? { provenance: seat.provenance } : {}) };
299
+ const answeredClasses = askAnsweredClassesOf(seat);
300
+ return { form: seat.form, ...(seat.provenance !== undefined ? { provenance: seat.provenance } : {}), ...(answeredClasses !== undefined ? { answeredClasses } : {}) };
301
+ }
302
+ export function askAnsweredClassesOf(seat) {
303
+ return declaredAnswerClassesOf(seat.value);
270
304
  }
271
305
  export function resolveQuestionSeam(spec, deps) {
272
306
  const seat = spec.onQuestion !== undefined ? { value: spec.onQuestion, provenance: "spec" } : deps.onQuestion !== undefined ? { value: deps.onQuestion, provenance: "deps" } : undefined;
@@ -305,6 +339,7 @@ export function describeStaticWiring(deps, spec = {}) {
305
339
  half: "static",
306
340
  askForm: ask.form,
307
341
  ...(ask.provenance !== undefined ? { askProvenance: ask.provenance } : {}),
342
+ ...(ask.answeredClasses !== undefined ? { askAnsweredClasses: ask.answeredClasses } : {}),
308
343
  questionWired: question.wired,
309
344
  ...(question.provenance !== undefined ? { questionProvenance: question.provenance } : {}),
310
345
  ...(() => {
@@ -335,5 +370,6 @@ export function describeStaticWiring(deps, spec = {}) {
335
370
  complianceWired: deps.compliancePostureResolver !== undefined,
336
371
  memoryAdmissionWired: deps.memoryScopeAdmission !== undefined,
337
372
  retentionPolicyWired: deps.retentionPolicy !== undefined,
373
+ toolPlan: planStaticToolMounts(deps, spec),
338
374
  });
339
375
  }
@@ -25,6 +25,16 @@ export declare function createWorkflowRun(over?: Partial<WorkflowRun>): Workflow
25
25
  * `runAssertion` that schedules work concurrently will interleave cases. Bindings whose stores share state
26
26
  * (e.g. SQL twins on one table) must CHAIN the assertions themselves (serialize inside `runAssertion`).
27
27
  */
28
- export declare function workflowRunStoreContract(make: () => WorkflowRunStore, runAssertion?: (name: string, fn: () => Promise<void>) => void): Promise<void>;
28
+ export declare function workflowRunStoreContract(make: () => WorkflowRunStore, runAssertion?: (name: string, fn: () => Promise<void>) => void, hooks?: WorkflowRunStoreContractHooks): Promise<void>;
29
+ /**
30
+ * The damaged-run clause's hooks (additive): `plantRow` leaves `raw` stored under the run id `id` as a foreign writer (or an
31
+ * earlier engine) would — past the write gate — and answers the store to read it from (a file backend reopens its directory).
32
+ * `unplantable` carries the reason a backend keeps no stored run another writer could damage; a hooks object with neither is
33
+ * refused.
34
+ */
35
+ export interface WorkflowRunStoreContractHooks {
36
+ readonly plantRow?: (store: WorkflowRunStore, id: string, raw: unknown) => Promise<WorkflowRunStore>;
37
+ readonly unplantable?: string;
38
+ }
29
39
  /** Re-export so a contract caller can label runs by status without re-importing the run module. */
30
40
  export type { WorkflowRunStatus };