@sema-agent/core 7.61.0 → 7.63.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 (298) hide show
  1. package/CHANGELOG.md +840 -0
  2. package/dist/agents/cascade.d.ts +11 -3
  3. package/dist/agents/cascade.js +1 -1
  4. package/dist/agents/peer-held-queue.d.ts +27 -4
  5. package/dist/agents/peer-held-queue.js +81 -36
  6. package/dist/agents/peer-session-drain.js +13 -3
  7. package/dist/agents/subagent-transcript-placement.d.ts +23 -0
  8. package/dist/agents/subagent-transcript-placement.js +14 -0
  9. package/dist/agents/subagent.d.ts +6 -1
  10. package/dist/agents/subagent.js +143 -58
  11. package/dist/agents/suspend-guard.d.ts +38 -16
  12. package/dist/agents/suspend-guard.js +9 -4
  13. package/dist/agents/verify.js +4 -3
  14. package/dist/brain/route-adjudicator.js +9 -4
  15. package/dist/core/approval-object.js +1 -1
  16. package/dist/core/arg-summary.js +1 -1
  17. package/dist/core/ask-question.d.ts +2 -2
  18. package/dist/core/canonical-json.d.ts +23 -13
  19. package/dist/core/canonical-json.js +4 -4
  20. package/dist/core/checkpoint-features.d.ts +722 -0
  21. package/dist/core/checkpoint-features.js +98 -0
  22. package/dist/core/checkpoint-queries.d.ts +47 -4
  23. package/dist/core/checkpoint-queries.js +36 -16
  24. package/dist/core/checkpoint-requirements.d.ts +12 -5
  25. package/dist/core/checkpoint-requirements.js +11 -5
  26. package/dist/core/checkpoint-row-verdict.d.ts +110 -0
  27. package/dist/core/checkpoint-row-verdict.js +245 -0
  28. package/dist/core/checkpoint-store.d.ts +76 -753
  29. package/dist/core/checkpoint-store.js +83 -144
  30. package/dist/core/compliance.d.ts +6 -2
  31. package/dist/core/compliance.js +3 -3
  32. package/dist/core/engine-attestation.d.ts +1 -1
  33. package/dist/core/engine-notice.d.ts +38 -7
  34. package/dist/core/engine-notice.js +9 -2
  35. package/dist/core/gate-fold.js +2 -2
  36. package/dist/core/git-worktree-env.d.ts +62 -3
  37. package/dist/core/git-worktree-env.js +91 -30
  38. package/dist/core/governance-codes.d.ts +9 -3
  39. package/dist/core/governance-codes.js +16 -3
  40. package/dist/core/hooks.d.ts +13 -0
  41. package/dist/core/human-input-projection.d.ts +1 -0
  42. package/dist/core/human-input-projection.js +3 -0
  43. package/dist/core/image-admission.d.ts +1 -1
  44. package/dist/core/locked-config.d.ts +2 -2
  45. package/dist/core/mcp-host-seat.js +6 -1
  46. package/dist/core/memory-engine/consolidation-driver.d.ts +33 -18
  47. package/dist/core/memory-engine/consolidation-driver.js +99 -98
  48. package/dist/core/memory-engine/consolidation.d.ts +73 -10
  49. package/dist/core/memory-engine/consolidation.js +167 -11
  50. package/dist/core/memory-engine/data-plane.d.ts +8 -4
  51. package/dist/core/memory-engine/data-plane.js +11 -6
  52. package/dist/core/memory-engine/delegation-settlement.d.ts +37 -35
  53. package/dist/core/memory-engine/delegation-settlement.js +53 -59
  54. package/dist/core/memory-engine/dual-root.d.ts +12 -6
  55. package/dist/core/memory-engine/dual-root.js +9 -5
  56. package/dist/core/memory-engine/engine.d.ts +98 -35
  57. package/dist/core/memory-engine/engine.js +477 -380
  58. package/dist/core/memory-engine/entry-scan.d.ts +8 -0
  59. package/dist/core/memory-engine/entry-scan.js +3 -0
  60. package/dist/core/memory-engine/file-backend.d.ts +29 -3
  61. package/dist/core/memory-engine/file-backend.js +66 -35
  62. package/dist/core/memory-engine/index.d.ts +7 -7
  63. package/dist/core/memory-engine/index.js +6 -6
  64. package/dist/core/memory-engine/landing-admission.d.ts +5 -3
  65. package/dist/core/memory-engine/landing-admission.js +3 -3
  66. package/dist/core/memory-engine/layout.d.ts +121 -45
  67. package/dist/core/memory-engine/layout.js +252 -102
  68. package/dist/core/memory-engine/memory-backend-contract.d.ts +19 -1
  69. package/dist/core/memory-engine/memory-backend-contract.js +320 -0
  70. package/dist/core/memory-engine/memory-deployment.d.ts +31 -8
  71. package/dist/core/memory-engine/memory-deployment.js +26 -12
  72. package/dist/core/memory-engine/scope-contract.d.ts +52 -11
  73. package/dist/core/memory-engine/scope-contract.js +68 -19
  74. package/dist/core/memory-engine/session-write-home.d.ts +3 -1
  75. package/dist/core/memory-engine/session-write-home.js +1 -1
  76. package/dist/core/memory-engine/sync-client.d.ts +3 -1
  77. package/dist/core/memory-engine/sync-client.js +7 -0
  78. package/dist/core/memory-engine/sync-report.d.ts +3 -2
  79. package/dist/core/memory-engine/sync-report.js +6 -2
  80. package/dist/core/memory-engine/tools.d.ts +2 -2
  81. package/dist/core/memory-engine/tools.js +10 -10
  82. package/dist/core/memory-engine/types.d.ts +118 -19
  83. package/dist/core/memory-engine/types.js +1 -0
  84. package/dist/core/memory-vector.d.ts +1 -1
  85. package/dist/core/memory.d.ts +10 -10
  86. package/dist/core/memory.js +15 -6
  87. package/dist/core/mode-policy.js +1 -1
  88. package/dist/core/mods/classic-events.d.ts +9 -1
  89. package/dist/core/mods/dollar.d.ts +32 -1
  90. package/dist/core/mods/dollar.js +13 -1
  91. package/dist/core/mods/kernel/events.d.ts +11 -3
  92. package/dist/core/mods/kernel/events.js +13 -10
  93. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  94. package/dist/core/mods/lifecycle-stations.js +44 -9
  95. package/dist/core/mods/session-append.d.ts +4 -1
  96. package/dist/core/mods/session-append.js +7 -0
  97. package/dist/core/mods/session-receive.js +12 -15
  98. package/dist/core/mods/stations.d.ts +70 -6
  99. package/dist/core/mods/stations.js +144 -1
  100. package/dist/core/own-property-receipt.d.ts +7 -0
  101. package/dist/core/own-property-receipt.js +3 -0
  102. package/dist/core/park-selfcheck.js +2 -2
  103. package/dist/core/pause-registry.d.ts +2 -0
  104. package/dist/core/pause-registry.js +3 -0
  105. package/dist/core/permission-rule-consent.d.ts +10 -3
  106. package/dist/core/permission-rule-consent.js +37 -24
  107. package/dist/core/permission-rule-store.d.ts +35 -1
  108. package/dist/core/permission-rule-store.js +27 -8
  109. package/dist/core/read-only-shell.js +3 -2
  110. package/dist/core/read-root-candidate.js +1 -1
  111. package/dist/core/redaction-marks.d.ts +8 -0
  112. package/dist/core/redaction-marks.js +6 -0
  113. package/dist/core/remote-env.d.ts +12 -1
  114. package/dist/core/remote-env.js +3 -0
  115. package/dist/core/resume-startup-cause.d.ts +5 -4
  116. package/dist/core/runner/child-tree.d.ts +29 -3
  117. package/dist/core/runner/child-tree.js +39 -16
  118. package/dist/core/runner/compact-session.js +5 -2
  119. package/dist/core/runner/contracts.d.ts +36 -17
  120. package/dist/core/runner/delegation-owner.d.ts +43 -0
  121. package/dist/core/runner/delegation-owner.js +59 -0
  122. package/dist/core/runner/gate-exit.js +2 -2
  123. package/dist/core/runner/inherited-ask-grants.js +1 -1
  124. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  125. package/dist/core/runner/lineage-reroot-view.js +108 -0
  126. package/dist/core/runner/memory-consolidation-driver.d.ts +6 -3
  127. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  128. package/dist/core/runner/memory-consolidation-write-judge.d.ts +2 -1
  129. package/dist/core/runner/memory-consolidation-write-judge.js +3 -2
  130. package/dist/core/runner/permission-rule-lanes.d.ts +2 -1
  131. package/dist/core/runner/permission-rule-lanes.js +2 -2
  132. package/dist/core/runner/person-path-rows.d.ts +23 -3
  133. package/dist/core/runner/person-path-rows.js +31 -4
  134. package/dist/core/runner/placement-fence.d.ts +12 -0
  135. package/dist/core/runner/placement-fence.js +20 -6
  136. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  137. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  138. package/dist/core/runner/prepare-ask-lane.js +2 -2
  139. package/dist/core/runner/prepare-caps-and-workflow.d.ts +5 -1
  140. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  141. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  142. package/dist/core/runner/prepare-config-doors.js +3 -4
  143. package/dist/core/runner/prepare-execution-env.js +17 -6
  144. package/dist/core/runner/prepare-hands-readface.d.ts +3 -2
  145. package/dist/core/runner/prepare-hands-readface.js +32 -10
  146. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -8
  147. package/dist/core/runner/prepare-inherited-gate.js +14 -6
  148. package/dist/core/runner/prepare-memory-engine-session.d.ts +2 -4
  149. package/dist/core/runner/prepare-memory-engine-session.js +4 -4
  150. package/dist/core/runner/prepare-memory.d.ts +3 -2
  151. package/dist/core/runner/prepare-memory.js +28 -20
  152. package/dist/core/runner/prepare-park-ask.js +4 -3
  153. package/dist/core/runner/prepare-task.js +22 -16
  154. package/dist/core/runner/prepare-workspace-restore.js +3 -6
  155. package/dist/core/runner/resume-admission.d.ts +3 -3
  156. package/dist/core/runner/resume-admission.js +6 -3
  157. package/dist/core/runner/resume-apply.d.ts +4 -0
  158. package/dist/core/runner/resume-apply.js +11 -4
  159. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  160. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  161. package/dist/core/runner/run-git-lane.d.ts +2 -0
  162. package/dist/core/runner/run-git-lane.js +4 -1
  163. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  164. package/dist/core/runner/run-harness-handlers.js +3 -2
  165. package/dist/core/runner/run-leg.js +25 -8
  166. package/dist/core/runner/run-settle-and-teardown.js +6 -4
  167. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  168. package/dist/core/runner/run-turn-boundary.js +7 -4
  169. package/dist/core/runner/runtask.js +6 -6
  170. package/dist/core/runner/steering-preview.d.ts +9 -0
  171. package/dist/core/runner/steering-preview.js +5 -0
  172. package/dist/core/runner/stream-steer-verb.js +8 -0
  173. package/dist/core/runner/terminal-account.js +1 -1
  174. package/dist/core/runner/tool-face-overlay.js +2 -0
  175. package/dist/core/runner/turn-attachments.d.ts +5 -0
  176. package/dist/core/runner/turn-attachments.js +1 -1
  177. package/dist/core/runner-deps.d.ts +8 -4
  178. package/dist/core/secret-env.d.ts +9 -6
  179. package/dist/core/secret-env.js +41 -22
  180. package/dist/core/session-checkout.d.ts +108 -0
  181. package/dist/core/session-checkout.js +485 -0
  182. package/dist/core/session-store.d.ts +13 -5
  183. package/dist/core/session-store.js +28 -4
  184. package/dist/core/session.d.ts +29 -5
  185. package/dist/core/session.js +3 -0
  186. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +6 -12
  187. package/dist/core/store-contracts/checkpoint-store-contract.js +73 -6
  188. package/dist/core/store-contracts/session-store-contract.js +61 -8
  189. package/dist/core/task-event.d.ts +28 -1
  190. package/dist/core/task-notification.d.ts +9 -1
  191. package/dist/core/task-notification.js +8 -1
  192. package/dist/core/task-registry-agent.d.ts +40 -8
  193. package/dist/core/task-registry-agent.js +57 -24
  194. package/dist/core/task-registry-shared.d.ts +33 -11
  195. package/dist/core/task-registry-workflow.js +4 -3
  196. package/dist/core/task-registry.d.ts +27 -10
  197. package/dist/core/task-registry.js +19 -13
  198. package/dist/core/task-result.d.ts +5 -5
  199. package/dist/core/task-spec-members.js +1 -1
  200. package/dist/core/task-spec.d.ts +21 -1
  201. package/dist/core/terminal-cause.d.ts +6 -6
  202. package/dist/core/tool-face.d.ts +6 -2
  203. package/dist/core/tool-face.js +1 -1
  204. package/dist/core/tool-policy.d.ts +16 -13
  205. package/dist/core/tool-policy.js +11 -10
  206. package/dist/core/tool-roster.d.ts +4 -4
  207. package/dist/core/tool-spec.d.ts +42 -19
  208. package/dist/core/types.d.ts +2 -2
  209. package/dist/core/types.js +1 -1
  210. package/dist/core/untrusted-egress.d.ts +15 -4
  211. package/dist/core/untrusted-egress.js +23 -22
  212. package/dist/core/workspace-snapshot.d.ts +3 -1
  213. package/dist/core/workspace-snapshot.js +1 -0
  214. package/dist/engine/execution-env/node-execution-env.d.ts +3 -0
  215. package/dist/engine/execution-env/node-execution-env.js +12 -5
  216. package/dist/engine/harness/types.d.ts +77 -1
  217. package/dist/engine/harness/types.js +108 -0
  218. package/dist/engine/session/import-validate.js +6 -1
  219. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  220. package/dist/engine/session/parent-chain-guard.js +1 -1
  221. package/dist/engine/session/path-to-root.d.ts +18 -3
  222. package/dist/engine/session/path-to-root.js +15 -1
  223. package/dist/engine/session/repo-utils.d.ts +12 -1
  224. package/dist/engine/session/repo-utils.js +41 -0
  225. package/dist/engine/session/session.d.ts +24 -1
  226. package/dist/engine/session/session.js +46 -2
  227. package/dist/engine/session/storage-base.d.ts +20 -0
  228. package/dist/engine/session/storage-base.js +28 -9
  229. package/dist/index.d.ts +16 -12
  230. package/dist/index.js +11 -8
  231. package/dist/internal/harness-types.d.ts +1 -1
  232. package/dist/internal/harness.d.ts +4 -3
  233. package/dist/internal/harness.js +3 -2
  234. package/dist/orchestration/run-workflow-tool.d.ts +7 -1
  235. package/dist/orchestration/run-workflow-tool.js +28 -11
  236. package/dist/orchestration/workflow-governance.d.ts +1 -1
  237. package/dist/orchestration/workflow.d.ts +6 -0
  238. package/dist/orchestration/workflow.js +5 -8
  239. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  240. package/dist/stores/file/checkpoint-store.js +7 -6
  241. package/dist/stores/file/fs-atomic.d.ts +0 -22
  242. package/dist/stores/file/fs-atomic.js +0 -17
  243. package/dist/stores/file/index.d.ts +2 -9
  244. package/dist/stores/file/index.js +2 -4
  245. package/dist/stores/file/session-store.d.ts +13 -7
  246. package/dist/stores/file/session-store.js +42 -18
  247. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  248. package/dist/tools/fs/bash-program-position.js +10 -10
  249. package/dist/tools/fs/program-read-model.d.ts +34 -10
  250. package/dist/tools/fs/program-read-model.js +37 -7
  251. package/dist/tools/fs/program-read-model.rows.js +13 -2
  252. package/dist/tools/fs/read-deny.d.ts +13 -1
  253. package/dist/tools/fs/read-deny.js +10 -2
  254. package/dist/tools/fs/removal-targets.js +5 -5
  255. package/dist/tools/fs/safety.d.ts +2 -0
  256. package/dist/tools/fs/safety.js +1 -1
  257. package/dist/tools/fs/shell-read-argv.d.ts +11 -2
  258. package/dist/tools/fs/shell-read-argv.js +45 -29
  259. package/dist/tools/fs/shell-read-bindings.d.ts +20 -2
  260. package/dist/tools/fs/shell-read-bindings.js +153 -69
  261. package/dist/tools/fs/shell-read-brace.d.ts +18 -0
  262. package/dist/tools/fs/shell-read-brace.js +79 -0
  263. package/dist/tools/fs/shell-read-check.js +29 -11
  264. package/dist/tools/fs/shell-read-establish.js +43 -22
  265. package/dist/tools/fs/shell-read-functions.js +2 -2
  266. package/dist/tools/fs/shell-read-judge.d.ts +11 -0
  267. package/dist/tools/fs/shell-read-judge.js +3 -3
  268. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  269. package/dist/tools/fs/shell-read-object-path.js +119 -0
  270. package/dist/tools/fs/shell-read-plan.d.ts +18 -0
  271. package/dist/tools/fs/shell-read-plan.js +217 -104
  272. package/dist/tools/fs/shell-read-start.d.ts +76 -13
  273. package/dist/tools/fs/shell-read-start.js +97 -17
  274. package/dist/tools/fs/shell-read-word.d.ts +10 -0
  275. package/dist/tools/fs/shell-read-word.js +9 -5
  276. package/dist/tools/fs/shell-read-workdir.d.ts +54 -14
  277. package/dist/tools/fs/shell-read-workdir.js +103 -19
  278. package/dist/tools/fs/shell-read-write-targets.js +13 -8
  279. package/dist/tools/worktree.d.ts +3 -2
  280. package/dist/tools/worktree.js +7 -35
  281. package/package.json +3 -2
  282. package/test/export-surface.snapshot.json +93 -43
  283. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  284. package/wire-changes/core-stores-sql@7.63.0.json +30 -0
  285. package/wire-changes/core@7.62.0.json +2181 -0
  286. package/wire-changes/core@7.63.0.json +3523 -0
  287. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  288. package/wire-changes/mods-kernel@7.63.0.json +30 -0
  289. package/wire-changes/primitives@7.62.0.json +30 -0
  290. package/wire-changes/primitives@7.63.0.json +445 -0
  291. package/dist/core/consolidate-scope.d.ts +0 -93
  292. package/dist/core/consolidate-scope.js +0 -98
  293. package/dist/core/credential-vocabulary.d.ts +0 -176
  294. package/dist/core/credential-vocabulary.js +0 -190
  295. package/dist/core/redaction-passes.d.ts +0 -82
  296. package/dist/core/redaction-passes.js +0 -377
  297. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  298. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -1,4 +1,5 @@
