@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.
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 +386 -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 +1525 -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 +320 -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 +637 -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 +329 -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 +629 -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 +1502 -0
  186. package/docs/pinned-codex.md +321 -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,253 @@
1
+ // What relay can tell about the program a root session's server runs in, from the server's own
2
+ // environment and the client's initialize request, and what that allows. Every answer here comes
3
+ // from host experiments (experiments/answers.md); a host relay has not positively identified gets
4
+ // the cautious answer.
5
+ import { hostSession } from "../backends/env.js";
6
+ import { ancestorCommandLinesLater } from "../core/procs.js";
7
+ import { TARGETS, targetDef } from "../targets/index.js";
8
+ /**
9
+ * Starts reading the StartEvidence of a `relay mcp` with these arguments. Null for a launched
10
+ * agent's server (--context, or relay's variables in its environment), which builds no host profile.
11
+ */
12
+ export function startEvidence(argv, env) {
13
+ if (argv.includes("--context") || ["RELAY_RUN_ID", "RELAY_NODE_ID", "RELAY_DEPTH", "RELAY_INJECTED"].some((k) => env[k] !== undefined))
14
+ return null;
15
+ // A reading that fails is one that could not be made, as ancestorCommandLines throwing is to the profile.
16
+ return ancestorCommandLinesLater(3).then((started) => ({ started }), () => ({ started: null }));
17
+ }
18
+ const multiModelClient = /^(opencode|cli|t3[- ]?code)$/i;
19
+ // Positive evidence only: the desktop chat's client name has not been observed.
20
+ // VS Code sends productService.nameLong (branded Visual Studio Code / - Insiders; OSS: Code - OSS):
21
+ // https://github.com/microsoft/vscode/blob/278880aeb30de8d2b16d0d1ee65e5f82a3d869fe/src/vs/workbench/contrib/mcp/common/mcpServerRequestHandler.ts#L135-L138
22
+ // https://github.com/microsoft/vscode/blob/9ab103a9f4bf101d1115f17f79119e763c8c6f07/product.json#L2-L3
23
+ // Branded wire logs: https://github.com/microsoft/vscode/issues/306918 (stable), /issues/311305 (Insiders).
24
+ // It imports desktop registrations: https://code.visualstudio.com/docs/agents/reference/mcp-configuration#automatic-discovery
25
+ // Continue's Client name is continue-client:
26
+ // https://github.com/continuedev/continue/blob/5ddd0d37a1c755c5cd8cd77fd18dc15dd520c81a/core/context/mcp/MCPConnection.ts#L88-L92
27
+ const multiModelRegistration = /^(opencode(?:[ -].*)?|grok(?:[ -].*)?|cursor(?:[ -].*)?|cline|roo[- ]?code|kilo[- ]?code|continue(?:-client)?|visual studio code(?: - insiders)?|code - oss|cli|t3[- ]?code)$/i;
28
+ /** True when version a.b.c is at least min. Anything unparsable is not. */
29
+ export function atLeast(version, min) {
30
+ const m = /(\d+)\.(\d+)\.(\d+)/.exec(version ?? "");
31
+ if (!m)
32
+ return false;
33
+ const have = m.slice(1, 4).map(Number);
34
+ for (let i = 0; i < 3; i++)
35
+ if (have[i] !== min[i])
36
+ return have[i] > min[i];
37
+ return true;
38
+ }
39
+ /** The Claude Code version the host experiments ran: elicitation, idle and busy, shown as a dialog. */
40
+ const CLAUDE_DIALOG = [2, 1, 286];
41
+ /** From this version a main-conversation MCP call is moved to the background after two minutes. */
42
+ const CLAUDE_BACKGROUND = [2, 1, 212];
43
+ /**
44
+ * Unsolicited dialogs, by detectable surface, not just vendor. Floors retain the existing policy
45
+ * of qualifying later versions of the same surface. A relay call being in flight says nothing
46
+ * about whether the host's turn is busy (it may be in a shell call), so relay cannot select an
47
+ * idle-only path: both columns must qualify. ask_user cannot override this table.
48
+ */
49
+ export const DIALOG_QUALIFICATIONS = {
50
+ // experiments/answers.md C-a, C-g (busy), C-k (idle), rerun at 2.1.302.
51
+ claudeCli: { label: "interactive Claude Code", idleSince: CLAUDE_DIALOG, busySince: CLAUDE_DIALOG, withheld: "interactive Claude Code version is below the idle and busy dialog qualification floor (2.1.286)" },
52
+ // experiments/answers.md X-b (client), X-e (idle, 0.162.1), X-j (busy, 0.163.0).
53
+ codexCli: { label: "Codex CLI", idleSince: [0, 162, 1], busySince: [0, 163, 0], withheld: "Codex CLI busy dialogs are not qualified before 0.163.0; relay cannot distinguish idle from busy" },
54
+ // experiments/answers.md XA-a (0.162.0-alpha, MCP UI capability/client_type), XA-d
55
+ // (idle), XA-f (busy UNRUN); docs/plan-1.0.md Outstanding table. Desktop originators
56
+ // can only withhold: a custom originator is never evidence of the qualified CLI.
57
+ codexApp: { label: "Codex app / desktop", idleSince: [0, 162, 0], busySince: null, withheld: "Codex app busy dialogs are not qualified (answers.md XA-f); relay cannot distinguish idle from busy" },
58
+ // experiments/answers.md D-a, D-c, D-d: SDK/Code-tab dialogs decline automatically.
59
+ claudeSdk: { label: "Claude Code SDK / desktop Code tab", idleSince: null, busySince: null, withheld: "Claude Code under the Agent SDK or the desktop app declines elicitations on its own" },
60
+ // experiments/answers.md C-a and P-c: sdk-cli / -p cancels without showing a person.
61
+ claudeUnattended: { label: "Claude Code unattended (-p)", idleSince: null, busySince: null, withheld: "Claude Code running unattended (-p)" },
62
+ // experiments/answers.md D-a to D-d do not qualify the shared desktop bridge; the
63
+ // plan's D C19 requires a conversation-bound, idle-and-busy path. None was observed.
64
+ sharedDesktop: { label: "shared Claude desktop connection", idleSince: null, busySince: null, withheld: "shared desktop connection: dialogs and notices cannot be bound to a conversation" },
65
+ // No idle/busy observations in experiments/answers.md for other clients or wrappers.
66
+ unknown: { label: "unknown hosts / custom Codex originators", idleSince: null, busySince: null, withheld: "unrecognised host surface: idle and busy dialogs are not qualified" },
67
+ };
68
+ function dialogQualification(surface, version) {
69
+ const q = DIALOG_QUALIFICATIONS[surface];
70
+ const qualified = q.idleSince !== null && q.busySince !== null && atLeast(version, q.idleSince) && atLeast(version, q.busySince);
71
+ return { qualified, why: qualified ? `${q.label}: approval dialogs qualified idle and busy` : q.withheld };
72
+ }
73
+ /**
74
+ * The longest a call waits under the Claude desktop app's own entry (relay-desktop). The app ends a
75
+ * tool call after 60 s (its MCP SDK's default; progress notifications do not reset it), then takes
76
+ * the connection for dead and restarts relay for every session that shares it (Claude.app
77
+ * 2.42304.0, 2026-10-16). Below that, so that a wait ends on relay's side first.
78
+ */
79
+ export const DESKTOP_WAIT_S = 50;
80
+ /** Leave time to build and write the reply; scale the margin for short host timeouts. */
81
+ export const hostWaitCapS = (timeoutS) => timeoutS - Math.min(10, timeoutS / 6);
82
+ const enabled = (value) => /^(1|true|yes|on)$/i.test(value ?? "");
83
+ /**
84
+ * In -p, backgrounded calls can die with the turn. Use the environment visible to this server.
85
+ * https://code.claude.com/docs/en/env-vars (CLAUDE_AUTO_BACKGROUND_TASKS)
86
+ * https://code.claude.com/docs/en/mcp#automatic-backgrounding-of-long-tool-calls
87
+ * CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS defaults to 120000; 0 or
88
+ * CLAUDE_CODE_DISABLE_BACKGROUND_TASKS disables backgrounding altogether.
89
+ */
90
+ function unattendedWaitCapS(env) {
91
+ if (!unattendedClaude(env) || !enabled(env.CLAUDE_AUTO_BACKGROUND_TASKS) || enabled(env.CLAUDE_CODE_DISABLE_BACKGROUND_TASKS))
92
+ return null;
93
+ const raw = env.CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS?.replaceAll("_", "");
94
+ const ms = raw?.trim() ? Number(raw) : 120000;
95
+ if (ms === 0)
96
+ return null;
97
+ return hostWaitCapS((Number.isFinite(ms) && ms > 0 ? ms : 120000) / 1000);
98
+ }
99
+ /**
100
+ * The client name the desktop app's connection for Cowork and the Code tab gives:
101
+ * local-agent-mode-<entry name>. The connection for its chats was not seen.
102
+ */
103
+ const DESKTOP_CLIENT = /^local-agent-mode-/i;
104
+ /**
105
+ * Interactive Claude Code in a terminal: entry point "cli", no SDK or desktop markers, and not
106
+ * running unattended (an interactive session leaves CLAUDE_CODE_SESSION_ATTENDED unset).
107
+ */
108
+ export const interactiveClaudeCli = (env) => env.CLAUDE_CODE_ENTRYPOINT === "cli" && env.CLAUDE_CODE_SESSION_ATTENDED === undefined && !hostSession(env);
109
+ /**
110
+ * Claude Code under `claude -p`: entry point "sdk-cli", or CLAUDE_CODE_SESSION_ATTENDED=0. Claude
111
+ * Code 2.1.302 sets the first and leaves the variable unset, and cancels every elicitation within
112
+ * milliseconds with nothing shown (experiments/answers.md C-a and P-c, 2026-10-17).
113
+ */
114
+ const unattendedClaude = (env) => env.CLAUDE_CODE_ENTRYPOINT === "sdk-cli" || env.CLAUDE_CODE_SESSION_ATTENDED === "0";
115
+ /** Claude Code in the Claude desktop app (its Code tab). */
116
+ const desktopApp = (env) => Boolean(env.CLAUDE_CODE_DESKTOP_APP_VERSION);
117
+ /**
118
+ * Whether one of these command lines starts Claude Code so that it can skip its permission
119
+ * prompts: in bypassPermissions mode, or able to switch to it during the session. Relay's
120
+ * questions were never seen answered by a person in that mode, so nothing there is read as one.
121
+ */
122
+ export const canBypassPrompts = (commandLines) => commandLines.some((line) => /(^|\s)--(allow-)?dangerously-skip-permissions(=\S*)?(\s|$)/.test(line) || /(^|\s)--permission-mode(=|\s+)bypassPermissions(\s|$)/.test(line));
123
+ /**
124
+ * What relay can tell about the host. `hostCommandLines` are the command lines of the processes
125
+ * that started this server (its parent first), read only for the flags in canBypassPrompts; null
126
+ * where relay could not inspect them, which for Claude Code withholds the dialog and confirm.
127
+ * `settings` says why Claude Code's settings may answer for the person, for the dialog and for
128
+ * confirm separately (src/core/claude-settings.ts): a bypassPermissions default mode stands in the
129
+ * way of both; Elicitation hooks that match relay, of the dialog; PreToolUse or PermissionRequest
130
+ * hooks that match relay's confirm tool, of confirm. A string stands in the way of both.
131
+ * `desktopEntry` says the server was started from the Claude desktop app's own entry (--desktop);
132
+ * there, and for a client named as the app's connection, waits end after DESKTOP_WAIT_S.
133
+ */
134
+ export function hostProfile(env, client, canElicit, hostCommandLines = [], settings = null, opts = {}) {
135
+ const raw = profileOf(env, client, canElicit, hostCommandLines, settings, opts.codexDesktop);
136
+ // Profiles decide their own default; an explicit marker can qualify or disable inbox delivery
137
+ // for a particular deployment (including an SDK host) without copying another host's profile.
138
+ const inbox = opts.inbox ?? (env.RELAY_HOST_INBOX === "off" ? false : env.RELAY_HOST_INBOX === "on" ? true : raw.inbox);
139
+ const p = { ...raw, inbox };
140
+ const detectedT3 = /^codex-mcp-client$/i.test(client?.name ?? "") && /t3[- ]?code/i.test(env.CODEX_INTERNAL_ORIGINATOR_OVERRIDE ?? "");
141
+ const attributed = detectedT3 ? { ...p, inbox: opts.inbox ?? (env.RELAY_HOST_INBOX === "on"), elicit: "no", why: "T3 Code: elicitation answers cannot be attributed to a person" } : p;
142
+ if (!opts.desktopEntry && !DESKTOP_CLIENT.test(client?.name ?? ""))
143
+ return attributed;
144
+ return { ...attributed, confirm: false, inbox: false, elicit: "no", why: DIALOG_QUALIFICATIONS.sharedDesktop.withheld, waitCapS: DESKTOP_WAIT_S, longWaits: false, waits: attributed.waits === "background" ? "plain" : attributed.waits };
145
+ }
146
+ function profileOf(env, client, canElicit, hostCommandLines, settings, codexDesktop = false) {
147
+ const name = client?.name ?? "";
148
+ const base = { recognised: false, elicit: "no", declineIsDenial: false, longWaits: false, confirm: false, formNote: true, withdraws: true, safeFirst: true, inbox: false, waits: "plain", waitCapS: null };
149
+ // These frontends allow automation or attached clients to answer; even always cannot
150
+ // attribute their answers to a person. T3 detection stays in the host profile.
151
+ if (multiModelClient.test(name)) {
152
+ return { ...base, why: `${name || "T3 Code"}: elicitation answers cannot be attributed to a person` };
153
+ }
154
+ if (/^claude-code$/i.test(name)) {
155
+ const flag = hostCommandLines === null ? "relay could not inspect how Claude Code was started (ps), so it cannot tell whether it can skip permission prompts"
156
+ : canBypassPrompts(hostCommandLines) ? "Claude Code started so that it can skip permission prompts (bypassPermissions)" : null;
157
+ const consent = typeof settings === "string" ? { dialog: settings, confirm: settings } : settings;
158
+ const noDialog = flag ?? consent?.dialog ?? null;
159
+ const noConfirm = flag ?? consent?.confirm ?? null;
160
+ const cli = interactiveClaudeCli(env);
161
+ const qualified = atLeast(client?.version, CLAUDE_DIALOG);
162
+ const longWaits = cli && atLeast(client?.version, CLAUDE_BACKGROUND);
163
+ // Seen prompting for a marked tool: interactive Claude Code 2.1.286, and the desktop app 2.1.299.
164
+ // Where the mode or a hook could let confirm through without the person, it is not offered.
165
+ const offered = qualified && (cli || desktopApp(env));
166
+ // Notices on its inbox socket were seen taken from 2.1.286 on (2.1.286, 2.1.299 in the desktop
167
+ // app, 2.1.302); before that, events come with the next result. The socket is documented from
168
+ // 2.1.224 (code.claude.com/docs/en/cross-session-messaging), but relay posts only where seen.
169
+ const claude = {
170
+ ...base, recognised: true, safeFirst: false, inbox: qualified && (env.CLAUDE_CODE_ENTRYPOINT === "claude-desktop" || desktopApp(env) || !hostSession(env)), longWaits, waits: longWaits ? "background" : "plain", confirm: offered && !noConfirm,
171
+ waitCapS: unattendedWaitCapS(env),
172
+ ...(offered && noConfirm ? { confirmWithheld: noConfirm } : {}),
173
+ };
174
+ // Its question dialog can be answered by the mode or by a hook, not by a person: an answer
175
+ // there, accept or decline, would decide nothing that is the person's. So no question is put
176
+ // to the user, whatever ask_user says; requests go to the root agent and the terminal.
177
+ if (noDialog)
178
+ return { ...claude, why: noDialog };
179
+ // Claude Code under the Agent SDK (the Claude desktop app's Code tab among them) advertises
180
+ // elicitation but declines every request on its own within milliseconds, with nothing shown, and
181
+ // does not move long calls to the background.
182
+ if (hostSession(env))
183
+ return { ...claude, why: DIALOG_QUALIFICATIONS.claudeSdk.withheld };
184
+ if (unattendedClaude(env))
185
+ return { ...claude, why: DIALOG_QUALIFICATIONS.claudeUnattended.withheld };
186
+ if (!canElicit)
187
+ return { ...claude, why: "host lacks elicitation" };
188
+ // Its dialog has Accept and Decline buttons, and nothing declines on the user's behalf.
189
+ const dialogs = dialogQualification("claudeCli", client?.version);
190
+ if (cli && dialogs.qualified)
191
+ return { ...claude, elicit: "dialog", declineIsDenial: true, why: dialogs.why };
192
+ return { ...claude, why: cli ? dialogs.why : "Claude Code, not positively identified as interactive; idle and busy dialogs are not qualified" };
193
+ }
194
+ if (/^codex-mcp-client$/i.test(name)) {
195
+ // Its form: no note field, and a withdrawn form stays on screen (see HostProfile).
196
+ const codex = { ...base, recognised: true, waits: "parallel", formNote: false, withdraws: false };
197
+ if (!canElicit)
198
+ return { ...codex, why: "host lacks elicitation" };
199
+ const originator = env.CODEX_INTERNAL_ORIGINATOR_OVERRIDE;
200
+ // XA-a's bundled version is distinct from X-b's CLI. Also recognise desktop evidence
201
+ // at newer versions: MCP UI capability, call metadata, or a forwarded desktop originator.
202
+ const app = codexDesktop || /^0\.162\.0(?:-|$)/.test(client?.version ?? "") || /desktop|chatgpt|codex[ _-]?app/i.test(originator ?? "");
203
+ const surface = app ? "codexApp" : originator && originator !== "codex_cli_rs" ? "unknown" : "codexCli";
204
+ const dialogs = dialogQualification(surface, client?.version);
205
+ // The CLI's decline can be automatic under approval policy never, so it stays unattributed.
206
+ return { ...codex, elicit: dialogs.qualified ? "dialog" : "no", why: dialogs.why };
207
+ }
208
+ if (!canElicit)
209
+ return { ...base, why: "host lacks elicitation" };
210
+ return { ...base, why: `an unrecognised host (${name || "no client name"}); idle and busy dialogs are not qualified` };
211
+ }
212
+ /** A copied single-family registration is not evidence about a different harness. */
213
+ export function registrationAgrees(host, clientName, desktop = false) {
214
+ if (multiModelClient.test(clientName))
215
+ return false;
216
+ if (desktop) {
217
+ const mine = targetDef(host).vendor;
218
+ // Keep unknown desktop names compatible, but never let a copied entry overrule a client
219
+ // relay already attributes to another family. Use every registered single-family matcher.
220
+ const other = TARGETS.some((t) => t.vendor && t.vendor !== mine && t.clientNames.test(clientName));
221
+ return !other && !/^gemini-cli-mcp-client$/i.test(clientName) && !multiModelRegistration.test(clientName);
222
+ }
223
+ if (!clientName)
224
+ return true;
225
+ return host === "claude" ? /^(claude-code|local-agent-mode-.*)$/i.test(clientName)
226
+ : host === "codex" ? /^codex-mcp-client$/i.test(clientName) : false;
227
+ }
228
+ /** Evidence only lowers labels; it must never change routing. */
229
+ export function hostFamilyDoubt(env, family) {
230
+ if (family === "claude")
231
+ family = "anthropic";
232
+ if (family === "codex")
233
+ family = "openai";
234
+ if (family === "anthropic") {
235
+ for (const [key, value] of Object.entries(env))
236
+ if (value !== undefined && targetDef("claude").endpointEnv.test(key)) {
237
+ if (key !== "ANTHROPIC_BASE_URL")
238
+ return key;
239
+ try {
240
+ if (new URL(value).hostname !== "api.anthropic.com")
241
+ return key;
242
+ }
243
+ catch {
244
+ return key;
245
+ }
246
+ }
247
+ for (const key of ["ANTHROPIC_MODEL", "ANTHROPIC_DEFAULT_OPUS_MODEL", "ANTHROPIC_DEFAULT_SONNET_MODEL", "ANTHROPIC_DEFAULT_HAIKU_MODEL"]) {
248
+ if (env[key] && !targetDef("claude").ownModels.test(env[key]))
249
+ return key;
250
+ }
251
+ }
252
+ return family === "openai" && env.OPENAI_BASE_URL !== undefined ? "OPENAI_BASE_URL" : null;
253
+ }