@sema-agent/core 7.66.0 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -41,14 +41,15 @@ export declare function uncachedInputTokensOf(family: CacheFamily, u: {
41
41
  * Normalize one turn's reported usage into its `{ totalInputTokens, uncachedInputTokens, costMicroUsd }`
42
42
  * — the authoritative cost re-priced in core from injected pricing (so cached tokens aren't charged at
43
43
  * full price). Shared by the run loop's per-turn accounting and post-task memory consolidation
44
- * so a pricing change lives in ONE place. We emit only 5-min-TTL cache writes, so
45
- * `cacheWriteTokensLong` is 0.
44
+ * so a pricing change lives in ONE place. `cacheWriteLong` is the one-hour part of `cacheWrite`; the exclusive price buckets are split
45
+ * from them HERE, once (a table with no one-hour price leaves that part in the five-minute bucket, never as plain input).
46
46
  */
47
47
  export declare function usageCostMicroUsd(family: CacheFamily, u: {
48
48
  input?: number;
49
49
  output?: number;
50
50
  cacheRead?: number;
51
51
  cacheWrite?: number;
52
+ cacheWriteLong?: number;
52
53
  }, pricing: ModelPricing): {
53
54
  totalInputTokens: number;
54
55
  uncachedInputTokens: number;
@@ -19,11 +19,12 @@ export function usageCostMicroUsd(family, u, pricing) {
19
19
  const normalized = { input: u.input || 0, cacheRead: u.cacheRead || 0, cacheWrite: u.cacheWrite || 0 };
20
20
  const totalInputTokens = promptTokensOf(family, normalized);
21
21
  const uncachedInputTokens = uncachedInputTokensOf(family, normalized);
22
+ const longWrites = pricing.cacheWriteLongPer1M !== undefined ? Math.max(0, Math.min(u.cacheWriteLong || 0, normalized.cacheWrite)) : 0;
22
23
  const costMicroUsd = computeCostMicroUsd({
23
24
  totalInputTokens,
24
25
  cacheReadTokens: normalized.cacheRead,
25
- cacheWriteTokens: normalized.cacheWrite,
26
- cacheWriteTokensLong: 0,
26
+ cacheWriteTokens: normalized.cacheWrite - longWrites,
27
+ cacheWriteTokensLong: longWrites,
27
28
  outputTokens: u.output || 0,
28
29
  }, pricing);
29
30
  return { totalInputTokens, uncachedInputTokens, costMicroUsd };
@@ -13,7 +13,7 @@ export async function voidVerifierPause(input) {
13
13
  const leg = compositionLegRecord(cp.state.compositionLeg);
14
14
  if (leg?.entry !== "verify") {
15
15
  throw new CheckpointError("resume.composition_mismatch", `this card was not parked by a verification gate's verifier leg (it records ${leg === undefined ? "no composition leg" : `a ${leg.entry} leg`}) — ` +
16
- "voidVerifierPause voids only a verifier's own card; nothing was settled and the row is as it was");
16
+ "voidVerifierPause voids only a verifier's own card; nothing was settled and the row is as it was", { reason: "not_a_verifier_card" });
17
17
  }
18
18
  const report = (err, sessionId) => {
19
19
  try {
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * The HOST wiring seat: `RunnerDeps` — every store, sink, hook and policy provider a deployment hands
3
- * the engine — plus the three structured shapes only its own callbacks produce (`ProjectMemoryLoad`,
4
- * `ResumePreflightInfo`, `ResumePreflightVerdict`). Layer 0 vocabulary; `types.ts` re-exports all four,
5
- * so no consumer's import changes.
3
+ * the engine — plus the two structured shapes only its own callbacks produce (`ResumePreflightInfo`,
4
+ * `ResumePreflightVerdict`). Layer 0 vocabulary; `types.ts` re-exports all three, so no consumer's
5
+ * import changes.
6
6
  */
7
7
  import type { Model } from "../internal/llm.js";
8
8
  import type { AgentDefinition } from "./agent-definition.js";
@@ -13,50 +13,6 @@ import type { HandsBandOptions } from "./hands-band.js";
13
13
  import type { OnElicit } from "./mcp-server-spec.js";
14
14
  import type { Brain, ModelRef, ModelRoles } from "./model-seat.js";
15
15
  import type { RuntimeCaps, WorkflowGovernanceBaseline } from "./runtime-caps.js";
16
- /**
17
- * parity-204 — the `RunnerDeps.loadProjectMemory` return: the one form a loader answers in (a loader with nothing to
18
- * inject answers `{ content: null }`; a bare `string | null` is not read). Carries the `seededFromContext`
19
- * seam (cc204-bundle @17917159: CC preloads readFileState for CLAUDE.md/nested-memory files it
20
- * placed in context, and a DEFAULT whole-file Read of an unchanged seeded file answers with the
21
- * already-in-context reminder instead of re-transmitting the body — token economy, GA in 204).
22
- */
23
- export interface ProjectMemoryLoad {
24
- /** The project-context text to inject (null/blank ⇒ no injection). */
25
- content: string | null;
26
- /**
27
- * Files whose FULL, disk-verbatim text the deployment has placed in the model's context (e.g. the
28
- * CLAUDE.md that `content` embeds). The Runner pre-seeds the hands' read state (through the same
29
- * resolveKey containment as a real Read — an out-of-root path is silently skipped), so a default
30
- * whole-file Read of an UNCHANGED seeded file returns the reminder
31
- * (`This file is already in your context (see "Contents of <path>" above) and has not changed on
32
- * disk…`) instead of the body. `content` here MUST be the file's exact disk text at load time —
33
- * the unchanged check hashes it; never declare a truncated/annotated variant (CC's `isPartialView`
34
- * exemption). A file that later changes on disk always reads normally (hash mismatch bypasses the
35
- * dedup and disarms it). Requires hands (an executionEnv); ignored on a hands-less task.
36
- */
37
- seededFiles?: ReadonlyArray<{
38
- path: string;
39
- content: string;
40
- }>;
41
- /**
42
- * design-A C-3 (AGENTS.md×ingest, [A1]) — the deployment DECLARES which instruction files this
43
- * snapshot was built from and their fingerprints (e.g. `AGENTS.md` / `CLAUDE.md`, hash over the
44
- * raw pre-cap file bytes). Core does NOT interpret the hash algorithm or re-derive it — the pair
45
- * is an OPAQUE comparison baseline (`path` + verbatim `contentHash` equality only), kept so the
46
- * mid-session change probe can answer "did the file behind my snapshot move?" without core
47
- * ever learning a file-name policy (types.ts seam rule: core never hardcodes instruction file
48
- * names). [A2]: this list now FEEDS the C-4 `instructions_change` lane — when the deployment also
49
- * wires {@link RunnerDeps.probeInstructionSources}, the run loop probes these paths at eligible
50
- * turn boundaries and a moved hash is announced via a fixed tail attachment. Optional and inert
51
- * when absent (today's loaders keep their exact behavior; no sources ⇒ the lane never runs).
52
- */
53
- instructionSources?: ReadonlyArray<{
54
- path: string;
55
- /** `null` = the source is DECLARED but currently ABSENT from disk — the change probe then watches for
56
- * its APPEARANCE (renders "absent → hash"). */
57
- contentHash: string | null;
58
- }>;
59
- }
60
16
  /**
61
17
  * design/380 O2 — the facts handed to a deployment's {@link RunnerDeps.resumePreflight}: the row's
62
18
  * own recorded identity + placement record, read off the persisted checkpoint (never off the resume
@@ -109,12 +65,20 @@ export type ResumePreflightVerdict = {
109
65
  };
110
66
  /** Runtime dependencies shared across tasks. */
111
67
  export interface RunnerDeps {
68
+ /** The deployment's Brain; every engine read of it goes through the model lane (`brain/model-lane.ts`), which walks a catalog
69
+ * entry's `Model.fallbacks` chain on this same Brain and passes any other request straight through. */
112
70
  brain: Brain;
113
- /** Catalog used to resolve string ModelRefs to Model objects. */
71
+ /** Catalog used to resolve string ModelRefs to Model objects; its door (`new Runner` / `swapDeps`) also resolves each entry's
72
+ * `fallbacks` words over it (`config.model_fallback_invalid` on a bad chain). */
114
73
  models?: Record<string, Model>;
74
+ /** The deployment's model-fallback policy ({@link ModelFallbackPolicy}: the gate words, the per-hop first-token deadline),
75
+ * received once at `new Runner`; a bad value ⇒ `config.model_fallback_invalid`; absent ⇒ the default gate, no deadline. */
76
+ modelFallback?: import("./model-fallbacks.js").ModelFallbackPolicy;
77
+ /** The deployment's prompt-cache retention word: ONE word, written on every call of the Brain seat in every lane (main loop, compaction, classifier, side query, mod call, advisor, consolidation) over the call's own value — what each brain does with it, and the price of `"long"` on one-off calls too, is `StreamOptions.cacheRetention`; absent ⇒ today's bytes; a non-word ⇒ `config.invalid_argument` at `new Runner`. */
78
+ cacheRetention?: import("../internal/llm.js").CacheRetention;
115
79
  /**
116
80
  * The deployment's per-model CONTEXT-WINDOW overlay, keyed by CATALOG WORD ({@link ContextSettings}):
117
- * `contextTokens` / `autoCompactTokens` over what the model card declares, `autoCompact` / `manualCompact` the task seats' twins.
81
+ * `contextTokens` / `autoCompactTokens` over what the model card declares, `reserveTokens` (twin of the task's, which outranks it), `autoCompact` / `manualCompact` the task seats' twins.
118
82
  *
119
83
  * It is the ONE hot-swappable seat an IN-FLIGHT leg re-reads. Every other seat follows the snapshot law
120
84
  * (a running task keeps the deps object it prepared under) because those seats are the routing card —
@@ -129,20 +93,18 @@ export interface RunnerDeps {
129
93
  */
130
94
  contextSettings?: ContextSettings;
131
95
  /**
132
- * design/338 (mid-turn MCP revocation) — the HOST's revocation ledger, probed synchronously at
133
- * every MCP dispatch (tool call + the three resource tools) BEFORE the transport. The engine
134
- * never caches the answer: the ledger's one authority lives on the host (a cached copy would be
135
- * a split-state second authority). A revoked server's calls settle as the coded refusal
136
- * `mcp.server_revoked` with known-not-executed wording; in-flight calls a revocation raced are
137
- * deliberately not chased (the threat shape is "new calls after removal"). Absent seat = the
138
- * pre-338 semantics. A THROWING probe fails open (revocation is a tightening face — a broken
139
- * probe must not brick every MCP call) with a once-per-MATERIALIZATION `mcp.revocation_probe_failed`
140
- * notice (a resume re-materializes and may announce again — the standing condition is re-news at
141
- * each fresh mount, never per-call). The notice is a deployment wiring fact: `detail: { message }`
142
- * only, no session attribution, `"operator"` audience by its explicit {@link NOTICE_AUDIENCE} row — a wire projector
143
- * forwards it operator-tier and needs no per-session de-duplication of its own. The probe's second argument, `{ fingerprint }`, is passed exactly when the server's declaration carries one.
144
- */
145
- mcpRevocations?: import("./mcp-server-spec.js").McpRevocationLedger;
96
+ * The HOST's revocation ledger over the protocol peers a run declares — its MCP servers and A2A peers — as one seat
97
+ * (protocol-revocation.ts). `revoked({ protocol, server | peer, fingerprint? })` is asked SYNCHRONOUSLY, never cached, as each request
98
+ * leaves the engine: an MCP server's dial (a 401 re-dial included), each listing page, each call, resource request and 401 re-send; an
99
+ * A2A peer's card, each message and status poll, every redirect hop. A request answered revoked is not sent (a call answers
100
+ * `mcp.server_revoked` / `a2a.peer_revoked`; a dial or a card fetch leaves the status row `failed` / `errorCode: "revoked"`; a refresh
101
+ * answers `revoked`); one already sent is not chased. `fingerprint` rides exactly when the MCP declaration carries one. Absent ⇒ never
102
+ * asked. A ledger that throws, or answers anything but a boolean (a Promise included — the seat is synchronous), fails OPEN and is told
103
+ * ONCE PER LEG, whichever protocol asked first: `protocol.revocation_probe_failed` (`detail: { message, runId }`, operator audience).
104
+ * Read once at `new Runner`: a value that is not an object with a `revoked` function — a Proxy, a function, the retired MCP-only
105
+ * `{ isRevoked }` form — is refused there (`config.invalid_argument`).
106
+ */
107
+ protocolRevocations?: import("./protocol-revocation.js").ProtocolRevocationLedger;
146
108
  peerSeat?: import("./peer-seat.js").PeerSeat;
147
109
  /**
148
110
  * design/147 S1c (ruled 2026-07-18) — the DURABLE name→agent roster behind explicit-name
@@ -991,15 +953,13 @@ export interface RunnerDeps {
991
953
  * WHO consumes this deployment's principal inbox (`principal.inbox`, where the
992
954
  * organization's delivery gate appends cross-principal letters; the mailbox contract's fourth chain).
993
955
  * Absent = no consumer, no lane (byte for byte as before); a deployment that mounts a gate DECLARES
994
- * `{ assistant: "<agent handle>" }` (the only consumer; no terminal leg touches the box; an agent handle is `a` and 6–32 lower-case
995
- * hex digits, the shape the task registry mints) or `"terminals"` (each terminal drains the box as a second lane; a held letter's
956
+ * `"assistant"` (the only consumer: the leg the host hands `RunInternals.principalInboxAssistant` reads the box, through `ReadInbox`
957
+ * alone; no terminal leg touches it) or `"terminals"` (each terminal drains the box as a second lane; a held letter's
996
958
  * decision is the letter's own field in the box, so every terminal reads the same one). Letters are judged on the principal's
997
- * `crossSessionInbound` layers (managed, user), held when unset. ANY other value fails the prepare of a leg
998
- * that drains a session box with `config.principal_inbox_consumer_invalid` (`detail.reason: "malformed"`).
959
+ * `crossSessionInbound` layers (managed, user), held when unset. ANY other value (the retired `{ assistant: "<handle>" }` among them,
960
+ * refused with the way to the current form) fails a session-box leg's prepare with `config.principal_inbox_consumer_invalid` (`detail.reason: "malformed"`).
999
961
  */
1000
- principalInboxConsumer?: "terminals" | {
1001
- assistant: string;
1002
- };
962
+ principalInboxConsumer?: "terminals" | "assistant";
1003
963
  /**
1004
964
  * design/385 §4.4 (slice 4) — this deployment's `dialogExpiry` (settings key, vocabulary
1005
965
  * `"60s" | "5m" | "10m" | "never"`, default `"5m"`): how long a HELD cross-session message whose cause
@@ -1149,85 +1109,6 @@ export interface RunnerDeps {
1149
1109
  sessionId: string;
1150
1110
  phase: "checkpoint" | "terminal";
1151
1111
  }) => void;
1152
- /**
1153
- * design/113 C4 — proactive project startup. The Runner calls this once during `prepareTask` (every prepare,
1154
- * incl. durable resume — design/113 §4 H8) and injects the returned text as a READ-ONLY, FENCED, virtual
1155
- * `"project"` memory layer at the TAIL (so the agent "sees" what project it is in from turn 1, like CC's
1156
- * CLAUDE.md/git injection — the cure for "say hi → only greets"). The deployment/profile owns the CONTENT
1157
- * (read CLAUDE.md / `.claude/` + fold in `git log -5`/status + a byte budget); core owns the seam + fence +
1158
- * cache placement and NEVER hardcodes a filename (same trust posture as {@link executionEnvFactory}/
1159
- * {@link mods}/{@link modelKnowledgeCutoffs}). A RunnerDeps FUNCTION, not a `TaskSpec` field: it is
1160
- * unserializable (durable resume) and reading files for an UNTRUSTED caller would be a confused-deputy hole
1161
- * (design/44 §7 Q4). DECOUPLED from `memoryStore` — injects even with NO long-term memory configured (H5).
1162
- *
1163
- * `undefined` (default) ⇒ the whole path is skipped = byte-identical to today (full parity, H3). The loader answers a
1164
- * {@link ProjectMemoryLoad}; `{ content: null }` (or blank content) ⇒ no injection (also byte-identical). Any other
1165
- * answer (a bare string, `null`, a non-object) is not read: it is disclosed on `onError` (phase `config`) and the leg runs
1166
- * with no project layer, as when the loader throws. The content is fenced/sanitized like every other memory
1167
- * layer (repo-controlled CLAUDE.md is UNTRUSTED data, not an instruction — H2). The ctx lets a profile tailor
1168
- * or suppress: `handsEnabled:false` = a hands-less chat with no real project (answer `{ content: null }`); `isSubagent` =
1169
- * a delegated child (a profile may trim CLAUDE.md for a cheap "grep this" subagent — H7).
1170
- */
1171
- loadProjectMemory?: (ctx: {
1172
- /** The task's working directory (= the execution env's cwd; a worktree task = its worktree root). */
1173
- cwd: string;
1174
- /** False ⇒ a hands-less chat (no real filesystem/project) — a profile typically answers `{ content: null }`. */
1175
- handsEnabled: boolean;
1176
- /** True ⇒ a delegated subagent run (a profile may trim/suppress project content to control cost). */
1177
- isSubagent: boolean;
1178
- /** The subagent's type name, when `isSubagent` — lets a profile tailor content per agent type. */
1179
- agentName?: string;
1180
- /**
1181
- * design-A C-1 ([A2]) — the acquired session's id (uuid domain; equals the run's `sessionId`).
1182
- * A deployment keys its SESSION-LEVEL snapshot cache on this (design-A §4.1 freeze unit: read
1183
- * once per session, reuse across the session's prepares) — core itself caches nothing across
1184
- * prepares. Always filled by the Runner; optional so hand-built ctx objects stay valid.
1185
- */
1186
- sessionId?: string;
1187
- /** The run this prepare belongs to — the id the `task.start` trace frame, `noteTaskRun` and `TaskResult.runId` carry. Always filled by the Runner. */
1188
- runId?: string;
1189
- /**
1190
- * design-A C-1/C-2 ([A2]) — where this prepare sits in the snapshot lifecycle; the deployment's
1191
- * cache-invalidation signal (core only derives and forwards it, and ignores the answer):
1192
- * - `"fresh"` — no prior context: a brand-new session (no `spec.sessionId`, or an empty one).
1193
- * - `"resume"` — an existing session's context continues (a durable-resume leg, a same-session
1194
- * follow-up run, or a `resumeAt` rewind): a cached snapshot is still the one
1195
- * the model has been seeing.
1196
- * - `"post-compact"`— a compaction landed since the model's last full turn on this branch (branch
1197
- * tail shows a `compaction` entry with no *user* message after it): the context
1198
- * was rebuilt — the design-A §4.1 re-read boundary; a deployment should drop
1199
- * its snapshot cache and read fresh. HONEST APPROXIMATION (recorded, see
1200
- * docs/REVIEW-BACKLOG.md): a compaction followed by a mid-run user-role
1201
- * injection (steer) before the next prepare reads as `"resume"` — the freshness
1202
- * gap is covered by the C-4 `instructions_change` lane, not by this signal.
1203
- * A session clear starts a NEW session, which reads `"fresh"` (rewinding past the root is rejected).
1204
- */
1205
- phase?: "fresh" | "resume" | "post-compact";
1206
- }) => Promise<ProjectMemoryLoad> | ProjectMemoryLoad;
1207
- /**
1208
- * design-A C-4 ([A2]) — the mid-session instruction-file change PROBE (the server half of the
1209
- * `instructions_change` attachment lane). At eligible turn boundaries (continuation-gated like
1210
- * `date_change`) the run loop calls this with the snapshot's declared
1211
- * {@link ProjectMemoryLoad.instructionSources} and compares the answer against the lane's
1212
- * per-path last-announced hash; a moved hash appends a fixed ≤512-byte tail notice (the model is
1213
- * told the file changed and can Read the truth — the snapshot itself stays frozen, §4.1).
1214
- * Contract:
1215
- * - return `null` ⇒ this boundary is SKIPPED silently (nothing announced, nothing committed; the
1216
- * next boundary retries) — the fail-soft path for a remote cwd / EACCES / transient IO.
1217
- * - a per-entry `contentHash: null` ⇒ the file is GONE from disk (announced once as removed).
1218
- * - paths not in `sources` are ignored; the probe should never throw (core guards anyway and
1219
- * treats a throw exactly like `null`).
1220
- * - core never reads files here and never interprets the hash (opaque equality only — the same
1221
- * posture as `instructionSources`); the lstat/read/hash economics live in the deployment.
1222
- * Unset ⇒ the lane does not exist: zero calls, zero state, byte-identical output.
1223
- */
1224
- probeInstructionSources?: (sources: ReadonlyArray<{
1225
- path: string;
1226
- contentHash: string | null;
1227
- }>) => Promise<ReadonlyArray<{
1228
- path: string;
1229
- contentHash: string | null;
1230
- }> | null>;
1231
1112
  /**
1232
1113
  * design/99 §E23 — the LIVE-ONLY inbound-elicitation seam (an MCP server asking the END USER for input
1233
1114
  * mid-tool-call). Wired ONLY for servers that opted in via {@link McpServerSpec.elicitation}; absent ⇒ core
@@ -1362,14 +1243,17 @@ export interface RunnerDeps {
1362
1243
  sessionId: string;
1363
1244
  /**
1364
1245
  * Machine-readable sub-classification when the site has one (a kebab-case word naming the arm) —
1365
- * e.g. the design/31 cache-break detector's root cause (`"model-switch" | "tool-schema" |
1366
- * "tool-set" | "system-prefix" | "server-or-ttl"`), or the file-history liveness arms
1367
- * (`"file-history-no-store"` / `"file-history-no-env"`). Lets the host pick its own log level:
1368
- * `"server-or-ttl"` is usually benign in agentic tasks (slow tools ⇒ 5min+ request gaps expire
1369
- * provider caches — service[64] flag②) and warrants info/warn, while the prefix-bug causes
1370
- * warrant attention.
1246
+ * e.g. where the design/31 cache-break detector located the change ({@link import("./cache-break-detector.js").CacheBreakFinding}
1247
+ * `cause`), or the file-history liveness arms (`"file-history-no-store"` / `"file-history-no-env"`). Lets the host
1248
+ * pick its own log level: `"server-or-ttl"` is usually benign (slow tools ⇒ 5min+ request gaps expire provider
1249
+ * caches — service[64] flag②); a located change with `expected` was declared (a lawful opening); one without it is an
1250
+ * undeclared prefix change, reported whether or not the cache dropped, and warrants attention.
1371
1251
  */
1372
1252
  classification?: string;
1253
+ /** `"prompt-cache"` findings only: `expected` = declared before the request went out; `firstChangedIndex` = the first
1254
+ * changed position (a tool index, a rewritten message index). */
1255
+ expected?: true;
1256
+ firstChangedIndex?: number;
1373
1257
  }) => void;
1374
1258
  /**
1375
1259
  * Structured sink for operator-facing NOTICES ({@link EngineNotice}) — announcements that are not
@@ -1469,9 +1353,9 @@ export interface RunnerDeps {
1469
1353
  clearOnRejection?: boolean;
1470
1354
  };
1471
1355
  /**
1472
- * Two-phase prefix-cache-break detection (design/31): per turn, fingerprint the prefix and, on a
1473
- * confirmed `cacheRead` drop, emit a root-cause finding via `onError(phase:"prompt-cache")`. Cheap
1474
- * (hashes only) and only fires on a detected break. Default **on**; set `false` to disable.
1356
+ * Two-phase prefix-cache-break detection (design/31): per turn, fingerprint the prefix and emit a finding via
1357
+ * `onError(phase:"prompt-cache")` on a confirmed `cacheRead` drop (`expected` when the located change was declared)
1358
+ * and on any prefix change no seat declared. Cheap (hashes only). Default **on**; set `false` to disable.
1475
1359
  */
1476
1360
  cacheBreakDetection?: boolean;
1477
1361
  /**
@@ -66,9 +66,14 @@ export interface WorkflowGovernanceBaseline {
66
66
  * catalog does not hold — so the legal set is the INTERSECTION of this list and the catalog keys
67
67
  * (note the catalog is the Runner's TIER-EXPANDED one, so on a deployment with `RunnerDeps.tiers`
68
68
  * the tier words and CC aliases are catalog keys here too, still gated by this list).
69
- * NEVER fail-open to the whole `models` catalog for an LLM-authored workflow.
69
+ * NEVER fail-open to the whole `models` catalog for an LLM-authored workflow unless the deployment
70
+ * writes so: the one word `"catalog"` instead of a list declares that every entry of the catalog the
71
+ * leg runs under is pickable. Which names a value answers, and when a change to them takes effect, is
72
+ * `workflowModelNamesOf`'s contract (orchestration/workflow-governance.ts). Any other value (a string
73
+ * other than `"catalog"`, a list holding a non-string or an empty name) refuses the mount
74
+ * (`config.invalid_governance_baseline`); `null` reads as absent.
70
75
  */
71
- workflowModelAllowlist?: string[];
76
+ workflowModelAllowlist?: string[] | "catalog";
72
77
  }
73
78
  /**
74
79
  * design/99 §K — the per-principal runtime ENTITLEMENTS the engine enforces server-side, resolved by a
@@ -121,7 +126,7 @@ export interface RuntimeCaps {
121
126
  * gate, not a config mistake).
122
127
  */
123
128
  allowObservers?: boolean;
124
- /** `true` FORCES this principal's run onto the durable-approval path: the engine synthesizes a
129
+ /** `true` FORCES this principal's run onto the durable-approval path: on a ROOT leg the engine synthesizes a
125
130
  * `durableApproval{scope: principal}` so a policy `ask` suspends to the wire (a per-tool CC-faithful gate)
126
131
  * even when the caller did not opt in — center's fleet-wide "interactive runs gate" mandate. A
127
132
  * caller-supplied `TaskSpec.durableApproval` always wins (it may carry a tighter scope/ttl).
@@ -130,7 +135,14 @@ export interface RuntimeCaps {
130
135
  * `config.durable_gate_unavailable` once (before its first ask), every ask resolves on the live chain
131
136
  * (a live approver / question face in-stream, or the fail-closed deny with none), no durable record
132
137
  * is written, and a live question face is consulted rather than vetoed (a mandate that cannot park
133
- * must not demote a reachable person into the model answering for them). */
138
+ * must not demote a reachable person into the model answering for them).
139
+ * On a DELEGATED leg it synthesizes nothing: such a leg can be resumed only under the opt-in its parent forwarded
140
+ * (a background child on a park-capable lane, a workflow agent — the parent's effective opt-in, a forced root's
141
+ * synthesized one included). Where the entitlement reaches a delegated leg with a store and no forwarded opt-in
142
+ * (a synchronous or fork child), the leg announces `config.durable_gate_unavailable` (cause `leg_not_resumable`)
143
+ * and parks no ask, and nothing answers in the mandate's place: every permission ask is refused without
144
+ * consulting the approver and a question is refused (not shown) — a delegated leg does not answer what its
145
+ * principal is forced to park. */
134
146
  forceDurableGate?: boolean;
135
147
  /**
136
148
  * The per-principal auto-mode DENY bit (the mirror of the settings-plane
@@ -22,7 +22,7 @@
22
22
  import { type RedactionConfidence, type RedactionSource } from "@sema-agent/primitives";
23
23
  import { type EngineNotice } from "./engine-notice.js";
24
24
  /** Does a value carry a credential? A URL userinfo (after every `scheme://`, and a leading `//`) with a password or a
25
- * token-like user; a scheme-less `user:password@host`; a credential assignment; a webhook URL; a Sonar login; a
25
+ * token-like user; a userinfo with no `//` in front of it the vocabulary reads; a credential assignment; a webhook URL; a Sonar login; a
26
26
  * private-key header; an `Authorization` header, `token …`, `Bearer …` or `Basic …` with credential-shaped content (the
27
27
  * value forms are the vocabulary's rows, {@link ENV_VALUES}). Reads the first {@link VALUE_SCAN_LIMIT} code units. The value half of the judgment, exported apart from the env
28
28
  * entry's exemptions ({@link isExemptEnvName}): a caller holding a value that is no environment variable asks this. */
@@ -61,6 +61,12 @@ export interface WithheldEnvDeclaration {
61
61
  * a flag or placeholder word, one character repeated, or fewer than eight characters. */
62
62
  readonly values: readonly string[];
63
63
  }
64
+ /** One character, three times or more, and nothing else: `xxxxxxxx`, `00000000` (a known vendor token prefix is set aside
65
+ * first, the env value view's `tokenHead`: `sk-xxxxxxxx`). The language of `/^(\S)\1{2,}$/u` — one code point that is
66
+ * no white space, repeated — read by comparing the text with that code point repeated, not by a back-reference loop: a
67
+ * regex engine keeps backtrack state per repetition, so a value of a few million characters would exhaust it. Exported
68
+ * for the checks that hold it to that language; not part of the package entry. */
69
+ export declare function isOneCharacterRepeated(text: string): boolean;
64
70
  /**
65
71
  * THE one reading of an empty credential: a string with nothing but white space in it, the empty string included, is no
66
72
  * credential, whoever hands it and wherever it is handed. Every face that asks "was a credential handed at all" reads
@@ -188,8 +194,9 @@ export declare function hostChildEnvProblem(policy: unknown, ...grants: readonly
188
194
  /**
189
195
  * THE environment a child spawned ON THIS HOST starts with: {@link inheritedHostEnv}'s reading of `policy`, then each
190
196
  * grant in order (a later grant's value wins, names compared as the platform compares them; an `undefined` value
191
- * unsets). The tool shell's children and a command hook's children are composed here alike: a hook starts from the
192
- * run's shell policy and settings-env grant, with the hook's own variables as the last grant. An own credential is never
197
+ * unsets). The tool shell's children, a command hook's children and a local language server are composed here alike: a
198
+ * hook starts from the run's shell policy and settings-env grant, with the hook's own variables as the last grant; a
199
+ * language server reads `"scrub"` with the host's `NodeLspManagerOptions.env` as its grant. An own credential is never
193
200
  * inherited; a grant is the host's explicit act and is not read against the declaration. A grant that is not an object
194
201
  * or throws while read, a name that is empty or holds `=`, NUL or an unpaired surrogate, and a value that is not a
195
202
  * string or holds NUL or an unpaired surrogate throw, as a refused policy does ({@link hostChildEnvProblem}).
@@ -199,6 +206,14 @@ export declare function hostChildEnv(policy: InheritEnvPolicy | undefined, ...gr
199
206
  * `undefined` when it is: a malformed policy, or an allow list naming one of the declared own credentials
200
207
  * ({@link declareWithheldEnv}, compared as it says). */
201
208
  export declare function inheritEnvPolicyProblem(value: unknown): string | undefined;
209
+ /** The declaration half of {@link inheritEnvPolicyProblem}, for a value whose shape is a policy: the first entry of an allow
210
+ * list that names one of the declared own credentials, and the sentence refusing it; `undefined` for a word, or a list
211
+ * naming none. A judged list can only turn up here after a declaration made since it was judged. */
212
+ export declare function declaredInheritEntry(value: unknown): {
213
+ index: number;
214
+ name: string;
215
+ refusal: string;
216
+ } | undefined;
202
217
  /** Test seam: never called by production code. */
203
218
  export declare function __resetSecretEnvScrubNoticeAnnouncement(): void;
204
219
  /** What both disclosures say about one set of findings: every withheld name, and those that are the engine's own
@@ -229,4 +244,6 @@ export declare function announceSecretEnvScrub(onNotice: ((notice: EngineNotice)
229
244
  export declare function withheldEnvUserNotice(withheld: readonly SecretEnvFinding[] | "unknown", at: {
230
245
  sessionId: string;
231
246
  runId?: string | undefined;
247
+ sourceSessionId?: string | undefined;
248
+ agentId?: string | undefined;
232
249
  }): EngineNotice | undefined;
@@ -4,6 +4,8 @@ import { CREDENTIAL_MIN_CHARS, envNameView, envValueView, isSensitiveHeaderName,
4
4
  import { DEFAULT_INHERITED_ENV_VARS } from "@modelcontextprotocol/client/stdio";
5
5
  import { deliverEngineNotice } from "./engine-notice.js";
6
6
  import { optionKeys, receiveMembers } from "./own-property-receipt.js";
7
+ import { callerText } from "./caller-text.js";
8
+ import { describeRejectedValue } from "./tool-search-setting.js";
7
9
  const GIT_CONFIG_ENV_RE = /^GIT_CONFIG_(?:COUNT|PARAMETERS|(?:KEY|VALUE)_[0-9]+)$/;
8
10
  const PROXY_ENV_RE = /^(?:(?:https?|ftp|all|no)_proxy|npm_config_(?:https?_)?proxy|npm_config_noproxy|yarn_proxy|(?:yarn|global_agent|docker|claude_code)_(?:https?|no)_proxy|cloudsdk_proxy_[a-z]+|electron_get_use_proxy)$/i;
9
11
  function isExemptEnvName(name) {
@@ -14,7 +16,7 @@ const ENV_VALUES = envValueView();
14
16
  const OTEL_ENV_RE = /^(?:INPUT_)?OTEL_/i;
15
17
  const SEMA_NAMESPACE_SECRET_RE = ENV_NAMES.anySegmentUnder("SEMA_");
16
18
  const BUNDLER_SETTINGS = ["BUILD", "LOCAL", "MIRROR", "PATH", "WITH", "WITHOUT", "CACHE", "DISABLE", "IGNORE", "ONLY"];
17
- const BUNDLER_HOST = "(?:[A-Za-z0-9]+(?:___[A-Za-z0-9]+)*__)+[A-Za-z]{2,}";
19
+ const BUNDLER_HOST = "(?:[A-Za-z0-9]+(?:___[A-Za-z0-9]+)*__)+[A-Za-z]{2}[A-Za-z]*";
18
20
  const BUNDLER_CREDENTIAL_RE = new RegExp(`^(?:INPUT_)?BUNDLE_(?!(?:${BUNDLER_SETTINGS.join("|")})__(?!${BUNDLER_HOST}$))\\w*__`, "i");
19
21
  const PUBLISHER_PREFIX_RE = /^(?:INPUT_|ORG_GRADLE_PROJECT_|POETRY_PYPI_TOKEN_|POETRY_HTTP_BASIC_|CARGO_REGISTRIES_|CONAN_LOGIN_USERNAME_|CONAN_PASSWORD_)/i;
20
22
  const PUBLISHER_LOGIN_PREFIX_RE = /^(?:INPUT_)?(?:POETRY_HTTP_BASIC_|CONAN_LOGIN_USERNAME_)/i;
@@ -36,8 +38,8 @@ const VALUE_SCAN_LIMIT = 8192;
36
38
  function looksLikeToken(user) {
37
39
  return ENV_VALUES.tokenHead.test(user) || (user.length >= 20 && /[0-9]/.test(user) && /[a-z]/i.test(user));
38
40
  }
39
- const HOST_RE = /^(?:localhost|[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.(?=[a-z0-9-]*[a-z])[a-z0-9-]+|[a-z0-9_.-]+(?=:\d+(?:[/?#]|$))|\d{1,3}(?:\.\d{1,3}){3}|\[[0-9a-f:.]+\])(?::\d+)?(?:[/?#]|$)/i;
40
- const HOSTLIKE_RE = /^(?:(?=[a-z0-9._-]*[a-z])[a-z0-9._-]+|\d{1,3}(?:\.\d{1,3}){3}|\[[0-9a-f:.]+\])(?::\d+)?(?:[/?#]|$)/i;
41
+ const HOST_RE = /^(?:localhost|[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.(?=[a-z0-9-]*[a-z])[a-z0-9-]+|[a-z0-9_.-]+(?=:\d+(?:[/?#]|$))|\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}|\[[0-9a-f:.]+\])(?::\d+)?(?:[/?#]|$)/i;
42
+ const HOSTLIKE_RE = /^(?:(?=[a-z0-9._-]*[a-z])[a-z0-9._-]+|\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}|\[[0-9a-f:.]+\])(?::\d+)?(?:[/?#]|$)/i;
41
43
  function isHostPortPathBeforeAt(before, after) {
42
44
  const hostPort = /^([a-z0-9_-]+(?:\.[a-z0-9_-]+)*):\d+([/?#].*)$/is.exec(before);
43
45
  if (!hostPort)
@@ -63,12 +65,16 @@ function authorityCarriesCredential(rest) {
63
65
  return false;
64
66
  return userinfo.includes(":") || (!/[/?#]/.test(userinfo) && looksLikeToken(userinfo));
65
67
  }
66
- const PACKAGE_REFERENCE_RE = /^(?:[\w.-]+(?::[\w.-]+)?@sha(?:256|384|512):[0-9a-f]{32,}|npm:(?:@[\w.-]+\/)?[\w.-]+@[\w.^~<>=*|+-]*|[a-z_][\w.-]*:[\w.-]+:v?\d[\w.+\[\](),-]*@(?:jar|war|ear|aar|apk|aab|pom|zip|tar|tgz|module|klib|exe|dll|so|dylib)?)$/i;
67
- function carriesSchemelessUserinfo(text) {
68
- if (!/^[^\s/@:]+:(?!\/\/)(?![\\/])[^\s@]*@[^\s/@]+/.test(text) || /^[a-z]:[\\/]/i.test(text) || PACKAGE_REFERENCE_RE.test(text))
69
- return false;
70
- const at = text.lastIndexOf("@", text.search(/\s|$/));
71
- return !isHostPortPathBeforeAt(text.slice(0, at), text.slice(at + 1)) && !/^(?:mailto|sips?|xmpp|im|acct):/i.test(text);
68
+ const URL_USERINFO = ENV_VALUES.urlUserinfo;
69
+ function carriesFrontlessUserinfo(text) {
70
+ for (const m of text.matchAll(URL_USERINFO)) {
71
+ if ((m[1] ?? "").endsWith("//"))
72
+ continue;
73
+ const userinfo = (m[2] ?? "").slice(0, -1);
74
+ if (userinfo.includes(":") || (!/[?#]/.test(userinfo) && looksLikeToken(userinfo)))
75
+ return true;
76
+ }
77
+ return false;
72
78
  }
73
79
  export function looksLikeCredentialValue(value) {
74
80
  const text = value.length > VALUE_SCAN_LIMIT ? value.slice(0, VALUE_SCAN_LIMIT) : value;
@@ -78,7 +84,7 @@ export function looksLikeCredentialValue(value) {
78
84
  }
79
85
  if (text.startsWith("//") && authorityCarriesCredential(text.slice(2)))
80
86
  return true;
81
- return carriesSchemelessUserinfo(text) || ENV_VALUES.forms.some((form) => form.re.test(text));
87
+ return carriesFrontlessUserinfo(text) || ENV_VALUES.forms.some((form) => form.re.test(text));
82
88
  }
83
89
  const OWN_CREDENTIAL = "the engine's own service credential";
84
90
  const SECRET_ENV_KIND_CONFIDENCE = {
@@ -183,8 +189,16 @@ function runtimeSuppliedHolderOf(value) {
183
189
  const supplied = policyArm([...runtimeSuppliedEnv()]);
184
190
  return Object.keys(supplied).find((k) => supplied[k] === value);
185
191
  }
186
- const PLACEHOLDER_KEY_WORDS = new Set([...ENV_VALUES.flagWords, "undefined", "placeholder", "lm-studio", "not-needed", "sk-no-key-required"]);
187
- const ONE_REPEATED_CHARACTER_RE = /^(\S)\1{2,}$/u;
192
+ const PLACEHOLDER_KEY_WORDS = new Set([...ENV_VALUES.flagWords, ...ENV_VALUES.placeholderWords]);
193
+ export function isOneCharacterRepeated(text) {
194
+ const first = text.codePointAt(0);
195
+ if (first === undefined)
196
+ return false;
197
+ const unit = String.fromCodePoint(first);
198
+ if (!/^\S$/u.test(unit) || text.length < 3 * unit.length || text.length % unit.length !== 0)
199
+ return false;
200
+ return text === unit.repeat(text.length / unit.length);
201
+ }
188
202
  export function isBlankCredential(value) {
189
203
  return value.trim() === "";
190
204
  }
@@ -196,7 +210,7 @@ function notACredentialReason(value) {
196
210
  return `a string of fewer than ${CREDENTIAL_MIN_CHARS} characters, which names no secret`;
197
211
  if (PLACEHOLDER_KEY_WORDS.has(text.toLowerCase()))
198
212
  return "a flag or placeholder word, which names no secret";
199
- if (ONE_REPEATED_CHARACTER_RE.test(text.replace(ENV_VALUES.tokenHead, "")))
213
+ if (isOneCharacterRepeated(text.replace(ENV_VALUES.tokenHead, "")))
200
214
  return "one character repeated, which names no secret";
201
215
  return undefined;
202
216
  }
@@ -228,7 +242,7 @@ export function declareWithheldEnv(table) {
228
242
  if (given === null || typeof given !== "object" || Array.isArray(given)) {
229
243
  throw new Error(`declareWithheldEnv: the declaration must be a table { names, values } (got ${Array.isArray(given) ? "an array — a names-only list is no longer a declaration: pass { names, values }" : kindOf(given)})`);
230
244
  }
231
- const received = receiveMembers(given, { subject: "declareWithheldEnv's table", unit: "member", moment: "at the declaration" }, WITHHELD_ENV_TABLE_KEYS, (_, [stray]) => new Error(`declareWithheldEnv: the table has a member ${JSON.stringify(String(stray).slice(0, 64))} — it holds names and values only`));
245
+ const received = receiveMembers(given, { subject: "declareWithheldEnv's table", unit: "member", moment: "at the declaration" }, WITHHELD_ENV_TABLE_KEYS, (_, [stray]) => new Error(`declareWithheldEnv: the table has a member ${callerText(stray)} — it holds names and values only`));
232
246
  const givenNames = received.names;
233
247
  if (!Array.isArray(givenNames))
234
248
  throw new Error(`declareWithheldEnv: names must be an array of variable names (got ${kindOf(givenNames)})`);
@@ -363,7 +377,7 @@ function policyShapeProblem(value) {
363
377
  return undefined;
364
378
  if (Array.isArray(value))
365
379
  return variableNameListProblem("inheritEnv", value);
366
- return `inheritEnv must be "scrub", "all" or a list of variable names (got ${typeof value === "string" ? JSON.stringify(value) : value === null ? "null" : typeof value})`;
380
+ return `inheritEnv must be "scrub", "all" or a list of variable names (got ${describeRejectedValue(value)})`;
367
381
  }
368
382
  export function inheritedHostEnv(policy, findings) {
369
383
  const problem = inheritEnvPolicyProblem(policy);
@@ -442,13 +456,19 @@ function policyArm(policy, findings) {
442
456
  return arm;
443
457
  }
444
458
  export function inheritEnvPolicyProblem(value) {
445
- const shape = policyShapeProblem(value);
459
+ return policyShapeProblem(value) ?? declaredInheritEntry(value)?.refusal;
460
+ }
461
+ export function declaredInheritEntry(value) {
446
462
  const { names } = withheldEnvOf();
447
- if (shape !== undefined || !Array.isArray(value) || names.length === 0)
448
- return shape;
463
+ if (!Array.isArray(value) || names.length === 0)
464
+ return undefined;
465
+ const list = value;
449
466
  const own = new Set(names.map(envNameKey));
450
- const named = value.findIndex((k) => own.has(envNameKey(k)));
451
- return named === -1 ? undefined : `inheritEnv[${named}] names ${value[named]}, which is ${OWN_CREDENTIAL} and cannot be inherited by a child (a configuration error: no retry succeeds until the policy or the declaration changes)`;
467
+ const index = list.findIndex((k) => own.has(envNameKey(k)));
468
+ const name = list[index];
469
+ if (name === undefined)
470
+ return undefined;
471
+ return { index, name, refusal: `inheritEnv[${index}] names ${name}, which this process has declared (declareWithheldEnv) to be ${OWN_CREDENTIAL}, so a child cannot inherit it (a configuration error: no retry succeeds until the policy or the declaration changes)` };
452
472
  }
453
473
  let secretEnvScrubNoticeAnnounced = false;
454
474
  export function __resetSecretEnvScrubNoticeAnnouncement() {
@@ -473,11 +493,14 @@ export function announceSecretEnvScrub(onNotice, findings) {
473
493
  });
474
494
  }
475
495
  export function withheldEnvUserNotice(withheld, at) {
476
- const route = { sessionId: at.sessionId, ...(at.runId !== undefined ? { runId: at.runId } : {}) };
496
+ const route = { sessionId: at.sessionId, ...(at.sourceSessionId !== undefined ? { sourceSessionId: at.sourceSessionId } : {}), ...(at.agentId !== undefined ? { agentId: at.agentId } : {}), ...(at.runId !== undefined ? { runId: at.runId } : {}) };
497
+ const delegated = at.sourceSessionId !== undefined;
498
+ const shell = delegated ? "the tool shell of a delegated agent in this session" : "the tool shell in this session";
499
+ const subject = delegated ? "A delegated agent's tool shell in this session" : "The tool shell in this session";
477
500
  if (withheld === "unknown") {
478
501
  return {
479
502
  code: "inherit_env.names_withheld",
480
- message: "The engine could not determine which variables of its environment the tool shell in this session does not receive: the execution environment does not say. Variables you set may read as unset there.",
503
+ message: `The engine could not determine which variables of its environment ${shell} does not receive: the execution environment does not say. Variables you set may read as unset there.`,
481
504
  detail: { state: "unknown", ...route },
482
505
  };
483
506
  }
@@ -491,7 +514,7 @@ export function withheldEnvUserNotice(withheld, at) {
491
514
  ];
492
515
  return {
493
516
  code: "inherit_env.names_withheld",
494
- message: `The tool shell in this session does not receive ${names.length} variable(s) of the engine's environment: ${halves.join("; ")}. Values are never shown.`,
517
+ message: `${subject} does not receive ${names.length} variable(s) of the engine's environment: ${halves.join("; ")}. Values are never shown.`,
495
518
  detail: { state: "withheld", names, ...(ownCredentials.length > 0 ? { ownCredentials } : {}), ...route },
496
519
  };
497
520
  }
@@ -119,6 +119,14 @@ export declare function canonicalDataRootKeys(env: ExecutionEnv, spellings: read
119
119
  * containment test would be a second place for the two judges to disagree about what "inside" means.
120
120
  */
121
121
  export declare function relativeUnderRoot(targetKey: string, rootKey: string): string | null;
122
+ /**
123
+ * The row of the recommended sensitive-path table (`RECOMMENDED_SENSITIVE_PATTERNS`: the `.ssh` / `.aws` / `.git/hooks` / key-file rows the
124
+ * write guard reads) that any of `spellings` lands on — its pattern as written — or `undefined` when none does. The same rows, the same
125
+ * segment judgment and the same host case fold as the write guard's, read over bare spellings: pure and synchronous (no environment, no
126
+ * data-root exemption — a directory the host points a store at is judged whole, the way the guard judges a target outside the data root).
127
+ * For a reader that asks "is this directory one the guard protects" rather than "may this call write here".
128
+ */
129
+ export declare function sensitiveRowOf(spellings: readonly string[]): string | undefined;
122
130
  /**
123
131
  * Build a composable policy that DENIES writes (via the guarded fs tools) whose target lands on a guarded pattern — by any
124
132
  * view its reading holds: the spelling anchored at the tool's declared base, the canonical target, a hop of the leaf's