@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
@@ -1,4 +1,4 @@
1
- import { type MemoryAnnouncement, type MemoryGovernanceDocName, type MemoryGovernanceDocs } from "./types.js";
1
+ import { type MemoryAnnouncement, type MemoryAttribution, type MemoryGovernanceDocName, type MemoryGovernanceDocs } from "./types.js";
2
2
  import type { AssertAllKeysHandled } from "../ask-origin.js";
3
3
  import { physicalPathOfExisting } from "../physical-path.js";
4
4
  /** Cursor sidecar for the design/84 Seam B pair on the FileBackend (`{ [scope]: cursor }`). B3: control plane. */
@@ -279,9 +279,9 @@ export declare const canonicalize: typeof physicalPathOfExisting;
279
279
  /** True iff `child` (canonicalized) is `root` or inside it. */
280
280
  export declare function isContainedIn(root: string, child: string): boolean;
281
281
  /** The codes the store's physical form refuses an act with — the whole family, one closed set: {@link TARGET_OUTSIDE_STORE},
282
- * {@link SCOPE_HOME_NOT_DIRECTORY}, {@link CONTROL_PLANE_LINKS_UNSUPPORTED} and {@link CONTROL_PLANE_STRAYS}. Each is a plain `Error` carrying `code` and a
282
+ * {@link SCOPE_HOME_NOT_DIRECTORY}, {@link CONTROL_PLANE_LINKS_UNSUPPORTED}, {@link CONTROL_PLANE_STRAYS} and {@link STORE_ROOT_SENSITIVE}. Each is a plain `Error` carrying `code` and a
283
283
  * `detail` ({@link StoreFormRefusalDetail}). */
284
- export declare const STORE_FORM_REFUSAL_CODES: readonly ["memory.target_outside_store", "memory.scope_home_not_directory", "memory.control_plane_links_unsupported", "memory.control_plane_strays"];
284
+ export declare const STORE_FORM_REFUSAL_CODES: readonly ["memory.target_outside_store", "memory.scope_home_not_directory", "memory.control_plane_links_unsupported", "memory.control_plane_strays", "memory.store_root_sensitive"];
285
285
  export type StoreFormRefusalCode = (typeof STORE_FORM_REFUSAL_CODES)[number];
286
286
  /** The code an act on a store path is refused with when it would land outside the store ({@link landsOutsideStore}). */
287
287
  export declare const TARGET_OUTSIDE_STORE = "memory.target_outside_store";
@@ -294,6 +294,9 @@ export declare const CONTROL_PLANE_LINKS_UNSUPPORTED = "memory.control_plane_lin
294
294
  * store over the engine's own control plane, and that control plane still holds carrier records (`controlPlaneStraysRefusal`;
295
295
  * #3484, C-R1119 HB-5): records nobody reads would launder what they recorded, so they are adopted first. */
296
296
  export declare const CONTROL_PLANE_STRAYS = "memory.control_plane_strays";
297
+ /** The code a store root (or the control plane beside it) that lies inside a path the write guard protects is refused with, before anything is
298
+ * created there ({@link assertStoreRootsNotSensitive}): a library written under `~/.ssh` is a library an escalation vector holds. */
299
+ export declare const STORE_ROOT_SENSITIVE = "memory.store_root_sensitive";
297
300
  /** What a scope home can be besides a real directory (an `lstat` verdict). */
298
301
  export declare const SCOPE_HOME_FORMS: readonly ["symlink", "file", "other"];
299
302
  export type ScopeHomeForm = (typeof SCOPE_HOME_FORMS)[number];
@@ -309,14 +312,20 @@ export type HomeFormPhraseCoversEveryForm = AssertAllKeysHandled<Exclude<ScopeHo
309
312
  * `form` is present on {@link SCOPE_HOME_NOT_DIRECTORY} only; `controlDir`, `recorded` and `now` are present
310
313
  * together on a moved store root only ({@link storeRootMovedRefusal}): the control plane whose root anchor
311
314
  * refused (the `controlDir` to hand {@link reanchorMemoryStoreRoot}), the physical root the anchor records,
312
- * and where the root resolves now. */
315
+ * and where the root resolves now; `row` and `of` are present on {@link STORE_ROOT_SENSITIVE} only: the table row the root lands on
316
+ * (a pattern of the write guard's list, as written) and which root it is (`path` is that root's spelling). */
313
317
  export type StoreFormRefusalDetail = {
314
318
  readonly path: string;
315
319
  readonly form?: ScopeHomeForm;
316
320
  readonly controlDir?: string;
317
321
  readonly recorded?: string;
318
322
  readonly now?: string;
323
+ readonly row?: string;
324
+ readonly of?: StoreRootKind;
319
325
  };
326
+ /** Which root a {@link STORE_ROOT_SENSITIVE} refusal is about: the store's own directory, the control plane beside it, or the memory engine root a
327
+ * deployment's host verbs keep their own lock under. */
328
+ export type StoreRootKind = "store" | "control_plane" | "engine_root";
320
329
  /** A refusal the store's physical form earns: a plain `Error` (never the control-plane-damage class —
321
330
  * the engine's own account is intact, the layout it was handed is not the layout it needs) carrying a
322
331
  * `code` and a `detail`. */
@@ -348,6 +357,9 @@ export declare function scopeHomeRefusal(form: ScopeHomeForm, path: string): Sto
348
357
  /** Seat 4 — the control plane at `path` is on a file system that refused a hard link (`fault`: the error code `link`
349
358
  * answered, when it named one). The store publishes every control object with `link`, so it is not opened there. */
350
359
  export declare function controlPlaneLinksRefusal(path: string, fault: string | undefined): StoreFormRefusal;
360
+ /** Seat 6 — a store root (`of: "store"`) or its control plane (`of: "control_plane"`) that lies inside a path the write guard's table protects
361
+ * (`row`: the row it lands on). Not opened and nothing created: the sentence names the row, never the path (`detail.path` is the spelling). */
362
+ export declare function storeRootSensitiveRefusal(of: StoreRootKind, path: string, row: string): StoreFormRefusal;
351
363
  /** Seat 5 — an engine whose backend carries a governance store of its own over a control plane (`path`) that still holds
352
364
  * that carrier's records from before (`strays`: the documents, and the count of entries per object kind): the engine
353
365
  * reads its records through the carrier, so these would be read by nobody — a pollution marker, a hold, a capture
@@ -387,6 +399,22 @@ export declare const ROOT_ANCHOR_FILE = "root-anchor.json";
387
399
  /** What an ABSENT anchor means: a control plane holding nothing records the root (a first open); one already
388
400
  * holding a store backfills while the arm is open and refuses once it is not. */
