@sema-agent/core 7.56.0 → 7.58.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 (319) hide show
  1. package/CHANGELOG.md +926 -0
  2. package/LICENSE +1 -1
  3. package/dist/agents/org-delivery-gate.js +3 -4
  4. package/dist/agents/peer-held-queue.d.ts +69 -49
  5. package/dist/agents/peer-held-queue.js +255 -106
  6. package/dist/agents/peer-session-drain.js +63 -43
  7. package/dist/agents/send-message-tool.js +3 -2
  8. package/dist/agents/subagent-steps.js +2 -4
  9. package/dist/agents/subagent.js +8 -8
  10. package/dist/brain/anthropic.js +16 -8
  11. package/dist/brain/open-responses.js +10 -8
  12. package/dist/brain/openai.js +11 -9
  13. package/dist/brain/provider-dialect.d.ts +3 -2
  14. package/dist/brain/provider-dialect.js +2 -2
  15. package/dist/brain/request-params.d.ts +6 -0
  16. package/dist/brain/request-params.js +14 -1
  17. package/dist/brain/route-adjudicator.js +2 -1
  18. package/dist/brain/stream-engine.d.ts +9 -0
  19. package/dist/brain/stream-engine.js +24 -10
  20. package/dist/brain/stream-shared.d.ts +5 -4
  21. package/dist/brain/stream-shared.js +4 -4
  22. package/dist/core/a2a.d.ts +2 -1
  23. package/dist/core/a2a.js +23 -10
  24. package/dist/core/allow-entry.d.ts +5 -11
  25. package/dist/core/allow-entry.js +19 -26
  26. package/dist/core/approval-object.d.ts +21 -5
  27. package/dist/core/approval-object.js +44 -17
  28. package/dist/core/ask-origin.d.ts +23 -4
  29. package/dist/core/ask-origin.js +5 -1
  30. package/dist/core/auto-compaction.d.ts +75 -6
  31. package/dist/core/auto-compaction.js +43 -27
  32. package/dist/core/auto-mode-directive.d.ts +29 -5
  33. package/dist/core/auto-mode-directive.js +38 -8
  34. package/dist/core/background-agent-store.d.ts +6 -2
  35. package/dist/core/background-agent-store.js +1 -1
  36. package/dist/core/checkpoint-requirements.d.ts +13 -1
  37. package/dist/core/checkpoint-requirements.js +4 -0
  38. package/dist/core/checkpoint-store.d.ts +44 -40
  39. package/dist/core/checkpoint-store.js +32 -14
  40. package/dist/core/cross-boundary-taint.js +4 -2
  41. package/dist/core/engine-notice.d.ts +4 -3
  42. package/dist/core/engine-notice.js +6 -0
  43. package/dist/core/file-history-store.d.ts +14 -8
  44. package/dist/core/file-history-store.js +14 -4
  45. package/dist/core/fs-write-gate-policy.d.ts +4 -2
  46. package/dist/core/fs-write-gate-policy.js +7 -3
  47. package/dist/core/gate-fold.js +6 -3
  48. package/dist/core/gate-lanes.js +13 -5
  49. package/dist/core/git-worktree-env.d.ts +53 -11
  50. package/dist/core/git-worktree-env.js +96 -12
  51. package/dist/core/hooks.d.ts +6 -3
  52. package/dist/core/hooks.js +12 -5
  53. package/dist/core/human-input-projection.d.ts +1 -0
  54. package/dist/core/human-input-projection.js +3 -0
  55. package/dist/core/locked-config.d.ts +15 -1
  56. package/dist/core/locked-config.js +38 -2
  57. package/dist/core/mailbox-store.d.ts +62 -1
  58. package/dist/core/mailbox-store.js +59 -0
  59. package/dist/core/mcp-call-meta.d.ts +66 -0
  60. package/dist/core/mcp-call-meta.js +103 -0
  61. package/dist/core/mcp-connection-pool.d.ts +3 -1
  62. package/dist/core/mcp-connection-pool.js +3 -1
  63. package/dist/core/mcp-failure.d.ts +7 -1
  64. package/dist/core/mcp-failure.js +10 -0
  65. package/dist/core/mcp-name-judge.d.ts +46 -0
  66. package/dist/core/mcp-name-judge.js +61 -0
  67. package/dist/core/mcp-probe.d.ts +5 -1
  68. package/dist/core/mcp-probe.js +3 -6
  69. package/dist/core/mcp-server-link.d.ts +5 -2
  70. package/dist/core/mcp-server-spec.d.ts +46 -18
  71. package/dist/core/mcp-server-spec.js +1 -18
  72. package/dist/core/mcp.d.ts +6 -14
  73. package/dist/core/mcp.js +85 -65
  74. package/dist/core/memory-engine/consolidation-driver.js +4 -3
  75. package/dist/core/memory-engine/distiller.js +26 -17
  76. package/dist/core/memory-engine/layout.js +5 -2
  77. package/dist/core/memory-engine/scope-contract.d.ts +45 -4
  78. package/dist/core/memory-engine/scope-contract.js +80 -11
  79. package/dist/core/mode-policy.d.ts +8 -5
  80. package/dist/core/mode-policy.js +5 -4
  81. package/dist/core/mods/host.js +1 -1
  82. package/dist/core/mods/kernel/dispatch.d.ts +3 -0
  83. package/dist/core/mods/kernel/dispatch.js +10 -8
  84. package/dist/core/mods/kernel/events.d.ts +5 -1
  85. package/dist/core/mods/kernel/events.js +1 -1
  86. package/dist/core/mods/kernel/registration.d.ts +5 -1
  87. package/dist/core/mods/kernel/site-rules.d.ts +3 -0
  88. package/dist/core/mods/kernel/site-rules.js +10 -0
  89. package/dist/core/mods/package.d.ts +23 -0
  90. package/dist/core/mods/package.js +118 -0
  91. package/dist/core/mods/stations.d.ts +2 -2
  92. package/dist/core/mods/stations.js +1 -1
  93. package/dist/core/mods/tool-call.d.ts +5 -1
  94. package/dist/core/mods/tool-call.js +12 -3
  95. package/dist/core/park-selfcheck.js +2 -0
  96. package/dist/core/path-guard-rows.d.ts +20 -0
  97. package/dist/core/path-guard-rows.js +11 -0
  98. package/dist/core/peer-seat.d.ts +186 -0
  99. package/dist/core/peer-seat.js +307 -0
  100. package/dist/core/permission-rule-consent.d.ts +5 -3
  101. package/dist/core/permission-rule-consent.js +20 -15
  102. package/dist/core/permission-rule-model.d.ts +43 -2
  103. package/dist/core/permission-rule-model.js +52 -8
  104. package/dist/core/permission-rule-org.js +1 -1
  105. package/dist/core/present-plan-tool.d.ts +10 -1
  106. package/dist/core/present-plan-tool.js +46 -2
  107. package/dist/core/protocol-http-auth.d.ts +56 -31
  108. package/dist/core/protocol-http-auth.js +71 -42
  109. package/dist/core/protocol-naming.d.ts +20 -0
  110. package/dist/core/protocol-naming.js +20 -3
  111. package/dist/core/read-only-shell.d.ts +20 -5
  112. package/dist/core/read-only-shell.js +29 -14
  113. package/dist/core/redaction-marks.d.ts +16 -0
  114. package/dist/core/redaction-marks.js +16 -0
  115. package/dist/core/redaction-passes.js +8 -9
  116. package/dist/core/remote-env.d.ts +37 -1
  117. package/dist/core/remote-env.js +11 -0
  118. package/dist/core/resume-startup-cause.d.ts +24 -2
  119. package/dist/core/resume-startup-cause.js +20 -1
  120. package/dist/core/retention.d.ts +41 -15
  121. package/dist/core/retention.js +59 -12
  122. package/dist/core/rewrite-rejudge.d.ts +37 -0
  123. package/dist/core/rewrite-rejudge.js +40 -0
  124. package/dist/core/roles.js +50 -7
  125. package/dist/core/run-origin.d.ts +40 -0
  126. package/dist/core/run-origin.js +37 -0
  127. package/dist/core/runner/advertised-writable-dirs.d.ts +57 -38
  128. package/dist/core/runner/advertised-writable-dirs.js +126 -0
  129. package/dist/core/runner/compact-session.d.ts +10 -0
  130. package/dist/core/runner/compact-session.js +202 -0
  131. package/dist/core/runner/compaction-call-options.d.ts +2 -2
  132. package/dist/core/runner/compaction-restate.d.ts +15 -6
  133. package/dist/core/runner/compaction-restate.js +28 -2
  134. package/dist/core/runner/compaction-seams.d.ts +21 -1
  135. package/dist/core/runner/compaction-seams.js +11 -8
  136. package/dist/core/runner/contracts.d.ts +36 -21
  137. package/dist/core/runner/derived-route-fallback.d.ts +13 -0
  138. package/dist/core/runner/derived-route-fallback.js +6 -0
  139. package/dist/core/runner/env-capability-census.d.ts +3 -2
  140. package/dist/core/runner/env-capability-census.js +9 -3
  141. package/dist/core/runner/gate-exit.d.ts +18 -4
  142. package/dist/core/runner/gate-exit.js +5 -1
  143. package/dist/core/runner/permission-rule-lanes.d.ts +7 -7
  144. package/dist/core/runner/permission-rule-lanes.js +17 -11
  145. package/dist/core/runner/prepare-acquire-reconcile.d.ts +3 -0
  146. package/dist/core/runner/prepare-acquire-reconcile.js +2 -1
  147. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  148. package/dist/core/runner/prepare-caps-and-workflow.js +1 -1
  149. package/dist/core/runner/prepare-config-doors.d.ts +14 -5
  150. package/dist/core/runner/prepare-config-doors.js +16 -13
  151. package/dist/core/runner/prepare-delegation-surface.d.ts +4 -0
  152. package/dist/core/runner/prepare-delegation-surface.js +15 -18
  153. package/dist/core/runner/prepare-gate-stations.js +1 -1
  154. package/dist/core/runner/prepare-hands-readface.d.ts +10 -4
  155. package/dist/core/runner/prepare-hands-readface.js +6 -1
  156. package/dist/core/runner/prepare-memory.d.ts +3 -0
  157. package/dist/core/runner/prepare-memory.js +19 -23
  158. package/dist/core/runner/prepare-park-ask.d.ts +2 -0
  159. package/dist/core/runner/prepare-park-ask.js +2 -2
  160. package/dist/core/runner/prepare-policy-chain.d.ts +4 -4
  161. package/dist/core/runner/prepare-policy-chain.js +4 -6
  162. package/dist/core/runner/prepare-protocol-tools.d.ts +4 -2
  163. package/dist/core/runner/prepare-protocol-tools.js +3 -3
  164. package/dist/core/runner/prepare-suspend-saga.d.ts +2 -0
  165. package/dist/core/runner/prepare-suspend-saga.js +2 -1
  166. package/dist/core/runner/prepare-task.d.ts +4 -1
  167. package/dist/core/runner/prepare-task.js +46 -37
  168. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +13 -0
  169. package/dist/core/runner/prepare-tool-disclosure-mount.js +13 -7
  170. package/dist/core/runner/prepare-wiring-manifest.d.ts +1 -0
  171. package/dist/core/runner/prepare-wiring-manifest.js +2 -2
  172. package/dist/core/runner/prepare-workspace-restore.d.ts +3 -0
  173. package/dist/core/runner/prepare-workspace-restore.js +4 -4
  174. package/dist/core/runner/resume-admission.js +1 -1
  175. package/dist/core/runner/resume-checkpoint-screen.js +2 -0
  176. package/dist/core/runner/rewind-files.d.ts +2 -5
  177. package/dist/core/runner/rewind-files.js +9 -51
  178. package/dist/core/runner/run-harness-handlers.d.ts +3 -4
  179. package/dist/core/runner/run-harness-handlers.js +1 -8
  180. package/dist/core/runner/run-identity-wiring.js +1 -0
  181. package/dist/core/runner/run-leg.js +15 -22
  182. package/dist/core/runner/run-notification-lane.d.ts +2 -0
  183. package/dist/core/runner/run-notification-lane.js +5 -2
  184. package/dist/core/runner/run-recovery-lanes.js +3 -4
  185. package/dist/core/runner/run-settle-and-teardown.js +5 -11
  186. package/dist/core/runner/run-terminal-adoption.js +3 -4
  187. package/dist/core/runner/run-turn-boundary.js +3 -5
  188. package/dist/core/runner/runtask.d.ts +8 -1
  189. package/dist/core/runner/runtask.js +28 -34
  190. package/dist/core/runner/send-message-continuation.js +1 -1
  191. package/dist/core/runner/session-verb-doors.d.ts +28 -0
  192. package/dist/core/runner/session-verb-doors.js +48 -0
  193. package/dist/core/runner/session-write-ledger.d.ts +30 -0
  194. package/dist/core/runner/session-write-ledger.js +101 -0
  195. package/dist/core/runner/stream-settle-backstop.js +11 -14
  196. package/dist/core/runner/sub-agent-deny-lists.d.ts +25 -3
  197. package/dist/core/runner/sub-agent-deny-lists.js +21 -10
  198. package/dist/core/runner/teardown-bounded.d.ts +1 -0
  199. package/dist/core/runner/teardown-bounded.js +1 -0
  200. package/dist/core/runner/terminal-account.js +3 -3
  201. package/dist/core/runner/tool-end-body.js +1 -0
  202. package/dist/core/runner/tool-occurrence.d.ts +4 -1
  203. package/dist/core/runner/tool-occurrence.js +2 -1
  204. package/dist/core/runner/write-protection-station.d.ts +8 -2
  205. package/dist/core/runner/write-protection-station.js +2 -0
  206. package/dist/core/runner-deps.d.ts +4 -4
  207. package/dist/core/secret-env.d.ts +4 -0
  208. package/dist/core/secret-env.js +3 -0
  209. package/dist/core/sensitive-path-policy.js +6 -7
  210. package/dist/core/session-log-transfer.d.ts +24 -0
  211. package/dist/core/session-log-transfer.js +166 -0
  212. package/dist/core/session-policy-store.d.ts +7 -2
  213. package/dist/core/session-policy-store.js +1 -1
  214. package/dist/core/session-store.d.ts +84 -19
  215. package/dist/core/session-store.js +162 -24
  216. package/dist/core/session.d.ts +92 -1
  217. package/dist/core/shell-read-silence.js +1 -0
  218. package/dist/core/shell-wrapper-projection.d.ts +1 -1
  219. package/dist/core/steer-replay.d.ts +4 -2
  220. package/dist/core/steer-replay.js +2 -1
  221. package/dist/core/store-contracts/background-agent-store-contract.js +1 -0
  222. package/dist/core/store-contracts/checkpoint-store-contract.js +19 -1
  223. package/dist/core/store-contracts/file-history-store-contract.js +9 -0
  224. package/dist/core/store-contracts/mailbox-store-contract.js +49 -1
  225. package/dist/core/store-contracts/session-repo-contract.js +112 -5
  226. package/dist/core/store-contracts/session-store-contract.d.ts +4 -1
  227. package/dist/core/store-contracts/session-store-contract.js +236 -2
  228. package/dist/core/task-event.d.ts +68 -8
  229. package/dist/core/task-registry-agent.d.ts +8 -4
  230. package/dist/core/task-registry-agent.js +14 -8
  231. package/dist/core/task-registry-shared.d.ts +36 -6
  232. package/dist/core/task-registry-shared.js +11 -0
  233. package/dist/core/task-registry.d.ts +1 -1
  234. package/dist/core/task-registry.js +1 -1
  235. package/dist/core/task-spec.d.ts +37 -0
  236. package/dist/core/task-stream.d.ts +2 -1
  237. package/dist/core/terminal-cause.d.ts +1 -1
  238. package/dist/core/tool-catalog-entries.d.ts +6 -0
  239. package/dist/core/tool-catalog-entries.js +2 -0
  240. package/dist/core/tool-name-aliases.d.ts +32 -2
  241. package/dist/core/tool-name-aliases.js +23 -0
  242. package/dist/core/tool-name-readings.d.ts +4 -0
  243. package/dist/core/tool-name-readings.js +1 -0
  244. package/dist/core/tool-policy.d.ts +10 -6
  245. package/dist/core/tool-policy.js +4 -7
  246. package/dist/core/tool-result-store.d.ts +17 -10
  247. package/dist/core/tool-result-store.js +3 -1
  248. package/dist/core/trace.d.ts +4 -1
  249. package/dist/core/trace.js +2 -1
  250. package/dist/core/types.d.ts +1 -1
  251. package/dist/core/untrusted-egress.d.ts +18 -0
  252. package/dist/core/untrusted-egress.js +82 -12
  253. package/dist/core/wiring-manifest.d.ts +12 -3
  254. package/dist/core/wiring-manifest.js +4 -3
  255. package/dist/core/workspace-snapshot.d.ts +44 -0
  256. package/dist/core/workspace-snapshot.js +34 -0
  257. package/dist/core/write-protect.d.ts +43 -3
  258. package/dist/core/write-protect.js +43 -16
  259. package/dist/engine/execution-env/node-execution-env.js +15 -11
  260. package/dist/engine/execution-env/symlink-chain.d.ts +7 -5
  261. package/dist/engine/harness/agent-harness.d.ts +12 -5
  262. package/dist/engine/harness/agent-harness.js +13 -2
  263. package/dist/engine/harness/types.d.ts +48 -7
  264. package/dist/engine/harness/types.js +5 -1
  265. package/dist/engine/llm/types.d.ts +12 -3
  266. package/dist/engine/llm/types.js +1 -1
  267. package/dist/engine/loop/agent-loop.d.ts +1 -4
  268. package/dist/engine/loop/agent-loop.js +26 -4
  269. package/dist/engine/session/import-validate.js +3 -0
  270. package/dist/engine/session/memory-repo.d.ts +17 -9
  271. package/dist/engine/session/memory-repo.js +44 -34
  272. package/dist/engine/session/repo-utils.d.ts +22 -4
  273. package/dist/engine/session/repo-utils.js +49 -1
  274. package/dist/engine/session/storage-base.d.ts +10 -1
  275. package/dist/engine/session/storage-base.js +7 -1
  276. package/dist/index.d.ts +23 -11
  277. package/dist/index.js +15 -6
  278. package/dist/internal/harness-types.d.ts +1 -1
  279. package/dist/internal/harness.d.ts +4 -3
  280. package/dist/internal/harness.js +3 -2
  281. package/dist/stores/file/checkpoint-store.d.ts +0 -4
  282. package/dist/stores/file/checkpoint-store.js +0 -1
  283. package/dist/stores/file/file-history-store.js +12 -4
  284. package/dist/stores/file/index.d.ts +4 -1
  285. package/dist/stores/file/index.js +4 -1
  286. package/dist/stores/file/mailbox-store.d.ts +2 -1
  287. package/dist/stores/file/mailbox-store.js +26 -1
  288. package/dist/stores/file/session-store.d.ts +15 -8
  289. package/dist/stores/file/session-store.js +28 -13
  290. package/dist/tools/fs/bash-readonly-classifier.d.ts +15 -19
  291. package/dist/tools/fs/bash-readonly-classifier.js +5 -10
  292. package/dist/tools/fs/fs-bash.js +10 -3
  293. package/dist/tools/fs/fs-write.d.ts +6 -3
  294. package/dist/tools/fs/fs-write.js +8 -7
  295. package/dist/tools/fs/index.d.ts +3 -0
  296. package/dist/tools/fs/index.js +1 -1
  297. package/dist/tools/fs/pattern-kill-guard.d.ts +3 -2
  298. package/dist/tools/fs/pattern-kill-guard.js +68 -36
  299. package/dist/tools/fs/safety.js +40 -8
  300. package/dist/tools/fs/search.js +6 -24
  301. package/dist/tools/fs/shell-read-check.d.ts +18 -1
  302. package/dist/tools/fs/shell-read-check.js +66 -16
  303. package/dist/tools/fs/shell-read-establish.js +2 -1
  304. package/dist/tools/fs/shell-read-identity.d.ts +12 -9
  305. package/dist/tools/fs/shell-read-identity.js +10 -5
  306. package/dist/tools/fs/shell-read-judge.d.ts +10 -1
  307. package/dist/tools/web.js +9 -7
  308. package/dist/tools/worktree.d.ts +42 -15
  309. package/dist/tools/worktree.js +60 -32
  310. package/package.json +4 -2
  311. package/test/export-surface.snapshot.json +141 -3
  312. package/wire-changes/core-stores-sql@7.57.0.json +29 -0
  313. package/wire-changes/core-stores-sql@7.58.0.json +29 -0
  314. package/wire-changes/core@7.57.0.json +1487 -0
  315. package/wire-changes/core@7.58.0.json +2188 -0
  316. package/wire-changes/mods-kernel@7.57.0.json +29 -0
  317. package/wire-changes/mods-kernel@7.58.0.json +81 -0
  318. package/wire-changes/primitives@7.57.0.json +245 -0
  319. package/wire-changes/primitives@7.58.0.json +29 -0
