@jbkjr/relay 0.0.0-stage → 1.2.1

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 (296) hide show
  1. package/LICENSE +21 -0
  2. package/LICENSES/Apache-2.0.txt +201 -0
  3. package/LICENSES/README.md +19 -0
  4. package/LICENSES/codex-NOTICE.txt +6 -0
  5. package/README.md +386 -2
  6. package/SECURITY.md +145 -0
  7. package/adapters/briefs/claude.md +43 -0
  8. package/adapters/briefs/codex.md +56 -0
  9. package/adapters/briefs/models.json +33 -0
  10. package/adapters/build.mjs +8 -0
  11. package/adapters/claude/.claude-plugin/marketplace.json +13 -0
  12. package/adapters/claude/relay/.claude-plugin/plugin.json +5 -0
  13. package/adapters/claude/relay/agents/codex.md +21 -0
  14. package/adapters/claude/relay/agents/operator.md +21 -0
  15. package/adapters/claude/relay/skills/ask/SKILL.md +20 -0
  16. package/adapters/claude/relay/skills/chat/SKILL.md +13 -0
  17. package/adapters/claude/relay/skills/delegate/SKILL.md +21 -0
  18. package/adapters/claude/relay/skills/discuss/SKILL.md +19 -0
  19. package/adapters/claude/relay/skills/review/SKILL.md +21 -0
  20. package/adapters/claude/relay/skills/tree/SKILL.md +10 -0
  21. package/adapters/claude/relay/skills/write-for-codex/SKILL.md +78 -0
  22. package/adapters/codex/.agents/plugins/marketplace.json +20 -0
  23. package/adapters/codex/AGENTS.snippet.md +5 -0
  24. package/adapters/codex/relay/.codex-plugin/plugin.json +6 -0
  25. package/adapters/codex/relay/skills/relay-ask/SKILL.md +20 -0
  26. package/adapters/codex/relay/skills/relay-chat/SKILL.md +13 -0
  27. package/adapters/codex/relay/skills/relay-delegate/SKILL.md +21 -0
  28. package/adapters/codex/relay/skills/relay-discuss/SKILL.md +19 -0
  29. package/adapters/codex/relay/skills/relay-review/SKILL.md +21 -0
  30. package/adapters/codex/relay/skills/relay-tree/SKILL.md +10 -0
  31. package/adapters/codex/relay/skills/relay-write-for-claude/SKILL.md +66 -0
  32. package/adapters/generate.mjs +124 -0
  33. package/bin/relay +59 -0
  34. package/codex-pin.json +12 -0
  35. package/dist/backends/acp.js +1424 -0
  36. package/dist/backends/claude.js +890 -0
  37. package/dist/backends/cli-version.js +112 -0
  38. package/dist/backends/codex-app.js +1525 -0
  39. package/dist/backends/codex-daybreak.js +75 -0
  40. package/dist/backends/codex-env.js +656 -0
  41. package/dist/backends/codex-network.js +304 -0
  42. package/dist/backends/codex-pin.js +320 -0
  43. package/dist/backends/codex-shell-policy.js +182 -0
  44. package/dist/backends/codex-stage2.js +998 -0
  45. package/dist/backends/codex-subagents.js +47 -0
  46. package/dist/backends/codex.js +637 -0
  47. package/dist/backends/copilot.js +246 -0
  48. package/dist/backends/env.js +147 -0
  49. package/dist/backends/gemini.js +607 -0
  50. package/dist/backends/grok.js +337 -0
  51. package/dist/backends/index.js +8 -0
  52. package/dist/backends/native-temp.js +187 -0
  53. package/dist/backends/never-admission.js +90 -0
  54. package/dist/backends/run.js +67 -0
  55. package/dist/backends/stream.js +230 -0
  56. package/dist/backends/tool-discovery.js +15 -0
  57. package/dist/backends/types.js +264 -0
  58. package/dist/build-info.json +5 -0
  59. package/dist/cli.js +344 -0
  60. package/dist/confine/bridge.js +113 -0
  61. package/dist/confine/broker-core.js +76 -0
  62. package/dist/confine/broker-http.js +650 -0
  63. package/dist/confine/broker-names.js +9 -0
  64. package/dist/confine/broker.js +258 -0
  65. package/dist/confine/canary.js +380 -0
  66. package/dist/confine/diagnostics.js +122 -0
  67. package/dist/confine/gemini-tools-main.js +8 -0
  68. package/dist/confine/gemini-tools.js +181 -0
  69. package/dist/confine/hardlinks.js +58 -0
  70. package/dist/confine/harness-config.js +16 -0
  71. package/dist/confine/index.js +117 -0
  72. package/dist/confine/leases.js +217 -0
  73. package/dist/confine/paths.js +6 -0
  74. package/dist/confine/peer.js +115 -0
  75. package/dist/confine/port-policy.js +8 -0
  76. package/dist/confine/ports.js +365 -0
  77. package/dist/confine/private-root.js +208 -0
  78. package/dist/confine/probe-stage2.js +501 -0
  79. package/dist/confine/probe.js +1109 -0
  80. package/dist/confine/proxy.js +783 -0
  81. package/dist/confine/sbcheck.js +208 -0
  82. package/dist/confine/seatbelt-never.js +41 -0
  83. package/dist/confine/seatbelt-stage2.js +139 -0
  84. package/dist/confine/seatbelt.js +1129 -0
  85. package/dist/confine/sockets.js +36 -0
  86. package/dist/confine/turn-probe.js +19 -0
  87. package/dist/confine/turn.js +86 -0
  88. package/dist/core/adoption.js +124 -0
  89. package/dist/core/api-keys.js +423 -0
  90. package/dist/core/approvals.js +740 -0
  91. package/dist/core/build-identity.js +248 -0
  92. package/dist/core/caller.js +749 -0
  93. package/dist/core/calls.js +102 -0
  94. package/dist/core/claude-settings.js +1045 -0
  95. package/dist/core/config.js +453 -0
  96. package/dist/core/context.js +186 -0
  97. package/dist/core/db.js +753 -0
  98. package/dist/core/dispatch.js +110 -0
  99. package/dist/core/env-broker.js +505 -0
  100. package/dist/core/env-policy.js +182 -0
  101. package/dist/core/escalation-authority.js +76 -0
  102. package/dist/core/escalation-contract.js +13 -0
  103. package/dist/core/escalation-person-path.js +131 -0
  104. package/dist/core/escalation-policy.js +79 -0
  105. package/dist/core/escalation-runtime.js +135 -0
  106. package/dist/core/escalation-state.js +42 -0
  107. package/dist/core/escalations.js +191 -0
  108. package/dist/core/events.js +235 -0
  109. package/dist/core/executables.js +147 -0
  110. package/dist/core/extensions.js +645 -0
  111. package/dist/core/families.js +204 -0
  112. package/dist/core/git.js +657 -0
  113. package/dist/core/identity.js +113 -0
  114. package/dist/core/liveness.js +68 -0
  115. package/dist/core/mediated-network-provider.js +81 -0
  116. package/dist/core/never-checkpoint.js +76 -0
  117. package/dist/core/never-coverage.js +97 -0
  118. package/dist/core/never-network.js +49 -0
  119. package/dist/core/never-policy.js +302 -0
  120. package/dist/core/never-proxy-policy.js +109 -0
  121. package/dist/core/never-schema.js +61 -0
  122. package/dist/core/never-tools.js +56 -0
  123. package/dist/core/notices.js +48 -0
  124. package/dist/core/ops.js +959 -0
  125. package/dist/core/outcome.js +224 -0
  126. package/dist/core/params.js +32 -0
  127. package/dist/core/presence.js +174 -0
  128. package/dist/core/procs.js +546 -0
  129. package/dist/core/prompts.js +363 -0
  130. package/dist/core/protected-config.js +238 -0
  131. package/dist/core/raw-network.js +192 -0
  132. package/dist/core/redact.js +152 -0
  133. package/dist/core/refusal.js +33 -0
  134. package/dist/core/relay-command.js +310 -0
  135. package/dist/core/reported.js +3 -0
  136. package/dist/core/restart-overlay.js +651 -0
  137. package/dist/core/retention.js +1135 -0
  138. package/dist/core/secrets.js +329 -0
  139. package/dist/core/session-token.js +175 -0
  140. package/dist/core/session.js +744 -0
  141. package/dist/core/shell.js +2 -0
  142. package/dist/core/shipped-pin.js +47 -0
  143. package/dist/core/shown.js +42 -0
  144. package/dist/core/slots.js +67 -0
  145. package/dist/core/stage2-executors.js +453 -0
  146. package/dist/core/stage2-switch.js +5 -0
  147. package/dist/core/steering.js +149 -0
  148. package/dist/core/storage.js +358 -0
  149. package/dist/core/toml.js +175 -0
  150. package/dist/core/views.js +324 -0
  151. package/dist/core/wait.js +114 -0
  152. package/dist/core/wake.js +207 -0
  153. package/dist/core/watch.js +247 -0
  154. package/dist/core/worktree.js +213 -0
  155. package/dist/hosts/claude-desktop.js +274 -0
  156. package/dist/hosts/claude.js +249 -0
  157. package/dist/hosts/codex.js +329 -0
  158. package/dist/hosts/desktop-shared.js +20 -0
  159. package/dist/hosts/index.js +11 -0
  160. package/dist/hosts/types.js +4 -0
  161. package/dist/install/basics.js +18 -0
  162. package/dist/install/claude-init.js +133 -0
  163. package/dist/install/common.js +655 -0
  164. package/dist/install/doctor.js +629 -0
  165. package/dist/install/qualify-codex.js +205 -0
  166. package/dist/install.js +524 -0
  167. package/dist/mcp/elicit.js +209 -0
  168. package/dist/mcp/gateway.js +218 -0
  169. package/dist/mcp/host.js +253 -0
  170. package/dist/mcp/server.js +1124 -0
  171. package/dist/mcp/stdio.js +37 -0
  172. package/dist/modes/discussion.js +393 -0
  173. package/dist/modes/review.js +722 -0
  174. package/dist/native/relay-sbcheck +0 -0
  175. package/dist/targets/briefs.js +86 -0
  176. package/dist/targets/claude.js +94 -0
  177. package/dist/targets/codex.js +66 -0
  178. package/dist/targets/copilot.js +93 -0
  179. package/dist/targets/gemini.js +119 -0
  180. package/dist/targets/grok.js +126 -0
  181. package/dist/targets/index.js +192 -0
  182. package/dist/targets/types.js +18 -0
  183. package/dist/targets/verified.js +35 -0
  184. package/dist/worker.js +113 -0
  185. package/docs/UPGRADING.md +1502 -0
  186. package/docs/pinned-codex.md +321 -0
  187. package/experiments/stage2-redteam/lib/oracles.mjs +214 -0
  188. package/experiments/stage2-redteam/lib/report.mjs +35 -0
  189. package/npm-shrinkwrap.json +1632 -0
  190. package/package.json +82 -4
  191. package/scripts/codex-qualify/codex-pin-store.mjs +353 -0
  192. package/scripts/codex-qualify/codex-qualifier-process.mjs +265 -0
  193. package/scripts/codex-qualify/codex-qualifier.example.json +5 -0
  194. package/scripts/codex-qualify/codex-qualifier.mjs +281 -0
  195. package/scripts/codex-qualify/codex-shipped-pin.mjs +158 -0
  196. package/scripts/codex-qualify/codex-stage2-pin.mjs +48 -0
  197. package/scripts/codex-qualify/codex-stage2.mjs +2381 -0
  198. package/scripts/codex-qualify/install-codex-qualifier.mjs +98 -0
  199. package/scripts/codex-qualify/main-module.mjs +14 -0
  200. package/scripts/codex-qualify/relay-codex-qualifier.plist +37 -0
  201. package/scripts/codex-qualify/scratch-env.mjs +31 -0
  202. package/scripts/codex-qualify/session.mjs +96 -0
  203. package/scripts/codex-qualify/stage2-escalation-cases.mjs +125 -0
  204. package/test/codex-permissions.test.ts +875 -0
  205. package/test/fixtures/boundary-probes.mjs +17 -0
  206. package/test/fixtures/denial-stream-host.mjs +7 -0
  207. package/test/fixtures/families.json +246 -0
  208. package/test/fixtures/install-snapshots/claude-desktop-foreign.txt +158 -0
  209. package/test/fixtures/install-snapshots/claude-desktop-fresh.txt +101 -0
  210. package/test/fixtures/install-snapshots/claude-desktop-installed.txt +161 -0
  211. package/test/fixtures/install-snapshots/claude-foreign.txt +133 -0
  212. package/test/fixtures/install-snapshots/claude-fresh.txt +77 -0
  213. package/test/fixtures/install-snapshots/claude-installed.txt +133 -0
  214. package/test/fixtures/install-snapshots/codex-foreign.txt +159 -0
  215. package/test/fixtures/install-snapshots/codex-fresh.txt +107 -0
  216. package/test/fixtures/install-snapshots/codex-installed.txt +161 -0
  217. package/test/fixtures/link-parent.mjs +6 -0
  218. package/test/fixtures/mediated-command.cjs +72 -0
  219. package/test/fixtures/native-skill-isolation.json +280 -0
  220. package/test/fixtures/pinned-codex-app-server.mjs +25 -0
  221. package/test/fixtures/qualified-ext-adapters.mjs +36 -0
  222. package/test/fixtures/refusals/README.md +52 -0
  223. package/test/fixtures/refusals/claude-source-result.json +7 -0
  224. package/test/fixtures/refusals/openai-app-capacity.json +24 -0
  225. package/test/fixtures/refusals/openai-app-cyberPolicy.json +24 -0
  226. package/test/fixtures/refusals/openai-gpt-6-astra-max.json +12 -0
  227. package/test/fixtures/refusals/openai-gpt-6.1-sol-xhigh.json +12 -0
  228. package/test/fixtures/refusals/openai-review-capacity.json +24 -0
  229. package/test/fixtures/relay-0.2.0.sql +57 -0
  230. package/test/fixtures/relay-0.9.1.gen.mjs +212 -0
  231. package/test/fixtures/relay-0.9.1.sql +340 -0
  232. package/test/fixtures/slow-boundary-probes.mjs +37 -0
  233. package/test/fixtures/stable-surfaces/config.json +1122 -0
  234. package/test/fixtures/stable-surfaces/escalation.json +128 -0
  235. package/test/fixtures/stable-surfaces/events.json +37 -0
  236. package/test/fixtures/stable-surfaces/gemini-native-resume.json +4 -0
  237. package/test/fixtures/stable-surfaces/inbox.jsonl +2 -0
  238. package/test/fixtures/stable-surfaces/notice.txt +1 -0
  239. package/test/fixtures/stable-surfaces/refusal-item.json +28 -0
  240. package/test/fixtures/stable-surfaces/refusal-review.json +23 -0
  241. package/test/fixtures/stable-surfaces/registry.json +49 -0
  242. package/test/fixtures/stable-surfaces/tools-desktop.json +575 -0
  243. package/test/fixtures/stable-surfaces/tools.json +716 -0
  244. package/test/fixtures/stable-surfaces/usage.txt +46 -0
  245. package/test/fixtures/stage2-acp-native.mjs +138 -0
  246. package/test/fixtures/stage2-app-server.mjs +23 -0
  247. package/test/fixtures/stage2-catalog.json +91 -0
  248. package/test/fixtures/stage2-hostile-web.mjs +35 -0
  249. package/test/fixtures/stage2-native-network.mjs +62 -0
  250. package/test/fixtures/stage2-worker.ts +87 -0
  251. package/test/fixtures/status-views/expected.json +7825 -0
  252. package/test/fixtures/status-views/registries.json +1 -0
  253. package/test/fixtures/steering.json +209 -0
  254. package/test/helpers.ts +740 -0
  255. package/test/host-env.ts +7 -0
  256. package/test/keychain-decoy.ts +197 -0
  257. package/test/live-scope.ts +44 -0
  258. package/test/mediated-network.test.ts +192 -0
  259. package/test/mediated-proxy.test.ts +264 -0
  260. package/test/native-temp-alias.ts +10 -0
  261. package/test/never-policy.test.ts +629 -0
  262. package/test/never-tools.test.ts +136 -0
  263. package/test/process-home.ts +18 -0
  264. package/test/proxy.test.ts +531 -0
  265. package/test/restart-overlay-live.test.ts +85 -0
  266. package/test/restart-overlay-profile.test.ts +66 -0
  267. package/test/restart-overlay.test.ts +416 -0
  268. package/test/stable-surfaces.test.ts +249 -0
  269. package/test/stage2-escalation-live.test.ts +544 -0
  270. package/test/stage2-escalation-qualification.test.ts +170 -0
  271. package/test/stage2-escalation.test.ts +747 -0
  272. package/test/stage2-executor.test.ts +849 -0
  273. package/test/stage2-grant.test.ts +603 -0
  274. package/test/stage2-native-live.test.ts +647 -0
  275. package/test/stage2-network-decisions.test.ts +70 -0
  276. package/test/stage2-probe.test.ts +845 -0
  277. package/test/stage2-standing-live.test.ts +203 -0
  278. package/test/stubs/broker-host.mjs +59 -0
  279. package/test/stubs/broker-peer.mjs +20 -0
  280. package/test/stubs/confined-harness.mjs +91 -0
  281. package/test/stubs/ext-broken-server.mjs +2 -0
  282. package/test/stubs/ext-odd-server.mjs +21 -0
  283. package/test/stubs/ext-server.mjs +31 -0
  284. package/test/stubs/fake-host-cli.mjs +218 -0
  285. package/test/stubs/procargs.mjs +30 -0
  286. package/test/stubs/stub-acp +4 -0
  287. package/test/stubs/stub-agent.mjs +322 -0
  288. package/test/stubs/stub-claude +4 -0
  289. package/test/stubs/stub-codex +4 -0
  290. package/test/stubs/targets/acp.mjs +307 -0
  291. package/test/stubs/targets/claude.mjs +149 -0
  292. package/test/stubs/targets/codex.mjs +479 -0
  293. package/test/stubs/targets/gemini.mjs +604 -0
  294. package/test/temp-root.ts +11 -0
  295. package/test/wp4-adapters.test.ts +353 -0
  296. package/test/wp4-interlock.test.ts +136 -0