389
401
  export declare function absentAnchorReading(controlPlaneHoldsStore: boolean, backfillArmOpen?: boolean): "record" | "backfill" | "refuse";
402
+ /**
403
+ * THE judgment of where one root of a memory store may live: not inside a path the write guard's table protects (`sensitiveRowOf` — the
404
+ * `.ssh` / `.aws` / key-file rows of `RECOMMENDED_SENSITIVE_PATTERNS`, the one table, no second list). A library kept under `~/.ssh` is written by
405
+ * the engine's own file I/O, which no write guard sees — the guard judges the model's tool calls, not the store — so the root is a
406
+ * configuration fact to refuse, not a write to gate. Read on the root's spelling and on where it physically lands NOW (a link on its prefix, a
407
+ * missing tail rejoined, as {@link landingPathOf} reads it; never kept between calls — a link retargeted since the last open is read again); a
408
+ * root that cannot be placed is judged on its spelling and says what is wrong at the act that needs it. Throws {@link storeRootSensitiveRefusal}.
409
+ */
410
+ export declare function assertRootNotSensitive(of: StoreRootKind, root: string): void;
411
+ /**
412
+ * The store's two roots through that judgment: its directory and its control plane. Run at the head of {@link anchorStoreRoot}, which every opener
413
+ * (a file backend's construction, an engine's mount) and every anchored face passes before it creates a root or writes under one — and by
414
+ * {@link effectiveControlRootOf} before the one-shot move of a legacy control plane, which is the one write that precedes the anchor head. The
415
+ * transaction lock ({@link tryStoreTxnLock}) judges the plane itself, for the faces that make it before they read the anchor.
416
+ */
417
+ export declare function assertStoreRootsNotSensitive(dir: string, controlDir: string): void;
390
418
  /** Options of {@link anchorStoreRoot}. */
391
419
  export interface AnchorStoreRootOptions {
392
420
  /** Where `memory.root_anchor_backfilled` goes. */
@@ -576,8 +604,10 @@ export declare function writeFileNoFollow(path: string, content: string): void;
576
604
  * write that could not be ATTEMPTED must not read as one that chose not to). `O_EXCL | O_CREAT` is the
577
605
  * atomic form — an `existsSync`-then-write pair is a TOCTOU with exactly the window this closes — and
578
606
  * it refuses a symlink at the final component on its own (POSIX `EEXIST` on a link, dangling or not),
579
- * so the twin's no-follow property is kept without a second check. */
580
- export declare function writeFileNoReplace(path: string, content: string): "written" | "kept";
607
+ * so the twin's no-follow property is kept without a second check. `mode` is the created file's
608
+ * permission bits (under the process umask): a caller putting bytes back into a seat it vacated passes
609
+ * the vacated file's, so the seat's permissions are what they were. */
610
+ export declare function writeFileNoReplace(path: string, content: string, mode?: number): "written" | "kept";
581
611
  /** THE minter of every staging name the engine puts beside a plane file while it is displaced:
582
612
  * `<owner>.staging-<ms>-<pid>-<seq>`. One grammar for every site, so one recognizer
583
613
  * ({@link stagingNamePattern}) knows the names the engine can have left beside a seat. */
@@ -585,8 +615,9 @@ export declare function mintStagingName(owner: string, now: () => number): strin
585
615
  /** The grammar {@link mintStagingName} and {@link claimStaging} write, as a recognizer — of ONE owner's
586
616
  * generations when `owner` is given; otherwise of every staging name an engine has minted beside a seat,
587
617
  * for the two owners it mints them for: an instruction hold (`hold-<ms>-<12 hex>`) and a crash-residue
588
- * capture (`<ms>-residue-<entry id>.md`), whose `<ms>-residue-<id>.md.staging` of 7.55.0 and earlier is
589
- * included (a name already on disk does not lose its owner with an upgrade). A prefix or a bare
618
+ * capture (`<16 hex>-residue-<entry id>.md`, {@link quarantineObjectNameOf}), whose clock-named
619
+ * `<ms>-residue-<id>.md` of earlier releases — and the `<ms>-residue-<id>.md.staging` of 7.55.0 and earlier
620
+ * — are included (a name already on disk does not lose its owner with an upgrade). A prefix or a bare
590
621
  * `.staging-` suffix would adopt any name a writer chose on the strength of its spelling. Minted and
591
622
  * recognised side by side so the two cannot drift. */
592
623
  export declare function stagingNamePattern(owner?: string): RegExp;
@@ -654,18 +685,34 @@ export type QuarantineObjects = Pick<import("./types.js").MemoryGovernanceObject
654
685
  * no readable object explains (a store that fails, an entry that is no object, a name the store refuses) is the put's
655
686
  * own and is thrown. The File store's synchronous paths take its twin, `putFileControlObjectOnce` (`control-objects.ts`). */
656
687
  export declare function putControlObjectOnce(objects: Pick<import("./types.js").MemoryGovernanceObjects, "putObject" | "getObject">, kind: import("./types.js").MemoryControlObjectKind, name: string, bytes: Uint8Array): Promise<"created" | "existed">;