@@ -136,6 +136,12 @@ export declare function headerListEntries(value: unknown): string[];
136
136
  * or keys answer differently on a second read cannot be judged as one bag and sent as another. */
137
137
  export declare function headerBagOnce(bag: Readonly<Record<string, string>> | undefined): Record<string, string> | undefined;
138
138
  export declare function mergeHeaders(...bags: Array<Record<string, string> | undefined>): Record<string, string>;
139
+ /** The values a request is DECLARED with ({@link import("./stream-engine.js").SSERequest.declared}): every value of the header bags it was
140
+ * built from — the route's credential headers included, as the merge after `applyRouteCredentialHeaders` holds them — the values the
141
+ * deployment or the call stated outside a bag (a configured protocol version, each entry of a list header the brain re-folds), and the
142
+ * key when it names a secret ({@link namesASecret}: a placeholder key is left in the words as it is left to every child). The values the
143
+ * brain writes itself (a structural lock, the default version, the beta entries it chose) are not among them. */
144
+ export declare function declaredRequestValues(bags: ReadonlyArray<Readonly<Record<string, string>> | undefined>, stated: ReadonlyArray<string | undefined>, key: string | undefined): string[];
139
145
  /**
140
146
  * The output-cap key(s) each lane's wire form uses. A lane's set is exactly the keys THAT lane's
141
147
  * endpoint reads — a stray cap key belonging to another wire form is inert there and must not be
@@ -1,4 +1,4 @@
1
- import { isCredentialHeaderName } from "../core/secret-env.js";
1
+ import { isCredentialHeaderName, namesASecret } from "../core/secret-env.js";
2
2
  import { isPlainRecord } from "../core/mods/kernel/receive.js";
3
3
  import { BrainError } from "./errors.js";
4
4
  export const OPENAI_RESERVED = new Set([
@@ -129,6 +129,19 @@ export function mergeHeaders(...bags) {
129
129
  }
130
130
  return out;
131
131
  }
132
+ export function declaredRequestValues(bags, stated, key) {
133
+ const out = new Set();
134
+ for (const bag of bags)
135
+ for (const value of Object.values(bag ?? {}))
136
+ if (typeof value === "string" && value !== "")
137
+ out.add(value);
138
+ for (const value of stated)
139
+ if (value !== undefined && value !== "")
140
+ out.add(value);
141
+ if (key !== undefined && namesASecret(key))
142
+ out.add(key);
143
+ return [...out];
144
+ }
132
145
  export const OUTPUT_CAP_KEYS = {
133
146
  openai: ["max_tokens", "max_completion_tokens"],
134
147
  anthropic: ["max_tokens"],
@@ -3,8 +3,9 @@ import { BrainError } from "./errors.js";
3
3
  import { reportCredentialOriginRefusal } from "./status-sink.js";
4
4
  import { receiptRefusal, receiveOwnProperties } from "../core/own-property-receipt.js";
5
5
  import { credentialHeaderValues, holdOwnCredentialValues, isCredentialHeaderName, isSchemedCredentialHeader } from "../core/secret-env.js";
6
+ import { REDACTION_MARKS } from "../core/redaction-marks.js";
6
7
  const REDACTED_VALUE = "«redacted»";
7
- const REDACTED_CREDENTIALS = "[redacted-credentials]";
8
+ const REDACTED_CREDENTIALS = REDACTION_MARKS.credentials;
8
9
  function servableParse(raw) {
9
10
  let u;
10
11
  try {
@@ -109,6 +109,12 @@ export declare const WAITING_FIRST_TOKEN_EVERY_MS = 30000;
109
109
  export interface SSERequest {
110
110
  url: string;
111
111
  headers: Record<string, string>;
112
+ /**
113
+ * Every header value this request was DECLARED with — the model entry's, the deployment's and the call's header bags as the
114
+ * route kept them, and the key — as the adapter built them. An endpoint's words lose these before the engine carries them
115
+ * ({@link remoteWords}); the engine's own protocol words (`content-type`, the version and the beta list it chose) are not declared.
116
+ */
117
+ declared: readonly string[];
112
118
  body: string;
