@sema-agent/core 7.66.0 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -0,0 +1,196 @@
1
+ import type { ToolCatalogEntry, ToolMountTag } from "./tool-face.js";
2
+ /** The closed set of facts a mount row may read. */
3
+ export declare const TOOL_MOUNT_FACTS: readonly ["runner.self", "leg.parentNotify", "leg.peerLane", "leg.taskNotification", "leg.session", "env.hands", "env.performsIo", "env.backgroundShell", "env.scheduler", "spec.enableBlockedReport", "spec.planMode", "spec.interactiveTools.on", "spec.interactiveTools.off", "spec.planFile", "spec.selfOrchestration", "spec.outputSchema", "spec.handsReadOnly", "spec.mcp", "spec.advisorModel", "spec.selector", "seat.checkpoint", "seat.workflows", "seat.offload", "seat.offloadBytes", "seat.lsp", "seat.artifact", "seat.question", "seat.sharedMemory", "seat.memoryEngine", "caps.allowWorkflows", "model.gate", "listing.skills", "listing.mcp", "listing.mcp.resources", "listing.a2a", "artifact.verdict", "advisor.route", "lsp.readFace", "names.declared", "names.occupied.sharedMemory", "names.occupied.memoryEngine", "names.deferred", "names.retracted"];
4
+ export type ToolMountFact = (typeof TOOL_MOUNT_FACTS)[number];
5
+ /** The name identity a mount judgment reads: a name and the spellings that dispatch to it. */
6
+ export interface ToolMountIdentity {
7
+ readonly name: string;
8
+ readonly aliases?: readonly string[];
9
+ }
10
+ /** The atomically-mounted groups one late judgment may take back off the roster (the memory pairs). */
11
+ export type ToolMountRetractable = "sharedMemory" | "memoryEngine";
12
+ /** A row's condition. Each leaf names the fact it reads; the composites are Kleene's. */
13
+ export type ToolMountCond = {
14
+ readonly fact: ToolMountFact;
15
+ }
16
+ /** The task's tool valve leaves this identity mounted (`spec.selector`). */
17
+ | {
18
+ readonly valve: string;
19
+ readonly aliases?: readonly string[];
20
+ }
21
+ /** A caller tool declares this name (`names.declared`); `viaAlias` also counts a caller alias. */
22
+ | {
23
+ readonly declared: string;
24
+ readonly viaAlias?: true;
25
+ }
26
+ /** The model's class gate keeps this caller tool (`model.gate`). */
27
+ | {
28
+ readonly kept: string;
29
+ }
30
+ /** The late judgment took this group back (`names.retracted`). */
31
+ | {
32
+ readonly retracted: ToolMountRetractable;
33
+ }
34
+ /** Another row's verdict. */
35
+ | {
36
+ readonly row: string;
37
+ } | {
38
+ readonly not: ToolMountCond;
39
+ } | {
40
+ readonly all: readonly ToolMountCond[];
41
+ } | {
42
+ readonly any: readonly ToolMountCond[];
43
+ };
44
+ /** The phases of a prepare, in the order it reaches them. */
45
+ export declare const TOOL_MOUNT_SEGMENTS: readonly ["caller", "synthetic", "workflow", "output", "protocol", "hands", "delegation", "question", "scheduler", "lsp", "artifact", "context", "advisor", "engine"];
46
+ export type ToolMountSegment = (typeof TOOL_MOUNT_SEGMENTS)[number];
47
+ /** One catalog row: the definition `id`, the phase that mounts it, the tag its mount carries, and its condition. */
48
+ export interface ToolMountRule {
49
+ readonly id: string;
50
+ readonly segment: ToolMountSegment;
51
+ readonly tag: ToolMountTag;
52
+ /** The condition the mount site asks. */
53
+ readonly when: ToolMountCond;
54
+ /** Mounted on the engine lane: the tool valve does not apply to it. */
55
+ readonly engineLane?: true;
56
+ /** The group a late judgment may take this definition back with. */
57
+ readonly retractable?: ToolMountRetractable;
58
+ }
59
+ /** The member families no catalog row names. */
60
+ export declare const TOOL_MOUNT_FAMILIES: readonly ["caller", "mcp", "mcp-resources", "a2a"];
61
+ export type ToolMountFamily = (typeof TOOL_MOUNT_FAMILIES)[number];
62
+ /** The rows, in prepare order. */
63
+ export declare const TOOL_MOUNT_RULES: readonly ToolMountRule[];
64
+ /** The catalog definition behind a row (every row names one). */
65
+ export declare function mountRuleEntry(rule: ToolMountRule): ToolCatalogEntry;
66
+ /** The names a retractable group's definitions answer to (the group whose names the leg reads as occupied before it mounts). */
67
+ export declare function mountGroupNames(group: ToolMountRetractable): readonly string[];
68
+ /** The row for a catalog id, or undefined when no row mounts that definition (a scenario definition a host mounts as its own). */
69
+ export declare function mountRuleOf(id: string): ToolMountRule | undefined;
70
+ /** A three-valued verdict and the facts that decided it (the open ones, when unknown). */
71
+ export interface ToolMountVerdict {
72
+ readonly value: boolean | "unknown";
73
+ readonly why: readonly ToolMountFact[];
74
+ }
75
+ /** What a reader of the rows can read: each answer is the fact's value, or `undefined` when it cannot be read. */
76
+ export interface ToolMountFactSource {
77
+ fact(f: ToolMountFact): boolean | undefined;
78
+ valve(identity: ToolMountIdentity): boolean | undefined;
79
+ declared(name: string, viaAlias: boolean): boolean | undefined;
80
+ kept(name: string): boolean | undefined;
81
+ retracted(group: ToolMountRetractable): boolean | undefined;
82
+ }
83
+ /** Kleene evaluation of one condition; `row` answers a cross-row reference. */
84
+ export declare function evaluateMountCond(cond: ToolMountCond, src: ToolMountFactSource, row: (id: string) => ToolMountVerdict): ToolMountVerdict;
85
+ /**
86
+ * Whether row `id`'s definition ends up on the roster (its condition, the valve, its group's retraction), over facts a
87
+ * phase states before the roster exists. A fact the row reads and the phase never stated is a fault, never a guess.
88
+ */
89
+ export declare function mountRowVerdict(id: string, facts: Partial<Record<ToolMountFact, boolean>>, leaves: (identity: ToolMountIdentity) => boolean): boolean;
90
+ /** The member sources a plan names. */
91
+ export type ToolMountSource = "builtin" | "synthetic" | "scenario" | "mcp" | "a2a";
92
+ /** One tool a plan names. */
93
+ export interface ToolMountPlanMember {
94
+ readonly name: string;
95
+ /** The catalog definition, when one is behind the member. */
96
+ readonly id?: string;
97
+ readonly source: ToolMountSource;
98
+ readonly mountedBy: ToolMountTag;
99
+ readonly state: "mounted" | "conditional";
100
+ /** For a conditional member: the facts that decide it. */
101
+ readonly when?: readonly ToolMountFact[];
102
+ }
103
+ /** A listing whose members are only known live. */
104
+ export interface ToolMountPlanFamily {
105
+ readonly source: "mcp" | "a2a";
106
+ readonly peer: string;
107
+ readonly state: "conditional";
108
+ readonly when: readonly ToolMountFact[];
109
+ }
110
+ /** A definition that does not mount, and the facts that keep it off (a caller's own tool carries no catalog id). */
111
+ export interface ToolMountPlanAbsent {
112
+ readonly id?: string;
113
+ readonly name: string;
114
+ readonly because: readonly ToolMountFact[];
115
+ }
116
+ /**
117
+ * The tools a leg mounts, read off the mount table. `static` is the deployment's reading before any task (a fact it
118
+ * cannot read leaves the member conditional); `effective` is a leg's own, after its prepare: every member mounted, and
119
+ * its members are the leg's roster.
120
+ */
121
+ export interface ToolMountPlan {
122
+ readonly half: "static" | "effective";
123
+ readonly members: readonly ToolMountPlanMember[];
124
+ readonly families: readonly ToolMountPlanFamily[];
125
+ readonly absent: readonly ToolMountPlanAbsent[];
126
+ }
127
+ /** A family member a static reader knows by name before the leg runs. */
128
+ export interface ToolMountPlannedMember {
129
+ readonly family: ToolMountFamily;
130
+ readonly identity: ToolMountIdentity;
131
+ /** The catalog definition behind it, when its contract is one. */
132
+ readonly id?: string;
133
+ readonly source: ToolMountSource;
134
+ readonly mountedBy: ToolMountTag;
135
+ /** The member's own condition (the family's listing fact, its class gate). */
136
+ readonly when: ToolMountCond;
137
+ }
138
+ /**
139
+ * The plan the rows give over `src`: each catalog row is a member (holds), a conditional member (open) or an absent
140
+ * definition (fails); `members` adds the family members a static reader knows by name (each under its own condition and
141
+ * the valve); `families` the listings it only knows by peer.
142
+ */
143
+ export declare function planToolMounts(src: ToolMountFactSource, members: readonly ToolMountPlannedMember[], families: readonly ToolMountPlanFamily[]): ToolMountPlan;
144
+ /** The internal fault the ledger raises when a mount and the table disagree. */
145
+ export declare const TOOL_MOUNT_PLAN_MISMATCH = "internal.tool_mount_plan_mismatch";
146
+ /** The leg's name domain, bound once its spec and valve are final. */
147
+ export interface ToolMountLegBinding {
148
+ /** The task's tool valve: does it leave this identity mounted? */
149
+ readonly leaves: (identity: ToolMountIdentity) => boolean;
150
+ /** The caller's own tools, as the class gate left them. */
151
+ readonly declared: readonly ToolMountIdentity[];
152
+ }
153
+ /** What the ledger reads off a mounted instance beside its name. */
154
+ export type ToolMountContractOf<T extends ToolMountIdentity> = (tool: T) => string;
155
+ /**
156
+ * The ledger a leg's roster builder carries. Facts enter once (`know`; a second, different word for a fact is a fault);
157
+ * a mount site asks `judge` / `judgeTool` / `judgeMember` and mounts on yes; `settle` checks, before the roster is
158
+ * snapshotted, that the instances on it are exactly the ones the rows said — by name, and by contract for every catalog
159
+ * definition — and that every row it was never asked about fails over the facts the leg stated.
160
+ */
161
+ export declare class ToolMountLedger<T extends ToolMountIdentity> {
162
+ #private;
163
+ constructor(contractOf: ToolMountContractOf<T>);
164
+ /** Bind the leg's name domain (once). */
165
+ bindLeg(leg: ToolMountLegBinding): void;
166
+ /** State facts. A fact stated twice must keep its word. */
167
+ know(facts: Partial<Record<ToolMountFact, boolean>>): void;
168
+ /** Has this fact been stated? */
169
+ knows(f: ToolMountFact): boolean;
170
+ /** Does row `id`'s condition hold — a READING (a fact another phase derives from the row), never a mount: nothing is
171
+ * recorded. */
172
+ holds(id: string): boolean;
173
+ /** Would row `id`'s condition hold were `assumed` stated as well — a reading for a phase that has to decide before the
174
+ * fact it assumes is live (the memory trio's injection is taught before its session mounts); nothing is recorded. */
175
+ holdsIf(id: string, assumed: Partial<Record<ToolMountFact, boolean>>): boolean;
176
+ /** The names of the rows `select` picks whose condition holds — a reading, as {@link holds}. */
177
+ holding(select: (entry: ToolCatalogEntry) => boolean): string[];
178
+ /** Does row `id` hold? A yes records the definition the roster must end up carrying. */
179
+ judge(id: string): boolean;
180
+ /** Does the row of the catalog definition this instance is hold? The instance names the row by name and contract. */
181
+ judgeTool(tool: T): boolean;
182
+ /** Mount a family member: its family's listing holds by construction (the member is in hand), so the member is
183
+ * recorded and the answer is yes — the valve decides it later, as it decides every other member. */
184
+ judgeMember(family: ToolMountFamily, tool: T): boolean;
185
+ /** The late judgment's word on a group (taken back or kept). */
186
+ retract(group: ToolMountRetractable, taken: boolean): void;
187
+ /**
188
+ * Check the roster against the rows: the instances on it (later mount wins, as the roster dispatches) must be the
189
+ * judged-yes definitions and members the valve and the retractions leave, one for one by name, each catalog
190
+ * definition under its own contract; every row never asked must fail over the leg's facts. Returns the leg's
191
+ * effective plan.
192
+ */
193
+ settle(onRoster: readonly T[], members: readonly ToolMountPlanMember[]): ToolMountPlan;
194
+ /** The effective plan, once settled. */
195
+ get plan(): ToolMountPlan | undefined;
196
+ }
@@ -0,0 +1,404 @@
1
+ import { TOOL_CATALOG_ENTRIES } from "./tool-catalog-entries.js";
2
+ export const TOOL_MOUNT_FACTS = Object.freeze([
3
+ "runner.self",
4
+ "leg.parentNotify",
5
+ "leg.peerLane",
6
+ "leg.taskNotification",
7
+ "leg.session",
8
+ "env.hands",
9
+ "env.performsIo",
10
+ "env.backgroundShell",
11
+ "env.scheduler",
12
+ "spec.enableBlockedReport",
13
+ "spec.planMode",
14
+ "spec.interactiveTools.on",
15
+ "spec.interactiveTools.off",
16
+ "spec.planFile",
17
+ "spec.selfOrchestration",
18
+ "spec.outputSchema",
19
+ "spec.handsReadOnly",
20
+ "spec.mcp",
21
+ "spec.advisorModel",
22
+ "spec.selector",
23
+ "seat.checkpoint",
24
+ "seat.workflows",
25
+ "seat.offload",
26
+ "seat.offloadBytes",
27
+ "seat.lsp",
28
+ "seat.artifact",
29
+ "seat.question",
30
+ "seat.sharedMemory",
31
+ "seat.memoryEngine",
32
+ "caps.allowWorkflows",
33
+ "model.gate",
34
+ "listing.skills",
35
+ "listing.mcp",
36
+ "listing.mcp.resources",
37
+ "listing.a2a",
38
+ "artifact.verdict",
39
+ "advisor.route",
40
+ "lsp.readFace",
41
+ "names.declared",
42
+ "names.occupied.sharedMemory",
43
+ "names.occupied.memoryEngine",
44
+ "names.deferred",
45
+ "names.retracted",
46
+ ]);
47
+ const FACT_SET = new Set(TOOL_MOUNT_FACTS);
48
+ const isMountFact = (k) => FACT_SET.has(k);
49
+ export const TOOL_MOUNT_SEGMENTS = Object.freeze(["caller", "synthetic", "workflow", "output", "protocol", "hands", "delegation", "question", "scheduler", "lsp", "artifact", "context", "advisor", "engine"]);
50
+ export const TOOL_MOUNT_FAMILIES = Object.freeze(["caller", "mcp", "mcp-resources", "a2a"]);
51
+ const F = (fact) => ({ fact });
52
+ const NOT = (not) => ({ not });
53
+ const ALL = (...all) => ({ all });
54
+ const ANY = (...any) => ({ any });
55
+ const ROW = (row) => ({ row });
56
+ const VALVE = (valve, aliases) => (aliases === undefined ? { valve } : { valve, aliases });
57
+ const DECLARED = (declared, viaAlias) => (viaAlias === undefined ? { declared } : { declared, viaAlias });
58
+ const HANDS = F("env.hands");
59
+ const WRITES = ALL(HANDS, NOT(F("spec.handsReadOnly")));
60
+ const SHELL = ALL(HANDS, F("env.performsIo"));
61
+ const FULL_SHELL = ALL(SHELL, NOT(F("spec.handsReadOnly")));
62
+ const BACKGROUND = ALL(FULL_SHELL, F("env.backgroundShell"));
63
+ const DELEGATION = ANY(BACKGROUND, ROW("workflow"));
64
+ const PLAN_PAIR = ALL(F("spec.planMode"), NOT(F("spec.interactiveTools.off")), ANY(F("spec.interactiveTools.on"), F("seat.checkpoint")));
65
+ const ENTRY_BY_ID = new Map(TOOL_CATALOG_ENTRIES.map((e) => [e.id, e]));
66
+ const entryOf = (id) => {
67
+ const e = ENTRY_BY_ID.get(id);
68
+ if (e === undefined)
69
+ throw mismatch(`mount row "${id}" names no catalog definition`);
70
+ return e;
71
+ };
72
+ const namesOf = (e) => [e.name, ...(e.face.aliases ?? [])];
73
+ const SHARED_MEMORY_IDS = ["memory-list", "memory-read"];
74
+ const ENGINE_MEMORY_IDS = ["memory-search", "memory-get", "memory-index"];
75
+ const LIST_AGENTS = entryOf("list-agents");
76
+ export const TOOL_MOUNT_RULES = Object.freeze([
77
+ { id: "report-blocked", segment: "synthetic", tag: "always", when: F("spec.enableBlockedReport") },
78
+ { id: "report-findings", segment: "synthetic", tag: "always", when: NOT(DECLARED("ReportFindings", true)) },
79
+ { id: "exit-plan-mode", segment: "synthetic", tag: "optional", when: ALL(PLAN_PAIR, NOT(F("spec.planFile"))) },
80
+ { id: "exit-plan-mode-file", segment: "synthetic", tag: "optional", when: ALL(PLAN_PAIR, F("spec.planFile")) },
81
+ { id: "enter-plan-mode", segment: "synthetic", tag: "optional", when: ALL(PLAN_PAIR, F("seat.checkpoint")) },
82
+ { id: "workflow", segment: "workflow", tag: "workflow", when: ALL(F("runner.self"), F("spec.selfOrchestration"), F("seat.workflows"), F("caps.allowWorkflows")) },
83
+ { id: "structured-output", segment: "output", tag: "optional", when: F("spec.outputSchema") },
84
+ { id: "refresh-mcp-tools", segment: "protocol", tag: "optional", when: F("spec.mcp") },
85
+ { id: "read", segment: "hands", tag: "hands", when: HANDS },
86
+ { id: "edit", segment: "hands", tag: "hands", when: WRITES },
87
+ { id: "write", segment: "hands", tag: "hands", when: WRITES },
88
+ { id: "notebook-edit", segment: "hands", tag: "hands", when: WRITES },
89
+ { id: "save-tool-result", segment: "hands", tag: "hands", when: ALL(WRITES, F("seat.offloadBytes")) },
90
+ { id: "grep", segment: "hands", tag: "hands", when: HANDS },
91
+ { id: "glob", segment: "hands", tag: "hands", when: HANDS },
92
+ { id: "repo-map", segment: "hands", tag: "hands", when: HANDS },
93
+ { id: "bash", segment: "hands", tag: "hands", when: FULL_SHELL },
94
+ { id: "bash-readonly", segment: "hands", tag: "hands", when: ALL(SHELL, F("spec.handsReadOnly")) },
95
+ { id: "task-stop", segment: "delegation", tag: "delegation", when: DELEGATION },
96
+ { id: "send-message", segment: "delegation", tag: "delegation", when: ALL(ANY(DELEGATION, F("leg.parentNotify"), F("leg.peerLane")), F("runner.self"), NOT(DECLARED("SendMessage"))) },
97
+ { id: "agent-transcript", segment: "delegation", tag: "delegation", when: ALL(DELEGATION, F("runner.self"), NOT(DECLARED("SendMessage")), NOT(DECLARED("AgentTranscript"))) },
98
+ { id: "read-inbox", segment: "delegation", tag: "peerLane", when: ALL(F("leg.taskNotification"), VALVE("ReadInbox"), NOT(DECLARED("ReadInbox"))) },
99
+ {
100
+ id: "list-agents",
101
+ segment: "delegation",
102
+ tag: "peerLane",
103
+ when: ALL(ANY(F("leg.peerLane"), DELEGATION), F("runner.self"), NOT(DECLARED("SendMessage")), VALVE("SendMessage"), VALVE(LIST_AGENTS.name, LIST_AGENTS.face.aliases), ...namesOf(LIST_AGENTS).map((n) => NOT(DECLARED(n, true)))),
104
+ },
105
+ { id: "monitor", segment: "delegation", tag: "backgroundTasks", when: BACKGROUND },
106
+ { id: "enter-worktree", segment: "delegation", tag: "hands", when: FULL_SHELL },
107
+ { id: "exit-worktree", segment: "delegation", tag: "hands", when: FULL_SHELL },
108
+ { id: "read-tool-result", segment: "delegation", tag: "optional", when: F("seat.offload") },
109
+ { id: "ask-user-question", segment: "question", tag: "optional", when: ALL(ANY(F("spec.interactiveTools.on"), ALL(NOT(F("spec.interactiveTools.off")), F("seat.question"))), VALVE("AskUserQuestion")) },
110
+ { id: "cron-create", segment: "scheduler", tag: "scheduler", when: ALL(NOT(F("spec.handsReadOnly")), F("env.scheduler")) },
111
+ { id: "cron-delete", segment: "scheduler", tag: "scheduler", when: ALL(NOT(F("spec.handsReadOnly")), F("env.scheduler")) },
112
+ { id: "cron-list", segment: "scheduler", tag: "scheduler", when: ALL(NOT(F("spec.handsReadOnly")), F("env.scheduler")) },
113
+ { id: "schedule-wakeup", segment: "scheduler", tag: "scheduler", when: ALL(NOT(F("spec.handsReadOnly")), F("env.scheduler"), F("leg.session")) },
114
+ { id: "lsp", segment: "lsp", tag: "hands", when: ALL(HANDS, F("seat.lsp"), F("lsp.readFace")) },
115
+ { id: "artifact", segment: "artifact", tag: "optional", when: ALL(F("seat.artifact"), F("artifact.verdict")) },
116
+ { id: "skill", segment: "context", tag: "optional", when: F("listing.skills") },
117
+ ...SHARED_MEMORY_IDS.map((id) => ({
118
+ id,
119
+ segment: "context",
120
+ tag: "memory",
121
+ when: ALL(F("seat.sharedMemory"), ...SHARED_MEMORY_IDS.map((m) => VALVE(entryOf(m).name)), NOT(F("names.occupied.sharedMemory"))),
122
+ retractable: "sharedMemory",
123
+ })),
124
+ ...ENGINE_MEMORY_IDS.map((id) => ({
125
+ id,
126
+ segment: "context",
127
+ tag: "memory",
128
+ when: ALL(F("seat.memoryEngine"), ...ENGINE_MEMORY_IDS.map((m) => VALVE(entryOf(m).name)), NOT(F("names.occupied.memoryEngine"))),
129
+ retractable: "memoryEngine",
130
+ })),
131
+ { id: "advisor", segment: "advisor", tag: "optional", when: ALL(F("spec.advisorModel"), VALVE("advisor"), F("advisor.route")) },
132
+ { id: "tool-search", segment: "engine", tag: "optional", when: F("names.deferred"), engineLane: true },
133
+ ]);
134
+ const RULE_BY_ID = new Map(TOOL_MOUNT_RULES.map((r) => [r.id, r]));
135
+ export function mountRuleEntry(rule) {
136
+ return entryOf(rule.id);
137
+ }
138
+ export function mountGroupNames(group) {
139
+ return TOOL_MOUNT_RULES.filter((r) => r.retractable === group).flatMap((r) => namesOf(mountRuleEntry(r)));
140
+ }
141
+ export function mountRuleOf(id) {
142
+ return RULE_BY_ID.get(id);
143
+ }
144
+ const leaf = (v, f) => ({ value: v === undefined ? "unknown" : v, why: [f] });
145
+ const union = (vs) => [...new Set(vs.flatMap((v) => v.why))];
146
+ export function evaluateMountCond(cond, src, row) {
147
+ if ("fact" in cond)
148
+ return leaf(src.fact(cond.fact), cond.fact);
149
+ if ("valve" in cond)
150
+ return leaf(src.valve(cond.aliases === undefined ? { name: cond.valve } : { name: cond.valve, aliases: cond.aliases }), "spec.selector");
151
+ if ("declared" in cond)
152
+ return leaf(src.declared(cond.declared, cond.viaAlias === true), "names.declared");
153
+ if ("kept" in cond)
154
+ return leaf(src.kept(cond.kept), "model.gate");
155
+ if ("retracted" in cond)
156
+ return leaf(src.retracted(cond.retracted), "names.retracted");
157
+ if ("row" in cond)
158
+ return row(cond.row);
159
+ if ("not" in cond) {
160
+ const v = evaluateMountCond(cond.not, src, row);
161
+ return { value: v.value === "unknown" ? "unknown" : !v.value, why: v.why };
162
+ }
163
+ const parts = ("all" in cond ? cond.all : cond.any).map((c) => evaluateMountCond(c, src, row));
164
+ const decisive = "all" in cond ? false : true;
165
+ const decided = parts.filter((p) => p.value === decisive);
166
+ if (decided.length > 0)
167
+ return { value: decisive, why: union(decided) };
168
+ const open = parts.filter((p) => p.value === "unknown");
169
+ if (open.length > 0)
170
+ return { value: "unknown", why: union(open) };
171
+ return { value: !decisive, why: union(parts) };
172
+ }
173
+ function finalCond(rule) {
174
+ const e = mountRuleEntry(rule);
175
+ const parts = [rule.when];
176
+ if (rule.engineLane !== true)
177
+ parts.push(VALVE(e.name, e.face.aliases));
178
+ if (rule.retractable !== undefined)
179
+ parts.push(NOT({ retracted: rule.retractable }));
180
+ return ALL(...parts);
181
+ }
182
+ function rowVerdicts(src) {
183
+ const memo = new Map();
184
+ const of = (id) => {
185
+ const hit = memo.get(id);
186
+ if (hit !== undefined)
187
+ return hit;
188
+ const rule = RULE_BY_ID.get(id);
189
+ if (rule === undefined)
190
+ throw mismatch(`mount condition names no row "${id}"`);
191
+ const v = evaluateMountCond(rule.when, src, of);
192
+ memo.set(id, v);
193
+ return v;
194
+ };
195
+ return of;
196
+ }
197
+ export function mountRowVerdict(id, facts, leaves) {
198
+ const rule = RULE_BY_ID.get(id);
199
+ if (rule === undefined)
200
+ throw mismatch(`no mount row "${id}"`);
201
+ const src = { fact: (f) => facts[f], valve: leaves, declared: () => undefined, kept: () => true, retracted: () => undefined };
202
+ const v = evaluateMountCond(finalCond(rule), src, rowVerdicts(src));
203
+ if (v.value === "unknown")
204
+ throw mismatch(`the row "${id}" asked ${v.why.join(", ")}, which was never stated`);
205
+ return v.value;
206
+ }
207
+ export function planToolMounts(src, members, families) {
208
+ const row = rowVerdicts(src);
209
+ const out = [];
210
+ const absent = [];
211
+ const place = (name, id, source, mountedBy, v) => {
212
+ if (v.value === false) {
213
+ absent.push({ ...(id !== undefined ? { id } : {}), name, because: v.why });
214
+ return;
215
+ }
216
+ out.push({ name, ...(id !== undefined ? { id } : {}), source, mountedBy, state: v.value === true ? "mounted" : "conditional", ...(v.value === "unknown" ? { when: v.why } : {}) });
217
+ };
218
+ for (const m of members) {
219
+ const v = evaluateMountCond(ALL(m.when, VALVE(m.identity.name, m.identity.aliases)), src, row);
220
+ place(m.identity.name, m.id, m.source, m.mountedBy, v);
221
+ }
222
+ for (const rule of TOOL_MOUNT_RULES) {
223
+ const e = mountRuleEntry(rule);
224
+ place(e.name, e.id, e.source, rule.tag, evaluateMountCond(finalCond(rule), src, row));
225
+ }
226
+ const kept = dedupeLaterWins(out);
227
+ const named = new Set(kept.map((m) => m.name));
228
+ return { half: "static", members: kept, families: [...families], absent: absent.filter((a) => !named.has(a.name)) };
229
+ }
230
+ function dedupeLaterWins(members) {
231
+ const byName = new Map();
232
+ for (const m of members) {
233
+ byName.delete(m.name);
234
+ byName.set(m.name, m);
235
+ }
236
+ return [...byName.values()];
237
+ }
238
+ export const TOOL_MOUNT_PLAN_MISMATCH = "internal.tool_mount_plan_mismatch";
239
+ function mismatch(message) {
240
+ return Object.assign(new Error(`tool mount plan: ${message}`), { code: TOOL_MOUNT_PLAN_MISMATCH });
241
+ }
242
+ export class ToolMountLedger {
243
+ #contractOf;
244
+ #facts = new Map();
245
+ #retracted = new Map();
246
+ #judged = new Map();
247
+ #expected = [];
248
+ #leg;
249
+ #plan;
250
+ constructor(contractOf) {
251
+ this.#contractOf = contractOf;
252
+ }
253
+ bindLeg(leg) {
254
+ if (this.#leg !== undefined)
255
+ throw mismatch("the leg's name domain was bound twice");
256
+ this.#leg = leg;
257
+ }
258
+ know(facts) {
259
+ for (const [k, v] of Object.entries(facts)) {
260
+ if (!isMountFact(k))
261
+ throw mismatch(`"${k}" is not a mount fact`);
262
+ if (typeof v !== "boolean")
263
+ continue;
264
+ const had = this.#facts.get(k);
265
+ if (had !== undefined && had !== v)
266
+ throw mismatch(`the fact ${k} was stated ${had} and then ${v}`);
267
+ this.#facts.set(k, v);
268
+ }
269
+ }
270
+ knows(f) {
271
+ return this.#facts.has(f);
272
+ }
273
+ #source() {
274
+ const leg = () => {
275
+ if (this.#leg === undefined)
276
+ throw mismatch("a mount judgment read the name domain before it was bound");
277
+ return this.#leg;
278
+ };
279
+ return {
280
+ fact: (f) => this.#facts.get(f),
281
+ valve: (identity) => leg().leaves(identity),
282
+ declared: (name, viaAlias) => leg().declared.some((t) => t.name === name || (viaAlias && t.aliases?.includes(name) === true)),
283
+ kept: () => true,
284
+ retracted: (g) => this.#retracted.get(g),
285
+ };
286
+ }
287
+ #verdict(id) {
288
+ const v = rowVerdicts(this.#source())(id);
289
+ if (v.value === "unknown")
290
+ throw mismatch(`the row "${id}" asked ${v.why.join(", ")}, which this leg never stated`);
291
+ return v;
292
+ }
293
+ holds(id) {
294
+ if (!RULE_BY_ID.has(id))
295
+ throw mismatch(`no mount row "${id}"`);
296
+ return this.#verdict(id).value === true;
297
+ }
298
+ holdsIf(id, assumed) {
299
+ if (!RULE_BY_ID.has(id))
300
+ throw mismatch(`no mount row "${id}"`);
301
+ const base = this.#source();
302
+ const v = rowVerdicts({ ...base, fact: (f) => assumed[f] ?? base.fact(f) })(id);
303
+ if (v.value === "unknown")
304
+ throw mismatch(`the row "${id}" asked ${v.why.join(", ")}, which this leg never stated`);
305
+ return v.value === true;
306
+ }
307
+ holding(select) {
308
+ const out = new Set();
309
+ for (const rule of TOOL_MOUNT_RULES) {
310
+ const e = mountRuleEntry(rule);
311
+ if (select(e) && this.holds(rule.id))
312
+ out.add(e.name);
313
+ }
314
+ return [...out];
315
+ }
316
+ judge(id) {
317
+ const had = this.#judged.get(id);
318
+ if (had !== undefined)
319
+ return had;
320
+ const rule = RULE_BY_ID.get(id);
321
+ if (rule === undefined)
322
+ throw mismatch(`no mount row "${id}"`);
323
+ const holds = this.#verdict(id).value === true;
324
+ this.#judged.set(id, holds);
325
+ if (holds) {
326
+ const e = mountRuleEntry(rule);
327
+ this.#expected.push({
328
+ name: e.name,
329
+ ...(e.face.aliases !== undefined ? { aliases: e.face.aliases } : {}),
330
+ rowId: id,
331
+ ...(e.face.contract !== undefined ? { contract: e.face.contract.contractId } : {}),
332
+ ...(rule.engineLane === true ? { engineLane: true } : {}),
333
+ ...(rule.retractable !== undefined ? { retractable: rule.retractable } : {}),
334
+ });
335
+ }
336
+ return holds;
337
+ }
338
+ judgeTool(tool) {
339
+ const contract = this.#contractOf(tool);
340
+ const rule = TOOL_MOUNT_RULES.find((r) => {
341
+ const e = mountRuleEntry(r);
342
+ return e.name === tool.name && (e.face.contract === undefined || e.face.contract.contractId === contract);
343
+ });
344
+ if (rule === undefined)
345
+ throw mismatch(`"${tool.name}" (${contract}) is no catalog definition a mount row names`);
346
+ return this.judge(rule.id);
347
+ }
348
+ judgeMember(family, tool) {
349
+ this.#expected.push({ name: tool.name, ...(tool.aliases !== undefined ? { aliases: tool.aliases } : {}), family, contract: this.#contractOf(tool) });
350
+ return true;
351
+ }
352
+ retract(group, taken) {
353
+ const had = this.#retracted.get(group);
354
+ if (had !== undefined && had !== taken)
355
+ throw mismatch(`the ${group} retraction was stated ${had} and then ${taken}`);
356
+ this.#retracted.set(group, taken);
357
+ }
358
+ settle(onRoster, members) {
359
+ const leg = this.#leg;
360
+ if (leg === undefined)
361
+ throw mismatch("the roster settled before its name domain was bound");
362
+ const survives = (e) => (e.engineLane === true || leg.leaves(e)) && (e.retractable === undefined || this.#retracted.get(e.retractable) !== true);
363
+ const expected = laterWins(this.#expected.filter(survives));
364
+ const actual = laterWins(onRoster);
365
+ for (const name of new Set([...expected.keys(), ...actual.keys()])) {
366
+ const e = expected.get(name), a = actual.get(name);
367
+ if (e === undefined)
368
+ throw mismatch(`"${name}" is on the roster but no mount row or member judgment put it there`);
369
+ if (a === undefined)
370
+ throw mismatch(`"${name}" was judged mounted (${e.rowId ?? e.family}) but is not on the roster`);
371
+ if (e.contract !== undefined && this.#contractOf(a) !== e.contract)
372
+ throw mismatch(`"${name}" answers as ${this.#contractOf(a)}, but its row mounts ${e.contract}`);
373
+ if (e.engineLane !== true && !leg.leaves(a))
374
+ throw mismatch(`"${name}" dispatches to an instance the valve takes out`);
375
+ }
376
+ const src = this.#source();
377
+ const row = rowVerdicts(src);
378
+ const absent = [];
379
+ for (const rule of TOOL_MOUNT_RULES) {
380
+ const e = mountRuleEntry(rule);
381
+ const v = evaluateMountCond(finalCond(rule), src, row);
382
+ if (v.value === "unknown")
383
+ throw mismatch(`the row "${rule.id}" was left open: ${v.why.join(", ")} never stated`);
384
+ if (!this.#judged.has(rule.id) && evaluateMountCond(rule.when, src, row).value === true)
385
+ throw mismatch(`the row "${rule.id}" holds but its mount site never asked`);
386
+ if (v.value === false && !actual.has(e.name))
387
+ absent.push({ id: e.id, name: e.name, because: v.why });
388
+ }
389
+ for (const t of leg.declared)
390
+ if (!leg.leaves(t) && !actual.has(t.name))
391
+ absent.push({ name: t.name, because: ["spec.selector"] });
392
+ this.#plan = { half: "effective", members, families: [], absent };
393
+ return this.#plan;
394
+ }
395
+ get plan() {
396
+ return this.#plan;
397
+ }
398
+ }
399
+ function laterWins(items) {
400
+ const out = new Map();
401
+ for (const t of items)
402
+ out.set(t.name, t);
403
+ return out;
404
+ }
@@ -0,0 +1,12 @@
1
+ import { type MountFactDeps, type MountFactSpec } from "./tool-mount-facts.js";
2
+ import { type ToolMountPlan } from "./tool-mount-plan.js";
3
+ import type { RunnerDeps, TaskSpec } from "./types.js";
4
+ /** The deps members the static reading reads. */
5
+ export type StaticToolPlanDeps = MountFactDeps & Pick<RunnerDeps, "checkpointStore" | "sessionStore" | "peerDirectory" | "mailboxStore" | "executionEnv" | "executionEnvFactory" | "runtimeCapsResolver" | "memoryBackend" | "toolResultThresholdChars" | "toolResultStore" | "toolModelGate" | "models" | "tiers" | "roles" | "onQuestion" | "lockedConfig" | "toolPolicy" | "basePolicyForResumeEdit" | "peerSeat">;
6
+ /** The spec members the static reading reads. */
7
+ export type StaticToolPlanSpec = MountFactSpec & Pick<TaskSpec, "tools" | "allowTools" | "excludeTools" | "excludeAllTools" | "deferTools" | "alwaysLoadTools" | "restoreGatedTools" | "permissionMode" | "shellGate" | "planFile" | "mcp" | "a2a" | "toolPolicy" | "basePolicyForResumeEdit" | "sessionId" | "memory" | "model" | "modelRole" | "roles" | "thinking" | "toolResultThresholdChars" | "checkpointStore" | "onQuestion" | "durableApproval">;
8
+ /**
9
+ * The static plan of `(deps, spec)`: the mount table's rows, the caller's own tools, the MCP resource trio and the declared
10
+ * peers' families, evaluated over the facts read above. Refuses a spec prepare would refuse at the same doors.
11
+ */
12
+ export declare function planStaticToolMounts(deps: StaticToolPlanDeps, spec: StaticToolPlanSpec): ToolMountPlan;