@@ -0,0 +1,66 @@
1
+ import "./helpers.ts";
2
+ import assert from "node:assert/strict";
3
+ import { test } from "node:test";
4
+ import { stage2NetworkRules, checkStage2Network } from "../dist/confine/seatbelt-stage2.js";
5
+ import { neverSeatbeltRules } from "../dist/confine/seatbelt-never.js";
6
+ import { resolveNeverPolicy } from "../dist/core/never-policy.js";
7
+
8
+ const net = (extra = {}) => ({ mode: "stage2" as const, deniedTcp: [49221], deniedUdp: [49222], relayRange: [49230, 49231, 49232, 49233], execPort: 49230, bindPorts: [], worktreeSockets: false, egress: "none" as const, ...extra });
9
+ function rules(n = net()) { const params: Record<string,string> = {}; return { text: stage2NetworkRules(n, (key, value) => { params[key] = value; return `(param "${key}")`; }, '(with message "decoy")', { tmpDir: "/owned/tmp", worktree: "/owned/work" }), params }; }
10
+
11
+ test("narrow overlay profile has no raw outbound, DNS or UDP listener authority", () => {
12
+ const p = rules();
13
+ assert.doesNotMatch(p.text, /allow network-outbound \(remote ip[46] "\*:\*"/);
14
+ assert.doesNotMatch(p.text, /mDNSResponder|dnssd|allow network-bind network-inbound \(local udp/);
15
+ assert.match(p.text, /allow network-bind network-inbound \(local tcp .*EXEC_PORT/);
16
+ });
17
+ test("approved IPv4 localhost connect compiles the disclosed localhost host token", () => {
18
+ const p = rules(net({ connectPorts: [49240] }));
19
+ assert.match(p.text, /allow network-outbound \(remote ip4 \(string-append "localhost:" \(param "CONNECT_PORT_0"\)\)\)/);
20
+ assert.doesNotMatch(p.text, /allow network-outbound \(remote ip6/);
21
+ });
22
+ test("localhost listen adds no connect authority", () => {
23
+ const listen = rules(net({ relayRange: [49230, 49231, 49232], bindPorts: [49233], listenPorts: [49240] }));
24
+ assert.match(listen.text, /allow network-bind network-inbound .*LISTEN_PORT_0/);
25
+ assert.doesNotMatch(listen.text, /CONNECT_PORT/);
26
+ });
27
+ test("port0 allow precedes final snapshot and reserved bind/inbound denies; executor startup survives", () => {
28
+ const p = rules(net({ relayRange: [49230, 49231, 49232], bindPorts: [49233], broadBind: true }));
29
+ assert.match(p.text, /0.0.0.0, on the LAN/);
30
+ const broad = p.text.indexOf('(allow network-bind network-inbound (local tcp "*:*")');
31
+ assert.ok(broad >= 0 && broad < p.text.indexOf('(deny network-inbound'));
32
+ assert.match(p.text, /deny network-bind network-inbound .*RELAY_LISTEN_DENY/);
33
+ assert.deepEqual(Object.entries(p.params).filter(([key]) => key.startsWith("RELAY_LISTEN_DENY")).map(([,v]) => Number(v)), [49231,49232]);
34
+ assert.doesNotMatch(p.text, /allow network-outbound \(remote ip/);
35
+ });
36
+ test("typed network refuses reserved, denied and malformed exact exceptions", () => {
37
+ for (const extra of [{ connectPorts: [49230] }, { listenPorts: [49230] }, { connectPorts: [0] }, { listenPorts: [65536] }, { connectPorts: [22] }, { listenPorts: [631] }, { egress: "unqualified" }]) assert.throws(() => checkStage2Network(net(extra)), /invalid|protected|static denied/);
38
+ const connect = rules(net({ relayRange: [49230, 49231, 49232], bindPorts: [49233], connectPorts: [49221], broadBind: true }));
39
+ assert.ok(connect.text.indexOf("CONNECT_PORT_0") > connect.text.indexOf('(deny network-outbound'));
40
+ const listen = rules(net({ relayRange: [49230, 49231, 49232], bindPorts: [49233], listenPorts: [49221] }));
41
+ assert.ok(listen.text.indexOf("LISTEN_PORT_0") > listen.text.indexOf('(deny network-inbound'));
42
+ assert.doesNotMatch(listen.text, /allow network-outbound/);
43
+ });
44
+ test("generated overlay network addresses contain only Seatbelt's supported host tokens", () => {
45
+ for (const extra of [{}, { connectPorts: [49240] }, { relayRange: [49230, 49231, 49232], bindPorts: [49233], listenPorts: [49240] }, { relayRange: [49230, 49231, 49232], bindPorts: [49233], broadBind: true }, { relayRange: [49230, 49231, 49232], bindPorts: [49233], egress: "raw" }]) {
46
+ const p = rules(net(extra));
47
+ const policy = resolveNeverPolicy({ builtins: false, never: { ports: [{ port: 49223, transport: "both", destinations: "this-machine" }] } });
48
+ const floor = neverSeatbeltRules(policy, (k,v) => { p.params[k] = v; return `(param "${k}")`; }, "", { worktree: "/owned/work", tmpDir: "/owned/tmp" }).join("\n");
49
+ const profile = (p.text + "\n" + floor).replace(/\(param "([^"]+)"\)/g, (_, k) => JSON.stringify(p.params[k]));
50
+ assert.doesNotMatch(profile, /\((?:remote|local)\s+(?:ip[46]?|tcp|udp)\s+(?:\(string-append\s+)?"(?:\d+\.\d+\.\d+\.\d+|\[?::1)/);
51
+ const hosts = [...profile.matchAll(/\((?:remote|local)\s+(?:ip[46]?|tcp|udp)\s+(?:\(string-append\s+)?"([^" ]+):/g)].map(m => m[1]);
52
+ assert.ok(hosts.length > 0);
53
+ assert.ok(hosts.every(h => h === "localhost" || h === "*"), JSON.stringify(hosts));
54
+ }
55
+ });
56
+ test("final never floor denies write/read/test/link and both listener operations after broad binds", () => {
57
+ const policy = resolveNeverPolicy({ builtins: false, never: { paths: [{ path: "/owned/forbidden", access: "all" }, { path: "/owned/install", access: "write" }], ports: [{ port: 49223, transport: "both", destinations: "this-machine" }] } });
58
+ const params: Record<string,string> = {};
59
+ const final = neverSeatbeltRules(policy, (k,v) => { params[k]=v; return `(param "${k}")`; }, '(with message "decoy")', { worktree: "/owned/work", tmpDir: "/owned/tmp" }).join("\n");
60
+ assert.match(final, /deny file-read\* file-read-data file-read-metadata file-test-existence file-write\*/);
61
+ assert.match(final, /file-write-data file-write-create file-write-unlink file-write-mode file-link/);
62
+ assert.match(final, /deny network-bind network-inbound \(local tcp/);
63
+ assert.match(final, /deny network-bind network-inbound \(local udp/);
64
+ assert.match(final, /require-all \(remote ip6/);
65
+ assert.equal(params.NEVER_PORT_0, "49223");
66
+ });
@@ -0,0 +1,416 @@
1
+ import "./helpers.ts";
2
+ import assert from "node:assert/strict";
3
+ import fs from "node:fs";
4
+ import os from "node:os";
5
+ import path from "node:path";
6
+ import { test } from "node:test";
7
+ import { closeDbForTests, createRun, db, insertNode, insertTurn, updateTurn } from "../dist/core/db.js";
8
+ import { withDefaults } from "../dist/core/config.js";
9
+ import { allowOverlay, assertOverlayLaunch, consumeOverlay, createOverlayRequest, finishOverlay, getOverlay, markOverlayLaunched, markOverlayReceipt, nextOverlayTurn, originOverlay, overlayInterlock, overlayPrompt, overlayTurnProblem, prepareOverlayRestart, reapOverlays, setOverlayClockForTests, overlayDeadlineExpired, settleOverlayRequestInTransaction } from "../dist/core/restart-overlay.js";
10
+ import { tx, setParam } from "../dist/core/db.js";
11
+ import { reserveLaunch, finishLaunchReservation, launchReservationState } from "../dist/core/restart-overlay.js";
12
+ import { stage2Wanted } from "../dist/backends/codex-stage2.js";
13
+ import { targetDef } from "../dist/targets/index.js";
14
+ import { executorPolicy } from "../dist/backends/codex-env.js";
15
+ import { seatbeltProfile } from "../dist/confine/seatbelt.js";
16
+ import { readNeverFloor } from "../dist/core/never-checkpoint.js";
17
+ import { setOverlayControlSnapshotForTests } from "../dist/core/restart-overlay.js";
18
+
19
+ setOverlayControlSnapshotForTests(() => ({ ports: [], controlPlanes: [] }));
20
+
21
+ function fixture() {
22
+ const home = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), "overlay-")));
23
+ const old = { RELAY_HOME: process.env.RELAY_HOME, RELAY_CONFIG: process.env.RELAY_CONFIG };
24
+ process.env.RELAY_HOME = path.join(home, "registry");
25
+ process.env.RELAY_CONFIG = path.join(home, "config.json");
26
+ const cfg = withDefaults({ targets: { codex: { stage2: true } }, job_timeout_s: null, turn_timeout_s: null });
27
+ fs.writeFileSync(process.env.RELAY_CONFIG, JSON.stringify(cfg));
28
+ const run = createRun(home, cfg, "test-root");
29
+ const cwd = path.join(home, "work"); fs.mkdirSync(cwd);
30
+ insertNode({ id: "j_overlay", run_id: run, kind: "job", target: "codex", mode: "write", depth: 1, task: "test", cwd, status: "running" });
31
+ const origin = insertTurn("j_overlay", "initial", "test", "write", "running");
32
+ let wall = 100_000, mono = 1000;
33
+ setOverlayClockForTests({ wall: () => wall, mono: () => mono, boot: () => "unit-boot", owner: () => ({ pid: process.pid, start: "unit-start" }) });
34
+ const request = (extra = {}) => createOverlayRequest({ nodeId: "j_overlay", originTurn: origin, capabilities: [{ kind: "port0" }], reason: "tests", continuation: "continue tests", authority: { owningRoot: "root-session", tokenBinding: "nonsecret-version-1", required_decider: "owning_run_root" }, ...extra });
35
+ const allow = (r = request()) => allowOverlay(run, r.id, r.digest, { decisionId: "decision-1", decidedBy: "root-session", route: "supervisor", at: wall });
36
+ const ready = () => { const r = allow(); markOverlayReceipt(run, r.id, true); updateTurn(origin, { status: "done" }); return prepareOverlayRestart(run, r.id, { clean: true }); };
37
+ return { home, run, origin, request, allow, ready, clock(w: number, m: number) { wall = w; mono = m; }, close() { setOverlayClockForTests(null); closeDbForTests(); for (const [k,v] of Object.entries(old)) if (v === undefined) delete process.env[k]; else process.env[k] = v; fs.rmSync(home, { recursive: true, force: true }); } };
38
+ }
39
+
40
+ test("overlay allow closes origin with durable receipt; no destination before receipt and verified teardown", () => {
41
+ const f = fixture(); try {
42
+ const r = f.allow();
43
+ assert.equal(r.state, "pending_restart");
44
+ assert.match(r.receipt!.disclosures.join(" "), /reserved block of 4 TCP ports \(\$PORT\/\$PORTS\).*LAN and tailnet/);
45
+ assert.match(overlayTurnProblem("j_overlay", f.origin)!, /closing/);
46
+ assert.equal(originOverlay("j_overlay", f.origin)?.id, r.id);
47
+ assert.throws(() => prepareOverlayRestart(f.run, r.id, { clean: true }), /receipt|origin/);
48
+ markOverlayReceipt(f.run, r.id, true); updateTurn(f.origin, { status: "done" });
49
+ const tainted = prepareOverlayRestart(f.run, r.id, { clean: false, problem: "detached survivor" });
50
+ assert.equal(tainted.state, "tainted");
51
+ assert.match(overlayInterlock("local")!, /tainted/);
52
+ assert.throws(() => consumeOverlay(f.run, r.id, 999), /ready|destination/);
53
+ } finally { f.close(); }
54
+ });
55
+
56
+ test("listen disclosure names its port and the opened job block with LAN and tailnet exposure", () => {
57
+ const f = fixture(); try {
58
+ const r = f.request({ capabilities: [{ kind: "localhost", operation: "listen", port: 49240 }] });
59
+ const text = r.request.disclosures.join(" ");
60
+ assert.match(text, /TCP listen port 49240.*LAN and tailnet/);
61
+ assert.match(text, /reserved block of 4 TCP ports \(\$PORT\/\$PORTS\).*LAN and tailnet/);
62
+ } finally { f.close(); }
63
+ });
64
+
65
+ test("destination is assigned atomically, consumed once, never inherited by unrelated resume", () => {
66
+ const f = fixture(); try {
67
+ const r = f.ready(); assert.ok(r.destinationTurn);
68
+ assert.throws(() => consumeOverlay(f.run, r.id, r.destinationTurn! + 1), /destination/);
69
+ const consumed = consumeOverlay(f.run, r.id, r.destinationTurn!);
70
+ assert.equal(consumed.state, "running");
71
+ assert.equal(consumed.budgetMs, 3_600_000);
72
+ assert.equal(consumed.recoveryDeadline, 3_700_000);
73
+ assert.throws(() => consumeOverlay(f.run, r.id, r.destinationTurn!), /consum/);
74
+ assert.match(overlayTurnProblem("j_overlay", 999)!, /overlay/);
75
+ assert.equal(finishOverlay(f.run, r.id, { clean: true }).state, "expired");
76
+ assert.equal(overlayTurnProblem("j_overlay", 999), null);
77
+ } finally { f.close(); }
78
+ });
79
+
80
+ test("default deadline is monotonic through backward wall clocks and approval pauses", () => {
81
+ const f = fixture(); try {
82
+ const r = f.ready(); const c = consumeOverlay(f.run, r.id, r.destinationTurn!);
83
+ f.clock(90_000, 3_601_001);
84
+ assert.equal(overlayDeadlineExpired(c), true);
85
+ assert.match(overlayTurnProblem("j_overlay", r.destinationTurn!)!, /deadline/);
86
+ assert.equal(getOverlay(f.run, r.id).state, "stopping");
87
+ assert.equal(finishOverlay(f.run, r.id, { clean: false, problem: "survivors" }).state, "tainted");
88
+ } finally { f.close(); }
89
+ });
90
+
91
+ test("tighter bounds and pending expiry cannot be renewed by a late allow", () => {
92
+ const f = fixture(); try {
93
+ const r = f.request({ remainingMs: 700 });
94
+ assert.equal(r.budgetMs, 700);
95
+ f.clock(101_000, 2000);
96
+ assert.throws(() => f.allow(r), /expir/);
97
+ } finally { f.close(); }
98
+ });
99
+
100
+ test("worker death recovery stops app first and retains taint until a clean reap", () => {
101
+ const f = fixture(); try {
102
+ const r = f.ready(); consumeOverlay(f.run, r.id, r.destinationTurn!);
103
+ const order: string[] = [];
104
+ reapOverlays(f.run, { ownerAlive: () => false, stop: () => { order.push("app-first-stop"); return { clean: false, problem: "sweep uncertain" }; } });
105
+ assert.deepEqual(order, ["app-first-stop"]); assert.equal(getOverlay(f.run, r.id).state, "tainted");
106
+ reapOverlays(f.run, { ownerAlive: () => false, stop: () => ({ clean: true }) });
107
+ assert.equal(getOverlay(f.run, r.id).state, "expired");
108
+ assert.equal(overlayInterlock("local"), null);
109
+ } finally { f.close(); }
110
+ });
111
+
112
+ test("never additions and grant changes invalidate pending approval at launch", () => {
113
+ const f = fixture(); try {
114
+ const r = f.ready();
115
+ fs.writeFileSync(process.env.RELAY_CONFIG!, JSON.stringify(withDefaults({ never: { ports: [{ port: 49222 }] } })));
116
+ assert.throws(() => consumeOverlay(f.run, r.id, r.destinationTurn!), /never.*changed/);
117
+ assert.equal(getOverlay(f.run, r.id).state, "ready");
118
+ } finally { f.close(); }
119
+ });
120
+
121
+ test("WP6 floor: add before approve, remove before launch and registry reload never shrink the approved floor", () => {
122
+ const f = fixture(); try {
123
+ const decoy = path.join(f.home, "never-decoy"); fs.mkdirSync(decoy);
124
+ fs.writeFileSync(process.env.RELAY_CONFIG!, JSON.stringify(withDefaults({ never: { paths: [{ path: decoy }] } })));
125
+ const r = f.allow();
126
+ markOverlayReceipt(f.run, r.id, true); updateTurn(f.origin, { status: "done" });
127
+ const saved = readNeverFloor(f.run)!;
128
+ fs.writeFileSync(process.env.RELAY_CONFIG!, JSON.stringify(withDefaults({})));
129
+ closeDbForTests();
130
+ const ready = prepareOverlayRestart(f.run, r.id, { clean: true });
131
+ const consumed = consumeOverlay(f.run, r.id, ready.destinationTurn!);
132
+ assert.equal(consumed.state, "running");
133
+ assert.equal(readNeverFloor(f.run)!.hash, saved.hash);
134
+ assert.ok(readNeverFloor(f.run)!.paths.some(p => p.path === decoy));
135
+ } finally { f.close(); }
136
+ });
137
+
138
+ for (const access of ["all", "write"]) test(`WP6 outside tree: ${access} never floor refuses parent and descendant grants`, () => {
139
+ const f = fixture(); try {
140
+ const parent = path.join(f.home, "outside-installation"); fs.mkdirSync(parent);
141
+ const decoy = path.join(parent, "installation-decoy"); fs.mkdirSync(decoy);
142
+ fs.mkdirSync(path.join(decoy, "child"));
143
+ fs.writeFileSync(process.env.RELAY_CONFIG!, JSON.stringify(withDefaults({ never: { paths: [{ path: decoy, access }] } })));
144
+ for (const root of [parent, path.join(decoy, "child")]) {
145
+ assert.throws(() => f.request({ capabilities: [{ kind: "write", scope: "tree", root }] }), /never|protected/);
146
+ }
147
+ } finally { f.close(); }
148
+ });
149
+
150
+ test("typed capabilities refuse opaque providers, read widening, never roots and control endpoints", () => {
151
+ const f = fixture(); try {
152
+ for (const capabilities of [[{ kind: "network", mode: "local" }], [{ kind: "localhost", operation: "connect", port: 5900 }], [{ kind: "write", root: process.env.RELAY_HOME!, scope: "tree" }], [{ kind: "port0", extra: true }]]) {
153
+ assert.throws(() => f.request({ capabilities }), /never|capability_unavailable|Unrecognized|unrecognized|requires a person decision/);
154
+ }
155
+ } finally { f.close(); }
156
+ });
157
+
158
+ test("malformed overlay records fail the per-registry interlock closed", () => {
159
+ const f = fixture(); try {
160
+ f.request();
161
+ db().prepare("UPDATE runs SET config_json = json_set(config_json, '$.params_json.overlays', json(?)) WHERE id = ?").run('{"bad":{}}', f.run);
162
+ assert.match(overlayInterlock("local")!, /malformed/);
163
+ assert.match(overlayInterlock("stage2")!, /malformed/);
164
+ } finally { f.close(); }
165
+ });
166
+
167
+ test("WP4: overlay-only reservation blocks local through pending, ready, running, stopping and tainted states with flags off", () => {
168
+ const f = fixture(); try {
169
+ const check = (id: string, state: string) => {
170
+ setParam("j_overlay", "grant", null);
171
+ assert.match(overlayInterlock("local")!, new RegExp(`overlay ${id} ${state} reserves stage2.*reap/cancel`));
172
+ };
173
+ const r = f.request(); check(r.id, "requested");
174
+ f.allow(r); check(r.id, "pending_restart");
175
+ markOverlayReceipt(f.run, r.id, true); check(r.id, "stopping");
176
+ updateTurn(f.origin, { status: "done" });
177
+ const ready = prepareOverlayRestart(f.run, r.id, { clean: true }); check(r.id, "ready");
178
+ consumeOverlay(f.run, r.id, ready.destinationTurn!); check(r.id, "running");
179
+ // Feature flags and standing node grants are not classification evidence.
180
+ db().prepare("UPDATE runs SET config_json=json_set(config_json,'$.targets.codex.stage2',json('false')) WHERE id=?").run(f.run);
181
+ finishOverlay(f.run, r.id, { clean: false, problem: "uncertain survivor sweep" }); check(r.id, "tainted");
182
+ finishOverlay(f.run, r.id, { clean: true }); assert.equal(overlayInterlock("local"), null);
183
+ } finally { f.close(); }
184
+ });
185
+
186
+ test("WP4: pending destination may reserve beside its source local proxy, but no same-job launch exemption", () => {
187
+ const f = fixture(); try {
188
+ updateTurn(f.origin, { grant_json: '{"network":true,"local_network":true}' });
189
+ reserveLaunch("j_overlay", f.origin, "local"); launchReservationState(f.run, f.origin, "running");
190
+ const r = f.allow(); markOverlayReceipt(f.run, r.id, true); updateTurn(f.origin, { status: "done" });
191
+ assert.throws(() => prepareOverlayRestart(f.run, r.id, { clean: true }), /reservation.*j_overlay running.*local/);
192
+ finishLaunchReservation(f.run, f.origin, { clean: false, problem: "source proxy still alive" });
193
+ assert.throws(() => prepareOverlayRestart(f.run, r.id, { clean: true }), /j_overlay tainted/);
194
+ finishLaunchReservation(f.run, f.origin, { clean: true });
195
+ assert.equal(prepareOverlayRestart(f.run, r.id, { clean: true }).state, "ready");
196
+ } finally { f.close(); }
197
+ });
198
+
199
+ test("IPv4 localhost connect approval carries LAN/tailnet disclosure and refuses IPv6 and control ports", () => {
200
+ const f = fixture(); try {
201
+ for (const port of [22, 5900, 47200]) {
202
+ assert.throws(() => f.request({ capabilities: [{ kind: "localhost", operation: "connect", port }] }), /never/);
203
+ }
204
+ assert.throws(() => f.request({ capabilities: [{ kind: "localhost", operation: "connect", port: 49240, host: "::1" }] }));
205
+ const request = f.request({ capabilities: [{ kind: "localhost", operation: "connect", port: 49240 }] });
206
+ assert.match(request.request.disclosures.join(" "), /port 49240 on this Mac's LAN and tailnet addresses/);
207
+ const allowed = f.allow(request);
208
+ assert.match(overlayPrompt(allowed), /LAN and tailnet/);
209
+ } finally { f.close(); }
210
+ });
211
+
212
+ test("static denied ports cannot be localhost connect or listen exceptions and are rechecked before decision", () => {
213
+ const f = fixture(); try {
214
+ for (const operation of ["connect", "listen"] as const) for (const port of [22, 3031, 3283, 445, 548, 631]) {
215
+ assert.throws(() => f.request({ capabilities: [{ kind: "localhost", operation, port }] }), new RegExp(`static denied TCP port ${port}`));
216
+ }
217
+ const pending = f.request({ capabilities: [{ kind: "localhost", operation: "connect", port: 49240 }] });
218
+ setOverlayControlSnapshotForTests(() => ({ ports: [49240], controlPlanes: [49240] }));
219
+ assert.throws(() => f.allow(pending), /control listeners/, "validatePlan rechecks authority immediately before the decision");
220
+ } finally { setOverlayControlSnapshotForTests(() => ({ ports: [], controlPlanes: [] })); f.close(); }
221
+ });
222
+
223
+ test("standing mediated baseline survives a port0 addition and raw substitution is refused", () => {
224
+ const f = fixture(); try {
225
+ setParam("j_overlay", "grant", { network: true });
226
+ assert.throws(() => f.request({ capabilities: [{ kind: "network", mode: "raw" }], authority: { owningRoot: "root-session", tokenBinding: "nonsecret-version-1", required_decider: "person" } }), /cannot be combined/);
227
+ const request = f.allow();
228
+ markOverlayReceipt(f.run, request.id, true); updateTurn(f.origin, { status: "done" });
229
+ const ready = prepareOverlayRestart(f.run, request.id, { clean: true });
230
+ const consumed = consumeOverlay(f.run, request.id, ready.destinationTurn!);
231
+ assert.equal(consumed.state, "running");
232
+ assert.match(overlayPrompt(consumed), /port0/);
233
+ } finally { f.close(); }
234
+ });
235
+
236
+ test("localhost connect refuses non-reserved control listeners and unreadable snapshots before approval", () => {
237
+ const f = fixture(); try {
238
+ setOverlayControlSnapshotForTests(() => ({ ports: [49240], controlPlanes: [49240] }));
239
+ assert.throws(() => f.request({ capabilities: [{ kind: "localhost", operation: "connect", port: 49240 }] }), /never relay.authority.*control listeners/);
240
+ setOverlayControlSnapshotForTests(() => { throw new Error("fixture snapshot unavailable"); });
241
+ assert.throws(() => f.request({ capabilities: [{ kind: "localhost", operation: "connect", port: 49240 }] }), /cannot check localhost control listeners.*fixture snapshot unavailable/);
242
+ } finally { setOverlayControlSnapshotForTests(() => ({ ports: [], controlPlanes: [] })); f.close(); }
243
+ });
244
+
245
+ test("failed receipt delivery persists allowed-not-executed and never queues a destination", () => {
246
+ const f = fixture(); try {
247
+ const r = f.allow(); markOverlayReceipt(f.run, r.id, false); updateTurn(f.origin, { status: "done" });
248
+ const stopped = prepareOverlayRestart(f.run, r.id, { clean: true });
249
+ assert.equal(stopped.state, "failed"); assert.equal(stopped.destinationTurn, undefined);
250
+ assert.equal(stopped.receipt?.delivered, false);
251
+ } finally { f.close(); }
252
+ });
253
+
254
+ test("an expired consumption cannot launch or be revived by a second attempt", () => {
255
+ const f = fixture(); try {
256
+ const r = f.ready(); f.clock(r.request.pendingDeadline, r.request.pendingMonotonicDeadline);
257
+ assert.throws(() => consumeOverlay(f.run, r.id, r.destinationTurn!), /expired/);
258
+ assert.equal(getOverlay(f.run, r.id).consumedAt, undefined);
259
+ } finally { f.close(); }
260
+ });
261
+
262
+ test("a grant change after allow cannot widen the replacement turn", () => {
263
+ const f = fixture(); try {
264
+ const r = f.ready(); setParam("j_overlay", "grant", { network: true, raw_network: true });
265
+ assert.throws(() => consumeOverlay(f.run, r.id, r.destinationTurn!), /grant changed/);
266
+ } finally { f.close(); }
267
+ });
268
+
269
+ test("read access cannot silently acquire an outside write root", () => {
270
+ const f = fixture(); try {
271
+ const root = path.join(f.home, "outside"); fs.mkdirSync(root); updateTurn(f.origin, { access: "read" });
272
+ assert.throws(() => f.request({ capabilities: [{ kind: "write", scope: "tree", root }] }), /read jobs/);
273
+ } finally { f.close(); }
274
+ });
275
+
276
+ test("outside writes pin exact existing trees and missing files; a swapped root refuses launch", () => {
277
+ const f = fixture(); try {
278
+ const root = path.join(f.home, "outside"); fs.mkdirSync(root);
279
+ const r = f.allow(f.request({ capabilities: [{ kind: "write", scope: "tree", root }, { kind: "write", scope: "file", root: path.join(f.home, "missing.txt") }] }));
280
+ assert.equal(r.request.roots[1].existed, false);
281
+ markOverlayReceipt(f.run, r.id, true); updateTurn(f.origin, { status: "done" });
282
+ fs.renameSync(root, root + "-old"); fs.mkdirSync(root);
283
+ assert.throws(() => prepareOverlayRestart(f.run, r.id, { clean: true }), /identity changed/);
284
+ } finally { f.close(); }
285
+ });
286
+
287
+ for (const attack of ["symlink", "hardlink"]) test(`WP6 outside file: ${attack} replacement after approval invalidates the root pin`, () => {
288
+ const f = fixture(); try {
289
+ const root = path.join(f.home, "approved-file"), decoy = path.join(f.home, "owned-decoy");
290
+ fs.writeFileSync(root, "approved"); fs.writeFileSync(decoy, "untouched");
291
+ const r = f.allow(f.request({ capabilities: [{ kind: "write", scope: "file", root }] }));
292
+ markOverlayReceipt(f.run, r.id, true); updateTurn(f.origin, { status: "done" });
293
+ fs.unlinkSync(root);
294
+ if (attack === "symlink") fs.symlinkSync(decoy, root); else fs.linkSync(decoy, root);
295
+ assert.throws(() => prepareOverlayRestart(f.run, r.id, { clean: true }), /identity changed|never/);
296
+ assert.equal(fs.readFileSync(decoy, "utf8"), "untouched");
297
+ assert.equal(getOverlay(f.run, r.id).destinationTurn, undefined);
298
+ } finally { f.close(); }
299
+ });
300
+
301
+ test("WP6 another job cannot use an overlay destination, before or after consumption", () => {
302
+ const f = fixture(); try {
303
+ const r = f.ready();
304
+ insertNode({ id: "j_foreign", run_id: f.run, kind: "job", target: "codex", mode: "write", depth: 1, task: "foreign", cwd: f.home, status: "running" });
305
+ const foreign = insertTurn("j_foreign", "test", "try stolen overlay", "write", "running");
306
+ assert.throws(() => consumeOverlay(f.run, r.id, foreign), /destination/);
307
+ const consumed = consumeOverlay(f.run, r.id, r.destinationTurn!);
308
+ assert.throws(() => assertOverlayLaunch(consumed, foreign), /destination/);
309
+ assert.throws(() => consumeOverlay(f.run, r.id, r.destinationTurn!), /consumed/);
310
+ assert.equal(getOverlay(f.run, r.id).destinationTurn, r.destinationTurn);
311
+ } finally { f.close(); }
312
+ });
313
+
314
+ test("consume records survive registry reload and reject unknown recovery clocks", () => {
315
+ const f = fixture(); try {
316
+ const ready = f.ready(); const r = consumeOverlay(f.run, ready.id, ready.destinationTurn!);
317
+ closeDbForTests(); assert.equal(getOverlay(f.run, r.id).recoveryDeadline, r.recoveryDeadline);
318
+ setOverlayClockForTests({ wall: () => 100_000, mono: () => 1000, boot: () => "different-boot" });
319
+ assert.equal(overlayDeadlineExpired(getOverlay(f.run, r.id)), true);
320
+ assert.throws(() => assertOverlayLaunch(r, r.destinationTurn), /expired/);
321
+ } finally { f.close(); }
322
+ });
323
+
324
+ test("a crash after consumption never retries and deadline is never reset", () => {
325
+ const f = fixture(); try {
326
+ const ready = f.ready(); const r = consumeOverlay(f.run, ready.id, ready.destinationTurn!);
327
+ closeDbForTests(); f.clock(101_000, 2000);
328
+ assert.throws(() => consumeOverlay(f.run, r.id, r.destinationTurn!), /consumed/);
329
+ assert.equal(getOverlay(f.run, r.id).recoveryDeadline, r.recoveryDeadline);
330
+ } finally { f.close(); }
331
+ });
332
+
333
+ test("terminal allow/deny race has one winner with immutable decision provenance", () => {
334
+ const f = fixture(); try {
335
+ const request = f.request(); const r = f.allow(request);
336
+ assert.throws(() => tx(() => settleOverlayRequestInTransaction(f.run, r.id, r.digest, "denied")), /terminal/);
337
+ assert.throws(() => f.allow(request), /terminal/);
338
+ assert.equal(getOverlay(f.run, r.id).decision?.decisionId, "decision-1");
339
+ } finally { f.close(); }
340
+ });
341
+
342
+ test("raw scope cannot be classified as supervisor and host-never refuses even person raw", () => {
343
+ const f = fixture(); try {
344
+ assert.throws(() => f.request({ capabilities: [{ kind: "network", mode: "raw" }] }), /person/);
345
+ fs.writeFileSync(process.env.RELAY_CONFIG!, JSON.stringify(withDefaults({ never: { hosts: ["decoy.example"] } })));
346
+ assert.throws(() => f.request({ capabilities: [{ kind: "network", mode: "raw" }], authority: { owningRoot: "root", tokenBinding: "version", required_decider: "person" } }), /never.hosts/);
347
+ } finally { f.close(); }
348
+ });
349
+
350
+ test("overlay-only plans select stage2 without manufacturing a standing raw grant", () => {
351
+ const f = fixture(); try {
352
+ const ready = f.ready(); const r = consumeOverlay(f.run, ready.id, ready.destinationTurn!);
353
+ assert.equal(stage2Wanted({ config: withDefaults({ targets: { codex: { stage2: true } } }), target: targetDef("codex"), overlay: r }), true);
354
+ assertOverlayLaunch(r, r.destinationTurn);
355
+ assert.throws(() => assertOverlayLaunch(r, f.origin), /destination/);
356
+ } finally { f.close(); }
357
+ });
358
+
359
+ test("captured local turn blocks overlay consumption even after mutable grant removal", () => {
360
+ const f = fixture(); try {
361
+ const ready = f.ready();
362
+ insertNode({ id: "j_local", run_id: f.run, kind: "job", target: "codex", mode: "write", depth: 1, task: "local", cwd: f.home, status: "running" });
363
+ const turn = insertTurn("j_local", "initial", "local", "write", "running");
364
+ updateTurn(turn, { grant_json: JSON.stringify({ network: true, local_network: true }) });
365
+ assert.throws(() => consumeOverlay(f.run, ready.id, ready.destinationTurn!), /j_local is running a turn in local network mode/);
366
+ } finally { f.close(); }
367
+ });
368
+
369
+ test("replacement runs before already queued messages, which retain baseline authority", () => {
370
+ const f = fixture(); try {
371
+ const queued = insertTurn("j_overlay", "followup", "unrelated continuation", "write");
372
+ const ready = f.ready();
373
+ assert.ok(queued < ready.destinationTurn!);
374
+ assert.equal(nextOverlayTurn("j_overlay")?.id, ready.destinationTurn);
375
+ assert.match(overlayTurnProblem("j_overlay", queued)!, /overlay/);
376
+ const c = consumeOverlay(f.run, ready.id, ready.destinationTurn!);
377
+ assert.match(overlayPrompt(c), /outcome unknown/);
378
+ const launched = markOverlayLaunched(c, c.destinationTurn);
379
+ assert.match(overlayPrompt(launched), /This turn allowed listeners to bind 0.0.0.0/);
380
+ assert.throws(() => markOverlayLaunched(c, c.destinationTurn), /already recorded/);
381
+ finishOverlay(f.run, c.id, { clean: true });
382
+ assert.equal(overlayTurnProblem("j_overlay", queued), null);
383
+ } finally { f.close(); }
384
+ });
385
+
386
+ test("production executor compiler applies exact file/tree writes with final floor parameters", () => {
387
+ const f = fixture(); try {
388
+ const root = path.join(f.home, "outside"); fs.mkdirSync(root);
389
+ const tmp = path.join(f.home, "tmp"); fs.mkdirSync(tmp);
390
+ const file = path.join(f.home, "missing.txt");
391
+ const r = f.allow(f.request({ capabilities: [{ kind: "write", root, scope: "tree" }, { kind: "write", root: file, scope: "file" }] }));
392
+ markOverlayReceipt(f.run, r.id, true); updateTurn(f.origin, { status: "done" });
393
+ const ready = prepareOverlayRestart(f.run, r.id, { clean: true }); const consumed = consumeOverlay(f.run, ready.id, ready.destinationTurn!);
394
+ const policy = executorPolicy({ target: targetDef("codex"), cwd: path.join(f.home, "work"), access: "write", config: withDefaults({}), neverPolicy: readNeverFloor(f.run)!, overlay: consumed } as any, tmp,
395
+ { mode: "stage2", egress: "none", deniedTcp: [], deniedUdp: [], relayRange: [49230, 49233], execPort: 49230, bindPorts: [], worktreeSockets: false });
396
+ const profile = seatbeltProfile(policy); const params = Object.fromEntries(profile.params);
397
+ assert.deepEqual(policy.overlayRoots, consumed.request.roots, "probe roots come from this consumed overlay only");
398
+ assert.equal(params.OVERLAY_FILE_0, file); assert.ok(Object.entries(params).some(([k,v]) => k.startsWith("WRITABLE_") && v === root));
399
+ assert.match(profile.profile, /allow file-write\* \(literal \(param "OVERLAY_FILE_0"\)\)/);
400
+ assert.match(profile.profile, /deny file-link \(literal \(param "OVERLAY_FILE_0"\)\)/);
401
+ assert.ok(profile.profile.lastIndexOf("NEVER_") > profile.profile.indexOf("OVERLAY_FILE_0"));
402
+ assert.doesNotMatch(profile.profile, /allow network-outbound \(remote ip[46] "\*:\*"/);
403
+ assert.doesNotMatch(profile.profile, /\((?:remote|local)\s+(?:ip[46]?|tcp|udp)\s+(?:\(string-append\s+)?"(?:\d+\.\d+\.\d+\.\d+|\[?::1)/);
404
+ } finally { f.close(); }
405
+ });
406
+
407
+ test("fresh person-authorized raw overlay adds one turn without a standing raw grant", () => {
408
+ const f = fixture(); try {
409
+ const request = f.request({ capabilities: [{ kind: "network", mode: "raw" }], authority: { owningRoot: "root-session", tokenBinding: "version", required_decider: "person" } });
410
+ const r = allowOverlay(f.run, request.id, request.digest, { decisionId: "person-1", decidedBy: "person-dialog", route: "person", at: 100_000 });
411
+ markOverlayReceipt(f.run, r.id, true); updateTurn(f.origin, { status: "done" });
412
+ const ready = prepareOverlayRestart(f.run, r.id, { clean: true }); const c = consumeOverlay(f.run, ready.id, ready.destinationTurn!);
413
+ assertOverlayLaunch(c, c.destinationTurn); assert.equal(c.request.authority.required_decider, "person");
414
+ assert.equal(JSON.parse((db().prepare("SELECT params_json FROM nodes WHERE id='j_overlay'").get() as any).params_json ?? "{}").grant, undefined);
415
+ } finally { f.close(); }
416
+ });