@sema-agent/core 7.66.1 → 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 (899) hide show
  1. package/CHANGELOG.md +3483 -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 +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +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.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -0,0 +1,673 @@
1
+ import { userAttachmentOf } from "../../internal/llm.js";
2
+ import { normalizeFileText } from "../../tools/fs/encoding.js";
3
+ import { countLines } from "../../tools/fs/fs-shared.js";
4
+ import { pathFamilyOf, sha256, startsWithDriveLetter } from "../../tools/fs/safety.js";
5
+ import { relativeUnderRoot } from "../sensitive-path-policy.js";
6
+ import { ORG_ADJUDICATION_TIMEOUT_MS } from "../permission-rule-org.js";
7
+ import { isInstructionLaneEntry, mintInstructionFrames } from "../user-attachment.js";
8
+ import { deliverEngineNotice } from "../engine-notice.js";
9
+ import { agentIdOf } from "../leg-identity.js";
10
+ import { describeRejectedValue } from "../tool-search-setting.js";
11
+ import { strayMembersOf } from "../own-property-receipt.js";
12
+ import { appendAdmittedRow } from "../row-admission.js";
13
+ import { asThrownError, thrownText } from "../thrown-value.js";
14
+ import { announceDigest, withAnnounceDigests } from "./announce-once-ledger.js";
15
+ import { steeringPreview } from "./steering-preview.js";
16
+ import { cutInstructionText, INSTRUCTION_FILE_MAX_BYTES, INSTRUCTION_INCLUDE_MAX_DEPTH, instructionFileCap, isTextIncludeTarget, processInstructionText, ruleGlobsMatch } from "./nested-memory-content.js";
17
+ export const NESTED_MEMORY_MAX_NAMES = 8;
18
+ export const NESTED_MEMORY_NAME_MAX = 255;
19
+ export const NESTED_MEMORY_MAX_HOST_RULES = 20;
20
+ export const NESTED_MEMORY_PROBES_PER_LOAD = 32;
21
+ export const NESTED_MEMORY_FRAME_BUDGET_FILES = 3;
22
+ export const NESTED_MEMORY_STAT_BATCH = 8;
23
+ export const NESTED_MEMORY_PROBE_FACE = "nested-memory";
24
+ export const INSTRUCTIONS_WITHHELD = "instructions.withheld";
25
+ export const INSTRUCTIONS_WITHHELD_REASONS = Object.freeze(["rule_denied", "outside_roots", "approval_required", "admission_unknown", "target_moved"]);
26
+ const FIELD = "TaskSpec.instructionFamily";
27
+ export const NESTED_MEMORY_LANE = Object.freeze({
28
+ declaration: FIELD,
29
+ origin: "nested_memory",
30
+ rootOrigin: "project_instructions",
31
+ echo: "steering_injected",
32
+ notice: INSTRUCTIONS_WITHHELD,
33
+ limits: Object.freeze({ maxNames: NESTED_MEMORY_MAX_NAMES, maxNameChars: NESTED_MEMORY_NAME_MAX, maxHostRules: NESTED_MEMORY_MAX_HOST_RULES, maxIncludeDepth: INSTRUCTION_INCLUDE_MAX_DEPTH, probesPerLoad: NESTED_MEMORY_PROBES_PER_LOAD }),
34
+ });
35
+ const refuse = (at, problem) => Object.assign(new Error(`${at}: ${problem}`), { code: "config.invalid_argument" });
36
+ const isPlain = (v) => v !== null && typeof v === "object" && !Array.isArray(v) && [Object.prototype, null].includes(Object.getPrototypeOf(v));
37
+ function onlyKeys(v, keys, at) {
38
+ const stray = strayMembersOf(v, { subject: at, unit: "member", moment: "when the run is prepared" }, keys);
39
+ if (stray !== undefined)
40
+ throw Object.assign(new Error(stray.sentence), { code: "config.invalid_argument" });
41
+ }
42
+ function screenName(v, at) {
43
+ if (typeof v !== "string")
44
+ throw refuse(at, `must be a string (got ${describeRejectedValue(v)}).`);
45
+ if (v.length === 0)
46
+ throw refuse(at, "is empty.");
47
+ if (v.length > NESTED_MEMORY_NAME_MAX)
48
+ throw refuse(at, `is ${v.length} characters, over ${NESTED_MEMORY_NAME_MAX}.`);
49
+ if (v.includes("\u0000"))
50
+ throw refuse(at, "holds a NUL character.");
51
+ if (v.includes("\\") || startsWithDriveLetter(v))
52
+ throw refuse(at, "must be a `/`-separated relative name (no backslash, no drive letter): the engine joins it to each directory itself.");
53
+ if (v.startsWith("/"))
54
+ throw refuse(at, "is absolute — it must be relative to each directory it is read in.");
55
+ const segments = v.split("/");
56
+ if (segments.some((s) => s === ""))
57
+ throw refuse(at, "has an empty segment (a doubled or trailing `/`).");
58
+ if (segments.some((s) => s === "." || s === ".."))
59
+ throw refuse(at, "has a `.` or `..` segment — a name stays inside the directory it is read in.");
60
+ return v;
61
+ }
62
+ function screenNames(v, at, seen) {
63
+ if (!Array.isArray(v))
64
+ throw refuse(at, `must be an array of names (got ${describeRejectedValue(v)}).`);
65
+ if (v.length === 0)
66
+ throw refuse(at, "is empty — omit it instead.");
67
+ if (v.length > NESTED_MEMORY_MAX_NAMES)
68
+ throw refuse(at, `has ${v.length} names, over ${NESTED_MEMORY_MAX_NAMES}.`);
69
+ return Array.from(v).map((x, i) => {
70
+ const name = screenName(x, `${at}[${i}]`);
71
+ const fold = name.normalize("NFC").toLowerCase();
72
+ const twin = seen.get(fold);
73
+ if (twin !== undefined)
74
+ throw refuse(`${at}[${i}]`, twin === name ? `repeats ${JSON.stringify(name)}.` : `${JSON.stringify(name)} names the same file as ${JSON.stringify(twin)} on a case-insensitive filesystem.`);
75
+ seen.set(fold, name);
76
+ return name;
77
+ });
78
+ }
79
+ export function instructionFamilyOf(spec) {
80
+ return spec !== null && typeof spec === "object" ? spec.instructionFamily : undefined;
81
+ }
82
+ export function screenNestedMemory(spec, projectMemory) {
83
+ const v = instructionFamilyOf(spec);
84
+ if (v === undefined)
85
+ return undefined;
86
+ if (!isPlain(v))
87
+ throw refuse(FIELD, `must be an object (got ${describeRejectedValue(v)}).`);
88
+ onlyKeys(v, ["files", "rulesDir", "alternate", "includes", "hostRules"], FIELD);
89
+ const seen = new Map();
90
+ const files = v["files"] === undefined ? [] : screenNames(v["files"], `${FIELD}.files`, seen);
91
+ const rulesDir = v["rulesDir"] === undefined ? undefined : screenName(v["rulesDir"], `${FIELD}.rulesDir`);
92
+ let alternate;
93
+ if (v["alternate"] !== undefined) {
94
+ const a = v["alternate"];
95
+ const at = `${FIELD}.alternate`;
96
+ if (!isPlain(a))
97
+ throw refuse(at, `must be an object (got ${describeRejectedValue(a)}).`);
98
+ onlyKeys(a, ["files", "rulesDir", "when"], at);
99
+ const when = a["when"];
100
+ if (when !== "absent" && when !== "also")
101
+ throw refuse(`${at}.when`, `must be "absent" or "also" (got ${describeRejectedValue(when)}).`);
102
+ const altFiles = screenNames(a["files"], `${at}.files`, seen);
103
+ const altRules = a["rulesDir"] === undefined ? undefined : screenName(a["rulesDir"], `${at}.rulesDir`);
104
+ alternate = Object.freeze({ files: Object.freeze(altFiles), ...(altRules !== undefined ? { rulesDir: altRules } : {}), when });
105
+ }
106
+ const includes = v["includes"];
107
+ if (includes !== undefined && typeof includes !== "boolean")
108
+ throw refuse(`${FIELD}.includes`, `must be a boolean (got ${describeRejectedValue(includes)}).`);
109
+ const hostRules = v["hostRules"] === undefined ? [] : screenHostRules(v["hostRules"]);
110
+ if (files.length === 0 && rulesDir === undefined && alternate === undefined && hostRules.length === 0)
111
+ throw refuse(FIELD, "names nothing to load (no files, rulesDir, alternate or hostRules) — omit it instead.");
112
+ if (projectMemory === "disabled")
113
+ return undefined;
114
+ return Object.freeze({ files: Object.freeze(files), ...(rulesDir !== undefined ? { rulesDir } : {}), ...(alternate !== undefined ? { alternate } : {}), includes: includes === true, hostRules: Object.freeze(hostRules) });
115
+ }
116
+ function screenHostRules(v) {
117
+ const at = `${FIELD}.hostRules`;
118
+ if (!Array.isArray(v))
119
+ throw refuse(at, `must be an array (got ${describeRejectedValue(v)}).`);
120
+ if (v.length > NESTED_MEMORY_MAX_HOST_RULES)
121
+ throw refuse(at, `has ${v.length} rules, over ${NESTED_MEMORY_MAX_HOST_RULES}.`);
122
+ const names = new Set();
123
+ return Array.from(v).map((r, i) => {
124
+ const ra = `${at}[${i}]`;
125
+ if (!isPlain(r))
126
+ throw refuse(ra, `must be an object (got ${describeRejectedValue(r)}).`);
127
+ onlyKeys(r, ["level", "name", "paths", "text"], ra);
128
+ const level = r["level"];
129
+ if (level !== "user" && level !== "managed" && level !== "project")
130
+ throw refuse(`${ra}.level`, `must be "user", "managed" or "project" (got ${describeRejectedValue(level)}).`);
131
+ const name = r["name"];
132
+ if (typeof name !== "string" || name.length === 0 || name.length > NESTED_MEMORY_NAME_MAX || name.includes("\u0000"))
133
+ throw refuse(`${ra}.name`, `must be a non-empty string of at most ${NESTED_MEMORY_NAME_MAX} characters without NUL (got ${describeRejectedValue(name)}).`);
134
+ if (names.has(name))
135
+ throw refuse(`${ra}.name`, `repeats ${JSON.stringify(name)}.`);
136
+ names.add(name);
137
+ const paths = r["paths"];
138
+ if (!Array.isArray(paths) || paths.length === 0 || Array.from(paths).some((p) => typeof p !== "string" || p.length === 0))
139
+ throw refuse(`${ra}.paths`, `must be a non-empty array of globs (got ${describeRejectedValue(paths)}) — a rule with no paths belongs to the session's instructions.`);
140
+ const text = r["text"];
141
+ if (typeof text !== "string")
142
+ throw refuse(`${ra}.text`, `must be a string (got ${describeRejectedValue(text)}).`);
143
+ if (text.length > INSTRUCTION_FILE_MAX_BYTES)
144
+ throw refuse(`${ra}.text`, `is ${text.length} characters, over the ${INSTRUCTION_FILE_MAX_BYTES} an instruction file may be read at.`);
145
+ return Object.freeze({ level, name, paths: Object.freeze(Array.from(paths)), text });
146
+ });
147
+ }
148
+ export function instructionEchoOf(label, layer, withdrawn) {
149
+ return { source: layer === "root" ? "project_instructions" : "nested_memory", preview: steeringPreview(withdrawn ? `${label} (withdrawn: it no longer applies)` : label) };
150
+ }
151
+ export function instructionEchoTo(queue, ident, attach) {
152
+ return (label, layer, withdrawn) => {
153
+ queue.push({ type: "steering_injected", ...instructionEchoOf(label, layer, withdrawn), ...ident() });
154
+ attach.attachmentsInjected += 1;
155
+ };
156
+ }
157
+ export async function restateInstructionFiles(lane, seat, echo) {
158
+ let load;
159
+ try {
160
+ load = await lane.load({ echo });
161
+ }
162
+ catch (err) {
163
+ seat.report?.(asThrownError(err));
164
+ return;
165
+ }
166
+ if (load === undefined)
167
+ return;
168
+ for (const [i, f] of load.frames.entries()) {
169
+ try {
170
+ await appendAdmittedRow(seat.admitRows, seat.session, { role: "user", content: [...f.seed.content], timestamp: Date.now(), provenance: "engine-note", attachment: f.seed.attachment });
171
+ f.commit?.();
172
+ }
173
+ catch (err) {
174
+ load.release(load.frames.slice(i).map((x) => x.seed.attachment.ordinal));
175
+ seat.report?.(new Error(`instruction files could not be written to the transcript after the compaction (the next load owes them again): ${asThrownError(err).message}`));
176
+ return;
177
+ }
178
+ }
179
+ }
180
+ const layerOf = (level) => (level === "" ? "root" : "nested");
181
+ const itemId = (i) => `${i.kind}\u0000${i.path}`;
182
+ const HOST_RULE_KEY = "host-rule:";
183
+ export function createNestedMemoryLane(seat) {
184
+ const decl = seat.declaration;
185
+ const win = pathFamilyOf({ root: seat.root }) === "win";
186
+ const sep = win ? "\\" : "/";
187
+ const rootBase = seat.root.endsWith(sep) ? seat.root.slice(0, -1) : seat.root;
188
+ const abs = (rel) => (rel === "" ? rootBase : `${rootBase}${sep}${win ? rel.replaceAll("/", "\\") : rel}`);
189
+ const relOf = (key) => {
190
+ const r = relativeUnderRoot(key, seat.root);
191
+ return r === null ? undefined : win ? r.replaceAll("\\", "/") : r;
192
+ };
193
+ const levelsOf = (rel) => {
194
+ const segs = rel.split("/");
195
+ return segs.slice(0, -1).map((_, i) => segs.slice(0, i + 1).join("/"));
196
+ };
197
+ const queue = [];
198
+ const queued = new Set();
199
+ const inFlight = new Set();
200
+ const includesBy = new Map();
201
+ let hostRetry = false;
202
+ let seen;
203
+ let alternateOn = decl.alternate === undefined ? false : decl.alternate.when === "also" ? true : undefined;
204
+ const entryId = (e) => `${e.hash}\u0000${e.lastReadAt ?? ""}\u0000${e.witnesses?.join("\u0001") ?? ""}`;
205
+ const isAccess = (e) => e.seededFromContext !== true && !isInstructionLaneEntry(e);
206
+ const deliveredEntry = (key) => {
207
+ const e = seat.state.get(key);
208
+ return e !== undefined && isInstructionLaneEntry(e) ? e : undefined;
209
+ };
210
+ const withdrawing = new Set();
211
+ const activeNames = () => [...decl.files, ...(alternateOn === true ? decl.alternate.files : [])];
212
+ const activeRules = () => [decl.rulesDir, alternateOn === true ? decl.alternate?.rulesDir : undefined].filter((d) => d !== undefined);
213
+ const memberAt = (rel, level, names, rules) => {
214
+ const local = level === "" ? rel : rel.startsWith(`${level}/`) ? rel.slice(level.length + 1) : undefined;
215
+ if (local === undefined)
216
+ return undefined;
217
+ if (names.includes(local))
218
+ return "name";
219
+ return rules.some((d) => local.startsWith(`${d}/`) && local.endsWith(".md")) ? "rule" : undefined;
220
+ };
221
+ const declaredNames = [...decl.files, ...(decl.alternate?.files ?? [])];
222
+ const declaredRules = [decl.rulesDir, decl.alternate?.rulesDir].filter((d) => d !== undefined);
223
+ const isMember = (key, at) => {
224
+ const rel = relOf(key);
225
+ if (rel === undefined || rel === "")
226
+ return false;
227
+ return (at === "root" ? [""] : ["", ...levelsOf(rel)]).some((level) => memberAt(rel, level, declaredNames, declaredRules) !== undefined);
228
+ };
229
+ const enqueueLevel = (level) => {
230
+ const items = [];
231
+ const add = (i) => {
232
+ const id = itemId(i);
233
+ if (queued.has(id))
234
+ return;
235
+ queued.add(id);
236
+ items.push(i);
237
+ };
238
+ const join = (name) => abs(level === "" ? name : `${level}/${name}`);
239
+ const names = activeNames();
240
+ const rules = activeRules();
241
+ for (const name of names)
242
+ add({ kind: "file", level, path: join(name), rule: "none", depth: 0 });
243
+ for (const dir of rules)
244
+ add({ kind: "listing", level, path: join(dir) });
245
+ for (const [key, e] of seat.state) {
246
+ const rel = relOf(key);
247
+ const member = rel === undefined || rel === "" || !isInstructionLaneEntry(e) ? undefined : memberAt(rel, level, names, rules);
248
+ if (member !== undefined)
249
+ add({ kind: "file", level, path: key, rule: member === "name" ? "none" : "any", depth: 0 });
250
+ }
251
+ if (level === "")
252
+ queue.unshift(...items);
253
+ else
254
+ queue.push(...items);
255
+ };
256
+ const handBack = (rs) => {
257
+ for (const r of rs) {
258
+ inFlight.delete(r.key);
259
+ withdrawing.delete(r.key);
260
+ }
261
+ if (rs.some((r) => r.key.startsWith(HOST_RULE_KEY)))
262
+ hostRetry = true;
263
+ const back = rs.filter((r) => !r.key.startsWith(HOST_RULE_KEY)).map((r) => r.item).filter((i) => !queued.has(itemId(i)));
264
+ for (const i of back)
265
+ queued.add(itemId(i));
266
+ queue.unshift(...back);
267
+ };
268
+ let primed;
269
+ const collect = async (ask, echo) => {
270
+ const leg = seat.leg();
271
+ if (leg === undefined || seat.signal.aborted)
272
+ return [];
273
+ const accesses = new Set();
274
+ const current = new Map();
275
+ for (const [key, e] of seat.state) {
276
+ current.set(key, entryId(e));
277
+ const rel = relOf(key);
278
+ if (rel !== undefined && rel !== "" && isAccess(e))
279
+ accesses.add(rel);
280
+ }
281
+ const dirty = new Set([""]);
282
+ const touch = (rel) => {
283
+ for (const l of levelsOf(rel))
284
+ dirty.add(l);
285
+ };
286
+ for (const key of ask.triggers ?? []) {
287
+ const rel = relOf(key);
288
+ if (rel === undefined || rel === "")
289
+ continue;
290
+ accesses.add(rel);
291
+ touch(rel);
292
+ }
293
+ if (seen === undefined)
294
+ for (const rel of accesses)
295
+ touch(rel);
296
+ else {
297
+ for (const [key, id] of current) {
298
+ const rel = relOf(key);
299
+ if (rel !== undefined && rel !== "" && seen.get(key) !== id && isAccess(seat.state.get(key)))
300
+ touch(rel);
301
+ }
302
+ for (const key of seen.keys()) {
303
+ const rel = relOf(key);
304
+ if (rel !== undefined && rel !== "" && !current.has(key))
305
+ touch(rel);
306
+ }
307
+ }
308
+ seen = current;
309
+ const pending = new Set(ask.triggers ?? []);
310
+ const p = { count: 0 };
311
+ if (alternateOn === undefined) {
312
+ p.count += decl.files.length;
313
+ const atRoot = await Promise.all(decl.files.map((name) => seat.env.fileInfo(abs(name), seat.signal).catch(() => undefined)));
314
+ alternateOn = !atRoot.some((info) => info?.ok === true && info.value.kind !== "directory");
315
+ }
316
+ for (const level of [...dirty].sort((a, b) => a.split("/").length - b.split("/").length || (a < b ? -1 : a > b ? 1 : 0)))
317
+ if (level === "" || [...accesses].some((r) => r.startsWith(`${level}/`)))
318
+ enqueueLevel(level);
319
+ const model = leg.harness.getModel();
320
+ const cpt = model.charsPerToken ?? 4;
321
+ const cap = instructionFileCap(model.contextWindow, cpt);
322
+ const told = new Set(leg.announcedListingsRef.advisories ?? []);
323
+ const fresh = [];
324
+ const delegated = agentIdOf(leg.hookIdentity) !== undefined;
325
+ const once = (lane, path, why, say) => {
326
+ const d = announceDigest(lane, `${path}\n${why}`);
327
+ if (told.has(d))
328
+ return;
329
+ told.add(d);
330
+ fresh.push(d);
331
+ say();
332
+ };
333
+ const withheld = (path, reason) => once(INSTRUCTIONS_WITHHELD, path, reason, () => {
334
+ if (delegated)
335
+ return;
336
+ const where = relOf(path) !== undefined && isMember(path, "root") ? "the task root" : "a directory the model accessed";
337
+ deliverEngineNotice(seat.deps.onNotice, { code: INSTRUCTIONS_WITHHELD, message: `An instruction file of ${where} was not loaded: ${path} (${WITHHELD_TEXT[reason]}).`, detail: { path, reason, sessionId: leg.sessionId, runId: leg.runId } });
338
+ });
339
+ const unread = (path, why) => once("nested_memory_unread", path, why, () => {
340
+ try {
341
+ seat.deps.onError?.(new Error(`instruction file ${path} was not loaded: ${why}`), { phase: "degraded", sessionId: leg.sessionId, classification: "attachment-read" });
342
+ }
343
+ catch {
344
+ }
345
+ });
346
+ const reads = [];
347
+ const withdraw = (key, item) => {
348
+ if (inFlight.has(key))
349
+ return;
350
+ inFlight.add(key);
351
+ withdrawing.add(key);
352
+ const layer = layerOf(item.level);
353
+ reads.push({
354
+ key,
355
+ item,
356
+ read: {
357
+ supply: "path",
358
+ owner: "repository",
359
+ layer,
360
+ label: key,
361
+ text: "",
362
+ withdraws: true,
363
+ record: () => {
364
+ if (deliveredEntry(key) !== undefined)
365
+ seat.state.delete(key);
366
+ seen?.delete(key);
367
+ inFlight.delete(key);
368
+ withdrawing.delete(key);
369
+ echo.fn?.(key, layer, true);
370
+ },
371
+ },
372
+ });
373
+ };
374
+ const visited = new Set();
375
+ const deadlineAt = Date.now() + ORG_ADJUDICATION_TIMEOUT_MS;
376
+ const ruleApplies = (globs, level) => [...accesses].some((rel) => (level === "" || rel.startsWith(`${level}/`)) && ruleGlobsMatch(globs, level === "" ? rel : rel.slice(level.length + 1)));
377
+ const stats = new Map();
378
+ const statsAhead = (first) => {
379
+ if (first.kind !== "file" || stats.has(first.path))
380
+ return;
381
+ const room = Math.max(1, Math.min(NESTED_MEMORY_STAT_BATCH, NESTED_MEMORY_PROBES_PER_LOAD - p.count));
382
+ const batch = [first, ...queue.filter((i) => i.kind === "file" && !stats.has(i.path))].slice(0, room);
383
+ p.count += batch.length;
384
+ for (const i of batch)
385
+ stats.set(i.path, seat.env.fileInfo(i.path, seat.signal).catch((err) => ({ ok: false, error: { code: "io", message: thrownText(err) } })));
386
+ };
387
+ const probeFile = async (item) => {
388
+ const info = await stats.get(item.path);
389
+ if (!info.ok) {
390
+ if (info.error.code === "not_found" && deliveredEntry(item.path) !== undefined)
391
+ withdraw(item.path, item);
392
+ else if (!QUIET_ERRORS.has(info.error.code))
393
+ unread(item.path, info.error.message);
394
+ return [];
395
+ }
396
+ if (info.value.kind === "directory")
397
+ return [];
398
+ const target = await seat.reader.resolveTarget(item.path, { signal: seat.signal });
399
+ if (!target.ok) {
400
+ const card = target.refusal.details?.type;
401
+ if (card === "read_path_denied")
402
+ withheld(item.path, "rule_denied");
403
+ else if (card === "path_not_in_root")
404
+ withheld(item.path, "outside_roots");
405
+ return [];
406
+ }
407
+ const key = target.key;
408
+ if (visited.has(key) || inFlight.has(key))
409
+ return [];
410
+ const stat = info.value.kind === "symlink" ? await seat.env.fileInfo(key, seat.signal).catch(() => undefined) : info;
411
+ if (stat === undefined || !stat.ok)
412
+ return [];
413
+ const mtime = stat.value.mtimeMs;
414
+ const entry = seat.state.get(key);
415
+ if (entry !== undefined && entry.lastReadAt === mtime && (!decl.includes || includesBy.has(key))) {
416
+ visited.add(key);
417
+ return includesAt(includesBy.get(key) ?? [], item);
418
+ }
419
+ const face = seat.readFace();
420
+ if (face === undefined) {
421
+ withheld(item.path, "admission_unknown");
422
+ return [];
423
+ }
424
+ p.count++;
425
+ const held = await seat.reader.openBound(key, seat.signal).catch(() => undefined);
426
+ try {
427
+ const verdict = await seat.judge({ file_path: item.path, face }, NESTED_MEMORY_PROBE_FACE, { deadlineAt });
428
+ if (verdict.verdict !== "no_objection") {
429
+ withheld(item.path, verdict.verdict === "deny" ? "rule_denied" : verdict.verdict === "ask" ? "approval_required" : "admission_unknown");
430
+ return [];
431
+ }
432
+ if (verdict.judged !== undefined && verdict.judged !== key) {
433
+ withheld(item.path, "target_moved");
434
+ return [];
435
+ }
436
+ visited.add(key);
437
+ const t = await seat.reader.readText(key, { signal: seat.signal }, { judgedKey: key, capBytes: INSTRUCTION_FILE_MAX_BYTES, ...(held?.ok === true ? { bound: { key, object: held.value } } : {}) });
438
+ return admit(t, item, key, mtime, entry);
439
+ }
440
+ finally {
441
+ if (held?.ok === true)
442
+ await held.value.close().catch(() => undefined);
443
+ }
444
+ };
445
+ const admit = (t, item, key, mtime, entry) => {
446
+ if (t.kind !== "text") {
447
+ if (t.kind === "refused")
448
+ withheld(item.path, "rule_denied");
449
+ else if (t.kind === "moved")
450
+ withheld(item.path, "target_moved");
451
+ else if (t.kind !== "absent")
452
+ unread(item.path, t.kind === "not_text" ? "it is not text" : t.kind === "oversize" ? `it is over ${INSTRUCTION_FILE_MAX_BYTES} bytes` : "the environment could not read it");
453
+ return [];
454
+ }
455
+ const text = normalizeFileText(t.text);
456
+ const hash = sha256(text);
457
+ const shown = processInstructionText(text, decl.includes);
458
+ if (item.rule !== "none" && shown.globs !== undefined && !ruleApplies(shown.globs, item.level))
459
+ return [];
460
+ const targets = includeTargetsOf(shown.includes, key);
461
+ includesBy.set(key, targets);
462
+ const more = includesAt(targets, item);
463
+ if (pending.has(key))
464
+ return more;
465
+ if (entry !== undefined && entry.hash === hash)
466
+ return more;
467
+ if (shown.content.trim() === "") {
468
+ if (entry !== undefined && isInstructionLaneEntry(entry))
469
+ withdraw(key, item);
470
+ return more;
471
+ }
472
+ const cut = cutInstructionText(shown.content, cap, cpt);
473
+ const totalLines = countLines(text);
474
+ const whole = shown.content === text && cut.note === undefined;
475
+ const recorded = { hash, totalLines, truncated: !whole, ...(whole ? { view: { start: 1, end: totalLines } } : { isPartialView: true }) };
476
+ inFlight.add(key);
477
+ const layer = layerOf(item.level);
478
+ const read = {
479
+ supply: "path",
480
+ owner: "repository",
481
+ layer,
482
+ label: key,
483
+ text: cut.text,
484
+ ...(cut.note !== undefined ? { cut: cut.note } : {}),
485
+ observation: { key, entry: recorded, stampedAt: mtime },
486
+ record: (transmission) => {
487
+ const landed = { ...recorded, lastReadAt: mtime, witnesses: [transmission] };
488
+ seat.state.set(key, landed);
489
+ seen?.set(key, entryId(landed));
490
+ inFlight.delete(key);
491
+ echo.fn?.(key, layer, false);
492
+ },
493
+ };
494
+ reads.push({ read, item, key });
495
+ return more;
496
+ };
497
+ const includeTargetsOf = (paths, from) => {
498
+ const fromRel = relOf(from);
499
+ if (fromRel === undefined)
500
+ return [];
501
+ const base = fromRel.split("/").slice(0, -1);
502
+ return paths.flatMap((raw) => {
503
+ if (raw.startsWith("~/"))
504
+ return [];
505
+ const rel = raw.startsWith("/") ? relOf(raw) : resolveRel(base, raw);
506
+ return rel === undefined || rel === "" || !isTextIncludeTarget(rel) ? [] : [abs(rel)];
507
+ });
508
+ };
509
+ const includesAt = (targets, item) => item.depth + 1 < INSTRUCTION_INCLUDE_MAX_DEPTH ? targets.map((path) => ({ kind: "file", level: item.level, path, rule: "none", depth: item.depth + 1 })) : [];
510
+ const probeListing = async (item) => {
511
+ p.count++;
512
+ const listed = await seat.env.listDir(item.path, seat.signal).catch((err) => ({ ok: false, error: { code: "io", message: thrownText(err) } }));
513
+ if (!listed.ok) {
514
+ if (!QUIET_ERRORS.has(listed.error.code))
515
+ unread(item.path, listed.error.message);
516
+ return [];
517
+ }
518
+ const entries = [...listed.value].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
519
+ return [
520
+ ...entries.filter((e) => e.kind !== "directory" && e.name.endsWith(".md")).map((e) => ({ kind: "file", level: item.level, path: e.path, rule: "any", depth: 0 })),
521
+ ...entries.filter((e) => e.kind === "directory").map((e) => ({ kind: "listing", level: item.level, path: e.path })),
522
+ ];
523
+ };
524
+ const budget = NESTED_MEMORY_FRAME_BUDGET_FILES * cap;
525
+ let chars = 0;
526
+ while (queue.length > 0 && p.count < NESTED_MEMORY_PROBES_PER_LOAD && !seat.signal.aborted && chars <= budget) {
527
+ const item = queue.shift();
528
+ queued.delete(itemId(item));
529
+ statsAhead(item);
530
+ const before = reads.length;
531
+ let more;
532
+ try {
533
+ more = item.kind === "file" ? await probeFile(item) : await probeListing(item);
534
+ }
535
+ catch (err) {
536
+ unread(item.path, thrownText(err));
537
+ more = [];
538
+ }
539
+ for (const r of reads.slice(before))
540
+ chars += r.read.text.length;
541
+ const added = more.filter((i) => !queued.has(itemId(i)));
542
+ for (const i of added)
543
+ queued.add(itemId(i));
544
+ queue.unshift(...added);
545
+ }
546
+ if (decl.hostRules.length > 0 && (dirty.size > 0 || hostRetry)) {
547
+ hostRetry = false;
548
+ const matched = decl.hostRules.filter((r) => !inFlight.has(`${HOST_RULE_KEY}${r.name}`) && [...accesses].some((rel) => ruleGlobsMatch(r.paths, rel)));
549
+ const shownNow = matched.length > 0 ? lastHostRuleTexts(await leg.session.buildContext().then((c) => c.messages).catch(() => [])) : new Map();
550
+ for (const r of matched) {
551
+ const cut = cutInstructionText(r.text, cap, cpt);
552
+ if (cut.text.trim() === "" || shownNow.get(r.name) === cut.text)
553
+ continue;
554
+ const key = `${HOST_RULE_KEY}${r.name}`;
555
+ inFlight.add(key);
556
+ reads.push({ key, item: { kind: "file", level: "", path: key, rule: "none", depth: 0 }, read: { supply: "content_text", owner: r.level === "project" ? "repository" : "deployment", layer: "nested", label: r.name, text: cut.text, ...(cut.note !== undefined ? { cut: cut.note } : {}), record: () => (inFlight.delete(key), echo.fn?.(r.name, "nested", false)) } });
557
+ }
558
+ }
559
+ if (fresh.length > 0) {
560
+ leg.announcedListingsRef.advisories = withAnnounceDigests(leg.announcedListingsRef.advisories, fresh);
561
+ leg.frameReceipts.listingSnapshotOwed = true;
562
+ }
563
+ return reads;
564
+ };
565
+ const mint = (reads) => {
566
+ const leg = seat.leg();
567
+ if (reads.length === 0 || leg === undefined) {
568
+ handBack(reads);
569
+ return undefined;
570
+ }
571
+ const model = leg.harness.getModel();
572
+ const budget = NESTED_MEMORY_FRAME_BUDGET_FILES * instructionFileCap(model.contextWindow, model.charsPerToken ?? 4);
573
+ let minted = mintInstructionFrames(reads.map((r) => r.read), seat);
574
+ const sizeOf = (frames) => frames.reduce((n, f) => n + f.seed.content.reduce((m, b) => m + (b.type === "text" ? b.text.length : 0), 0), 0);
575
+ while (reads.length > 1 && sizeOf(minted.frames) > budget) {
576
+ handBack(reads.splice(-1));
577
+ minted = mintInstructionFrames(reads.map((r) => r.read), seat);
578
+ }
579
+ const taken = [...reads];
580
+ return {
581
+ inputId: minted.inputId,
582
+ frames: minted.frames,
583
+ chars: minted.frames.reduce((n, f) => n + f.seed.attachment.chars, 0),
584
+ release: (ordinals) => handBack(ordinals === undefined ? taken : taken.filter((_, i) => ordinals.includes(i + 1))),
585
+ };
586
+ };
587
+ return {
588
+ async prime() {
589
+ if (primed !== undefined)
590
+ return;
591
+ const echo = { fn: undefined };
592
+ primed = { reads: await collect({}, echo), echo };
593
+ },
594
+ async load(ask) {
595
+ const held = primed;
596
+ primed = undefined;
597
+ const reads = [];
598
+ if (held !== undefined) {
599
+ held.echo.fn = ask.echo;
600
+ const carried = new Set(ask.triggers ?? []);
601
+ for (const r of held.reads) {
602
+ if (carried.has(r.key) && r.read.withdraws !== true)
603
+ inFlight.delete(r.key);
604
+ else
605
+ reads.push(r);
606
+ }
607
+ }
608
+ try {
609
+ reads.push(...(await collect(ask, { fn: ask.echo })));
610
+ }
611
+ catch (err) {
612
+ handBack(reads);
613
+ throw err;
614
+ }
615
+ return mint(reads);
616
+ },
617
+ rootSelected() {
618
+ const keys = new Set();
619
+ for (const key of [...seat.state.keys(), ...inFlight])
620
+ if (!withdrawing.has(key) && isMember(key, "root"))
621
+ keys.add(key);
622
+ const rank = (rel) => {
623
+ const i = declaredNames.indexOf(rel);
624
+ return i < 0 ? declaredNames.length : i;
625
+ };
626
+ return [...keys].map((k) => relOf(k)).sort((a, b) => rank(a) - rank(b) || (a < b ? -1 : a > b ? 1 : 0));
627
+ },
628
+ isMember,
629
+ };
630
+ }
631
+ export async function primeInstructionLane(lane, manifest, report) {
632
+ try {
633
+ await lane.prime();
634
+ }
635
+ catch (err) {
636
+ report(asThrownError(err));
637
+ }
638
+ manifest.instructions = Object.freeze({ selected: Object.freeze(lane.rootSelected()) });
639
+ }
640
+ function resolveRel(base, raw) {
641
+ const out = [...base];
642
+ for (const seg of raw.split("/")) {
643
+ if (seg === "" || seg === ".")
644
+ continue;
645
+ if (seg === "..") {
646
+ if (out.length === 0)
647
+ return undefined;
648
+ out.pop();
649
+ }
650
+ else
651
+ out.push(seg);
652
+ }
653
+ return out.join("/");
654
+ }
655
+ function lastHostRuleTexts(messages) {
656
+ const out = new Map();
657
+ for (const m of messages) {
658
+ const a = userAttachmentOf(m);
659
+ if (a?.origin !== "nested_memory" || a.supply !== "content_text")
660
+ continue;
661
+ const blocks = m.content.slice(a.dataBlocks.start, a.dataBlocks.end);
662
+ out.set(a.label, blocks.map((b) => (b.type === "text" ? (b.text ?? "") : "")).join(""));
663
+ }
664
+ return out;
665
+ }
666
+ const QUIET_ERRORS = new Set(["not_found", "not_directory", "aborted"]);
667
+ const WITHHELD_TEXT = {
668
+ rule_denied: "a read rule refuses it",
669
+ outside_roots: "it resolves outside the directories the run may read",
670
+ approval_required: "reading it needs an approval nobody was asked for",
671
+ admission_unknown: "the engine could not confirm it may be read",
672
+ target_moved: "it changed while it was being checked",
673
+ };