@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,158 @@
1
+ #!/usr/bin/env node
2
+ // A release's shipped Codex pin (decision 18; format in src/core/shipped-pin.ts).
3
+ //
4
+ // - writeShippedPin: the maintainer's side, and the only code that writes codex-pin.json. It writes
5
+ // one only from the pin store's current pin when that is a qualification on this Mac (versions/),
6
+ // re-judged now against the current verdict schema with its verdict bound by digest, and when
7
+ // that qualification ran exactly the build being released.
8
+ // - installShippedPin: the user's side (`relay install codex --write`, `relay qualify-codex
9
+ // --shipped`). It downloads the Codex release the package's shipped pin names, refuses unless
10
+ // npm's integrity is the pinned one (before downloading) and the bytes match it, checks Apple's
11
+ // signature, OpenAI's Team ID and the exact version as the qualifier does, and publishes the tree
12
+ // under shipped/. Relay then runs it only while the running build is the one the pin names
13
+ // (src/backends/codex-pin.ts). It never replaces a local pin unless asked to.
14
+ // - checkTarball: a packed release carries a valid shipped pin for exactly its own build.
15
+ //
16
+ // node scripts/codex-qualify/codex-shipped-pin.mjs --write --store /abs/pin-store [--package /abs/relay]
17
+ // node scripts/codex-qualify/codex-shipped-pin.mjs --check-tarball relay-X.Y.Z.tgz
18
+ import fs from "node:fs";
19
+ import os from "node:os";
20
+ import path from "node:path";
21
+ import { spawnSync } from "node:child_process";
22
+ import { parseArgs } from "node:util";
23
+ import { acquire, liveServices } from "./codex-qualifier.mjs";
24
+ import { ProcessSupervisor } from "./codex-qualifier-process.mjs";
25
+ import {
26
+ CURRENT_VERDICT_SCHEMA, acquireLock, atomicJson, initStore, isShippedTarget, pointer, promote,
27
+ publishShippedTree, recoverTransaction, sha256, validateTarget,
28
+ } from "./codex-pin-store.mjs";
29
+ import { isMain } from "./main-module.mjs";
30
+ import { buildIdentity, describeBuild, sameBuild } from "../../dist/core/build-identity.js";
31
+ import { SHIPPED_PIN_FILE, SHIPPED_PIN_FORMAT, parseShippedPin, readShippedPin, sameShippedPin } from "../../dist/core/shipped-pin.js";
32
+
33
+ const PACKAGE_ROOT = path.resolve(import.meta.dirname, "..", "..");
34
+
35
+ /**
36
+ * The shipped pin a passing local qualification in `store` supports for the relay build at
37
+ * `packageRoot`, written to <packageRoot>/codex-pin.json. Throws, writing nothing, unless every
38
+ * condition holds; holds the store's lock so that current cannot move underneath.
39
+ */
40
+ export function writeShippedPin({ store, packageRoot = PACKAGE_ROOT }) {
41
+ if (!path.isAbsolute(store ?? "") || !path.isAbsolute(packageRoot ?? "")) throw new Error("store and package must be absolute");
42
+ const release = acquireLock(store);
43
+ if (!release) throw new Error(`the pin store ${store} is locked by a running qualifier; wait for it`);
44
+ try {
45
+ recoverTransaction(store);
46
+ const current = pointer(store, "current");
47
+ if (!current) throw new Error(`${store} has no current pin: qualify the release's Codex first`);
48
+ if (isShippedTarget(current)) throw new Error(`current (${current}) is a release's shipped pin, not a qualification on this Mac`);
49
+ // validateTarget re-reads the sealed manifest and the binary's digest, and re-judges the
50
+ // verdict file, bound to the manifest by its sha256, against the manifest's schema.
51
+ const m = validateTarget(store, current);
52
+ if (m.qualificationFixture) throw new Error("current is a stage-2 fixture pin, not a qualification");
53
+ if (m.verdictSchema !== CURRENT_VERDICT_SCHEMA || !m.verdictSha256) {
54
+ throw new Error(`current was qualified under ${m.verdictSchema ?? "the unversioned stage2-v1 schema"}; a shipped pin needs a qualification under ${CURRENT_VERDICT_SCHEMA}`);
55
+ }
56
+ if (sha256(m.verdictPath) !== m.verdictSha256) throw new Error("the qualification's verdict changed since it was judged");
57
+ const build = buildIdentity(packageRoot);
58
+ if (!m.relayBuild) throw new Error("current was qualified before relay had build identities (it names a relay commit); qualify again with this build");
59
+ if (m.relayBuild.scheme !== build.scheme) throw new Error(`current was qualified under ${m.relayBuild.scheme}, which does not cover relay's dependency lock; qualify again with this build (${build.scheme})`);
60
+ if (!sameBuild(m.relayBuild, build)) throw new Error(`current was qualified with ${describeBuild(m.relayBuild)}, not ${describeBuild(build)}, the build being released`);
61
+ const pin = parseShippedPin({
62
+ format: SHIPPED_PIN_FORMAT,
63
+ codex: { version: m.version, npmIntegrity: m.npmIntegrity },
64
+ relay: { scheme: build.scheme, version: build.version, sha256: build.sha256 },
65
+ });
66
+ atomicJson(path.join(packageRoot, SHIPPED_PIN_FILE), pin);
67
+ fs.chmodSync(path.join(packageRoot, SHIPPED_PIN_FILE), 0o644);
68
+ return { pin, from: current, verdictPath: m.verdictPath };
69
+ } finally {
70
+ release();
71
+ }
72
+ }
73
+
74
+ /**
75
+ * Puts the shipped pin of the relay at `packageRoot` in place in `store` and makes it current.
76
+ * Returns { state }: "none" (this relay ships no pin), "unchanged", "local-kept" (current is a
77
+ * qualification on this Mac and `replaceLocal` is false), "installed", "busy" or "failed".
78
+ */
79
+ export async function installShippedPin({ store, packageRoot = PACKAGE_ROOT, replaceLocal = false, services: supplied, supervisor: suppliedSupervisor } = {}) {
80
+ if (!path.isAbsolute(store ?? "")) throw new Error("store must be absolute");
81
+ const shipped = readShippedPin(packageRoot);
82
+ if (!shipped) return { state: "none" };
83
+ const build = buildIdentity(packageRoot);
84
+ if (!sameBuild(build, shipped.relay)) {
85
+ return { state: "failed", error: `this relay's shipped pin was qualified with ${describeBuild(shipped.relay)}, and this package is ${describeBuild(build)}: the package was changed after it was released. Reinstall relay, or qualify a Codex here with relay qualify-codex.` };
86
+ }
87
+ initStore(store);
88
+ const release = acquireLock(store);
89
+ if (!release) return { state: "busy" };
90
+ let scratch;
91
+ try {
92
+ recoverTransaction(store);
93
+ const current = pointer(store, "current");
94
+ if (current) {
95
+ const m = validateTarget(store, current);
96
+ if (isShippedTarget(current) && m.version === shipped.codex.version && m.npmIntegrity === shipped.codex.npmIntegrity) return { state: "unchanged", target: current, shipped };
97
+ if (!isShippedTarget(current) && !replaceLocal) return { state: "local-kept", target: current, version: m.version, shipped };
98
+ }
99
+ scratch = fs.mkdtempSync(path.join(store, "staging", "shipped-"));
100
+ const supervisor = suppliedSupervisor ?? new ProcessSupervisor(scratch);
101
+ const services = supplied ?? liveServices(scratch, supervisor);
102
+ const candidate = await acquire(shipped.codex.version, scratch, services, { integrity: shipped.codex.npmIntegrity });
103
+ if (candidate.npmIntegrity !== shipped.codex.npmIntegrity) throw new Error("downloaded Codex does not match the shipped pin's integrity");
104
+ const manifest = {
105
+ version: shipped.codex.version, binarySha256: candidate.binarySha256, npmIntegrity: candidate.npmIntegrity,
106
+ codesign: candidate.codesign, installedAt: new Date().toISOString(),
107
+ };
108
+ const target = publishShippedTree(store, candidate.vendor, manifest);
109
+ const transaction = promote(store, target, "promote");
110
+ atomicJson(path.join(store, "last-result.json"), { state: "shipped", version: manifest.version, target, transaction, relay: shipped.relay });
111
+ return { state: "installed", target, shipped, previous: current };
112
+ } catch (err) {
113
+ let recoveryError;
114
+ try { recoverTransaction(store); } catch (e) { recoveryError = e.message; }
115
+ return { state: "failed", error: err.message, ...(recoveryError ? { recoveryError } : {}) };
116
+ } finally {
117
+ if (scratch) {
118
+ const unseal = (dir) => { try { fs.chmodSync(dir, 0o700); for (const e of fs.readdirSync(dir, { withFileTypes: true })) if (e.isDirectory()) unseal(path.join(dir, e.name)); } catch { /* gone */ } };
119
+ unseal(scratch);
120
+ fs.rmSync(scratch, { recursive: true, force: true });
121
+ }
122
+ release();
123
+ }
124
+ }
125
+
126
+ /** A packed release (npm pack's .tgz): its codex-pin.json must be valid and name exactly the build it packs. */
127
+ export function checkTarball(tarball) {
128
+ const dir = fs.mkdtempSync(path.join(os.tmpdir(), "relay-tarball-"));
129
+ try {
130
+ const r = spawnSync("/usr/bin/tar", ["-xzf", tarball, "-C", dir], { encoding: "utf8" });
131
+ if (r.status !== 0) throw new Error(`cannot unpack ${tarball}: ${r.stderr.trim()}`);
132
+ const root = path.join(dir, "package");
133
+ const pin = readShippedPin(root);
134
+ if (!pin) throw new Error(`${tarball} carries no ${SHIPPED_PIN_FILE}`);
135
+ const build = buildIdentity(root);
136
+ if (!sameBuild(build, pin.relay)) throw new Error(`${tarball}'s shipped pin names ${describeBuild(pin.relay)}, and it packs ${describeBuild(build)}`);
137
+ return { pin, build };
138
+ } finally {
139
+ fs.rmSync(dir, { recursive: true, force: true });
140
+ }
141
+ }
142
+
143
+ export { sameShippedPin };
144
+
145
+ if (isMain(import.meta.url)) {
146
+ try {
147
+ const { values } = parseArgs({ options: { write: { type: "boolean" }, store: { type: "string" }, package: { type: "string" }, "check-tarball": { type: "string" } } });
148
+ if (values.write && values.store && !values["check-tarball"]) {
149
+ const { pin, from, verdictPath } = writeShippedPin({ store: values.store, packageRoot: values.package ?? PACKAGE_ROOT });
150
+ console.log(`Wrote ${path.join(values.package ?? PACKAGE_ROOT, SHIPPED_PIN_FILE)} from ${from} (verdict ${verdictPath}):\n${JSON.stringify(pin, null, 2)}`);
151
+ } else if (values["check-tarball"] && !values.write) {
152
+ const { pin, build } = checkTarball(path.resolve(values["check-tarball"]));
153
+ console.log(`${values["check-tarball"]}: shipped pin for Codex ${pin.codex.version}, qualified with ${describeBuild(build)}: matches the build it packs.`);
154
+ } else {
155
+ throw new Error("usage: codex-shipped-pin.mjs --write --store /abs/pin-store [--package /abs/relay] | --check-tarball relay.tgz");
156
+ }
157
+ } catch (e) { console.error(e.message); process.exitCode = 1; }
158
+ }
@@ -0,0 +1,48 @@
1
+ // Provisional pins for the model-free qualifier only. These are never published or promoted:
2
+ // qualification must exercise Relay's pinned path before the candidate has a passing verdict.
3
+ import fs from "node:fs";
4
+ import path from "node:path";
5
+ import { atomicJson, sha256, TEAM_ID, validateManifest } from "./codex-pin-store.mjs";
6
+ import { scratchEnv } from "./scratch-env.mjs";
7
+
8
+ /** Stage the supplied executable (not an installed/current pin) in a fresh scratch store. */
9
+ export function stageQualificationPin({ scratch, bin, version }) {
10
+ if (!/^\d+\.\d+\.\d+$/.test(version)) throw new Error("candidate must be stable semver");
11
+ const env = scratchEnv(scratch);
12
+ const home = path.join(env.HOME, ".local/share/relay-codex-home");
13
+ const store = path.join(env.HOME, ".local/share/relay-codex-pins");
14
+ // Validate existing ancestors before creating anything beneath them. A stale scratch symlink
15
+ // must not redirect a write to a person's home or pin store.
16
+ scratchEnv(scratch, { CODEX_HOME: home });
17
+ scratchEnv(scratch, { CODEX_HOME: path.dirname(store) });
18
+ fs.mkdirSync(store, { mode: 0o700 }); // Deliberately refuse reuse, including symlink aliases.
19
+ const source = fs.realpathSync(bin);
20
+ const binarySha256 = sha256(source);
21
+ const target = `versions/${version}-${binarySha256.slice(0, 12)}`;
22
+ const dir = path.join(store, target);
23
+ fs.mkdirSync(path.join(dir, "bin"), { recursive: true, mode: 0o700 });
24
+ const copy = (from, to) => { fs.copyFileSync(from, to, fs.constants.COPYFILE_EXCL); fs.chmodSync(to, 0o555); };
25
+ const stagedBin = path.join(dir, "bin/codex");
26
+ copy(source, stagedBin);
27
+ if (sha256(stagedBin) !== binarySha256) throw new Error("candidate changed while staging qualification pin");
28
+ // Homebrew and npm ship code mode's host beside the native executable. Resolve a launcher
29
+ // symlink first so copying the candidate does not lose its companion or select one from PATH.
30
+ const host = path.join(path.dirname(source), "codex-code-mode-host");
31
+ if (fs.existsSync(host)) copy(host, path.join(dir, "bin/codex-code-mode-host"));
32
+ const manifest = validateManifest({
33
+ version, binarySha256,
34
+ // Shape-compatible fixture metadata, not acquisition/qualification evidence. The real
35
+ // qualifier verifies npm/codesign/source and publishes only AFTER this run has passed.
36
+ npmIntegrity: `sha512-${"A".repeat(86)}==`,
37
+ codesign: { teamId: TEAM_ID, identity: "stage-2 qualification fixture (unqualified)" },
38
+ qualifiedAt: new Date().toISOString(), sourceCommit: "0".repeat(40),
39
+ verdictPath: path.join(fs.realpathSync(scratch), "stage2-verdict.json"),
40
+ qualificationFixture: true,
41
+ });
42
+ atomicJson(path.join(dir, "manifest.json"), manifest);
43
+ fs.chmodSync(path.join(dir, "manifest.json"), 0o444);
44
+ fs.chmodSync(path.join(dir, "bin"), 0o555);
45
+ fs.chmodSync(dir, 0o555);
46
+ fs.symlinkSync(target, path.join(store, "current"));
47
+ return { bin: stagedBin, pin_store: store, home, pinned: true };
48
+ }