@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,16 @@
1
+ import type { MemoryBackend, MemoryEntry } from "./types.js";
2
+ /** One read of the face: the shadow text (absent when there is none), or the fault with the error the face threw. */
3
+ export type CommittedShadowRead = {
4
+ readonly fault: false;
5
+ readonly content?: string;
6
+ } | {
7
+ readonly fault: true;
8
+ readonly error: Error;
9
+ };
10
+ /** The committed shadow of `id`, read through the backend's own face (never a path re-derived by the caller). A backend
11
+ * without the face answers no shadow. */
12
+ export declare function committedShadowOrFault(backend: MemoryBackend, id: string): CommittedShadowRead;
13
+ /** The unadopted read's face: a fault is "no copy". */
14
+ export declare function committedShadowTextOrAbsent(backend: MemoryBackend, id: string): string | undefined;
15
+ /** The frontmatter read's face: a fault is thrown (the original error), absence is `undefined`. */
16
+ export declare function committedShadowFrontmatter(backend: MemoryBackend, id: string): MemoryEntry["frontmatter"] | undefined;
@@ -0,0 +1,21 @@
1
+ import { asThrownError } from "../thrown-value.js";
2
+ import { parseEntryFile } from "./frontmatter.js";
3
+ export function committedShadowOrFault(backend, id) {
4
+ try {
5
+ const content = backend.readCommittedShadow?.(id);
6
+ return content === undefined ? { fault: false } : { fault: false, content };
7
+ }
8
+ catch (err) {
9
+ return { fault: true, error: asThrownError(err) };
10
+ }
11
+ }
12
+ export function committedShadowTextOrAbsent(backend, id) {
13
+ const read = committedShadowOrFault(backend, id);
14
+ return read.fault ? undefined : read.content;
15
+ }
16
+ export function committedShadowFrontmatter(backend, id) {
17
+ const read = committedShadowOrFault(backend, id);
18
+ if (read.fault)
19
+ throw read.error;
20
+ return read.content !== undefined ? parseEntryFile(read.content).frontmatter : undefined;
21
+ }
@@ -1,4 +1,5 @@
1
1
  import { uuidv7 } from "../../internal/harness.js";
2
+ import { describeRejectedValue } from "../tool-search-setting.js";
2
3
  import { enqueueMemoryAnnouncement } from "./layout.js";
3
4
  import { inlineUntrusted } from "../untrusted-text.js";
4
5
  import { extensionWords } from "../untrusted-egress.js";
