@openllmsh/sdk 0.0.0-stage → 2.10.12-alpha.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 (245) hide show
  1. package/ARCHITECTURE.md +43 -0
  2. package/LICENSE +202 -0
  3. package/README.md +142 -2
  4. package/assets/openllm-light.svg +18 -0
  5. package/assets/openllm.svg +18 -0
  6. package/client/chat.ts +140 -0
  7. package/client/devices.ts +269 -0
  8. package/client/http.ts +72 -0
  9. package/client/index.ts +129 -0
  10. package/client/relay-mux.ts +547 -0
  11. package/client/types.ts +51 -0
  12. package/client/vault.ts +239 -0
  13. package/connect/chat.ts +58 -0
  14. package/connect/client.ts +240 -0
  15. package/connect/config.ts +47 -0
  16. package/connect/errors.ts +121 -0
  17. package/connect/index.ts +23 -0
  18. package/connect/oauth.ts +265 -0
  19. package/connect/routes.ts +234 -0
  20. package/connect/store.ts +107 -0
  21. package/mcp/handle.ts +24 -0
  22. package/mcp/index.ts +76 -0
  23. package/mcp/server.ts +319 -0
  24. package/mcp/tools/marketplace.ts +439 -0
  25. package/mcp/tools/memory-client.ts +297 -0
  26. package/mcp/tools/memory-config.ts +32 -0
  27. package/mcp/tools/memory.ts +369 -0
  28. package/mcp/tools/model-priority.ts +88 -0
  29. package/mcp/tools/openllm.ts +883 -0
  30. package/mcp/types.ts +28 -0
  31. package/openapi/call.ts +90 -0
  32. package/openapi/index.ts +8 -0
  33. package/openapi/openapi.json +80213 -0
  34. package/openapi/operations.ts +2075 -0
  35. package/package.json +39 -4
  36. package/protocol/CONTRIBUTING.md +21 -0
  37. package/protocol/README.md +134 -0
  38. package/protocol/access.ts +186 -0
  39. package/protocol/agent-prompt-text.ts +32 -0
  40. package/protocol/agent.ts +991 -0
  41. package/protocol/api-key-syntax.ts +105 -0
  42. package/protocol/assets/openllm-light.svg +18 -0
  43. package/protocol/assets/openllm.svg +18 -0
  44. package/protocol/audio.ts +29 -0
  45. package/protocol/auth.ts +142 -0
  46. package/protocol/changelog.ts +155 -0
  47. package/protocol/chat.ts +458 -0
  48. package/protocol/client-registry.ts +356 -0
  49. package/protocol/config.ts +345 -0
  50. package/protocol/control-channel.ts +115 -0
  51. package/protocol/cooldown-reason.ts +78 -0
  52. package/protocol/cost.ts +10 -0
  53. package/protocol/daemon-port.ts +31 -0
  54. package/protocol/daemon.ts +1524 -0
  55. package/protocol/default-chains.ts +66 -0
  56. package/protocol/device-state.ts +85 -0
  57. package/protocol/doctor-report-local.ts +443 -0
  58. package/protocol/doctor-report-policy.ts +119 -0
  59. package/protocol/doctor-report.ts +947 -0
  60. package/protocol/errors.ts +14 -0
  61. package/protocol/execution-selection.ts +141 -0
  62. package/protocol/hop-grant.ts +33 -0
  63. package/protocol/image-edit-parse.ts +263 -0
  64. package/protocol/images.ts +298 -0
  65. package/protocol/index.ts +74 -0
  66. package/protocol/inference-headers.ts +3 -0
  67. package/protocol/keepalive.ts +69 -0
  68. package/protocol/local-auth.ts +300 -0
  69. package/protocol/local-device-control.ts +133 -0
  70. package/protocol/local-provider.ts +288 -0
  71. package/protocol/local-session.ts +118 -0
  72. package/protocol/marketplace.ts +187 -0
  73. package/protocol/media-attempt.ts +81 -0
  74. package/protocol/media-bytes.ts +28 -0
  75. package/protocol/media-default.ts +357 -0
  76. package/protocol/media-dimensions.ts +132 -0
  77. package/protocol/media-input.ts +61 -0
  78. package/protocol/media-model.ts +142 -0
  79. package/protocol/media-option-issue.ts +90 -0
  80. package/protocol/media-types.ts +70 -0
  81. package/protocol/model-match.ts +1051 -0
  82. package/protocol/model-settings.ts +327 -0
  83. package/protocol/models.ts +767 -0
  84. package/protocol/mux.ts +722 -0
  85. package/protocol/plan-surface.ts +59 -0
  86. package/protocol/provider-models.ts +16 -0
  87. package/protocol/provider-status.ts +206 -0
  88. package/protocol/provider-tier.ts +67 -0
  89. package/protocol/provider-usage.ts +263 -0
  90. package/protocol/providers.ts +901 -0
  91. package/protocol/public-usage-index.ts +354 -0
  92. package/protocol/realtime-generated.ts +31 -0
  93. package/protocol/realtime.ts +324 -0
  94. package/protocol/registry-pointer.ts +118 -0
  95. package/protocol/relay.ts +702 -0
  96. package/protocol/replay-session.ts +11 -0
  97. package/protocol/responses.ts +280 -0
  98. package/protocol/semver.ts +182 -0
  99. package/protocol/setup-mode.ts +22 -0
  100. package/protocol/sha256-hex.ts +98 -0
  101. package/protocol/stats.ts +406 -0
  102. package/protocol/streaming.ts +19 -0
  103. package/protocol/subscription-daemon-floors.ts +33 -0
  104. package/protocol/subscription-provider-compat.ts +104 -0
  105. package/protocol/subscription-provider.ts +32 -0
  106. package/protocol/team-grant.ts +17 -0
  107. package/protocol/team-shareable.ts +61 -0
  108. package/protocol/transcription-encoding.ts +76 -0
  109. package/protocol/url-locality-dns.ts +37 -0
  110. package/protocol/url-locality.ts +288 -0
  111. package/protocol/usage-snapshots.ts +9 -0
  112. package/protocol/vendor-cli-install.ts +29 -0
  113. package/protocol/video-job-plan.ts +50 -0
  114. package/protocol/videos.ts +227 -0
  115. package/tsconfig.json +14 -0
  116. package/tunnel/ARCHITECTURE.md +111 -0
  117. package/tunnel/LICENSE +33 -0
  118. package/tunnel/README.md +45 -0
  119. package/tunnel/assets/openllm-light.svg +18 -0
  120. package/tunnel/assets/openllm.svg +18 -0
  121. package/tunnel/channel-envelope.ts +139 -0
  122. package/tunnel/codec.ts +191 -0
  123. package/tunnel/device-anchor.ts +229 -0
  124. package/tunnel/device-control.ts +118 -0
  125. package/tunnel/device-grant.ts +173 -0
  126. package/tunnel/fleet.ts +77 -0
  127. package/tunnel/index.ts +22 -0
  128. package/tunnel/mux.ts +580 -0
  129. package/tunnel/peer-link.ts +390 -0
  130. package/tunnel/rtc-auth.ts +415 -0
  131. package/tunnel/rtc-duplex.ts +187 -0
  132. package/tunnel/rtc-ice.ts +136 -0
  133. package/tunnel/secure.ts +1298 -0
  134. package/tunnel/stream-reset-error.ts +14 -0
  135. package/tunnel/streams.ts +1430 -0
  136. package/tunnel/team-grant.ts +302 -0
  137. package/tunnel/wire-bytes.ts +102 -0
  138. package/vault/ARCHITECTURE.md +470 -0
  139. package/vault/LICENSE +33 -0
  140. package/vault/api-key.ts +190 -0
  141. package/vault/argon2.ts +106 -0
  142. package/vault/cli-auth-seal.ts +157 -0
  143. package/vault/cred-seal.ts +146 -0
  144. package/vault/credential.ts +55 -0
  145. package/vault/crypto.ts +210 -0
  146. package/vault/daemon-attest.ts +229 -0
  147. package/vault/derive.ts +113 -0
  148. package/vault/device-access.ts +87 -0
  149. package/vault/device-anchor.ts +185 -0
  150. package/vault/device-control.ts +174 -0
  151. package/vault/handoff.ts +396 -0
  152. package/vault/index.ts +21 -0
  153. package/vault/passkey.ts +243 -0
  154. package/vault/phrase.ts +65 -0
  155. package/vault/pin.ts +153 -0
  156. package/vault/public-key-seal.ts +131 -0
  157. package/vault/seed.ts +272 -0
  158. package/vault/team.ts +355 -0
  159. package/vault/vault-item.ts +131 -0
  160. package/vault/vault-migrate-digest.ts +29 -0
  161. package/vault/wrapped.ts +77 -0
  162. package/wire/ARCHITECTURE.md +90 -0
  163. package/wire/CONTRIBUTING.md +19 -0
  164. package/wire/LICENSE +33 -0
  165. package/wire/README.md +51 -0
  166. package/wire/adapters/messages/anthropic-map.ts +37 -0
  167. package/wire/adapters/messages/index.ts +7 -0
  168. package/wire/adapters/messages/reasoning-from-items.ts +38 -0
  169. package/wire/adapters/messages/reasoning-signature.ts +243 -0
  170. package/wire/adapters/messages/request.ts +574 -0
  171. package/wire/adapters/messages/response.ts +215 -0
  172. package/wire/adapters/messages/streaming.ts +1027 -0
  173. package/wire/adapters/messages/usage.ts +43 -0
  174. package/wire/adapters/responses/index.ts +3 -0
  175. package/wire/adapters/responses/request.ts +395 -0
  176. package/wire/adapters/responses/response.ts +88 -0
  177. package/wire/adapters/responses/streaming.ts +344 -0
  178. package/wire/assets/openllm-light.svg +18 -0
  179. package/wire/assets/openllm.svg +18 -0
  180. package/wire/features/account-rank.ts +166 -0
  181. package/wire/features/compaction/compact-request.ts +862 -0
  182. package/wire/features/compaction/compaction-text.ts +43 -0
  183. package/wire/features/context-demote.ts +47 -0
  184. package/wire/features/context-overflow-strategy.ts +26 -0
  185. package/wire/features/context-skip.ts +170 -0
  186. package/wire/features/conversation-affinity.ts +144 -0
  187. package/wire/features/max-tokens-backfill.ts +141 -0
  188. package/wire/features/model-caps.ts +53 -0
  189. package/wire/features/model-settings.ts +24 -0
  190. package/wire/features/output-limit-clamp.ts +64 -0
  191. package/wire/features/quota-gate.ts +85 -0
  192. package/wire/index.ts +44 -0
  193. package/wire/lib/attempt-outcome.ts +43 -0
  194. package/wire/lib/canonical/content-part.ts +38 -0
  195. package/wire/lib/canonical/count-tokens-capability.ts +138 -0
  196. package/wire/lib/canonical/encoding-select.ts +82 -0
  197. package/wire/lib/canonical/image-signature.ts +202 -0
  198. package/wire/lib/canonical/image-sse.ts +216 -0
  199. package/wire/lib/canonical/message.ts +43 -0
  200. package/wire/lib/canonical/token-estimate.ts +266 -0
  201. package/wire/lib/encrypted-content.ts +66 -0
  202. package/wire/lib/error-class.ts +154 -0
  203. package/wire/lib/error-envelope.ts +56 -0
  204. package/wire/lib/forwarded-headers.ts +180 -0
  205. package/wire/lib/provider-error-rules.ts +48 -0
  206. package/wire/lib/refusal.ts +38 -0
  207. package/wire/lib/responses-apply-patch.ts +104 -0
  208. package/wire/lib/responses-namespace.ts +53 -0
  209. package/wire/lib/secret-scrub.ts +101 -0
  210. package/wire/lib/streaming/accumulate.ts +221 -0
  211. package/wire/lib/streaming/finish-reason.ts +33 -0
  212. package/wire/lib/streaming/peek.ts +154 -0
  213. package/wire/lib/streaming/provider-decode.ts +259 -0
  214. package/wire/lib/streaming/response-stream.ts +71 -0
  215. package/wire/lib/streaming/sse.ts +699 -0
  216. package/wire/lib/streaming/strip-tool-calls.ts +95 -0
  217. package/wire/lib/streaming/upstream-error.ts +58 -0
  218. package/wire/lib/strip-subagent-isolation.ts +284 -0
  219. package/wire/lib/thinking-signature.ts +156 -0
  220. package/wire/lib/token-ruler/bpe-core.ts +426 -0
  221. package/wire/lib/token-ruler/index.ts +2 -0
  222. package/wire/lib/token-ruler/ruler.ts +79 -0
  223. package/wire/lib/token-ruler/vocab/claude-ranks.ts +16 -0
  224. package/wire/lib/token-ruler/vocab/claude.ts +22 -0
  225. package/wire/lib/token-ruler/vocab/o200k-ranks.ts +18 -0
  226. package/wire/lib/token-ruler/vocab/o200k.ts +19 -0
  227. package/wire/lib/tool-name-map.ts +271 -0
  228. package/wire/lib/tool-schema.ts +353 -0
  229. package/wire/lib/usage-observer.ts +125 -0
  230. package/wire/providers/anthropic/adaptive-thinking.ts +291 -0
  231. package/wire/providers/anthropic/beta-headers.ts +165 -0
  232. package/wire/providers/anthropic/index.ts +10 -0
  233. package/wire/providers/anthropic/request.ts +607 -0
  234. package/wire/providers/anthropic/response.ts +155 -0
  235. package/wire/providers/anthropic/streaming.ts +315 -0
  236. package/wire/providers/anthropic/web-search-domains.ts +49 -0
  237. package/wire/providers/chatgpt/common.ts +136 -0
  238. package/wire/providers/chatgpt/index.ts +9 -0
  239. package/wire/providers/chatgpt/request.ts +959 -0
  240. package/wire/providers/chatgpt/streaming.ts +1007 -0
  241. package/wire/providers/chatgpt/web-search.ts +63 -0
  242. package/wire/providers/grok/web-search.ts +87 -0
  243. package/wire/providers/kimi/web-search.ts +145 -0
  244. package/wire/providers/upstream-deny.ts +355 -0
  245. package/wire/providers/upstream-request.ts +619 -0