657
- /** The name the copy of the suspect file at `path` is tried under on `attempt` (0…10). codex batch-2 review F2: the
658
- * key is timestamp+basename, and two rejected files can legally share BOTH (same basename under different parents,
659
- * one clock tick — or a test's frozen injected clock), so a capture is written ONCE (a standing name is never
660
- * replaced) and suffixed on collision; bounded — after the numbered tries, one last name keyed by pid+counter (unique
661
- * within this process) either lands or the capture fails. A `\` (legal in a POSIX file name, never in an object name)
662
- * is spelled `%5C`. */
688
+ /** The longest name a store keeps an object under, in UTF-8 bytes — one file name on the file systems the File store runs on. */
689
+ export declare const CONTROL_OBJECT_NAME_MAX_BYTES = 255;
690
+ /** The name of a `quarantine` object, one spelling for every copy the engine keeps there (#2877, C-R983 K2):
691
+ * `<the first 16 hex digits of the SHA-256 of its bytes>-<label>`. The name is a function of the bytes and of what
692
+ * they are a copy of, never of when they were kept, so the same bytes contained again (a withheld file the model
693
+ * writes back at every harvest) meet the copy that already stands and keep no second one. `content` is the bytes, or
694
+ * their SHA-256 in hex when the writer holds only that (a hold's row). The label is the last segment of `source` —
695
+ * the suspect file's path, or a bare label for a copy that has no plane path — with each character that is no part of
696
+ * a legal object name or would read as more than one line (a `\`, legal in a POSIX file name; a NUL; any other control
697
+ * character) spelled as the percent form of its UTF-8 bytes ({@link labelCharSpelled}), and cut between spellings where
698
+ * the name would pass `CONTROL_OBJECT_NAME_MAX_BYTES − 2` bytes (room for a numbered capture name, `.1` … `.9`): a file
699
+ * whose own name is as long as a file name can be still gets its copy, and two copies of the same bytes under one long
700
+ * label still meet. */
701
+ export declare function quarantineObjectNameOf(content: Uint8Array | {
702
+ readonly sha256: string;
703
+ }, source: string): string;
704
+ /** The name a copy is tried under on `attempt` (0…10): its {@link quarantineObjectNameOf} first, then suffixed. Two
705
+ * different copies can share a base (a digest-prefix collision, or a name something else was planted under), so a
706
+ * capture is written ONCE (a standing name is never replaced) and suffixed when the name holds other bytes; bounded —
707
+ * after the numbered tries, one last name keyed by pid+counter (unique within this process) either lands or the
708
+ * capture fails. */
663
709
  export declare function quarantineCaptureName(base: string, attempt: number): string;
664
- /** The base of every capture name for the suspect file at `path`: `<now>-<basename>` ({@link quarantineCaptureName}). */
665
- export declare function quarantineCaptureBase(path: string, now: () => number): string;
666
- /** Keep the copy of the suspect file at `path` (its already-read `content`) as a `quarantine` object of the
667
- * governance store, under the first of its capture names ({@link quarantineCaptureName}) that does not stand yet. */
668
- export declare function captureIntoQuarantine(objects: QuarantineObjects, path: string, content: string, now: () => number): Promise<QuarantineCapture>;
710
+ /** Keep `content` — the already-read bytes of the suspect file at `source`, or of the copy `source` labels (its text,
711
+ * or the raw bytes of a file read as they lie) — as a `quarantine` object of the governance store. A capture name
712
+ * holding exactly these bytes already keeps them: the capture answers that name and writes nothing (one copy however
713
+ * often the same bytes are contained). A name holding other bytes is passed over to the next of the capture names
714
+ * ({@link quarantineCaptureName}). */
715
+ export declare function captureIntoQuarantine(objects: QuarantineObjects, source: string, content: string | Uint8Array): Promise<QuarantineCapture>;
669
716
  /** The governance store's quarantine objects, as an erasure finds and removes them. A reader that must see damage hands
670
717
  * in the store's damage-visible view (`standingControlObjectsOf`, `consolidation.ts`): for the File store its listing
671
718
  * names every entry standing in the kind's directory; any other store's listing is its own (KL-3466-c). */
@@ -1133,6 +1180,11 @@ export interface LineageContribution {
1133
1180
  * challenge (the account travels with the entry). Absence = unmarked content — the sweeps'
1134
1181
  * domain (older vintages read as unmarked, the conservative side). */
1135
1182
  marked?: true;
1183
+ /** `"overlap"` ⇔ this session never committed the entry: it was another live writer of the layer
1184
+ * while a committing session's window ran, so the bytes may be its ({@link MemoryAttribution}).
1185
+ * Such a row carries no incarnation (it binds every occupant of the id). Absent ⇔ the session
1186
+ * committed the entry — an overlap landing on that row later keeps it so ({@link landContribution}). */
1187
+ attribution?: Extract<MemoryAttribution, "overlap">;
1136
1188
  }
1137
1189
  /** One staged (pre-commit) row: an entry this transaction WOULD commit. `kind: "latch-only"` marks
1138
1190
  * a bundle-import SYNTHETIC latch row (design/178 v2-c §1): it withholds the id on the model-visible
@@ -1149,6 +1201,11 @@ export interface LineagePendingRow {
1149
1201
  * at the read face). Absence = the row's content is unmarked (older vintages included) — the
1150
1202
  * conservative side: an unmarked row of a marked session is challenged. */
1151
1203
  marked?: true;
1204
+ /** The session this row is a contribution of, when it is not the transaction's own: another live
1205
+ * writer of the layer in the committing window. Present ⇔ `attribution` is `"overlap"`; the row then
1206
+ * promotes under this session with no incarnation. */
1207
+ sessionId?: string;
1208
+ attribution?: Extract<MemoryAttribution, "overlap">;
1152
1209
  }
1153
1210
  /** One staged transaction: rows land BEFORE `applyPatches`; the commit credential lands after it
1154
1211
  * succeeds; promotion consumes both. A pending txn without a credential is the crash window —
@@ -1253,7 +1310,8 @@ export declare function releaseImportLatch(store: MemoryGovernanceDocs & Pick<im
1253
1310
  * corrupt ledger (integrity unknown ≠ no latch). */
1254
1311
  export declare function lineageLatchedIds(docs: MemoryGovernanceDocs): Promise<Set<string>>;