@@ -128,7 +129,7 @@ export async function runMemoryConsolidationDriver(engine, scope, opts) {
128
129
  if (typeof opts?.chat !== "function")
129
130
  throw driverConfigRefusal("runMemoryConsolidationDriver needs an explicit chat seat (opts.chat) — the engine holds no model seat and a driver that silently skips would publish nothing as a model's answer.");
130
131
  if (typeof opts.model !== "string" || opts.model.trim() === "" || isAliasModelId(opts.model)) {
131
- throw driverConfigRefusal(`runMemoryConsolidationDriver needs an EXPLICIT model id, got ${JSON.stringify(opts.model)} — an alias can be re-pointed upstream and would move the run with no trace in the archive.`);
132
+ throw driverConfigRefusal(`runMemoryConsolidationDriver needs an EXPLICIT model id, got ${describeRejectedValue(opts.model)} — an alias can be re-pointed upstream and would move the run with no trace in the archive.`);
132
133
  }
133
134
  if (opts.mintRepairBudget !== undefined && (typeof opts.mintRepairBudget !== "number" || !Number.isFinite(opts.mintRepairBudget) || opts.mintRepairBudget < 0 || opts.mintRepairBudget > 1)) {
134
135
  throw driverConfigRefusal(`runMemoryConsolidationDriver: mintRepairBudget must be a number in [0, 1] when present (got ${String(opts.mintRepairBudget)}) — an unevaluable budget is refused loudly, never folded to the default.`);
@@ -9,7 +9,7 @@
9
9
  * exclusion view closed.
10
10
  */
11
11
  import { type SessionCaptureRecordStore } from "./layout.js";
12
- import type { MemoryBackend, MemoryEntry, MemoryEntryHeader, MemoryEntryOrigin, MemoryGovernanceObjects, MemoryGovernanceStore, NotePatch } from "./types.js";
12
+ import type { MemoryAttribution, MemoryBackend, MemoryEntry, MemoryEntryHeader, MemoryEntryOrigin, MemoryGovernanceObjects, MemoryGovernanceStore, NotePatch } from "./types.js";
13
13
  import type { ConsolidationDriverRunRow } from "./consolidation-driver.js";
14
14
  /**
15
15
  * Derive the SUPERSEDED set from a committed header listing: superseded entry id → the standing
@@ -426,7 +426,7 @@ export interface ConsolidationDirectedPatch {
426
426
  /** delete only (§1.5-2): who reached the terminal — "self" when THIS plan's apply landed it,
427
427
  * "unattributed" when a replay found the terminal already standing (the F9 crash micro-window:
428
428
  * audit degrades, the judgment never does). */
429
- attribution?: "self" | "unattributed";
429
+ attribution?: Exclude<MemoryAttribution, "overlap">;
430
430
  }
431
431
  export type ConsolidationPlanState = "open" | "applying" | "completed" | "conflict" | "discarded";
432
432
  export interface ConsolidationPlanFile {
@@ -515,7 +515,7 @@ export interface ConsolidationIntentCredentialRow {
515
515
  patches: Array<{
516
516
  op: "update" | "delete";
517
517
  id: string;
518
- attribution?: "self" | "unattributed";
518
+ attribution?: Exclude<MemoryAttribution, "overlap">;
519
519
  }>;
520
520
  }
521
521
  /**
@@ -51,8 +51,9 @@ export declare function moveFileControlObject(controlDir: string, from: {
51
51
  * `putControlObjectOnce` (`layout.ts`), one law: `"existed"` ⇔ an object stands there that reads back (the same bytes,
52
52
  * or other bytes the put refused); a refusal no readable object explains is the put's own and is thrown. */
53
53
  export declare function putFileControlObjectOnce(controlDir: string, kind: MemoryControlObjectKind, name: string, bytes: Uint8Array): "created" | "existed";
54
- /** The File store's capture of one suspect file's copy into its `quarantine` objects — the synchronous twin of
55
- * `captureIntoQuarantine` (`layout.ts`) for the File backend's own synchronous read paths, under the same names. */
56
- export declare function captureIntoFileQuarantine(controlDir: string, path: string, content: string, now: () => number): QuarantineCapture;
54
+ /** The File store's capture of one suspect copy into its `quarantine` objects — the synchronous twin of
55
+ * `captureIntoQuarantine` (`layout.ts`) for the File backend's own synchronous paths: the same names, and the same
56
+ * answer for a name already holding these bytes (the copy is kept; nothing is written again). */
57
+ export declare function captureIntoFileQuarantine(controlDir: string, source: string, content: string): QuarantineCapture;
57
58
  /** Delete one object ({@link import("./types.js").MemoryGovernanceStore.deleteObject}). */
58
59
  export declare function deleteFileControlObject(controlDir: string, kind: MemoryControlObjectKind, name: string): boolean;
@@ -2,7 +2,7 @@ import { closeSync, fsyncSync, linkSync, lstatSync, openSync, readFileSync, read
2
2
  import { randomUUID } from "node:crypto";
3
3
  import { join } from "node:path";
4
4
  import { MEMORY_CONTROL_OBJECT_KINDS } from "./types.js";
5
- import { ControlPlaneCorruptError, IMPORT_RECEIPTS_DIR, LINK_PROBE_PREFIX, QUARANTINE_DIR, SESSION_CAPTURE_OPTOUT_DIR, SESSION_POLLUTION_DIR, controlPlaneLinksRefusal, ensureDirExists, quarantineCaptureBase, quarantineCaptureName } from "./layout.js";
5
+ import { CONTROL_OBJECT_NAME_MAX_BYTES, ControlPlaneCorruptError, IMPORT_RECEIPTS_DIR, LINK_PROBE_PREFIX, QUARANTINE_DIR, SESSION_CAPTURE_OPTOUT_DIR, SESSION_POLLUTION_DIR, controlPlaneLinksRefusal, ensureDirExists, quarantineCaptureName, quarantineObjectNameOf } from "./layout.js";
6
6
  import { thrownText } from "../thrown-value.js";
7
7
  const FILE_CONTROL_OBJECT_DIRS = Object.freeze({
8
8
  pollution: SESSION_POLLUTION_DIR,
@@ -23,7 +23,6 @@ export function fileControlObjectDirOf(kind) {
23
23
  throw unknownObject(`${JSON.stringify(String(kind))} is not a control-object kind`);
24
24
  return FILE_CONTROL_OBJECT_DIRS[kind];
25
25
  }
26
- const CONTROL_OBJECT_NAME_MAX_BYTES = 255;
27
26
  export function isControlObjectName(name) {
28
27
  return typeof name === "string" && name !== "" && name !== "." && name !== ".." && !/[/\\\0]/.test(name) && Buffer.byteLength(name, "utf8") <= CONTROL_OBJECT_NAME_MAX_BYTES;
29
28
  }
@@ -239,14 +238,17 @@ export function putFileControlObjectOnce(controlDir, kind, name, bytes) {
239
238
  return "existed";
240
239
  }
241
240
  }
242
- export function captureIntoFileQuarantine(controlDir, path, content, now) {
241
+ export function captureIntoFileQuarantine(controlDir, source, content) {
243
242
  const bytes = new TextEncoder().encode(content);
244
- const base = quarantineCaptureBase(path, now);
243
+ const base = quarantineObjectNameOf(bytes, source);
245
244
  try {
246
245
  for (let attempt = 0; attempt <= 10; attempt++) {
247
246
  const name = quarantineCaptureName(base, attempt);
248
247
  if (putFileControlObjectOnce(controlDir, "quarantine", name, bytes) === "created")
249
248
  return { name };
249
+ const standing = getFileControlObject(controlDir, "quarantine", name);
250
+ if (standing !== undefined && Buffer.from(standing).equals(bytes))
251
+ return { name };
250
252
  }
251
253
  return { failed: "quarantine copy failed: every capture name already stands" };
252
254
  }
@@ -1,5 +1,6 @@
1
1
  import type { MemoryControlObjectKind, MemoryGovernanceDocs, MemoryGovernanceObjects, MemoryOriginCause } from "./types.js";
2
2
  import { type SessionPollutionObjects } from "./layout.js";
3
+ import { type ProcessCensus, type ProcessUncheckable } from "../process-identity.js";
3
4
  /** A row's FIRST-WRITE status. Rows are immutable after their first write — every later transition
4
5
  * is an append-only event ({@link SettlementEvent}); the effective status is the fold. */
5
6
  export type SettlementRowStatus = "pending" | "unattestable";
@@ -153,11 +154,11 @@ export interface SessionAccountRow {
153
154
  sessionId: string;
154
155
  openedAt: number;
155
156
  /** The scope this session writes (its write home) — the layer it is a live writer of until
156
- * `terminatedAt` ({@link openLayerWriters}). Absent on rows written before the field. */
157
+ * `terminatedAt` ({@link foreignWriterCandidates}). Absent on rows written before the field. */
157
158
  writeScope?: string;
158
159
  /** The session's leg ENDED here: its terminal harvest returned (whatever it admitted — a refused,
159
- * zero-admission or budget-deferred pass ends the leg all the same), or the host valve closed the
160
- * row. A lifecycle fact, independent of `closedAt` (every full harvest closes the account — a
160
+ * zero-admission or budget-deferred pass ends the leg all the same), the host valve closed the
161
+ * row, or a writer reading proved its holding process gone ({@link legLive}). A lifecycle fact, independent of `closedAt` (every full harvest closes the account — a
161
162
  * checkpoint harvest too — while the session may keep writing); cleared when a resume re-opens
162
163
  * the row. */
163
164
  terminatedAt?: number;
@@ -165,6 +166,11 @@ export interface SessionAccountRow {
165
166
  * carried on that mount's handle. A close or a leg end made for another leg — an earlier leg
166
167
  * whose harvest finished after a resume re-opened the row — is not this leg's and is not written. */
167
168
  leg?: string;
169
+ /** The PROCESS that opened the current leg, written by that open ({@link openSessionAccount}). A leg
170
+ * whose process is proven gone is over ({@link legLive}): a process killed outright never runs the
171
+ * harvest that would have ended it. Absent on rows written before the field — such a leg cannot be
172
+ * proven over and reads as running, its refusals naming the host valve. */
173
+ holder?: SessionAccountHolder;
168
174
  /** The STICKY unattributed set, frozen at materialize (§3.6 归属判据): pre-existing, uncommitted
169
175
  * files seen while a FOREIGN dangling open row stood. Membership never shrinks on later writes
170
176
  * (the sticky law); it clears only when the row is re-opened with a fresh classification (the
@@ -180,6 +186,18 @@ export interface SessionAccountRow {
180
186
  * (an unadjudicated close must not launder the residue window it covered). */
181
187
  unadjudicated?: true;
182
188
  }
189
+ /** The process holding a row's current leg: the leg, and the fingerprint (pid, start times, host, pid
190
+ * namespace where the host names one) of the process whose materialize opened it. */
191
+ export interface SessionAccountHolder {
192
+ leg: string;
193
+ pid: number;
194
+ startedAtMs: number | null;
195
+ startedSinceBootMs: number | null;
196
+ host: string;
197
+ /** Absent where the opening host names no pid namespace (macOS): the host name alone then decides
198
+ * whether a reader shares its process table. */
199
+ pidNs?: string;
200
+ }
183
201
  /** The one-time v1 key-form conversions of the three engine sidecars, in one call (each in its own
184
202
  * lock, each idempotent). The layout adoption runs this before any later scope registration can
185
203
  * change what a v1 key's first segment names. A step of the File layout's own upgrade: it converts
@@ -193,21 +211,100 @@ export declare function convertV1SidecarKeys(controlDir: string): void;
193
211
  * adoption runs this before handing the document to another store (#3484): that store's readers refuse the v1 form,
194
212
  * and nothing there converts it. The conversion is the File layout's own ({@link convertSessionAccounts}). */
195
213
  export declare function convertV1SessionAccountsAt(controlDir: string): void;
196
- /** The dangling-trigger read: open rows (and unadjudicated closes) belonging to OTHER sessions.
197
- * These are what arm the unattributed residue classification at a session's materialize. */
198
- export declare function foreignDanglingSessionAccounts(docs: MemoryGovernanceDocs, selfSessionId: string): Promise<SessionAccountRow[]>;
199
- /** The live writers of the store's layers, as the account knows them: every row other than the one
200
- * held by `selfLeg` (the asking mount's own leg — another leg of the same session is another
201
- * writer) whose session's leg has not ended (no `terminatedAt` — running, or ended without
202
- * a terminal close, e.g. a crash), by its write scope. A row written before the write scope was
203
- * recorded (the engine then closed the account at every full harvest, so its close cannot say
204
- * whether the leg ended) reads as before: live while never closed, counted in `unscoped` — a
205
- * writer of an unknown layer. Sessions that open no row (no session id, provenance "off", an
206
- * adoption-restricted mount) are not visible here. */
207
- export declare function openLayerWriters(docs: MemoryGovernanceDocs, selfLeg: string | undefined): Promise<{
208
- scopes: Set<string>;
209
- unscoped: number;
210
- }>;
214
+ /** The asking mount, excluded from {@link foreignWriterCandidates}: its own leg (another leg of the
215
+ * same session is another writer), its own session id, or both. */
216
+ export interface WriterCandidateSelf {
217
+ sessionId?: string;
218
+ leg?: string;
219
+ }
220
+ /** Why an open leg could not be proven over — each a reason it may still be running. */
221
+ export type LegUnprovable =
222
+ /** The row records no process for its leg (written before the field, or before legs were recorded). */
223
+ "no_holder"
224
+ /** The recorded process opened an EARLIER leg: a later open replaced the leg without recording its own. */
225
+ | "earlier_leg"
226
+ /** The row changed between the census and the record of its end (a resume re-opened it) — twice. */
227
+ | "contended" | ProcessUncheckable;
228
+ /** A leg that is still open: proven running, or not provable either way (and why). */
229
+ export type LegStanding = {
230
+ readonly state: "running";
231
+ } | {
232
+ readonly state: "unprovable";
233
+ readonly why: LegUnprovable;
234
+ };
235
+ /**
236
+ * Is the row's leg still a writer? ONE rule: a leg is over when it was recorded over, or when the process
237
+ * holding it is proven gone.
238
+ *
239
+ * · RECORDED OVER — `terminatedAt` (its harvest returned, the host valve closed it, or an earlier census
240
+ * proved it gone). A row written before its leg or write scope was recorded keeps its own reading (the
241
+ * engine then closed the account at every full harvest, so only a never-closed row is a writer) and
242
+ * records no process this engine wrote, so its leg is never proven over by a census.
243
+ * · PROVEN GONE — the holder's process, judged by {@link processCensus}: only a pid this host's process
244
+ * table says does not exist, or one now held by a process that started after the holder did, is gone.
245
+ * Everything the census cannot establish — a holder from another host or pid namespace, one written
246
+ * without its namespace on a host that has one, no comparable start time — leaves the leg a writer.
247
+ *
248
+ * `gone` carries the holder the verdict was reached on: recording the end is conditional on the row still
249
+ * naming that same holder ({@link foreignWriterCandidates}).
250
+ */
251
+ export declare function legLive(row: SessionAccountRow, census: ProcessCensus): {
252
+ readonly state: "ended";
253
+ } | {
254
+ readonly state: "gone";
255
+ readonly holder: SessionAccountHolder;
256
+ } | LegStanding;
257
+ /** The words for each {@link LegUnprovable}. */
258
+ export declare function legUnprovableText(why: LegUnprovable): string;
259
+ /** One candidate of {@link foreignWriterCandidates}: the account row as the reading answers it, and its leg —
260
+ * still open (proven running, or not provable either way, and why) or over. The row names no write scope where
261
+ * its layer is not known (written before the field; re-opened on another layer over a generation that never
262
+ * closed normally; changing again while the census read it): a writer of every layer. */
263
+ export type ForeignWriter = SessionAccountRow & {
264
+ readonly standing: LegStanding | {
265
+ readonly state: "ended";
266
+ };
267
+ };
268
+ /** A leg the reading proved gone and recorded over — handed to the reader the moment its record lands, for the
269
+ * reader to say once (a reading that fails afterwards has handed it over all the same). */
270
+ export interface ProvenEndedLeg {
271
+ readonly sessionId: string;
272
+ readonly leg: string;
273
+ readonly writeScope?: string;
274
+ }
275
+ /**
276
+ * THE liveness reading of the session account — the one answer to "which other writers may have put bytes on
277
+ * this layer since `since`, and which of them may still be writing". A row is asked about when it is not the
278
+ * asking mount's ({@link WriterCandidateSelf}) and writes `layer` (or records no write scope — a writer of every
279
+ * layer; `layer` absent asks about every layer). Its leg is judged by ONE rule ({@link legLive}): over when
280
+ * recorded over, or when the process holding it is proven gone — and a leg proven gone is RECORDED over here
281
+ * (`terminatedAt`, written only while the row still names the leg and holder the verdict was reached on: a resume
282
+ * that re-opened the row in between is a live leg, and the census runs again on the fresh row, once; a row that
283
+ * changes again stays a writer, of every layer — the scope this census read is no longer the one it holds). The
284
+ * process table is asked once per pid however many rows name it, and outside the ledger's lock. Each leg this
285
+ * reading records over goes to `onEnded` as its record lands.
286
+ *
287
+ * A row is a CANDIDATE when its leg is still open, or ended after `since`, or its account never closed (a terminal
288
+ * harvest that deferred files, a failed prepare, a leg proven gone — none adjudicated the plane), or the host valve
289
+ * closed it without adjudication; a row written before its leg and write scope were recorded, while its account
290
+ * never closed or was valve-closed. The account close alone is not the answer (every full harvest closes it, a
291
+ * checkpoint harvest too, while the leg keeps writing), and the leg end alone is not either (a deferred terminal
292
+ * harvest ends the leg over files it never adjudicated).
293
+ *
294
+ * Its readers: the materialize residue arm (`since` = the mount) and the harvest's window (`since` = the handle's
295
+ * last baseline) judge every candidate's state; the read-only-layer restore waits on the candidates whose leg is
296
+ * open — the edit it must not overwrite is one a writer may still be making, and a leg that is over has made its
297
+ * last (its unadjudicated bytes are the residue arm's to judge). The host audit reads it whole. Sessions that open
298
+ * no row (no session id, provenance "off", an adoption-restricted mount) are not visible here. Throws on a corrupt
299
+ * ledger.
300
+ */
301
+ export declare function foreignWriterCandidates(docs: MemoryGovernanceDocs, input: {
302
+ layer?: string;
303
+ since: number;
304
+ self: WriterCandidateSelf;
305
+ now: () => number;
306
+ onEnded: (leg: ProvenEndedLeg) => void;
307
+ }): Promise<ForeignWriter[]>;
211
308
  /** The leg that holds `sessionId`'s account row (undefined ⇔ no row, or a row without one). */
212
309
  export declare function sessionAccountLeg(docs: MemoryGovernanceDocs, sessionId: string): Promise<string | undefined>;
213
310
  /** The write scope `sessionId`'s account row records — the scope its newest account-opening mount wrote
@@ -227,7 +324,8 @@ export interface SessionUnattributedSet {
227
324
  }
228
325
  export declare function emptyUnattributedSet(): SessionUnattributedSet;
229
326
  /** Open (or re-open, on a same-session resume) the session's account row, persisting the sticky
230
- * unattributed classification frozen at THIS materialize. */
327
+ * unattributed classification frozen at THIS materialize. The leg's holder is the process doing the
328
+ * open (fingerprinted before the ledger's lock is taken). */
231
329
  export declare function openSessionAccount(docs: MemoryGovernanceDocs, input: {
232
330
  sessionId: string;
233
331
  now: () => number;
@@ -269,10 +367,16 @@ export declare function terminateSessionAccount(docs: MemoryGovernanceDocs, inpu
269
367
  }): Promise<SessionAccountWrite>;
270
368
  /** The host valve for a dangling row (advisory; §3.6 — dangling rows never auto-expire). The
271
369
  * close is `closed-unadjudicated` (r7-3): it stops the row dangling but the residue arm keeps
272
- * firing until a full-domain harvest closes normally. `requestId` required (audit, #123). */
370
+ * firing until a full-domain harvest closes normally. `requestId` required (audit, #123).
371
+ *
372
+ * `leg` names the leg the caller means to close — the one a refusal it read named (`null` for a row
373
+ * without one). A row held by any other leg is refused (`memory.session_account_resolve_stale`) and
374
+ * nothing is written: a resume that re-opened the row after the refusal was read is a live writer, and
375
+ * closing it would hand its uncommitted edits to the next restore. */
273
376
  export declare function resolveSessionAccountRecord(docs: MemoryGovernanceDocs, input: {
274
377
  sessionId: string;
275
378
  requestId: string;
379
+ leg: string | null;
276
380
  now: () => number;
277
381
  }): Promise<void>;
278
382
  /** The hold ledger's file: the File store's coordinate of the governance document `holds` (read here only by the
@@ -309,8 +413,6 @@ export interface HoldRow {
309
413
  * custody file and, verified, is what release commits: no verify-reread window). */
310
414
  contentDigest: string;
311
415
  capturedAt: number;
312
- /** The settlement rows whose outcome this hold waits on (the session's pending set at capture). */
313
- settleIds: string[];
314
416
  status: HoldStatus;
315
417
  disposition?: {
316
418
  terminal: HoldTerminal;
@@ -380,7 +482,6 @@ export declare function openInstructionHold(store: HoldStore, input: {
380
482
  baseRev?: string;
381
483
  slug: string;
382
484
  scope: string;
383
- settleIds: readonly string[];
384
485
  now: () => number;
385
486
  /** The caller's act gate on the memory plane (the engine's anchor read), asked immediately before each act this
386
487
  * function performs there: the refusal's text, or `undefined` when the act may proceed. */
@@ -416,8 +517,9 @@ export declare function reconcileHolds(store: HoldStore, input: {
416
517
  actRefused: (path: string, act: string) => string | undefined;
417
518
  }): Promise<void>;
418
519
  /** The quarantine seat of a hold's custody bytes: a function of the ROW, never of a clock. The same
419
- * row names the same seat on every call, in every process, after any crash — the old
420
- * `<ms>-hold-<captureName>` shape with the row's own content digest where the wall clock was. */
520
+ * row names the same seat on every call, in every process, after any crash — the family's one name
521
+ * ({@link quarantineObjectNameOf}) over the row's own content digest and `hold-<captureName>` (a row's
522
+ * captureName is a safe basename, so the label passes through unchanged). */
421
523
  export declare function holdQuarantineNameOf(row: Pick<HoldRow, "captureName" | "contentDigest">): string;
422
524
  /** Dispose one held row: the row records its terminal and the quarantine seat NAMED BY THE ROW
423
525
  * ({@link holdQuarantineNameOf}) first, then the custody bytes move there (host-auditable;
@@ -1,8 +1,10 @@
1
1
  import { createHash } from "node:crypto";
2
+ import { describeRejectedValue } from "../tool-search-setting.js";
2
3
  import { existsSync, linkSync, lstatSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
3
4
  import { dirname, join } from "node:path";
4
- import { appendChallengeEvents, claimStaging, fileGovernanceDocOf, isSameFile, lockedStrictUpdate, mintStagingName, readStrictSidecar, stagingNamePattern, v1MemoryPathKeyResolver, lineageContributionsOfSession, markSessionPolluted, readProjectionDebts, readSessionPollution, putControlObjectOnce, ControlPlaneCorruptError } from "./layout.js";
5
+ import { appendChallengeEvents, claimStaging, fileGovernanceDocOf, isSameFile, lockedStrictUpdate, mintStagingName, readStrictSidecar, stagingNamePattern, v1MemoryPathKeyResolver, lineageContributionsOfSession, markSessionPolluted, readProjectionDebts, readSessionPollution, putControlObjectOnce, quarantineObjectNameOf, ControlPlaneCorruptError } from "./layout.js";
5
6
  import { thrownText } from "../thrown-value.js";
7
+ import { processCensus, processFingerprint, uncheckableProcessText } from "../process-identity.js";
6
8
  import { fileControlObjectDirOf, fileControlObjectFaultCode } from "./control-objects.js";
7
9
  function reqStr(v) {
8
10
  return typeof v === "string" && v.length > 0;
@@ -81,7 +83,7 @@ export async function resolveSettlementRecord(docs, input) {
81
83
  throw e;
82
84
  }
83
85
  if (input.to !== "clean" && input.to !== "external") {
84
- const e = new Error(`resolveSettlement verdict must be "clean" or "external" (got ${JSON.stringify(input.to)}) — refused loudly, never folded.`);
86
+ const e = new Error(`resolveSettlement verdict must be "clean" or "external" (got ${describeRejectedValue(input.to)}) — refused loudly, never folded.`);
85
87
  e.code = "memory.settlement_resolve_invalid";
86
88
  throw e;
87
89
  }
@@ -235,8 +237,23 @@ function malformedAccountRow(row) {
235
237
  (row.closedAt !== undefined && (typeof row.closedAt !== "number" || !Number.isFinite(row.closedAt))) ||
236
238
  (row.terminatedAt !== undefined && (typeof row.terminatedAt !== "number" || !Number.isFinite(row.terminatedAt))) ||
237
239
  (row.leg !== undefined && !reqStr(row.leg)) ||
240
+ (row.holder !== undefined && malformedHolder(row.holder)) ||
238
241
  (row.unadjudicated !== undefined && row.unadjudicated !== true));
239
242
  }
243
+ function malformedHolder(h) {
244
+ if (typeof h !== "object" || h === null || Array.isArray(h))
245
+ return true;
246
+ const x = h;
247
+ const measure = (v) => v === null || (typeof v === "number" && Number.isFinite(v));
248
+ return (!reqStr(x.leg) ||
249
+ typeof x.pid !== "number" ||
250
+ !Number.isSafeInteger(x.pid) ||
251
+ x.pid <= 0 ||
252
+ !measure(x.startedAtMs) ||
253
+ !measure(x.startedSinceBootMs) ||
254
+ !reqStr(x.host) ||
255
+ (x.pidNs !== undefined && !reqStr(x.pidNs)));
256
+ }
240
257
  function isUnattributedMember(x) {
241
258
  return typeof x === "object" && x !== null && reqStr(x.scope) && safeRelPath(x.rel);
242
259
  }
@@ -334,13 +351,100 @@ function sessionAccountsV2(read) {
334
351
  async function readSessionAccounts(docs) {
335
352
  return sessionAccountsV2(coerceSessionAccounts(await docs.readDoc("session-accounts")));
336
353
  }
337
- export async function foreignDanglingSessionAccounts(docs, selfSessionId) {
338
- const rec = await readSessionAccounts(docs);
339
- return rec.rows.filter((r) => r.sessionId !== selfSessionId && (r.closedAt === undefined || r.unadjudicated === true));
354
+ export function legLive(row, census) {
355
+ if (row.writeScope === undefined && row.leg === undefined)
356
+ return row.closedAt === undefined ? { state: "unprovable", why: "no_holder" } : { state: "ended" };
357
+ if (row.terminatedAt !== undefined)
358
+ return { state: "ended" };
359
+ const holder = row.holder;
360
+ if (holder === undefined)
361
+ return { state: "unprovable", why: "no_holder" };
362
+ if (holder.leg !== row.leg)
363
+ return { state: "unprovable", why: "earlier_leg" };
364
+ const verdict = census.verdict(holder);
365
+ if (verdict.state === "gone")
366
+ return { state: "gone", holder };
367
+ return verdict.state === "running" ? { state: "running" } : { state: "unprovable", why: verdict.why };
368
+ }
369
+ export function legUnprovableText(why) {
370
+ switch (why) {
371
+ case "no_holder":
372
+ return "its account records no process for the leg (it was opened by an engine before this one)";
373
+ case "earlier_leg":
374
+ return "the process its account records opened an earlier leg (a later open did not record its own)";
375
+ case "contended":
376
+ return "its account kept changing while it was being checked";
377
+ default:
378
+ return uncheckableProcessText(why);
379
+ }
380
+ }
381
+ export async function foreignWriterCandidates(docs, input) {
382
+ const asked = (r) => !(input.self.leg !== undefined && r.leg === input.self.leg) &&
383
+ !(input.self.sessionId !== undefined && r.sessionId === input.self.sessionId) &&
384
+ (input.layer === undefined || r.writeScope === undefined || r.writeScope === input.layer);
385
+ const candidate = (r, open) => open || r.unadjudicated === true || r.closedAt === undefined || ((r.writeScope !== undefined || r.leg !== undefined) && r.terminatedAt !== undefined && r.terminatedAt > input.since);
386
+ for (let pass = 0;; pass++) {
387
+ const rows = (await readSessionAccounts(docs)).rows.filter(asked);
388
+ const census = processCensus();
389
+ const candidates = [];
390
+ let again = false;
391
+ for (const row of rows) {
392
+ const live = legLive(row, census);
393
+ if (live.state !== "gone") {
394
+ if (candidate(row, live.state !== "ended"))
395
+ candidates.push({ ...row, standing: live });
396
+ continue;
397
+ }
398
+ const at = input.now();
399
+ if ((await endProvenGoneLeg(docs, { sessionId: row.sessionId, holder: live.holder, at })) === "written") {
400
+ input.onEnded({ sessionId: row.sessionId, leg: live.holder.leg, ...(row.writeScope !== undefined ? { writeScope: row.writeScope } : {}) });
401
+ const over = { ...row, terminatedAt: at };
402
+ if (candidate(over, false))
403
+ candidates.push({ ...over, standing: { state: "ended" } });
404
+ continue;
405
+ }
406
+ if (pass === 0) {
407
+ again = true;
408
+ break;
409
+ }
410
+ const { writeScope: _changing, ...anyLayer } = row;
411
+ candidates.push({ ...anyLayer, standing: { state: "unprovable", why: "contended" } });
412
+ }
413
+ if (!again)
414
+ return candidates;
415
+ }
416
+ }
417
+ async function endProvenGoneLeg(docs, input) {
418
+ return docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
419
+ const rec = sessionAccountsV2(read);
420
+ const row = rec.rows.find((r) => r.sessionId === input.sessionId);
421
+ if (row === undefined)
422
+ return { result: "absent" };
423
+ if (row.terminatedAt !== undefined || row.leg !== input.holder.leg || !sameHolder(row.holder, input.holder))
424
+ return { result: "stale" };
425
+ row.terminatedAt = input.at;
426
+ return { next: rec, result: "written" };
427
+ });
428
+ }
429
+ function sameHolder(a, b) {
430
+ return (a !== undefined &&
431
+ a.leg === b.leg &&
432
+ a.pid === b.pid &&
433
+ a.startedAtMs === b.startedAtMs &&
434
+ a.startedSinceBootMs === b.startedSinceBootMs &&
435
+ a.host === b.host &&
436
+ a.pidNs === b.pidNs);
340
437
  }
341
- export async function openLayerWriters(docs, selfLeg) {
342
- const open = (await readSessionAccounts(docs)).rows.filter((r) => (selfLeg === undefined || r.leg !== selfLeg) && (r.writeScope !== undefined ? r.terminatedAt === undefined : r.closedAt === undefined));
343
- return { scopes: new Set(open.flatMap((r) => (r.writeScope !== undefined ? [r.writeScope] : []))), unscoped: open.filter((r) => r.writeScope === undefined).length };
438
+ function holderOf(leg) {
439
+ const fp = processFingerprint();
440
+ return {
441
+ leg,
442
+ pid: fp.pid,
443
+ startedAtMs: fp.startedAtMs,
444
+ startedSinceBootMs: fp.startedSinceBootMs,
445
+ host: fp.host,
446
+ ...(fp.pidNs !== undefined ? { pidNs: fp.pidNs } : {}),
447
+ };
344
448
  }
345
449
  export async function sessionAccountLeg(docs, sessionId) {
346
450
  return (await readSessionAccounts(docs)).rows.find((r) => r.sessionId === sessionId)?.leg;
@@ -356,20 +460,37 @@ function memberKey(scope, rel) {
356
460
  return JSON.stringify([scope, rel]);
357
461
  }
358
462
  export async function openSessionAccount(docs, input) {
463
+ const holder = input.leg !== undefined ? holderOf(input.leg) : undefined;
359
464
  await docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
360
465
  const rec = sessionAccountsV2(read);
361
466
  const row = rec.rows.find((r) => r.sessionId === input.sessionId);
362
- if (row !== undefined && input.writeScope !== undefined)
363
- row.writeScope = input.writeScope;
467
+ if (row !== undefined && input.writeScope !== undefined) {
468
+ const priorOpen = row.closedAt === undefined || row.unadjudicated !== undefined;
469
+ if (!priorOpen)
470
+ row.writeScope = input.writeScope;
471
+ else if (row.writeScope !== input.writeScope)
472
+ delete row.writeScope;
473
+ }
364
474
  if (row !== undefined) {
365
475
  delete row.terminatedAt;
366
476
  if (input.leg !== undefined)
367
477
  row.leg = input.leg;
368
478
  else
369
479
  delete row.leg;
480
+ if (holder !== undefined)
481
+ row.holder = holder;
482
+ else
483
+ delete row.holder;
370
484
  }
371
485
  if (row === undefined) {
372
- rec.rows.push({ sessionId: input.sessionId, openedAt: input.now(), ...(input.writeScope !== undefined ? { writeScope: input.writeScope } : {}), ...(input.leg !== undefined ? { leg: input.leg } : {}), unattributed: [...input.unattributed] });
486
+ rec.rows.push({
487
+ sessionId: input.sessionId,
488
+ openedAt: input.now(),
489
+ ...(input.writeScope !== undefined ? { writeScope: input.writeScope } : {}),
490
+ ...(input.leg !== undefined ? { leg: input.leg } : {}),
491
+ ...(holder !== undefined ? { holder } : {}),
492
+ unattributed: [...input.unattributed],
493
+ });
373
494
  }
374
495
  else if (row.closedAt !== undefined && row.unadjudicated === undefined) {
375
496
  row.openedAt = input.now();
@@ -437,6 +558,14 @@ export async function resolveSessionAccountRecord(docs, input) {
437
558
  e.code = "memory.session_account_resolve_unknown";
438
559
  throw e;
439
560
  }
561
+ const held = row.leg ?? null;
562
+ if (input.leg !== held) {
563
+ const named = typeof input.leg === "string" || input.leg === null ? JSON.stringify(input.leg) : `a ${typeof input.leg}`;
564
+ const e = new Error(`resolveSessionAccount: session ${JSON.stringify(input.sessionId)} is held by leg ${JSON.stringify(held)}, not ${named} — ` +
565
+ `the row was re-opened or never held that leg; nothing was closed (read the refusal again for the leg it names now)`);
566
+ e.code = "memory.session_account_resolve_stale";
567
+ throw e;
568
+ }
440
569
  row.closedAt = input.now();
441
570
  row.unadjudicated = true;
442
571
  row.terminatedAt = row.closedAt;
@@ -472,8 +601,6 @@ function coerceHolds(raw) {
472
601
  !reqStr(row.contentDigest) ||
473
602
  typeof row.capturedAt !== "number" ||
474
603
  !Number.isFinite(row.capturedAt) ||
475
- !Array.isArray(row.settleIds) ||
476
- row.settleIds.some((x) => typeof x !== "string") ||
477
604
  !HOLD_STATUSES.has(row.status) ||
478
605
  (row.disposition !== undefined && (typeof row.disposition !== "object" || row.disposition === null || !HOLD_TERMINALS.has(row.disposition.terminal) || (row.disposition.quarantineName !== undefined && !safeBasename(row.disposition.quarantineName)))) ||
479
606
  (row.resolved !== undefined && row.resolved !== "release" && row.resolved !== "discard") ||
@@ -485,12 +612,13 @@ function coerceHolds(raw) {
485
612
  !safeBasename(row.captureName)) {
486
613
  throw new ControlPlaneCorruptError("memory instruction-hold ledger: a row is malformed — refusing (fail-closed; an unevaluable hold must not read as settled)");
487
614
  }
615
+ const { settleIds: _settleIds, ...current } = row;
488
616
  if (v1) {
489
- const { relPath: _relPath, ...rest } = row;
617
+ const { relPath: _relPath, ...rest } = current;
490
618
  rows.push({ ...rest, rel: `${row.slug}.md` });
491
619
  }
492
620
  else {
493
- rows.push(row);
621
+ rows.push(current);
494
622
  }
495
623
  }
496
624
  return { version: 2, rows };
@@ -627,7 +755,6 @@ export async function openInstructionHold(store, input) {
627
755
  captureName,
628
756
  contentDigest: digest,
629
757
  capturedAt: input.now(),
630
- settleIds: [...input.settleIds],
631
758
  status: "capturing",
632
759
  });
633
760
  return { next: rec, result: undefined };
@@ -947,7 +1074,7 @@ async function adoptOrphanedQuarantineBytes(store, snapshot) {
947
1074
  }
948
1075
  }
949
1076
  export function holdQuarantineNameOf(row) {
950
- return `${row.contentDigest.slice(0, 16)}-hold-${row.captureName}`;
1077
+ return quarantineObjectNameOf({ sha256: row.contentDigest }, `hold-${row.captureName}`);
951
1078
  }
952
1079
  function foreignSeatRefusal(holdId, seatName) {
953
1080
  return new ControlPlaneCorruptError(`memory instruction hold ${holdId}: the quarantine seat ${seatName} is occupied by something that is not the hold's captured bytes — refusing to replace or adopt it (fail-closed; inspect or remove it, and the next harvest converges)`);
@@ -1024,7 +1151,7 @@ export async function resolveHoldRecord(docs, input) {
1024
1151
  throw e;
1025
1152
  }
1026
1153
  if (input.action !== "release" && input.action !== "discard") {
1027
- const e = new Error(`resolveHold action must be "release" or "discard" (got ${JSON.stringify(input.action)}) — refused loudly, never folded.`);
1154
+ const e = new Error(`resolveHold action must be "release" or "discard" (got ${describeRejectedValue(input.action)}) — refused loudly, never folded.`);
1028
1155
  e.code = "memory.hold_resolve_invalid";
1029
1156
  throw e;
1030
1157
  }
@@ -133,7 +133,8 @@ export declare function isAliasModelId(model: string): boolean;
133
133
  * An OpenAI-compatible chat seat over an explicit endpoint. Screened at CONSTRUCTION (the
134
134
  * bad-value loudness law): a missing key, an alias model id or an unservable request root refuses
135
135
  * with a code before any call is made — an alias can be re-pointed upstream and would move the
136
- * driven model with no trace in the archived plan.
136
+ * driven model with no trace in the archived plan. A root the key would reach in the clear across a
137
+ * network (not https, not plain http to this machine) refuses with `config.protocol_plaintext_credentials`.
137
138
  *
138
139
  * The root is judged by {@link assertServableRequestRoot} — the SAME law the brains apply, because
139
140
  * emptiness alone let userinfo, a non-http(s) scheme and a non-URL spelling reach `fetch` as a