Skip to content

Commit 709f1ab

Browse files
committed
feat(gui): expose Cursor HTTP transport setting
1 parent d9c4864 commit 709f1ab

20 files changed

Lines changed: 233 additions & 11 deletions

File tree

‎docs-site/src/content/docs/guides/providers.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -512,7 +512,8 @@ Cursor is tracked separately as an experimental adapter. `adapter: "cursor"` app
512512
and the dashboard Add Provider picker as an experimental local config entry with Cursor's static
513513
fallback model catalog metadata. When a Cursor access token is configured, opencodex uses Cursor's
514514
live HTTP/2 transport. Set `upstreamHttpVersion: "http1.1"` when a proxy requires Cursor's HTTP/1.1
515-
compatibility path; the setting covers both inference and live model discovery. Its bundled fallback seed includes `gpt-5.6-sol` / `terra` / `luna` (1M context),
515+
compatibility path; the setting covers both inference and live model discovery and is exposed at
516+
**Providers → Cursor → Settings → Cursor transport**. Its bundled fallback seed includes `gpt-5.6-sol` / `terra` / `luna` (1M context),
516517
regular/Fast rows for Grok 4.5 and 4.6 (500K), and `kimi-k3` (262K); live discovery decides which
517518
remain visible for the account. Grok 4.6 exposes `low` / `medium` / `high` / `xhigh` in both forms,
518519
while 4.5 stops at `high`. Fast requests send the matching base Grok model with separate `effort`

‎docs-site/src/content/docs/reference/configuration/providers.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -278,7 +278,7 @@ Cursor-specific model parameters:
278278
If a proxy cannot carry Cursor's default HTTP/2 stream, set `upstreamHttpVersion` to `"http1.1"`.
279279
This switches inference to Cursor's `RunSSE` + `BidiAppend` compatibility transport and uses
280280
HTTP/1.1 for `GetUsableModels` discovery as well. Leave it unset or use `"auto"` for the existing
281-
HTTP/2 behavior.
281+
HTTP/2 behavior. In the dashboard choose **Providers → Cursor → Settings → Cursor transport**.
282282

283283
| Codex model | Cursor Router mode |
284284
| --- | --- |
@@ -314,8 +314,8 @@ Cursor server-driven local tools are disabled by default. Codex continues using
314314
}
315315
```
316316

317-
Set the field on `providers.cursor`, not at the top level. In the dashboard use **Providers → Cursor
318-
→ Edit JSON**, save, then restart. Legacy `unsafeAllowNativeLocalExec: true` equals
317+
Set `nativeLocalExec` on `providers.cursor`, not at the top level. In the dashboard use **Providers
318+
→ Cursor → Edit JSON**, save, then restart. Legacy `unsafeAllowNativeLocalExec: true` equals
319319
`nativeLocalExec: "on"` only when `nativeLocalExec` is unset. MCP, screen recording, and computer use
320320
are controlled separately by `mcpServers` and `desktopExecutor`.
321321

‎docs-site/src/content/docs/zh-cn/guides/providers.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -366,7 +366,8 @@ adapter。若要将没有内置默认值的模型(例如 `gpt-5.4-nano`)接
366366
Cursor 作为单独的实验性 adapter 进行跟踪。`adapter: "cursor"` 会作为实验性本地配置出现在
367367
`ocx init` 和 dashboard Add Provider picker 中,并保存 Cursor 的静态回退模型目录 metadata。配置
368368
Cursor access token 后,opencodex 会使用 Cursor live HTTP/2 transport。代理要求 Cursor 的
369-
HTTP/1.1 兼容路径时,可设置 `upstreamHttpVersion: "http1.1"`;该设置同时覆盖推理与实时模型发现。内置回退列表包含上下文为
369+
HTTP/1.1 兼容路径时,可设置 `upstreamHttpVersion: "http1.1"`;该设置同时覆盖推理与实时模型发现,
370+
并可在 **Providers → Cursor → 设置 → Cursor 传输协议** 中选择。内置回退列表包含上下文为
370371
1M 的 `gpt-5.6-sol` / `terra` / `luna`、上下文为 500K 的 Grok 4.5/4.6 普通与 Fast 条目,以及上下文为
371372
262K 的 `kimi-k3`;最终显示哪些模型由账号的实时发现结果决定。Grok 4.6 的两种形式均提供
372373
`low` / `medium` / `high` / `xhigh`,而 4.5 最高为 `high`。Fast 请求会发送对应的 Grok 基础模型,

‎docs-site/src/content/docs/zh-cn/reference/configuration/providers.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -225,6 +225,7 @@ Cursor 桥接是实验性的。执行 `ocx login cursor` 之后,添加或编
225225
如果代理无法承载 Cursor 默认的 HTTP/2 stream,请将 `upstreamHttpVersion` 设置为
226226
`"http1.1"`。推理会切换到 Cursor 的 `RunSSE` + `BidiAppend` 兼容传输,`GetUsableModels`
227227
实时发现也会使用 HTTP/1.1。保持未设置或使用 `"auto"`,则继续使用现有 HTTP/2 行为。
228+
在仪表板中,可通过 **Providers → Cursor → 设置 → Cursor 传输协议** 进行选择。
228229

229230
| Codex model | Cursor Router mode |
230231
| --- | --- |
@@ -256,7 +257,7 @@ Cursor 由服务端驱动的本地工具默认是禁用的。Codex 继续使用
256257
}
257258
```
258259

