@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
@@ -27,11 +27,14 @@ export declare const AUTONOMOUS_LOOP_DYNAMIC_SENTINEL = "<<autonomous-loop-dynam
27
27
  /** Runner-held 上下文 + run-stop 出口,工具工厂闭包捕获(模型触不到)。 */
28
28
  export interface SchedulerToolContext {
29
29
  /**
30
- * **会话腿**的越界隔离键(Runner 填 sessionId ?? principal ?? taskId)。durable 腿不用这条链——它的键由
31
- * {@link durableScopeOf} 从 principal 独立铸(ruled 2026-08-03,见该函数注释)。
30
+ * **会话腿**的越界隔离键(Runner 填 sessionId ?? isolation scope ?? taskId)。durable 腿不用这条链——它的键由
31
+ * {@link durableScopeOf} 从 isolation scope 独立铸(ruled 2026-08-03,见该函数注释)。
32
32
  */
33
33
  scope: string;
34
+ /** 任务的人(`TaskSpec.principal`),原样交给宿主 capability;缺 `isolationScope` 时也是 durable 腿的键。 */
34
35
  principal?: string;
36
+ /** 任务的 isolation scope(`TaskSpec.isolationScope`):在场时 durable 腿按它铸键(同一人的另一 scope 看不见这条 job)。 */
37
+ isolationScope?: string;
35
38
  sessionId?: string;
36
39
  taskConfig?: unknown;
37
40
  /** `ctx.requestStopAfterTurn`(干净结束本 run 的 runner 原语出口)。design/136 §2.2:Sleep 撤除后本槽位
@@ -2,6 +2,8 @@ import { Type } from "typebox";
2
2
  import { defineTool, errorResult } from "../core/tools.js";
3
3
  import { hasScheduler, isValidCronExpr, } from "../core/scheduler.js";
4
4
  import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
5
+ import { isolationScopeOf } from "../core/isolation-scope.js";
6
+ import { envErrorDetail } from "./fs/env-error-detail.js";
5
7
  export const SCHEDULE_WAKEUP_TOOL_NAME = "ScheduleWakeup";
6
8
  export const AUTONOMOUS_LOOP_SENTINEL = "<<autonomous-loop>>";
7
9
  export const AUTONOMOUS_LOOP_DYNAMIC_SENTINEL = "<<autonomous-loop-dynamic>>";
@@ -31,7 +33,7 @@ The runtime clamps to [60, 3600], so you don't need to clamp yourself.
31
33
  One short sentence on what you chose and why. Goes to telemetry and is shown back to the user. "watching CI run" beats "waiting." The user reads this to understand what you're doing without having to predict your cadence in advance — make it specific.
32
34
  `;
33
35
  function durableScopeOf(c) {
34
- return c.principal ?? "default";
36
+ return isolationScopeOf(c) ?? "default";
35
37
  }
36
38
  function toSchedulerContext(c, scope) {
37
39
  return {
@@ -296,7 +298,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
296
298
  const knownIds = before.ok ? new Set(before.value.map((s) => s.id)) : undefined;
297
299
  const r = await sched.schedule(intent, opCtx);
298
300
  if (!r.ok)
299
- return errorResult(`Error (CronCreate): ${r.error.message}`);
301
+ return errorResult(`Error (CronCreate): ${envErrorDetail(r.error.message)}`);
300
302
  const replaced = knownIds?.has(r.value.id);
301
303
  const afterList = await withinReadBudget(() => sched.list(opCtx), signal);
302
304
  const nextFireAt = afterList?.ok === true ? nextFireAtOf(afterList.value.find((s) => s.id === r.value.id)) : undefined;
@@ -356,7 +358,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
356
358
  if (!r.ok) {
357
359
  if (r.error.code === "not_found")
358
360
  return `CronDelete: no scheduled task "${id}" (already gone or not yours).`;
359
- return errorResult(`Error (CronDelete): ${r.error.message}`);
361
+ return errorResult(`Error (CronDelete): ${envErrorDetail(r.error.message)}`);
360
362
  }
361
363
  return { content: `Cancelled scheduled task ${id}.`, details: { type: "cron-delete", id } };
362
364
  },
@@ -373,7 +375,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
373
375
  for (const lane of lanesDiffer ? [sessionCtx, durableCtx] : [sessionCtx]) {
374
376
  const listed = await sched.list(lane);
375
377
  if (!listed.ok)
376
- return errorResult(`Error (CronList): ${listed.error.message}`);
378
+ return errorResult(`Error (CronList): ${envErrorDetail(listed.error.message)}`);
377
379
  for (const s of listed.value) {
378
380
  if (seen.has(s.id))
379
381
  continue;
@@ -415,7 +417,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
415
417
  const listPendingWakeups = async () => {
416
418
  const r = await sched.list(sessionCtx);
417
419
  if (!r.ok)
418
- return { err: r.error.message };
420
+ return { err: envErrorDetail(r.error.message) };
419
421
  return {
420
422
  ids: r.value
421
423
  .filter((s) => s.mode === "session-wakeup" || (s.mode === undefined && s.label === WAKEUP_LABEL))
@@ -503,7 +505,7 @@ MOUNT NOTE: this host does not vouch for session-scoped scheduling, so a wakeup
503
505
  ...(sessionReapVouched ? { lifetime: "session" } : {}),
504
506
  }, sessionCtx);
505
507
  if (!r.ok)
506
- return errorResult(`Error (${SCHEDULE_WAKEUP_TOOL_NAME}): ${r.error.message}`);
508
+ return errorResult(`Error (${SCHEDULE_WAKEUP_TOOL_NAME}): ${envErrorDetail(r.error.message)}`);
507
509
  const scheduledFor = Date.now() + clampedDelaySeconds * 1000;
508
510
  const hhmmss = new Date(scheduledFor).toTimeString().slice(0, 8);
509
511
  const clampNote = wasClamped ? ` (clamped to ${clampedDelaySeconds}s from your requested value)` : "";
@@ -1,4 +1,5 @@
1
1
  import type { ToolSpec } from "../core/types.js";
2
+ import { type DamagedRowVerdict } from "../core/row-shape.js";
2
3
  /**
3
4
  * design/119 — the structured task-list tool family: `TaskCreate` / `TaskGet` /
4
5
  * `TaskUpdate` / `TaskList`. The upgrade path over TodoWrite: individual tasks with stable ids,
@@ -20,17 +21,54 @@ import type { ToolSpec } from "../core/types.js";
20
21
  * trust domain — the list is model scratch either way, sharing adds no egress). The `owner` field's
21
22
  * teammate-assignment semantics (trimmed in the 198 port) come back through this seam.
22
23
  */
24
+ /** A task's status words (closed; a stored entry's `status` is read against it). */
25
+ export declare const TASK_LIST_STATUSES: readonly ["pending", "in_progress", "completed"];
23
26
  export interface TaskListItem {
24
27
  id: string;
25
28
  subject: string;
26
29
  description: string;
27
30
  activeForm?: string;
28
31
  owner?: string;
29
- status: "pending" | "in_progress" | "completed";
32
+ status: (typeof TASK_LIST_STATUSES)[number];
30
33
  blocks: string[];
31
34
  blockedBy: string[];
32
35
  metadata?: Record<string, unknown>;
33
36
  }
37
+ /** An entry of a task list that does not read as {@link TASK_LIST_ITEM_ROW_SHAPE}: the id the list files it under and its verdict.
38
+ * {@link TaskListStore.list} answers it in place of the item; it counts as open (it still blocks what depends on it). */
39
+ export interface DamagedTaskListItem {
40
+ readonly id: string;
41
+ readonly rowVerdict: DamagedRowVerdict;
42
+ }
43
+ /** One entry of {@link TaskListStore.list}: an item, or a damaged entry (narrow with `"rowVerdict" in entry`). */
44
+ export type TaskListEntry = TaskListItem | DamagedTaskListItem;
45
+ /** The refusal code of a task entry that does not read (`get`, an update of it, an edge to it) or a write whose item does not. */
46
+ export declare const TASK_LIST_ROW_MALFORMED_CODE = "task_list.row_malformed";
47
+ /** Typed task-list store error so callers branch on `code`. */
48
+ export declare class TaskListStoreError extends Error {
49
+ readonly code: typeof TASK_LIST_ROW_MALFORMED_CODE;
50
+ constructor(code: typeof TASK_LIST_ROW_MALFORMED_CODE, message: string);
51
+ }
52
+ /**
53
+ * THE TASK ENTRY'S MEMBER-SHAPE TABLE (`rowShapeReader`, row-shape.ts). An entry has no row predicate of its own — it is filed under
54
+ * its id in the list (`tasks[id]`), and the list document's own shape is its store's container judgment. `members` is what the
55
+ * tools read: the id (equal to the key it is filed under), subject, description, status word, the optional active form and owner,
56
+ * the dependency lists — whose ABSENCE reads as no dependencies (`[]`, in a read and a write alike) and which, present, are lists of
57
+ * task ids — and the metadata ({@link jsonMetadataProblem}). Exit `list-damaged`: a listing answers such an entry by its id, it
58
+ * counts as open, `get` and every update of it refuse in {@link TASK_LIST_ROW_MALFORMED_CODE}, and deletion by its id goes on.
59
+ */
60
+ export declare const TASK_LIST_ITEM_ROW_SHAPE: import("../core/row-shape.js").RowShapeReader<TaskListItem>;
61
+ /**
62
+ * A stored entry as every reader reads it: the item (absent dependency lists read as `[]`), or the refusal
63
+ * ({@link TASK_LIST_ROW_MALFORMED_CODE}) of one that does not read, told to `disclose` first. A store's `get` goes through this.
64
+ */
65
+ export declare function readStoredTaskListItem(raw: unknown, id: string, disclose?: (sentence: string) => void): TaskListItem;
66
+ /** One stored entry as a listing answers it: the item, or — an entry that does not read — its id and verdict (told to `disclose`). */
67
+ export declare function listStoredTaskListEntry(raw: unknown, id: string, disclose?: (sentence: string) => void): TaskListEntry;
68
+ /** A write's item held to {@link TASK_LIST_ITEM_ROW_SHAPE} (its metadata refused first by {@link assertJsonMetadata}): the item to
69
+ * store — absent dependency lists stored as `[]` — or the refusal before anything is written. A dependency list that is present
70
+ * and not a list of ids is refused. */
71
+ export declare function admitTaskListItem(item: TaskListItem, id: string): TaskListItem;
34
72
  /**
35
73
  * design/147 §6 D2 — the task-list persistence seam (storage-tier abstraction, same family as
36
74
  * `RosterStore`/checkpoint store: core bundles a memory implementation; a deployment plugs pg/file
@@ -50,6 +88,11 @@ export interface TaskListItem {
50
88
  * rows survive makes every receipt lie and every subsequent update miss).
51
89
  * - Value semantics: `get`/`list` return detached copies; `set` stores a detached copy. Callers
52
90
  * mutate their copy and write it back — a live-reference store would alias already-emitted events.
91
+ * - ENTRY SHAPE ({@link TASK_LIST_ITEM_ROW_SHAPE}, the one reading every backend makes): `set` stores the item the table admits —
92
+ * absent dependency lists stored as `[]`, a present one that is not a list of ids refused — or refuses it
93
+ * ({@link TASK_LIST_ROW_MALFORMED_CODE}) before anything is written. A stored entry that does not read (another writer's, an
94
+ * earlier release's) is `list`ed as a {@link DamagedTaskListItem} — its id and verdict — in its place, and `get` of it refuses in
95
+ * the same code; `delete` removes it by its id. The tools count such an entry as open, so it keeps blocking what depends on it.
53
96
  * - RB-274: `list` is ordered by ID (numeric ascending), not by write order. The tool lane always
54
97
  * allocates before it sets, so the two coincide there — but a store shared with an OUTSIDE writer
55
98
  * (a real CC instance on the same directory) can set an id out of order, and then the backends
@@ -64,7 +107,7 @@ export interface TaskListStore {
64
107
  get(id: string): TaskListItem | undefined | Promise<TaskListItem | undefined>;
65
108
  set(id: string, item: TaskListItem): void | Promise<void>;
66
109
  delete(id: string): boolean | Promise<boolean>;
67
- list(): TaskListItem[] | Promise<TaskListItem[]>;
110
+ list(): TaskListEntry[] | Promise<TaskListEntry[]>;
68
111
  allocateId(): string | Promise<string>;
69
112
  /** the transaction boundary for adapters whose backend outlives one wrapper
70
113
  * instance (pg, shared files): when present, the tools run EVERY read-modify-write sequence
@@ -76,24 +119,10 @@ export interface TaskListStore {
76
119
  }
77
120
  /** the clone policy behind the detached-copy contract: metadata must be JSON-shaped
78
121
  * (structuredClone would accept — and SHARE — SharedArrayBuffer backing memory, and throws opaquely
79
- * on functions/proxies; the tool lane is always JSON, so this guards DIRECT store users). */
80
- /**
81
- * RB-168 — the dependency arrays are STRUCTURAL, and a store must refuse a row that lacks them.
82
- *
83
- * The in-memory store rejected such a row incidentally: its snapshot helper spreads `t.blocks`, so a
84
- * missing array threw "blocks is not iterable" at write. The file store had no such accident and wrote the
85
- * row to disk, where it survived until `TaskUpdate` reached `t.blocks.includes(...)` — a contaminated row that
86
- * passes the write and detonates at an unrelated later call, in a different session, with no trace of where
87
- * it came from. Two backends disagreeing about what a valid row is means a test written against one has
88
- * different semantics on the other.
89
- *
90
- * NORMALIZE rather than reject: the harm is a stored row that EXPLODES AT READ, not an incomplete one.
91
- * Defaulting the arrays removes the harm without inventing a new failure mode for callers that legitimately
92
- * write a partial row (a task with no dependencies has empty arrays — that is what the absence meant).
93
- * Rejecting instead would have been a behaviour change dressed as a fix: the first attempt did exactly that
94
- * and broke an in-tree test whose subject was id allocation, not row shape.
95
- */
96
- export declare function normalizeTaskShape<T>(item: T): T;
122
+ * on functions/proxies; the tool lane is always JSON, so this guards DIRECT store users). The answer form:
123
+ * `undefined` = JSON-shaped, else the refusal's sentence naming the first member that is not. */
124
+ export declare function jsonMetadataProblem(value: unknown, path?: string): string | undefined;
125
+ /** {@link jsonMetadataProblem} as the write-time refusal (a store twin calls it before persisting). */
97
126
  export declare function assertJsonMetadata(value: unknown, path?: string): void;
