@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
@@ -1,4 +1,4 @@
1
- import type { RendererId } from "./catalog/schema.js";
1
+ import type { PromptCatalog, RendererId } from "./catalog/schema.js";
2
2
  import { type PromptSelectors } from "./select.js";
3
3
  import type { SectionRenderInputs } from "./types.js";
4
4
  export interface RendererSpec {
@@ -13,9 +13,9 @@ export interface RendererSpec {
13
13
  export declare const RENDERERS: Readonly<Record<RendererId, RendererSpec>>;
14
14
  /** The renderer version vector — the identity's renderer element (a changed output bumps a version). */
15
15
  export declare function rendererVector(): Readonly<Record<RendererId, number>>;
16
- /** One renderer's output for these inputs (and the variant it rendered, when it rendered a catalog message);
17
- * undefined ⇒ the section is absent this run. */
18
- export declare function runRenderer(id: RendererId, inputs: SectionRenderInputs, selectors: PromptSelectors): {
16
+ /** One renderer's output for these inputs (and the variant it rendered, when it rendered a catalog message — read through
17
+ * {@link messageText}, so in the run's locale); undefined ⇒ the section is absent this run. */
18
+ export declare function runRenderer(id: RendererId, inputs: SectionRenderInputs, selectors: PromptSelectors, catalog?: PromptCatalog): {
19
19
  readonly text: string;
20
20
  readonly variant?: string;
21
21
  } | undefined;
@@ -1,36 +1,45 @@
1
- import { reminderMarkDeclaration } from "../core/reminder-mint.js";
1
+ import { declarationWithMark } from "../core/reminder-mint.js";
2
2
  import { renderCoworkBase } from "../prompts/cowork.js";
3
- import { catalogMessage } from "./catalog/index.js";
4
- import { selectVariant } from "./select.js";
3
+ import { ENVIRONMENT_MESSAGES } from "./catalog/environment.js";
4
+ import { catalogMessage, SEMA_DEFAULT_CATALOG } from "./catalog/index.js";
5
+ import { messageText } from "./select.js";
5
6
  export const RENDERERS = {
6
7
  "role-base": { id: "role-base", version: 2, stability: "session", reads: "selectors", external: false, messages: ["core/role.base"] },
7
8
  "mcp-instructions": { id: "mcp-instructions", version: 1, stability: "session", reads: "mcp", external: true },
8
- "reminder-mark": { id: "reminder-mark", version: 1, stability: "session", reads: "mark", external: false },
9
- environment: { id: "environment", version: 2, stability: "leg", reads: "env", external: false },
10
- memory: { id: "memory", version: 1, stability: "leg", reads: "memory", external: false },
9
+ "reminder-mark": { id: "reminder-mark", version: 1, stability: "session", reads: "mark", external: false, messages: ["core/harness.reminder-mark"] },
10
+ environment: { id: "environment", version: 3, stability: "leg", reads: "env", external: false, messages: ENVIRONMENT_MESSAGES.map((m) => m.id) },
11
+ memory: { id: "memory", version: 2, stability: "leg", reads: "memory", external: false, messages: ["core/memory.no-persistent-store"] },
11
12
  };
12
13
  export function rendererVector() {
13
14
  return Object.fromEntries(Object.values(RENDERERS).map((r) => [r.id, r.version]));
14
15
  }
15
- export function runRenderer(id, inputs, selectors) {
16
+ export function runRenderer(id, inputs, selectors, catalog = SEMA_DEFAULT_CATALOG) {
16
17
  const plain = (text) => (text === undefined ? undefined : { text });
18
+ const read = (message) => messageText(catalog, catalogMessage(message, catalog), selectors);
17
19
  switch (id) {
18
20
  case "role-base": {
19
- const v = selectVariant(catalogMessage("core/role.base"), selectors);
21
+ const v = read("core/role.base");
20
22
  if (v === undefined)
21
23
  return undefined;
22
- if (v.id !== "cowork")
23
- return { text: v.text, variant: v.id };
24
- const sections = renderCoworkBase({ tools: inputs.toolNames ?? [], workspaceFolder: inputs.workspaceFolder });
25
- return sections.length === 0 ? undefined : { text: sections.map((s) => s.text).join("\n\n"), variant: v.id };
24
+ if (v.variant !== "cowork")
25
+ return v;
26
+ const sections = renderCoworkBase({ tools: inputs.toolNames ?? [], workspaceFolder: inputs.workspaceFolder }, v.text);
27
+ return sections.length === 0 ? undefined : { text: sections.map((s) => s.text).join("\n\n"), variant: v.variant };
26
28
  }
27
29
  case "mcp-instructions":
28
30
  return plain(inputs.mcpInstructionsBlock);
29
- case "reminder-mark":
30
- return plain(inputs.facts.reminderMark !== undefined ? reminderMarkDeclaration(inputs.facts.reminderMark) : undefined);
31
+ case "reminder-mark": {
32
+ const mark = inputs.facts.reminderMark;
33
+ const v = mark !== undefined ? read("core/harness.reminder-mark") : undefined;
34
+ return v === undefined || mark === undefined ? undefined : { text: declarationWithMark(v.text, mark), variant: v.variant };
35
+ }
31
36
  case "environment":
32
- return plain(inputs.environmentBlock);
33
- case "memory":
34
- return plain(inputs.memoryBlock);
37
+ return inputs.environmentBlock === undefined ? undefined : { text: inputs.environmentBlock, variant: "default" };
38
+ case "memory": {
39
+ const lead = inputs.facts.memoryStoreAbsent === true ? read("core/memory.no-persistent-store") : undefined;
40
+ if (lead === undefined)
41
+ return plain(inputs.memoryBlock);
42
+ return { text: inputs.memoryBlock !== undefined ? `${lead.text}\n\n${inputs.memoryBlock}` : lead.text, variant: lead.variant };
43
+ }
35
44
  }
36
45
  }
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * The role base's one decision rule (a leaf): of an ordered list of sources — the task, the requested model role's
3
- * preset, an engine spawner's child persona — the first that names a role base decides it wholly (the sugar's header).
3
+ * preset — the first that names a role base decides it wholly (the sugar's header).
4
4
  */
5
5
  import type { HostRole } from "./catalog/schema.js";
6
6
  /** A source's statement of the role base — its word (the host role; selects the `core/role.base` variant), its text
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * The selector: the one reading that picks, for a catalog message, the variant a run receives — and decides
3
- * whether an overlay's `when` applies to this run (every source class alike). Four dimensions, each with exactly one
3
+ * whether an overlay's `when` applies to this run (every source class alike). Five dimensions, each with exactly one
4
4
  * writer, so no value ever needs a precedence order:
5
5
  *
6
6
  * - `traits` — the model's declared traits (`Model.promptTraits`) with the task's one switch on `lean_prompt`
@@ -10,12 +10,14 @@
10
10
  * `standard`).
11
11
  * - `facts` — the runtime facts prepare produces (one derived: `executionEnvironmentDeclared`).
12
12
  * - `binding` — the deployment's scenario name (`TaskSpec.promptBinding`, an open vocabulary; absent ⇒ none).
13
+ * - `locale` — which rendering of the chosen variant the run reads (`TaskSpec.promptLocale`; absent ⇒ `canonical`, the
14
+ * catalog's own text). It picks no variant: the variant is chosen first, its rendering after ({@link messageText}).
13
15
  *
14
16
  * A `when` is a conjunction: every listed trait present, every `noneOf` trait absent, every host key equal, every
15
17
  * fact equal, the binding inside its `anyOf` (or outside its `noneOf`). No disjunction across dimensions.
16
18
  */
17
19
  import type { PromptManifestSelectors } from "../core/trace.js";
18
- import { type CatalogMessage, type FactConjunction, type HostForm, type HostRole, type PromptFactName, type PromptTraitName, type TraitCondition, type Variant, type VariantWhen } from "./catalog/schema.js";
20
+ import { type CatalogMessage, type FactConjunction, type HostForm, type HostRole, type PromptCatalog, type PromptFactName, type PromptLocale, type PromptTraitName, type RenderedLocale, type TraitCondition, type Variant, type VariantWhen } from "./catalog/schema.js";
19
21
  import type { PromptRuntimeFacts } from "./types.js";
20
22
  /** The run's selector values, resolved once per assembly. */
21
23
  export interface PromptSelectors {
@@ -26,6 +28,7 @@ export interface PromptSelectors {
26
28
  };
27
29
  readonly facts: Readonly<Record<PromptFactName, boolean>>;
28
30
  readonly binding?: string;
31
+ readonly locale: PromptLocale;
29
32
  }
30
33
  /**
31
34
  * The run's effective traits — the one place a trait set is formed: the model's declared set (exact: nothing is added
@@ -64,17 +67,26 @@ export declare function resolveHost(task: {
64
67
  export declare function resolvePromptLean(task: {
65
68
  readonly promptLean?: unknown;
66
69
  }): boolean | undefined;
70
+ /** The rendering of the catalog as its one writer gave it (`TaskSpec.promptLocale`, `SideQuerySpec.promptLocale` —
71
+ * `seat` names which in the refusal): absent (the catalog's own text), or a rendered locale — today `"zh-Hans"`.
72
+ * `"canonical"` is the absence's name, not a value a caller writes, so it is refused like any other word
73
+ * (`config.prompt_selector_invalid`), never read as absent. */
74
+ export declare function resolvePromptLocale(task: {
75
+ readonly promptLocale?: unknown;
76
+ }, seat?: string): RenderedLocale | undefined;
67
77
  /** A role-base seat's role word as its writer gave it — the one door every seat that may name a role base passes
68
78
  * (`TaskSpec.promptRole`, a role preset's `promptRole`, the delegation tool's `promptRole`; `seat` names where it was
69
79
  * written): absent, or a word of {@link HOST_ROLES}; anything else is refused by name (`config.prompt_selector_invalid`). */
70
80
  export declare function readPromptRole(seat: string, value: unknown): HostRole | undefined;
71
81
  /** The run's selectors — their one mint: the facts from the runtime facts, the host from its two writers' values, the
72
- * binding as the task's door validated it, and the effective traits ({@link effectiveTraitsOf}; absent ⇒ those of a
73
- * model that declares none, with no task switch). */
82
+ * binding as the task's door validated it, the effective traits ({@link effectiveTraitsOf}; absent ⇒ those of a
83
+ * model that declares none, with no task switch) and the locale as its door gave it (absent ⇒ `canonical`). Prepare
84
+ * mints once and every reader of the run — the manifest, the identity, the `prompt.compose` event and the composer —
85
+ * reads that one object. */
74
86
  export declare function selectorsOf(facts: PromptRuntimeFacts, host?: {
75
87
  readonly role?: HostRole;
76
88
  readonly form?: HostForm;
77
- }, binding?: string, traits?: ReadonlySet<PromptTraitName>): PromptSelectors;
89
+ }, binding?: string, traits?: ReadonlySet<PromptTraitName>, locale?: RenderedLocale): PromptSelectors;
78
90
  /** The selectors' plain form (traits sorted): what the manifest shows, the identity's `binding` element digests and the
79
91
  * `prompt.compose` event carries — one record. */
80
92
  export declare function selectorRecordOf(s: PromptSelectors): PromptManifestSelectors;
@@ -94,3 +106,12 @@ export declare function whenHolds(when: VariantWhen | undefined, s: PromptSelect
94
106
  export declare function canonicalWhen(when: VariantWhen | undefined): VariantWhen | undefined;
95
107
  /** The variant this run receives, or undefined when no variant's `when` holds (the message is absent). */
96
108
  export declare function selectVariant(message: CatalogMessage, s: PromptSelectors): Variant | undefined;
109
+ /** A message's text this run: the selector chooses the variant, the run's locale its rendering ({@link renderingOf}).
110
+ * `undefined` ⇒ no variant's `when` holds, the message is absent. */
111
+ export declare function messageText(catalog: PromptCatalog, message: CatalogMessage, s: PromptSelectors): {
112
+ readonly variant: string;
113
+ readonly text: string;
114
+ } | undefined;
115
+ /** A chosen variant's text in a locale — as written (`canonical`) or that locale's rendering — read by {@link messageText}
116
+ * and by the engine text reading. A missing rendering is a defect the catalog door refuses, so it throws, never falls back. */
117
+ export declare function renderingOf(catalog: PromptCatalog, messageId: string, variant: Variant, locale: PromptLocale): string;
@@ -1,4 +1,4 @@
1
- import { bundleMembersOf, HOST_ROLES, isHostRole, isPromptTraitName } from "./catalog/schema.js";
1
+ import { bundleMembersOf, HOST_ROLES, isHostRole, isPromptTraitName, isWordOf, PROMPT_LOCALES } from "./catalog/schema.js";
2
2
  const UNDECLARED_MODEL_TRAITS = Object.freeze(["lean_prompt"]);
3
3
  export function effectiveTraitsOf(declared, lean) {
4
4
  const traits = new Set(declared ?? UNDECLARED_MODEL_TRAITS);
@@ -47,6 +47,7 @@ export function catalogFactsOf(facts) {
47
47
  worktreeIsolated: facts.worktreeIsolated,
48
48
  teammateEnabled: facts.teammateEnabled,
49
49
  isSubagent: facts.isSubagent === true,
50
+ memoryStoreAbsent: facts.memoryStoreAbsent === true,
50
51
  executionEnvironmentDeclared: facts.policyEnabled || facts.isolationEnabled,
51
52
  };
52
53
  }
@@ -59,6 +60,14 @@ export function resolvePromptLean(task) {
59
60
  const v = task.promptLean;
60
61
  return v === undefined || v === true || v === false ? v : refuseSelector("TaskSpec.promptLean", v, ["true", "false"]);
61
62
  }
63
+ export function resolvePromptLocale(task, seat = "TaskSpec.promptLocale") {
64
+ const v = task.promptLocale;
65
+ return v === undefined ? undefined : isRenderedLocale(v) ? v : refuseSelector(seat, v, RENDERED_LOCALES.map((l) => `"${l}"`));
66
+ }
67
+ const RENDERED_LOCALES = PROMPT_LOCALES.filter((l) => l !== "canonical");
68
+ function isRenderedLocale(v) {
69
+ return isWordOf(RENDERED_LOCALES, v);
70
+ }
62
71
  export function readPromptRole(seat, value) {
63
72
  return value === undefined ? undefined : isHostRole(value) ? value : refuseSelector(seat, value, HOST_ROLES.map((a) => `"${a}"`));
64
73
  }
@@ -67,12 +76,13 @@ function refuseSelector(seat, value, allowed) {
67
76
  code: "config.prompt_selector_invalid",
68
77
  });
69
78
  }
