@openllmsh/sdk 0.0.0-stage → 2.10.12-alpha.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ARCHITECTURE.md +43 -0
- package/LICENSE +202 -0
- package/README.md +142 -2
- package/assets/openllm-light.svg +18 -0
- package/assets/openllm.svg +18 -0
- package/client/chat.ts +140 -0
- package/client/devices.ts +269 -0
- package/client/http.ts +72 -0
- package/client/index.ts +129 -0
- package/client/relay-mux.ts +547 -0
- package/client/types.ts +51 -0
- package/client/vault.ts +239 -0
- package/connect/chat.ts +58 -0
- package/connect/client.ts +240 -0
- package/connect/config.ts +47 -0
- package/connect/errors.ts +121 -0
- package/connect/index.ts +23 -0
- package/connect/oauth.ts +265 -0
- package/connect/routes.ts +234 -0
- package/connect/store.ts +107 -0
- package/mcp/handle.ts +24 -0
- package/mcp/index.ts +76 -0
- package/mcp/server.ts +319 -0
- package/mcp/tools/marketplace.ts +439 -0
- package/mcp/tools/memory-client.ts +297 -0
- package/mcp/tools/memory-config.ts +32 -0
- package/mcp/tools/memory.ts +369 -0
- package/mcp/tools/model-priority.ts +88 -0
- package/mcp/tools/openllm.ts +883 -0
- package/mcp/types.ts +28 -0
- package/openapi/call.ts +90 -0
- package/openapi/index.ts +8 -0
- package/openapi/openapi.json +80213 -0
- package/openapi/operations.ts +2075 -0
- package/package.json +39 -4
- package/protocol/CONTRIBUTING.md +21 -0
- package/protocol/README.md +134 -0
- package/protocol/access.ts +186 -0
- package/protocol/agent-prompt-text.ts +32 -0
- package/protocol/agent.ts +991 -0
- package/protocol/api-key-syntax.ts +105 -0
- package/protocol/assets/openllm-light.svg +18 -0
- package/protocol/assets/openllm.svg +18 -0
- package/protocol/audio.ts +29 -0
- package/protocol/auth.ts +142 -0
- package/protocol/changelog.ts +155 -0
- package/protocol/chat.ts +458 -0
- package/protocol/client-registry.ts +356 -0
- package/protocol/config.ts +345 -0
- package/protocol/control-channel.ts +115 -0
- package/protocol/cooldown-reason.ts +78 -0
- package/protocol/cost.ts +10 -0
- package/protocol/daemon-port.ts +31 -0
- package/protocol/daemon.ts +1524 -0
- package/protocol/default-chains.ts +66 -0
- package/protocol/device-state.ts +85 -0
- package/protocol/doctor-report-local.ts +443 -0
- package/protocol/doctor-report-policy.ts +119 -0
- package/protocol/doctor-report.ts +947 -0
- package/protocol/errors.ts +14 -0
- package/protocol/execution-selection.ts +141 -0
- package/protocol/hop-grant.ts +33 -0
- package/protocol/image-edit-parse.ts +263 -0
- package/protocol/images.ts +298 -0
- package/protocol/index.ts +74 -0
- package/protocol/inference-headers.ts +3 -0
- package/protocol/keepalive.ts +69 -0
- package/protocol/local-auth.ts +300 -0
- package/protocol/local-device-control.ts +133 -0
- package/protocol/local-provider.ts +288 -0
- package/protocol/local-session.ts +118 -0
- package/protocol/marketplace.ts +187 -0
- package/protocol/media-attempt.ts +81 -0
- package/protocol/media-bytes.ts +28 -0
- package/protocol/media-default.ts +357 -0
- package/protocol/media-dimensions.ts +132 -0
- package/protocol/media-input.ts +61 -0
- package/protocol/media-model.ts +142 -0
- package/protocol/media-option-issue.ts +90 -0
- package/protocol/media-types.ts +70 -0
- package/protocol/model-match.ts +1051 -0
- package/protocol/model-settings.ts +327 -0
- package/protocol/models.ts +767 -0
- package/protocol/mux.ts +722 -0
- package/protocol/plan-surface.ts +59 -0
- package/protocol/provider-models.ts +16 -0
- package/protocol/provider-status.ts +206 -0
- package/protocol/provider-tier.ts +67 -0
- package/protocol/provider-usage.ts +263 -0
- package/protocol/providers.ts +901 -0
- package/protocol/public-usage-index.ts +354 -0
- package/protocol/realtime-generated.ts +31 -0
- package/protocol/realtime.ts +324 -0
- package/protocol/registry-pointer.ts +118 -0
- package/protocol/relay.ts +702 -0
- package/protocol/replay-session.ts +11 -0
- package/protocol/responses.ts +280 -0
- package/protocol/semver.ts +182 -0
- package/protocol/setup-mode.ts +22 -0
- package/protocol/sha256-hex.ts +98 -0
- package/protocol/stats.ts +406 -0
- package/protocol/streaming.ts +19 -0
- package/protocol/subscription-daemon-floors.ts +33 -0
- package/protocol/subscription-provider-compat.ts +104 -0
- package/protocol/subscription-provider.ts +32 -0
- package/protocol/team-grant.ts +17 -0
- package/protocol/team-shareable.ts +61 -0
- package/protocol/transcription-encoding.ts +76 -0
- package/protocol/url-locality-dns.ts +37 -0
- package/protocol/url-locality.ts +288 -0
- package/protocol/usage-snapshots.ts +9 -0
- package/protocol/vendor-cli-install.ts +29 -0
- package/protocol/video-job-plan.ts +50 -0
- package/protocol/videos.ts +227 -0
- package/tsconfig.json +14 -0
- package/tunnel/ARCHITECTURE.md +111 -0
- package/tunnel/LICENSE +33 -0
- package/tunnel/README.md +45 -0
- package/tunnel/assets/openllm-light.svg +18 -0
- package/tunnel/assets/openllm.svg +18 -0
- package/tunnel/channel-envelope.ts +139 -0
- package/tunnel/codec.ts +191 -0
- package/tunnel/device-anchor.ts +229 -0
- package/tunnel/device-control.ts +118 -0
- package/tunnel/device-grant.ts +173 -0
- package/tunnel/fleet.ts +77 -0
- package/tunnel/index.ts +22 -0
- package/tunnel/mux.ts +580 -0
- package/tunnel/peer-link.ts +390 -0
- package/tunnel/rtc-auth.ts +415 -0
- package/tunnel/rtc-duplex.ts +187 -0
- package/tunnel/rtc-ice.ts +136 -0
- package/tunnel/secure.ts +1298 -0
- package/tunnel/stream-reset-error.ts +14 -0
- package/tunnel/streams.ts +1430 -0
- package/tunnel/team-grant.ts +302 -0
- package/tunnel/wire-bytes.ts +102 -0
- package/vault/ARCHITECTURE.md +470 -0
- package/vault/LICENSE +33 -0
- package/vault/api-key.ts +190 -0
- package/vault/argon2.ts +106 -0
- package/vault/cli-auth-seal.ts +157 -0
- package/vault/cred-seal.ts +146 -0
- package/vault/credential.ts +55 -0
- package/vault/crypto.ts +210 -0
- package/vault/daemon-attest.ts +229 -0
- package/vault/derive.ts +113 -0
- package/vault/device-access.ts +87 -0
- package/vault/device-anchor.ts +185 -0
- package/vault/device-control.ts +174 -0
- package/vault/handoff.ts +396 -0
- package/vault/index.ts +21 -0
- package/vault/passkey.ts +243 -0
- package/vault/phrase.ts +65 -0
- package/vault/pin.ts +153 -0
- package/vault/public-key-seal.ts +131 -0
- package/vault/seed.ts +272 -0
- package/vault/team.ts +355 -0
- package/vault/vault-item.ts +131 -0
- package/vault/vault-migrate-digest.ts +29 -0
- package/vault/wrapped.ts +77 -0
- package/wire/ARCHITECTURE.md +90 -0
- package/wire/CONTRIBUTING.md +19 -0
- package/wire/LICENSE +33 -0
- package/wire/README.md +51 -0
- package/wire/adapters/messages/anthropic-map.ts +37 -0
- package/wire/adapters/messages/index.ts +7 -0
- package/wire/adapters/messages/reasoning-from-items.ts +38 -0
- package/wire/adapters/messages/reasoning-signature.ts +243 -0
- package/wire/adapters/messages/request.ts +574 -0
- package/wire/adapters/messages/response.ts +215 -0
- package/wire/adapters/messages/streaming.ts +1027 -0
- package/wire/adapters/messages/usage.ts +43 -0
- package/wire/adapters/responses/index.ts +3 -0
- package/wire/adapters/responses/request.ts +395 -0
- package/wire/adapters/responses/response.ts +88 -0
- package/wire/adapters/responses/streaming.ts +344 -0
- package/wire/assets/openllm-light.svg +18 -0
- package/wire/assets/openllm.svg +18 -0
- package/wire/features/account-rank.ts +166 -0
- package/wire/features/compaction/compact-request.ts +862 -0
- package/wire/features/compaction/compaction-text.ts +43 -0
- package/wire/features/context-demote.ts +47 -0
- package/wire/features/context-overflow-strategy.ts +26 -0
- package/wire/features/context-skip.ts +170 -0
- package/wire/features/conversation-affinity.ts +144 -0
- package/wire/features/max-tokens-backfill.ts +141 -0
- package/wire/features/model-caps.ts +53 -0
- package/wire/features/model-settings.ts +24 -0
- package/wire/features/output-limit-clamp.ts +64 -0
- package/wire/features/quota-gate.ts +85 -0
- package/wire/index.ts +44 -0
- package/wire/lib/attempt-outcome.ts +43 -0
- package/wire/lib/canonical/content-part.ts +38 -0
- package/wire/lib/canonical/count-tokens-capability.ts +138 -0
- package/wire/lib/canonical/encoding-select.ts +82 -0
- package/wire/lib/canonical/image-signature.ts +202 -0
- package/wire/lib/canonical/image-sse.ts +216 -0
- package/wire/lib/canonical/message.ts +43 -0
- package/wire/lib/canonical/token-estimate.ts +266 -0
- package/wire/lib/encrypted-content.ts +66 -0
- package/wire/lib/error-class.ts +154 -0
- package/wire/lib/error-envelope.ts +56 -0
- package/wire/lib/forwarded-headers.ts +180 -0
- package/wire/lib/provider-error-rules.ts +48 -0
- package/wire/lib/refusal.ts +38 -0
- package/wire/lib/responses-apply-patch.ts +104 -0
- package/wire/lib/responses-namespace.ts +53 -0
- package/wire/lib/secret-scrub.ts +101 -0
- package/wire/lib/streaming/accumulate.ts +221 -0
- package/wire/lib/streaming/finish-reason.ts +33 -0
- package/wire/lib/streaming/peek.ts +154 -0
- package/wire/lib/streaming/provider-decode.ts +259 -0
- package/wire/lib/streaming/response-stream.ts +71 -0
- package/wire/lib/streaming/sse.ts +699 -0
- package/wire/lib/streaming/strip-tool-calls.ts +95 -0
- package/wire/lib/streaming/upstream-error.ts +58 -0
- package/wire/lib/strip-subagent-isolation.ts +284 -0
- package/wire/lib/thinking-signature.ts +156 -0
- package/wire/lib/token-ruler/bpe-core.ts +426 -0
- package/wire/lib/token-ruler/index.ts +2 -0
- package/wire/lib/token-ruler/ruler.ts +79 -0
- package/wire/lib/token-ruler/vocab/claude-ranks.ts +16 -0
- package/wire/lib/token-ruler/vocab/claude.ts +22 -0
- package/wire/lib/token-ruler/vocab/o200k-ranks.ts +18 -0
- package/wire/lib/token-ruler/vocab/o200k.ts +19 -0
- package/wire/lib/tool-name-map.ts +271 -0
- package/wire/lib/tool-schema.ts +353 -0
- package/wire/lib/usage-observer.ts +125 -0
- package/wire/providers/anthropic/adaptive-thinking.ts +291 -0
- package/wire/providers/anthropic/beta-headers.ts +165 -0
- package/wire/providers/anthropic/index.ts +10 -0
- package/wire/providers/anthropic/request.ts +607 -0
- package/wire/providers/anthropic/response.ts +155 -0
- package/wire/providers/anthropic/streaming.ts +315 -0
- package/wire/providers/anthropic/web-search-domains.ts +49 -0
- package/wire/providers/chatgpt/common.ts +136 -0
- package/wire/providers/chatgpt/index.ts +9 -0
- package/wire/providers/chatgpt/request.ts +959 -0
- package/wire/providers/chatgpt/streaming.ts +1007 -0
- package/wire/providers/chatgpt/web-search.ts +63 -0
- package/wire/providers/grok/web-search.ts +87 -0
- package/wire/providers/kimi/web-search.ts +145 -0
- package/wire/providers/upstream-deny.ts +355 -0
- 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
|
+
};
|