@@ -0,0 +1,356 @@
1
+ /**
2
+ * The client registry — the SINGLE source of truth for which clients
3
+ * `openllm <client>` supports, how each one is reached, and which mode it runs
4
+ * in. `commands.ts` derives help + completion from this, the dashboard renders
5
+ * one instruction card per entry, and dispatch in `main.ts` switches on it, so
6
+ * none of those can drift from the actual supported set.
7
+ *
8
+ * Two modes (docs/proposals/remove-registry-runtime-config-merge.md §3.4):
9
+ *
10
+ * session — the client is launched per task and can be pointed at an
11
+ * overlay we own (a flag, a `-c` override, or a private config
12
+ * dir). We merge in memory, write only into an ephemeral
13
+ * ~/.openllm/run/<client>/<pid>/, exec the real binary, and
14
+ * never touch the user's config. No uninstall exists because
15
+ * nothing was installed.
16
+ *
17
+ * always-on — the client is a long-lived app with a fixed config path and no
18
+ * per-invocation overlay hook (Raycast). `openllm <client>`
19
+ * applies the overlay to the host config IN PLACE and
20
+ * `openllm <client> uninstall` reverses exactly that, tracked by
21
+ * an ownership ledger under ~/.openllm/clients/. The ChatGPT
22
+ * Mac app is always-on too, but writes no vendor config: it
23
+ * installs a launcher .app that starts ChatGPT wired to us.
24
+ */
25
+
26
+ export const CLIENT_IDS = [
27
+ "claude",
28
+ "codex",
29
+ "chatgpt",
30
+ "grok",
31
+ "hermes",
32
+ "opencode",
33
+ "raycast",
34
+ ] as const;
35
+ export type TClientId = (typeof CLIENT_IDS)[number];
36
+
37
+ export type TClientMode = "session" | "always-on";
38
+
39
+ /**
40
+ * How a session client is pointed at our overlay. Each strategy is the
41
+ * client's OWN documented mechanism — we never redirect a config dir when a
42
+ * narrower hook exists, because a full redirect would also displace the user's
43
+ * credentials and history.
44
+ */
45
+ export type TSessionStrategy =
46
+ /** Extra CLI flags referencing run-local files (Claude: --settings/--mcp-config). */
47
+ | "flags"
48
+ /** `-c key=value` overrides layered on the user's config (Codex). */
49
+ | "config-overrides"
50
+ /** A private config dir env var over a symlink farm of the real one (Grok). */
51
+ | "config-dir"
52
+ /** A single config-file env var (OpenCode). */
53
+ | "config-file";
54
+
55
+ /** The daemon broker's session vocabulary for launchable clients.
56
+ * Mirrors DeviceSessionCli in packages/sdk/protocol/daemon.ts — this compiled
57
+ * binary carries no workspace deps, so the set is restated here once and
58
+ * every CLI-side consumer imports THIS alias. Overlay clients remain
59
+ * vendor-only; shell deliberately has no `CLIENTS` entry. */
60
+ export const DAEMON_CLIS = [
61
+ "claude_code",
62
+ "chatgpt",
63
+ "grok",
64
+ "opencode",
65
+ "hermes",
66
+ "shell",
67
+ ] as const;
68
+ export type TDaemonCli = (typeof DAEMON_CLIS)[number];
69
+
70
+ /**
71
+ * Official curl|shell installer for a session client. Owned by the registry —
72
+ * `install-client.ts` and install guidance derive from this; never build a
73
+ * command from user input.
74
+ */
75
+ export type TClientCurlInstall = {
76
+ readonly url: string;
77
+ readonly shell: "bash" | "sh";
78
+ };
79
+
80
+ export type TClient = {
81
+ readonly id: TClientId;
82
+ /** Human label for help text + the dashboard card. */
83
+ readonly name: string;
84
+ readonly mode: TClientMode;
85
+ /** Binary we exec, and the candidate paths to find it at. */
86
+ readonly bin: string;
87
+ readonly binPaths: readonly string[];
88
+ /** Official install docs / download page, printed when the binary is missing. */
89
+ readonly installHint: string;
90
+ /**
91
+ * Curl|shell installer when OpenLLM may offer on-demand install. Absent for
92
+ * always-on apps (ChatGPT Mac app, Raycast) and any client without a trusted
93
+ * official script.
94
+ */
95
+ readonly curlInstall?: TClientCurlInstall;
96
+ /** Session clients only: how the overlay reaches the client. */
97
+ readonly strategy?: TSessionStrategy;
98
+ /** Daemon broker's DeviceSessionCli vocabulary for this client. */
99
+ readonly daemonCli?: TDaemonCli;
100
+ /** Client argv markers that select a non-interactive mode. */
101
+ readonly nonInteractiveMarkers?: readonly string[];
102
+ /** Whether this client needs a live model catalog (and under which id the
103
+ * gateway serves it — the historical slug, which may differ from `id`). */
104
+ readonly catalogSlug?: string;
105
+ /** Platforms the client runs on; empty = every supported OS. */
106
+ readonly os?: readonly ("darwin" | "linux")[];
107
+ /**
108
+ * This client's own "skip every approval prompt" flag, which `-d` translates
109
+ * to. Every client spells it differently, so `-d` is OUR stable spelling and
110
+ * this is the mapping. Undefined = the client has no equivalent, and `-d`
111
+ * errors rather than silently launching WITH prompts (a false sense of
112
+ * yolo-mode is worse than a clear refusal).
113
+ */
114
+ readonly dangerousFlag?: string;
115
+ /** One-line note. Rendered as a `# …` comment inside the dashboard's
116
+ * terminal block and in `openllm <client> -h`, so keep it short and
117
+ * period-free — it has to read as a shell comment. */
118
+ readonly note: string;
119
+ };
120
+
121
+ export const CLIENTS: Readonly<Record<TClientId, TClient>> = {
122
+ claude: {
123
+ id: "claude",
124
+ name: "Claude Code",
125
+ mode: "session",
126
+ strategy: "flags",
127
+ daemonCli: "claude_code",
128
+ nonInteractiveMarkers: ["-p", "--print"],
129
+ bin: "claude",
130
+ binPaths: ["~/.local/bin/claude"],
131
+ installHint: "https://claude.ai/install.sh",
132
+ curlInstall: { url: "https://claude.ai/install.sh", shell: "bash" },
133
+ dangerousFlag: "--dangerously-skip-permissions",
134
+ note: "your ~/.claude config is never modified",
135
+ },
136
+ codex: {
137
+ id: "codex",
138
+ name: "Codex",
139
+ mode: "session",
140
+ strategy: "config-overrides",
141
+ daemonCli: "chatgpt",
142
+ nonInteractiveMarkers: ["exec"],
143
+ bin: "codex",
144
+ binPaths: ["~/.local/bin/codex", "~/.codex/bin/codex"],
145
+ installHint: "https://chatgpt.com/codex/install.sh",
146
+ curlInstall: {
147
+ url: "https://chatgpt.com/codex/install.sh",
148
+ shell: "bash",
149
+ },
150
+ catalogSlug: "codex",
151
+ dangerousFlag: "--dangerously-bypass-approvals-and-sandbox",
152
+ note: "your ~/.codex/config.toml is never modified",
153
+ },
154
+ grok: {
155
+ id: "grok",
156
+ name: "Grok Build",
157
+ mode: "session",
158
+ strategy: "config-dir",
159
+ daemonCli: "grok",
160
+ nonInteractiveMarkers: ["-p", "--print"],
161
+ bin: "grok",
162
+ binPaths: ["~/.grok/bin/grok", "~/.local/bin/grok"],
163
+ installHint: "https://x.ai/cli/install.sh",
164
+ curlInstall: { url: "https://x.ai/cli/install.sh", shell: "bash" },
165
+ catalogSlug: "grok-build",
166
+ dangerousFlag: "--always-approve",
167
+ note: "your ~/.grok config and auth.json are never modified",
168
+ },
169
+ hermes: {
170
+ id: "hermes",
171
+ name: "Hermes",
172
+ mode: "session",
173
+ strategy: "config-dir",
174
+ daemonCli: "hermes",
175
+ nonInteractiveMarkers: ["-z", "run", "cron", "webhook", "gateway"],
176
+ bin: "hermes",
177
+ binPaths: ["~/.hermes/bin/hermes", "~/.local/bin/hermes"],
178
+ installHint: "https://hermes-agent.nousresearch.com/install.sh",
179
+ curlInstall: {
180
+ url: "https://hermes-agent.nousresearch.com/install.sh",
181
+ shell: "bash",
182
+ },
183
+ dangerousFlag: "--yolo",
184
+ note: "session overlay; openllm hermes install writes a sticky profile without touching default config",
185
+ },
186
+ opencode: {
187
+ id: "opencode",
188
+ name: "OpenCode",
189
+ mode: "session",
190
+ strategy: "config-file",
191
+ daemonCli: "opencode",
192
+ nonInteractiveMarkers: ["run", "serve", "--print"],
193
+ bin: "opencode",
194
+ binPaths: ["~/.opencode/bin/opencode", "~/.local/bin/opencode"],
195
+ installHint: "https://opencode.ai/install",
196
+ curlInstall: { url: "https://opencode.ai/install", shell: "bash" },
197
+ catalogSlug: "opencode",
198
+ note: "your ~/.config/opencode config is never modified",
199
+ },
200
+ chatgpt: {
201
+ id: "chatgpt",
202
+ name: "ChatGPT",
203
+ mode: "always-on",
204
+ bin: "",
205
+ binPaths: [],
206
+ installHint: "https://chatgpt.com/download",
207
+ catalogSlug: "codex",
208
+ os: ["darwin"],
209
+ note: "installs an OpenLLM ChatGPT launcher in /Applications; ~/.codex is never modified",
210
+ },
211
+ raycast: {
212
+ id: "raycast",
213
+ name: "Raycast",
214
+ mode: "always-on",
215
+ bin: "",
216
+ binPaths: [],
217
+ installHint: "https://raycast.com",
218
+ catalogSlug: "raycast",
219
+ os: ["darwin"],
220
+ note: "Raycast runs continuously, so this applies to its config once",
221
+ },
222
+ } as const;
223
+
224
+ /** Always-on client ids — a test pins this to `mode === "always-on"`. */
225
+ export const ALWAYS_ON_CLIENT_IDS = ["chatgpt", "raycast"] as const;
226
+ export type TAlwaysOnClientId = (typeof ALWAYS_ON_CLIENT_IDS)[number];
227
+
228
+ export const isClientId = (value: string): value is TClientId =>
229
+ (CLIENT_IDS as readonly string[]).includes(value);
230
+
231
+ /** Verbs an always-on client reserves; everything else forwards to the client. */
232
+ export const ALWAYS_ON_VERBS = ["uninstall", "status"] as const;
233
+ export type TAlwaysOnVerb = (typeof ALWAYS_ON_VERBS)[number];
234
+
235
+ export const isAlwaysOnVerb = (value: string): value is TAlwaysOnVerb =>
236
+ (ALWAYS_ON_VERBS as readonly string[]).includes(value);
237
+
238
+ /**
239
+ * OpenLLM-level flags, which sit BEFORE the client name:
240
+ *
241
+ * openllm -d claude --resume
242
+ * ^^ ours ^^^^^^^^ the client's, untouched
243
+ *
244
+ * Position is load-bearing, not stylistic. `-d` is already taken by the
245
+ * clients themselves — claude has `-d`=--debug (and `-r`=--resume, which is
246
+ * why a leading `-r` is refused rather than silently ignored) — so consuming
247
+ * them AFTER the client name would silently steal
248
+ * a flag the user meant for the client. Putting them where openllm's own flags
249
+ * live means everything after the client name is unambiguously the client's,
250
+ * now and as clients add flags.
251
+ */
252
+ export type TClientFlags = {
253
+ /** `-d` — translate to the client's own skip-all-approvals flag. */
254
+ readonly dangerous: boolean;
255
+ /** `--new` — always start a fresh session; never offer to attach to one
256
+ * already running on this machine. */
257
+ readonly fresh: boolean;
258
+ /** `--bare` — sterile launch for internal summarizers — drops the OpenLLM MCP
259
+ * overlay; ordinary launches never set it. */
260
+ readonly bare: boolean;
261
+ /**
262
+ * `--attach [id]` — attach to a running session without being asked. An id
263
+ * (or unique prefix) picks one; a bare `--attach` takes the best match for
264
+ * this client and directory. Null means the flag was absent.
265
+ */
266
+ readonly attach: string | null;
267
+ /** Incompatible session-selection flags detected before client dispatch. */
268
+ readonly sessionSelectionError?: string;
269
+ /** Everything from the client name onward, in order and untouched. */
270
+ readonly rest: readonly string[];
271
+ };
272
+
273
+ /**
274
+ * Split our flags off the front of `openllm`'s OWN argv — i.e. the arguments
275
+ * that appear before the client name. Stops at the first token that isn't one
276
+ * of ours, which is the client name itself.
277
+ *
278
+ * `rest` therefore begins with the client name (when one was given), and
279
+ * everything after it is forwarded to the client verbatim — we never inspect,
280
+ * reorder, or rewrite a single client argument.
281
+ */
282
+ export const parseClientFlags = (args: readonly string[]): TClientFlags => {
283
+ let dangerous = false;
284
+ let fresh = false;
285
+ let bare = false;
286
+ let attach: string | null = null;
287
+ let sessionSelectionError: string | undefined;
288
+ let i = 0;
289
+ for (; i < args.length; i += 1) {
290
+ const arg = args[i];
291
+ if (arg === "-d") {
292
+ dangerous = true;
293
+ continue;
294
+ }
295
+ // `-r` (route via cloud) is gone: the gateway is chosen automatically
296
+ // (local daemon if it answers, else the cloud origin, which tunnels to
297
+ // a device). Refuse it loudly rather than hand it to the client as if it
298
+ // were the client's own `-r`.
299
+ // Exception: launchers installed before the removal bake
300
+ // `openllm -r chatgpt launch`; accept and ignore it there so they keep
301
+ // working until the next `openllm chatgpt` rewrites them.
302
+ if (arg === "-r" && args[i + 1] === "chatgpt" && args[i + 2] === "launch")
303
+ continue;
304
+ if (arg === "-r" || (/^-[dr]+$/.test(arg) && arg.includes("r"))) {
305
+ sessionSelectionError =
306
+ "-r was removed — the gateway is chosen automatically (local daemon if running, else the cloud)";
307
+ break;
308
+ }
309
+ // Long-form on purpose: `-n`/`-a` would be plausible client flags, and
310
+ // these live in the same position as `-d`, so a collision would be
311
+ // silent. Session selection is rare enough that spelling it out is fine.
312
+ if (arg === "--bare") {
313
+ bare = true;
314
+ continue;
315
+ }
316
+ if (arg === "--new") {
317
+ fresh = true;
318
+ if (attach !== null)
319
+ sessionSelectionError = "--new cannot be combined with --attach";
320
+ continue;
321
+ }
322
+ if (arg === "--attach") {
323
+ if (fresh)
324
+ sessionSelectionError = "--new cannot be combined with --attach";
325
+ // A bare `--attach` means "best match"; an id may follow. The next token
326
+ // is only consumed when it cannot be the client name or another flag.
327
+ const next = args[i + 1];
328
+ if (next !== undefined && !next.startsWith("-") && !isClientId(next)) {
329
+ // Session ids are uuids; a prefix is only usable at 4+ chars anyway.
330
+ if (!/^[A-Za-z0-9][A-Za-z0-9_-]{3,}$/.test(next)) {
331
+ sessionSelectionError = `invalid --attach selector: ${next}`;
332
+ break;
333
+ }
334
+ attach = next;
335
+ i += 1;
336
+ continue;
337
+ }
338
+ attach = "";
339
+ continue;
340
+ }
341
+ // Combined short form (`-dd`), since these are ours and take no values.
342
+ if (/^-d+$/.test(arg)) {
343
+ dangerous = true;
344
+ continue;
345
+ }
346
+ break; // the client name (or an unknown flag) — everything from here is not ours
347
+ }
348
+ return {
349
+ dangerous,
350
+ fresh,
351
+ bare,
352
+ attach,
353
+ ...(sessionSelectionError === undefined ? {} : { sessionSelectionError }),
354
+ rest: args.slice(i),
355
+ };
356
+ };