@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,205 @@
1
+ // relay qualify-codex: one run of the Codex qualifier (CODEX_QUALIFIER), as its LaunchAgent runs it.
2
+ // It calls the qualifier's own runQualifier with nothing but relay's package root (a built git
3
+ // checkout or an npm install; the pin names its build identity, src/core/build-identity.ts), relay's pin store
4
+ // and the person's --version/--force: every check of a scheduled run stays in force (npm's SRI,
5
+ // Apple's signature and OpenAI's Team ID, the exact version, the source tag, the full stage-2
6
+ // qualification judged against the current schema, the Aqua login session, the lock and the
7
+ // promotion journal). Afterwards it asks relay itself (freezeCodexConfig) which Codex it would run,
8
+ // so what it prints is what relay will do, not what the qualifier says it did.
9
+ import fs from "node:fs";
10
+ import path from "node:path";
11
+ import { pathToFileURL } from "node:url";
12
+ import { parseArgs } from "node:util";
13
+ import { CODEX_QUALIFIER, CODEX_SHIPPED_PIN, codexPinInfo, describeCodexPin, freezeCodexConfig } from "../backends/codex-pin.js";
14
+ import { buildIdentity, describeBuild, isBuildRecord } from "../core/build-identity.js";
15
+ import { loadConfig, relayCodexPinStore } from "../core/config.js";
16
+ import { launchedTree } from "../core/presence.js";
17
+ import { relayPackageRoot } from "../core/protected-config.js";
18
+ export const QUALIFY_CODEX_USAGE = "usage: relay qualify-codex [--version X.Y.Z] [--force] | --shipped";
19
+ const QUALIFY_CODEX_HELP = [
20
+ "Qualifies a Codex release for relay and makes it the pin relay runs Codex from: downloads it from npm",
21
+ "and its source from GitHub, verifies both, and runs relay's model-free stage-2 qualification against it",
22
+ "(about an hour and a half; needs this Mac's desktop login session and the network).",
23
+ " --version X.Y.Z qualify this release (default: npm's latest)",
24
+ " --force retry a release whose qualification already failed with this relay build",
25
+ " --shipped instead, put this release's shipped pin in place (the maintainer's qualification of the",
26
+ " Codex it names; a download of a few minutes), replacing a pin qualified here",
27
+ ].join("\n");
28
+ /** The command's own reach: relay's package, the person's config and the qualifier file there. */
29
+ export const qualifyCodexDefaults = () => ({
30
+ root: relayPackageRoot(),
31
+ config: () => loadConfig(),
32
+ launched: () => launchedTree(),
33
+ load: async (file) => (await import(pathToFileURL(file).href)),
34
+ loadShipped: async (file) => (await import(pathToFileURL(file).href)),
35
+ out: (line) => console.log(line),
36
+ });
37
+ const firstLine = (value) => String(value ?? "").split("\n")[0];
38
+ /** Which Codex relay runs now, by relay's own selection. Returns whether that is a qualified pin. */
39
+ export function relayVerdict(cfg, out) {
40
+ try {
41
+ const frozen = freezeCodexConfig(cfg);
42
+ if (!frozen.targets.codex.pinned) {
43
+ out(`relay runs Codex unpinned: targets.codex.pinned is false in your config, so relay runs ${frozen.targets.codex.bin} and does not use this pin store.`);
44
+ return false;
45
+ }
46
+ const info = codexPinInfo(frozen);
47
+ out(`relay will run Codex from the qualified pin ${frozen.targets.codex.bin}${info ? ` (${describeCodexPin(info)})` : ""}.`);
48
+ return true;
49
+ }
50
+ catch (err) {
51
+ out(err.message);
52
+ return false;
53
+ }
54
+ }
55
+ function describePin(store, target, out) {
56
+ const m = JSON.parse(fs.readFileSync(path.join(store, target, "manifest.json"), "utf8"));
57
+ out("What was checked:");
58
+ out(` - npm package @openai/codex@${m.version}-darwin-arm64: its bytes match npm's sha512 integrity (${String(m.npmIntegrity).slice(0, 23)}…)`);
59
+ out(` - code signature: valid and Apple-issued, Team ID ${m.codesign?.teamId} (${m.codesign?.identity})`);
60
+ out(` - the binary reports exactly codex-cli ${m.version}; its sha256 is ${m.binarySha256}`);
61
+ out(` - Codex's source: tag rust-v${m.version} at commit ${m.sourceCommit}`);
62
+ out(` - relay's stage-2 qualification (model-free, scratch homes, no login): every item and part of ${m.verdictSchema} passed (verdict ${m.verdictPath})`);
63
+ // Pins from before build identities name the relay commit they ran from instead.
64
+ const ran = isBuildRecord(m.relayBuild) ? `${describeBuild(m.relayBuild)} (sha256 ${m.relayBuild.sha256})` : `relay commit ${m.relayCommit}`;
65
+ out(` - run from ${ran}, Node ${m.nodeVersion}`);
66
+ out(`Pin: ${path.join(store, "current")} -> ${target}`);
67
+ }
68
+ /** Returns the exit code. Refuses, without starting the qualifier, wherever a scheduled run would not be the person's own. */
69
+ export async function qualifyCodex(args, supplied = {}) {
70
+ const deps = { ...qualifyCodexDefaults(), ...supplied };
71
+ const { out } = deps;
72
+ if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
73
+ out(`${QUALIFY_CODEX_USAGE}\n${QUALIFY_CODEX_HELP}`);
74
+ return 0;
75
+ }
76
+ let values;
77
+ try {
78
+ ({ values } = parseArgs({ args, strict: true, allowPositionals: false, options: { version: { type: "string" }, force: { type: "boolean", default: false }, shipped: { type: "boolean", default: false } } }));
79
+ if (values.version !== undefined && !/^\d+\.\d+\.\d+$/.test(values.version))
80
+ throw new Error("--version must be a stable X.Y.Z");
81
+ if (values.shipped && (values.version !== undefined || values.force))
82
+ throw new Error("--shipped takes no --version or --force: it is this release's pin");
83
+ }
84
+ catch (err) {
85
+ out(`relay qualify-codex: ${firstLine(err.message)}\n${QUALIFY_CODEX_USAGE}`);
86
+ return 2;
87
+ }
88
+ const launched = deps.launched();
89
+ if (launched) {
90
+ out(`relay qualify-codex refused: it runs only from your own terminal, not in a launched agent's environment or process tree (${launched}). Nothing ran.`);
91
+ return 1;
92
+ }
93
+ const root = deps.root;
94
+ const runner = path.join(root, CODEX_QUALIFIER);
95
+ if (!fs.existsSync(runner) || !fs.existsSync(path.join(root, "dist", "backends", "codex.js"))) {
96
+ out(`relay qualify-codex refused: the qualifier runs from a built relay (an npm install, or a git checkout after npm run build), and ${root} is not one (no ${CODEX_QUALIFIER} or dist/). Nothing ran.`);
97
+ return 1;
98
+ }
99
+ // The pin names the build that ran by its content (src/core/build-identity.ts), so a checkout with
100
+ // local changes is qualified as what it is. An incomplete build is refused before anything runs.
101
+ let build;
102
+ try {
103
+ build = buildIdentity(root);
104
+ }
105
+ catch (err) {
106
+ out(`relay qualify-codex refused: ${firstLine(err.message)}. Nothing ran.`);
107
+ return 1;
108
+ }
109
+ if (values.shipped) {
110
+ const placed = await placeShippedPin(deps, { replaceLocal: true });
111
+ return relayVerdict(deps.config(), out) && (placed === "installed" || placed === "unchanged") ? 0 : 1;
112
+ }
113
+ const cfg = deps.config();
114
+ const store = relayCodexPinStore(cfg);
115
+ out(`Qualifying ${values.version ? `Codex ${values.version}` : "npm's latest Codex"} for ${describeBuild(build)} at ${root}, into the pin store ${store}.`);
116
+ out("It downloads Codex from npm and its source from GitHub, verifies them, and runs relay's model-free stage-2 qualification against it: about an hour and a half. It needs this Mac's desktop (Aqua) login session and the network. Your own Codex, its login and ~/.codex are not used.");
117
+ if (values.force)
118
+ out("--force: a failure recorded for these exact inputs is retried; every check still runs.");
119
+ const qualifier = await deps.load(runner);
120
+ const previousUmask = process.umask(0o077);
121
+ let result;
122
+ try {
123
+ result = await qualifier.runQualifier({ repo: root, store }, { version: values.version, force: values.force });
124
+ }
125
+ catch (err) {
126
+ result = { state: "error", error: err?.message ?? String(err) };
127
+ }
128
+ finally {
129
+ process.umask(previousUmask);
130
+ }
131
+ out("");
132
+ let ok = false;
133
+ switch (result?.state) {
134
+ case "promoted":
135
+ out(`Qualified Codex ${result.version} and made it relay's pin.`);
136
+ try {
137
+ describePin(store, String(result.target), out);
138
+ ok = true;
139
+ }
140
+ catch (err) {
141
+ out(`relay could not read the new pin's manifest in ${path.join(store, String(result.target))}: ${firstLine(err.message)}`);
142
+ }
143
+ break;
144
+ case "error":
145
+ out(`The qualifier stopped with an error before it could record a result: ${firstLine(result.error)}`);
146
+ break;
147
+ case "unchanged":
148
+ out(`Codex ${result.version} is already relay's qualified pin (${result.target}). Nothing changed.`);
149
+ ok = true;
150
+ break;
151
+ case "skipped":
152
+ out(`Not run: Codex ${result.version} (binary sha256 ${result.binarySha256}) already failed qualification with ${isBuildRecord(result.relayBuild) ? describeBuild(result.relayBuild) : "this relay build"} on ${result.failedAt}. Verdict: ${result.verdictPath}. Run again with --force to retry it.`);
153
+ break;
154
+ case "busy":
155
+ out(`Not run: another qualifier run holds the lock on ${store}. Wait for it to finish, then run this again.`);
156
+ break;
157
+ case "failed":
158
+ out(`Qualification of Codex ${result.version} failed: ${firstLine(result.error)}`);
159
+ out(`Evidence: ${result.runDir} (runner.log, stage2.log, failure.json).`);
160
+ break;
161
+ default:
162
+ out(`The qualifier returned no result relay knows (${JSON.stringify(result?.state)}).`);
163
+ }
164
+ // Relay's own answer, whatever the qualifier reported.
165
+ const pinned = relayVerdict(deps.config(), out);
166
+ return ok && pinned ? 0 : 1;
167
+ }
168
+ export async function placeShippedPin(deps, { replaceLocal }) {
169
+ const { out } = deps;
170
+ const store = relayCodexPinStore(deps.config());
171
+ const previousUmask = process.umask(0o077);
172
+ let result;
173
+ // Loading the module is part of the pin step: its failure is the pin's, not the host install's (r_96c6b786 C2).
174
+ try {
175
+ result = await (await deps.loadShipped(path.join(deps.root, CODEX_SHIPPED_PIN))).installShippedPin({ store, packageRoot: deps.root, replaceLocal });
176
+ }
177
+ catch (err) {
178
+ result = { state: "failed", error: err?.message ?? String(err) };
179
+ }
180
+ finally {
181
+ process.umask(previousUmask);
182
+ }
183
+ const shipped = result.shipped;
184
+ const what = shipped ? `Codex ${shipped.codex.version} (npm ${shipped.codex.npmIntegrity.slice(0, 23)}…), qualified by the maintainer with ${describeBuild(shipped.relay)}` : "";
185
+ switch (result.state) {
186
+ case "installed":
187
+ out(`Put this release's shipped Codex pin in place: ${what}. Relay downloaded it and checked npm's integrity, Apple's signature, OpenAI's Team ID and the exact version; the stage-2 qualification is the maintainer's (${path.join(store, "current")} -> ${result.target}).`);
188
+ return "installed";
189
+ case "unchanged":
190
+ out(`This release's shipped Codex pin is already in place: ${what}.`);
191
+ return "unchanged";
192
+ case "local-kept":
193
+ out(`Your own qualified Codex pin (Codex ${result.version}, ${result.target}) stays in force; this release ships a pin for ${what}. \`relay qualify-codex --shipped\` switches to it.`);
194
+ return "local-kept";
195
+ case "none":
196
+ out("This relay ships no Codex pin (a git checkout never does): run `relay qualify-codex` once from your own terminal to qualify one here (about an hour and a half).");
197
+ return "none";
198
+ case "busy":
199
+ out(`Not done: a qualifier run holds the lock on ${store}. Wait for it to finish, then run this again.`);
200
+ return "busy";
201
+ default:
202
+ out(`Putting the shipped Codex pin in place failed: ${firstLine(result.error)}`);
203
+ return "failed";
204
+ }
205
+ }