98
127
  /**
99
128
  * RB-274 — the contract's `list` order: numeric ids ascending (CC's own task order), any non-numeric id
@@ -1,5 +1,67 @@
1
1
  import { Type } from "typebox";
2
2
  import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
3
+ import { absentReads, isListOf, isRowCorrupt, isString, isWord, optional, pair, required, rowShapeReader, takesExit } from "../core/row-shape.js";
4
+ export const TASK_LIST_STATUSES = Object.freeze(["pending", "in_progress", "completed"]);
5
+ export const TASK_LIST_ROW_MALFORMED_CODE = "task_list.row_malformed";
6
+ export class TaskListStoreError extends Error {
7
+ code;
8
+ constructor(code, message) {
9
+ super(message);
10
+ this.code = code;
11
+ this.name = "TaskListStoreError";
12
+ }
13
+ }
14
+ const isJsonMetadata = (v) => (jsonMetadataProblem(v) === undefined ? undefined : "is not JSON-serializable");
15
+ export const TASK_LIST_ITEM_ROW_SHAPE = rowShapeReader({
16
+ family: "task-list",
17
+ code: TASK_LIST_ROW_MALFORMED_CODE,
18
+ sentence: "This task list holds an entry that does not read the way this engine reads a task — it was written by another writer or an earlier release, or changed in storage. It stays as stored: it is listed as unreadable and counts as open (it still blocks the tasks that depend on it); it cannot be read or updated here, and it can be deleted.",
19
+ exit: "list-damaged",
20
+ segments: [
21
+ {
22
+ name: "members",
23
+ entries: [
24
+ required("id", isString),
25
+ pair("id", (r, ctx) => (r.id === ctx.key ? undefined : "its id is not the key the list files it under")),
26
+ pair("rowVerdict", (r) => (Object.hasOwn(r, "rowVerdict") ? "it carries rowVerdict, the member a listing reserves for an entry that does not read" : undefined)),
27
+ required("subject", isString),
28
+ required("description", isString),
29
+ required("status", isWord(TASK_LIST_STATUSES)),
30
+ optional("activeForm", isString),
31
+ optional("owner", isString),
32
+ absentReads("blocks", () => [], isListOf(isString)),
33
+ absentReads("blockedBy", () => [], isListOf(isString)),
34
+ optional("metadata", isJsonMetadata),
35
+ ],
36
+ },
37
+ ],
38
+ });
39
+ function taskListRefusal(corrupt) {
40
+ return new TaskListStoreError(TASK_LIST_ROW_MALFORMED_CODE, TASK_LIST_ITEM_ROW_SHAPE.refusalText(corrupt));
41
+ }
42
+ export function readStoredTaskListItem(raw, id, disclose) {
43
+ const answer = TASK_LIST_ITEM_ROW_SHAPE.read(raw, { key: id });
44
+ if (!isRowCorrupt(answer))
45
+ return answer.row;
46
+ disclose?.(`task #${id}: ${answer.why} — refused in ${TASK_LIST_ROW_MALFORMED_CODE}`);
47
+ throw taskListRefusal(answer);
48
+ }
49
+ export function listStoredTaskListEntry(raw, id, disclose) {
50
+ const answer = TASK_LIST_ITEM_ROW_SHAPE.read(raw, { key: id });
51
+ if (!isRowCorrupt(answer))
52
+ return answer.row;
53
+ takesExit(answer, "list-damaged", "task list listing");
54
+ disclose?.(`task #${id}: ${answer.why} — listed as unreadable`);
55
+ return { id, rowVerdict: TASK_LIST_ITEM_ROW_SHAPE.damagedVerdict(answer) };
56
+ }
57
+ export function admitTaskListItem(item, id) {
58
+ if (item.metadata)
59
+ assertJsonMetadata(item.metadata);
60
+ const answer = TASK_LIST_ITEM_ROW_SHAPE.admit(item, { key: id });
61
+ if (isRowCorrupt(answer))
62
+ throw taskListRefusal(answer);
63
+ return answer.row;
64
+ }
3
65
  const STATUS = Type.Union([
4
66
  Type.Literal("pending"),
5
67
  Type.Literal("in_progress"),
@@ -22,39 +84,41 @@ function renderTask(t) {
22
84
  .join("\n");
23
85
  }
24
86
  function snapTask(t) {
25
- const n = normalizeTaskShape(t);
26
- return { ...n, blocks: [...n.blocks], blockedBy: [...n.blockedBy], ...(n.metadata ? { metadata: structuredClone(n.metadata) } : {}) };
87
+ return { ...t, blocks: [...t.blocks], blockedBy: [...t.blockedBy], ...(t.metadata ? { metadata: structuredClone(t.metadata) } : {}) };
27
88
  }
28
- export function normalizeTaskShape(item) {
29
- const t = item;
30
- if (!Array.isArray(t.blocks) || !Array.isArray(t.blockedBy)) {
31
- return {
32
- ...item,
33
- blocks: Array.isArray(t.blocks) ? t.blocks : [],
34
- blockedBy: Array.isArray(t.blockedBy) ? t.blockedBy : [],
35
- };
36
- }
37
- return item;
89
+ function snapEntry(e) {
90
+ return "rowVerdict" in e ? { id: e.id, rowVerdict: e.rowVerdict } : snapTask(e);
38
91
  }
39
- export function assertJsonMetadata(value, path = "metadata") {
92
+ export function jsonMetadataProblem(value, path = "metadata") {
40
93
  if (value === null)
41
- return;
94
+ return undefined;
42
95
  const t = typeof value;
43
96
  if (t === "string" || t === "number" || t === "boolean")
44
- return;
97
+ return undefined;
45
98
  if (Array.isArray(value)) {
46
- value.forEach((v, i) => assertJsonMetadata(v, `${path}[${i}]`));
47
- return;
99
+ for (let i = 0; i < value.length; i++) {
100
+ const problem = jsonMetadataProblem(value[i], `${path}[${i}]`);
101
+ if (problem !== undefined)
102
+ return problem;
103
+ }
104
+ return undefined;
48
105
  }
49
106
  if (t === "object" && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null)) {
50
107
  for (const [k, v] of Object.entries(value)) {
51
108
  if (v === undefined)
52
109
  continue;
53
- assertJsonMetadata(v, `${path}.${k}`);
110
+ const problem = jsonMetadataProblem(v, `${path}.${k}`);
111
+ if (problem !== undefined)
112
+ return problem;
54
113
  }
55
- return;
114
+ return undefined;
56
115
  }
57
- throw new Error(`Task ${path} must be JSON-serializable (found ${t === "object" ? "non-plain object" : t}).`);
116
+ return `Task ${path} must be JSON-serializable (found ${t === "object" ? "non-plain object" : t}).`;
117
+ }
118
+ export function assertJsonMetadata(value, path = "metadata") {
119
+ const problem = jsonMetadataProblem(value, path);
120
+ if (problem !== undefined)
121
+ throw new Error(problem);
58
122
  }
59
123
  export function compareTaskIds(a, b) {
60
124
  const num = (id) => (/^\d+$/.test(id) ? Number.parseInt(id, 10) : Number.NaN);
@@ -73,15 +137,13 @@ export function createMemoryTaskListStore() {
73
137
  return {
74
138
  get: (id) => {
75
139
  const t = tasks.get(id);
76
- return t ? snapTask(t) : undefined;
140
+ return t ? snapTask(readStoredTaskListItem(t, id)) : undefined;
77
141
  },
78
142
  set: (id, item) => {
79
- if (item.metadata)
80
- assertJsonMetadata(item.metadata);
81
- tasks.set(id, snapTask(item));
143
+ tasks.set(id, snapTask(admitTaskListItem(item, id)));
82
144
  },
83
145
  delete: (id) => tasks.delete(id),
84
- list: () => [...tasks.values()].sort((a, b) => compareTaskIds(a.id, b.id)).map(snapTask),
146
+ list: () => [...tasks.entries()].sort(([a], [b]) => compareTaskIds(a, b)).map(([id, t]) => snapEntry(listStoredTaskListEntry(t, id))),
85
147
  allocateId: () => String(nextId++),
86
148
  };
87
149
  }
@@ -290,19 +352,28 @@ export function createTaskListTools(store) {
290
352
  execute: (args) => serialized(tasks, async (tx) => {
291
353
  const a = args;
292
354
  const id = String(a.taskId);
293
- const t = await tx.get(id);
294
- if (!t) {
295
- throw new Error(`Task #${id} not found.`);
296
- }
297
- if (a.ifOwnerIs !== undefined) {
355
+ const notFound = () => new Error(`Task #${id} not found.`);
356
+ const guardOwner = (t) => {
357
+ if (a.ifOwnerIs === undefined)
358
+ return;
298
359
  const match = a.ifOwnerIs === null ? t.owner === undefined : t.owner === a.ifOwnerIs;
299
360
  if (!match) {
300
361
  throw new Error(`Task #${id} owner guard failed: task is ${t.owner === undefined ? "unowned" : `owned by "${t.owner}"`}.`);
301
362
  }
302
- }
363
+ };
303
364
  if (a.status === "deleted") {
304
- for (const other of await tx.list()) {
305
- if (other.id === id)
365
+ const entries = await tx.list();
366
+ const target = entries.find((e) => e.id === id);
367
+ if (!target)
368
+ throw notFound();
369
+ if ("rowVerdict" in target) {
370
+ if (a.ifOwnerIs !== undefined)
371
+ await tx.get(id);
372
+ }
373
+ else
374
+ guardOwner(target);
375
+ for (const other of entries) {
376
+ if (other.id === id || "rowVerdict" in other)
306
377
  continue;
307
378
  const blocks = other.blocks.filter((x) => x !== id);
308
379
  const blockedBy = other.blockedBy.filter((x) => x !== id);
@@ -313,6 +384,13 @@ export function createTaskListTools(store) {
313
384
  await tx.delete(id);
314
385
  return { content: `Task #${id} deleted.`, details: { type: "task", deleted: id } };
315
386
  }
387
+ const t = await tx.get(id);
388
+ if (!t)
389
+ throw notFound();
390
+ guardOwner(t);
391
+ for (const b of [...(a.addBlocks ?? []), ...(a.addBlockedBy ?? [])])
392
+ if (b !== id)
393
+ await tx.get(b);
316
394
  if (a.status)
317
395
  t.status = a.status;
318
396
  if (a.subject !== undefined)
@@ -427,15 +505,17 @@ export function createTaskListTools(store) {
427
505
  if (all.length === 0) {
428
506
  return { content: "The task list is empty.", details: { type: "task-list", tasks: [] } };
429
507
  }
430
- const openIds = new Set(all.filter((x) => x.status !== "completed").map((x) => x.id));
508
+ const openIds = new Set(all.filter((x) => "rowVerdict" in x || x.status !== "completed").map((x) => x.id));
431
509
  const lines = all.map((t) => {
510
+ if ("rowVerdict" in t)
511
+ return `#${t.id} [unreadable]`;
432
512
  const liveBlockers = t.blockedBy.filter((b) => openIds.has(b));
433
513
  return `#${t.id} [${t.status}] ${t.subject}${t.owner ? ` (owner: ${t.owner})` : ""}${liveBlockers.length ? ` (blocked by: ${liveBlockers.join(", ")})` : ""}`;
434
514
  });
435
515
  const open = openIds.size;
436
516
  return {
437
517
  content: `${lines.join("\n")}\n(${all.length} total, ${open} open)`,
438
- details: { type: "task-list", tasks: all.map(snapTask) },
518
+ details: { type: "task-list", tasks: all.map(snapEntry) },
439
519
  };
440
520
  }),
441
521
  };
@@ -1,4 +1,4 @@
1
- import type { Brain, ToolSpec } from "../core/types.js";
1
+ import type { RunnerDeps, ToolSpec } from "../core/types.js";
2
2
  import { type HostFloor } from "../core/host-floor.js";
3
3
  import type { Model } from "../internal/llm.js";
4
4
  /** WebFetch's factory options. Which hosts it may reach is not one of them: that is the deployment's host floor (`RunnerDeps.hostFloor`),
@@ -161,9 +161,14 @@ export interface WebFetchSummarizerOptions {
161
161
  headers?: Record<string, string>;
162
162
  } | undefined;
163
163
  }
164
+ /**
165
+ * The seat a summarizer is built over: `RunnerDeps`' own two members for the model lane — the deployment's `brain` and the
166
+ * `modelFallback` policy the lane walks a catalog entry's `fallbacks` chain on (absent ⇒ the default gate).
167
+ */
168
+ export type WebFetchSummarizerSeat = Pick<RunnerDeps, "brain" | "modelFallback">;
164
169
  /**
165
170
  * A reference {@link WebFetchConfig.summarize} implementation: reuses a
166
- * caller-supplied `brain` (rather than requiring a dedicated second model) to extract a focused answer
171
+ * caller-supplied brain seat (rather than requiring a dedicated second model) to extract a focused answer
167
172
  * from fetched content per the caller's `prompt`, instead of the tool dumping the whole (fenced, still
168
173
  * untrusted) page. CC ALWAYS routes fetched content through a secondary model this way
169
174
  * (WebFetchTool/utils.ts:484-530); a deployment that omits `summarize` entirely gets `webFetchToolSpec`'s
@@ -177,8 +182,13 @@ export interface WebFetchSummarizerOptions {
177
182
  * previously a private copy inside this package's own `sema-tb` CLI entry point, promoted here so other
178
183
  * deployments (a server assembling `WebFetchConfig` for its own scenarios, for one) can reuse it directly
179
184
  * rather than re-deriving it from source.
185
+ *
186
+ * The request goes out on the engine's model lane, like every other model call the engine makes: when `model` is a
187
+ * catalog entry with a `fallbacks` chain, a failure the seat's `modelFallback` gate admits moves the request to the next
188
+ * entry, and the summary is that entry's text. The seat is read once, here — a member it does not take, a `brain` that is
189
+ * not a Brain and a bad `modelFallback` are refused when the summarizer is built, not on the first page.
180
190
  */
