@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
@@ -1,4 +1,6 @@
1
1
  import { describeRejectedValue } from "./tool-search-setting.js";
2
+ import { isPlainRecord } from "./mods/kernel/receive.js";
3
+ import { receivedToolData } from "./tool-data-door.js";
2
4
  export function isErrorLike(value) {
3
5
  try {
4
6
  if (value instanceof Error)
@@ -21,6 +23,11 @@ export function thrownName(err) {
21
23
  const name = isErrorLike(err) ? readMember(err, "name") : undefined;
22
24
  return typeof name === "string" ? name : undefined;
23
25
  }
26
+ const MAX_THROWN_NAME_CHARS = 64;
27
+ export function boundedThrownName(e) {
28
+ const name = thrownName(e);
29
+ return name === undefined || name === "" ? typeof e : name.slice(0, MAX_THROWN_NAME_CHARS);
30
+ }
24
31
  export function thrownText(err) {
25
32
  try {
26
33
  if (typeof err === "string")
@@ -57,13 +64,18 @@ export function asThrownError(err) {
57
64
  return new Error(thrownLabel(err));
58
65
  }
59
66
  export function readMember(value, key) {
67
+ const read = readMemberOrUnreadable(value, key);
68
+ return read === UNREADABLE ? undefined : read;
69
+ }
70
+ export const UNREADABLE = Symbol("unreadable member");
71
+ export function readMemberOrUnreadable(value, key) {
60
72
  try {
61
73
  if (value === null || value === undefined)
62
74
  return undefined;
63
75
  return value[key];
64
76
  }
65
77
  catch {
66
- return undefined;
78
+ return UNREADABLE;
67
79
  }
68
80
  }
69
81
  export function readOwnMembers(value) {
@@ -81,10 +93,34 @@ export function readOwnMembers(value) {
81
93
  Object.defineProperty(out, key, { value: readMember(value, key), enumerable: true, writable: true, configurable: true });
82
94
  return out;
83
95
  }
96
+ function isArrayIndex(key) {
97
+ const n = Number(key);
98
+ return Number.isInteger(n) && n >= 0 && n < 4_294_967_295 && String(n) === key;
99
+ }
100
+ export function readElements(value) {
101
+ let keys;
102
+ try {
103
+ if (!Array.isArray(value))
104
+ return undefined;
105
+ keys = Object.getOwnPropertyNames(value);
106
+ }
107
+ catch {
108
+ return undefined;
109
+ }
110
+ return keys.filter(isArrayIndex).map((k) => readMember(value, k));
111
+ }
84
112
  export function thrownMarksOf(err) {
85
- const details = readOwnMembers(readMember(err, "details"));
113
+ const received = receivedToolData(readMember(err, "details"));
114
+ const details = isPlainRecord(received) ? received : undefined;
86
115
  const errorKind = readMember(err, "errorKind");
87
116
  if (typeof errorKind !== "string")
88
117
  return details;
89
118
  return { ...(details ?? {}), errorKind };
90
119
  }
120
+ const ENGINE_CODE_SPELLING = /^[a-z][a-zA-Z0-9_]*(?:\.[a-zA-Z0-9_]+)*$/;
121
+ export function isEngineCodeShape(code) {
122
+ return typeof code === "string" && ENGINE_CODE_SPELLING.test(code);
123
+ }
124
+ export function codedRefusal(code, message) {
125
+ return Object.assign(new Error(message), { code, details: Object.freeze({ code }) });
126
+ }
@@ -15,11 +15,11 @@ const c = (contractId, implementationRevision = "1") => ({ contractId, implement
15
15
  export const TOOL_CATALOG_ENTRIES = [
16
16
  {
17
17
  id: "read", name: "Read", source: "builtin", definedIn: "src/tools/fs/fs-read.ts", mountedBy: ["hands"],
18
- cards: ["text", "notebook", "file_unchanged", "image", "document"],
18
+ cards: ["text", "notebook", "image", "document"],
19
19
  face: {
20
- family: "file-read", boundaryLegs: ["env"], effect: "read", contract: c("core.read@1"),
20
+ family: "file-read", boundaryLegs: ["env"], effect: "read", contract: c("core.read@1", "2"),
21
21
  pathTarget: { param: "file_path", aliases: ["path"], access: "read", base: "cwd", absent: "none" },
22
- ruleFace: { params: ["file_path", "path", "offset", "limit", "pages"] },
22
+ ruleFace: { params: ["file_path", "path", "offset", "limit", "pages", "allow_large"] },
23
23
  renderHints: { summaryParams: ["file_path"] },
24
24
  offload: false, compactable: true, budgetExempt: true,
25
25
  },
@@ -56,6 +56,16 @@ export const TOOL_CATALOG_ENTRIES = [
56
56
  renderHints: { userFacingName: "Edit Notebook", summaryParams: ["notebook_path"], approvalCard: "notebook-edit" },
57
57
  },
58
58
  },
59
+ {
60
+ id: "save-tool-result", name: "SaveToolResult", source: "builtin", definedIn: "src/tools/fs/fs-write.ts", mountedBy: ["hands"],
61
+ cards: [],
62
+ face: {
63
+ family: "file-write", boundaryLegs: ["env"], effect: "write", contract: c("core.save_tool_result@1"),
64
+ pathTarget: { param: "file_path", aliases: ["path"], access: "create", base: "cwd", absent: "none" },
65
+ ruleFace: { params: ["ref", "file_path", "path"] },
66
+ renderHints: { summaryParams: ["file_path"], approvalCard: "generic" },
67
+ },
68
+ },
59
69
  {
60
70
  id: "bash", name: "Bash", source: "builtin", definedIn: "src/tools/fs/fs-bash.ts", mountedBy: ["hands"],
61
71
  cards: ["bash", "readonly_out_of_root", "read_unestablished", "bash_invalid_timeout", "bash_self_kill_refused"],
@@ -0,0 +1,7 @@
1
+ /**
2
+ * THE tool door: a value a tool body handed the engine — a member of what its `execute` returned, or the `details` mark of
3
+ * what it threw (read by `thrownMarksOf`) — as data the engine owns. Primitives are themselves; anything the receipt refuses
4
+ * (a Proxy, an object with its own `toJSON`, a bigint or a symbol at the top) is absent. The copy of an object the engine
5
+ * holds a receipt for holds it too — the receipt crosses with the object, never as a member.
6
+ */
7
+ export declare function receivedToolData(v: unknown): unknown;
@@ -0,0 +1,13 @@
1
+ import { types } from "node:util";
2
+ import { receive } from "./mods/kernel/receive.js";
3
+ import { carryNotStartedReceipt } from "./delegation-not-started.js";
4
+ const TOOL_DATA_MODE = Object.freeze({ accessors: "call-once", depth: Infinity, others: "copy", contain: true, wire: true, isProxy: (v) => types.isProxy(v) });
5
+ export function receivedToolData(v) {
6
+ if (v === null || v === undefined || typeof v === "string" || typeof v === "number" || typeof v === "boolean")
7
+ return v;
8
+ const r = receive(v, TOOL_DATA_MODE);
9
+ if (!r.ok)
10
+ return undefined;
11
+ carryNotStartedReceipt(v, r.value);
12
+ return r.value;
13
+ }
@@ -0,0 +1,25 @@
1
+ /**
2
+ * The frozen task-start copies of the caller's tool-face control arrays: the selector's own layer (`allow` / `exclude`) and
3
+ * the disclosure lists. The driver compiles the selector from them once the leg's delegation facts are known.
4
+ */
5
+ export interface ToolFaceLists {
6
+ allow: readonly string[] | undefined;
7
+ exclude: readonly string[] | undefined;
8
+ defer: readonly string[] | undefined;
9
+ alwaysLoad: readonly string[] | undefined;
10
+ restoreGated: readonly string[] | true | undefined;
11
+ }
12
+ /** The spec members the reader reads — each `unknown`, because the reader is the screen. */
13
+ export interface ToolFaceListsSpec {
14
+ readonly allowTools?: unknown;
15
+ readonly excludeTools?: unknown;
16
+ readonly deferTools?: unknown;
17
+ readonly alwaysLoadTools?: unknown;
18
+ readonly restoreGatedTools?: unknown;
19
+ }
20
+ /**
21
+ * Read the five tool-face lists: the restore selector first (its own refusal, `config.tool_model_gate_invalid`), then the four
22
+ * name lists in the order `allowTools`, `excludeTools`, `deferTools`, `alwaysLoadTools` (`config.tool_face_control`), and the
23
+ * snapshot. Every list is one frozen copy, shared by reference with every reader.
24
+ */
25
+ export declare function readToolFaceLists(spec: ToolFaceListsSpec): ToolFaceLists;
@@ -0,0 +1,38 @@
1
+ import { assertRestoreGatedToolsValue } from "./tool-model-gate.js";
2
+ function toolFaceListRefusal(message, reason) {
3
+ const e = new Error(message);
4
+ e.code = "config.tool_face_control";
5
+ e.detail = { reason };
6
+ return e;
7
+ }
8
+ function toolNameList(value, seat) {
9
+ if (value === undefined)
10
+ return undefined;
11
+ if (!Array.isArray(value)) {
12
+ throw toolFaceListRefusal(`TaskSpec.${seat} must be an array of tool names or absent (got ${value === null ? "null" : typeof value}) — a garbage list must refuse loudly, never be read as "no ${seat}".`, "not_a_list");
13
+ }
14
+ const entries = value;
15
+ const names = [];
16
+ for (const entry of entries) {
17
+ if (typeof entry !== "string") {
18
+ throw toolFaceListRefusal(`TaskSpec.${seat} entries must be strings (got ${entry === null ? "null" : typeof entry}).`, "not_a_string");
19
+ }
20
+ names.push(entry);
21
+ }
22
+ return Object.freeze(names);
23
+ }
24
+ export function readToolFaceLists(spec) {
25
+ const restore = spec.restoreGatedTools;
26
+ assertRestoreGatedToolsValue(restore);
27
+ const allow = toolNameList(spec.allowTools, "allowTools");
28
+ const exclude = toolNameList(spec.excludeTools, "excludeTools");
29
+ const defer = toolNameList(spec.deferTools, "deferTools");
30
+ const alwaysLoad = toolNameList(spec.alwaysLoadTools, "alwaysLoadTools");
31
+ return {
32
+ allow,
33
+ exclude,
34
+ defer,
35
+ alwaysLoad,
36
+ restoreGated: restore === true ? true : restore !== undefined ? Object.freeze([...restore]) : undefined,
37
+ };
38
+ }
@@ -1,13 +1,3 @@
1
- /**
2
- * The READER of an MCP server's `toolFaces` declaration ({@link McpServerSpec.toolFaces}, the per-tool FACE overlay): `readToolFaces(declared)`,
3
- * the face-side sibling of `readToolAxes` (`mcp-server-spec.ts`). The engine's preparation door and its MCP materialization entrance ask it
4
- * (`locked-config.ts`), and a host that assembles the field from JSON (a console's write door, a deployment intake) asks it at its own door:
5
- * one reading of the declaration, whoever asks and whenever. The mount ({@link applyMcpToolFaces}) then consumes the reader's copy and never
6
- * the raw object, and judges each face against the materialized schema with the very judge this reader ends in.
7
- *
8
- * It sits beside `mcp-server-spec.ts` rather than in the runner directory the mount lives in: it is the declaration's door, not a station of
9
- * the prepare path, and the public surface is tiered by where a symbol is declared (`readToolAxes` is `advanced` for the same reason).
10
- */
11
1
  import { type McpServerSpec } from "./mcp-server-spec.js";
12
2
  /** Every member name a face declaration has, at any depth — the words a `toolFaces` refusal's member path spells (derived from the tables above). */
13
3
  export declare const TOOL_FACE_WORDS: ReadonlySet<string>;
@@ -1,4 +1,5 @@
1
- import { callerText, dataKind, perToolEmptyName, perToolEntryRefusal, receivePerToolDeclaration } from "./mcp-server-spec.js";
1
+ import { callerText, dataKind } from "./caller-text.js";
2
+ import { perToolEmptyName, perToolEntryRefusal, receivePerToolDeclaration } from "./mcp-server-spec.js";
2
3
  import { isPlainRecord } from "./mods/kernel/receive.js";
3
4
  import { strayMembersOf } from "./own-property-receipt.js";
4
5
  import { faceProblem } from "./runner/tool-face-overlay.js";
@@ -80,7 +81,8 @@ export function readToolFaces(declared) {
80
81
  if (!received.ok)
81
82
  return { ok: false, problem: received.problem };
82
83
  const entries = [];
83
- for (const [tool, raw] of Object.entries(received.perTool)) {
84
+ const declaredEntries = Object.entries(received.perTool);
85
+ for (const [index, [tool, raw]] of declaredEntries.entries()) {
84
86
  if (tool.length === 0)
85
87
  return { ok: false, problem: perToolEmptyName("toolFaces", "tool") };
86
88
  let face;
@@ -91,7 +93,7 @@ export function readToolFaces(declared) {
91
93
  face = "a member threw while it was read";
92
94
  }
93
95
  if (typeof face === "string")
94
- return { ok: false, problem: perToolEntryRefusal("toolFaces", "tool", tool, inlineUntrusted(face, 240)) };
96
+ return { ok: false, problem: perToolEntryRefusal("toolFaces", "tool", tool, inlineUntrusted(face, 240), { index, of: declaredEntries.length }) };
95
97
  entries.push([tool, face]);
96
98
  }
97
99
  return entries.length > 0 ? { ok: true, faces: Object.fromEntries(entries) } : { ok: true };
@@ -0,0 +1,103 @@
1
+ import { type ToolNameListSide } from "./tool-name-list.js";
2
+ /** YAML's white space — the space and the tab — THE one definition: every test that reads a blank reads it here (a
3
+ * no-break space, a line break, any other space character is text). */
4
+ export declare const isBlank: (ch: string) => boolean;
5
+ /** Why a list cannot be read — clauses a reader puts in its sentence; none quotes the list's own text. */
6
+ export declare const PARENS_NOT_ONE_ZONE = "an entry's parentheses are not one group that closes it (a `(` that does not close, a `)` with no `(`, or text after the closing `)` \u2014 `\\(` / `\\)` are a rule's own text)";
7
+ export declare const SEQUENCE_NOT_A_NAME = "an entry is not a plain or quoted name (nested, mapping, anchor, tag, flow and block-scalar entries, and number, boolean and null entries, are not read)";
8
+ /** An entry the rule syntax cannot read, by its place in the list (counted from 1; the entry itself is not quoted). */
9
+ export declare const notARule: (position: number) => string;
10
+ /**
11
+ * The cut, run over ONE scalar's text at a time (a reader of YAML's structure reads that first): entries end at every comma
12
+ * and every SPACE character outside parentheses. A `(` opens a zone a matching `)` closes, nested zones counted
13
+ * (`Bash(echo $(date) now)` is one entry); a parenthesis after an odd run of backslashes is the rule's escaped text
14
+ * (`\(` / `\)`, the rule syntax's own escape) and counts for nothing. An entry's parentheses are ONE zone that closes the
15
+ * entry: a `)` with no zone open, a zone the scalar leaves open, and anything but a separator after the `)` that closes the
16
+ * zone (`Bash(a)(b)`, two rules joined by a tab or a no-break space) are the one problem of parentheses, kept for the list
17
+ * ({@link problem}) and for the entry it is in ({@link brokenParens}). Each entry loses the blanks at its ends and an empty
18
+ * one is dropped (`Read,Grep,` is two). A tab is no separator. What else an entry must be is the rule syntax's to say, asked
19
+ * once the whole list is read.
20
+ */
21
+ export declare class EntryCutter {
22
+ readonly entries: string[];
23
+ /** Per entry, at its index in {@link entries}: its parentheses are not one zone that closes it. */
24
+ readonly brokenParens: boolean[];
25
+ problem: string | undefined;
26
+ /** Parentheses open in the current scalar: inside one nothing cuts. */
27
+ private depth;
28
+ /** The current entry's zone opened and closed again: only a separator may follow. */
29
+ private closed;
30
+ private current;
31
+ /** The current entry's parentheses are not one zone. */
32
+ private currentBroken;
33
+ /** Blanks read after the entry's last other character, written only when another one follows: an entry's leading and
34
+ * trailing blanks, and the blanks a line break drops, never are (and no line break makes the cut look back). */
35
+ private blanks;
36
+ /** The character pushed last was a backslash that escapes the next one. */
37
+ private escaping;
38
+ push(ch: string): void;
39
+ /** `breaks` line breaks inside a scalar, as YAML folds them: the blanks before them go, one reads as a space (which
40
+ * separates entries outside parentheses), and more than one keeps all but one as line breaks of the text. */
41
+ fold(breaks: number): void;
42
+ /** The scalar is over: its last entry is cut, and a zone it left open is a problem. */
43
+ endScalar(): void;
44
+ fail(why: string): void;
45
+ /** The current entry's parentheses are not one zone that closes it — a problem of the list and of that entry. */
46
+ private breakParens;
47
+ private cut;
48
+ }
49
+ /** One entry of a tool-list field, read by the rule syntax. */
50
+ export interface ToolListFieldEntry {
51
+ /** The entry's place in the field, counted from 1 over every entry the field holds — read or refused — in written order. */
52
+ readonly position: number;
53
+ /** The entry as written, the blanks at its ends dropped: the spelling a definition's tool list or a rule list takes as it is. */
54
+ readonly spelling: string;
55
+ /** The tool name the rule syntax reads (`Bash` in `Bash(git log:*)`; `*` for the lone `*`). */
56
+ readonly name: string;
57
+ /** The rule the parentheses hold, unescaped (`git log:*`); absent for a bare name and for `Tool()` / `Tool(*)`, the whole tool. */
58
+ readonly arg?: string;
59
+ }
60
+ /** What a reader of the field is told. `level: "error"` — the field, or one entry of it, is not read: the value is no list
61
+ * (`not_a_list`), a list whose entries cannot be read (`unreadable`), a list item that is not a string or holds no entry
62
+ * (`not_a_name`), an entry whose parentheses are not one group closing it (`parens`), an entry that is no rule spelling
63
+ * (`not_a_rule`). `level: "info"` — the list is read as written and says something its author may not mean: a denied list
64
+ * holding the lone `*` denies every tool (`deny_all`, once, at the first such entry). */
65
+ export interface ToolListFieldProblem {
66
+ readonly level: "error" | "info";
67
+ readonly code: "not_a_list" | "unreadable" | "not_a_name" | "parens" | "not_a_rule" | "deny_all";
68
+ /** The entry's place ({@link ToolListFieldEntry.position}); absent when the problem is the whole value's. */
69
+ readonly position?: number;
70
+ /** The entry as the cut wrote it (`parens`, `not_a_rule`, `deny_all`): data for a host to show through its own escaping, never in `why`. */
71
+ readonly spelling?: string;
72
+ /** The words that say why, never quoting the field: for an `error`, the clause the skills-directory reader refuses the same
73
+ * list with; for `deny_all`, what the list as written does. */
74
+ readonly why: string;
75
+ }
76
+ /** A tool-list field, read: `entries` is `undefined` only for an absent field; `problems` holds every entry or value not read
77
+ * (`error`) and what the list as read says that its author may not mean (`info`). */
78
+ export interface ToolListField {
79
+ readonly entries: readonly ToolListFieldEntry[] | undefined;
80
+ readonly problems: readonly ToolListFieldProblem[];
81
+ }
82
+ /**
83
+ * Read a tool-list FIELD — the value a host's YAML parser produced for an agent's `tools:` / `disallowedTools:` or a
84
+ * command's `allowed-tools` — by the one grammar of this module. Nothing is dropped without a problem saying so:
85
+ * - `undefined` (the field is absent): `entries` is `undefined` — no list; the consumer's default applies (an agent's
86
+ * `tools:` absent holds every tool, its `disallowedTools:` absent denies none);
87
+ * - `null` (the key written with nothing after it): an empty list — the field is written and names no tool;
88
+ * - a string: each of its lines is cut alone (a line break ends an entry, as each line of a skill's block scalar is cut
89
+ * alone), an empty or blank string an empty list;
90
+ * - a list (read once by index, as every host-written tool-name list is): each string item is cut as a string; an item that
91
+ * is not a string, or a string that holds no entry, is `not_a_name` and takes one position;
92
+ * - any other value: `not_a_list`, and an empty list.
93
+ * Every entry is then the rule syntax's to read: one it reads is an entry, one whose parentheses are not one zone is `parens`,
94
+ * one it cannot read `not_a_rule`. Case is kept, a repeated entry is kept, a name no tool answers to is kept (the list's
95
+ * consumer judges names), and the lone `*` is an entry like any other, the list never collapsed to it: the consumer reads it
96
+ * — an allowed list holding it allows every tool, a denied list holding it denies every tool. `side` is the side the field is
97
+ * on: a `denied` list holding a `*` entry is also told so, once (`deny_all`, `level: "info"`), its entries unchanged.
98
+ * A field with an `error` problem is not the list its author wrote: an allowed list that lost entries holds fewer tools, a
99
+ * denied list that lost entries denies fewer. A host refuses the definition, as the skills-directory reader refuses the skill,
100
+ * or says so naming each problem; installing `entries` without a word is the one thing it does not do. An `info` problem is
101
+ * the list as written: a host shows it, and installs the list.
102
+ */
103
+ export declare function parseToolListField(value: unknown, side: ToolNameListSide): ToolListField;
@@ -0,0 +1,130 @@
1
+ import { ruleSpellingOf } from "./permission-rule-syntax.js";
2
+ import { readToolNameList } from "./tool-name-list.js";
3
+ export const isBlank = (ch) => ch === " " || ch === "\t";
4
+ export const PARENS_NOT_ONE_ZONE = "an entry's parentheses are not one group that closes it (a `(` that does not close, a `)` with no `(`, or text after the closing `)` — `\\(` / `\\)` are a rule's own text)";
5
+ export const SEQUENCE_NOT_A_NAME = "an entry is not a plain or quoted name (nested, mapping, anchor, tag, flow and block-scalar entries, and number, boolean and null entries, are not read)";
6
+ export const notARule = (position) => `entry ${position} is no rule spelling (a tool name of ASCII letters, digits and \`_ - . : *\`, starting with a letter, a digit, \`_\` or \`*\`, then at most one parenthesized rule)`;
7
+ export class EntryCutter {
8
+ entries = [];
9
+ brokenParens = [];
10
+ problem;
11
+ depth = 0;
12
+ closed = false;
13
+ current = "";
14
+ currentBroken = false;
15
+ blanks = "";
16
+ escaping = false;
17
+ push(ch) {
18
+ const escaped = this.escaping;
19
+ this.escaping = ch === "\\" && !escaped;
20
+ if (this.depth === 0 && (ch === "," || ch === " ")) {
21
+ this.cut();
22
+ return;
23
+ }
24
+ if (isBlank(ch)) {
25
+ if (this.current !== "")
26
+ this.blanks += ch;
27
+ return;
28
+ }
29
+ if (this.closed)
30
+ this.breakParens();
31
+ if (ch === "(" && !escaped)
32
+ this.depth++;
33
+ else if (ch === ")" && !escaped) {
34
+ if (this.depth === 0)
35
+ this.breakParens();
36
+ else
37
+ this.closed = --this.depth === 0;
38
+ }
39
+ this.current += this.blanks + ch;
40
+ this.blanks = "";
41
+ }
42
+ fold(breaks) {
43
+ this.blanks = "";
44
+ if (breaks === 1)
45
+ this.push(" ");
46
+ else
47
+ for (let n = 1; n < breaks; n++)
48
+ this.push("\n");
49
+ }
50
+ endScalar() {
51
+ if (this.depth > 0)
52
+ this.breakParens();
53
+ this.depth = 0;
54
+ this.escaping = false;
55
+ this.cut();
56
+ }
57
+ fail(why) {
58
+ this.problem ??= why;
59
+ }
60
+ breakParens() {
61
+ this.currentBroken = true;
62
+ this.fail(PARENS_NOT_ONE_ZONE);
63
+ }
64
+ cut() {
65
+ const entry = this.current;
66
+ const broken = this.currentBroken;
67
+ this.current = "";
68
+ this.blanks = "";
69
+ this.closed = false;
70
+ this.currentBroken = false;
71
+ if (entry !== "") {
72
+ this.entries.push(entry);
73
+ this.brokenParens.push(broken);
74
+ }
75
+ }
76
+ }
77
+ const LIST_UNREADABLE = "its value is a list whose entries cannot be read (an accessor or a proxy trap threw), not a list of names";
78
+ const notAList = (type) => `its value is ${type}, not a list of names`;
79
+ const DENY_ALL = "`*` in a denied list denies every tool (a reader that collapses the list to `*` would deny nothing)";
80
+ export function parseToolListField(value, side) {
81
+ if (value === undefined)
82
+ return { entries: undefined, problems: [] };
83
+ const entries = [];
84
+ const problems = [];
85
+ const read = () => {
86
+ const star = side === "denied" ? entries.find((e) => e.name === "*") : undefined;
87
+ if (star !== undefined)
88
+ problems.push({ level: "info", code: "deny_all", position: star.position, spelling: star.spelling, why: DENY_ALL });
89
+ return { entries, problems };
90
+ };
91
+ if (value === null)
92
+ return read();
93
+ let position = 0;
94
+ const cutString = (text) => {
95
+ const cut = new EntryCutter();
96
+ for (const line of text.split("\n")) {
97
+ for (const ch of line)
98
+ cut.push(ch);
99
+ cut.endScalar();
100
+ }
101
+ cut.entries.forEach((spelling, index) => {
102
+ position++;
103
+ const rule = cut.brokenParens[index] === true ? undefined : ruleSpellingOf(spelling);
104
+ if (rule !== undefined) {
105
+ entries.push({ position, spelling, name: rule.toolName, ...(rule.ruleContent !== undefined ? { arg: rule.ruleContent } : {}) });
106
+ }
107
+ else if (cut.brokenParens[index] === true)
108
+ problems.push({ level: "error", code: "parens", position, spelling, why: PARENS_NOT_ONE_ZONE });
109
+ else
110
+ problems.push({ level: "error", code: "not_a_rule", position, spelling, why: notARule(position) });
111
+ });
112
+ return cut.entries.length;
113
+ };
114
+ if (typeof value === "string") {
115
+ cutString(value);
116
+ return read();
117
+ }
118
+ const list = readToolNameList(value);
119
+ if (list.kind === "not_a_list")
120
+ return { entries, problems: [{ level: "error", code: "not_a_list", why: notAList(list.type) }] };
121
+ if (list.kind === "unreadable")
122
+ return { entries, problems: [{ level: "error", code: "unreadable", why: LIST_UNREADABLE }] };
123
+ for (const item of list.entries) {
124
+ if (typeof item === "string" && cutString(item) > 0)
125
+ continue;
126
+ position++;
127
+ problems.push({ level: "error", code: "not_a_name", position, why: SEQUENCE_NOT_A_NAME });
128
+ }
129
+ return read();
130
+ }
@@ -0,0 +1,47 @@
1
+ /**
2
+ * The NORMALIZATION a leg's mount facts pass through before the mount table reads them (tool-mount-plan.ts): the task's
3
+ * own word, the deployment's seats and the execution environment, each read ONCE into the closed fact set. Both halves
4
+ * read the table through these functions — prepare states their answers when its roster opens, and
5
+ * `describeStaticWiring` states the ones a deployment can read before any task — so a fact means the same thing to the
6
+ * leg that mounts and to the reader that predicts.
7
+ *
8
+ * Facts only known where a phase computes them (a listing, a verdict a phase reaches live, the name domain at a
9
+ * phase's point) are not here: the phase that computes one states it beside the judgment that reads it.
10
+ */
11
+ import type { ExecutionEnv } from "../internal/harness-types.js";
12
+ import type { ToolMountFact } from "./tool-mount-plan.js";
13
+ import type { RunnerDeps, TaskSpec } from "./types.js";
14
+ /** Facts a reader of the mount table states; a fact absent from the record is one it cannot read. */
15
+ export type ToolMountFacts = Partial<Record<ToolMountFact, boolean>>;
16
+ /** The spec members the task's own word is read from. */
17
+ export type MountFactSpec = Pick<TaskSpec, "enableBlockedReport" | "enablePlanMode" | "interactiveTools" | "selfOrchestration" | "outputSchema" | "handsReadOnly" | "advisorModel" | "lspManager">;
18
+ /** The task's own word. */
19
+ export declare function specMountFacts(spec: MountFactSpec): ToolMountFacts;
20
+ /** The deps members the deployment's seats are read from. */
21
+ export type MountFactDeps = Pick<RunnerDeps, "workflowScriptRunner" | "workflowGovernanceBaseline" | "lspManager" | "artifactHost" | "sharedMemoryStores">;
22
+ /** The deployment's seats a task cannot move (a task's own LSP manager counts with the deployment's). */
23
+ export declare function seatMountFacts(deps: MountFactDeps, spec: Pick<TaskSpec, "lspManager">): ToolMountFacts;
24
+ /** The run's global offload thresholds: the explicit one (the task's, else the deployment's — the coarse knob that outranks
25
+ * the per-tool defaults) and the effective one (the explicit one, else the engine default). */
26
+ export declare function offloadThresholdsOf(spec: Pick<TaskSpec, "toolResultThresholdChars">, deps: Pick<RunnerDeps, "toolResultThresholdChars">): {
27
+ readonly explicit: number | undefined;
28
+ readonly effective: number;
29
+ };
30
+ /** `seat.offload`: a finite, positive effective threshold opens the offload seat (a store is always at hand once it is open —
31
+ * the deployment's, else a fresh in-memory one). */
32
+ export declare function offloadSeatFact(effectiveThreshold: number): boolean;
33
+ /** The question seat's inputs: a live question face; a park store the question can wait in; the per-principal durable
34
+ * entitlement (`undefined` where it cannot be read before a principal resolves); the task's own durable opt-in. */
35
+ export interface QuestionSeatInputs<F extends boolean | undefined = boolean | undefined> {
36
+ readonly face: boolean;
37
+ readonly parkStore: boolean;
38
+ readonly forceDurableGate: F;
39
+ readonly durableApprovalDeclared: boolean;
40
+ /** The leg's one fact `approvalParkNotResumable` (`approvalParkNotResumableOf`; a static reader reads a top-level leg: `false`). */
41
+ readonly approvalParkNotResumable: boolean;
42
+ }
43
+ /** `seat.question`: a seat that answers — a live face, or the durable park (a store to wait in AND a declared opt-in). */
44
+ export declare function questionSeatFact(input: QuestionSeatInputs<boolean>): boolean;
45
+ export declare function questionSeatFact(input: QuestionSeatInputs): boolean | undefined;
46
+ /** The execution environment's reach: hands at all, a target its shell faces reach, the two daemon capabilities. */
47
+ export declare function envMountFacts(handsEnabled: boolean, env: ExecutionEnv): ToolMountFacts;
@@ -0,0 +1,50 @@
1
+ import { workflowsCapability } from "../orchestration/workflow-script-runner.js";
2
+ import { hasBackgroundShell } from "./background-shell.js";
3
+ import { performsIo } from "./remote-env.js";
4
+ import { hasScheduler } from "./scheduler.js";
5
+ import { durableParkOptInDeclared } from "./tool-policy.js";
6
+ import { DEFAULT_TOOL_RESULT_THRESHOLD_CHARS } from "./tool-result-store.js";
7
+ export function specMountFacts(spec) {
8
+ return {
9
+ "spec.enableBlockedReport": spec.enableBlockedReport !== false,
10
+ "spec.planMode": spec.enablePlanMode === true,
11
+ "spec.interactiveTools.on": spec.interactiveTools === true,
12
+ "spec.interactiveTools.off": spec.interactiveTools === false,
13
+ "spec.selfOrchestration": spec.selfOrchestration === true,
14
+ "spec.outputSchema": spec.outputSchema !== undefined,
15
+ "spec.handsReadOnly": spec.handsReadOnly === true,
16
+ "spec.advisorModel": spec.advisorModel !== undefined,
17
+ };
18
+ }
19
+ export function seatMountFacts(deps, spec) {
20
+ return {
21
+ "seat.workflows": workflowsCapability(deps),
22
+ "seat.lsp": (spec.lspManager ?? deps.lspManager) !== undefined,
23
+ "seat.artifact": deps.artifactHost !== undefined,
24
+ "seat.sharedMemory": deps.sharedMemoryStores !== undefined,
25
+ };
26
+ }
27
+ export function offloadThresholdsOf(spec, deps) {
28
+ const explicit = spec.toolResultThresholdChars ?? deps.toolResultThresholdChars;
29
+ return { explicit, effective: explicit ?? DEFAULT_TOOL_RESULT_THRESHOLD_CHARS };
30
+ }
31
+ export function offloadSeatFact(effectiveThreshold) {
32
+ return Number.isFinite(effectiveThreshold) && effectiveThreshold > 0;
33
+ }
34
+ export function questionSeatFact(input) {
35
+ if (input.face)
36
+ return true;
37
+ if (!input.parkStore)
38
+ return false;
39
+ if (input.forceDurableGate === undefined)
40
+ return input.durableApprovalDeclared ? true : undefined;
41
+ return durableParkOptInDeclared({ forceDurableGate: input.forceDurableGate, durableApprovalDeclared: input.durableApprovalDeclared, approvalParkNotResumable: input.approvalParkNotResumable });
42
+ }
43
+ export function envMountFacts(handsEnabled, env) {
44
+ return {
45
+ "env.hands": handsEnabled,
46
+ "env.performsIo": performsIo(env) === true,
47
+ "env.backgroundShell": hasBackgroundShell(env),
48
+ "env.scheduler": hasScheduler(env),
49
+ };
50
+ }