1
1
  import type { ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
2
+ import { type RepositoryProbe } from "../tools/fs/shell-read-object-path.js";
2
3
  /** The managed parent (under the repository root) that holds every managed worktree — the reference implementation's
3
4
  * `.claude/worktrees/` under this project's brand — so {@link pruneWorktrees} and a userland reaper find orphans by one known
4
5
  * location. Every tree the engine mints lives at `<repoRoot>/.sema/worktrees/<slug>` (see {@link managedWorktreeDir}). */
@@ -11,11 +12,33 @@ export declare function managedWorktreeDir(repoRoot: string, name: string): stri
11
12
  * when `dir` is not shaped as a managed tree. Literal, byte-exact segments (no case fold): this answer EXEMPTS, and a fold
12
13
  * would widen an exemption. */
13
14
  export declare function managedWorktreeBaseOf(dir: string): string | undefined;
15
+ /** The managed tree `dir` is in — `dir` itself, or its nearest ancestor shaped as one (a task root in `pkg/` of a session's tree
16
+ * sits at `<tree>/pkg`) — as its root and the checkout it was minted under; `undefined` when no level is a managed tree or a
17
+ * level below the tree is `.` / `..` (where that lands is not decided lexically, and this answer exempts). */
18
+ export declare function managedTreeAt(dir: string): {
19
+ readonly root: string;
20
+ readonly base: string;
21
+ } | undefined;
22
+ /**
23
+ * THE repository root the managed parent is anchored at (the path law): the root of the checkout `dir` belongs
24
+ * to, read through the one repository-top reader ({@link repositoryTopOf} — no second walk). A managed tree is checked out
25
+ * BELOW the repository root it was minted under and its `.git` is a `gitdir:` file, which the top reader answers `undefined`
26
+ * for; so a `dir` at or below a managed tree (its root, a subdirectory of it, a symlink alias of either — read on the
27
+ * canonical spelling) is first peeled to the root before the marker's outermost occurrence (a tree minted by an older engine
28
+ * under another tree peels all the way out). `undefined` where the reader has no answer — not a repository, a linked work tree
29
+ * of the person's own, a submodule, a lookup the environment did not answer; the caller then stays at the root it was given.
30
+ */
31
+ export declare function repositoryRootOf(env: RepositoryProbe, dir: string, signal?: AbortSignal): Promise<string | undefined>;
32
+ /** Where the managed parent hangs for a mint asked at `root`: the repository root when the reader names one, spelled as the
33
+ * caller spelled `root` whenever that is the same directory (a consumer comparing the tree's path with its own root's keeps
34
+ * one spelling); `root` itself when no repository root is named. */
35
+ export declare function managedAnchorOf(env: ExecutionEnv, root: string): Promise<string>;
14
36
  /** The branch the path law gives the managed tree at `dir` (`sema/<slug>`), or `undefined` when `dir` is not a managed tree —
15
37
  * what a recorded branch must equal before anything deletes it (a record cannot name some other branch for removal). */
16
38
  export declare function managedWorktreeBranchOf(dir: string): string | undefined;
17
39
  export interface AddWorktreeOptions {
18
- /** The base repository root — where `git worktree add` runs (the base env's cwd is typically this). */
40
+ /** Where the mint is asked (the caller's task root — a checkout of the repository, typically its root). The managed parent
41
+ * hangs at the REPOSITORY root that checkout belongs to ({@link repositoryRootOf}); with no repository root named, here. */
19
42
  repoRoot: string;
20
43
  /** Stable per-task identity: with no {@link name}, the tree's name is this (sanitized) plus a random suffix — a fresh name
21
44
  * per mint, for the lanes that mint one tree per child. */
@@ -36,6 +59,14 @@ export interface AddWorktreeOptions {
36
59
  * step's failure (the add's refuses the mint before anything exists). Absent ⇒ the starts carry none (no run). */
37
60
  readFloor?: () => ReadFloor | undefined;
38
61
  }
62
+ /** Single-quote a path for the `exec` command STRING (the Shell API takes a command string, not argv). */
63
+ export declare function shq(s: string): string;
64
+ /**
65
+ * THE path law's symlink half: from `.sema` down to the tree's own directory, NO level may be a symlink — a link committed to
66
+ * the repository at any of them would redirect the mint outside it. Three levels exactly (the slug is one directory, see
67
+ * {@link slugOf}); a level that does not exist yet is fine (git creates it), and a level whose kind cannot be read refuses.
68
+ */
69
+ export declare function symlinkedLevel(env: ExecutionEnv, repoRoot: string, worktreeDir: string): Promise<string | undefined>;
39
70
  /**
40
71
  * Remove a managed worktree and — by the ONE branch rule — its branch: the branch is deleted only when its tip is still the
41
72
  * commit the tree was minted at (it carries nothing the tree made); otherwise it is kept, so commits made in the tree stay
@@ -47,10 +78,13 @@ export interface AddWorktreeOptions {
47
78
  * deregisters worktrees whose directory is gone). Check the result, retry once (the observed failures are transient),
48
79
  * and report the outcome.
49
80
  */
50
- export declare function removeManagedWorktree(baseEnv: ExecutionEnv, repoRoot: string, worktreeDir: string, branch?: {
81
+ export declare function removeManagedWorktree(baseEnv: ExecutionEnv, repoRoot: string, worktreeDir: string, branch: {
51
82
  readonly name: string;
52
83
  readonly baseSha: string;
53
- }, readFloor?: () => ReadFloor | undefined): Promise<{
84
+ } | undefined, readFloor: (() => ReadFloor | undefined) | undefined,
85
+ /** `"discard"` removes the tree whatever it holds (`--force`: the caller already decided its changes go); `"clean"` lets git
86
+ * refuse a tree with changes (no `--force`: whatever lands between the caller's own check and the removal keeps the tree). */
87
+ how: "discard" | "clean"): Promise<{
54
88
  ok: true;
55
89
  branchDeleted?: string;
56
90
  branchKept?: string;
@@ -81,6 +115,31 @@ export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOpti
81
115
  branch: string;
82
116
  baseSha?: string;
83
117
  }>;
118
+ /**
119
+ * THE managed-tree mint with no environment attached: judges the name, anchors the managed parent at the repository root,
120
+ * refuses a symlinked level, runs `git worktree add` (a name whose directory or branch exists is refused) and registers the
121
+ * parent in the repository-local ignore file. {@link addWorktree} wraps it with a tree-rooted env whose destroy removes the
122
+ * tree; a session checkout keeps the tree past every env and removes it only on release.
123
+ */
124
+ export declare function mintManagedWorktree(baseEnv: ExecutionEnv, opts: Pick<AddWorktreeOptions, "repoRoot" | "sessionId" | "name" | "commit" | "readFloor">): Promise<{
125
+ worktreeDir: string;
126
+ name: string;
127
+ branch: string;
128
+ anchor: string;
129
+ baseSha?: string;
130
+ }>;
131
+ /**
132
+ * Resolve the commit a new tree starts from, by the base words EnterWorktree and the session declaration share: `"head"` =
133
+ * the current local HEAD; `"fresh"` = the default branch tip (origin's HEAD symbolic ref → local main → local master → HEAD,
134
+ * the fallback named in `note`). Run where the mint is asked (`repoRoot`).
135
+ */
136
+ export declare function resolveBaseCommit(env: ExecutionEnv, repoRoot: string, baseRef: "fresh" | "head", readFloor: ReadFloor | undefined): Promise<{
137
+ sha: string;
138
+ label: string;
139
+ note?: string;
140
+ } | {
141
+ error: string;
142
+ }>;
84
143
  /** Reap orphaned worktrees (after a crash removed their dirs) — `git worktree prune` deregisters them. A userland
85
144
  * reaper calls this periodically against the base repo; core ships no post-kill Runner hook.
86
145
  *
@@ -1,5 +1,7 @@
1
1
  import { randomUUID } from "node:crypto";
2
2
  import { thrownLabel, thrownText } from "./thrown-value.js";
3
+ import { repositoryTopOf } from "../tools/fs/shell-read-object-path.js";
4
+ import { pathFamilyOf } from "../tools/fs/safety.js";
3
5
  export const WORKTREE_PARENT = ".sema/worktrees";
4
6
  const WORKTREE_BRANCH_PREFIX = "sema";
5
7
  const NAME_SEGMENT = /^[a-zA-Z0-9._-]+$/;
@@ -33,15 +35,41 @@ export function managedWorktreeBaseOf(dir) {
33
35
  const base = parts.slice(0, -3).join("/");
34
36
  return base === "" ? "/" : base;
35
37
  }
38
+ export function managedTreeAt(dir) {
39
+ const parts = dir.split("/");
40
+ for (let end = parts.length; end >= 4; end--) {
41
+ const root = parts.slice(0, end).join("/");
42
+ const base = managedWorktreeBaseOf(root);
43
+ if (base === undefined)
44
+ continue;
45
+ return parts.slice(end).some((s) => s === "." || s === "..") ? undefined : { root, base };
46
+ }
47
+ return undefined;
48
+ }
49
+ const MANAGED_MARKER = `/${WORKTREE_PARENT}/`;
50
+ export async function repositoryRootOf(env, dir, signal) {
51
+ const canonical = await env.canonicalPath(dir, signal);
52
+ const spelled = canonical.ok ? canonical.value : dir;
53
+ const at = spelled.indexOf(MANAGED_MARKER);
54
+ const base = at < 0 ? dir : at === 0 ? "/" : spelled.slice(0, at);
55
+ return repositoryTopOf(env, base, pathFamilyOf({ root: base }), signal);
56
+ }
57
+ export async function managedAnchorOf(env, root) {
58
+ const top = await repositoryRootOf(env, root);
59
+ if (top === undefined)
60
+ return root;
61
+ const own = await env.canonicalPath(root);
62
+ return own.ok && own.value === top ? root : top;
63
+ }
36
64
  export function managedWorktreeBranchOf(dir) {
37
65
  if (managedWorktreeBaseOf(dir) === undefined)
38
66
  return undefined;
39
67
  return `${WORKTREE_BRANCH_PREFIX}/${dir.slice(dir.lastIndexOf("/") + 1)}`;
40
68
  }
41
- function shq(s) {
69
+ export function shq(s) {
42
70
  return `'${s.replace(/'/g, "'\\''")}'`;
43
71
  }
44
- async function symlinkedLevel(env, repoRoot, worktreeDir) {
72
+ export async function symlinkedLevel(env, repoRoot, worktreeDir) {
45
73
  for (const level of [`${repoRoot}/.sema`, `${repoRoot}/${WORKTREE_PARENT}`, worktreeDir]) {
46
74
  const info = await env.fileInfo(level);
47
75
  if (!info.ok) {
@@ -55,13 +83,13 @@ async function symlinkedLevel(env, repoRoot, worktreeDir) {
55
83
  }
56
84
  return undefined;
57
85
  }
58
- export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch, readFloor) {
86
+ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch, readFloor, how) {
59
87
  const readFloorNow = () => { const f = readFloor?.(); return f !== undefined ? { readFloor: f } : {}; };
60
88
  let detail = "";
61
89
  let removed = false;
62
90
  for (let attempt = 0; attempt < 2 && !removed; attempt++) {
63
91
  try {
64
- const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot, ...readFloorNow() });
92
+ const r = await baseEnv.exec(`git worktree remove ${how === "discard" ? "--force " : ""}${shq(worktreeDir)}`, { cwd: repoRoot, ...readFloorNow() });
65
93
  if (r.ok && r.value.exitCode === 0)
66
94
  removed = true;
67
95
  else
@@ -93,13 +121,42 @@ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, bran
93
121
  }
94
122
  }
95
123
  export async function addWorktree(baseEnv, opts) {
124
+ const { worktreeDir, name, branch, anchor, baseSha } = await mintManagedWorktree(baseEnv, opts);
125
+ const branchRule = baseSha !== undefined ? { name: branch, baseSha } : undefined;
126
+ let inner;
127
+ try {
128
+ inner = await opts.rootEnvAt(worktreeDir);
129
+ }
130
+ catch (err) {
131
+ await removeManagedWorktree(baseEnv, anchor, worktreeDir, branchRule, opts.readFloor, "discard");
132
+ throw err;
133
+ }
134
+ const innerDestroy = inner.destroy;
135
+ const env = inner;
136
+ env.destroy = async () => {
137
+ try {
138
+ if (typeof innerDestroy === "function")
139
+ await innerDestroy.call(inner);
140
+ }
141
+ finally {
142
+ const removed = await removeManagedWorktree(baseEnv, anchor, worktreeDir, branchRule, opts.readFloor, "discard");
143
+ if (!removed.ok) {
144
+ throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
145
+ `\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
146
+ }
147
+ }
148
+ };
149
+ return { env, worktreeDir, name, branch, ...(baseSha !== undefined ? { baseSha } : {}) };
150
+ }
151
+ export async function mintManagedWorktree(baseEnv, opts) {
96
152
  const name = opts.name ?? `${(opts.sessionId || "task").replace(/[^A-Za-z0-9_-]/g, "_").slice(0, 50)}-${randomUUID().slice(0, 8)}`;
97
153
  const nameProblem = worktreeNameProblem(name);
98
154
  if (nameProblem !== undefined)
99
155
  throw new Error(nameProblem);
100
- const worktreeDir = managedWorktreeDir(opts.repoRoot, name);
156
+ const anchor = await managedAnchorOf(baseEnv, opts.repoRoot);
157
+ const worktreeDir = managedWorktreeDir(anchor, name);
101
158
  const branch = `${WORKTREE_BRANCH_PREFIX}/${slugOf(name)}`;
102
- const symlinked = await symlinkedLevel(baseEnv, opts.repoRoot, worktreeDir);
159
+ const symlinked = await symlinkedLevel(baseEnv, anchor, worktreeDir);
103
160
  if (symlinked !== undefined)
104
161
  throw new Error(symlinked);
105
162
  const readFloorNow = () => { const readFloor = opts.readFloor?.(); return readFloor !== undefined ? { readFloor } : {}; };
@@ -114,37 +171,41 @@ export async function addWorktree(baseEnv, opts) {
114
171
  const excludeLine = shq(`/${WORKTREE_PARENT}/`);
115
172
  await Promise.resolve()
116
173
  .then(() => baseEnv.exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
117
- `{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot, ...readFloorNow() }))
174
+ `{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: anchor, ...readFloorNow() }))
118
175
  .catch(() => undefined);
119
176
  const baseSha = await Promise.resolve()
120
177
  .then(() => baseEnv.exec("git rev-parse HEAD", { cwd: worktreeDir, ...readFloorNow() }))
121
178
  .then((r) => (r.ok && r.value.exitCode === 0 && r.value.stdout.trim() !== "" ? r.value.stdout.trim() : undefined))
122
179
  .catch(() => undefined);
123
- const branchRule = baseSha !== undefined ? { name: branch, baseSha } : undefined;
124
- let inner;
125
- try {
126
- inner = await opts.rootEnvAt(worktreeDir);
127
- }
128
- catch (err) {
129
- await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
130
- throw err;
180
+ return { worktreeDir, name, branch, anchor, ...(baseSha !== undefined ? { baseSha } : {}) };
181
+ }
182
+ export async function resolveBaseCommit(env, repoRoot, baseRef, readFloor) {
183
+ const rev = async (ref) => {
184
+ const r = await env.exec(`git rev-parse --verify --quiet ${shq(`${ref}^{commit}`)}`, { cwd: repoRoot, ...(readFloor !== undefined ? { readFloor } : {}) });
185
+ return r.ok && r.value.exitCode === 0 ? r.value.stdout.trim() : undefined;
186
+ };
187
+ if (baseRef === "head") {
188
+ const sha = await rev("HEAD");
189
+ return sha ? { sha, label: "HEAD" } : { error: "cannot resolve HEAD (empty repository with no commits?)" };
131
190
  }
132
- const innerDestroy = inner.destroy;
133
- const env = inner;
134
- env.destroy = async () => {
135
- try {
136
- if (typeof innerDestroy === "function")
137
- await innerDestroy.call(inner);
191
+ const sym = await env.exec("git symbolic-ref --quiet refs/remotes/origin/HEAD", { cwd: repoRoot, ...(readFloor !== undefined ? { readFloor } : {}) });
192
+ if (sym.ok && sym.value.exitCode === 0) {
193
+ const branch = sym.value.stdout.trim().replace(/^refs\/remotes\//, "");
194
+ if (branch) {
195
+ const sha = await rev(branch);
196
+ if (sha)
197
+ return { sha, label: branch };
138
198
  }
139
- finally {
140
- const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
141
- if (!removed.ok) {
142
- throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
143
- `\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
144
- }
145
- }
146
- };
147
- return { env, worktreeDir, name, branch, ...(baseSha !== undefined ? { baseSha } : {}) };
199
+ }
200
+ for (const candidate of ["main", "master"]) {
201
+ const sha = await rev(candidate);
202
+ if (sha)
203
+ return { sha, label: candidate };
204
+ }
205
+ const sha = await rev("HEAD");
206
+ return sha
207
+ ? { sha, label: "HEAD", note: " (no remote default branch or local main/master found — fell back to HEAD)" }
208
+ : { error: "cannot resolve a fresh base (no default branch and no HEAD)" };
148
209
  }
149
210
  export async function pruneWorktrees(baseEnv, repoRoot, readFloor) {
150
211
  try {
@@ -145,7 +145,7 @@ export type NoticeAudience = "user" | "operator";
145
145
  * the union's catalog ({@link EngineNotice.code}). The groups below say only which family a row joins,
146
146
  * so the catalog is not written a second time here and the two cannot drift.
147
147
  */
148
- export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
148
+ export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "delegation.resume_lane_missing", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.harvest_refused", "memory.harvest_conflict", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "session.lineage_rerooted", "instructions.source_changed", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
149
149
  /** A catalogued code (see {@link ENGINE_NOTICE_CODES}); {@link NOTICE_MINTER} says who mints it. NOT the type of
150
150
  * `EngineNotice.code`, which stays `string` — a host forwarding its own notices through the same
151
151
  * sink is a supported shape, and narrowing that field would break it. */
@@ -166,6 +166,8 @@ export type EngineNoticeCode = (typeof ENGINE_NOTICE_CODES)[number];
166
166
  declare const NOTICE_AUDIENCE_TABLE: {
167
167
  readonly "memory.session_polluted": "user";
168
168
  readonly "memory.harvest_quarantined": "user";
169
+ readonly "memory.harvest_refused": "user";
170
+ readonly "memory.harvest_conflict": "user";
169
171
  readonly "memory.delegation_static_mark_waived": "user";
170
172
  readonly "memory.hold_opened": "user";
171
173
  readonly "memory.hold_released": "user";
@@ -236,6 +238,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
236
238
  readonly "peer.held_settled": "user";
237
239
  readonly "peer.idle_subscription": "user";
238
240
  readonly "delegation.transcript_integrity": "operator";
241
+ readonly "delegation.resume_lane_missing": "operator";
239
242
  readonly "checkpoint.execution_outcome_unrecorded": "operator";
240
243
  readonly "mcp.injection_dropped": "user";
241
244
  readonly "mcp.revocation_probe_failed": "operator";
@@ -272,9 +275,9 @@ declare const NOTICE_AUDIENCE_TABLE: {
272
275
  readonly "config.image_processor_unavailable": "operator";
273
276
  readonly "fs.staging_file_left": "operator";
274
277
  readonly "fs.staging_file_swept": "operator";
278
+ readonly "session.lineage_rerooted": "user";
275
279
  readonly "config.forward_sink_failed": "operator";
276
280
  readonly "instructions.source_changed": "user";
277
- readonly "session.records_skipped": "user";
278
281
  readonly "server.model_unreachable": "user";
279
282
  readonly "permission.entry_mode_clamped": "user";
280
283
  readonly "memory.layer_locked_legacy": "operator";
@@ -355,6 +358,7 @@ declare const NOTICE_MINTER_TABLE: {
355
358
  readonly "checkpoint.execution_outcome_unrecorded": "engine";
356
359
  readonly "delegation.transcript_integrity": "engine";
357
360
  readonly "delegation.ask_unresolvable": "engine";
361
+ readonly "delegation.resume_lane_missing": "engine";
358
362
  readonly "mcp.injection_dropped": "engine";
359
363
  readonly "mcp.revocation_probe_failed": "engine";
360
364
  readonly "mcp.server_redialed": "engine";
@@ -364,6 +368,8 @@ declare const NOTICE_MINTER_TABLE: {
364
368
  readonly "workflow.agent_option_ignored": "engine";
365
369
  readonly "memory.session_polluted": "engine";
366
370
  readonly "memory.harvest_quarantined": "engine";
371
+ readonly "memory.harvest_refused": "engine";
372
+ readonly "memory.harvest_conflict": "engine";
367
373
  readonly "memory.delegation_static_mark_waived": "engine";
368
374
  readonly "memory.content_class_declared": "engine";
369
375
  readonly "memory.hold_opened": "engine";
@@ -412,8 +418,8 @@ declare const NOTICE_MINTER_TABLE: {
412
418
  readonly "config.image_processor_unavailable": "engine";
413
419
  readonly "fs.staging_file_left": "engine";
414
420
  readonly "fs.staging_file_swept": "engine";
421
+ readonly "session.lineage_rerooted": "engine";
415
422
  readonly "instructions.source_changed": "server";
416
- readonly "session.records_skipped": "server";
417
423
  readonly "memory.layer_locked_legacy": "server";
418
424
  readonly "server.model_unreachable": "server";
419
425
  readonly "permission.entry_mode_clamped": "server";
@@ -27,6 +27,8 @@ export const NON_GOVERNANCE_MEMORY_CODES = new Set([
27
27
  "memory.session_incarnation_unreadable",
28
28
  "memory.session_polluted",
29
29
  "memory.harvest_quarantined",
30
+ "memory.harvest_refused",
31
+ "memory.harvest_conflict",
30
32
  "memory.delegation_static_mark_waived",
31
33
  "memory.content_class_declared",
32
34
  "memory.consolidation_driver_superseded",
@@ -58,6 +60,8 @@ export const NON_GOVERNANCE_MEMORY_CODES = new Set([
58
60
  "memory.challenge_ledger_oversize",
59
61
  "memory.control_plane_rebuilt",
60
62
  "memory.control_plane_not_corrupt",
63
+ "memory.control_plane_rebuild_unsupported",
64
+ "memory.governance_doc_unknown",
61
65
  "memory.erasure_evidence_unavailable",
62
66
  "memory.erasure_selector_mismatch",
63
67
  "memory.erasure_census_incomplete",
@@ -176,6 +180,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
176
180
  "checkpoint.execution_outcome_unrecorded",
177
181
  "delegation.transcript_integrity",
178
182
  "delegation.ask_unresolvable",
183
+ "delegation.resume_lane_missing",
179
184
  "mcp.injection_dropped",
180
185
  "mcp.revocation_probe_failed",
181
186
  "mcp.server_redialed",
@@ -185,6 +190,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
185
190
  "workflow.agent_option_ignored",
186
191
  "memory.session_polluted",
187
192
  "memory.harvest_quarantined",
193
+ "memory.harvest_refused",
194
+ "memory.harvest_conflict",
188
195
  "memory.delegation_static_mark_waived",
189
196
  "memory.content_class_declared",
190
197
  "memory.hold_opened",
@@ -233,8 +240,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
233
240
  "config.image_processor_unavailable",
234
241
  "fs.staging_file_left",
235
242
  "fs.staging_file_swept",
243
+ "session.lineage_rerooted",
236
244
  "instructions.source_changed",
237
- "session.records_skipped",
238
245
  "memory.layer_locked_legacy",
239
246
  "server.model_unreachable",
240
247
  "permission.entry_mode_clamped",
@@ -242,6 +249,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
242
249
  const NOTICE_AUDIENCE_TABLE = {
243
250
  "memory.session_polluted": "user",
244
251
  "memory.harvest_quarantined": "user",
252
+ "memory.harvest_refused": "user",
253
+ "memory.harvest_conflict": "user",
245
254
  "memory.delegation_static_mark_waived": "user",
246
255
  "memory.hold_opened": "user",
247
256
  "memory.hold_released": "user",
@@ -312,6 +321,7 @@ const NOTICE_AUDIENCE_TABLE = {
312
321
  "peer.held_settled": "user",
313
322
  "peer.idle_subscription": "user",
314
323
  "delegation.transcript_integrity": "operator",
324
+ "delegation.resume_lane_missing": "operator",
315
325
  "checkpoint.execution_outcome_unrecorded": "operator",
316
326
  "mcp.injection_dropped": "user",
317
327
  "mcp.revocation_probe_failed": "operator",
@@ -348,9 +358,9 @@ const NOTICE_AUDIENCE_TABLE = {
348
358
  "config.image_processor_unavailable": "operator",
349
359
  "fs.staging_file_left": "operator",
350
360
  "fs.staging_file_swept": "operator",
361
+ "session.lineage_rerooted": "user",
351
362
  "config.forward_sink_failed": "operator",
352
363
  "instructions.source_changed": "user",
353
- "session.records_skipped": "user",
354
364
  "server.model_unreachable": "user",
355
365
  "permission.entry_mode_clamped": "user",
356
366
  "memory.layer_locked_legacy": "operator",
@@ -412,6 +422,7 @@ const NOTICE_MINTER_TABLE = {
412
422
  "checkpoint.execution_outcome_unrecorded": "engine",
413
423
  "delegation.transcript_integrity": "engine",
414
424
  "delegation.ask_unresolvable": "engine",
425
+ "delegation.resume_lane_missing": "engine",
415
426
  "mcp.injection_dropped": "engine",
416
427
  "mcp.revocation_probe_failed": "engine",
417
428
  "mcp.server_redialed": "engine",
@@ -421,6 +432,8 @@ const NOTICE_MINTER_TABLE = {
421
432
  "workflow.agent_option_ignored": "engine",
422
433
  "memory.session_polluted": "engine",
423
434
  "memory.harvest_quarantined": "engine",
435
+ "memory.harvest_refused": "engine",
436
+ "memory.harvest_conflict": "engine",
424
437
  "memory.delegation_static_mark_waived": "engine",
425
438
  "memory.content_class_declared": "engine",
426
439
  "memory.hold_opened": "engine",
@@ -469,8 +482,8 @@ const NOTICE_MINTER_TABLE = {
469
482
  "config.image_processor_unavailable": "engine",
470
483
  "fs.staging_file_left": "engine",
471
484
  "fs.staging_file_swept": "engine",
485
+ "session.lineage_rerooted": "engine",
472
486
  "instructions.source_changed": "server",
473
- "session.records_skipped": "server",
474
487
  "memory.layer_locked_legacy": "server",
475
488
  "server.model_unreachable": "server",
476
489
  "permission.entry_mode_clamped": "server",
@@ -205,6 +205,19 @@ export interface StopFailureEvent extends ClassicEventBase {
205
205
  /** Turns completed when the failure ended the run. */
206
206
  readonly turns: number;
207
207
  }
208
+ /** `classic.SessionStart`'s `e` — raised once per leg, in the bottom of `session.start` (the leg is prepared, its first model
209
+ * request not yet made). Observe-only. */
210
+ export interface SessionStartEvent extends ClassicEventBase {
211
+ /** The leg's tracked working directory. */
212
+ readonly cwd: string;
213
+ readonly sessionId: string;
214
+ }
215
+ /** `classic.SessionEnd`'s `e` — raised once per leg, in the bottom of `session.end` (its terminal settled). Observe-only. */
216
+ export interface SessionEndEvent extends ClassicEventBase {
217
+ /** The terminal status word. */
218
+ readonly reason: string;
219
+ readonly sessionId: string;
220
+ }
208
221
  /** `classic.PreCompact`'s `e` — before each compaction, after the trigger gate and a valid cut point. Answer:
209
222
  * {@link PreCompactResult} (`block` honored on "auto" / "manual" only). */
210
223
  export interface PreCompactEvent extends ClassicEventBase {
@@ -77,4 +77,5 @@ export declare function buildAppliedHumanInputEvent(input: {
77
77
  actor?: ActorAssertion | undefined;
78
78
  principal?: string | undefined;
79
79
  runOrigin?: HumanInputEvent["runOrigin"];
80
+ rewrittenBy?: readonly string[] | undefined;
80
81
  }): HumanInputEvent;
@@ -33,6 +33,7 @@ const HANDLED_HUMAN_INPUT_KEYS = {
33
33
  entryId: "forwarded",
34
34
  attachments: "forwarded",
35
35
  runOrigin: "forwarded",
36
+ rewrittenBy: "forwarded",
36
37
  };
37
38
  export function buildHumanInputEvent(input) {
38
39
  void HANDLED_HUMAN_INPUT_KEYS;
@@ -49,6 +50,7 @@ export function buildHumanInputEvent(input) {
49
50
  ...(input.entryId !== undefined ? { entryId: input.entryId } : {}),
50
51
  ...(input.attachments !== undefined && input.attachments.length > 0 ? { attachments: input.attachments.map((a) => ({ ...a })) } : {}),
51
52
  ...(input.runOrigin !== undefined ? { runOrigin: input.runOrigin } : {}),
53
+ ...(input.rewrittenBy !== undefined ? { rewrittenBy: Object.freeze([...input.rewrittenBy]) } : {}),
52
54
  };
53
55
  }
54
56
  export function buildAppliedHumanInputEvent(input) {
@@ -62,5 +64,6 @@ export function buildAppliedHumanInputEvent(input) {
62
64
  ...(input.actor?.issuer !== undefined ? { issuer: input.actor.issuer } : {}),
63
65
  ...(input.principal !== undefined ? { principal: input.principal } : {}),
64
66
  ...(input.runOrigin !== undefined ? { runOrigin: input.runOrigin } : {}),
67
+ ...(input.rewrittenBy !== undefined ? { rewrittenBy: input.rewrittenBy } : {}),
65
68
  });
66
69
  }
@@ -26,7 +26,7 @@ export declare const PDF_TARGET_RAW_SIZE: number;
26
26
  */
27
27
  export declare const IMAGE_ADMISSION: Readonly<{
28
28
  readonly hard: Readonly<{
29
- formats: Readonly<Record<"image/png" | "image/jpeg" | "image/gif" | "image/webp", (b: Uint8Array) => boolean>>;
29
+ formats: Readonly<Record<"image/jpeg" | "image/png" | "image/gif" | "image/webp", (b: Uint8Array) => boolean>>;
30
30
  readBytes: Readonly<{
31
31
  withoutProcessor: number;
32
32
  withProcessor: number;
@@ -268,8 +268,8 @@ export declare function snapshotAndValidateMcpEntries(declared: unknown, where?:
268
268
  * a locked slot (`config.locked_key`, two-state — the whole prepare is rejected, nothing is
269
269
  * silently dropped or merged), and produce the resolved snapshot downstream assembly consumes.
270
270
  * Runs BEFORE any side effect of task preparation — and, on a resume, before the claim: the resume's
271
- * screen calls this same function (`enter` naming each refusal's seat) and hands the leg the frozen
272
- * entries it judged, so the leg's prepare judges engine-owned plain data and dials what was judged.
271
+ * screen calls this same function (`enter` naming each refusal's seat) and hands the leg its judged copies
272
+ * of the lists THIS resume handed (the row records none), so the leg's prepare judges engine-owned plain data and dials what was judged.
273
273
  */
274
274
  export declare function preflightLockedConfig(spec: Pick<TaskSpec, "mcp" | "a2a" | "toolPolicy" | "basePolicyForResumeEdit">, deps: RunnerDeps, enter?: ConfigDoorEntry, receipt?: ReceivedPeerDeclarations): LockedPreflight;
275
275
  /**
@@ -65,6 +65,7 @@ export async function settledBefore(work, stop) {
65
65
  }
66
66
  const TAKEN = new WeakMap();
67
67
  const refusal = (condition) => new McpHostSeatFailure({ delivered: "no", condition });
68
+ const connectionClosed = () => refusal("the host seat's connection to this leg is closed");
68
69
  export async function openHostPipe(seat, server, stop) {
69
70
  stop?.throwIfAborted();
70
71
  let open;
@@ -143,6 +144,8 @@ class TakenPipe {
143
144
  const [heard, ended, failed] = [p.onmessage, p.onclose, p.onerror];
144
145
  p.onmessage = (message, extra) => {
145
146
  heard?.(message, extra);
147
+ if (this.#ended)
148
+ return;
146
149
  if ((isJSONRPCResultResponse(message) || isJSONRPCErrorResponse(message)) && this.#inFlight.has(message.id))
147
150
  this.#inFlight.set(message.id, true);
148
151
  this.onmessage?.(message, extra);
@@ -162,6 +165,8 @@ class TakenPipe {
162
165
  await Reflect.apply(this.#parts.start, this.#pipe, []);
163
166
  }
164
167
  async send(message, options) {
168
+ if (this.#ended)
169
+ throw connectionClosed();
165
170
  if (!isJSONRPCRequest(message))
166
171
  return void (await Reflect.apply(this.#parts.send, this.#pipe, [message, options]));
167
172
  const id = message.id;
@@ -270,7 +275,7 @@ class RequestSeatPipe {
270
275
  return this.deliver({ jsonrpc: "2.0", id, result: { protocolVersion, capabilities: { tools: {} }, serverInfo: { name: this.serverName, version: "" } } });
271
276
  }
272
277
  if (this.closed)
273
- throw new McpHostSeatFailure({ delivered: "no", condition: "the host seat's connection to this leg is closed" });
278
+ throw connectionClosed();
274
279
  if (method !== "tools/list" && method !== "tools/call")
275
280
  throw new McpHostSeatFailure({ delivered: "no", condition: `the host seat carries tools/list and tools/call only, and ${inlineUntrusted(method, 80)} was not handed on` });
276
281
  const stop = new AbortController();