181
- export declare function createWebFetchSummarizer(brain: Brain, model: Model, options?: WebFetchSummarizerOptions): (content: string, prompt: string, signal?: AbortSignal) => Promise<string | {
191
+ export declare function createWebFetchSummarizer(seat: WebFetchSummarizerSeat, model: Model, options?: WebFetchSummarizerOptions): (content: string, prompt: string, signal?: AbortSignal) => Promise<string | {
182
192
  text: string;
183
193
  truncated?: boolean;
184
194
  inputTruncated?: boolean;
package/dist/tools/web.js CHANGED
@@ -11,7 +11,11 @@ import { DEFAULT_CHARS_PER_TOKEN } from "../internal/harness.js";
11
11
  import { binaryMagicFormat } from "./fs/safety.js";
12
12
  import { pdfMagicMatches } from "../core/image-admission.js";
13
13
  import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
14
- import { thrownText } from "../core/thrown-value.js";
14
+ import { codedRefusal, thrownText } from "../core/thrown-value.js";
15
+ import { optionKeys, receiptRefusal, receiveMembers } from "../core/own-property-receipt.js";
16
+ import { modelLaneBrainOf } from "../core/runner/model-lane-seat.js";
17
+ import { completeOf } from "../brain/brain-faces.js";
18
+ import { isBrain } from "../brain/routing.js";
15
19
  const MAX_REDIRECTS = 10;
16
20
  const MAX_URL_LENGTH = 2048;
17
21
  const WEBFETCH_ACCEPT = "text/markdown, text/html, */*";
@@ -691,7 +695,16 @@ export function resolveSummaryInputChars(model, override) {
691
695
  const derived = Math.floor(inputTokens * charsPerToken * WEBFETCH_SUMMARY_INPUT_HEADROOM);
692
696
  return Math.min(WEBFETCH_SUMMARY_MAX_CONTENT, Math.max(WEBFETCH_SUMMARY_MIN_CONTENT, derived));
693
697
  }
694
- export function createWebFetchSummarizer(brain, model, options = {}) {
698
+ const SUMMARIZER_SEAT_KEYS = optionKeys()({ brain: 0, modelFallback: 0 });
699
+ export function createWebFetchSummarizer(seat, model, options = {}) {
700
+ if (typeof seat !== "object" || seat === null) {
701
+ throw receiptRefusal("createWebFetchSummarizer's seat must be a record of `brain` and (optionally) `modelFallback` — refused when the summarizer is built rather than wired without a Brain");
702
+ }
703
+ const held = receiveMembers(seat, { subject: "createWebFetchSummarizer's seat", unit: "member", moment: "when the summarizer is built" }, SUMMARIZER_SEAT_KEYS);
704
+ if (!isBrain(held.brain)) {
705
+ throw receiptRefusal("createWebFetchSummarizer's seat.brain is absent or is not a Brain (an object with a `stream` function) — refused when the summarizer is built rather than wired without one");
706
+ }
707
+ const complete = completeOf(modelLaneBrainOf(held));
695
708
  const maxContentChars = resolveSummaryInputChars(model, options.maxContentChars);
696
709
  return async (content, prompt, signal) => {
697
710
  const promptOverflow = Math.max(0, prompt.length - SUMMARY_PROMPT_ALLOWANCE_CHARS);
@@ -706,9 +719,7 @@ export function createWebFetchSummarizer(brain, model, options = {}) {
706
719
  ...(auth?.apiKey !== undefined ? { apiKey: auth.apiKey } : {}),
707
720
  ...(auth?.headers !== undefined ? { headers: auth.headers } : {}),
708
721
  };
709
- const msg = brain.complete
710
- ? await brain.complete(model, context, callOptions)
711
- : await (await Promise.resolve(brain.stream(model, context, callOptions))).result();
722
+ const msg = await complete(model, context, callOptions);
712
723
  if (msg.stopReason === "error" || msg.stopReason === "aborted") {
713
724
  throw new Error(msg.errorMessage ?? `summarizer stopped with ${msg.stopReason}`);
714
725
  }
@@ -984,7 +995,7 @@ export function createSearxngSearchBackend(baseUrl, options = {}) {
984
995
  const timeout = AbortSignal.timeout(timeoutMs);
985
996
  const followed = await fetchFollowing(doFetch, url, { method: "GET", headers: { accept: "application/json" }, signal: signal ? AbortSignal.any([signal, timeout]) : timeout }, { refusal: (hop) => hopRefusal(hop, opts?.hostFloor, false), follows: () => true, maxRedirects: SEARXNG_MAX_REDIRECTS });
986
997
  if (followed.kind === "refused")
987
- throw Object.assign(new Error(`SearXNG request is not sent — ${followed.reason}`), { code: HOST_FLOOR_REFUSED_CODE });
998
+ throw codedRefusal(HOST_FLOOR_REFUSED_CODE, `SearXNG request is not sent — ${followed.reason}`);
988
999
  if (followed.kind === "too_many")
989
1000
  throw new Error(`SearXNG was redirected more than ${SEARXNG_MAX_REDIRECTS} times`);
990
1001
  const res = followed.res;
@@ -15,8 +15,9 @@
15
15
  * M22 RESOLVED, live-CC anchor 2026-07-09: the previous worktree is left on disk untouched, only the
16
16
  * new one is tracked for exit-time cleanup, and a path-entered tree is NEVER removed by ExitWorktree);
17
17
  * ④ ExitWorktree outside a session is an honest NO-OP (CC errorCode 1), and a worktree with
18
- * uncommitted files or commits is NOT deleted by default (CC refuses `remove` without
19
- * `discard_changes`; sema keeps it and reports the path — inspect/merge in userland);
18
+ * uncommitted files, files git ignores, or commits is NOT deleted by default (CC refuses `remove` without
19
+ * `discard_changes`; sema keeps it and reports the path — inspect/merge in userland; the ignored-files arm is sema's
20
+ * own: CC counts `status --porcelain` and commits only);
20
21
  * ⑤ outside a git repository CC delegates to WorktreeCreate/WorktreeRemove hooks — sema has no such
21
22
  * shell extension point, so the tool says so honestly and refuses (no silent degrade).
22
23
  *
@@ -1,7 +1,7 @@
1
1
  import { resolve } from "node:path";
2
2
  import { Type } from "typebox";
3
3
  import { defineTool, errorResult } from "../core/tools.js";
4
- import { addWorktree, managedTreeAt, managedWorktreeBaseOf, pruneWorktrees, removeManagedWorktree, resolveBaseCommit, worktreeNameProblem, WORKTREE_PARENT } from "../core/git-worktree-env.js";
4
+ import { addWorktree, keptByHolds, managedTreeAt, managedWorktreeBaseOf, namedIgnored, pruneWorktrees, removeManagedWorktree, resolveBaseCommit, treeHoldsOf, worktreeNameProblem, WORKTREE_PARENT, } from "../core/git-worktree-env.js";
5
5
  import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
6
6
  import { thrownText } from "../core/thrown-value.js";
7
7
  export function currentCheckoutOf(session, taskRoot) {
@@ -82,17 +82,30 @@ const EXIT_DESCRIPTION = "Exit a worktree session created by EnterWorktree and r
82
82
  "## Behavior\n" +
83
83
  "\n" +
84
84
  "- Restores the session's working directory to where it was before EnterWorktree.\n" +
85
- "- Default: if the worktree has NO changes (clean `git status`, no new commits), it is removed and " +
86
- "pruned; if it HAS uncommitted files or new commits, it is KEPT on disk and its path reported so the " +
85
+ "- Default: if the worktree has NO changes (clean `git status`, no files git ignores, no new commits), it is removed and " +
86
+ "pruned; if it HAS uncommitted files, files git ignores (build output, `node_modules/`), or new commits, it is KEPT on disk and its path reported so the " +
87
87
  "work can be inspected or merged — nothing is discarded.\n" +
88
88
  "- A worktree entered via EnterWorktree `path` (not created by it) is NEVER removed — exit only restores " +
89
89
  "the working directory.\n" +
90
90
  "- `keep: true` always keeps the worktree on disk, changed or not.\n" +
91
- "- `discardChanges: true` removes the worktree even when it HAS uncommitted files or new commits — they " +
91
+ "- `discardChanges: true` removes the worktree even when it HAS uncommitted files, files git ignores, or new commits — they " +
92
92
  "are permanently discarded. Only set this when the work is confirmed disposable (a throwaway experiment, " +
93
93
  "or the user asked to discard it); it cannot be combined with `keep: true`.\n" +
94
94
  "- Once exited, EnterWorktree can be called again to create a fresh worktree.";
95
- const shq = (s) => `'${s.replace(/'/g, "'\\''")}'`;
95
+ function heldSentence(holds) {
96
+ const parts = [];
97
+ if (holds !== undefined) {
98
+ if (holds.files > 0)
99
+ parts.push(`${holds.files} uncommitted ${holds.files === 1 ? "file" : "files"}`);
100
+ if (holds.commits !== undefined && holds.commits > 0)
101
+ parts.push(`${holds.commits} new ${holds.commits === 1 ? "commit" : "commits"}`);
102
+ if (holds.ignored.length > 0)
103
+ parts.push(`${holds.ignored.length} ${holds.ignored.length === 1 ? "path" : "paths"} git ignores (${namedIgnored(holds.ignored)})`);
104
+ }
105
+ if (parts.length === 0)
106
+ return "could not verify the worktree state — keeping it to be safe";
107
+ return parts.length <= 2 ? parts.join(" and ") : `${parts.slice(0, -1).join(", ")} and ${parts[parts.length - 1]}`;
108
+ }
96
109
  function reasonOf(e) {
97
110
  try {
98
111
  if (typeof e === "object" && e !== null && !(e instanceof Error)) {
@@ -253,16 +266,16 @@ export function createWorktreeTools(env, opts) {
253
266
  description: EXIT_DESCRIPTION,
254
267
  parameters: Type.Object({
255
268
  keep: Type.Optional(Type.Boolean({
256
- description: "true = always keep the worktree on disk. Default: keep only when it has uncommitted files or new commits; remove when unchanged.",
269
+ description: "true = always keep the worktree on disk. Default: keep only when it has uncommitted files, files git ignores, or new commits; remove when it has none.",
257
270
  })),
258
271
  discardChanges: Type.Optional(Type.Boolean({
259
- description: "true = remove the worktree even when it has uncommitted files or new commits, permanently discarding them. Default false: a changed worktree is kept and its changes listed. Cannot be combined with `keep: true`.",
272
+ description: "true = remove the worktree even when it has uncommitted files, files git ignores, or new commits, permanently discarding them. Default false: a changed worktree is kept and its changes listed. Cannot be combined with `keep: true`.",
260
273
  })),
261
274
  action: Type.Optional(Type.Union([Type.Literal("keep"), Type.Literal("remove")], {
262
275
  description: '"keep" leaves the worktree and its branch on disk. "remove" takes the default removal path: an unchanged worktree is removed, a changed one is still KEPT unless `discard_changes: true`. A removed worktree\'s branch is deleted with it only when it carries no commits beyond the base; a branch with commits is kept and named in the reply.',
263
276
  })),
264
277
  discard_changes: Type.Optional(Type.Boolean({
265
- description: 'Set true to remove the worktree even when it has uncommitted files or unmerged commits — they are permanently discarded. Without it a changed worktree is KEPT (the exit still completes and the reply lists the changes plus this escape), never refused.',
278
+ description: 'Set true to remove the worktree even when it has uncommitted files, files git ignores, or unmerged commits — they are permanently discarded. Without it a changed worktree is KEPT (the exit still completes and the reply lists the changes plus this escape), never refused.',
266
279
  })),
267
280
  }),
268
281
  execute: async (args, ctx) => {
@@ -354,23 +367,9 @@ export function createWorktreeTools(env, opts) {
354
367
  },
355
368
  };
356
369
  }
357
- let changed = true;
358
- let changeDetail = "could not verify the worktree state — keeping it to be safe";
359
- const status = await env.exec("git status --porcelain", { cwd: active.worktreeDir, ...(readFloor !== undefined ? { readFloor } : {}) });
360
- if (status.ok && status.value.exitCode === 0) {
361
- const dirtyFiles = status.value.stdout.split("\n").filter((l) => l.trim() !== "").length;
362
- const ahead = await env.exec(`git rev-list --count ${shq(`${active.baseSha}..HEAD`)}`, { cwd: active.worktreeDir, ...(readFloor !== undefined ? { readFloor } : {}) });
363
- const commits = ahead.ok && ahead.value.exitCode === 0 ? parseInt(ahead.value.stdout.trim(), 10) || 0 : -1;
364
- if (commits >= 0) {
365
- changed = dirtyFiles > 0 || commits > 0;
366
- const parts = [];
367
- if (dirtyFiles > 0)
368
- parts.push(`${dirtyFiles} uncommitted ${dirtyFiles === 1 ? "file" : "files"}`);
369
- if (commits > 0)
370
- parts.push(`${commits} new ${commits === 1 ? "commit" : "commits"}`);
371
- changeDetail = parts.join(" and ");
372
- }
373
- }
370
+ const holds = await treeHoldsOf(env, active.worktreeDir, active.baseSha, () => readFloor, { rethrow: true });
371
+ const changed = keptByHolds(holds) !== undefined;
372
+ const changeDetail = heldSentence(holds);
374
373
  if (keep === true || (changed && discardChanges !== true)) {
375
374
  const why = keep === true ? "keep was requested" : `it has ${changeDetail}`;
376
375
  const removeHint = wantsRemove && keep !== true