1255
1312
  /** Every committed contribution of `sessionId` (the pollution-retroaction sweep input, and the
1256
- * erasure lane's sessionId-selector resolver). Throws on a corrupt ledger. Lookups are
1313
+ * erasure lane's sessionId-selector resolver, which keeps only the rows without `attribution` — the
1314
+ * entries the session committed, never those it was only an overlap writer of). Throws on a corrupt ledger. Lookups are
1257
1315
  * OWN-property (the twin law {@link lineageAccountOfEntry} states): a prototype-member sessionId
1258
1316
  * such as "constructor" indexes truthy on EVERY plain object, so a bare lookup would attribute
1259
1317
  * the WHOLE committed set to it — behind the erasure selector that phantom is a whole-store
@@ -1268,6 +1326,7 @@ export declare function lineageContributionsOfSession(docs: MemoryGovernanceDocs
1268
1326
  lastRev: string;
1269
1327
  lastAt: number;
1270
1328
  marked?: true;
1329
+ attribution?: "overlap";
1271
1330
  }>>;
1272
1331
  /** design/178 v2-a §1.3 — the BY-ENTRY lineage account, from ONE parse of the ledger (the
1273
1332
  * by-session read's transpose; the committed set is keyed by entryId, so the index is O(1) after
@@ -1284,6 +1343,7 @@ export declare function lineageAccountOfEntry(docs: MemoryGovernanceDocs, entryI
1284
1343
  sessionId: string;
1285
1344
  lastRev: string;
1286
1345
  lastAt: number;
1346
+ attribution?: "overlap";
1287
1347
  }>;
1288
1348
  pendingLatched: boolean;
1289
1349
  }>;
@@ -1299,9 +1359,10 @@ export declare function clearLineageForEntries(docs: MemoryGovernanceDocs, entry
1299
1359
  * can never write a deleted id's lineage row back (the read and the clear being two separate
1300
1360
  * lock spans was exactly the interleave that both missed a landing contributor and then erased
1301
1361
  * the record of having missed it).
1302
- * Struck pending rows contribute their txn's sessionId to the returned set — EXCEPT rows carrying
1303
- * the structural `kind: "latch-only"` seat (an import protocol's synthetic latch is not a
1304
- * contributing session; the row is still struck). Returns id → contributing session ids
1362
+ * Struck pending rows contribute to the returned set the session the commit path would promote them
1363
+ * under — their own `sessionId` (an overlap row: another live writer's), else their txn's — EXCEPT
1364
+ * rows carrying the structural `kind: "latch-only"` seat (an import protocol's synthetic latch is not
1365
+ * a contributing session; the row is still struck). Returns id → contributing session ids
1305
1366
  * (committed ∪ struck). NON-durable by design: a crash between the caller's journal close and this
1306
1367
  * call loses the return set — the caller's replay re-runs it idempotently and its attestation
1307
1368
  * carries the chain's pre-captured set (honest downgrade, never a fabricated rebuild).
@@ -1334,6 +1395,7 @@ export declare function importLineageCommitted(docs: MemoryGovernanceDocs, rows:
1334
1395
  lastRev: string;
1335
1396
  lastAt: number;
1336
1397
  marked?: true;
1398
+ attribution?: "overlap";
1337
1399
  }>): Promise<LineageImportDivergence[]>;
1338
1400
  /** Full-ledger read (tests / host observability). Throws on corruption. */
1339
1401
  export declare function readLineageRecord(docs: MemoryGovernanceDocs): Promise<{
@@ -1555,9 +1617,9 @@ export declare function writeAllSync(fd: number, data: string): void;
1555
1617
  * is not fsync'd (stores/file/fs-atomic.ts has the dir-fsync variant for stores that need it), so
1556
1618
  * a crash in that window can resurface the old content. Sidecars tolerate that (they are rebuilt
1557
1619
  * or re-derived); do not route data that can't through here. Throws on failure (fail-closed: a
1558
- * sidecar that cannot be written must not be silently skipped). The tmp file is created EXCLUSIVELY and
1559
- * no-follow: a name already standing there (a link or a file somebody placed) is an `EEXIST` refusal,
1560
- * never a file this write truncates or writes through. */
1620
+ * sidecar that cannot be written must not be silently skipped). The tmp file is opened by the one
1621
+ * exclusive opener ({@link openExclusiveTemp}): a name already standing there (a link or a file somebody placed)
1622
+ * is skipped for a fresh one, never a file this write truncates or writes through. */
1561
1623
  export declare function atomicWriteFileSync(path: string, data: string): void;
