@jbkjr/relay 0.0.0-stage → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/LICENSES/Apache-2.0.txt +201 -0
- package/LICENSES/README.md +19 -0
- package/LICENSES/codex-NOTICE.txt +6 -0
- package/README.md +386 -2
- package/SECURITY.md +145 -0
- package/adapters/briefs/claude.md +43 -0
- package/adapters/briefs/codex.md +56 -0
- package/adapters/briefs/models.json +33 -0
- package/adapters/build.mjs +8 -0
- package/adapters/claude/.claude-plugin/marketplace.json +13 -0
- package/adapters/claude/relay/.claude-plugin/plugin.json +5 -0
- package/adapters/claude/relay/agents/codex.md +21 -0
- package/adapters/claude/relay/agents/operator.md +21 -0
- package/adapters/claude/relay/skills/ask/SKILL.md +20 -0
- package/adapters/claude/relay/skills/chat/SKILL.md +13 -0
- package/adapters/claude/relay/skills/delegate/SKILL.md +21 -0
- package/adapters/claude/relay/skills/discuss/SKILL.md +19 -0
- package/adapters/claude/relay/skills/review/SKILL.md +21 -0
- package/adapters/claude/relay/skills/tree/SKILL.md +10 -0
- package/adapters/claude/relay/skills/write-for-codex/SKILL.md +78 -0
- package/adapters/codex/.agents/plugins/marketplace.json +20 -0
- package/adapters/codex/AGENTS.snippet.md +5 -0
- package/adapters/codex/relay/.codex-plugin/plugin.json +6 -0
- package/adapters/codex/relay/skills/relay-ask/SKILL.md +20 -0
- package/adapters/codex/relay/skills/relay-chat/SKILL.md +13 -0
- package/adapters/codex/relay/skills/relay-delegate/SKILL.md +21 -0
- package/adapters/codex/relay/skills/relay-discuss/SKILL.md +19 -0
- package/adapters/codex/relay/skills/relay-review/SKILL.md +21 -0
- package/adapters/codex/relay/skills/relay-tree/SKILL.md +10 -0
- package/adapters/codex/relay/skills/relay-write-for-claude/SKILL.md +66 -0
- package/adapters/generate.mjs +124 -0
- package/bin/relay +59 -0
- package/codex-pin.json +12 -0
- package/dist/backends/acp.js +1424 -0
- package/dist/backends/claude.js +890 -0
- package/dist/backends/cli-version.js +112 -0
- package/dist/backends/codex-app.js +1525 -0
- package/dist/backends/codex-daybreak.js +75 -0
- package/dist/backends/codex-env.js +656 -0
- package/dist/backends/codex-network.js +304 -0
- package/dist/backends/codex-pin.js +320 -0
- package/dist/backends/codex-shell-policy.js +182 -0
- package/dist/backends/codex-stage2.js +998 -0
- package/dist/backends/codex-subagents.js +47 -0
- package/dist/backends/codex.js +637 -0
- package/dist/backends/copilot.js +246 -0
- package/dist/backends/env.js +147 -0
- package/dist/backends/gemini.js +607 -0
- package/dist/backends/grok.js +337 -0
- package/dist/backends/index.js +8 -0
- package/dist/backends/native-temp.js +187 -0
- package/dist/backends/never-admission.js +90 -0
- package/dist/backends/run.js +67 -0
- package/dist/backends/stream.js +230 -0
- package/dist/backends/tool-discovery.js +15 -0
- package/dist/backends/types.js +264 -0
- package/dist/build-info.json +5 -0
- package/dist/cli.js +344 -0
- package/dist/confine/bridge.js +113 -0
- package/dist/confine/broker-core.js +76 -0
- package/dist/confine/broker-http.js +650 -0
- package/dist/confine/broker-names.js +9 -0
- package/dist/confine/broker.js +258 -0
- package/dist/confine/canary.js +380 -0
- package/dist/confine/diagnostics.js +122 -0
- package/dist/confine/gemini-tools-main.js +8 -0
- package/dist/confine/gemini-tools.js +181 -0
- package/dist/confine/hardlinks.js +58 -0
- package/dist/confine/harness-config.js +16 -0
- package/dist/confine/index.js +117 -0
- package/dist/confine/leases.js +217 -0
- package/dist/confine/paths.js +6 -0
- package/dist/confine/peer.js +115 -0
- package/dist/confine/port-policy.js +8 -0
- package/dist/confine/ports.js +365 -0
- package/dist/confine/private-root.js +208 -0
- package/dist/confine/probe-stage2.js +501 -0
- package/dist/confine/probe.js +1109 -0
- package/dist/confine/proxy.js +783 -0
- package/dist/confine/sbcheck.js +208 -0
- package/dist/confine/seatbelt-never.js +41 -0
- package/dist/confine/seatbelt-stage2.js +139 -0
- package/dist/confine/seatbelt.js +1129 -0
- package/dist/confine/sockets.js +36 -0
- package/dist/confine/turn-probe.js +19 -0
- package/dist/confine/turn.js +86 -0
- package/dist/core/adoption.js +124 -0
- package/dist/core/api-keys.js +423 -0
- package/dist/core/approvals.js +740 -0
- package/dist/core/build-identity.js +248 -0
- package/dist/core/caller.js +749 -0
- package/dist/core/calls.js +102 -0
- package/dist/core/claude-settings.js +1045 -0
- package/dist/core/config.js +453 -0
- package/dist/core/context.js +186 -0
- package/dist/core/db.js +753 -0
- package/dist/core/dispatch.js +110 -0
- package/dist/core/env-broker.js +505 -0
- package/dist/core/env-policy.js +182 -0
- package/dist/core/escalation-authority.js +76 -0
- package/dist/core/escalation-contract.js +13 -0
- package/dist/core/escalation-person-path.js +131 -0
- package/dist/core/escalation-policy.js +79 -0
- package/dist/core/escalation-runtime.js +135 -0
- package/dist/core/escalation-state.js +42 -0
- package/dist/core/escalations.js +191 -0
- package/dist/core/events.js +235 -0
- package/dist/core/executables.js +147 -0
- package/dist/core/extensions.js +645 -0
- package/dist/core/families.js +204 -0
- package/dist/core/git.js +657 -0
- package/dist/core/identity.js +113 -0
- package/dist/core/liveness.js +68 -0
- package/dist/core/mediated-network-provider.js +81 -0
- package/dist/core/never-checkpoint.js +76 -0
- package/dist/core/never-coverage.js +97 -0
- package/dist/core/never-network.js +49 -0
- package/dist/core/never-policy.js +302 -0
- package/dist/core/never-proxy-policy.js +109 -0
- package/dist/core/never-schema.js +61 -0
- package/dist/core/never-tools.js +56 -0
- package/dist/core/notices.js +48 -0
- package/dist/core/ops.js +959 -0
- package/dist/core/outcome.js +224 -0
- package/dist/core/params.js +32 -0
- package/dist/core/presence.js +174 -0
- package/dist/core/procs.js +546 -0
- package/dist/core/prompts.js +363 -0
- package/dist/core/protected-config.js +238 -0
- package/dist/core/raw-network.js +192 -0
- package/dist/core/redact.js +152 -0
- package/dist/core/refusal.js +33 -0
- package/dist/core/relay-command.js +310 -0
- package/dist/core/reported.js +3 -0
- package/dist/core/restart-overlay.js +651 -0
- package/dist/core/retention.js +1135 -0
- package/dist/core/secrets.js +329 -0
- package/dist/core/session-token.js +175 -0
- package/dist/core/session.js +744 -0
- package/dist/core/shell.js +2 -0
- package/dist/core/shipped-pin.js +47 -0
- package/dist/core/shown.js +42 -0
- package/dist/core/slots.js +67 -0
- package/dist/core/stage2-executors.js +453 -0
- package/dist/core/stage2-switch.js +5 -0
- package/dist/core/steering.js +149 -0
- package/dist/core/storage.js +358 -0
- package/dist/core/toml.js +175 -0
- package/dist/core/views.js +324 -0
- package/dist/core/wait.js +114 -0
- package/dist/core/wake.js +207 -0
- package/dist/core/watch.js +247 -0
- package/dist/core/worktree.js +213 -0
- package/dist/hosts/claude-desktop.js +274 -0
- package/dist/hosts/claude.js +249 -0
- package/dist/hosts/codex.js +329 -0
- package/dist/hosts/desktop-shared.js +20 -0
- package/dist/hosts/index.js +11 -0
- package/dist/hosts/types.js +4 -0
- package/dist/install/basics.js +18 -0
- package/dist/install/claude-init.js +133 -0
- package/dist/install/common.js +655 -0
- package/dist/install/doctor.js +629 -0
- package/dist/install/qualify-codex.js +205 -0
- package/dist/install.js +524 -0
- package/dist/mcp/elicit.js +209 -0
- package/dist/mcp/gateway.js +218 -0
- package/dist/mcp/host.js +253 -0
- package/dist/mcp/server.js +1124 -0
- package/dist/mcp/stdio.js +37 -0
- package/dist/modes/discussion.js +393 -0
- package/dist/modes/review.js +722 -0
- package/dist/native/relay-sbcheck +0 -0
- package/dist/targets/briefs.js +86 -0
- package/dist/targets/claude.js +94 -0
- package/dist/targets/codex.js +66 -0
- package/dist/targets/copilot.js +93 -0
- package/dist/targets/gemini.js +119 -0
- package/dist/targets/grok.js +126 -0
- package/dist/targets/index.js +192 -0
- package/dist/targets/types.js +18 -0
- package/dist/targets/verified.js +35 -0
- package/dist/worker.js +113 -0
- package/docs/UPGRADING.md +1502 -0
- package/docs/pinned-codex.md +321 -0
- package/experiments/stage2-redteam/lib/oracles.mjs +214 -0
- package/experiments/stage2-redteam/lib/report.mjs +35 -0
- package/npm-shrinkwrap.json +1632 -0
- package/package.json +82 -4
- package/scripts/codex-qualify/codex-pin-store.mjs +353 -0
- package/scripts/codex-qualify/codex-qualifier-process.mjs +265 -0
- package/scripts/codex-qualify/codex-qualifier.example.json +5 -0
- package/scripts/codex-qualify/codex-qualifier.mjs +281 -0
- package/scripts/codex-qualify/codex-shipped-pin.mjs +158 -0
- package/scripts/codex-qualify/codex-stage2-pin.mjs +48 -0
- package/scripts/codex-qualify/codex-stage2.mjs +2381 -0
- package/scripts/codex-qualify/install-codex-qualifier.mjs +98 -0
- package/scripts/codex-qualify/main-module.mjs +14 -0
- package/scripts/codex-qualify/relay-codex-qualifier.plist +37 -0
- package/scripts/codex-qualify/scratch-env.mjs +31 -0
- package/scripts/codex-qualify/session.mjs +96 -0
- package/scripts/codex-qualify/stage2-escalation-cases.mjs +125 -0
- package/test/codex-permissions.test.ts +875 -0
- package/test/fixtures/boundary-probes.mjs +17 -0
- package/test/fixtures/denial-stream-host.mjs +7 -0
- package/test/fixtures/families.json +246 -0
- package/test/fixtures/install-snapshots/claude-desktop-foreign.txt +158 -0
- package/test/fixtures/install-snapshots/claude-desktop-fresh.txt +101 -0
- package/test/fixtures/install-snapshots/claude-desktop-installed.txt +161 -0
- package/test/fixtures/install-snapshots/claude-foreign.txt +133 -0
- package/test/fixtures/install-snapshots/claude-fresh.txt +77 -0
- package/test/fixtures/install-snapshots/claude-installed.txt +133 -0
- package/test/fixtures/install-snapshots/codex-foreign.txt +159 -0
- package/test/fixtures/install-snapshots/codex-fresh.txt +107 -0
- package/test/fixtures/install-snapshots/codex-installed.txt +161 -0
- package/test/fixtures/link-parent.mjs +6 -0
- package/test/fixtures/mediated-command.cjs +72 -0
- package/test/fixtures/native-skill-isolation.json +280 -0
- package/test/fixtures/pinned-codex-app-server.mjs +25 -0
- package/test/fixtures/qualified-ext-adapters.mjs +36 -0
- package/test/fixtures/refusals/README.md +52 -0
- package/test/fixtures/refusals/claude-source-result.json +7 -0
- package/test/fixtures/refusals/openai-app-capacity.json +24 -0
- package/test/fixtures/refusals/openai-app-cyberPolicy.json +24 -0
- package/test/fixtures/refusals/openai-gpt-6-astra-max.json +12 -0
- package/test/fixtures/refusals/openai-gpt-6.1-sol-xhigh.json +12 -0
- package/test/fixtures/refusals/openai-review-capacity.json +24 -0
- package/test/fixtures/relay-0.2.0.sql +57 -0
- package/test/fixtures/relay-0.9.1.gen.mjs +212 -0
- package/test/fixtures/relay-0.9.1.sql +340 -0
- package/test/fixtures/slow-boundary-probes.mjs +37 -0
- package/test/fixtures/stable-surfaces/config.json +1122 -0
- package/test/fixtures/stable-surfaces/escalation.json +128 -0
- package/test/fixtures/stable-surfaces/events.json +37 -0
- package/test/fixtures/stable-surfaces/gemini-native-resume.json +4 -0
- package/test/fixtures/stable-surfaces/inbox.jsonl +2 -0
- package/test/fixtures/stable-surfaces/notice.txt +1 -0
- package/test/fixtures/stable-surfaces/refusal-item.json +28 -0
- package/test/fixtures/stable-surfaces/refusal-review.json +23 -0
- package/test/fixtures/stable-surfaces/registry.json +49 -0
- package/test/fixtures/stable-surfaces/tools-desktop.json +575 -0
- package/test/fixtures/stable-surfaces/tools.json +716 -0
- package/test/fixtures/stable-surfaces/usage.txt +46 -0
- package/test/fixtures/stage2-acp-native.mjs +138 -0
- package/test/fixtures/stage2-app-server.mjs +23 -0
- package/test/fixtures/stage2-catalog.json +91 -0
- package/test/fixtures/stage2-hostile-web.mjs +35 -0
- package/test/fixtures/stage2-native-network.mjs +62 -0
- package/test/fixtures/stage2-worker.ts +87 -0
- package/test/fixtures/status-views/expected.json +7825 -0
- package/test/fixtures/status-views/registries.json +1 -0
- package/test/fixtures/steering.json +209 -0
- package/test/helpers.ts +740 -0
- package/test/host-env.ts +7 -0
- package/test/keychain-decoy.ts +197 -0
- package/test/live-scope.ts +44 -0
- package/test/mediated-network.test.ts +192 -0
- package/test/mediated-proxy.test.ts +264 -0
- package/test/native-temp-alias.ts +10 -0
- package/test/never-policy.test.ts +629 -0
- package/test/never-tools.test.ts +136 -0
- package/test/process-home.ts +18 -0
- package/test/proxy.test.ts +531 -0
- package/test/restart-overlay-live.test.ts +85 -0
- package/test/restart-overlay-profile.test.ts +66 -0
- package/test/restart-overlay.test.ts +416 -0
- package/test/stable-surfaces.test.ts +249 -0
- package/test/stage2-escalation-live.test.ts +544 -0
- package/test/stage2-escalation-qualification.test.ts +170 -0
- package/test/stage2-escalation.test.ts +747 -0
- package/test/stage2-executor.test.ts +849 -0
- package/test/stage2-grant.test.ts +603 -0
- package/test/stage2-native-live.test.ts +647 -0
- package/test/stage2-network-decisions.test.ts +70 -0
- package/test/stage2-probe.test.ts +845 -0
- package/test/stage2-standing-live.test.ts +203 -0
- package/test/stubs/broker-host.mjs +59 -0
- package/test/stubs/broker-peer.mjs +20 -0
- package/test/stubs/confined-harness.mjs +91 -0
- package/test/stubs/ext-broken-server.mjs +2 -0
- package/test/stubs/ext-odd-server.mjs +21 -0
- package/test/stubs/ext-server.mjs +31 -0
- package/test/stubs/fake-host-cli.mjs +218 -0
- package/test/stubs/procargs.mjs +30 -0
- package/test/stubs/stub-acp +4 -0
- package/test/stubs/stub-agent.mjs +322 -0
- package/test/stubs/stub-claude +4 -0
- package/test/stubs/stub-codex +4 -0
- package/test/stubs/targets/acp.mjs +307 -0
- package/test/stubs/targets/claude.mjs +149 -0
- package/test/stubs/targets/codex.mjs +479 -0
- package/test/stubs/targets/gemini.mjs +604 -0
- package/test/temp-root.ts +11 -0
- package/test/wp4-adapters.test.ts +353 -0
- 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
|
+
}
|