259-
请将该字段设置在 `providers.cursor` 上,而不是顶层。在仪表板中,使用 **Providers → Cursor → Edit JSON**,保存,然后重启。旧的 `unsafeAllowNativeLocalExec: true` 仅在未设置 `nativeLocalExec` 时,才等同于 `nativeLocalExec: "on"`。MCP、屏幕录制和 computer use 由 `mcpServers` 和 `desktopExecutor` 单独控制。
260+
请将 `nativeLocalExec` 设置在 `providers.cursor` 上,而不是顶层。在仪表板中,使用 **Providers → Cursor → Edit JSON**,保存,然后重启。旧的 `unsafeAllowNativeLocalExec: true` 仅在未设置 `nativeLocalExec` 时,才等同于 `nativeLocalExec: "on"`。MCP、屏幕录制和 computer use 由 `mcpServers` 和 `desktopExecutor` 单独控制。
260261

261262
每个 `mcpServers.<name>` 都可以接受 `command`(stdio)或 `url`(Streamable HTTP)。stdio 还接受 `args`、`env` 和 `cwd`;HTTP 接受 `headers`。两者都支持 `enabled`(默认 true)和 `toolPrefix`。`desktopExecutor` 接受 `computerUseCommand`、`recordScreenCommand`、`cwd`、`env` 和 `timeoutMs`(默认 `30000`)。命令通过 `sh -c` 执行,从 stdin 读取一个 JSON 请求,并且必须向 stdout 写入一个 JSON 结果。
262263

‎gui/src/components/provider-workspace/ProviderSettings.tsx‎

Lines changed: 30 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,11 @@ const EMPTY_MODELS: string[] = [];
2727
type ChoicesStatus = "idle" | "loading" | "ready" | "error";
2828
type PacingRule = { requestsPerMinute?: number; minIntervalMs?: number };
2929
type PacingStatus = { enabled: boolean; queued: number; nextSlotInMs: number; lastStartedAt?: number; lastModelId?: string };
30+
type CursorHttpVersion = "http2" | "http1.1";
31+
32+
function effectiveCursorHttpVersion(value: WorkspaceItem["upstreamHttpVersion"]): CursorHttpVersion {
33+
return value === "http1.1" || value === "h1" ? "http1.1" : "http2";
34+
}
3035