1562
1624
  /** Content-gated {@link atomicWriteFileSync} for a DERIVED/control-plane file: a byte-identical
1563
1625
  * rewrite (the common case on a repeat mount over an unchanged store) is skipped entirely, so the
@@ -5,7 +5,9 @@ import { createHash, randomUUID } from "node:crypto";
5
5
  import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
6
6
  import { MEMORY_GOVERNANCE_DOC_NAMES, MEMORY_ORIGIN_CAUSES } from "./types.js";
7
7
  import { parseEntryFile } from "./frontmatter.js";
8
+ import { openExclusiveTemp } from "../exclusive-temp.js";
8
9
  import { physicalPathOf, physicalPathOfExisting, priorCallerCasedPathOf } from "../physical-path.js";
10
+ import { sensitiveRowOf } from "../sensitive-path-policy.js";
9
11
  import { thrownLabel, thrownText } from "../thrown-value.js";
10
12
  import { egressText } from "../untrusted-egress.js";
11
13
  import { optionKeys, receiveMembers } from "../own-property-receipt.js";
@@ -168,7 +170,7 @@ export function recordProjectIdHint(configRoot, repoRoot, projectId) {
168
170
  if (hints[key] === projectId.toLowerCase())
169
171
  return;
170
172
  hints[key] = projectId.toLowerCase();
171
- mkdirSync(configRoot, { recursive: true });
173
+ ensureDirExists(configRoot);
172
174
  atomicWriteFileSync(path, `${JSON.stringify(hints, null, 2)}\n`);
173
175
  }
174
176
  catch {
@@ -199,8 +201,10 @@ export function effectiveControlRootOf(dir, opts = {}) {
199
201
  if (opts.controlDir !== undefined)
200
202
  return opts.controlDir;
201
203
  const configRoot = resolveMemoryEngineRoot();
204
+ const control = deriveControlPlaneDir(configRoot, dir);
205
+ assertStoreRootsNotSensitive(dir, control);
202
206
  adoptCanonicalKeyedControlDir(configRoot, dir, opts.onIncident);
203
- return deriveControlPlaneDir(configRoot, dir);
207
+ return control;
204
208
  }
205
209
  export function resolveMemoryEngineRoot(explicit) {
206
210
  const raw = explicit ?? process.env.AGENT_DATA_DIR ?? join(homedir(), ".ai-agent");
@@ -749,17 +753,23 @@ export function isContainedIn(root, child) {
749
753
  const c = canonicalize(child);
750
754
  return c === r || c.startsWith(`${r}${sep}`);
751
755
  }
752
- export const STORE_FORM_REFUSAL_CODES = Object.freeze(["memory.target_outside_store", "memory.scope_home_not_directory", "memory.control_plane_links_unsupported", "memory.control_plane_strays"]);
756
+ export const STORE_FORM_REFUSAL_CODES = Object.freeze(["memory.target_outside_store", "memory.scope_home_not_directory", "memory.control_plane_links_unsupported", "memory.control_plane_strays", "memory.store_root_sensitive"]);
753
757
  export const TARGET_OUTSIDE_STORE = "memory.target_outside_store";
754
758
  export const SCOPE_HOME_NOT_DIRECTORY = "memory.scope_home_not_directory";
755
759
  export const CONTROL_PLANE_LINKS_UNSUPPORTED = "memory.control_plane_links_unsupported";
756
760
  export const CONTROL_PLANE_STRAYS = "memory.control_plane_strays";
761
+ export const STORE_ROOT_SENSITIVE = "memory.store_root_sensitive";
757
762
  export const SCOPE_HOME_FORMS = Object.freeze(["symlink", "file", "other"]);
758
763
  const SCOPE_HOME_FORM_PHRASE = {
759
764
  symlink: "a symbolic link",
760
765
  file: "a regular file",
761
766
  other: "a special file",
762
767
  };
768
+ const STORE_ROOT_WORDS = {
769
+ store: { what: "memory store root", remedy: "point the memory engine root (memoryEngineDir, or the file backend's directory) at a directory outside it" },
770
+ control_plane: { what: "memory control plane", remedy: "point the data root (AGENT_DATA_DIR, or the backend's controlDir) at a directory outside it" },
771
+ engine_root: { what: "memory engine root", remedy: "point the memory engine root (memoryEngineDir, or AGENT_DATA_DIR) at a directory outside it" },
772
+ };
763
773
  function storeFormRefusal(code, sentence, detail) {
764
774
  const e = new Error(`${code}: ${sentence}`);
765
775
  e.code = code;
@@ -781,6 +791,10 @@ export function scopeHomeRefusal(form, path) {
781
791
  export function controlPlaneLinksRefusal(path, fault) {
782
792
  return storeFormRefusal(CONTROL_PLANE_LINKS_UNSUPPORTED, `the memory control plane is on a file system that cannot make hard links (link answered ${fault ?? "an error with no code"}) — the store publishes its control objects (quarantine copies, held files, pollution markers) with link, so it is not opened and no entry or control object was written; move the control plane (controlDir, or the memory engine root) to a volume that supports hard links`, { path });
783
793
  }
794
+ export function storeRootSensitiveRefusal(of, path, row) {
795
+ const { what, remedy } = STORE_ROOT_WORDS[of];
796
+ return storeFormRefusal(STORE_ROOT_SENSITIVE, `the ${what} is inside a path the write guard protects (its \`${row}\` row) — a library kept there is a library that path's escalation vector holds, so it is refused (fail-closed) and nothing was created or written; ${remedy}`, { path, row, of });
797
+ }
784
798
  export function controlPlaneStraysRefusal(path, strays) {
785
799
  const named = [...strays.docs.map((d) => `the ${d} document`), ...Object.entries(strays.objects).map(([kind, n]) => `${n} ${kind} entr${n === 1 ? "y" : "ies"}`)];
786
800
  return storeFormRefusal(CONTROL_PLANE_STRAYS, `the memory backend carries its own governance store, and the engine's control plane still holds that store's records from before (${named.join(", ")}) — they would be read by nobody, so the engine is not opened and nothing was written; adopt them into the carrier first (adoptReplicaControlPlane(detail.path, <the backend's governance store>), which removes each one it hands over), then reopen`, { path });
@@ -893,7 +907,25 @@ function writeStoreRootAnchor(controlDir, lock, token, anchor) {
893
907
  assertSidecarLockOwnership(lock, token, "memory store root anchor", "strict");
894
908
  atomicWriteFileSync(join(controlDir, ROOT_ANCHOR_FILE), `${JSON.stringify(anchor, null, 2)}\n`);
895
909
  }
910
+ export function assertRootNotSensitive(of, root) {
911
+ const spellings = [resolve(root)];
912
+ try {
913
+ const landed = landingPathOf(root);
914
+ if (landed !== spellings[0])
915
+ spellings.push(landed);
916
+ }
917
+ catch {
918
+ }
919
+ const row = sensitiveRowOf(spellings);
920
+ if (row !== undefined)
921
+ throw storeRootSensitiveRefusal(of, root, row);
922
+ }
923
+ export function assertStoreRootsNotSensitive(dir, controlDir) {
924
+ assertRootNotSensitive("store", dir);
925
+ assertRootNotSensitive("control_plane", controlDir);
926
+ }
896
927
  export function anchorStoreRoot(dir, controlDir, opts = {}) {
928
+ assertStoreRootsNotSensitive(dir, controlDir);
897
929
  const anchor = readStoreRootAnchor(controlDir, dir);
898
930
  if (anchor !== undefined)
899
931
  return judgeAgainstAnchor(dir, controlDir, anchor);
@@ -925,19 +957,20 @@ export const TXN_LOCK_STALE_MS = 30_000;
925
957
  const TXN_LOCK_WAIT_MS = 15_000;
926
958
  const TXN_LOCK_STEAL_GRACE_MS = 250;
927
959
  export function tryStoreTxnLock(controlDir, opts) {
960
+ assertRootNotSensitive("control_plane", controlDir);
928
961
  const lockDir = join(controlDir, STORE_TXN_LOCK_DIR);
929
962
  const ownerPath = join(lockDir, "owner");
930
963
  const staleMs = opts.staleMs ?? TXN_LOCK_STALE_MS;
931
964
  const faultText = (err) => err.code ?? "io error";
932
965
  const tryMkdir = () => {
933
966
  try {
934
- mkdirSync(controlDir, { recursive: true });
967
+ mkdirSync(controlDir, { recursive: true, mode: 0o700 });
935
968
  }
936
969
  catch (err) {
937
970
  throw new ControlPlaneCorruptError(`memory control-plane root could not be created (${faultText(err)}) at ${controlDir} — a lock-acquisition fault is not contention (fail-closed)`, { cause: err });
938
971
  }
939
972
  try {
940
- mkdirSync(lockDir);
973
+ mkdirSync(lockDir, { mode: 0o700 });
941
974
  return true;
942
975
  }
943
976
  catch (err) {
@@ -1005,7 +1038,7 @@ export function tryStoreTxnLock(controlDir, opts) {
1005
1038
  }
1006
1039
  const token = randomUUID();
1007
1040
  try {
1008
- const fd = openSync(ownerPath, "w", 0o600);
1041
+ const fd = openSync(ownerPath, "wx", 0o600);
1009
1042
  try {
1010
1043
  writeAllSync(fd, token);
1011
1044
  fsyncSync(fd);
@@ -1210,10 +1243,10 @@ export function writeFileNoFollow(path, content) {
1210
1243
  if (names > 1)
1211
1244
  atomicWriteFileSync(path, content);
1212
1245
  }
1213
- export function writeFileNoReplace(path, content) {
1246
+ export function writeFileNoReplace(path, content, mode = 0o644) {
1214
1247
  let fd;
1215
1248
  try {
1216
- fd = openSync(path, O_WRONLY | O_CREAT | O_EXCL | O_NOFOLLOW, 0o644);
1249
+ fd = openSync(path, O_WRONLY | O_CREAT | O_EXCL | O_NOFOLLOW, mode);
1217
1250
  }
1218
1251
  catch (err) {
1219
1252
  if (err.code === "EEXIST")
@@ -1235,7 +1268,7 @@ export function mintStagingName(owner, now) {
1235
1268
  }
1236
1269
  export function stagingNamePattern(owner) {
1237
1270
  const head = owner === undefined
1238
- ? String.raw `(?:hold-\d+-[0-9a-f]{12}\.staging-\d+-\d+-\d+|\d+-residue-[^/]+\.md\.staging(?:-\d+-\d+-\d+)?)`
1271
+ ? String.raw `(?:hold-\d+-[0-9a-f]{12}\.staging-\d+-\d+-\d+|(?:\d+|[0-9a-f]{16})-residue-[^/]+\.md\.staging(?:-\d+-\d+-\d+)?)`
1239
1272
  : String.raw `${owner.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\.staging-\d+-\d+-\d+`;
1240
1273
  return new RegExp(String.raw `^${head}(?:\.claim-\d+-\d+)*$`);
1241
1274
  }
@@ -1340,20 +1373,40 @@ export async function putControlObjectOnce(objects, kind, name, bytes) {
1340
1373
  return "existed";
1341
1374
  }
1342
1375
  }
1376
+ export const CONTROL_OBJECT_NAME_MAX_BYTES = 255;
1377
+ export function quarantineObjectNameOf(content, source) {
1378
+ const digest = content instanceof Uint8Array ? createHash("sha256").update(content).digest("hex") : content.sha256;
1379
+ const head = `${digest.slice(0, 16)}-`;
1380
+ let room = CONTROL_OBJECT_NAME_MAX_BYTES - 2 - Buffer.byteLength(head, "utf8");
1381
+ let label = "";
1382
+ for (const char of basename(source)) {
1383
+ const spelled = labelCharSpelled(char);
1384
+ room -= Buffer.byteLength(spelled, "utf8");
1385
+ if (room < 0)
1386
+ break;
1387
+ label += spelled;
1388
+ }
1389
+ return head + label;
1390
+ }
1391
+ function labelCharSpelled(char) {
1392
+ if (!/[\p{Cc}\\]/u.test(char))
1393
+ return char;
1394
+ return [...Buffer.from(char, "utf8")].map((byte) => `%${byte.toString(16).toUpperCase().padStart(2, "0")}`).join("");
1395
+ }
1343
1396
  export function quarantineCaptureName(base, attempt) {
1344
1397
  return attempt === 0 ? base : attempt < 10 ? `${base}.${attempt}` : `${base}.${process.pid}.${quarantineSeq++}`;
1345
1398
  }
1346
- export function quarantineCaptureBase(path, now) {
1347
- return `${now()}-${basename(path).replace(/\\/g, "%5C")}`;
1348
- }
1349
- export async function captureIntoQuarantine(objects, path, content, now) {
1350
- const bytes = new TextEncoder().encode(content);
1351
- const base = quarantineCaptureBase(path, now);
1399
+ export async function captureIntoQuarantine(objects, source, content) {
1400
+ const bytes = typeof content === "string" ? new TextEncoder().encode(content) : content;
1401
+ const base = quarantineObjectNameOf(bytes, source);
1352
1402
  try {
1353
1403
  for (let attempt = 0; attempt <= 10; attempt++) {
1354
1404
  const name = quarantineCaptureName(base, attempt);
1355
1405
  if ((await putControlObjectOnce(objects, "quarantine", name, bytes)) === "created")
1356
1406
  return { name };
1407
+ const standing = await objects.getObject("quarantine", name);
1408
+ if (standing !== undefined && Buffer.from(standing).equals(bytes))
1409
+ return { name };
1357
1410
  }
1358
1411
  return { failed: "quarantine copy failed: every capture name already stands" };
1359
1412
  }
@@ -1617,11 +1670,11 @@ export function acquireSidecarLock(lockDir, opts = {}) {
1617
1670
  };
1618
1671
  for (;;) {
1619
1672
  try {
1620
- mkdirSync(lockDir);
1673
+ mkdirSync(lockDir, { mode: 0o700 });
1621
1674
  const token = mintToken();
1622
1675
  let fd;
1623
1676
  try {
1624
- fd = openSync(join(lockDir, "owner"), "w");
1677
+ fd = openSync(join(lockDir, "owner"), "wx", 0o600);
1625
1678
  writeAllSync(fd, token);
1626
1679
  }
1627
1680
  catch {
@@ -2426,6 +2479,15 @@ export function readStrictSidecar(controlDir, fileName, what) {
2426
2479
  }
2427
2480
  return readStrictSidecarRaw(file, what);
2428
2481
  }
2482
+ function landContribution(sessions, sessionId, incoming) {
2483
+ const standing = Object.prototype.hasOwnProperty.call(sessions, sessionId) ? sessions[sessionId] : undefined;
2484
+ if (incoming.attribution !== undefined && standing !== undefined && standing.attribution === undefined) {
2485
+ const { attribution: _overlap, ...asWriter } = incoming;
2486
+ sessions[sessionId] = asWriter;
2487
+ return;
2488
+ }
2489
+ sessions[sessionId] = incoming;
2490
+ }
2429
2491
  function coerceLineage(raw) {
2430
2492
  if (raw === undefined) {
2431
2493
  return { version: 1, committed: Object.create(null), pending: Object.create(null) };
@@ -2453,6 +2515,9 @@ function coerceLineage(raw) {
2453
2515
  if (!isIncarnationSeat(row.incarnation)) {
2454
2516
  throw badShape(`committed[${JSON.stringify(entryId)}][${JSON.stringify(sid)}] incarnation`);
2455
2517
  }
2518
+ if (row.attribution !== undefined && row.attribution !== "overlap") {
2519
+ throw badShape(`committed[${JSON.stringify(entryId)}][${JSON.stringify(sid)}] attribution`);
2520
+ }
2456
2521
  }
2457
2522
  }
2458
2523
  for (const [txnId, t] of Object.entries(r.pending)) {
@@ -2468,6 +2533,9 @@ function coerceLineage(raw) {
2468
2533
  const p = row;
2469
2534
  if (!p || typeof p !== "object" || typeof p.entryId !== "string" || typeof p.rev !== "string")
2470
2535
  throw badShape(`pending[${JSON.stringify(txnId)}] row`);
2536
+ if ((p.sessionId === undefined) !== (p.attribution === undefined) || (p.sessionId !== undefined && (typeof p.sessionId !== "string" || p.sessionId.length === 0)) || (p.attribution !== undefined && p.attribution !== "overlap")) {
2537
+ throw badShape(`pending[${JSON.stringify(txnId)}] row attribution`);
2538
+ }
2471
2539
  if (p.kind !== undefined && p.kind !== "latch-only")
2472
2540
  throw badShape(`pending[${JSON.stringify(txnId)}] row kind`);
2473
2541
  if (p.marked !== undefined && p.marked !== true)
@@ -2515,6 +2583,12 @@ export async function recordLineageCredential(docs, txnId, appliedIds, now) {
2515
2583
  return { next: rec, result: undefined };
2516
2584
  });
2517
2585
  }
2586
+ function promotedContribution(txn, row, at) {
2587
+ const marked = row.marked === true ? { marked: true } : {};
2588
+ if (row.sessionId !== undefined)
2589
+ return { sessionId: row.sessionId, contribution: { lastRev: row.rev, lastAt: at, ...marked, attribution: "overlap" } };
2590
+ return { sessionId: txn.sessionId, contribution: { lastRev: row.rev, lastAt: at, ...marked, ...(txn.incarnation !== undefined ? { incarnation: txn.incarnation } : {}) } };
2591
+ }
2518
2592
  export async function promoteLineagePending(docs, txnId) {
2519
2593
  return docs.updateDoc("lineage", coerceLineage, (rec) => {
2520
2594
  const txn = rec.pending[txnId];
@@ -2530,8 +2604,9 @@ export async function promoteLineagePending(docs, txnId) {
2530
2604
  if (!applied.has(row.entryId))
2531
2605
  continue;
2532
2606
  const sessions = (rec.committed[row.entryId] ??= Object.create(null));
2533
- sessions[txn.sessionId] = { lastRev: row.rev, lastAt: at, ...(row.marked === true ? { marked: true } : {}), ...(txn.incarnation !== undefined ? { incarnation: txn.incarnation } : {}) };
2534
- promoted.push({ entryId: row.entryId, sessionId: txn.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
2607
+ const promotion = promotedContribution(txn, row, at);
2608
+ landContribution(sessions, promotion.sessionId, promotion.contribution);
2609
+ promoted.push({ entryId: row.entryId, sessionId: promotion.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
2535
2610
  }
2536
2611
  delete rec.pending[txnId];
2537
2612
  return { next: rec, result: promoted };
@@ -2556,8 +2631,9 @@ export async function adjudicateLineagePending(docs, txnId, action, now) {
2556
2631
  if (applied !== undefined && !applied.has(row.entryId))
2557
2632
  continue;
2558
2633
  const sessions = (rec.committed[row.entryId] ??= Object.create(null));
2559
- sessions[txn.sessionId] = { lastRev: row.rev, lastAt: at, ...(row.marked === true ? { marked: true } : {}), ...(txn.incarnation !== undefined ? { incarnation: txn.incarnation } : {}) };
2560
- promoted.push({ entryId: row.entryId, sessionId: txn.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
2634
+ const promotion = promotedContribution(txn, row, at);
2635
+ landContribution(sessions, promotion.sessionId, promotion.contribution);
2636
+ promoted.push({ entryId: row.entryId, sessionId: promotion.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
2561
2637
  }
2562
2638
  delete rec.pending[txnId];
2563
2639
  return { next: rec, result: promoted };
@@ -2578,8 +2654,9 @@ export async function reconcileLineage(docs) {
2578
2654
  if (!applied.has(row.entryId))
2579
2655
  continue;
2580
2656
  const sessions = (rec.committed[row.entryId] ??= Object.create(null));
2581
- sessions[txn.sessionId] = { lastRev: row.rev, lastAt: txn.credential.at, ...(row.marked === true ? { marked: true } : {}), ...(txn.incarnation !== undefined ? { incarnation: txn.incarnation } : {}) };
2582
- promoted.push({ entryId: row.entryId, sessionId: txn.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
2657
+ const promotion = promotedContribution(txn, row, txn.credential.at);
2658
+ landContribution(sessions, promotion.sessionId, promotion.contribution);
2659
+ promoted.push({ entryId: row.entryId, sessionId: promotion.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
2583
2660
  }
2584
2661
  delete rec.pending[txnId];
2585
2662
  changed = true;
@@ -2658,14 +2735,14 @@ export async function lineageContributionsOfSession(docs, sessionId, asking) {
2658
2735
  const c = Object.prototype.hasOwnProperty.call(sessions, sessionId) ? sessions[sessionId] : undefined;
2659
2736
  if (c === undefined || !sessionRecordBindsIncarnation(c.incarnation, asking))
2660
2737
  continue;
2661
- out.push({ entryId, lastRev: c.lastRev, lastAt: c.lastAt, ...(c.marked === true ? { marked: true } : {}) });
2738
+ out.push({ entryId, lastRev: c.lastRev, lastAt: c.lastAt, ...(c.marked === true ? { marked: true } : {}), ...(c.attribution !== undefined ? { attribution: c.attribution } : {}) });
2662
2739
  }
2663
2740
  return out;
2664
2741
  }
2665
2742
  export async function lineageAccountOfEntry(docs, entryId) {
2666
2743
  const rec = coerceLineage(await docs.readDoc("lineage"));
2667
2744
  const sessions = Object.prototype.hasOwnProperty.call(rec.committed, entryId) ? rec.committed[entryId] : undefined;
2668
- const contributors = sessions === undefined ? [] : Object.entries(sessions).map(([sessionId, c]) => ({ sessionId, lastRev: c.lastRev, lastAt: c.lastAt }));
2745
+ const contributors = sessions === undefined ? [] : Object.entries(sessions).map(([sessionId, c]) => ({ sessionId, lastRev: c.lastRev, lastAt: c.lastAt, ...(c.attribution !== undefined ? { attribution: c.attribution } : {}) }));
2669
2746
  let pendingLatched = false;
2670
2747
  for (const txn of Object.values(rec.pending)) {
2671
2748
  if (txn.rows.some((r) => r.entryId === entryId)) {
@@ -2718,7 +2795,7 @@ export async function captureAndClearLineageForEntries(docs, entryIds) {
2718
2795
  }
2719
2796
  changed = true;
2720
2797
  if (row.kind !== "latch-only")
2721
- add(row.entryId, txn.sessionId);
2798
+ add(row.entryId, row.sessionId ?? txn.sessionId);
2722
2799
  }
2723
2800
  txn.rows = keep;
2724
2801
  }
@@ -2738,7 +2815,7 @@ export async function importLineageCommitted(docs, rows) {
2738
2815
  const sessions = (rec.committed[row.entryId] ??= Object.create(null));
2739
2816
  const standing = Object.prototype.hasOwnProperty.call(sessions, row.sessionId) ? sessions[row.sessionId] : undefined;
2740
2817
  if (standing === undefined || row.lastAt > standing.lastAt) {
2741
- sessions[row.sessionId] = { lastRev: row.lastRev, lastAt: row.lastAt, ...(row.marked === true ? { marked: true } : {}) };
2818
+ landContribution(sessions, row.sessionId, { lastRev: row.lastRev, lastAt: row.lastAt, ...(row.marked === true ? { marked: true } : {}), ...(row.attribution === "overlap" ? { attribution: "overlap" } : {}) });
2742
2819
  changed = true;
2743
2820
  continue;
2744
2821
  }
@@ -3099,8 +3176,7 @@ export function writeAllSync(fd, data) {
3099
3176
  }
3100
3177
  export function atomicWriteFileSync(path, data) {
3101
3178
  ensureDirExists(dirname(path));
3102
- const tmp = join(dirname(path), `${ATOMIC_WRITE_TMP_PREFIX}${process.pid}-${Math.random().toString(36).slice(2, 10)}`);
3103
- const fd = openSync(tmp, O_WRONLY | O_CREAT | O_EXCL | O_NOFOLLOW, 0o600);
3179
+ const { fd, path: tmp } = openExclusiveTemp(join(dirname(path), ATOMIC_WRITE_TMP_PREFIX));
3104
3180
  try {
3105
3181
  writeAllSync(fd, data);
3106
3182
  fsyncSync(fd);
@@ -1,10 +1,10 @@
1
1
  import { join } from "node:path";
2
2
  import { MemoryEngine } from "./engine.js";
3
3
  import { derivePersonalControlDir, derivePersonalMemoryDir, directoryPinOf, judgeMemoryStoreSeat, memoryPlaneStore, memoryScopePlaneOf, mergeErasureAttestations, refuseMemoryStoreInput } from "./dual-root.js";
4
- import { acquireStoreTxnLock, assertStoreTxnLockOwnership, ControlPlaneCorruptError, renewStoreTxnLock, resolveMemoryEngineRoot, storeHoldsRecord, storeOpenArtifactFault, TXN_LOCK_STALE_MS } from "./layout.js";
4
+ import { acquireStoreTxnLock, assertRootNotSensitive, assertStoreTxnLockOwnership, ControlPlaneCorruptError, renewStoreTxnLock, resolveMemoryEngineRoot, storeHoldsRecord, storeOpenArtifactFault, TXN_LOCK_STALE_MS } from "./layout.js";
5
5
  import { captureErasureInput, erasureRequestInvalid, erasureSelectHash } from "./file-backend.js";
6
6
  import { canonicalExpectedScopes } from "./export-bundle.js";
7
- import { thrownLabel, thrownText } from "../thrown-value.js";
7
+ import { isEngineCodeShape, thrownLabel, thrownText } from "../thrown-value.js";
8
8
  import { chooseSessionWriteHome } from "./session-write-home.js";
9
9
  const FACE = "createMemoryDeployment";
10
10
  export const MEMORY_DEPLOYMENT_ERASURE_LOCK_DIR = ".memory-erasure-judge";
@@ -48,6 +48,7 @@ export function createMemoryDeployment(input) {
48
48
  refuseMemoryStoreInput(FACE, "the backend publishes no control plane (controlPlaneRoot) — a session's memory facts then live in per-project control planes no deployment-wide reading can name", backend);
49
49
  }
50
50
  const engineRoot = resolveMemoryEngineRoot(input.memoryEngineDir);
51
+ assertRootNotSensitive("engine_root", engineRoot);
51
52
  const pinned = directoryPinOf(backend) !== undefined;
52
53
  const seatOf = (plane, store) => {
53
54
  const controlDir = controlOf(store);
@@ -208,12 +209,11 @@ async function anchorOf(store, requestId) {
208
209
  return undefined;
209
210
  throw coded("eraseMemoryEntries: another store of this deployment has an erasure-evidence face but no anchor read (erasureAnchorOf), so whether it already executed this requestId cannot be judged — nothing was deleted", "memory.erasure_evidence_unavailable");
210
211
  }
211
- const ERRNO_CODE = /^E[A-Z0-9]+$/;
212
212
  function personalOpenFault(err, mount) {
213
213
  if (err instanceof ControlPlaneCorruptError)
214
214
  return err;
215
215
  const code = err?.code;
216
- if (typeof code === "string" && !ERRNO_CODE.test(code))
216
+ if (typeof code === "string" && isEngineCodeShape(code))
217
217
  return err;
218
218
  return new ControlPlaneCorruptError(`the personal plane's memory store at ${mount} could not be opened (${typeof code === "string" ? code : thrownLabel(err)}): ${thrownText(err)}`, { cause: err });
219
219
  }