@sema-agent/core 7.66.1 → 7.67.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -8,13 +8,21 @@
8
8
  * any in-flight call silent for {@link TOOL_HEARTBEAT_MS}.
9
9
  *
10
10
  * THE CALLS IN FLIGHT ARE THE LEG'S OCCURRENCES (`tool-occurrence.ts`), not a set of this lane's own: the record
11
- * that carries a call's start frame carries its elapsed origin, its silence clock and its wait on the person, so
12
- * the beat can never describe a call the frames say ended, nor miss one they say started.
11
+ * that carries a call's start frame carries its elapsed origin (its release), its silence clock, its wait on the
12
+ * person and its classification, so the beat can never describe a call the frames say ended, nor miss one they say started.
13
13
  *
14
14
  * ONE ORIGIN PER CALL, the producer owns FACTS. A producer reports what it has seen (the tail, the totals),
15
15
  * never how long it has run: `elapsedTimeSeconds` is computed HERE from the occurrence's origin — its
16
- * announcement — because a shell command's own clock could only start at its spawn. With two origins a 30 s
17
- * beat could be followed moments later by a shell tick reporting 1 s, breaking the monotonicity the frame promises.
16
+ * RELEASE, the moment the engine let the call go to its executor — because a shell command's own clock could only
17
+ * start at its spawn. With two origins a 30 s beat could be followed moments later by a shell tick reporting 1 s,
18
+ * breaking the monotonicity the frame promises.
19
+ *
20
+ * ELAPSED IS EXECUTION TIME, COUNTED FROM THE RELEASE, NOT FROM THE ANNOUNCEMENT. The start frame goes out before the
21
+ * gate runs, so a call announced and still at its gate (a hook, a classifier, a card put to the person) is waiting, not
22
+ * running: counting its elapsed from the announcement made the person's ten seconds on a card the command's first ten.
23
+ * A call not yet released is still beaten like any other — its elapsed reads 0, it has executed for no time — and the
24
+ * frame says who holds it (`gate`, read off the occurrence at the mint — see `tool_progress.gate` in `task-event.ts`), so
25
+ * the beat never says "running" of a call that has not started.
18
26
  *
19
27
  * THE CADENCE HAS ONE ENFORCEMENT POINT, same reason: a producer's timer is a SAMPLING clock, not the
20
28
  * contract. `emit` drops a frame landing inside {@link TOOL_PROGRESS_MIN_INTERVAL_MS} of that call's last.
@@ -32,6 +40,13 @@
32
40
  * container's clock settling after a resume — makes each difference negative and silences BOTH producers
33
41
  * until it catches up: the exact failure this lane exists to prevent.
34
42
  *
43
+ * WORK IS TOLD ONLY BY A PRODUCER, AND ONLY WHEN ITS TOTALS ADVANCED. The leg's activity seat (`onWork`: the same
44
+ * seat a tool start, a tool end and an MCP progress notification beat) hears a frame a PRODUCER offered whose
45
+ * `totalBytes` is larger than that call's last frame carried — a command that is printing is working. The lane's own
46
+ * heartbeat never tells it (it says "still in flight", and a hung call must read as silent), and neither does a producer's
47
+ * tick whose totals did not move (a command that printed once and went quiet) or that carries none (a command that has
48
+ * printed nothing, a buffered environment).
49
+ *
35
50
  * LIVENESS ONLY — see the `tool_progress` member's contract in `task-event.ts`. The timer is `unref`'d and
36
51
  * every emission is fault-contained. */
37
52
  import type { TaskEvent, TaskEventIdentity } from "../types.js";
@@ -47,4 +62,4 @@ export declare const TOOL_PROGRESS_MIN_INTERVAL_MS = 1000;
47
62
  /** Build the lane over the run's content pusher (`pushContent` — the ONE seat that puts a frame on this
48
63
  * run's queue and, for a sub-agent, forwards it to the parent's sink), its identity mint and the leg's
49
64
  * occurrence table (the calls in flight). */
50
- export declare function createToolProgressLane(push: (e: TaskEvent) => void, ident: () => TaskEventIdentity, occurrences: ToolOccurrenceTable): ToolProgressLane;
65
+ export declare function createToolProgressLane(push: (e: TaskEvent) => void, ident: () => TaskEventIdentity, occurrences: ToolOccurrenceTable, onWork?: () => void): ToolProgressLane;
@@ -1,8 +1,9 @@
1
- import { occurrenceClock } from "./tool-occurrence.js";
1
+ import { gatePhaseOf, occurrenceClock } from "./tool-occurrence.js";
2
2
  export const TOOL_HEARTBEAT_MS = 30_000;
3
3
  export const TOOL_PROGRESS_MIN_INTERVAL_MS = 1_000;