113
119
  /**
114
120
  * The per-request output cap this request ACTUALLY carries on the wire, when the adapter sets one
@@ -194,6 +200,9 @@ export interface StreamControls {
194
200
  * raising the provider's own in-band failure from `finalize`: the terminal message the engine mints for that
195
201
  * failure keeps it (the text the provider streamed, the usage it reported), rather than an empty shell. */
196
202
  keepOutput(output: KeptOutput): void;
203
+ /** The provider's own words in an in-band failure, as the engine carries them: this attempt's request ({@link SSERequest.declared}) taken
204
+ * out, then the credential vocabulary. A judge that reads the frame (the condition, the input-too-long anchor) reads the raw words. */
205
+ providerWords(words: string): string;
197
206
  }
198
207
  /** The output a parser hands over with {@link StreamControls.keepOutput}. */
199
208
  export interface KeptOutput {
@@ -9,7 +9,7 @@ import { FAST_MAX_BACKOFF_MS, providerWaitHint, retryBackoffMs } from "./retry.j
9
9
  import { bindBrainStatusEmitter, emitBrainStatus, emitBrainTelemetry, reportExtraBodyDropped } from "./status-sink.js";
10
10
  import { createAttemptController, firstByteWindow, refuseRetiredTimeoutKnobs, resolveFirstByteRetries, resolveWatchdogMs, STALL_FIRST_BYTE_MS, STALL_FIRST_TOKEN_MS, STALL_IDLE_MS, } from "./timeout.js";
11
11
  import { readMember, thrownText } from "../core/thrown-value.js";
12
- import { egressText } from "../core/untrusted-egress.js";
12
+ import { remoteWords } from "../core/protocol-http-auth.js";
13
13
  const DEFAULT_MAX_RETRIES = 10;
14
14
  const MAX_RETRIES_ENV_CEILING = 15;
15
15
  const MAX_RETRIES_ENV = "SEMA_MAX_RETRIES";
@@ -294,6 +294,13 @@ export function runStreamingBrain(args) {
294
294
  let attemptPartial;
295
295
  let attemptOutput;
296
296
  let routeSeen;
297
+ let declaredSeen = [];
298
+ const echoCarried = (value, field) => {
299
+ if (remoteWords(value, declaredSeen) === value)
300
+ return value;
301
+ emitBrainTelemetry({ kind: "echo_dropped", field });
302
+ return undefined;
303
+ };
297
304
  void run()
298
305
  .catch((err) => {
299
306
  const aborted = signal?.aborted === true || isAbortError(err);
@@ -313,7 +320,8 @@ export function runStreamingBrain(args) {
313
320
  errorMsg.usage = kept.usage;
314
321
  }
315
322
  errorMsg.stopReason = aborted ? "aborted" : "error";
316
- errorMsg.errorMessage = thrownText(err);
323
+ const said = thrownText(err);
324
+ errorMsg.errorMessage = brainErrorCodeOf(err) !== undefined ? said : remoteWords(said, declaredSeen);
317
325
  const failure = aborted ? {} : thrownBrainFailure(err);
318
326
  if (failure.code !== undefined) {
319
327
  if (failure.errorKind !== undefined)
@@ -328,13 +336,17 @@ export function runStreamingBrain(args) {
328
336
  const statusNum = typeof status === "number" ? status : undefined;
329
337
  if (namesTheFailure(statusNum))
330
338
  errorMsg.apiErrorStatus = statusNum;
331
- if (requestIdSeen !== undefined)
332
- errorMsg.requestId = requestIdSeen;
339
+ const requestId = requestIdSeen === undefined ? undefined : echoCarried(requestIdSeen, "requestId");
340
+ if (requestId !== undefined)
341
+ errorMsg.requestId = requestId;
333
342
  if (routeSeen !== undefined)
334
343
  errorMsg.apiErrorRoute = routeSeen;
335
344
  const providerCode = readMember(err, "providerCode");
336
- if ((statusNum === undefined || refusedTheRequest(statusNum)) && typeof providerCode === "string" && isProviderEchoShape(providerCode))
337
- errorMsg.apiErrorCode = providerCode;
345
+ if ((statusNum === undefined || refusedTheRequest(statusNum)) && typeof providerCode === "string" && isProviderEchoShape(providerCode)) {
346
+ const apiErrorCode = echoCarried(providerCode, "apiErrorCode");
347
+ if (apiErrorCode !== undefined)
348
+ errorMsg.apiErrorCode = apiErrorCode;
349
+ }
338
350
  const condition = readMember(err, "providerCondition");
339
351
  const source = readMember(err, "providerConditionSource");
340
352
  if (isProviderCondition(condition) && isProviderConditionSource(source)) {
@@ -370,6 +382,7 @@ export function runStreamingBrain(args) {
370
382
  r.onCommitted?.();
371
383
  reportRequestStrip(model, r);
372
384
  routeSeen = admittedRequestRoute(r.route);
385
+ declaredSeen = r.declared;
373
386
  };
374
387
  commit(req);
375
388
  const dialect = resolveProviderDialect(req.url, model.api);
@@ -475,7 +488,7 @@ export function runStreamingBrain(args) {
475
488
  }
476
489
  else if (classifyFetchThrow(e) === "request_unbuildable") {
477
490
  cc.dispose();
478
- throw new BrainError("invalid_request", `${httpLabel} request could not be built: ${egressText("same-principal", stripUrlCredentials(thrownText(e)))}`);
491
+ throw new BrainError("invalid_request", `${httpLabel} request could not be built: ${remoteWords(stripUrlCredentials(thrownText(e)), req.declared)}`);
479
492
  }
480
493
  else {
481
494
  netErr = e;
@@ -634,14 +647,14 @@ export function runStreamingBrain(args) {
634
647
  continue;
635
648
  }
636
649
  if (netErr) {
637
- const chain = describeNetworkError(netErr);
650
+ const chain = remoteWords(describeNetworkError(netErr), req.declared);
638
651
  const proxyRefusal = connectReading?.proxyRefusal;
639
652
  throw new BrainError("network", proxyRefusal === undefined ? chain : `${proxyTunnelRefusedSentence(proxyRefusal.status)} — ${chain}`, undefined, { apiError: true });
640
653
  }
641
654
  if (r !== undefined && errorBody === undefined)
642
655
  errorBody = await readErrorBody(r, signal);
643
656
  const terminalVerdict = judge();
644
- const detail = errorBody?.text ?? "";
657
+ const detail = errorBody === undefined ? "" : remoteWords(errorBody.endedNormally ? errorBody.text : errorBody.text.replace(/\S+$/u, ""), req.declared);
645
658
  const status = r?.status ?? 0;
646
659
  const itl = terminalVerdict?.inputTooLong ?? "no";
647
660
  const providerCode = refusedTheRequest(status) ? readProviderErrorCode(errorBody) : undefined;
@@ -737,6 +750,7 @@ export function runStreamingBrain(args) {
737
750
  keepOutput: (output) => {
738
751
  attemptOutput = output;
739
752
  },
753
+ providerWords: (words) => remoteWords(words, req.declared),
740
754
  });
741
755
  const INBAND_OVERLOAD_WARNING = "API overloaded mid-response. The response above may be incomplete.";
742
756
  const onLineOverloadTierA = (line) => {
@@ -761,7 +775,7 @@ export function runStreamingBrain(args) {
761
775
  throw e;
762
776
  failure = {
763
777
  kind: "connection",
764
- err: new BrainError("network", `mid-stream read failed: ${describeNetworkError(e)}`, undefined, { apiError: true }),
778
+ err: new BrainError("network", `mid-stream read failed: ${remoteWords(describeNetworkError(e), req.declared)}`, undefined, { apiError: true }),
765
779
  };
766
780
  break readLoop;
767
781
  }
@@ -17,9 +17,10 @@ import { type AssistantMessage, type ModelOutputInvalid, type StreamDropCause }
17
17
  /** The warning (the reference's former words; later replaced by a resume request) stamped beside `partialFinalized` when a stream ended before its close — by the
18
18
  * mid-stream promotion (the body threw) and by the parsers' own finalize (content arrived, no finish frame). */
19
19
  export declare const STREAM_TORN_WARNING = "Connection closed mid-response. The response above may be incomplete.";
20
- /** A provider word as a stream-end seat carries it: the word in the provider echo shape, else `?` — the fact that a
21
- * word arrived survives, bytes outside the shape do not (the echo discipline: dropped, never rewritten). */
22
- export declare function echoFoldedWord(raw: string): string;
20
+ /** A provider word as a stream-end seat carries it: the word in the provider echo shape that the stream's mint
21
+ * (`providerWords`) leaves as it is, else `?` — the fact that a word arrived survives, bytes outside the shape or holding
22
+ * what the request was declared with do not (the echo discipline: dropped, never rewritten). */
23
+ export declare function echoFoldedWord(raw: string, providerWords: (words: string) => string): string;
23
24
  /**
24
25
  * The record of what arrived after a stream's first terminal statement — the one ordering rule both wire parsers
25
26
  * apply: the first ending (a finish / stop reason, a message stop, an in-band error) decides the turn; after it the
@@ -27,7 +28,7 @@ export declare function echoFoldedWord(raw: string): string;
27
28
  * here. Rides `AssistantMessage.streamEndIgnored` (the first refused frame's kind and word, how many came); the
28
29
  * Runner announces it (`route.stream_end_ignored`).
29
30
  */
30
- export declare function createStreamEndLedger(): {
31
+ export declare function createStreamEndLedger(providerWords: (words: string) => string): {
31
32
  note(statement: StreamEndStatement, word: string): void;
32
33
  readonly ignored: AssistantMessage["streamEndIgnored"];
33
34
  };
@@ -3,14 +3,14 @@ import { inspectDegenerate } from "./repetition.js";
3
3
  import { emitBrainTelemetry } from "./status-sink.js";
4
4
  import { stampStreamDrops } from "../internal/llm.js";
5
5
  export const STREAM_TORN_WARNING = "Connection closed mid-response. The response above may be incomplete.";
6
- export function echoFoldedWord(raw) {
7
- return isProviderEchoShape(raw) ? raw : "?";
6
+ export function echoFoldedWord(raw, providerWords) {
7
+ return isProviderEchoShape(raw) && providerWords(raw) === raw ? raw : "?";
8
8
  }
9
- export function createStreamEndLedger() {
9
+ export function createStreamEndLedger(providerWords) {
10
10
  let ignored;
11
11
  return {
12
12
  note(statement, word) {
13
- ignored = ignored === undefined ? { statement, word: echoFoldedWord(word), frames: 1 } : { ...ignored, frames: ignored.frames + 1 };
13
+ ignored = ignored === undefined ? { statement, word: echoFoldedWord(word, providerWords), frames: 1 } : { ...ignored, frames: ignored.frames + 1 };
14
14
  },
15
15
  get ignored() {
16
16
  return ignored;
@@ -1,4 +1,5 @@
1
1
  import type { AgentTool } from "../internal/harness-types.js";
2
+ import { type PeerSeat } from "./peer-seat.js";
2
3
  import { type HostFloor } from "./host-floor.js";
3
4
  import type { A2aServerSpec, ToolEffect } from "./types.js";
4
5
  /** The hard per-skill description bound (ruled 2026-08-03: ~2KiB). */
@@ -97,4 +98,4 @@ export declare class A2aRpcError extends Error {
97
98
  * `allSettled` keeps it fail-open: one unreachable peer is a skipped peer with a warning, never a task
98
99
  * that cannot start.
99
100
  */
100
- export declare function materializeA2aTools(specs: readonly A2aServerSpec[], principal?: string, signal?: AbortSignal, hostFloor?: HostFloor): Promise<MaterializedA2a>;
101
+ export declare function materializeA2aTools(specs: readonly A2aServerSpec[], principal?: string, signal?: AbortSignal, hostFloor?: HostFloor, peerSeat?: PeerSeat): Promise<MaterializedA2a>;
package/dist/core/a2a.js CHANGED
@@ -2,6 +2,7 @@ import { randomUUID } from "node:crypto";
2
2
  import { Type } from "typebox";
3
3
  import { A2A_TASK_STATES } from "./a2a-task-state.js";
4
4
  import { assertEndpointBound, carriesDeclaredHeaders, resolveProtocolHttpHeaders, underDeclaredHeaders } from "./protocol-http-auth.js";
5
+ import { PeerCarrier, carriedHttpHeaders, peerSeatMissing } from "./peer-seat.js";
5
6
  import { fetchFollowing, hopRefusal, HOST_FLOOR_REFUSED_CODE } from "./host-floor.js";
6
7
  import { describeHttpTransportFailure } from "./mcp-failure.js";
7
8
  import { findNamespacePrefixCollision, mintNamespacePrefix, mintNamespacedToolName } from "./protocol-naming.js";
@@ -147,18 +148,23 @@ async function requestJson(t, what, init) {
147
148
  const doFetch = resolveFetch();
148
149
  const deadline = withRequestDeadline(init.signal, init.timeoutMs);
149
150
  const peerLabel = inlineUntrusted(t.peer, A2A_ID_MAX_CHARS);
151
+ const pieces = await t.carrier.next(init.signal, init.url);
152
+ const carried = carriedHttpHeaders(A2A_NAMESPACE.id, t.carrier, pieces, t.principalHeader, t.principal);
153
+ assertEndpointBound(A2A_NAMESPACE.id, t.peer, init.url, t.declared, carried === undefined ? undefined : { ...carried });
150
154
  try {
151
155
  const followed = await fetchFollowing(doFetch, new URL(init.url), {
152
156
  method: init.method,
153
- headers: underDeclaredHeaders({ accept: "application/json", "a2a-version": A2A_PROTOCOL_VERSION, ...(init.body !== undefined ? { "content-type": "application/json" } : {}) }, t.headers),
157
+ headers: underDeclaredHeaders({ accept: "application/json", "a2a-version": A2A_PROTOCOL_VERSION, ...(init.body !== undefined ? { "content-type": "application/json" } : {}) }, carried === undefined ? undefined : { ...carried }),
154
158
  ...(init.body !== undefined ? { body: init.body } : {}),
155
159
  signal: deadline.signal,
156
- }, { refusal: (url) => hopRefusal(url, t.floor, false), follows: () => !carriesDeclaredHeaders(t.headers), maxRedirects: A2A_MAX_REDIRECTS });
160
+ }, { refusal: (url) => hopRefusal(url, t.floor, false), follows: () => !carriesDeclaredHeaders(carried === undefined ? undefined : { ...carried }), maxRedirects: A2A_MAX_REDIRECTS });
157
161
  if (followed.kind === "refused")
158
162
  throw Object.assign(new Error(`a2a: ${what} on peer "${peerLabel}" is not sent — ${followed.reason}`), { code: HOST_FLOOR_REFUSED_CODE });
159
163
  if (followed.kind === "too_many")
160
164
  throw new Error(`a2a: ${what} on peer "${peerLabel}" was redirected more than ${A2A_MAX_REDIRECTS} times`);
161
165
  const res = followed.res;
166
+ if (res.status === 401)
167
+ await t.carrier.rejected(pieces, init.signal, init.url);
162
168
  const text = await readBoundedText(res, `${what} from A2A peer "${peerLabel}"`);
163
169
  return { status: res.status, text };
164
170
  }
@@ -559,16 +565,23 @@ function declaredPeerOf(declared, index) {
559
565
  const judged = judgeEntryToolAxes(snapshot, "a2a");
560
566
  return judged.ok ? { spec: judged.entry } : { spec: snapshot, refusal: judged.error };
561
567
  }
562
- async function materializePeer(peer, principal, lifecycle, signal, floor) {
568
+ async function materializePeer(peer, principal, lifecycle, signal, floor, seat) {
563
569
  if ("refusal" in peer)
564
570
  throw peer.refusal;
565
571
  const { spec } = peer;
566
572
  const declaredAxes = spec.toolAxes;
567
- const headers = resolveProtocolHttpHeaders(A2A_NAMESPACE.id, spec, principal);
568
- const discovery = { peer: spec.name, endpoint: spec.url, headers, floor };
573
+ const missing = peerSeatMissing(`a2a: peer "${inlineUntrusted(spec.name, 120)}"`, spec.credentials, seat);
574
+ if (missing !== undefined)
575
+ throw missing;
576
+ resolveProtocolHttpHeaders(A2A_NAMESPACE.id, spec.principalHeader !== undefined ? { principalHeader: spec.principalHeader } : {}, principal);
577
+ const declared = spec.cardUrl === undefined ? [spec.url] : [spec.url, spec.cardUrl];
578
+ const identity = { protocol: "a2a", peer: spec.name, url: spec.url, ...(spec.cardUrl !== undefined ? { cardUrl: spec.cardUrl } : {}), destination: spec.url, ...(spec.credentials !== undefined ? { credentials: spec.credentials } : {}) };
579
+ const carrier = new PeerCarrier(seat, identity, principal, "a2a", spec.principalHeader !== undefined);
580
+ const asks = { carrier, principalHeader: spec.principalHeader, principal, declared, floor };
581
+ const discovery = { peer: spec.name, endpoint: spec.url, ...asks };
569
582
  const card = readCard(spec.name, await discoverCardBody(spec, discovery, signal), spec.url);
570
- assertEndpointBound(A2A_NAMESPACE.id, spec.name, card.endpoint, spec.cardUrl === undefined ? [spec.url] : [spec.url, spec.cardUrl], headers);
571
- const transport = { peer: spec.name, endpoint: card.endpoint, headers, floor };
583
+ assertEndpointBound(A2A_NAMESPACE.id, spec.name, card.endpoint, declared, carrier.last?.headers === undefined ? undefined : { ...carrier.last.headers });
584
+ const transport = { peer: spec.name, endpoint: card.endpoint, ...asks };
572
585
  const tools = [];
573
586
  const skillAxes = [];
574
587
  for (const skill of card.skills) {
@@ -598,7 +611,7 @@ function asPeerWarning(spec, err) {
598
611
  warning.code = "a2a.peer_unavailable";
599
612
  return warning;
600
613
  }
601
- export async function materializeA2aTools(specs, principal, signal, hostFloor) {
614
+ export async function materializeA2aTools(specs, principal, signal, hostFloor, peerSeat) {
602
615
  const peers = specs.map((spec, index) => declaredPeerOf(spec, index));
603
616
  if (peers.length > 0) {
604
617
  const collision = findNamespacePrefixCollision(A2A_NAMESPACE, peers.map((p) => p.spec.name));
@@ -616,7 +629,7 @@ export async function materializeA2aTools(specs, principal, signal, hostFloor) {
616
629
  const toolAxes = [];
617
630
  const warnings = [];
618
631
  const statuses = [];
619
- const settled = await Promise.allSettled(peers.map((peer) => materializePeer(peer, principal, lifecycle, signal, hostFloor)));
632
+ const settled = await Promise.allSettled(peers.map((peer) => materializePeer(peer, principal, lifecycle, signal, hostFloor, peerSeat)));
620
633
  for (let i = 0; i < peers.length; i++) {
621
634
  const spec = peers[i].spec;
622
635
  const outcome = settled[i];
@@ -651,7 +664,7 @@ export async function materializeA2aTools(specs, principal, signal, hostFloor) {
651
664
  }
652
665
  const previous = statuses.find((s) => s.name === spec.name)?.toolNames ?? [];
653
666
  try {
654
- const fresh = await materializePeer(target, principal, lifecycle, signal, hostFloor);
667
+ const fresh = await materializePeer(target, principal, lifecycle, signal, hostFloor, peerSeat);
655
668
  const names = fresh.tools.map((t) => t.name);
656
669
  results.push({
657
670
  peer: spec.name,
@@ -73,15 +73,6 @@ export type CompiledAllowEntry = {
73
73
  readonly kind: "domain";
74
74
  readonly rule: PersistedRule;
75
75
  };
76
- /**
77
- * THE near-miss reading of a tool name the judgment calls current: the spelling the run mounts when the run mounts no tool of this
78
- * exact name but one that differs from it only by case (`BASH` beside `Bash`), else `undefined`. Two kinds of name are never a near
79
- * miss, because the roster they would be read against is not the final one: an engine tool's (the engine mounts some of its tools
80
- * after a list is read) and a protocol tool's (a refresh mounts and unmounts them while the run goes on) — in both the exact
81
- * spelling can be the right one by the time it matters. Every station that asks "is this name a case twin of a mounted tool" reads
82
- * this answer: an entry list ({@link readRuleEntry}), a tool policy's name lists (the prepare-time policy-name audit).
83
- */
84
- export declare function nearMissSpellingOf(name: string, roster: ReadonlySet<string>): string | undefined;
85
76
  /**
86
77
  * THE universe a ROOT-facing tool-name list is read against: every name the engine's catalog carries, and the names the reader knows
87
78
  * are carried (`carried`). A list is root-facing when it bounds the tools of the run that holds it — the run's own `allowTools` /
@@ -135,7 +126,9 @@ export declare const AUTO_STRIPPED_PROGRAMS: readonly ["python", "python3", "pyt
135
126
  * disclosed.
136
127
  */
137
128
  export declare function autoStripped(compiled: CompiledAllowEntry, call: ToolCallRequest | undefined): boolean;
138
- /** {@link autoStripped} over a person's stored ALLOW row (a deny / ask row is never stripped; a path row never is). */
129
+ /** {@link autoStripped} over a person's stored ALLOW row, read as its list twin ({@link entryOfRow}): a row is stripped exactly when
130
+ * the entry spelling the same rule is (a deny / ask row never is; a row no grammar reads has no twin and is not stripped here — the
131
+ * lane reads no allow it cannot parse). */
139
132
  export declare function autoStrippedRule(rule: PersistedRule, call: ToolCallRequest): boolean;
140
133
  /** One row a list matcher reads. */
141
134
  export interface AllowEntryRow {
@@ -292,7 +285,7 @@ export type AccountedClass = "probe";
292
285
  * Exported (frozen) so a host that renders the card's "why it cannot be cleared" half reads the engine's row, never a copy. */
293
286
  export declare const SHADOW_REASON: Readonly<{
294
287
  readonly content_question: "the call is the engine's own question to a person";
295
- readonly hook: "a PreToolUse hook asks about this call — the deployment's own screening is answered by a person";
288
+ readonly hook: "an extension's screening asks about this call (a PreToolUse hook or a tool.check station) — the deployment's own screening is answered by a person";
296
289
  readonly ancestor: "the task that delegated this one owns this question";
297
290
  readonly dangerous_delete: "this removal targets a protected location (the filesystem root, a top-level directory, a home directory, or a workspace directory or one of its ancestors) — it is cleared by confirming this call, never by an allow rule";
298
291
  readonly unverifiable_delete: "this removal could not be verified safe — it is cleared by confirming this call, never by an allow rule";
@@ -308,6 +301,7 @@ export declare const SHADOW_REASON: Readonly<{
308
301
  readonly operator_forced: "this call arrived already marked as requiring confirmation (an earlier layer of this run, or the task that delegated it, judged it so) — it is cleared by confirming this call, never by a standing allow rule";
309
302
  readonly shell_floor: "this deployment mandates per-call confirmation for shell commands (shellGate: always)";
310
303
  readonly target_unresolved: "where this write leads on disk could not be determined (a link on the way could not be examined, or the environment could not resolve the target), so whether it lands on a guarded path is unknown — it is cleared by confirming this call: no standing rule and no automatic decider answers for it, though a wired approver seat can";
304
+ readonly write_protection_on_disk: "this write's target is on the deployment's write-protection table (the agent's own configuration is guarded one look per write) — it is cleared by confirming this call, never by a standing allow rule";
311
305
  readonly write_protection: "this write's target is on the deployment's write-protection table (the agent's own configuration is guarded one look per write) — it is cleared by confirming this call, never by a standing allow rule";
312
306
  readonly tool_marks_mcp: "this tool carries egress/irreversibility/interaction marks (a mandated confirmation a rule cannot clear)";
313
307
  readonly tool_marks_a2a: "this tool carries egress/irreversibility/interaction marks (a mandated confirmation a rule cannot clear)";
@@ -2,11 +2,11 @@ import { heldBy } from "./tool-name-readings.js";
2
2
  import { ruleIssue } from "./permission-rules.js";
3
3
  import { isCoveringRuleName, ruleNameCovers } from "./namespaced-rule-name.js";
4
4
  import { ruleSpellingOf } from "./permission-rule-syntax.js";
5
- import { judgeRuleToolName, splitNamespacedName } from "./tool-name-aliases.js";
5
+ import { splitNamespacedName, toolNameFaultOf } from "./tool-name-aliases.js";
6
6
  import { catalogToolNames, isShellFaceToolName } from "./tool-registry.js";
7
7
  import { ALLOW_RULE_MEMBERS } from "./allow-rule-shadow.js";
8
8
  import { callHostTargetOf } from "./host-target.js";
9
- import { COMMAND_RULE_TOOL, adjudicatePersistedDomainRules, adjudicatePersistedNameRules, commandCoverageOf, laneToolNamesOf, ruleContentOf, noticeRuleText, parseRuleText, programRunReachOf, ruleToolGrammarOf, commandPatternMayRun } from "./permission-rule-model.js";
9
+ import { adjudicatePersistedDomainRules, wholeToolRuleReaches, adjudicatePersistedNameRules, commandCoverageOf, laneToolNamesOf, ruleContentOf, noticeRuleText, parseRuleText, programRunReachOf, ruleToolGrammarOf, commandPatternMayRun } from "./permission-rule-model.js";
10
10
  import { pathRuleLaneAnswer } from "./runner/permission-rule-lanes.js";
11
11
  import { callTargetReadingOf } from "./effective-path-target.js";
12
12
  import { splitShellCompoundSegments } from "../tools/fs/bash-readonly-classifier.js";
@@ -25,30 +25,12 @@ export function nonListValueLabel(read) {
25
25
  function ruleRowOf(parsed) {
26
26
  return { ...parsed, scope: { kind: "global" }, adds: [{ dot: { actor: "list", counter: 1 }, origin: "user", createdAt: "" }] };
27
27
  }
28
- function mountedSpellingOf(name, roster) {
29
- const folded = name.toLowerCase();
30
- for (const mounted of roster)
31
- if (mounted.toLowerCase() === folded)
32
- return mounted;
33
- return undefined;
34
- }
35
- export function nearMissSpellingOf(name, roster) {
36
- if (roster.has(name) || catalogToolNames().has(name) || splitNamespacedName(name) !== undefined)
37
- return undefined;
38
- return mountedSpellingOf(name, roster);
39
- }
40
28
  export function rootFacingToolNames(carried) {
41
29
  return new Set([...catalogToolNames(), ...carried]);
42
30
  }
43
31
  function toolNameReading(name, roster, behavior) {
44
- const verdict = judgeRuleToolName(name, roster, behavior);
45
- if (verdict.kind === "unprefixed_namespace")
46
- return { kind: "inert", reason: "tool_name", verdict: verdict.kind };
47
- if (verdict.kind !== "current") {
48
- return { kind: "inert", reason: "tool_name", verdict: verdict.kind, guidance: verdict.guidance, ...(verdict.currentName !== undefined ? { currentName: verdict.currentName } : {}) };
49
- }
50
- const mounted = nearMissSpellingOf(name, roster);
51
- return mounted === undefined ? undefined : { kind: "inert", reason: "near_miss", currentName: mounted };
32
+ const fault = toolNameFaultOf(name, roster, behavior);
33
+ return fault === undefined ? undefined : { kind: "inert", ...fault };
52
34
  }
53
35
  export function readRuleEntry(raw, behavior, roster) {
54
36
  const inert = (reason) => ({ kind: "inert", reason });
@@ -165,12 +147,22 @@ export function autoStripped(compiled, call) {
165
147
  }
166
148
  }
167
149
  export function autoStrippedRule(rule, call) {
168
- return rule.behavior === "allow" && rule.tool === COMMAND_RULE_TOOL && autoStripped({ kind: "command", rule }, call);
150
+ if (rule.behavior !== "allow")
151
+ return false;
152
+ const entry = entryOfRow(rule);
153
+ return entry !== undefined && autoStripped(entry, call);
154
+ }
155
+ function entryOfRow(rule) {
156
+ if (rule.match === "tool")
157
+ return isShellFaceToolName(rule.tool) ? { kind: "shell", name: rule.tool } : { kind: "tool", name: rule.tool };
158
+ const grammar = ruleToolGrammarOf(rule.tool);
159
+ return grammar === undefined ? undefined : { kind: grammar, rule };
169
160
  }
170
161
  const NO_LEADS = new Map();
171
162
  function nameRowReaches(compiled, req) {
172
- const covers = compiled.kind === "covering" ? (n) => ruleNameCovers(compiled.pattern, n) : compiled.kind === "tool" || compiled.kind === "shell" ? (n) => n === compiled.name : undefined;
173
- return covers !== undefined && answersTo(req, covers);
163
+ if (compiled.kind === "tool" || compiled.kind === "shell")
164
+ return wholeToolRuleReaches(compiled.name, req);
165
+ return compiled.kind === "covering" && answersTo(req, (n) => ruleNameCovers(compiled.pattern, n));
174
166
  }
175
167
  function commandOf(req) {
176
168
  const tool = laneToolNamesOf(req).find((n) => ruleToolGrammarOf(n) === "command");
@@ -376,7 +368,7 @@ export function readAllowRuleShadows(value) {
376
368
  }
377
369
  export const SHADOW_REASON = Object.freeze({
378
370
  content_question: "the call is the engine's own question to a person",
379
- hook: "a PreToolUse hook asks about this call — the deployment's own screening is answered by a person",
371
+ hook: "an extension's screening asks about this call (a PreToolUse hook or a tool.check station) — the deployment's own screening is answered by a person",
380
372
  ancestor: "the task that delegated this one owns this question",
381
373
  dangerous_delete: "this removal targets a protected location (the filesystem root, a top-level directory, a home directory, or a workspace directory or one of its ancestors) — it is cleared by confirming this call, never by an allow rule",
382
374
  unverifiable_delete: "this removal could not be verified safe — it is cleared by confirming this call, never by an allow rule",
@@ -392,6 +384,7 @@ export const SHADOW_REASON = Object.freeze({
392
384
  operator_forced: "this call arrived already marked as requiring confirmation (an earlier layer of this run, or the task that delegated it, judged it so) — it is cleared by confirming this call, never by a standing allow rule",
393
385
  shell_floor: MANDATE_DISCLOSURE.operator_always,
394
386
  target_unresolved: MANDATE_DISCLOSURE.target_unresolved,
387
+ write_protection_on_disk: MANDATE_DISCLOSURE.write_protection,
395
388
  write_protection: MANDATE_DISCLOSURE.write_protection,
396
389
  tool_marks_mcp: MANDATE_DISCLOSURE.tool_marks,
397
390
  tool_marks_a2a: MANDATE_DISCLOSURE.tool_marks,
@@ -1,6 +1,7 @@
1
1
  import type { PendingAction } from "./checkpoint-store.js";
2
2
  import type { CallTargetReading } from "./effective-path-target.js";
3
3
  import { type SkillGrantSource } from "./skill-grant.js";
4
+ import type { ReadLanding } from "../tools/fs/shell-read-identity.js";
4
5
  import type { ToolCallPathTarget, ToolFamily, ToolHostTarget } from "./tool-face.js";
5
6
  import { type ToolRosterEntry } from "./tool-roster.js";
6
7
  type ParkedApproval = Extract<PendingAction, {
@@ -16,6 +17,15 @@ export type ApprovalTargetRole = (typeof APPROVAL_TARGET_ROLES)[number];
16
17
  export type ApprovalTargets = {
17
18
  readonly [R in ApprovalTargetRole]?: string | null;
18
19
  };
20
+ /** The row's `targetReads` member: per read candidate the shell read station judged for the parked bytes (its key's
21
+ * digest), where it landed (its settled targets' digest — a pattern lands on a set). A sibling of `targets`, not a key
22
+ * inside it: a reader that knows only the path roles reads an unknown key there as damage and spends the approval, where
23
+ * a member of its own carries its own word and that reader refuses the row unread (`version_newer`). Present exactly when
24
+ * the station judged the parked bytes — `{}` when it found no read candidate: a candidate appearing by the resume is a
25
+ * read the card did not cover. */
26
+ export type ApprovalTargetReads = {
27
+ readonly [candidate: string]: string;
28
+ };
19
29
  /** The tool member as the row carries it: every member optional (a row is read, never trusted to be whole). */
20
30
  export interface ApprovalTool {
21
31
  readonly capabilityId?: string;
@@ -29,17 +39,21 @@ export interface ApprovalTool {
29
39
  export interface ApprovalObject {
30
40
  /** Absent on a row minted before the identity members (all four absent): such a row binds the tool's name alone. */
31
41
  readonly tool?: ApprovalTool;
32
- /** The row's member as stored — read, validated, by the judge. */
42
+ /** The row's two target members as stored — read, validated, by the judge. */
33
43
  readonly targets?: unknown;
44
+ readonly targetReads?: unknown;
34
45
  readonly grants?: string;
35
46
  }
36
47
  /** The view of one parked approval's object. */
37
48
  export declare function approvalObjectOf(row: ParkedApproval): ApprovalObject;
38
- /** The `targets` member of a reading: per role, the canonical view, or `null` for a view the environment was asked for
39
- * and did not answer; nothing when no role was read either way (or no reading was taken). The park mints it from the
40
- * gate's reading of the parked bytes; the execution station reads the bytes that will run the same way. */
41
- export declare function approvalTargetsOf(reading: CallTargetReading | undefined): {
49
+ /** The TARGETS of a reading — the one mint of both members, for the row and for the live call alike: `targets` per role,
50
+ * the canonical view, or `null` for a view the environment was asked for and did not answer (nothing when no role was read
51
+ * either way, or no reading was taken); `targetReads` per read candidate the shell read station judged, where it landed
52
+ * (nothing when the station judged no candidate of these bytes). The park mints them from the gate's readings of the parked
53
+ * bytes; the execution station reads the bytes that will run the same way. */
54
+ export declare function approvalTargetsOf(reading: CallTargetReading | undefined, reads?: readonly ReadLanding[]): {
42
55
  targets?: ApprovalTargets;
56
+ targetReads?: ApprovalTargetReads;
43
57
  };
44
58
  /** Where a resume judges the object: before the claim (the decided bytes), before the session is touched (the live
45
59
  * tool), right before the execution (the tool as mounted then — a host's re-dial can replace it between the two — and the
@@ -71,6 +85,8 @@ export interface LiveApprovalObject {
71
85
  readonly skillToolName?: string;
72
86
  /** execution: the reading of the bytes that will run, taken at this station (`undefined`: none could be taken). */
73
87
  readonly targetReading?: CallTargetReading | undefined;
88
+ /** execution: where this leg's shell read station found those bytes' reads land (`undefined`: it holds no judgment of them). */
89
+ readonly reads?: readonly ReadLanding[] | undefined;
74
90
  /** execution: the bytes the decision rewrote the call to, as the tool reads them; absent when it rewrote nothing. When
75
91
  * the row's binding does not cover them ({@link licenseCovers}, the one judge of "are these the approved bytes") the
76
92
  * person approved bytes whose target the row never recorded, and the targets member is not judged. */
@@ -5,22 +5,23 @@ import { toolIdentityOf } from "./tool-roster.js";
5
5
  import { inlineUntrusted } from "./untrusted-text.js";
6
6
  export const APPROVAL_TARGET_ROLES = Object.freeze(["protective", "declared"]);
7
7
  export function approvalObjectOf(row) {
8
- const { capabilityId, contractId, shapeDigest, implementationRevision, family, pathTarget, hostTarget, targets, boundGrantDigest } = row;
8
+ const { capabilityId, contractId, shapeDigest, implementationRevision, family, pathTarget, hostTarget, targets, targetReads, boundGrantDigest } = row;
9
9
  const carried = [capabilityId, contractId, shapeDigest, implementationRevision].some((m) => m !== undefined);
10
10
  return {
11
11
  ...(carried ? { tool: { capabilityId, contractId, shapeDigest, implementationRevision, family, pathTarget, hostTarget } } : {}),
12
12
  ...(targets !== undefined ? { targets } : {}),
13
+ ...(targetReads !== undefined ? { targetReads } : {}),
13
14
  ...(boundGrantDigest !== undefined ? { grants: boundGrantDigest } : {}),
14
15
  };
15
16
  }
16
- export function approvalTargetsOf(reading) {
17
+ export function approvalTargetsOf(reading, reads) {
17
18
  const targets = {};
18
19
  for (const role of APPROVAL_TARGET_ROLES) {
19
20
  const view = reading?.[role];
20
21
  if (view?.kind === "path" && (view.canonical !== undefined || view.unread === true))
21
22
  targets[role] = view.canonical ?? null;
22
23
  }
23
- return Object.keys(targets).length > 0 ? { targets } : {};
24
+ return { ...(Object.keys(targets).length > 0 ? { targets } : {}), ...(reads !== undefined ? { targetReads: Object.fromEntries(reads.map((r) => [r.key, r.landing])) } : {}) };
24
25
  }
25
26
  export const APPROVAL_STATION_MEMBERS = Object.freeze({
26
27
  claim: Object.freeze(["grants"]),
@@ -52,22 +53,48 @@ function judgeTool(row, live) {
52
53
  return { member: "tool", disposition: "veto", code: "resume.target_moved", message: vetoed(row.toolName, "the tool's face (its display family, or the path target or URL slot it declares) changed after the approval") };
53
54
  }
54
55
  function judgeTargets(row, live) {
55
- const bound = row.targets;
56
- if (bound === undefined || ("decided" in live && !licenseCovers(row.boundInputHash, live.decided)))
56
+ if ((row.targets === undefined && row.targetReads === undefined) || ("decided" in live && !licenseCovers(row.boundInputHash, live.decided)))
57
57
  return undefined;
58
- const roles = typeof bound === "object" && bound !== null && !Array.isArray(bound) ? Object.entries(bound) : [];
59
- const whole = roles.length > 0 && roles.every(([k, v]) => APPROVAL_TARGET_ROLES.includes(k) && (v === null || (typeof v === "string" && v.length > 0)));
60
- if (!whole)
61
- return { member: "targets", disposition: "veto", code: "resume.target_moved", message: vetoed(row.toolName, "the target member of the approval on its checkpoint row is damaged (not a reading → resolved location record)") };
62
- const now = approvalTargetsOf(live.targetReading).targets ?? {};
63
- const where = (p) => (p === null ? "did not resolve" : `resolved to ${shown(p)}`);
64
- for (const [role, was] of roles) {
65
- const is = now[role];
66
- if (is === was)
67
- continue;
68
- return { member: "targets", disposition: "veto", code: "resume.target_moved", message: vetoed(row.toolName, is === undefined ? `where its target resolves (it ${where(was)} when the card was asked) could not be established on this leg` : `its target ${is === null ? "does not resolve" : `resolves to ${shown(is)}`} now and ${where(was)} when the card was asked`) };
58
+ const why = landedElsewhere(row.targets, row.targetReads, live);
59
+ return why === undefined ? undefined : { member: "targets", disposition: "veto", code: "resume.target_moved", message: vetoed(row.toolName, why) };
60
+ }
61
+ const DIGEST = /^[0-9a-f]{64}$/;
62
+ function landedElsewhere(bound, boundReads, live) {
63
+ if (bound !== undefined) {
64
+ const roles = typeof bound === "object" && bound !== null && !Array.isArray(bound) ? Object.entries(bound) : [];
65
+ const whole = roles.length > 0 && roles.every(([k, v]) => APPROVAL_TARGET_ROLES.includes(k) && (v === null || (typeof v === "string" && v.length > 0)));
66
+ if (!whole)
67
+ return "the target member of the approval on its checkpoint row is damaged (not a reading → resolved location record)";
68
+ const now = approvalTargetsOf(live.targetReading).targets ?? {};
69
+ const where = (p) => (p === null ? "did not resolve" : `resolved to ${shown(p)}`);
70
+ for (const [role, was] of roles) {
71
+ const is = now[role];
72
+ if (is === was)
73
+ continue;
74
+ return is === undefined ? `where its target resolves (it ${where(was)} when the card was asked) could not be established on this leg` : `its target ${is === null ? "does not resolve" : `resolves to ${shown(is)}`} now and ${where(was)} when the card was asked`;
75
+ }
69
76
  }
70
- return undefined;
77
+ if (boundReads === undefined)
78
+ return undefined;
79
+ const record = typeof boundReads === "object" && boundReads !== null && !Array.isArray(boundReads);
80
+ const reads = record ? Object.entries(boundReads) : [];
81
+ if (!record || !reads.every(([k, v]) => DIGEST.test(k) && typeof v === "string" && DIGEST.test(v)))
82
+ return "the read member of the approval on its checkpoint row is damaged (not a read → landing record)";
83
+ if (live.reads === undefined)
84
+ return `where its reads land (the read station judged ${reads.length} when the card was asked) could not be established on this leg`;
85
+ const was = new Map(reads);
86
+ const now = new Map(Object.entries(approvalTargetsOf(undefined, live.reads).targetReads ?? {}));
87
+ const named = (key) => live.reads?.find((r) => r.key === key);
88
+ const added = [...now.keys()].find((k) => !was.has(k));
89
+ if (added !== undefined || [...was.keys()].some((k) => !now.has(k)))
90
+ return `this leg reads the command differently than when the card was asked (${added !== undefined ? `${shown(named(added)?.raw ?? "?")} is read now at a place or in a form the card did not cover` : "a read the card covered is not read now"})`;
91
+ const movedKey = [...now.keys()].find((k) => now.get(k) !== was.get(k));
92
+ const moved = movedKey === undefined ? undefined : named(movedKey);
93
+ if (movedKey === undefined)
94
+ return undefined;
95
+ const targets = moved?.targets ?? [];
96
+ const at = targets.length === 0 ? "cannot be placed" : `lands on ${shown(targets[0])}${targets.length > 1 ? ` (and ${targets.length - 1} more)` : ""}`;
97
+ return `its read ${shown(moved?.raw ?? "?")} ${at} now, not where it landed when the card was asked`;
71
98
  }
72
99
  function judgeGrants(row, live, station) {
73
100
  const refusal = parkedSkillApprovalRefusal(row, live.args, live.skills ?? [], live.skillToolName ?? "", station);