70
- export function selectorsOf(facts, host = {}, binding, traits = effectiveTraitsOf(undefined, undefined)) {
79
+ export function selectorsOf(facts, host = {}, binding, traits = effectiveTraitsOf(undefined, undefined), locale) {
71
80
  return Object.freeze({
72
81
  traits,
73
82
  host: Object.freeze({ role: host.role ?? "general", form: host.form ?? "standard" }),
74
83
  facts: Object.freeze(catalogFactsOf(facts)),
75
84
  ...(binding !== undefined ? { binding } : {}),
85
+ locale: locale ?? "canonical",
76
86
  });
77
87
  }
78
88
  export function selectorRecordOf(s) {
@@ -81,6 +91,7 @@ export function selectorRecordOf(s) {
81
91
  traits: [...s.traits].sort(),
82
92
  host: { role: s.host.role, form: s.host.form },
83
93
  facts: { ...s.facts },
94
+ locale: s.locale,
84
95
  };
85
96
  }
86
97
  export function factsHold(conj, facts) {
@@ -135,3 +146,15 @@ export function canonicalWhen(when) {
135
146
  export function selectVariant(message, s) {
136
147
  return message.variants.find((v) => whenHolds(v.when, s));
137
148
  }
149
+ export function messageText(catalog, message, s) {
150
+ const v = selectVariant(message, s);
151
+ return v === undefined ? undefined : { variant: v.id, text: renderingOf(catalog, message.id, v, s.locale) };
152
+ }
153
+ export function renderingOf(catalog, messageId, variant, locale) {
154
+ if (locale === "canonical")
155
+ return variant.text;
156
+ const row = catalog.locales[locale]?.[messageId]?.[variant.id];
157
+ if (row === undefined)
158
+ throw new Error(`prompt catalog ${catalog.id}: no ${locale} rendering of ${messageId}#${variant.id}`);
159
+ return row.text;
160
+ }
@@ -0,0 +1,19 @@
1
+ /**
2
+ * The named-slot grammar of catalog text: `{{name}}`, a word between double braces. It is the one reading of
3
+ * "which slots does this text carry" and "fill them": the Cowork base renders its template through it, the engine's
4
+ * own texts are filled through it where the engine mints them, and the overlay door asks it whether a message may
5
+ * be an overlay's text.
6
+ *
7
+ * This module imports nothing, so the catalog modules and the Cowork template can both read it without a cycle.
8
+ */
9
+ /** The slot names a text carries, in order of occurrence (a name used twice is listed twice). */
10
+ export declare function slotNames(text: string): string[];
11
+ /**
12
+ * Fill a text's slots in one pass: each `{{name}}` is replaced by `valueOf(name)`, read as written (a value is never
13
+ * scanned again, so a value carrying `{{x}}` or `$&` lands verbatim). A slot whose value is `undefined` stays as
14
+ * written and is reported in `missing`, in order of occurrence.
15
+ */
16
+ export declare function fillSlots(text: string, valueOf: (name: string) => string | undefined): {
17
+ readonly text: string;
18
+ readonly missing: readonly string[];
19
+ };
@@ -0,0 +1,16 @@
1
+ const SLOT = /\{\{(\w+)\}\}/g;
2
+ export function slotNames(text) {
3
+ return [...text.matchAll(SLOT)].map((m) => m[1]);
4
+ }
5
+ export function fillSlots(text, valueOf) {
6
+ const missing = [];
7
+ const filled = text.replace(SLOT, (whole, name) => {
8
+ const value = valueOf(name);
9
+ if (value === undefined) {
10
+ missing.push(name);
11
+ return whole;
12
+ }
13
+ return value;
14
+ });
15
+ return { text: filled, missing };
16
+ }
@@ -2,10 +2,10 @@
2
2
  * The request-body sugar: the one place the task's role-layer prompt inputs are read and turned into overlays of
3
3
  * the `task` source class. Two inputs, one reading each:
4
4
  *
5
- * - the role base — the first of three sources that names one decides it ({@link roleBaseOf}): the task (its door-judged
6
- * `promptRole` and its `systemPrompt`), then the requested model role's preset, then the persona a core spawner hands
7
- * its child (`internals.defaultSystemPrompt`). The deciding source's word is the run's host role; its text, when it
8
- * names one, is a `replace` of `core/role.base`, applied after the selector chose the variant;
5
+ * - the role base — the first of two sources that names one decides it ({@link roleBaseOf}): the task (its door-judged
6
+ * `promptRole` and its `systemPrompt`), then the requested model role's preset. The deciding source's word is the run's
7
+ * host role; its text, when it names one, is a `replace` of `core/role.base`, applied after the selector chose the
8
+ * variant. Neither naming one leaves the selector's answer (a delegated child's is the sub-agent persona variant);
9
9
  * - the appended block — `TaskSpec.appendSystemPrompt` — an `add` to the `task-append` band (entry `core/role.append`);
10
10
  *
11
11
  * and nothing else reads them for assembly (`gate:sugar-single-site`). The sugar is applied first within its class,
@@ -25,9 +25,6 @@ export interface SugarInputs {
25
25
  /** The task seat's role word as its door judged it (`TaskSpec.promptRole`, `resolveHost`). */
26
26
  readonly taskRole?: HostRole;
27
27
  readonly resolvedRole: RoleBaseDeclaration;
28
- readonly internals?: {
29
- readonly defaultSystemPrompt?: string;
30
- };
31
28
  }
32
29
  /** The task class's first overlays (role base, then the appended block) and the run's host role, from ONE decision. */
33
30
  export interface RequestBodySugar {
@@ -4,8 +4,7 @@ const SUGAR = { source: "task", by: "sugar" };
4
4
  export function requestBodySugar(inputs) {
5
5
  const taskText = inputs.spec.systemPrompt;
6
6
  const task = { ...(inputs.taskRole !== undefined ? { promptRole: inputs.taskRole } : {}), ...(taskText !== undefined ? { systemPrompt: taskText } : {}) };
7
- const engineText = inputs.internals?.defaultSystemPrompt;
8
- const decided = roleBaseOf([task, inputs.resolvedRole, engineText !== undefined ? { systemPrompt: engineText } : undefined]);
7
+ const decided = roleBaseOf([task, inputs.resolvedRole]);
9
8
  const roleBase = decided?.systemPrompt;
10
9
  const append = inputs.spec.appendSystemPrompt;
11
10
  const out = [];
@@ -22,7 +22,7 @@ export interface ToolContractDescriptor {
22
22
  origin: ToolOrigin;
23
23
  /** Structure-only schema digest (descriptions/titles/examples stripped) — presentation-invariant. */
24
24
  shapeDigest: string;
25
- /** Full materialized schema digest (incl. descriptions) — the model-visible wire face. */
25
+ /** Full schema digest (incl. descriptions) of the model-visible wire face — the schema as `projectToolSchema` shows it. */
26
26
  wireSchemaDigest: string;
27
27
  /** The presentation card in effect ({@link cardIdOf}): `builtin:<wireName>` for a declared contract's card, the
28
28
  * undeclared-contract prefix for any other tool's, and `#<variant id>` after it when the mount chose one of the
@@ -96,6 +96,10 @@ export declare function attachedContractOf(tool: object): ToolContractDescriptor
96
96
  * inherits a core contract by name (§7.2: don't guess contracts from names).
97
97
  */
98
98
  export declare function getToolContract(tool: AgentTool, fallbackOrigin?: ToolOrigin): ToolContractDescriptor;
99
+ /** What a contract is read off — a mounted instance, or a task's own entry before it mounts (plus the descriptor it carries). */
100
+ export type ToolContractFace = Pick<AgentTool, "name" | "aliases" | "parameters" | "description">;
101
+ /** {@link getToolContract} over a {@link ToolContractFace}, for the static mount plan's reading; not exported from the root. */
102
+ export declare function toolContractOfFace(tool: ToolContractFace, fallbackOrigin?: ToolOrigin): ToolContractDescriptor;
99
103
  export declare function hasToolContract(tool: AgentTool): boolean;
100
104
  /** Manifest projection for the final mounted tool set (manifest v2 `tools`, protocol §5.4). */
101
105
  export declare function projectToolManifest(tools: readonly AgentTool[], originOf?: (tool: AgentTool) => ToolOrigin): ToolManifestRow[];
@@ -4,6 +4,7 @@ import { isPlainRecord, receive } from "../core/mods/kernel/receive.js";
4
4
  import { assertNoRetiredKeys, RETIRED_TOOL_SPEC_KEYS } from "../core/retired-keys.js";
5
5
  import { isPromptTraitName } from "./catalog/schema.js";
6
6
  import { traitsHold } from "./select.js";
7
+ import { projectToolSchema } from "../brain/tool-schema-projection.js";
7
8
  export function contractOriginOf(contractId) {
8
9
  return contractId.startsWith("core.") ? "core" : "caller";
9
10
  }
@@ -54,7 +55,7 @@ export function computeShapeDigest(schema) {
54
55
  return sha(canonical(stripPresentation(schema ?? null)));
55
56
  }
56
57
  export function computeWireSchemaDigest(schema, description) {
57
- return sha(`${canonical(schema ?? null)}\u0000${description}`);
58
+ return sha(`${canonical(projectToolSchema(schema ?? null))}\u0000${description}`);
58
59
  }
59
60
  const TOOL_CONTRACT = Symbol("sema.toolContract");
60
61
  const CARD_VARIANT = Symbol("sema.toolCardVariant");
@@ -171,6 +172,9 @@ export function attachedContractOf(tool) {
171
172
  return tool[TOOL_CONTRACT];
172
173
  }
173
174
  export function getToolContract(tool, fallbackOrigin = "caller") {
175
+ return toolContractOfFace(tool, fallbackOrigin);
176
+ }
177
+ export function toolContractOfFace(tool, fallbackOrigin = "caller") {
174
178
  const attached = tool[TOOL_CONTRACT];
175
179
  if (attached) {
176
180
  const mountedShape = computeShapeDigest(tool.parameters);
@@ -1,4 +1,4 @@
1
- import type { ToolFingerprintInput } from "../core/cache-break-detector.js";
1
+ import type { PrefixChangeCause, PrefixChangeDeclaration, ToolFingerprintInput } from "../core/cache-break-detector.js";
2
2
  /** Every prefix-shaping input a request carries — the CLASSIFICATION DOMAIN. Adding a field here
3
3
  * without classifying it in {@link PREFIX_INPUT_CLASSIFICATION} is a compile error. */
4
4
  export interface RawPrefixInputs {
@@ -29,6 +29,8 @@ export interface RawPrefixInputs {
29
29
  thinkingLevel: string | null;
30
30
  maxTokens: number | undefined;
31
31
  hasOutputSchema: boolean;
32
+ /** The deployment's prompt-cache retention word every call of the leg carries (absent ⇒ none written). */
33
+ cacheRetention?: string;
32
34
  /** Routing/audit fields — provably NOT part of the cacheable prefix. */
33
35
  sessionId: string;
34
36
  taskId: string | undefined;
@@ -50,6 +52,7 @@ export declare const PREFIX_INPUT_CLASSIFICATION: {
50
52
  readonly thinkingLevel: "cache-identity";
51
53
  readonly maxTokens: "cache-identity";
52
54
  readonly hasOutputSchema: "cache-identity";
55
+ readonly cacheRetention: "cache-identity";
53
56
  readonly sessionId: "proven-irrelevant";
54
57
  readonly taskId: "proven-irrelevant";
55
58
  readonly turn: "volatile-no-reuse";
@@ -74,29 +77,54 @@ export interface CacheIdentityElements {
74
77
  requestPolicyDigest: string;
75
78
  loweringVersion: string;
76
79
  }
80
+ /** Which writer moved the tool table: a deferred activation, a roster refresh, or the per-request view. */
81
+ export type ToolTableSource = "activation" | "roster" | "view";
82
+ /** One identity move as the trace reports it: the declared word and, where known, where it sits. */
83
+ export interface PrefixChangeNote {
84
+ cause: PrefixChangeCause;
85
+ /** `tool_table` only. */
86
+ source?: ToolTableSource;
87
+ /** `leg_start_inputs` only: the head segments that differ from the session's anchor (block ids, `tools`). */
88
+ segments?: string[];
89
+ /** `tool_table` only: the first tool position whose wire face differs. */
90
+ firstChangedIndex?: number;
91
+ }
92
+ /** The leg's prefix identity AND its declaration seat: each in-leg change to the head is declared once, by the seat that
93
+ * makes it, through the refresher of the element it moves (the word fixed by the refresher) or {@link TurnPromptSnapshot.declare}. */
77
94
  export interface TurnPromptSnapshot {
78
95
  elements: CacheIdentityElements;
79
96
  /** sha256(canonical(elements)) — the ONE eight-element identity value. */
80
97
  cacheIdentity: string;
81
98
  lowering: LoweringRecord;
82
- /** invoked after EVERY refresh so the run loop can emit the changed identity
83
- * (`prompt.snapshot_changed` trace); traces must never keep claiming a superseded prefix. */
84
- onChange?: (snapshot: TurnPromptSnapshot) => void;
85
- /** Refresh the tool half (design/36 rematerialize follows the declared mid-run change). */
86
- refreshTools(toolWire: RawPrefixInputs["toolWire"]): void;
99
+ /** invoked after every refresh that MOVED the identity, with the declared word, so the run loop can emit the
100
+ * changed identity (`prompt.snapshot_changed` trace); traces must never keep claiming a superseded prefix. */
101
+ onChange?: (snapshot: TurnPromptSnapshot, change: PrefixChangeNote) => void;
102
+ /** invoked with every declaration (an identity move, or {@link TurnPromptSnapshot.declare}); the leg's detector reads it. */
103
+ onDeclared?: (declaration: PrefixChangeDeclaration) => void;
104
+ /** The leg-start opening prepare found against the session's anchor (absent when the head is the anchored one,
105
+ * or the session holds no anchor for this segment); the run loop reports it once, beside `prompt.assembled`. */
106
+ legStart?: PrefixChangeNote;
107
+ /** The tool table's wire digest as MOUNTED (moved by `activation` / `roster`, not the per-request `view`): the anchor
108
+ * compares legs in it, since prepare sees the table before any request's view re-applies the same hiding. */
109
+ readonly mountedToolWireDigest: string;
110
+ /** Refresh the tool half — declares `tool_table` when the tools block moved. */
111
+ refreshTools(toolWire: RawPrefixInputs["toolWire"], source: ToolTableSource): void;
87
112
  /** Refresh the stable-system half (a compaction-boundary center change — pass the COMMITTED identity so the
88
- * identity never mixes old-artifact/new-prompt). */
113
+ * identity never mixes old-artifact/new-prompt) — declares `compaction` when it moved. */
89
114
  refreshStableSystem(stableSystemText: string, artifactDigest?: string): void;
90
- /** request-policy element follows mid-run wire changes (finalize lanes flip the
91
- * thinking level; a served-model swap re-namespaces the cache). */
115
+ /** The request-policy element follows the controls the main lane's calls carry — declares `request_policy`. */
92
116
  refreshRequestPolicy(p: {
93
- thinkingLevel?: string;
117
+ thinkingLevel?: string | null;
94
118
  maxTokens?: number | null;
119
+ cacheRetention?: string | null;
95
120
  }): void;
121
+ /** The namespace follows what served the answer — declares `model_namespace`. */
96
122
  refreshModel(m: {
97
123
  provider: string;
98
124
  modelId: string;
99
125
  }): void;
126
+ /** Declare a change no identity element carries (a history rewrite, a landed compaction's transcript). */
127
+ declare(declaration: PrefixChangeDeclaration): void;
100
128
  }
101
129
  /** Build the run's snapshot from classified raw inputs. Volatile/irrelevant fields are accepted so
102
130
  * the CLASSIFICATION stays total over everything callers hold, but only identity-class fields can
@@ -10,6 +10,7 @@ export const PREFIX_INPUT_CLASSIFICATION = {
10
10
  thinkingLevel: "cache-identity",
11
11
  maxTokens: "cache-identity",
12
12
  hasOutputSchema: "cache-identity",
13
+ cacheRetention: "cache-identity",
13
14
  sessionId: "proven-irrelevant",
14
15
  taskId: "proven-irrelevant",
15
16
  turn: "volatile-no-reuse",
@@ -46,51 +47,80 @@ function identityOf(e) {
46
47
  export function buildTurnPromptSnapshot(raw, api, promptHasher) {
47
48
  const promptSha = promptHasher ?? sha;
48
49
  const lowering = loweringRecordFor(api);
49
- let requestPolicy = { thinkingLevel: raw.thinkingLevel, maxTokens: (raw.maxTokens ?? null), hasOutputSchema: raw.hasOutputSchema };
50
+ let requestPolicy = {
51
+ thinkingLevel: raw.thinkingLevel,
52
+ maxTokens: raw.maxTokens ?? null,
53
+ hasOutputSchema: raw.hasOutputSchema,
54
+ ...(raw.cacheRetention !== undefined ? { cacheRetention: raw.cacheRetention } : {}),
55
+ };
56
+ const toolFace = (t) => ({ name: t.name, description: t.description, parameters: t.parameters });
57
+ let toolFaces = raw.toolWire.map((t) => canonical(toolFace(t)));
50
58
  const elements = {
51
59
  provider: raw.provider,
52
60
  modelId: raw.modelId,
53
61
  artifactDigest: raw.artifactDigest,
54
62
  layoutDigest: sha(canonical(raw.layoutGroups)),
55
63
  stableSystemDigest: promptSha(raw.stableSystemText),
56
- toolWireDigest: sha(canonical(raw.toolWire.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters })))),
64
+ toolWireDigest: sha(canonical(raw.toolWire.map(toolFace))),
57
65
  requestPolicyDigest: sha(canonical(requestPolicy)),
58
66
  loweringVersion: `${lowering.version}/${lowering.form}/${api}`,
59
67
  };
60
- const bump = () => {
68
+ const bump = (change) => {
61
69
  const next = identityOf(elements);
62
70
  if (next === snapshot.cacheIdentity)
63
71
  return;
64
72
  snapshot.cacheIdentity = next;
65
- snapshot.onChange?.(snapshot);
73
+ snapshot.onDeclared?.({ cause: change.cause });
74
+ snapshot.onChange?.(snapshot, change);
66
75
  };
76
+ let mounted = elements.toolWireDigest;
67
77
  const snapshot = {
68
78
  elements,
69
79
  cacheIdentity: "",
70
80
  lowering,
71
- refreshTools(toolWire) {
72
- elements.toolWireDigest = sha(canonical(toolWire.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters }))));
73
- bump();
81
+ get mountedToolWireDigest() {
82
+ return mounted;
83
+ },
84
+ refreshTools(toolWire, source) {
85
+ const faces = toolWire.map((t) => canonical(toolFace(t)));
86
+ const n = Math.min(faces.length, toolFaces.length);
87
+ let first = faces.length === toolFaces.length ? -1 : n;
88
+ for (let i = 0; i < n; i++) {
89
+ if (faces[i] !== toolFaces[i]) {
90
+ first = i;
91
+ break;
92
+ }
93
+ }
94
+ toolFaces = faces;
95
+ elements.toolWireDigest = sha(canonical(toolWire.map(toolFace)));
96
+ if (source !== "view")
97
+ mounted = elements.toolWireDigest;
98
+ bump({ cause: "tool_table", source, ...(first >= 0 ? { firstChangedIndex: first } : {}) });
74
99
  },
75
100
  refreshStableSystem(stableSystemText, artifactDigest) {
76
101
  elements.stableSystemDigest = promptSha(stableSystemText);
77
102
  if (artifactDigest !== undefined)
78
103
  elements.artifactDigest = artifactDigest;
79
- bump();
104
+ bump({ cause: "compaction" });
80
105
  },
81
106
  refreshRequestPolicy(p) {
107
+ const retention = p.cacheRetention === undefined ? requestPolicy.cacheRetention : (p.cacheRetention ?? undefined);
82
108
  requestPolicy = {
83
- ...requestPolicy,
84
- ...(p.thinkingLevel !== undefined ? { thinkingLevel: p.thinkingLevel } : {}),
85
- ...(p.maxTokens !== undefined ? { maxTokens: p.maxTokens } : {}),
109
+ thinkingLevel: p.thinkingLevel !== undefined ? p.thinkingLevel : requestPolicy.thinkingLevel,
110
+ maxTokens: p.maxTokens !== undefined ? p.maxTokens : requestPolicy.maxTokens,
111
+ hasOutputSchema: requestPolicy.hasOutputSchema,
112
+ ...(retention !== undefined ? { cacheRetention: retention } : {}),
86
113
  };
87
114
  elements.requestPolicyDigest = sha(canonical(requestPolicy));
88
- bump();
115
+ bump({ cause: "request_policy" });
89
116
  },
90
117
  refreshModel(m) {
91
118
  elements.provider = m.provider;
92
119
  elements.modelId = m.modelId;
93
- bump();
120
+ bump({ cause: "model_namespace" });
121
+ },
122
+ declare(declaration) {
123
+ snapshot.onDeclared?.(declaration);
94
124
  },
95
125
  };
96
126
  snapshot.cacheIdentity = identityOf(elements);
@@ -40,6 +40,9 @@ export interface PromptRuntimeFacts {
40
40
  /** THIS run is a delegated, non-fork subagent (named or not — a SUPERSET of {@link teammateEnabled}):
41
41
  * admits the consent notice and the delivery notes. A fork is excluded. OPTIONAL — absence reads as false. */
42
42
  isSubagent?: boolean;
43
+ /** The run has no memory store and no channel to persist through, and holds the user's conversation: the memory
44
+ * renderer leads with the no-persistent-store sentence. OPTIONAL — absence reads as false. */
45
+ memoryStoreAbsent?: boolean;
43
46
  }
44
47
  /** Inputs a renderer may read. Everything here is prepare-time-frozen; per-turn inputs ride event frames. */
45
48
  export interface SectionRenderInputs {