3136
function numberDraft(value: number | undefined): string { return value === undefined ? "" : String(value); }
3237
function positiveRpm(value: string): number | undefined {
@@ -67,6 +72,7 @@ export default function ProviderSettings({
6772
const initialAuth = String(item.authMode ?? (item.keyOptional ? "local" : "key"));
6873
const liveModelDiscoverySupported = providerSupportsLiveModelDiscovery(item.name, item);
6974
const savedLiveModels = liveModelDiscoverySupported ? item.liveModels !== false : false;
75+
const savedCursorHttpVersion = effectiveCursorHttpVersion(item.upstreamHttpVersion);
7076
const [adapter, setAdapter] = useState(item.adapter);
7177
const [baseUrl, setBaseUrl] = useState(item.baseUrl);
7278
const [defaultModel, setDefaultModel] = useState(item.defaultModel ?? "");
@@ -75,6 +81,7 @@ export default function ProviderSettings({
7581
const [note, setNote] = useState(item.note ?? "");
7682
const [allowPrivateNetwork, setAllowPrivateNetwork] = useState(item.allowPrivateNetwork ?? false);
7783
const [liveModels, setLiveModels] = useState(savedLiveModels);
84+
const [cursorHttpVersion, setCursorHttpVersion] = useState<CursorHttpVersion>(savedCursorHttpVersion);
7885
const [saving, setSaving] = useState(false);
7986
const [msg, setMsg] = useState<{ ok: boolean; text: string } | null>(null);
8087
const [accountMode, setAccountMode] = useState<"pool" | "direct">(item.codexAccountMode ?? "pool");
@@ -102,14 +109,15 @@ export default function ProviderSettings({
102109
setNote(item.note ?? "");
103110
setAllowPrivateNetwork(item.allowPrivateNetwork ?? false);
104111
setLiveModels(savedLiveModels);
112+
setCursorHttpVersion(savedCursorHttpVersion);
105113
setPacingEnabled(item.requestPacing?.enabled === true);
106114
setPacingRpm(numberDraft(item.requestPacing?.requestsPerMinute));
107115
setPacingDelay(numberDraft(item.requestPacing?.minIntervalMs));
108116
setPacingModels({ ...(item.requestPacing?.models ?? {}) });
109117
setMsg(null);
110118
setModeMsg(null);
111119
queueMicrotask(() => setEndpointChoice(matchChoiceId(baseUrlChoices, item.baseUrl)));
112-
}, [item.adapter, item.baseUrl, item.defaultModel, item.authMode, item.apiKeyTransport, item.keyOptional, item.note, item.allowPrivateNetwork, savedLiveModels, item.requestPacing, baseUrlChoices]);
120+
}, [item.adapter, item.baseUrl, item.defaultModel, item.authMode, item.apiKeyTransport, item.keyOptional, item.note, item.allowPrivateNetwork, savedLiveModels, savedCursorHttpVersion, item.requestPacing, baseUrlChoices]);
113121
/* eslint-enable react-hooks/set-state-in-effect */
114122

115123
// Account mode syncs on its own: a mode PATCH refresh must not reset an in-progress
@@ -185,7 +193,8 @@ export default function ProviderSettings({
185193
|| (adapter.trim() === "anthropic" && authMode === "key" && apiKeyTransport !== (item.apiKeyTransport ?? "x-api-key"))
186194
|| note.trim() !== (item.note ?? "")
187195
|| allowPrivateNetwork !== (item.allowPrivateNetwork ?? false)
188-
|| liveModels !== savedLiveModels;
196+
|| liveModels !== savedLiveModels
197+
|| (adapter.trim() === "cursor" && cursorHttpVersion !== savedCursorHttpVersion);
189198
const pacingDirty = pacingSignature(pacingDraft) !== pacingSignature(item.requestPacing);
190199
const formDirty = dirty || pacingDirty;
191200

@@ -242,6 +251,9 @@ export default function ProviderSettings({
242251
// Keep omitted legacy values omitted unless the user actually changes this toggle.
243252
// Otherwise an unrelated settings save manufactures `liveModels: true` provenance.
244253
if (liveModelDiscoverySupported && liveModels !== (item.liveModels !== false)) patch.liveModels = liveModels;
254+
if (adapter.trim() === "cursor" && cursorHttpVersion !== savedCursorHttpVersion) {
255+
patch.upstreamHttpVersion = cursorHttpVersion === "http1.1" ? "http1.1" : null;
256+
}
245257
if (supportsApiKeyTransport) patch.apiKeyTransport = apiKeyTransport;
246258
else if (item.apiKeyTransport !== undefined) patch.apiKeyTransport = "";
247259
}
@@ -287,7 +299,8 @@ export default function ProviderSettings({
287299
setAdapter(item.adapter); setBaseUrl(item.baseUrl);
288300
setDefaultModel(item.defaultModel ?? ""); setAuthMode(initialAuth);
289301
setApiKeyTransport(item.apiKeyTransport ?? "x-api-key");
290-
setNote(item.note ?? ""); setAllowPrivateNetwork(item.allowPrivateNetwork ?? false); setLiveModels(savedLiveModels); setMsg(null);
302+
setNote(item.note ?? ""); setAllowPrivateNetwork(item.allowPrivateNetwork ?? false); setLiveModels(savedLiveModels);
303+
setCursorHttpVersion(savedCursorHttpVersion); setMsg(null);
291304
setPacingEnabled(item.requestPacing?.enabled === true); setPacingRpm(numberDraft(item.requestPacing?.requestsPerMinute));
292305
setPacingDelay(numberDraft(item.requestPacing?.minIntervalMs)); setPacingModels({ ...(item.requestPacing?.models ?? {}) });
293306
setEndpointChoice(matchChoiceId(baseUrlChoices, item.baseUrl));
@@ -356,6 +369,20 @@ export default function ProviderSettings({
356369
<input className="input" value={baseUrl} onChange={e => setBaseUrl(e.target.value)} readOnly={plainBaseUrlLocked} disabled={plainBaseUrlLocked} />
357370
</label>
358371
)}
372+
{adapter.trim() === "cursor" && (
373+
<label className="pwi-settings-field">
374+
<span className="pwi-settings-label">{t("pws.cursorTransport")}</span>
375+
<select
376+
className="input"
377+
value={cursorHttpVersion}
378+
onChange={e => setCursorHttpVersion(e.target.value as CursorHttpVersion)}
379+
>
380+
<option value="http2">{t("pws.cursorTransportHttp2")}</option>
381+
<option value="http1.1">{t("pws.cursorTransportHttp1")}</option>
382+
</select>
383+
<span className="pwi-settings-hint">{t("pws.cursorTransportDesc")}</span>
384+
</label>
385+
)}
359386
<label className="pwi-settings-field">
360387
<span className="pwi-settings-label">{t("pws.cell.defaultModel")}</span>
361388
{modelOptions.length > 0 ? (

‎gui/src/components/provider-workspace/types.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,7 @@ export type ProviderUpdatePatch = {
9898
disabled?: boolean;
9999
allowPrivateNetwork?: boolean;
100100
liveModels?: boolean;
101+
upstreamHttpVersion?: "auto" | "http1.1" | "h1" | "http2" | "h2" | null;
101102
requestPacing?: WorkspaceItem["requestPacing"] | null;
102103
/** Dedicated field: the API PATCHes it alone for the canonical `openai` provider. */
103104
codexAccountMode?: "direct" | "pool";

‎gui/src/hooks/useJsonConfigEditor.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ import { useCallback, useEffect, useRef, useState } from "react";
33
export interface Config {
44
port: number;
55
defaultProvider: string;
6-
providers: Record<string, { adapter: string; baseUrl: string; hasApiKey?: boolean; hasHeaders?: boolean; defaultModel?: string; models?: string[]; liveModels?: boolean; reasoningWireFormat?: "gateway-object"; authMode?: string; keyOptional?: boolean; disabled?: boolean; note?: string; codexAccountMode?: "direct" | "pool" }>;
6+
providers: Record<string, { adapter: string; baseUrl: string; hasApiKey?: boolean; hasHeaders?: boolean; defaultModel?: string; models?: string[]; liveModels?: boolean; upstreamHttpVersion?: "auto" | "http1.1" | "h1" | "http2" | "h2"; reasoningWireFormat?: "gateway-object"; authMode?: string; keyOptional?: boolean; disabled?: boolean; note?: string; codexAccountMode?: "direct" | "pool" }>;
77
}
88

99
export function useJsonConfigEditor(deps: {

‎gui/src/hooks/useProviderAccountPools.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ import { oauthAccountDisplayLabel } from "../provider-workspace/auth";
77
export interface Config {
88
port: number;
99
defaultProvider: string;
10-
providers: Record<string, { adapter: string; baseUrl: string; hasApiKey?: boolean; hasHeaders?: boolean; defaultModel?: string; models?: string[]; liveModels?: boolean; authMode?: string; keyOptional?: boolean; disabled?: boolean; note?: string; codexAccountMode?: "direct" | "pool" }>;
10+
providers: Record<string, { adapter: string; baseUrl: string; hasApiKey?: boolean; hasHeaders?: boolean; defaultModel?: string; models?: string[]; liveModels?: boolean; upstreamHttpVersion?: "auto" | "http1.1" | "h1" | "http2" | "h2"; authMode?: string; keyOptional?: boolean; disabled?: boolean; note?: string; codexAccountMode?: "direct" | "pool" }>;
1111
}
1212

1313
export interface OAuthStatus { loggedIn: boolean; email?: string; error?: string; done?: boolean; needsReauth?: boolean; activeAccountId?: string | null }

‎gui/src/i18n/de.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1675,6 +1675,10 @@ export const de: Record<TKey, string> = {
16751675
"pws.allowPrivateNetwork": "Lokales/privates Netzwerk erlauben",
16761676
"pws.liveModels": "Modelle beim Anbieter erkennen",
16771677
"pws.liveModelsDesc": "Lädt den Live-Modellkatalog des Anbieters. Ausschalten, um nur konfigurierte statische Modelle zu verwenden.",
1678+
"pws.cursorTransport": "Cursor-Transport",
1679+
"pws.cursorTransportHttp2": "HTTP/2 (Standard)",
1680+
"pws.cursorTransportHttp1": "HTTP/1.1 (Proxy-Kompatibilität)",
1681+
"pws.cursorTransportDesc": "Verwenden Sie HTTP/1.1, wenn Ihr Proxy den HTTP/2-Stream von Cursor nicht zuverlässig überträgt.",
16781682
"pws.optionalPlaceholder": "Optional",
16791683
"pws.providerId": "Anbieter-ID",
16801684
"pws.reauth": "Erneute Anmeldung erforderlich",

‎gui/src/i18n/en.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1180,6 +1180,10 @@ export const en = {
11801180
"pws.allowPrivateNetwork": "Allow local/private network",
11811181
"pws.liveModels": "Discover models from provider",
11821182
"pws.liveModelsDesc": "Fetch the provider's live model catalog. Turn this off to use only configured/static models.",
1183+
"pws.cursorTransport": "Cursor transport",
1184+
"pws.cursorTransportHttp2": "HTTP/2 (default)",
1185+
"pws.cursorTransportHttp1": "HTTP/1.1 (proxy compatibility)",
1186+
"pws.cursorTransportDesc": "Use HTTP/1.1 when your proxy cannot reliably carry Cursor's HTTP/2 stream.",
11831187
"pws.optionalPlaceholder": "Optional",
11841188
"pws.providerId": "Provider ID",
11851189
"pws.reauth": "Needs re-auth",

0 commit comments

Comments
 (0)