@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
@@ -0,0 +1,240 @@
1
+ import { strict as assert } from "node:assert";
2
+ import { TASK_LIST_ROW_MALFORMED_CODE, createTaskListTools, } from "../../tools/task-list.js";
3
+ import { beginContract } from "./contract-harness.js";
4
+ import { thrownText } from "../thrown-value.js";
5
+ const row = (id, over = {}) => ({
6
+ id,
7
+ subject: `subject-${id}`,
8
+ description: `description-${id}`,
9
+ status: "pending",
10
+ blocks: [],
11
+ blockedBy: [],
12
+ ...over,
13
+ });
14
+ const ids = (entries) => entries.map((e) => e.id);
15
+ const forged = (value) => JSON.parse(JSON.stringify(value));
16
+ function items(entries) {
17
+ const out = [];
18
+ for (const e of entries) {
19
+ if ("rowVerdict" in e)
20
+ assert.fail(`task #${e.id} was listed as unreadable though the case wrote it readable`);
21
+ out.push(e);
22
+ }
23
+ return out;
24
+ }
25
+ const codeOf = (e) => (typeof e === "object" && e !== null ? Reflect.get(e, "code") : undefined);
26
+ function textOf(r) {
27
+ if (typeof r === "string")
28
+ return r;
29
+ return typeof r.content === "string" ? r.content : r.content.map((c) => ("text" in c ? c.text : "")).join("");
30
+ }
31
+ function tool(tools, name) {
32
+ const t = tools.find((x) => x.name === name);
33
+ assert.ok(t !== undefined, `the task-list tools carry ${name}`);
34
+ return t;
35
+ }
36
+ const call = async (t, args) => textOf(await t.execute(args, { toolCallId: "contract" }));
37
+ export async function taskListStoreContract(hooks, runAssertion) {
38
+ if (hooks.plantRow === undefined && (hooks.unplantable === undefined || hooks.unplantable.trim() === "")) {
39
+ throw new TypeError("taskListStoreContract: pass plantRow, or declare unplantable with the reason this backend keeps no bytes a foreign writer could damage");
40
+ }
41
+ const { run, settle } = beginContract(runAssertion);
42
+ const mk = hooks.make;
43
+ run("CRUD round trip: allocateId → set → get reads every member back; list holds it; delete, then the read is absent and a second delete is false", async () => {
44
+ const s = mk();
45
+ const id = String(await s.allocateId());
46
+ const item = row(id, { activeForm: "doing it", owner: "alice", metadata: { k: { deep: [1, 2] } } });
47
+ await s.set(id, item);
48
+ assert.deepEqual(await s.get(id), item);
49
+ assert.deepEqual(ids(await s.list()), [id]);
50
+ assert.equal(await s.delete(id), true);
51
+ assert.equal(await s.get(id), undefined);
52
+ assert.deepEqual(await s.list(), []);
53
+ assert.equal(await s.delete(id), false, "a repeated delete is false, not a throw");
54
+ });
55
+ run("detached copies both ways: mutating the object handed to set, or a copy read back, never reaches the store", async () => {
56
+ const s = mk();
57
+ const id = String(await s.allocateId());
58
+ const input = row(id, { metadata: { nested: { n: 1 } } });
59
+ await s.set(id, input);
60
+ input.subject = "MUTATED-VIA-INPUT";
61
+ input.blocks.push("999");
62
+ const nested = input.metadata?.nested;
63
+ if (typeof nested === "object" && nested !== null)
64
+ Reflect.set(nested, "n", 2);
65
+ assert.equal((await s.get(id)).subject, `subject-${id}`);
66
+ assert.deepEqual((await s.get(id)).blocks, []);
67
+ assert.deepEqual((await s.get(id)).metadata, { nested: { n: 1 } });
68
+ const copy = (await s.get(id));
69
+ copy.subject = "MUTATED-VIA-GET";
70
+ copy.blocks.push("888");
71
+ const listed = items(await s.list())[0];
72
+ listed.description = "MUTATED-VIA-LIST";
73
+ assert.equal((await s.get(id)).subject, `subject-${id}`);
74
+ assert.deepEqual((await s.get(id)).blocks, []);
75
+ assert.equal((await s.get(id)).description, `description-${id}`);
76
+ });
77
+ run("the entry table's write gate: absent dependency lists are stored as []; a present one that is no list of ids is refused and nothing is written", async () => {
78
+ const s = mk();
79
+ const id = String(await s.allocateId());
80
+ const { blocks: _b, blockedBy: _bb, ...partial } = row(id);
81
+ void _b;
82
+ void _bb;
83
+ await s.set(id, forged(partial));
84
+ const got = (await s.get(id));
85
+ assert.deepEqual([got.blocks, got.blockedBy], [[], []], "absence = no dependencies, stored as []");
86
+ assert.deepEqual(items(await s.list()).map((t) => [t.blocks, t.blockedBy]), [[[], []]]);
87
+ const other = String(await s.allocateId());
88
+ for (const bad of [42, "1", [1], { 0: "1" }]) {
89
+ await assert.rejects((async () => s.set(other, forged({ ...row(other), blocks: bad })))(), (e) => codeOf(e) === TASK_LIST_ROW_MALFORMED_CODE, `blocks ${JSON.stringify(bad)} is refused in ${TASK_LIST_ROW_MALFORMED_CODE}`);
90
+ assert.equal(await s.get(other), undefined, "a refused write leaves nothing behind");
91
+ }
92
+ });
93
+ run("metadata guard: a value that is not JSON-shaped is refused before it is written", async () => {
94
+ const s = mk();
95
+ const id = String(await s.allocateId());
96
+ await assert.rejects((async () => s.set(id, row(id, { metadata: { fn: () => 1 } })))(), /JSON-serializable/);
97
+ assert.equal(await s.get(id), undefined, "a refused write leaves no half entry");
98
+ });
99
+ run("allocateId: concurrent allocations are distinct, and deleting the highest id never lets it be handed out again", async () => {
100
+ const s = mk();
101
+ const minted = (await Promise.all(Array.from({ length: 8 }, () => s.allocateId()))).map(String);
102
+ assert.equal(new Set(minted).size, 8);
103
+ const highest = minted.reduce((a, b) => (Number(a) > Number(b) ? a : b));
104
+ await s.set(highest, row(highest));
105
+ assert.equal(await s.delete(highest), true);
106
+ const after = (await Promise.all([s.allocateId(), s.allocateId()])).map(String);
107
+ assert.deepEqual(after.filter((x) => minted.includes(x)), [], "the high-water mark never regresses");
108
+ assert.equal(new Set(after).size, 2);
109
+ });
110
+ run("list order: id ascending (numeric), stable across calls, whatever order the ids were written in", async () => {
111
+ const s = mk();
112
+ const minted = [];
113
+ for (let i = 0; i < 5; i++) {
114
+ const id = String(await s.allocateId());
115
+ minted.push(id);
116
+ await s.set(id, row(id));
117
+ }
118
+ assert.deepEqual(ids(await s.list()), minted);
119
+ assert.deepEqual(ids(await s.list()), minted, "a repeated call keeps the order");
120
+ await s.delete(minted[2]);
121
+ assert.deepEqual(ids(await s.list()), minted.filter((x) => x !== minted[2]));
122
+ const t = mk();
123
+ for (const id of ["30", "4", "12", "7"])
124
+ await t.set(id, row(id));
125
+ assert.deepEqual(ids(await t.list()), ["4", "7", "12", "30"]);
126
+ await t.set("2", row("2"));
127
+ assert.deepEqual(ids(await t.list()), ["2", "4", "7", "12", "30"]);
128
+ });
129
+ run("an unknown id: get answers undefined and delete answers false, neither throws", async () => {
130
+ const s = mk();
131
+ assert.equal(await s.get("nosuchid"), undefined);
132
+ assert.equal(await s.delete("nosuchid"), false);
133
+ assert.deepEqual(await s.list(), []);
134
+ });
135
+ run("single-call atomicity: concurrent writes of different ids all land; concurrent writes of one id converge on one whole write", async () => {
136
+ const s = mk();
137
+ const minted = (await Promise.all(Array.from({ length: 6 }, () => s.allocateId()))).map(String);
138
+ await Promise.all(minted.map((id) => s.set(id, row(id))));
139
+ assert.deepEqual(ids(await s.list()).sort(), [...minted].sort());
140
+ const target = minted[0];
141
+ await Promise.all(["w1", "w2", "w3"].map((w) => s.set(target, row(target, { subject: `S-${w}`, description: `D-${w}`, owner: w }))));
142
+ const got = (await s.get(target));
143
+ const winner = got.owner;
144
+ assert.ok(["w1", "w2", "w3"].includes(winner));
145
+ assert.deepEqual({ subject: got.subject, description: got.description }, { subject: `S-${winner}`, description: `D-${winner}` });
146
+ });
147
+ const reopen = hooks.reopen;
148
+ if (reopen !== undefined) {
149
+ run("durable: another instance over the same backend reads the entries, and a restart never re-mints an id", async () => {
150
+ const a = mk();
151
+ const id = String(await a.allocateId());
152
+ await a.set(id, row(id, { subject: "survives" }));
153
+ const b = reopen(a);
154
+ assert.deepEqual(ids(await b.list()), [id]);
155
+ assert.equal((await b.get(id)).subject, "survives");
156
+ await b.delete(id);
157
+ assert.notEqual(String(await reopen(a).allocateId()), id);
158
+ });
159
+ run("durable: mutate is the transaction boundary — a sequence reads its own writes, and they are visible after", async () => {
160
+ const s = mk();
161
+ assert.equal(typeof s.mutate, "function", "a backend shared wider than the object implements mutate");
162
+ const id = String(await s.allocateId());
163
+ await s.set(id, row(id));
164
+ const seen = await s.mutate(async (tx) => {
165
+ const cur = (await tx.get(id));
166
+ await tx.set(id, { ...cur, subject: "in-txn" });
167
+ return (await tx.get(id)).subject;
168
+ });
169
+ assert.equal(seen, "in-txn");
170
+ assert.equal((await s.get(id)).subject, "in-txn");
171
+ });
172
+ run("durable: read-modify-write sequences across two instances through mutate lose no update", async () => {
173
+ const a = mk();
174
+ const b = reopen(a);
175
+ const id = String(await a.allocateId());
176
+ await a.set(id, row(id, { subject: "seed", description: "seed" }));
177
+ const rmw = async (s, patch) => {
178
+ await s.mutate(async (tx) => {
179
+ const cur = { ...(await tx.get(id)) };
180
+ for (let i = 0; i < 5; i++)
181
+ await Promise.resolve();
182
+ patch(cur);
183
+ await tx.set(id, cur);
184
+ });
185
+ };
186
+ await Promise.all([rmw(a, (t) => void (t.subject = "changed-by-A")), rmw(b, (t) => void (t.description = "changed-by-B"))]);
187
+ const got = (await reopen(a).get(id));
188
+ assert.deepEqual({ subject: got.subject, description: got.description }, { subject: "changed-by-A", description: "changed-by-B" });
189
+ });
190
+ }
191
+ const plantRow = hooks.plantRow;
192
+ if (plantRow !== undefined) {
193
+ const SENTINEL = "planted-marker-1023";
194
+ const damaged = [
195
+ ["subject retyped", { id: "9", subject: 42, description: SENTINEL, status: "pending", blocks: [], blockedBy: [] }],
196
+ ["blocks a number", { id: "9", subject: SENTINEL, description: "d", status: "pending", blocks: 42, blockedBy: [] }],
197
+ ["status outside the set", { id: "9", subject: SENTINEL, description: "d", status: "done", blocks: [], blockedBy: [] }],
198
+ ["not an object", SENTINEL],
199
+ ["id contradicting its key", { id: "8", subject: SENTINEL, description: "d", status: "pending", blocks: [], blockedBy: [] }],
200
+ ];
201
+ for (const [what, raw] of damaged) {
202
+ run(`damaged entry (${what}): listed as its id and verdict, the other entries intact; get refuses in the family code and hands back nothing planted; delete by id removes it`, async () => {
203
+ const s = mk();
204
+ await s.set("1", row("1"));
205
+ await plantRow(s, "9", raw);
206
+ const listed = await s.list();
207
+ assert.deepEqual(ids(listed), ["1", "9"]);
208
+ const bad = listed.find((e) => e.id === "9");
209
+ assert.ok("rowVerdict" in bad, "the planted entry is listed as damaged");
210
+ assert.equal(bad.rowVerdict.code, TASK_LIST_ROW_MALFORMED_CODE);
211
+ assert.ok(!JSON.stringify(listed).includes(SENTINEL), "the listing carries no planted value");
212
+ assert.deepEqual(items(listed.filter((e) => e.id === "1")), [row("1")]);
213
+ await assert.rejects((async () => s.get("9"))(), (e) => codeOf(e) === TASK_LIST_ROW_MALFORMED_CODE && !thrownText(e).includes(SENTINEL), "get of an entry that does not read refuses in the family code, quoting nothing planted");
214
+ assert.equal(await s.delete("9"), true, "deletion by id goes on");
215
+ assert.deepEqual(ids(await s.list()), ["1"]);
216
+ });
217
+ }
218
+ run("damaged entry through the tools: it counts as open and keeps blocking its dependent; an edge to it is refused; TaskGet refuses; deleting it by id works", async () => {
219
+ const s = mk();
220
+ const tools = createTaskListTools(s);
221
+ const [create, get, update, list] = [tool(tools, "TaskCreate"), tool(tools, "TaskGet"), tool(tools, "TaskUpdate"), tool(tools, "TaskList")];
222
+ await call(create, { subject: "blocker", description: "d" });
223
+ await call(create, { subject: "dependent", description: "d" });
224
+ await call(update, { taskId: "2", addBlockedBy: ["1"] });
225
+ const blocker = (await s.get("1"));
226
+ await plantRow(s, "1", { ...blocker, status: 7 });
227
+ const shown = await call(list, {});
228
+ assert.match(shown, /^#1 \[unreadable\]$/m, "the damaged entry is shown as unreadable");
229
+ assert.match(shown, /^#2 \[pending\] dependent \(blocked by: 1\)$/m, "and it still blocks its dependent");
230
+ assert.match(shown, /\(2 total, 2 open\)/, "it counts as open");
231
+ await assert.rejects(call(get, { taskId: "1" }), (e) => codeOf(e) === TASK_LIST_ROW_MALFORMED_CODE);
232
+ await call(create, { subject: "third", description: "d" });
233
+ await assert.rejects(call(update, { taskId: "3", addBlocks: ["1"] }), (e) => codeOf(e) === TASK_LIST_ROW_MALFORMED_CODE, "an edge to an entry that does not read is refused");
234
+ assert.deepEqual((await s.get("3")).blocks, [], "and nothing of it was written");
235
+ assert.match(await call(update, { taskId: "1", status: "deleted" }), /Task #1 deleted\./);
236
+ assert.deepEqual(ids(await s.list()), ["2", "3"]);
237
+ });
238
+ }
239
+ await settle();
240
+ }
@@ -20,6 +20,6 @@ import { type ContractAssertionRunner } from "./contract-harness.js";
20
20
  * exactly the divergence the two legs above exist to prevent.
21
21
  */
22
22
  export declare function toolResultStoreContract(make: () => ToolResultStore, runAssertion?: ContractAssertionRunner, onOptionalMember?: (report: {
23
- member: "deleteBySession" | "listBySession" | "reap";
23
+ member: "deleteBySession" | "listBySession" | "reap" | "putBytes";
24
24
  status: "verified" | "absent";
25
25
  }) => void): Promise<void>;
@@ -147,5 +147,46 @@ export async function toolResultStoreContract(make, runAssertion, onOptionalMemb
147
147
  assert.deepEqual(await store.ownerOf("tr_age~owned"), { sessionId: "sess-B" }, "a reaped ref is free for a new owner");
148
148
  onOptionalMember?.({ member: "reap", status: "verified" });
149
149
  });
150
+ run("putBytes / bytesOf (optional): one election across kinds, one face per ref, and the session sweep required; absence is REPORTED", async () => {
151
+ const probe = make();
152
+ if (probe.putBytes === undefined && probe.bytesOf === undefined) {
153
+ onOptionalMember?.({ member: "putBytes", status: "absent" });
154
+ return;
155
+ }
156
+ assert.equal(typeof probe.putBytes, "function", `putBytes is ${typeof probe.putBytes} beside a bytesOf — the byte arm is a pair`);
157
+ assert.equal(typeof probe.bytesOf, "function", `bytesOf is ${typeof probe.bytesOf} beside a putBytes — the byte arm is a pair`);
158
+ assert.equal(typeof probe.deleteBySession, "function", "a store with a byte arm must implement deleteBySession — bytes a session produced leave with the session");
159
+ const store = make();
160
+ const bytesOf = async (ref) => Promise.resolve(store.bytesOf(ref));
161
+ const PNG = Uint8Array.from([0x89, 0x50, 0x4e, 0x47, 0, 1, 2, 3, 255]);
162
+ const ref = "tr_bytes~c1~b0";
163
+ await store.putBytes(ref, PNG, { sessionId: "sess-A" }, "image/png");
164
+ const kept = await bytesOf(ref);
165
+ assert.equal(kept?.byteLength, PNG.byteLength, "the entry's length is the bytes' length");
166
+ assert.equal(kept?.mediaType, "image/png", "the stated media type is stored with the entry");
167
+ assert.deepEqual([...(await Promise.resolve(kept.bytes()))], [...PNG], "the bytes read back exactly");
168
+ assert.equal(await store.get(ref), undefined, "the text face does not answer a byte entry (one face per ref)");
169
+ assert.equal(await bytesOf("tr_bytes~never"), undefined, "an unknown ref holds no bytes");
170
+ assert.deepEqual(await store.ownerOf(ref), { sessionId: "sess-A" }, "the byte entry's owner is recorded by the same election");
171
+ await store.putBytes(ref, Uint8Array.from([9]), { sessionId: "sess-A" }, "image/png");
172
+ assert.equal((await bytesOf(ref))?.byteLength, PNG.byteLength, "a repeat write keeps what is stored");
173
+ await assert.rejects((async () => store.putBytes(ref, PNG, { sessionId: "sess-B" }))(), (e) => e.code === "tool_result.ref_conflict", "a different owner is refused, coded");
174
+ await assert.rejects((async () => store.put(ref, "text over bytes", { sessionId: "sess-A" }))(), (e) => e.code === "tool_result.ref_conflict", "text on a ref holding bytes is refused, coded");
175
+ await store.put("tr_bytes~c2", "text first", { sessionId: "sess-A" });
176
+ await assert.rejects((async () => store.putBytes("tr_bytes~c2", PNG, { sessionId: "sess-A" }))(), (e) => e.code === "tool_result.ref_conflict", "bytes on a ref holding text are refused, coded");
177
+ assert.equal(await bytesOf("tr_bytes~c2"), undefined, "the refused write left no bytes");
178
+ assert.equal((await store.get("tr_bytes~c2"))?.content, "text first", "the refused write left the text as it was");
179
+ assert.deepEqual([...(await Promise.resolve((await bytesOf(ref)).bytes()))], [...PNG], "the refused write left the bytes as they were");
180
+ await store.putBytes("tr_bytes~other", PNG, { sessionId: "sess-B" });
181
+ if (store.listBySession !== undefined) {
182
+ const listed = (await Promise.resolve(store.listBySession("sess-A"))).entries.map((e) => e.ref).sort();
183
+ assert.deepEqual(listed, [ref, "tr_bytes~c2"].sort(), "a session's byte entries are listed with its text entries");
184
+ }
185
+ const swept = await Promise.resolve(store.deleteBySession("sess-A"));
186
+ assert.equal(swept.deleted, 2, "the session sweep removes its byte entry with its text entry");
187
+ assert.equal(await bytesOf(ref), undefined, "a swept byte entry is gone");
188
+ assert.equal((await bytesOf("tr_bytes~other"))?.byteLength, PNG.byteLength, "another session's byte entry survives the sweep");
189
+ onOptionalMember?.({ member: "putBytes", status: "verified" });
190
+ });
150
191
  await settle();
151
192
  }
@@ -9,8 +9,8 @@ import { type ExecResult, type ExecutionEnv, type ExecutionEnvCapabilities, Exec
9
9
  export declare class StubExecutionEnv implements ExecutionEnv {
10
10
  cwd: string;
11
11
  /** `ExecutionEnv.capabilities`: no target at all (`io: false`) — every operation refuses, so it produces no outside
12
- * content, names no path that is not the engine host's, and keeps the byte floor by refusing every start
13
- * (`keepsReadFloor: true`). A subclass that overrides operations with real I/O states its own block. */
12
+ * content, names no path that is not the engine host's, and keeps the byte floor and any command sandbox by refusing
13
+ * every start (`keepsReadFloor: true`, `commandSandbox: true`). A subclass that overrides operations with real I/O states its own block. */
14
14
  readonly capabilities: ExecutionEnvCapabilities;
15
15
  /** `ExecutionEnv.cdPath`: the stub runs no shell, so no shell receives a `CDPATH`. */
16
16
  readonly cdPath: readonly string[];
@@ -8,6 +8,7 @@ const STUB_ENV_CAPABILITIES = Object.freeze({
8
8
  externalContentTarget: false,
9
9
  io: false,
10
10
  keepsReadFloor: true,
11
+ commandSandbox: true,
11
12
  });
12
13
  export class StubExecutionEnv {
13
14
  cwd;
@@ -1,12 +1,16 @@
1
1
  /**
2
2
  * The synthetic-call judge — "would this call be refused outright?", asked without a model call, without an
3
3
  * approver and without a hook. One judge, one set of layers, for every consumer that needs the answer for a file the
4
- * model did not itself ask to touch. It has TWO FACES over one body (the layer walk below is written once):
4
+ * model did not itself ask to touch. The layer walk below is written once; two independent choices make a face — the probed
5
+ * tool (`Read` / `Write`) and which asks the walk holds as an objection (only mandated ones / every one):
5
6
  *
6
- * READ — a `Read` of a file the model did not ask for (the changed-file notice; a user's attachment). An ordinary
7
- * `ask` — a person's own ask rule — is not a refusal: the person who would answer it is the one asking.
8
- * WRITE — a `Write` of a path the engine itself writes in the background (the memory consolidation run). Every `ask`
9
- * is an objection here: nobody is present to answer it, so a layer that would ask a person refuses the write.
7
+ * READ — a `Read` of a file the model did not ask for (the changed-file notice; a user's attachment). An ordinary
8
+ * `ask` — a person's own ask rule — is not a refusal: the person who would answer it is the one asking.
9
+ * SERVED READ — a `Read`, every `ask` held: would the model's own `Read` of this path be served without anyone being asked?
10
+ * (a write tool's approval card showing the target's current contents: nobody asked for that read, so a
11
+ * person's own ask on it is an objection like any other).
12
+ * WRITE — a `Write` of a path the engine itself writes in the background (the memory consolidation run). Every `ask`
13
+ * is an objection here: nobody is present to answer it, so a layer that would ask a person refuses the write.
10
14
  *
11
15
  * It never picks a direction. The read face answers in FOUR states:
12
16
  *
@@ -18,10 +22,10 @@
18
22
  * no_objection — every layer it consulted answered and none objected;
19
23
  * unanswerable — no layer objected, and at least one could not answer (see the table below).
20
24
  *
21
- * The write face answers the same four, with `ask` in place of `mandated_ask`: any layer's ask, mandated or not.
25
+ * The served-read and write faces answer the same four, with `ask` in place of `mandated_ask`: any layer's ask, mandated or not.
22
26
  *
23
- * ONE PRECEDENCE on both faces: a deny anywhere wins over a held ask, and a held ask over an unanswerable layer; the walk
24
- * goes on past an ask (a later layer's deny is the stronger answer). The faces differ only in which asks are held. The
27
+ * ONE PRECEDENCE on every face: a deny anywhere wins over a held ask, and a held ask over an unanswerable layer; the walk
28
+ * goes on past an ask (a later layer's deny is the stronger answer). The faces differ only in the probed tool and which asks are held. The
25
29
  * CONSUMER decides where `mandated_ask` and `unanswerable` go: a notice that merely tells the model a file changed reads
26
30
  * both as no objection (the worst case is a notice about a file it then cannot re-read); a face that would put a file's
27
31
  * contents in front of the model reads both as a refusal; a background write reads everything but `no_objection` as a
@@ -71,7 +75,7 @@
71
75
  * facts the live gate stamps on a write (the roster's `Write` face, the tracked cwd and root, the advertised writable
72
76
  * directories, the data root's exemption): a containment fence and a data-root exemption judge the probe as they judge the call.
73
77
  */
74
- import type { ToolCallRequest, ToolCallFace, ToolPolicy } from "./tool-policy.js";
78
+ import type { CallFacts, ToolCallRequest, ToolCallFace, ToolPolicy } from "./tool-policy.js";
75
79
  import { type CallTargetStamp } from "./effective-path-target.js";
76
80
  import { type SkillGrantLane } from "./skill-grant.js";
77
81
  import type { OrgGateVerdict, PersistedRuleAnswer } from "./hooks.js";
@@ -125,32 +129,24 @@ export interface SyntheticReadLayers {
125
129
  /** The run's signal: its end ends the judgment's every wait (each policy layer's own signal ends with it). */
126
130
  signal?: AbortSignal;
127
131
  }
128
- /** The arguments a synthetic `Read` carries, and the facts a request stamps. */
132
+ /** The arguments a synthetic `Read` carries. The request's other facts (the tracked cwd a relative path resolves against, the root, the
133
+ * roster's `Read` face, the budget snapshot, the advertised and exempt roots) come from the judge's {@link SyntheticCallFacts}. */
129
134
  export interface SyntheticReadCall {
130
135
  file_path: string;
131
136
  offset?: number;
132
137
  limit?: number;
133
- /** The tracked working directory a relative `file_path` resolves against. */
134
- cwd?: string;
135
- /** The live roster's face for `Read`, when the consumer has one. */
136
- face?: ToolCallFace;
137
138
  }
138
139
  /** The path a synthetic `Write` probes. The request's other facts come from the judge's {@link SyntheticWriteFacts}. */
139
140
  export interface SyntheticWriteCall {
140
141
  file_path: string;
141
142
  }
142
- /** The facts the live gate stamps on a write, read at the moment of each judgment (the leg's cells move: the tracked cwd,
143
- * the advertised-directory ledger). Every member is optional — a leg without hands has no roster face, cwd or root. */
144
- export interface SyntheticWriteFacts {
145
- /** The live roster's face for `Write` (a containment fence admits a write only by the tool's own declared path target). */
146
- face?: ToolCallFace | undefined;
147
- cwd?: string | undefined;
148
- root?: string | undefined;
149
- advertisedWritableDirs?: {
150
- readonly roots: readonly string[];
151
- } | undefined;
152
- exemptRoots?: readonly string[] | undefined;
153
- }
143
+ /** The facts the live gate stamps on a write, read at the moment of each judgment ({@link CallFacts} less the budget: a background
144
+ * write runs once the run has ended, past every leg's budget snapshot). */
145
+ export type SyntheticWriteFacts = Omit<CallFacts, "budget">;
146
+ /** The facts the live gate stamps on any call it judges — a background write's ({@link SyntheticWriteFacts}) and the leg's budget
147
+ * snapshot (`ToolCallRequest.budget`). A probe carries them through {@link callFactsSeat}, the reader the live gate's own request
148
+ * goes through, so a layer judges it as it judges the probed tool's own call; `face` is the probed tool's roster face. */
149
+ export type SyntheticCallFacts = CallFacts;
154
150
  /** The stable synthetic call id a probe carries: `<face>-visibility-probe`, `face` a lowercase word
155
151
  * (letters and hyphens) naming the consumer. */
156
152
  export declare function syntheticReadProbeId(face: string): string;
@@ -164,9 +160,23 @@ export interface SyntheticReadBudget {
164
160
  deadlineAt?: number;
165
161
  }
166
162
  export type SyntheticReadJudge = (call: SyntheticReadCall, face: string, budget?: SyntheticReadBudget) => Promise<SyntheticReadVerdict>;
163
+ /** The path a served-read probe reads, and the face the run's roster gives `Read` (the face the model's own `Read` carries).
164
+ * The request's other facts come from the judge's {@link SyntheticCallFacts}. */
165
+ export interface SyntheticServedReadCall {
166
+ file_path: string;
167
+ face: ToolCallFace;
168
+ }
169
+ export type SyntheticServedReadJudge = (call: SyntheticServedReadCall, face: string, budget?: SyntheticReadBudget) => Promise<SyntheticWriteVerdict>;
167
170
  export type SyntheticWriteJudge = (call: SyntheticWriteCall, face: string, budget?: SyntheticReadBudget) => Promise<SyntheticWriteVerdict>;
168
- /** The READ face: only a mandated ask is held (a person's own ask is that person's question). */
169
- export declare function createSyntheticReadJudge(layers: SyntheticReadLayers): SyntheticReadJudge;
171
+ /** The READ face: only a mandated ask is held (a person's own ask is that person's question). The probe carries what the model's own
172
+ * `Read` carries — the leg's facts (`facts`, read at each judgment, the one reading the live gate's request goes through), so a
173
+ * layer judges the notice of a changed file, a person's attachment and a compaction's restore as it judges the model's own read of
174
+ * that file. A judge built without `facts` has no leg (a bare layer set): its probe carries none. */
175
+ export declare function createSyntheticReadJudge(layers: SyntheticReadLayers, facts?: () => SyntheticCallFacts): SyntheticReadJudge;
176
+ /** The SERVED-READ face: the `Read` probe with every ask held — `no_objection` only when the model's own `Read` of the path
177
+ * would be served without anyone being asked. The probe carries what the model's own `Read` carries: the roster's `Read`
178
+ * face (the call's) and the leg's facts the live gate stamps (`facts`, read at each judgment). */
179
+ export declare function createSyntheticServedReadJudge(layers: SyntheticReadLayers, facts: () => Omit<SyntheticCallFacts, "face">): SyntheticServedReadJudge;
170
180
  /** The WRITE face: every ask is held as an objection (no approver is present), and a persisted store that cannot be read is
171
181
  * unanswerable rather than silent. */
172
182
  export declare function createSyntheticWriteJudge(layers: SyntheticReadLayers, facts: () => SyntheticWriteFacts): SyntheticWriteJudge;
@@ -1,5 +1,5 @@
1
1
  import { callTargetReadingOf } from "./effective-path-target.js";
2
- import { advertisedWritableRootsSeat, attestationOf, describeThrown, exemptRootsSeat, refuseOutOfContractDecision } from "./tool-policy.js";
2
+ import { attestationOf, callFactsSeat, describeThrown, refuseOutOfContractDecision } from "./tool-policy.js";
3
3
  import { ownedClearanceFacts, ruleClearanceOf } from "./ask-origin.js";
4
4
  import { skillRowRefusal } from "./skill-grant.js";
5
5
  import { NOT_BINDABLE } from "./skill-grant-binding.js";
@@ -44,39 +44,30 @@ function layerWait(run) {
44
44
  },
45
45
  };
46
46
  }
47
- export function createSyntheticReadJudge(layers) {
48
- const judge = createProbeJudge(layers, "read");
47
+ function readProbeOf(call, face) {
48
+ return {
49
+ toolName: "Read",
50
+ args: { file_path: call.file_path, ...(call.offset !== undefined ? { offset: call.offset } : {}), ...(call.limit !== undefined ? { limit: call.limit } : {}) },
51
+ toolCallId: syntheticReadProbeId(face),
52
+ };
53
+ }
54
+ export function createSyntheticReadJudge(layers, facts = () => ({})) {
55
+ const judge = createProbeJudge(layers, "mandated");
49
56
  return async (call, face, budget) => {
50
- const probe = {
51
- toolName: "Read",
52
- args: { file_path: call.file_path, ...(call.offset !== undefined ? { offset: call.offset } : {}), ...(call.limit !== undefined ? { limit: call.limit } : {}) },
53
- toolCallId: syntheticReadProbeId(face),
54
- ...(call.cwd !== undefined ? { cwd: call.cwd } : {}),
55
- ...(call.face !== undefined ? { face: call.face } : {}),
56
- };
57
- const v = await judge(probe, budget);
57
+ const v = await judge({ ...readProbeOf(call, face), ...callFactsSeat(facts()) }, budget);
58
58
  return v.verdict === "ask" ? { ...v, verdict: "mandated_ask" } : v;
59
59
  };
60
60
  }
61
+ export function createSyntheticServedReadJudge(layers, facts) {
62
+ const judge = createProbeJudge(layers, "every");
63
+ return (call, face, budget) => judge({ ...readProbeOf({ file_path: call.file_path }, face), ...callFactsSeat({ ...facts(), face: call.face }) }, budget);
64
+ }
61
65
  export function createSyntheticWriteJudge(layers, facts) {
62
- const judge = createProbeJudge(layers, "write");
63
- return async (call, face, budget) => {
64
- const f = facts();
65
- const probe = {
66
- toolName: "Write",
67
- args: { file_path: call.file_path, content: "" },
68
- toolCallId: syntheticWriteProbeId(face),
69
- ...(f.cwd !== undefined ? { cwd: f.cwd } : {}),
70
- ...(f.root !== undefined ? { root: f.root } : {}),
71
- ...(f.face !== undefined ? { face: f.face } : {}),
72
- ...advertisedWritableRootsSeat(f.advertisedWritableDirs),
73
- ...(f.exemptRoots !== undefined ? exemptRootsSeat(f.exemptRoots) : {}),
74
- };
75
- return judge(probe, budget);
76
- };
66
+ const judge = createProbeJudge(layers, "every");
67
+ return async (call, face, budget) => judge({ toolName: "Write", args: { file_path: call.file_path, content: "" }, toolCallId: syntheticWriteProbeId(face), ...callFactsSeat(facts()) }, budget);
77
68
  }
78
- function createProbeJudge(layers, kind) {
79
- const everyAskHeld = kind === "write";
69
+ function createProbeJudge(layers, holds) {
70
+ const everyAskHeld = holds === "every";
80
71
  return async (unstated, budget) => {
81
72
  const deadlineAt = budget?.deadlineAt ?? Date.now() + ORG_ADJUDICATION_TIMEOUT_MS;
82
73
  const left = () => Math.max(0, Math.min(ORG_ADJUDICATION_TIMEOUT_MS, deadlineAt - Date.now()));