4
- export function createToolProgressLane(push, ident, occurrences) {
4
+ export function createToolProgressLane(push, ident, occurrences, onWork) {
5
5
  let timer;
6
+ const printed = new Map();
6
7
  const arm = () => {
7
8
  if (timer !== undefined)
8
9
  return;
@@ -16,19 +17,39 @@ export function createToolProgressLane(push, ident, occurrences) {
16
17
  timer = undefined;
17
18
  };
18
19
  occurrences.onOpen(arm);
19
- const emit = (body) => {
20
+ const noteWork = (toolCallId, attempt, bytes) => {
21
+ if (bytes === undefined || !Number.isFinite(bytes))
22
+ return;
23
+ const last = printed.get(toolCallId);
24
+ const before = last !== undefined && last.attempt === attempt ? last.bytes : 0;
25
+ printed.set(toolCallId, { attempt, bytes });
26
+ if (bytes <= before)
27
+ return;
28
+ try {
29
+ onWork?.();
30
+ }
31
+ catch {
32
+ }
33
+ };
34
+ const mint = (body, offeredByProducer) => {
20
35
  const now = occurrenceClock();
21
36
  const unseen = occurrences.get(body.toolCallId) === undefined;
22
37
  const occ = occurrences.ensure({ toolCallId: body.toolCallId, spelledName: body.toolName, args: undefined });
38
+ if (unseen)
39
+ occurrences.release(occ.toolCallId);
23
40
  if (!unseen && now - occ.lastHeardAt < TOOL_PROGRESS_MIN_INTERVAL_MS)
24
41
  return;
25
42
  occurrences.heard(occ.toolCallId);
43
+ const gate = gatePhaseOf(occ);
26
44
  try {
27
- push({ type: "tool_progress", ...body, elapsedTimeSeconds: Math.floor((now - occ.startedAt) / 1000), ...ident() });
45
+ push({ type: "tool_progress", ...body, elapsedTimeSeconds: Math.floor((now - (occ.releasedAt ?? now)) / 1000), ...(gate !== undefined ? { gate } : {}), ...ident() });
28
46
  }
29
47
  catch {
30
48
  }
49
+ if (offeredByProducer)
50
+ noteWork(occ.toolCallId, occ.attempt, body.totalBytes);
31
51
  };
52
+ const emit = (body) => mint(body, true);
32
53
  function beat() {
33
54
  const now = occurrenceClock();
34
55
  const inFlight = occurrences.live().filter((o) => o.beating);
@@ -39,7 +60,7 @@ export function createToolProgressLane(push, ident, occurrences) {
39
60
  for (const o of inFlight) {
40
61
  if (now - o.lastHeardAt < TOOL_HEARTBEAT_MS)
41
62
  continue;
42
- emit({ toolCallId: o.toolCallId, toolName: o.spelledName });
63
+ mint({ toolCallId: o.toolCallId, toolName: o.spelledName }, false);
43
64
  }
44
65
  }
45
66
  return {
@@ -47,6 +68,7 @@ export function createToolProgressLane(push, ident, occurrences) {
47
68
  clear() {
48
69
  occurrences.quiesce();
49
70
  disarm();
71
+ printed.clear();
50
72
  },
51
73
  };
52
74
  }
@@ -1,13 +1,17 @@
1
1
  /**
2
- * The run's account of the tool-result seat's media refusals (`tool_result.media_refused`, operator). The loop's
2
+ * The run's accounts of a tool's media and binary content it could not hand the model as content. The loop's
3
3
  * post-execution half admits every media block an executed call's result carries (`admitToolResultMedia`, the last step
4
- * of `finalizeToolOutcome`) and hands each call's refusals here once; the placeholders already stand in the result, so
5
- * this seat only words the account and delivers it on the deployment's notice sink. The detail carries the seat's
6
- * closed-set words, counts, the call's identity and a media type only when it can be one — never the bytes.
4
+ * of `finalizeToolOutcome`) and hands each call's refusals here once (`tool_result.media_refused`, operator); an MCP
5
+ * call or resource read whose server sent binary content that is not media the model reads hands what became of it here
6
+ * once (`tool_result.media_persisted`, operator). The lines that stand in the result are already there, so these
7
+ * seats only word the account and deliver it on the deployment's notice sink. The details carry closed-set words,
8
+ * counts, the call's identity, a media type only when it can be one, and the ref each piece is kept under in the run's
9
+ * tool-result store — or why it is not (with the store's own error text for the operator) — never the bytes.
7
10
  */
8
11
  import { type EngineNotice } from "../engine-notice.js";
9
12
  import { type ToolResultMediaRefusal } from "../image-admission.js";
10
13
  import type { ImageDownsampler } from "../image-downsample.js";
14
+ import type { McpBinaryKept } from "../mcp.js";
11
15
  /** The run's attribution pair, as every per-run notice carries it. */
12
16
  export interface ToolResultMediaSeatIds {
13
17
  sessionId: string;
@@ -18,6 +22,13 @@ export declare function toolResultMediaRefusedSeat(onNotice: ((notice: EngineNot
18
22
  toolCallId: string;
19
23
  refused: readonly ToolResultMediaRefusal[];
20
24
  }) => void;
25
+ /**
26
+ * The run's account of an MCP server's binary content (`tool_result.media_persisted`, operator): once per call or resource
27
+ * read that carried any — an audio block, or a resource blob of a type outside the media admission's sets. The model read a
28
+ * line naming each piece's ref (or why it was not kept) instead of the bytes. The detail carries the server, the call, and
29
+ * per piece its size, its media type when it can be one, and the ref — or why it was not kept.
30
+ */
31
+ export declare function mcpBinaryKeptSeat(onNotice: ((notice: EngineNotice) => void) | undefined, ids: ToolResultMediaSeatIds): (info: McpBinaryKept) => void;
21
32
  /**
22
33
  * The run's one account of an image that goes to the model unprocessed over `IMAGE_ADMISSION.soft.targetBytes`
23
34
  * (`config.image_processor_unavailable`, operator): said ONCE per run, at the first such image wherever it entered — a
@@ -3,15 +3,31 @@ import { IMAGE_ADMISSION } from "../image-admission.js";
3
3
  export function toolResultMediaRefusedSeat(onNotice, ids) {
4
4
  return ({ toolName, toolCallId, refused }) => {
5
5
  const reasons = [...new Set(refused.map((r) => r.reason))].join(", ");
6
+ const kept = refused.filter((r) => r.ref !== undefined).length;
7
+ const unkept = refused.filter((r) => r.notKept !== undefined).length;
6
8
  deliverEngineNotice(onNotice, {
7
9
  code: "tool_result.media_refused",
8
10
  message: `The ${JSON.stringify(toolName)} tool's result carried ${refused.length} media block(s) whose bytes the media admission refused (${reasons}). ` +
9
11
  `Each was replaced in the result by a text placeholder naming the refusal, so neither the model nor the event stream received those bytes; ` +
10
- `the tool, or the server behind it, returned bytes that are not what their block claims, or that are beyond what can be sent.`,
12
+ `the tool, or the server behind it, returned bytes that are not what their block claims, or that are beyond what can be sent.` +
13
+ (kept > 0 ? ` ${kept} refused for their size were kept in the run's tool-result store, and their placeholders name each one's ref (detail.refused[].ref).` : "") +
14
+ (unkept > 0 ? ` ${unkept} refused for their size were not kept (detail.refused[].notKept says why).` : ""),
11
15
  detail: { toolName, toolCallId, refused: refused.map((r) => ({ ...r })), sessionId: ids.sessionId, runId: ids.runId },
12
16
  });
13
17
  };
14
18
  }
19
+ export function mcpBinaryKeptSeat(onNotice, ids) {
20
+ return ({ server, toolName, toolCallId, kept }) => {
21
+ const stored = kept.filter((k) => "ref" in k).length;
22
+ deliverEngineNotice(onNotice, {
23
+ code: "tool_result.media_persisted",
24
+ message: `MCP server ${JSON.stringify(server)} sent ${kept.length} piece(s) of binary content in the ${JSON.stringify(toolName)} result that are not media the model reads (audio, or a type outside the image and document types it accepts). ` +
25
+ `${stored} were kept in the run's tool-result store and the result names each one's ref in place of the bytes` +
26
+ (stored < kept.length ? `; ${kept.length - stored} were not kept (detail.kept[].notKept says why), and the result says so.` : "."),
27
+ detail: { server, toolName, toolCallId, kept: kept.map((k) => ({ ...k })), sessionId: ids.sessionId, runId: ids.runId },
28
+ });
29
+ };
30
+ }
15
31
  export function imageUnprocessedSeat(onNotice, seat, ids) {
16
32
  let told = false;
17
33
  return (bytes) => {
@@ -30,7 +30,7 @@ export function createToolTableView(faces) {
30
30
  const fingerprint = faces.fpRef.current;
31
31
  if (fingerprint !== undefined && !sameNames(fingerprint.tools, shown))
32
32
  fingerprint.tools = inputs;
33
- faces.turnSnapshotRef.current?.refreshTools(inputs);
33
+ faces.turnSnapshotRef.current?.refreshTools(inputs, "view");
34
34
  }
35
35
  hidOne = hides;
36
36
  return hides ? { ...context, tools: shown } : context;
@@ -2,9 +2,12 @@ import type { McpDroppedTool } from "../mcp.js";
2
2
  import { type McpUnavailableEntry } from "../mcp-failure.js";
3
3
  import type { McpInstructionsEntry } from "../prompt-section-seat.js";
4
4
  import type { TaskSpec } from "../types.js";
5
+ import type { AttachmentSource } from "../attachment-source.js";
6
+ import type { ChangedFilesNotice } from "../../internal/llm.js";
5
7
  import { type BackgroundTaskTableRow } from "../task-notification.js";
6
8
  import { type SkillListingEntry, type SkillsBlockRender } from "./synthetic-tools.js";
7
9
  import { type ResolvedSkillListingBudget } from "../skill-listing-budget.js";
10
+ import { type EngineText } from "../../prompt-assembly/engine-text.js";
8
11
  /**
9
12
  * Turn-boundary attachment seam: the PURE producer layer (CC `getContextAttachments`
10
13
  * parity). This module is the single home of the CC-parity cadence judgment + reminder copy (提示词主权批:
@@ -77,7 +80,6 @@ export declare const CHANGED_FILES_MTIME_EPS_MS = 2000;
77
80
  /** Per-boundary byte cap over the bundle's CLIPPABLE frames (weak-model context economics). Intact-class
78
81
  * frames ride outside it — see {@link ATTACHMENT_DELIVERY_CLASS}. */
79
82
  export declare const ATTACHMENT_BYTE_CAP: number;
80
- export type AttachmentSource = "todo_reminder" | "task_reminder" | "tool_search_usage_reminder" | "changed_files" | "output_style" | "date_change" | "instructions_change" | "workflow_size_guideline_change" | "budget_usd" | "total_tokens_reminder" | "background_tasks" | "tools_delta" | "mcp_unavailable" | "agent_listing" | "skills_listing" | "mcp_instructions" | "mcp_dropped_tools";
81
83
  /** How the bundle cap treats a source — see {@link ATTACHMENT_DELIVERY_CLASS}. */
82
84
  export type AttachmentDeliveryClass = {
83
85
  readonly class: "clippable";
@@ -152,10 +154,6 @@ export declare const ATTACHMENT_DELIVERY_CLASS: {
152
154
  readonly class: "intact";
153
155
  readonly bound: () => number;
154
156
  };
155
- readonly instructions_change: {
156
- readonly class: "intact";
157
- readonly bound: () => number;
158
- };
159
157
  readonly workflow_size_guideline_change: {
160
158
  readonly class: "intact";
161
159
  readonly bound: () => number;
@@ -199,6 +197,12 @@ export interface TurnAttachment {
199
197
  * lane cap it rides under) so the echo is the list the model received, not the first row or two of it. Absent = the
200
198
  * shared budget ({@link import("./steering-preview.js").STEERING_PREVIEW_BUDGET}). */
201
199
  echoBound?: number;
200
+ /** changed_files only: the files the body lists, in order — each the (path, modification time) the model is told
201
+ * about ({@link changedFilesNoticeIn} records them on the carrying message). */
202
+ noticed?: ReadonlyArray<{
203
+ readonly path: string;
204
+ readonly mtimeMs: number;
205
+ }>;
202
206
  }
203
207
  /** H4 — the thin projection of a todo list kept run-local (NEVER the wire-capped `tool_end.structured` card).
204
208
  * Pure CONTENT memory: the write-window anchor lives on {@link AttachmentState.todoLastWriteTurn}
@@ -246,9 +250,6 @@ export interface AttachmentState {
246
250
  /** Cadence-clock value at the last tool_search_usage_reminder emitted (the reference's
247
251
  * `turnsSinceLastReminder`, found by scanning back for the attachment entry itself). */
248
252
  lastToolSearchReminderTurn: number;
249
- /** changed_files per-path dedup: the last mtime already surfaced for a path — the same (path, mtime)
250
- * is never reported twice. Evicted alongside readFileState's ENOENT eviction (LOW-9: bounded by it). */
251
- surfacedMtime: Map<string, number>;
252
253
  /** G1 backgroundTasks (CC /compact parity): SET by the run loop when a compaction LANDS,
253
254
  * CONSUMED at the next boundary the collector actually runs (a steered-away boundary carries it
254
255
  * forward untouched — the collector is never called there). One-shot: post-compact announce once,
@@ -321,31 +322,13 @@ export interface AttachmentState {
321
322
  export interface DateChangeState {
322
323
  announcedDate: string;
323
324
  }
324
- /**
325
- * [A2] C-4 (design-A §4.2/§4.3) — the instructions_change lane's OWN state, the date_change
326
- * discipline exactly: deliberately NOT an {@link AttachmentState} member (allocating that would
327
- * activate the cadence reducers on runs that only carry an instruction snapshot), one field, zero
328
- * reducers. `lastAnnouncedHash` starts as the snapshot's declared per-path hashes
329
- * (`ProjectMemoryLoad.instructionSources` — what the model is already seeing) and the RUN LOOP
330
- * commits it via {@link commitInstructionsChange} when it actually appends the frame (the producer
331
- * below is pure). The frame rides ABOVE the 8KB bundle cap as a fixed ≤{@link INSTRUCTIONS_CHANGE_BYTE_CAP}
332
- * item — no clipping face exists, so commit-at-append is sound (the A1-R argument verbatim).
333
- * `null` value = "announced as removed" (a reappearing file re-announces by hash inequality).
334
- */
335
- export interface InstructionsChangeState {
336
- lastAnnouncedHash: Map<string, string | null>;
337
- }
338
- /** [A2] C-4 — hard byte ceiling of one instructions_change frame body (design-A §4.3: fixed small
339
- * frame riding above the 8KB bundle cap; paths are ellipsis-truncated and overflow files are
340
- * summarized as a count rather than ever growing the frame). */
341
- export declare const INSTRUCTIONS_CHANGE_BYTE_CAP = 512;
342
325
  /**
343
326
  * `workflow_size_guideline_change` (the third above-cap fixed-frame lane) has NO state interface and
344
327
  * no producer here on purpose: its copy is the Workflow tool's own
345
328
  * `workflowSizeGuidelineChangeNotice`, and rendering it from this module would put an
346
329
  * orchestration dependency on the pure attachment producer layer. Its one-field run-local state and
347
330
  * its baseline/live comparison live at the single steerer instead (runtask.ts, next to the
348
- * date_change and instructions_change lanes it is structurally identical to). The kind is listed in
331
+ * date_change lane it is structurally identical to). The kind is listed in
349
332
  * {@link AttachmentSource} because the steer wrapper, the byte accounting and the
350
333
  * `steering_injected` echo are all keyed on that wordlist.
351
334
  */
@@ -611,6 +594,9 @@ export interface AttachmentInputs {
611
594
  added: ReadonlyArray<McpInstructionsEntry>;
612
595
  removed: readonly string[];
613
596
  };
597
+ /** The run's engine text reading (its locale's): the frame's catalog lines render through it, and the caller's
598
+ * intact-survival check renders through the same one. The Runner's boundary always hands it; absent ⇒ canonical. */
599
+ engineText?: EngineText;
614
600
  /** [cc216] mcp_dropped_tools: intake-dropped MCP tools snapshotted from
615
601
  * `MaterializedMcp.droppedTools` (rides the `mcpInstructions` opt-in — same MCP announce lane).
616
602
  * CALLER-owned consumption on intact cap survival (same `newTools` discipline). Tool names are
@@ -634,6 +620,34 @@ export interface AttachmentInputs {
634
620
  * least afford to lose.
635
621
  */
636
622
  export declare function collectDueAttachments(state: AttachmentState, inp: AttachmentInputs): readonly TurnAttachment[];
623
+ /**
624
+ * The changed_files frame for one scan's result — the ONE collector, shared by the turn boundary's bundle and a leg's first
625
+ * request: every file the scan found changed and not read again, or `undefined` when there is none. Whether the model was
626
+ * already told is not this collector's question: it is asked of the request's own view, which carries each listed
627
+ * (path, modification time) once (`request-copy-projection.ts`, over the record {@link changedFilesNoticeIn} writes). So a
628
+ * notice the request lost — the byte cap starved it, a trim or a summary took it — is minted again by the next scan, and
629
+ * the record step is nothing.
630
+ */
631
+ export declare function collectChangedFilesAttachment(changed: ReadonlyArray<{
632
+ path: string;
633
+ mtimeMs: number;
634
+ }>): TurnAttachment | undefined;
635
+ /**
636
+ * The same frame for a leg's first request, under the bundle's own lane cap ({@link ATTACHMENT_BYTE_CAP}, the one cut
637
+ * {@link capAttachments} makes): the list is unbounded where the boundary clips it, so a frame the first request carries is clipped
638
+ * by the same function, alone — it is the one clippable frame a first request owes.
639
+ */
640
+ export declare function collectChangedFilesFirstRequestFrame(changed: ReadonlyArray<{
641
+ path: string;
642
+ mtimeMs: number;
643
+ }>): TurnAttachment | undefined;
644
+ /**
645
+ * The record of a changed_files block as it stands in `text` — the message that carries it (its `changedFilesNotices`):
646
+ * `block` is the frame's minted bytes, found at their first occurrence; each listed file is found
647
+ * at its own list line in them, in order, and a file whose line the byte cap cut (with every one after it) is not listed.
648
+ * `undefined` when the block is not in `text` or lists no whole line — the request then carries it as written.
649
+ */
650
+ export declare function changedFilesNoticeIn(text: string, block: string, frame: TurnAttachment): ChangedFilesNotice | undefined;
637
651
  /**
638
652
  * The `tool_search_usage_reminder` renderer text, with the two
639
653
  * interpolations resolved: the name list (+ `(+N more)` tail when the census exceeds
@@ -671,47 +685,6 @@ export declare function renderDateChange(newDate: string): string;
671
685
  * `state.announcedDate = today` when the carrying message's receipt settles (see {@link DateChangeState}).
672
686
  */
673
687
  export declare function collectDateChange(state: DateChangeState, today: string): TurnAttachment | undefined;
674
- /**
675
- * [A2] C-4 — the instructions_change producer (design-A §4.3): the project-instruction snapshot is
676
- * FROZEN for the session (§4.1); when the deployment probe reports a file hash that walked away from
677
- * the last ANNOUNCED one, the model is told at the tail — it can Read the truth on demand (the
678
- * seeded-read dedup disarms on a changed file, §4.4, so the Read returns the real new content).
679
- *
680
- * PURE — same split as {@link collectDateChange}: the caller commits via
681
- * {@link commitInstructionsChange} when it actually appends the frame (append-⇔-commit holds because
682
- * the frame rides ABOVE the byte-capped bundle). Rules:
683
- * - `probed === null` ⇒ the probe declined this boundary (remote cwd / EACCES / transient IO):
684
- * silent skip, nothing committed, next boundary retries.
685
- * - string INEQUALITY against the last announced hash triggers (a rollback to an old value is also
686
- * a change — the date lane's same rule); the SAME value never announces twice (终身一次).
687
- * - `contentHash: null` = the file is GONE — announced once as removed (`hash → absent`);
688
- * a reappearing file re-announces by inequality against the committed `null`.
689
- * - probed paths the snapshot never declared are ignored (the deployment owns the file-name policy;
690
- * core only compares against the declared baseline).
691
- * - the frame body is HARD-BOUNDED to {@link INSTRUCTIONS_CHANGE_BYTE_CAP}: paths are
692
- * ellipsis-truncated, and files that don't fit are summarized as `(+N more…)` — those stay
693
- * UNCOMMITTED (absent from `announced`) and re-announce at the next boundary.
694
- * - multi-file changes merge into ONE frame, one line per file (§4.3).
695
- *
696
- * Returns the frame plus the `announced` entries that actually rode it (the caller's commit set),
697
- * or `undefined` when nothing is due.
698
- */
699
- export declare function collectInstructionsChange(state: InstructionsChangeState, probed: ReadonlyArray<{
700
- path: string;
701
- contentHash: string | null;
702
- }> | null): {
703
- attachment: TurnAttachment;
704
- announced: ReadonlyArray<{
705
- path: string;
706
- contentHash: string | null;
707
- }>;
708
- } | undefined;
709
- /** [A2] C-4 — the run loop's commit half (append-⇔-commit, {@link InstructionsChangeState}): advance
710
- * the per-path last-announced hashes for exactly the entries that rode the appended frame. */
711
- export declare function commitInstructionsChange(state: InstructionsChangeState, announced: ReadonlyArray<{
712
- path: string;
713
- contentHash: string | null;
714
- }>): void;
715
688
  export declare function renderBudgetUsd(used: number, total: number): string;
716
689
  /**
717
690
  * The whole body is the one-line envelope (cli296.js:188983): "<total_tokens>N tokens left</total_tokens>",
@@ -1006,14 +979,14 @@ export declare const MCP_INSTRUCTIONS_MAX_CHARS = 4096;
1006
979
  * own choice of tag count. One measurement, taken where the cut happens, is the only shape that cannot
1007
980
  * drift.
1008
981
  */
1009
- export declare function fenceMcpServerInstructions(server: string, text: string): string;
982
+ export declare function fenceMcpServerInstructions(server: string, text: string, say?: EngineText): string;
1010
983
  /**
1011
984
  * The ONE renderer of an MCP instructions entry, read by both lanes. A server's text rides the fence above;
1012
985
  * a host's replacement is host text and takes the reference's per-server block, `## <server>` then the
1013
986
  * text (cli296.js B[17396126,17396429), `Yqe`), unfenced. Both are bounded by the same per-entry cap and
1014
987
  * disclose the same cut, so the frame's size bound holds for the entry that actually rides.
1015
988
  */
1016
- export declare function renderMcpInstructionsEntry(entry: McpInstructionsEntry): string;
989
+ export declare function renderMcpInstructionsEntry(entry: McpInstructionsEntry, say?: EngineText): string;
1017
990
  /**
1018
991
  * G1 续批 — MCP server-instruction delta (the reference header, cli296.js:250602: "The following MCP servers have provided instructions").
1019
992
  * Deliberate deviations from the reference (recorded):
@@ -1029,7 +1002,7 @@ export declare function renderMcpInstructionsEntry(entry: McpInstructionsEntry):
1029
1002
  * carry the prefix — the asymmetry is the reference's, kept as is). Exported for the run loop's
1030
1003
  * intact-survival consumption check (tools_delta discipline).
1031
1004
  */
1032
- export declare function renderMcpInstructionsDelta(added: ReadonlyArray<McpInstructionsEntry>, removed: readonly string[]): string | undefined;
1005
+ export declare function renderMcpInstructionsDelta(added: ReadonlyArray<McpInstructionsEntry>, removed: readonly string[], say?: EngineText): string | undefined;
1033
1006
  /**
1034
1007
  * [cc216] mcp_dropped_tools — announce intake-dropped MCP tools ONCE (CC's
1035
1008
  * `mcp_dropped_tools_delta` system reminder). Per-entry line shape follows CC's `qny`
@@ -7,6 +7,7 @@ import { renderSkillLinesWithin, renderSkillsBlock } from "./synthetic-tools.js"
7
7
  import { SKILL_LISTING_DEFAULT_BUDGET } from "../skill-listing-budget.js";
8
8
  import { foldListingWithin, foldRemovalArmWithin, removalArmFloor } from "./listing-fold.js";
9
9
  import { eventDefaultOn } from "../../prompt-assembly/event-registry.js";
10
+ import { engineTextFor } from "../../prompt-assembly/engine-text.js";
10
11
  import { TOOL_SEARCH_NAME as TOOL_SEARCH_TOOL_NAME } from "./tool-disclosure.js";
11
12
  export const TODO_REMINDER_CONFIG = {
12
13
  TURNS_SINCE_WRITE: 10,
@@ -44,7 +45,6 @@ export const ATTACHMENT_DELIVERY_CLASS = {
44
45
  mcp_instructions: { class: "intact", bound: (inp) => mcpInstructionsBound(inp) },
45
46
  mcp_dropped_tools: { class: "intact", bound: (inp) => mcpDroppedToolsBound(inp) },
46
47
  date_change: { class: "intact", bound: () => DATE_CHANGE_MAX_BYTES },
47
- instructions_change: { class: "intact", bound: () => INSTRUCTIONS_CHANGE_BYTE_CAP },
48
48
  workflow_size_guideline_change: { class: "intact", bound: () => WORKFLOW_SIZE_GUIDELINE_CHANGE_MAX_BYTES },
49
49
  };
50
50
  export function isIntactSource(source) {
@@ -61,13 +61,11 @@ const ATTACHMENT_TAGS_OWNED = {
61
61
  export function attachmentEnvelopeTags(source) {
62
62
  return ATTACHMENT_TAGS_OWNED[source] ?? ATTACHMENT_TAGS_DEFAULT;
63
63
  }
64
- export const INSTRUCTIONS_CHANGE_BYTE_CAP = 512;
65
64
  export function createAttachmentState() {
66
65
  return {
67
66
  lastTodoReminderTurn: 0,
68
67
  lastTaskReminderTurn: 0,
69
68
  lastToolSearchReminderTurn: 0,
70
- surfacedMtime: new Map(),
71
69
  postCompactPending: false,
72
70
  };
73
71
  }
@@ -242,23 +240,57 @@ export function collectDueAttachments(state, inp) {
242
240
  if (skillsListingBody !== undefined)
243
241
  (out ??= []).push({ source: "skills_listing", body: skillsListingBody });
244
242
  if (inp.config.mcpInstructions && inp.mcpInstructions !== undefined) {
245
- const body = renderMcpInstructionsDelta(inp.mcpInstructions.added, inp.mcpInstructions.removed);
243
+ const body = renderMcpInstructionsDelta(inp.mcpInstructions.added, inp.mcpInstructions.removed, inp.engineText);
246
244
  if (body !== undefined)
247
245
  (out ??= []).push({ source: "mcp_instructions", body });
248
246
  }
249
247
  if (inp.config.mcpInstructions && inp.mcpDroppedTools !== undefined && inp.mcpDroppedTools.length > 0) {
250
248
  (out ??= []).push({ source: "mcp_dropped_tools", body: renderMcpDroppedTools(inp.mcpDroppedTools) });
251
249
  }
252
- if (inp.config.changedFiles && inp.changedFiles !== undefined && inp.changedFiles.length > 0) {
253
- const fresh = inp.changedFiles.filter((c) => state.surfacedMtime.get(c.path) !== c.mtimeMs);
254
- if (fresh.length > 0) {
255
- (out ??= []).push({ source: "changed_files", body: renderChangedFiles(fresh.map((c) => c.path)), commit: () => fresh.forEach((c) => state.surfacedMtime.set(c.path, c.mtimeMs)) });
256
- }
250
+ if (inp.config.changedFiles && inp.changedFiles !== undefined) {
251
+ const frame = collectChangedFilesAttachment(inp.changedFiles);
252
+ if (frame !== undefined)
253
+ (out ??= []).push(frame);
257
254
  }
258
255
  if (out === undefined)
259
256
  return EMPTY;
260
257
  return capAttachments(out);
261
258
  }
259
+ export function collectChangedFilesAttachment(changed) {
260
+ if (changed.length === 0)
261
+ return undefined;
262
+ return { source: "changed_files", body: renderChangedFiles(changed.map((c) => c.path)), noticed: changed.map((c) => ({ path: c.path, mtimeMs: c.mtimeMs })) };
263
+ }
264
+ export function collectChangedFilesFirstRequestFrame(changed) {
265
+ const frame = collectChangedFilesAttachment(changed);
266
+ if (frame === undefined)
267
+ return undefined;
268
+ const [capped] = capAttachments([frame]);
269
+ return capped === undefined ? undefined : { ...frame, body: capped.body };
270
+ }
271
+ export function changedFilesNoticeIn(text, block, frame) {
272
+ const at = text.indexOf(block);
273
+ if (at < 0 || frame.noticed === undefined)
274
+ return undefined;
275
+ const tags = attachmentEnvelopeTags("changed_files");
276
+ const files = [];
277
+ let cursor = 0;
278
+ for (const f of frame.noticed) {
279
+ const line = `\n${sanitizeUntrustedText(`- ${f.path}`, tags)}`;
280
+ let found = -1;
281
+ for (let i = block.indexOf(line, cursor); i >= 0; i = block.indexOf(line, i + 1)) {
282
+ if (block[i + line.length] === "\n") {
283
+ found = i;
284
+ break;
285
+ }
286
+ }
287
+ if (found < 0)
288
+ break;
289
+ files.push({ path: f.path, mtimeMs: f.mtimeMs, start: at + found, end: at + found + line.length });
290
+ cursor = found + line.length;
291
+ }
292
+ return files.length === 0 ? undefined : { start: at, end: at + block.length, files };
293
+ }
262
294
  const TODO_REMINDER_BASE = `The TodoWrite tool hasn't been used recently. If you're working on tasks that would benefit from tracking progress, consider using the TodoWrite tool to track progress. Also consider cleaning up the todo list if has become stale and no longer matches what you are working on. Only use it if it's relevant to the current work. This is just a gentle reminder - ignore if not applicable.\n`;
263
295
  const TASK_REMINDER_BASE = `The task tools haven't been used recently. If you're working on tasks that would benefit from tracking progress, consider using TaskCreate to add new tasks and TaskUpdate to update task status (set to in_progress when starting, completed when done). Also consider cleaning up the task list if it has become stale. Only use these if relevant to the current work. This is just a gentle reminder - ignore if not applicable.\n`;
264
296
  function renderTodoReminder(state) {
@@ -301,92 +333,6 @@ export function collectDateChange(state, today) {
301
333
  return undefined;
302
334
  return { source: "date_change", body: renderDateChange(today) };
303
335
  }
304
- function shortHash(hash) {
305
- const colon = hash.indexOf(":");
306
- const bare = colon >= 0 ? hash.slice(colon + 1) : hash;
307
- return bare.slice(0, 8) || "unknown";
308
- }
309
- function clipInstructionPath(path) {
310
- if (Buffer.byteLength(path, "utf8") <= 96)
311
- return path;
312
- const points = Array.from(path);
313
- let out = "";
314
- for (let i = points.length - 1; i >= 0; i--) {
315
- const next = points[i] + out;
316
- if (Buffer.byteLength(next, "utf8") > 95)
317
- break;
318
- out = next;
319
- }
320
- return `…${out}`;
321
- }
322
- const INSTRUCTIONS_CHANGE_TAIL_READ = "The snapshot in your context is from session start and has NOT been updated. Read the file if the current content matters to your next steps. Do not mention this notice to the user unless relevant.";
323
- const INSTRUCTIONS_CHANGE_TAIL_REMOVED = "The snapshot in your context is from session start and has NOT been updated. Do not mention this notice to the user unless relevant.";
324
- export function collectInstructionsChange(state, probed) {
325
- if (probed === null)
326
- return undefined;
327
- const due = [];
328
- const seen = new Set();
329
- for (const p of probed) {
330
- if (!state.lastAnnouncedHash.has(p.path))
331
- continue;
332
- if (seen.has(p.path))
333
- continue;
334
- seen.add(p.path);
335
- const last = state.lastAnnouncedHash.get(p.path);
336
- if (p.contentHash === last)
337
- continue;
338
- due.push({ path: p.path, from: last, to: p.contentHash });
339
- }
340
- if (due.length === 0)
341
- return undefined;
342
- const line = (d) => d.to === null
343
- ? `- ${clipInstructionPath(d.path)} was removed on disk (hash ${shortHash(d.from ?? "")} → absent)`
344
- : `- ${clipInstructionPath(d.path)} (hash ${d.from === null ? "absent" : shortHash(d.from)} → ${shortHash(d.to)})`;
345
- let body;
346
- let announced;
347
- if (due.length === 1) {
348
- const d = due[0];
349
- body =
350
- d.to === null
351
- ? `Project instruction file was removed on disk during this session: ${clipInstructionPath(d.path)} (hash ${shortHash(d.from ?? "")} → absent). ${INSTRUCTIONS_CHANGE_TAIL_REMOVED}`
352
- : `Project instruction file changed on disk during this session: ${clipInstructionPath(d.path)} (hash ${d.from === null ? "absent" : shortHash(d.from)} → ${shortHash(d.to)}). ${INSTRUCTIONS_CHANGE_TAIL_READ}`;
353
- }
354
- else {
355
- const header = "Project instruction files changed on disk during this session:";
356
- const tail = due.some((d) => d.to !== null) ? INSTRUCTIONS_CHANGE_TAIL_READ.replace("Read the file ", "Read the files ") : INSTRUCTIONS_CHANGE_TAIL_REMOVED;
357
- const fixed = Buffer.byteLength(`${header}\n\n${tail}`, "utf8");
358
- const overflowReserve = Buffer.byteLength("\n- (+99 more…)", "utf8");
359
- let used = fixed;
360
- const kept = [];
361
- for (const d of due) {
362
- const l = line(d);
363
- const cost = Buffer.byteLength(`\n${l}`, "utf8");
364
- if (used + cost + (kept.length + 1 < due.length ? overflowReserve : 0) > INSTRUCTIONS_CHANGE_BYTE_CAP)
365
- break;
366
- kept.push(d);
367
- used += cost;
368
- }
369
- if (kept.length === 0) {
370
- const d = due[0];
371
- body =
372
- d.to === null
373
- ? `Project instruction file was removed on disk during this session: ${clipInstructionPath(d.path)} (hash ${shortHash(d.from ?? "")} → absent). ${INSTRUCTIONS_CHANGE_TAIL_REMOVED}`
374
- : `Project instruction file changed on disk during this session: ${clipInstructionPath(d.path)} (hash ${d.from === null ? "absent" : shortHash(d.from)} → ${shortHash(d.to)}). ${INSTRUCTIONS_CHANGE_TAIL_READ}`;
375
- announced = [{ path: d.path, contentHash: d.to }];
376
- return { attachment: { source: "instructions_change", body }, announced };
377
- }
378
- const more = due.length - kept.length;
379
- body = `${header}\n${kept.map(line).join("\n")}${more > 0 ? `\n- (+${more} more…)` : ""}\n${tail}`;
380
- announced = kept.map((d) => ({ path: d.path, contentHash: d.to }));
381
- return { attachment: { source: "instructions_change", body }, announced };
382
- }
383
- announced = due.map((d) => ({ path: d.path, contentHash: d.to }));
384
- return { attachment: { source: "instructions_change", body }, announced };
385
- }
386
- export function commitInstructionsChange(state, announced) {
387
- for (const a of announced)
388
- state.lastAnnouncedHash.set(a.path, a.contentHash);
389
- }
390
336
  export function renderBudgetUsd(used, total) {
391
337
  return `USD budget: $${used}/$${total}; $${total - used} remaining`;
392
338
  }
@@ -685,25 +631,27 @@ export function commitSkillsListing(state, entries) {
685
631
  state.announcedSkills = new Map(entries.map((e) => [e.name, e.description]));
686
632
  }
687
633
  export const MCP_INSTRUCTIONS_MAX_CHARS = 4096;
688
- export function fenceMcpServerInstructions(server, text) {
634
+ export function fenceMcpServerInstructions(server, text, say = engineTextFor()) {
689
635
  const fence = delimitUntrustedWithClip(`MCP server "${server}" instructions`, text, MCP_INSTRUCTIONS_MAX_CHARS);
690
- return fence.clipped ? `${fence.text}\n${MCP_INSTRUCTIONS_TRUNCATION_NOTE}` : fence.text;
636
+ return fence.clipped ? `${fence.text}\n${mcpInstructionsTruncationNote(say)}` : fence.text;
637
+ }
638
+ function mcpInstructionsTruncationNote(say) {
639
+ return say("core/engine.mcp-entry-truncated", { max: String(MCP_INSTRUCTIONS_MAX_CHARS) });
691
640
  }
692
- const MCP_INSTRUCTIONS_TRUNCATION_NOTE = `(Truncated by the agent runtime: this server's instructions exceeded ${MCP_INSTRUCTIONS_MAX_CHARS} characters.)`;
693
- export function renderMcpInstructionsEntry(entry) {
641
+ export function renderMcpInstructionsEntry(entry, say = engineTextFor()) {
694
642
  if (entry.author !== "host")
695
- return fenceMcpServerInstructions(entry.server, entry.text);
643
+ return fenceMcpServerInstructions(entry.server, entry.text, say);
696
644
  const cps = [...entry.text];
697
- const body = cps.length > MCP_INSTRUCTIONS_MAX_CHARS ? `${cps.slice(0, MCP_INSTRUCTIONS_MAX_CHARS - 1).join("")}…\n${MCP_INSTRUCTIONS_TRUNCATION_NOTE}` : entry.text;
645
+ const body = cps.length > MCP_INSTRUCTIONS_MAX_CHARS ? `${cps.slice(0, MCP_INSTRUCTIONS_MAX_CHARS - 1).join("")}…\n${mcpInstructionsTruncationNote(say)}` : entry.text;
698
646
  return `## ${inlineUntrusted(entry.server, 160)}\n${body}`;
699
647
  }
700
- export function renderMcpInstructionsDelta(added, removed) {
648
+ export function renderMcpInstructionsDelta(added, removed, say = engineTextFor()) {
701
649
  const blocks = [];
702
650
  if (added.length > 0) {
703
- blocks.push(`# MCP Server Instructions\n\nThe following MCP servers have provided instructions for how to use their tools and resources:\n\n${added.map(renderMcpInstructionsEntry).join("\n\n")}`);
651
+ blocks.push(`${say("core/engine.mcp-header")}\n\n${say("core/engine.mcp-intro")}\n\n${added.map((entry) => renderMcpInstructionsEntry(entry, say)).join("\n\n")}`);
704
652
  }
705
653
  if (removed.length > 0) {
706
- blocks.push(`The following MCP servers have disconnected. Their instructions above no longer apply:\n${removed.join("\n")}`);
654
+ blocks.push(`${say("core/engine.mcp-disconnected")}\n${removed.join("\n")}`);
707
655
  blocks.push(AMBIENT_CONTEXT_NOTE);
708
656
  }
709
657
  return blocks.length > 0 ? blocks.join("\n\n") : undefined;