@jbkjr/relay 0.0.0-stage → 1.2.2

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 +393 -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 +1539 -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 +345 -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 +641 -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 +345 -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 +635 -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 +1518 -0
  186. package/docs/pinned-codex.md +333 -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,36 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { ensurePrivateRoot, privateStateRoot } from "./private-root.js";
4
+ /**
5
+ * Where relay keeps its own Unix sockets: one private directory per confined turn (the turn's
6
+ * broker, broker.ts), all inside this one. Every confined turn's profile denies reading, writing
7
+ * and connecting anywhere in it, and removing or renaming it or any directory above it, as final
8
+ * rules; only the turn's own bridge socket is allowed after them. So no turn can find, reach or
9
+ * replace another turn's broker.
10
+ */
11
+ export function relaySocketsDir() {
12
+ return path.join(privateStateRoot(), "s");
13
+ }
14
+ /**
15
+ * The sockets directory, made if missing (mode 0700) and checked: a real directory, not a link,
16
+ * this user's own and writable by no one else. Throws otherwise.
17
+ */
18
+ export function ensureRelaySocketsDir() {
19
+ const dir = relaySocketsDir();
20
+ ensurePrivateRoot(privateStateRoot());
21
+ try {
22
+ fs.mkdirSync(dir, { mode: 0o700 });
23
+ }
24
+ catch (err) {
25
+ if (err.code !== "EEXIST")
26
+ throw err;
27
+ }
28
+ const st = fs.lstatSync(dir);
29
+ if (st.isSymbolicLink() || !st.isDirectory())
30
+ throw new Error(`relay's sockets directory ${dir} is not a plain directory, so relay does not serve a confined turn from it`);
31
+ if (typeof process.getuid === "function" && st.uid !== process.getuid())
32
+ throw new Error(`relay's sockets directory ${dir} is not owned by this user`);
33
+ if (st.mode & 0o077)
34
+ fs.chmodSync(dir, 0o700);
35
+ return dir;
36
+ }
@@ -0,0 +1,19 @@
1
+ import { prepareLaunch } from "./index.js";
2
+ /** Whether this build of relay runs the per-turn boundary probes, and so launches relay-enforced targets at all. */
3
+ export const PROBES_ENABLED = true;
4
+ /** Why relay refuses a relay-enforced launch when it has no boundary probe (a build with PROBES_ENABLED false). */
5
+ export const NO_PROBE = "relay cannot yet probe its sandbox's boundary before each turn (the per-turn probes are not enabled in this build of relay), and it does not launch a harness inside its own sandbox unprobed";
6
+ let standIn = null;
7
+ /**
8
+ * Test-only seam: the probe relay-enforced launches get in this process, or null to remove it.
9
+ * Nothing in relay calls this; only test code does.
10
+ */
11
+ export function setBoundaryProbeForTests(probe) {
12
+ standIn = probe;
13
+ }
14
+ /** The probe every relay-enforced launch runs, or null when there is none (the launch is then refused). */
15
+ export function boundaryProbe() {
16
+ if (standIn)
17
+ return standIn;
18
+ return PROBES_ENABLED ? prepareLaunch : null;
19
+ }
@@ -0,0 +1,86 @@
1
+ // Shared construction for production relay-enforced turns and the red-team harness.
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ import { openProxy } from "./proxy.js";
5
+ import { registerTurnSecret } from "../core/secrets.js";
6
+ import { keyPathsToDeny } from "../core/api-keys.js";
7
+ import { ensurePrivateRoot, privateStateRoot } from "./private-root.js";
8
+ import { relayCodexProtected } from "../core/protected-config.js";
9
+ import { neverFloorApplies } from "../core/never-coverage.js";
10
+ export function privateTurnTemp(parent = ensurePrivateRoot(privateStateRoot()), prefix = "relay-tmp-") {
11
+ // path.join drops the trailing slash of an empty prefix; preserve it so short native
12
+ // names are children of the protected root rather than siblings of it.
13
+ const dir = fs.realpathSync(fs.mkdtempSync(path.join(parent, prefix) + (prefix ? "" : path.sep)));
14
+ fs.chmodSync(dir, 0o700);
15
+ return dir;
16
+ }
17
+ /** The production proxy owns its generated credentials redaction registration. */
18
+ export async function openTurnProxy(opts) {
19
+ const proxy = await openProxy(opts);
20
+ try {
21
+ registerTurnSecret(proxy.token, "proxy token");
22
+ }
23
+ catch (error) {
24
+ await proxy.close();
25
+ throw error;
26
+ }
27
+ return proxy;
28
+ }
29
+ /** Identity-bearing inputs and the login home are supplied by the caller; the key paths denied come from relay's key settings (core/api-keys.ts). */
30
+ export function turnPolicy(spec, state, tmpDir, network, home, name, bridgeSocket, bridgeSecret) {
31
+ // Write grants carry one identity pin each (caller.ts checkGrant). A grant without its pins is a legacy
32
+ // grant from before relay pinned them: relay refuses the turn and the root must grant it again,
33
+ // rather than run with an unpinned grant (review X2). Checked here as well as in the sandbox
34
+ // layer, whose own check runs inside prepareLaunch, so it does not depend on which probe runs.
35
+ const grantPaths = spec.access === "write" ? (spec.grant?.write_paths ?? []) : [];
36
+ const grantPins = spec.access === "write" ? (spec.grant?.write_path_pins ?? []) : [];
37
+ if (grantPaths.length && grantPins.length !== grantPaths.length) {
38
+ throw new Error(`${name} was granted write paths without the per-directory pins relay records when it authorises a grant (a grant from an earlier version). The root session must grant those write paths again before relay will run this turn.`);
39
+ }
40
+ // The target's login store, in the person's real home whatever home the harness is given.
41
+ const store = spec.target.tokenStore ? loginStore(spec.target.tokenStore, home) : undefined;
42
+ const codex = relayCodexProtected(spec.config);
43
+ return {
44
+ // Where the floor binds this target (core/never-coverage.ts). It conflicts with released
45
+ // credential/TRUST routes (Copilot, Grok): where it does not apply, retain their released outer
46
+ // profile, not a profile whose final denies silently defeat its login allows. Grant/identity screens still run.
47
+ ...(spec.neverPolicy && neverFloorApplies(spec.target.id, spec.config) ? { neverPolicy: spec.neverPolicy } : {}),
48
+ worktree: spec.cwd,
49
+ ...(spec.worktreePin ? { worktreePin: spec.worktreePin } : {}),
50
+ // The worktree's git directories as the repository records them, not as its `.git` file says.
51
+ ...(spec.gitEnv ? { gitEnv: spec.gitEnv } : {}),
52
+ worktreeWritable: spec.access === "write",
53
+ writable: grantPaths,
54
+ writeDenied: codex.stores.map((p) => p.path),
55
+ ...(grantPaths.length ? { writablePins: grantPins } : {}),
56
+ stateDirs: state.stateDirs,
57
+ // The profile's state whole (review E8): nothing of it is dropped on the way to the sandbox.
58
+ state: {
59
+ home: state.home ?? "temp",
60
+ ...(state.homeVars ? { homeVars: state.homeVars } : {}),
61
+ ...(state.links ? { links: state.links } : {}),
62
+ ...(state.tokenFiles ? { tokenFiles: state.tokenFiles } : {}),
63
+ ...(state.env ? { env: state.env } : {}),
64
+ ...(state.persistent ? { persistent: state.persistent } : {}),
65
+ ...(store ? { tokenStore: store } : {}),
66
+ },
67
+ ...(state.execPaths?.length ? { execPaths: state.execPaths } : {}),
68
+ tmpDir,
69
+ // The default API key directory and any key file the local config moves (core/api-keys.ts): no agent
70
+ // relay confines, whatever its target, may read a key kept there, list the directory or test which names it holds.
71
+ denied: [...keyPathsToDeny(), ...codex.homes.map((p) => p.path)],
72
+ ...(bridgeSocket ? { bridgeSocket } : {}),
73
+ ...(bridgeSecret ? { bridgeSecret } : {}),
74
+ network,
75
+ keychain: state.keychain,
76
+ ...(state.certificateTrust ? { certificateTrust: true } : {}),
77
+ };
78
+ }
79
+ /** A target's login-store grant, its directory resolved in `home`: a plain path below it, never the home folder itself or outside it. */
80
+ export function loginStore(grant, home) {
81
+ const parts = typeof grant.dir === "string" ? grant.dir.split("/") : [];
82
+ if (!parts.length || parts.some((p) => !/^[A-Za-z0-9._-]+$/.test(p) || p === "." || p === "..")) {
83
+ throw new Error(`${grant.name}: its directory must be a plain path relative to the home folder: ${JSON.stringify(grant.dir)}`);
84
+ }
85
+ return { name: grant.name, dir: path.join(home, ...parts), files: [...grant.files], locks: [...grant.locks], tempName: grant.tempName };
86
+ }
@@ -0,0 +1,124 @@
1
+ // Explicit recovery for process-scoped 1.0 runs. This is an administrative handoff,
2
+ // not a conversation-key adapter or a durable logical-session membership system.
3
+ import crypto from "node:crypto";
4
+ import fs from "node:fs";
5
+ import path from "node:path";
6
+ import { relayHome } from "./config.js";
7
+ import { db, getNode, getRun, runNodes, tx } from "./db.js";
8
+ import { ownsRun, refused, UNAVAILABLE } from "./caller.js";
9
+ import { fingerprint } from "./identity.js";
10
+ import { pidAlive, procStart, sameProcess } from "./procs.js";
11
+ import { writeProblem } from "./storage.js";
12
+ const digest = (s) => crypto.createHash("sha256").update(s ?? "unassigned").digest("hex");
13
+ const valid = (run, to) => /^run_[0-9a-f]{8}$/.test(run) && /^[0-9a-f]{24}$/.test(to);
14
+ const ticketPath = (run, to) => path.join(relayHome(), "adoptions", `${run}-${to}.json`);
15
+ // An unreadable start time is not evidence that a live owner died. A different known start
16
+ // time is PID reuse; legacy owners without a token still count as owners while alive.
17
+ export const ownerOpen = (run) => pidAlive(run.root_pid) && (!run.root_start || !procStart(run.root_pid) || sameProcess(run.root_pid, run.root_start));
18
+ /** Recovery lookup belongs to the explicit authorization path, never normal item access. */
19
+ export const adoptionRun = (id) => getRun(id.startsWith("run_") ? id : getNode(id)?.run_id ?? "") ?? undefined;
20
+ /** Called only by the administrative CLI after the person types the printed exact transfer. */
21
+ export function authorizeAdoption(id, to) {
22
+ const run = adoptionRun(id);
23
+ if (!run)
24
+ return UNAVAILABLE();
25
+ const runId = run.id;
26
+ if (!valid(runId, to))
27
+ return UNAVAILABLE();
28
+ if (ownerOpen(run))
29
+ return refused("the run's owning connection is still open. Close it before transferring its authority.");
30
+ const file = ticketPath(runId, to);
31
+ try {
32
+ fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
33
+ fs.writeFileSync(file, JSON.stringify({ run: runId, to, previous_owner: digest(run.root_token), approved_at: Date.now() }), { mode: 0o600 });
34
+ }
35
+ catch (err) {
36
+ // A full disk, or a control directory that is not writable: said, with what to do, not thrown at the terminal.
37
+ return { authorized: false, error: `${writeProblem(file, err, "no transfer was authorized")}.` };
38
+ }
39
+ return { authorized: true, run_id: runId, into_session: to, note: "Call adopt from that connection within ten minutes. No authority changes until it consumes this one-use authorization." };
40
+ }
41
+ export function adopt(inst, id, to, call = {}, description) {
42
+ if (inst.ctx.kind !== "root" || call.codexSubagent)
43
+ return refused("only a person's root connection can take over a run.");
44
+ if (to !== fingerprint(inst))
45
+ return UNAVAILABLE();
46
+ const run = adoptionRun(id);
47
+ if (!run)
48
+ return UNAVAILABLE();
49
+ const runId = run.id;
50
+ if (!valid(runId, to))
51
+ return UNAVAILABLE();
52
+ const file = ticketPath(runId, to);
53
+ let ticket;
54
+ try {
55
+ ticket = JSON.parse(fs.readFileSync(file, "utf8"));
56
+ }
57
+ catch { /* Qualified permission prompt may authorize instead. */ }
58
+ const prompted = inst.host.confirmTool === true;
59
+ return tx(() => {
60
+ const current = getRun(runId);
61
+ if (!current)
62
+ return UNAVAILABLE();
63
+ if (ownsRun(inst, runId))
64
+ return { adopted: true, run_id: runId, into_session: to };
65
+ // A concurrent winner, including one committed before our first read, takes precedence
66
+ // over a stale ticket's refusal. All ownership and authorization checks share this lock.
67
+ const changed = current.root_token !== run.root_token;
68
+ const open = ownerOpen(current);
69
+ const issued = ticket?.run === runId && ticket.to === to
70
+ && typeof ticket.approved_at === "number" && Number.isFinite(ticket.approved_at)
71
+ && ticket.approved_at <= Date.now() && Date.now() - ticket.approved_at < 600_000;
72
+ if (changed || open) {
73
+ // A person-issued ticket can explain a competing transfer. Ticketless callers and
74
+ // permission prompts must not distinguish a live/changed run from an unknown one.
75
+ if (prompted || !issued)
76
+ return UNAVAILABLE();
77
+ return refused(changed ? "the run's ownership changed during adoption. Close its owning connection before trying again."
78
+ : "the run's owning connection is still open. Close it before transferring its authority.");
79
+ }
80
+ const authorized = issued && ticket.previous_owner === digest(current.root_token);
81
+ // Never disclose expected descriptions: unknown, live and mismatched orphaned runs
82
+ // all return the same reply on the permission-prompt path.
83
+ if (prompted && !authorized && (description?.in_directory !== current.root_cwd || description?.item_count !== runNodes(runId).length))
84
+ return UNAVAILABLE();
85
+ if (!prompted && !authorized)
86
+ return UNAVAILABLE();
87
+ const won = db().prepare("UPDATE runs SET root_token = ?, root_pid = ?, root_start = ? WHERE id = ? AND root_token IS ?")
88
+ .run(inst.token, process.pid, procStart(process.pid), runId, current.root_token);
89
+ if (Number(won.changes) !== 1)
90
+ return UNAVAILABLE();
91
+ if (!ownsRun(inst, inst.runId) || getRun(inst.runId)?.status === "cancelled")
92
+ inst.runId = runId;
93
+ inst.since.set(runId, current.created_at);
94
+ if (authorized)
95
+ fs.renameSync(file, `${file}.used`);
96
+ return { adopted: true, run_id: runId, into_session: to, rights: "supervision", effect: "Took over this run's jobs, approval requests and events.", confirmed_by: authorized ? "terminal" : "host permission prompt" };
97
+ });
98
+ }
99
+ /**
100
+ * The transfer authorizations `relay adopt` wrote for a run, taken up (`.used`) or not, which go
101
+ * with its records when keep_records_days forgets it (retention.ts); and whether one is still
102
+ * waiting to be taken up, written less than ten minutes ago as adopt takes them, which keeps the
103
+ * run. A directory of them that cannot be read is thrown, so that the run is kept.
104
+ */
105
+ export function adoptionTickets(runId) {
106
+ const dir = path.join(relayHome(), "adoptions");
107
+ let names;
108
+ try {
109
+ names = fs.readdirSync(dir);
110
+ }
111
+ catch (err) {
112
+ if (err.code === "ENOENT")
113
+ return { files: [], waiting: false };
114
+ throw new Error(`relay could not look for transfers of it that relay adopt authorized in ${dir} (${err.message})`);
115
+ }
116
+ const files = names.filter((n) => n.startsWith(`${runId}-`) && /\.json(?:\.used)?$/.test(n)).map((n) => path.join(dir, n));
117
+ const waiting = files.some((f) => {
118
+ if (f.endsWith(".used"))
119
+ return false;
120
+ const st = fs.statSync(f, { throwIfNoEntry: false });
121
+ return st !== undefined && Date.now() - st.mtimeMs < 600_000;
122
+ });
123
+ return { files, waiting };
124
+ }