@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,209 @@
1
+ {
2
+ "null-allow-false": {
3
+ "instructions": "relay reaches coding agents of several families: claude (Anthropic), codex (OpenAI). It cannot tell which family of model this session runs, so it does not choose for you: name target in each call that starts something, picking a family other than your own model's unless the user asks otherwise. For agents of your own family, use your host's own subagents. Every result names both sides' families (families); from here the caller's is unknown. delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
4
+ "target": "Which agent to reach: claude (Anthropic), codex (OpenAI). Relay cannot tell your family, so name one whose family differs from your own model's, unless the user asks otherwise."
5
+ },
6
+ "null-allow-true": {
7
+ "instructions": "relay reaches coding agents of several families: claude (Anthropic), codex (OpenAI). It cannot tell which family of model this session runs, so it does not choose for you: name target in each call that starts something, picking a family other than your own model's unless the user asks otherwise. For agents of your own family, use your host's own subagents. Every result names both sides' families (families); from here the caller's is unknown. delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
8
+ "target": "Which agent to reach: claude (Anthropic), codex (OpenAI). Relay cannot tell your family, so name one whose family differs from your own model's, unless the user asks otherwise."
9
+ },
10
+ "null-refuse-false": {
11
+ "instructions": "relay cannot tell which family of agent this session is, and its config (same_family \"refuse\") starts only agents it can show are of another family, so it reaches no agent from here. Register relay for your actual host (`relay install <host>`) and start the session again. For a multi-model harness, the user can set same_family \"allow\"; then name target. Copying a single-family registration does not identify a multi-model session.",
12
+ "target": "Which agent to reach. Relay cannot tell your family, and its config (same_family \"refuse\") reaches no agent from such a session."
13
+ },
14
+ "null-refuse-true": {
15
+ "instructions": "relay cannot tell which family of agent this session is, and its config (same_family \"refuse\") starts only agents it can show are of another family, so it reaches no agent from here. Register relay for your actual host (`relay install <host>`) and start the session again. For a multi-model harness, the user can set same_family \"allow\"; then name target. Copying a single-family registration does not identify a multi-model session.",
16
+ "target": "Which agent to reach. Relay cannot tell your family, and its config (same_family \"refuse\") reaches no agent from such a session."
17
+ },
18
+ "claude-allow-false": {
19
+ "instructions": "relay reaches other families of coding agent: from this Claude session, Codex. It fills the gaps between families. For more Claude agents, use your own subagents: they are built for this host. Name claude through relay only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Every result names both sides' families (families). delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
20
+ "target": "Which agent to reach. Leave it out to reach Codex. claude is your own family: for Claude work use your own subagents, and name claude only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental)."
21
+ },
22
+ "claude-allow-true": {
23
+ "instructions": "relay reaches other families of coding agent: from this Claude session, Codex. It fills the gaps between families. For more Claude agents, use your own subagents, where this session has them: they are built for this host. Name claude through relay only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Every result names both sides' families (families). delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
24
+ "target": "Which agent to reach. Leave it out to reach Codex. claude is your own family: for Claude work use your own subagents, where this session has them, and name claude only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental)."
25
+ },
26
+ "claude-refuse-false": {
27
+ "instructions": "relay reaches other families of coding agent: from this Claude session, Codex. It fills the gaps between families. For more Claude agents, use your own subagents: relay's config (same_family \"refuse\") does not start your own family. Every result names both sides' families (families). delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
28
+ "target": "Which agent to reach. Leave it out to reach Codex. For your own family (claude) use your own subagents: relay's config (same_family \"refuse\") refuses it. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental)."
29
+ },
30
+ "claude-refuse-true": {
31
+ "instructions": "relay reaches other families of coding agent: from this Claude session, Codex. It fills the gaps between families. For more Claude agents, use your own subagents, where this session has them: relay's config (same_family \"refuse\") does not start your own family. Every result names both sides' families (families). delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
32
+ "target": "Which agent to reach. Leave it out to reach Codex. For your own family (claude) use your own subagents, where this session has them: relay's config (same_family \"refuse\") refuses it. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental)."
33
+ },
34
+ "codex-allow-false": {
35
+ "instructions": "relay reaches other families of coding agent: from this Codex session, Claude. It fills the gaps between families. For more Codex agents, use your own subagents (spawn_agent): they are built for this host. Name codex through relay only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Every result names both sides' families (families). delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
36
+ "target": "Which agent to reach. Leave it out to reach Claude. codex is your own family: for Codex work use your own subagents (spawn_agent), and name codex only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental)."
37
+ },
38
+ "codex-allow-true": {
39
+ "instructions": "relay reaches other families of coding agent: from this Codex session, Claude. It fills the gaps between families. For more Codex agents, use your own subagents, where this session has them: they are built for this host. Name codex through relay only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Every result names both sides' families (families). delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
40
+ "target": "Which agent to reach. Leave it out to reach Claude. codex is your own family: for Codex work use your own subagents, where this session has them, and name codex only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental)."
41
+ },
42
+ "codex-refuse-false": {
43
+ "instructions": "relay reaches other families of coding agent: from this Codex session, Claude. It fills the gaps between families. For more Codex agents, use your own subagents (spawn_agent): relay's config (same_family \"refuse\") does not start your own family. Every result names both sides' families (families). delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
44
+ "target": "Which agent to reach. Leave it out to reach Claude. For your own family (codex) use your own subagents (spawn_agent): relay's config (same_family \"refuse\") refuses it. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental)."
45
+ },
46
+ "codex-refuse-true": {
47
+ "instructions": "relay reaches other families of coding agent: from this Codex session, Claude. It fills the gaps between families. For more Codex agents, use your own subagents, where this session has them: relay's config (same_family \"refuse\") does not start your own family. Every result names both sides' families (families). delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
48
+ "target": "Which agent to reach. Leave it out to reach Claude. For your own family (codex) use your own subagents, where this session has them: relay's config (same_family \"refuse\") refuses it. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental)."
49
+ },
50
+ "model-allow-false": "The model to run; optional (the target's default otherwise).",
51
+ "preamble-allow-false-claude-false": "The relay tools reach other families of agent (for you, Codex) when you leave target out. You have no subagents of your own in this turn, so you may name your own family's target when the work needs another agent of your kind; relay labels that work same-family.",
52
+ "preamble-allow-false-claude-true": "The relay tools are for reaching other families of agent (for you, Codex), which they reach when you leave target out. For helpers of your own kind, use your own subagents; name your own family's target through relay only when your task asks for that, and relay then labels the work same-family.",
53
+ "preamble-allow-false-codex-false": "The relay tools reach other families of agent (for you, Claude) when you leave target out. You have no subagents of your own in this turn, so you may name your own family's target when the work needs another agent of your kind; relay labels that work same-family.",
54
+ "preamble-allow-false-codex-true": "The relay tools are for reaching other families of agent (for you, Claude), which they reach when you leave target out. For helpers of your own kind, use your own subagents; name your own family's target through relay only when your task asks for that, and relay then labels the work same-family.",
55
+ "preamble-allow-false-copilot-false": "Relay cannot tell your own model's family, so name target in each relay call that starts something, picking a family other than your own model's unless your task says otherwise. Results are labelled family unknown.",
56
+ "preamble-allow-false-copilot-true": "Relay cannot tell your own model's family, so name target in each relay call that starts something, picking a family other than your own model's unless your task says otherwise. Results are labelled family unknown.",
57
+ "model-allow-true": "The model to run. Optional for claude and codex (their default otherwise). For copilot the model decides the family: name one (for example gpt-6.1-sol, gemini-3.8-flash, claude-sonnet-5.5) and relay labels the work by its family; \"auto\", or no model, lets Copilot choose, and relay then labels the family unknown.",
58
+ "preamble-allow-true-claude-false": "The relay tools reach other families of agent (for you, Codex or Copilot (experimental); name one as target unless relay's config sets your default) when you leave target out. You have no subagents of your own in this turn, so you may name your own family's target when the work needs another agent of your kind; relay labels that work same-family.",
59
+ "preamble-allow-true-claude-true": "The relay tools are for reaching other families of agent (for you, Codex or Copilot (experimental); name one as target unless relay's config sets your default), which they reach when you leave target out. For helpers of your own kind, use your own subagents; name your own family's target through relay only when your task asks for that, and relay then labels the work same-family.",
60
+ "preamble-allow-true-codex-false": "The relay tools reach other families of agent (for you, Claude or Copilot (experimental); name one as target unless relay's config sets your default) when you leave target out. You have no subagents of your own in this turn, so you may name your own family's target when the work needs another agent of your kind; relay labels that work same-family.",
61
+ "preamble-allow-true-codex-true": "The relay tools are for reaching other families of agent (for you, Claude or Copilot (experimental); name one as target unless relay's config sets your default), which they reach when you leave target out. For helpers of your own kind, use your own subagents; name your own family's target through relay only when your task asks for that, and relay then labels the work same-family.",
62
+ "preamble-allow-true-copilot-false": "Relay cannot tell your own model's family, so name target in each relay call that starts something, picking a family other than your own model's unless your task says otherwise. Results are labelled family unknown.",
63
+ "preamble-allow-true-copilot-true": "Relay cannot tell your own model's family, so name target in each relay call that starts something, picking a family other than your own model's unless your task says otherwise. Results are labelled family unknown.",
64
+ "model-refuse-false": "The model to run; optional (the target's default otherwise).",
65
+ "preamble-refuse-false-claude-false": "The relay tools reach another family of agent only (for you, Codex). You have no subagents of your own in this turn, so do the work of a helper of your own kind yourself.",
66
+ "preamble-refuse-false-claude-true": "The relay tools reach another family of agent only (for you, Codex). For helpers of your own kind, use your own subagents.",
67
+ "preamble-refuse-false-codex-false": "The relay tools reach another family of agent only (for you, Claude). You have no subagents of your own in this turn, so do the work of a helper of your own kind yourself.",
68
+ "preamble-refuse-false-codex-true": "The relay tools reach another family of agent only (for you, Claude). For helpers of your own kind, use your own subagents.",
69
+ "preamble-refuse-false-copilot-false": "The relay tools reach another family of agent only (for you, Claude or Codex; name one as target unless relay's config sets your default). You have no subagents of your own in this turn, so do the work of a helper of your own kind yourself.",
70
+ "preamble-refuse-false-copilot-true": "The relay tools reach another family of agent only (for you, Claude or Codex; name one as target unless relay's config sets your default). For helpers of your own kind, use your own subagents.",
71
+ "model-refuse-true": "The model to run. Optional for claude and codex (their default otherwise). For copilot the model decides the family, so name one relay's list knows (for example gpt-6.1-sol, gemini-3.8-flash, claude-sonnet-5.5): relay's config (same_family \"refuse\") refuses \"auto\", no model and ids its list does not name.",
72
+ "preamble-refuse-true-claude-false": "The relay tools reach another family of agent only (for you, Codex or Copilot (experimental); name one as target unless relay's config sets your default). You have no subagents of your own in this turn, so do the work of a helper of your own kind yourself.",
73
+ "preamble-refuse-true-claude-true": "The relay tools reach another family of agent only (for you, Codex or Copilot (experimental); name one as target unless relay's config sets your default). For helpers of your own kind, use your own subagents.",
74
+ "preamble-refuse-true-codex-false": "The relay tools reach another family of agent only (for you, Claude or Copilot (experimental); name one as target unless relay's config sets your default). You have no subagents of your own in this turn, so do the work of a helper of your own kind yourself.",
75
+ "preamble-refuse-true-codex-true": "The relay tools reach another family of agent only (for you, Claude or Copilot (experimental); name one as target unless relay's config sets your default). For helpers of your own kind, use your own subagents.",
76
+ "preamble-refuse-true-copilot-false": "The relay tools reach another family of agent only (for you, Claude or Codex; name one as target unless relay's config sets your default). You have no subagents of your own in this turn, so do the work of a helper of your own kind yourself.",
77
+ "preamble-refuse-true-copilot-true": "The relay tools reach another family of agent only (for you, Claude or Codex; name one as target unless relay's config sets your default). For helpers of your own kind, use your own subagents.",
78
+ "side-anthropic-anthropic": "another Claude agent, of your own family (Anthropic)",
79
+ "review-anthropic-anthropic": " This is a same-family review: both reviewers run Anthropic's models. Say so when you report it.",
80
+ "summary-job-anthropic-anthropic": "Same-family: caller working with launched. Both run Anthropic's models; this is not a cross-family job.",
81
+ "summary-consult-anthropic-anthropic": "Same-family: caller working with launched. Both run Anthropic's models; this is not a cross-family consult.",
82
+ "summary-discussion-anthropic-anthropic": "Same-family: caller working with launched. Both run Anthropic's models; this is not a cross-family discussion.",
83
+ "summary-review-anthropic-anthropic": "Same-family: caller working with launched. Both run Anthropic's models; this is not a cross-family review.",
84
+ "side-anthropic-openai": "a Claude agent (Anthropic)",
85
+ "review-anthropic-openai": "",
86
+ "summary-job-anthropic-openai": "Cross-family: caller working with launched.",
87
+ "summary-consult-anthropic-openai": "Cross-family: caller working with launched.",
88
+ "summary-discussion-anthropic-openai": "Cross-family: caller working with launched.",
89
+ "summary-review-anthropic-openai": "Cross-family: caller working with launched.",
90
+ "side-anthropic-unknown": "a Claude agent (Anthropic)",
91
+ "review-anthropic-unknown": " Relay cannot show the two reviewers are of different families. Report it as family unknown.",
92
+ "summary-job-anthropic-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this job is not known to be cross-family.",
93
+ "summary-consult-anthropic-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this consult is not known to be cross-family.",
94
+ "summary-discussion-anthropic-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this discussion is not known to be cross-family.",
95
+ "summary-review-anthropic-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this review is not known to be cross-family.",
96
+ "side-openai-anthropic": "a Codex agent (OpenAI)",
97
+ "review-openai-anthropic": "",
98
+ "summary-job-openai-anthropic": "Cross-family: caller working with launched.",
99
+ "summary-consult-openai-anthropic": "Cross-family: caller working with launched.",
100
+ "summary-discussion-openai-anthropic": "Cross-family: caller working with launched.",
101
+ "summary-review-openai-anthropic": "Cross-family: caller working with launched.",
102
+ "side-openai-openai": "another Codex agent, of your own family (OpenAI)",
103
+ "review-openai-openai": " This is a same-family review: both reviewers run OpenAI's models. Say so when you report it.",
104
+ "summary-job-openai-openai": "Same-family: caller working with launched. Both run OpenAI's models; this is not a cross-family job.",
105
+ "summary-consult-openai-openai": "Same-family: caller working with launched. Both run OpenAI's models; this is not a cross-family consult.",
106
+ "summary-discussion-openai-openai": "Same-family: caller working with launched. Both run OpenAI's models; this is not a cross-family discussion.",
107
+ "summary-review-openai-openai": "Same-family: caller working with launched. Both run OpenAI's models; this is not a cross-family review.",
108
+ "side-openai-unknown": "a Codex agent (OpenAI)",
109
+ "review-openai-unknown": " Relay cannot show the two reviewers are of different families. Report it as family unknown.",
110
+ "summary-job-openai-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this job is not known to be cross-family.",
111
+ "summary-consult-openai-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this consult is not known to be cross-family.",
112
+ "summary-discussion-openai-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this discussion is not known to be cross-family.",
113
+ "summary-review-openai-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this review is not known to be cross-family.",
114
+ "side-unknown-anthropic": "an agent whose family relay cannot tell",
115
+ "review-unknown-anthropic": " Relay cannot show the two reviewers are of different families. Report it as family unknown.",
116
+ "summary-job-unknown-anthropic": "Family unknown: relay cannot show that caller and launched are of different families, so this job is not known to be cross-family.",
117
+ "summary-consult-unknown-anthropic": "Family unknown: relay cannot show that caller and launched are of different families, so this consult is not known to be cross-family.",
118
+ "summary-discussion-unknown-anthropic": "Family unknown: relay cannot show that caller and launched are of different families, so this discussion is not known to be cross-family.",
119
+ "summary-review-unknown-anthropic": "Family unknown: relay cannot show that caller and launched are of different families, so this review is not known to be cross-family.",
120
+ "side-unknown-openai": "an agent whose family relay cannot tell",
121
+ "review-unknown-openai": " Relay cannot show the two reviewers are of different families. Report it as family unknown.",
122
+ "summary-job-unknown-openai": "Family unknown: relay cannot show that caller and launched are of different families, so this job is not known to be cross-family.",
123
+ "summary-consult-unknown-openai": "Family unknown: relay cannot show that caller and launched are of different families, so this consult is not known to be cross-family.",
124
+ "summary-discussion-unknown-openai": "Family unknown: relay cannot show that caller and launched are of different families, so this discussion is not known to be cross-family.",
125
+ "summary-review-unknown-openai": "Family unknown: relay cannot show that caller and launched are of different families, so this review is not known to be cross-family.",
126
+ "side-unknown-unknown": "an agent whose family relay cannot tell",
127
+ "review-unknown-unknown": " Relay cannot show the two reviewers are of different families. Report it as family unknown.",
128
+ "summary-job-unknown-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this job is not known to be cross-family.",
129
+ "summary-consult-unknown-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this consult is not known to be cross-family.",
130
+ "summary-discussion-unknown-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this discussion is not known to be cross-family.",
131
+ "summary-review-unknown-unknown": "Family unknown: relay cannot show that caller and launched are of different families, so this review is not known to be cross-family.",
132
+ "resolution-allow-null-undefined": {
133
+ "reason": "relay cannot tell which family of model this session runs, so it does not choose an agent for you. Call again with target (claude (Anthropic), codex (OpenAI)), picking a family other than your own model's unless the user asked otherwise; or the user can set default_target.unknown in relay's config."
134
+ },
135
+ "resolution-allow-null-claude": {
136
+ "target": "claude"
137
+ },
138
+ "resolution-allow-null-codex": {
139
+ "target": "codex"
140
+ },
141
+ "resolution-allow-null-copilot": {
142
+ "reason": "Copilot (experimental) is switched off in relay's config (targets.copilot.enabled). Do this part yourself."
143
+ },
144
+ "resolution-allow-claude-undefined": {
145
+ "target": "codex"
146
+ },
147
+ "resolution-allow-claude-claude": {
148
+ "target": "claude"
149
+ },
150
+ "resolution-allow-claude-codex": {
151
+ "target": "codex"
152
+ },
153
+ "resolution-allow-claude-copilot": {
154
+ "reason": "Copilot (experimental) is switched off in relay's config (targets.copilot.enabled). Use Codex instead, or do this part yourself."
155
+ },
156
+ "resolution-allow-codex-undefined": {
157
+ "target": "claude"
158
+ },
159
+ "resolution-allow-codex-claude": {
160
+ "target": "claude"
161
+ },
162
+ "resolution-allow-codex-codex": {
163
+ "target": "codex"
164
+ },
165
+ "resolution-allow-codex-copilot": {
166
+ "reason": "Copilot (experimental) is switched off in relay's config (targets.copilot.enabled). Use Claude instead, or do this part yourself."
167
+ },
168
+ "resolution-refuse-null-undefined": {
169
+ "reason": "relay cannot tell which agent it is running inside, and its config (same_family \"refuse\") connects different families of agent only, which it cannot check for a caller it does not know, so it reaches no agent from here. Register relay for your actual host (`relay install <host>`) and start the session again. For a multi-model harness, the user can set same_family \"allow\"; then name target. Copying a single-family registration does not identify a multi-model session."
170
+ },
171
+ "resolution-refuse-null-claude": {
172
+ "reason": "relay cannot tell which agent it is running inside, and its config (same_family \"refuse\") connects different families of agent only, which it cannot check for a caller it does not know, so it reaches no agent from here. Register relay for your actual host (`relay install <host>`) and start the session again. For a multi-model harness, the user can set same_family \"allow\"; then name target. Copying a single-family registration does not identify a multi-model session."
173
+ },
174
+ "resolution-refuse-null-codex": {
175
+ "reason": "relay cannot tell which agent it is running inside, and its config (same_family \"refuse\") connects different families of agent only, which it cannot check for a caller it does not know, so it reaches no agent from here. Register relay for your actual host (`relay install <host>`) and start the session again. For a multi-model harness, the user can set same_family \"allow\"; then name target. Copying a single-family registration does not identify a multi-model session."
176
+ },
177
+ "resolution-refuse-null-copilot": {
178
+ "reason": "relay cannot tell which agent it is running inside, and its config (same_family \"refuse\") connects different families of agent only, which it cannot check for a caller it does not know, so it reaches no agent from here. Register relay for your actual host (`relay install <host>`) and start the session again. For a multi-model harness, the user can set same_family \"allow\"; then name target. Copying a single-family registration does not identify a multi-model session."
179
+ },
180
+ "resolution-refuse-claude-undefined": {
181
+ "target": "codex"
182
+ },
183
+ "resolution-refuse-claude-claude": {
184
+ "reason": "relay's config (same_family \"refuse\") reaches only the other family of agent. You are a Claude agent: for another Claude agent use your own subagents, and use relay for Codex. If the user wants such calls through relay anyway, they can set \"same_family\": \"allow\" in relay's config."
185
+ },
186
+ "resolution-refuse-claude-codex": {
187
+ "target": "codex"
188
+ },
189
+ "resolution-refuse-claude-copilot": {
190
+ "reason": "Copilot (experimental) runs models of several families, so relay must know which one would answer: name it with model (for example gpt-6.1-sol, gpt-6-astra, gpt-6-luna, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex), or set targets.copilot.default_model in relay's config."
191
+ },
192
+ "resolution-refuse-codex-undefined": {
193
+ "target": "claude"
194
+ },
195
+ "resolution-refuse-codex-claude": {
196
+ "target": "claude"
197
+ },
198
+ "resolution-refuse-codex-codex": {
199
+ "reason": "relay's config (same_family \"refuse\") reaches only the other family of agent. You are a Codex agent: for another Codex agent use your own subagents, and use relay for Claude. If the user wants such calls through relay anyway, they can set \"same_family\": \"allow\" in relay's config."
200
+ },
201
+ "resolution-refuse-codex-copilot": {
202
+ "reason": "Copilot (experimental) runs models of several families, so relay must know which one would answer: name it with model (for example claude-sonnet-5.5, claude-opus-5.5, claude-haiku-5.5, claude-haiku-4.5, gemini-3.8-flash, gemini-3.7-flash), or set targets.copilot.default_model in relay's config."
203
+ },
204
+ "unknownDefault": "relay reaches coding agents of several families: claude (Anthropic), codex (OpenAI). It cannot tell which family of model this session runs, so it does not choose for you: name target in each call that starts something, or leave it out to reach codex (default_target.unknown in relay's config), picking a family other than your own model's unless the user asks otherwise. For agents of your own family, use your host's own subagents. Every result names both sides' families (families); from here the caller's is unknown. delegate hands off work, ask puts a question, discuss holds a turn-by-turn discussion with you as one side, review gets an independent review to set against your own.",
205
+ "leaveOutNone": "Which agent to reach. Name one of the agents of another family (none is switched on); relay cannot choose for you. claude is your own family: for Claude work use your own subagents, and name claude only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental).",
206
+ "leaveOutSeveral": "Which agent to reach. Name one of the agents of another family (codex (OpenAI), copilot (experimental; the family of the model you give)); relay cannot choose for you. claude is your own family: for Claude work use your own subagents, and name claude only when the user asks for that, or when this session has no subagents of its own; relay then labels the work same-family. Registered targets: claude, codex, copilot (experimental), gemini, grok (experimental).",
207
+ "unknownOff": "default_target.unknown in relay's config names copilot, which is switched off. Name a target, or fix the config.",
208
+ "none": "no agent of another family is switched on in relay's config, so a call that names no target reaches nothing. Do this part yourself or with your own subagents."
209
+ }