@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,182 @@
1
+ // Which of the names relay released to a Codex turn (child_env.pass, a person-approved grant.env)
2
+ // Codex itself keeps from the commands it runs, by the person's own shell_environment_policy.
3
+ // Relay never sets, overrides or edits that policy: this only reads it (config/read, at a turn and
4
+ // in doctor's codex env line) and says what it does. Names and reasons only, never a value.
5
+ //
6
+ // Mirrors codex-cli 0.163.0 (tag rust-v0.163.0, commit 8308618), and is unchanged in 0.164.0 (tag
7
+ // rust-v0.164.0, commit 6aaac69; rechecked 2026-10-23), whose lines these are, under codex-rs/:
8
+ // - config/src/shell_environment_policy.rs:15-49, 92-131: the fields (inherit,
9
+ // ignore_default_excludes, exclude, set, include_only, filters, experimental_use_profile), and
10
+ // `filters`, which cannot be mixed with exclude or include_only, nor repeat a pattern ignoring case.
11
+ // - same file, 133-169: inherit defaults to "all" and ignore_default_excludes to true, so the
12
+ // default excludes are off unless it is set false; filters' "include" patterns are include_only,
13
+ // their "exclude" patterns exclude.
14
+ // - protocol/src/shell_environment.rs:105-175 populate_env, applied to the app server's own
15
+ // environment, where relay's released names are: (1) inherit all, none, or core
16
+ // (UNIX_CORE_ENV_VARS, 177-181, compared ignoring ASCII case); (2) unless
17
+ // ignore_default_excludes, drop *KEY*, *SECRET*, *TOKEN*; (3) drop exclude matches; (4) insert
18
+ // `set`, by exact name on Unix, which replaces a released value of that name; (5) with
19
+ // include_only non-empty, keep only matches, `set`'s entries too; (6) NON_INHERITABLE_ENV_VARS
20
+ // (15-28, ignoring ASCII case) always removed.
21
+ // - protocol/src/config_types.rs:230: patterns are wildmatch 2.6.1 WildMatchPattern<'*','?'>
22
+ // built case-insensitive: `*` any run of characters, `?` one, the whole name, no escapes or
23
+ // classes, each character compared after Unicode lowercasing.
24
+ // - core/src/unified_exec/process_manager.rs:1473-1496, exec_command (the tool Codex's model runs
25
+ // commands with; source unifiedExecStartup): the policy's result, then Codex sets CODEX_THREAD_ID,
26
+ // CODEX_TOOL_CALL_ID, CODEX_SESSION_ID, CODEX_VERSION, CODEX_APPLY_PATCH_PRESERVE_LINE_ENDINGS and
27
+ // CODEX_PERMISSION_PROFILE (core/src/exec_env.rs:41-82), the ten names of UNIFIED_EXEC_ENV
28
+ // (process_manager.rs:94-105, 130-135), and removes CODEX_PLUGIN_METRICS_OUTPUT
29
+ // (core-plugins/src/plugin_metrics_sidecar.rs:26, 247-253). The local exec backend builds the
30
+ // same environment again from the same policy (exec-server/src/local_process.rs:747-802).
31
+ // - The login shell's snapshot keeps only the exports the same policy admits
32
+ // (shell-command/src/shell_snapshot_render.rs:17-32, core/src/shell_snapshot.rs:618-619 and
33
+ // 670-676), so it cannot bring a withheld name back. The person's shell startup files can still
34
+ // give a name a value of their own when a command runs a login shell or is captured in the
35
+ // snapshot; relay cannot see that, and does not judge it.
36
+ // - experimental_use_profile is parsed into use_profile and read nowhere in 0.163.0 or 0.164.0.
37
+ // - A profile cannot set this policy (config/src/profile_toml.rs:24-82 has no such field), and
38
+ // config/read reports the policy merged from every layer, -c flags included
39
+ // (app-server/src/config_manager.rs:603-624, config_manager_service.rs:120-151), as configured,
40
+ // not resolved: an unset field is null.
41
+ // A shape this does not recognise (a field it does not know, a value of the wrong type, filters
42
+ // mixed with the legacy lists) makes every name "cannot tell", never a guess.
43
+ const FIELDS = new Set(["inherit", "ignore_default_excludes", "exclude", "set", "include_only", "filters", "experimental_use_profile"]);
44
+ const CORE = ["PATH", "SHELL", "TMPDIR", "TEMP", "TMP", "HOME", "LANG", "LC_ALL", "LC_CTYPE", "LOGNAME", "USER"];
45
+ const DEFAULT_EXCLUDES = ["*KEY*", "*SECRET*", "*TOKEN*"];
46
+ const NON_INHERITABLE = ["CODEX_EXEC_SERVER_NOISE_AUTH_TOKEN", "NODE_REPL_AUTH_TOKEN", "CODEX_GUARDIAN_DECISIONS_API_KEY", "OPENAI_FEDERATION_RULE_ID", "OPENAI_IDENTITY_TOKEN_FILE", "OPENAI_WORKLOAD_IDENTITY_CONTEXT"];
47
+ /** What exec_command sets or removes after the policy, by exact name on Unix. */
48
+ const CODEX_SETS = new Set([
49
+ "CODEX_THREAD_ID", "CODEX_TOOL_CALL_ID", "CODEX_SESSION_ID", "CODEX_VERSION", "CODEX_APPLY_PATCH_PRESERVE_LINE_ENDINGS", "CODEX_PERMISSION_PROFILE", "CODEX_PLUGIN_METRICS_OUTPUT",
50
+ "NO_COLOR", "TERM", "LANG", "LC_CTYPE", "LC_ALL", "COLORTERM", "PAGER", "GIT_PAGER", "GH_PAGER", "CODEX_CI",
51
+ ]);
52
+ /** Rust's eq_ignore_ascii_case: only A-Z fold. */
53
+ const asciiLower = (s) => s.replace(/[A-Z]/g, (c) => c.toLowerCase());
54
+ const sameAscii = (a, b) => asciiLower(a) === asciiLower(b);
55
+ const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
56
+ const unset = (v) => v === undefined || v === null;
57
+ /** wildmatch 2.6.1's case-insensitive match: `*` any run, `?` one character, the whole name, characters compared lowercased. */
58
+ export function codexPatternMatches(pattern, name) {
59
+ const p = [...pattern].map((c) => c.toLowerCase());
60
+ const s = [...name].map((c) => c.toLowerCase());
61
+ let i = 0, j = 0, star = -1, mark = 0;
62
+ while (j < s.length) {
63
+ if (i < p.length && p[i] === "*") {
64
+ star = i++;
65
+ mark = j;
66
+ }
67
+ else if (i < p.length && (p[i] === "?" || p[i] === s[j])) {
68
+ i++;
69
+ j++;
70
+ }
71
+ else if (star >= 0) {
72
+ i = star + 1;
73
+ j = ++mark;
74
+ }
75
+ else
76
+ return false;
77
+ }
78
+ while (i < p.length && p[i] === "*")
79
+ i++;
80
+ return i === p.length;
81
+ }
82
+ /** The policy, or why relay does not recognise its shape. `raw` undefined: the server did not report one. */
83
+ function parse(raw) {
84
+ if (raw === undefined)
85
+ return "Codex did not report its shell_environment_policy";
86
+ if (!isObject(raw))
87
+ return "Codex reported a shell_environment_policy that is not a table";
88
+ const unknown = Object.keys(raw).filter((k) => !FIELDS.has(k)).sort();
89
+ if (unknown.length)
90
+ return `Codex's shell_environment_policy has ${unknown.length === 1 ? "a field" : "fields"} relay does not know (${unknown.join(", ")})`;
91
+ const wrong = (field) => `Codex's shell_environment_policy.${field} is not of a type relay knows`;
92
+ const strings = (v) => Array.isArray(v) && v.every((x) => typeof x === "string");
93
+ const inherit = unset(raw.inherit) ? "all" : raw.inherit;
94
+ if (inherit !== "all" && inherit !== "core" && inherit !== "none")
95
+ return wrong("inherit");
96
+ if (!unset(raw.ignore_default_excludes) && typeof raw.ignore_default_excludes !== "boolean")
97
+ return wrong("ignore_default_excludes");
98
+ if (!unset(raw.experimental_use_profile) && typeof raw.experimental_use_profile !== "boolean")
99
+ return wrong("experimental_use_profile");
100
+ for (const field of ["exclude", "include_only"])
101
+ if (!unset(raw[field]) && !strings(raw[field]))
102
+ return wrong(field);
103
+ if (!unset(raw.set) && !(isObject(raw.set) && Object.values(raw.set).every((v) => typeof v === "string")))
104
+ return wrong("set");
105
+ let exclude = (raw.exclude ?? []);
106
+ let includeOnly = (raw.include_only ?? []);
107
+ const filters = !unset(raw.filters);
108
+ if (filters) {
109
+ if (!isObject(raw.filters) || !Object.values(raw.filters).every((v) => v === "include" || v === "exclude"))
110
+ return wrong("filters");
111
+ if (!unset(raw.exclude) || !unset(raw.include_only))
112
+ return "Codex's shell_environment_policy mixes filters with exclude or include_only, which Codex does not accept";
113
+ const keys = Object.keys(raw.filters);
114
+ if (new Set(keys.map((k) => k.toLowerCase())).size !== keys.length)
115
+ return "Codex's shell_environment_policy.filters repeats a pattern ignoring case, which Codex does not accept";
116
+ exclude = keys.filter((k) => raw.filters[k] === "exclude");
117
+ includeOnly = keys.filter((k) => raw.filters[k] === "include");
118
+ }
119
+ return {
120
+ inherit, ignoreDefaultExcludes: raw.ignore_default_excludes ?? true,
121
+ exclude, includeOnly, set: new Set(Object.keys((raw.set ?? {}))), filters,
122
+ };
123
+ }
124
+ /** The two reasons that are Codex's own handling rather than the person's policy, and not the person's to change. */
125
+ const NEVER = "Codex never passes it to commands";
126
+ const CODEX_SET = "Codex sets it itself for every command";
127
+ /** Why Codex keeps `name` from its commands, in Codex's order, or [] when the released value reaches them. */
128
+ function reasons(policy, name) {
129
+ const out = [];
130
+ if (policy.inherit === "none")
131
+ out.push('not inherited: inherit = "none"');
132
+ else if (policy.inherit === "core" && !CORE.some((c) => sameAscii(c, name)))
133
+ out.push('not inherited: inherit = "core"');
134
+ if (!policy.ignoreDefaultExcludes) {
135
+ const hit = DEFAULT_EXCLUDES.find((p) => codexPatternMatches(p, name));
136
+ if (hit)
137
+ out.push(`matches Codex's default exclude ${hit}, on with ignore_default_excludes = false`);
138
+ }
139
+ const excluded = policy.exclude.find((p) => codexPatternMatches(p, name));
140
+ if (excluded !== undefined)
141
+ out.push(policy.filters ? `matches the exclude filter ${JSON.stringify(excluded)}` : `matches exclude ${JSON.stringify(excluded)}`);
142
+ if (policy.set.has(name))
143
+ out.push("replaced by shell_environment_policy.set");
144
+ if (policy.includeOnly.length && !policy.includeOnly.some((p) => codexPatternMatches(p, name)))
145
+ out.push(policy.filters ? "matches no include filter" : "matches no include_only pattern");
146
+ if (NON_INHERITABLE.some((n) => sameAscii(n, name)))
147
+ out.push(NEVER);
148
+ if (CODEX_SETS.has(name))
149
+ out.push(CODEX_SET);
150
+ return out;
151
+ }
152
+ /**
153
+ * Which of `names` Codex keeps from the commands it runs, and why, under `policy` as config/read
154
+ * reports it (shell_environment_policy) or as config.toml has it. A shape relay does not recognise
155
+ * gives known: false, with why, for every name.
156
+ */
157
+ export function codexShellPolicyVerdict(policy, names) {
158
+ const parsed = parse(policy);
159
+ if (typeof parsed === "string")
160
+ return { known: false, why: parsed };
161
+ const withheld = [...new Set(names)].sort().map((name) => ({ name, reasons: reasons(parsed, name) })).filter((w) => w.reasons.length);
162
+ return { known: true, withheld };
163
+ }
164
+ /** Whether any reason is the person's policy (and so the person's to change), not Codex's own handling. */
165
+ const byPolicy = (withheld) => withheld.some((w) => w.reasons.some((r) => r !== NEVER && r !== CODEX_SET));
166
+ const listed = (withheld) => withheld.map((w) => `${w.name} (${w.reasons.join("; ")})`).join(", ");
167
+ const REMEDY = "To let a name through, change shell_environment_policy (inherit, include_only, exclude, set) in Codex's own config; relay does not override it.";
168
+ /**
169
+ * The note for a Codex turn whose released names (as delivered to Codex's process) include some
170
+ * Codex keeps from its commands, or null: names and reasons only.
171
+ */
172
+ export function codexShellPolicyNote(policy, names) {
173
+ if (!names.length)
174
+ return null;
175
+ const v = codexShellPolicyVerdict(policy, names);
176
+ if (!v.known)
177
+ return `Relay cannot tell whether Codex passes ${[...new Set(names)].sort().join(", ")}, released for this turn, to the commands it runs: ${v.why}. Codex's own shell_environment_policy decides that; relay does not override it.`;
178
+ if (!v.withheld.length)
179
+ return null;
180
+ return `Codex will not pass ${v.withheld.length === 1 ? "this name" : "these names"} relay released for this turn to the commands it runs: ${listed(v.withheld)}. ` +
181
+ `Relay gave ${v.withheld.length === 1 ? "it" : "them"} to Codex's process.${byPolicy(v.withheld) ? ` ${REMEDY}` : ""}`;
182
+ }