dsh-gpt-adapter 0.2.3 → 0.2.4

package/README.md

@@ -12,6 +12,7 @@ Install one plugin to reuse local Codex instructions, skills, enabled plugin res
 
 - Discover upstream models with `GET /models` and retain stale entries until explicit cleanup.
 - Provide the GPT reasoning preset `low / medium / high / xhigh / max / ultra` through the native Models page and conversation menu.
+- Provide per-model Default, 516K, 1M, and Custom context windows, with the effective capacity and its source shown in settings.
 - Offer independent Standard and Fast speed choices. Fast sends `service_tier: "priority"`; Ultrafast requires an explicit upstream declaration or override.
 - Preserve optional function arguments on GPT Responses requests by setting missing `strict` values to `false`.
 - Read Codex instruction files and refresh them at the next model step without repeating unchanged baselines.
@@ -22,14 +23,14 @@ Reasoning and speed presets are requests to the configured gateway, not guarante
 
 ## Compatibility and installation
 
-The native integration targets DSH `0.2.2-rc.1`, Cordis `4.1.0`, and the pinned adapter source hash. The development dependency uses Pi AI `1.3.0`. Installed third-party package files are never edited. The published npm package is `dsh-gpt-adapter@0.2.3`.
+The native integration targets DSH `0.2.2-rc.1`, Cordis `4.1.0`, and the pinned adapter source hash. The development dependency uses Pi AI `1.3.0`. Installed third-party package files are never edited. The package version is `dsh-gpt-adapter@0.2.4`.
 
 Requires Node.js `>=24.9.0` and DSH. Source builds also require pnpm.
 
 Install the published package in the web profile:
 
 ```sh
-dsh plugin --profile web add dsh-gpt-adapter@0.2.3
+dsh plugin --profile web add dsh-gpt-adapter@0.2.4
 ```
 
 Restart the DSH host after installing or upgrading. Configure GPT connections under **Settings → Models**; Codex environment reuse is enabled by default. The plugin extends the existing native settings and conversation controls.
@@ -42,7 +43,7 @@ cd dsh-gpt-adapter
 pnpm install --frozen-lockfile
 mkdir -p artifacts
 pnpm pack --pack-destination artifacts
-dsh plugin --profile web add ./artifacts/dsh-gpt-adapter-0.2.3.tgz
+dsh plugin --profile web add ./artifacts/dsh-gpt-adapter-0.2.4.tgz
 ```
 
 `pnpm pack` runs the production build.
@@ -125,6 +126,27 @@ An empty `mcpAllowlist` imports all enabled declared servers. A nonempty list fi
 
 Capability precedence is user override, explicit upstream metadata, external catalog, then preset. Catalog requests never receive the provider API key. Model-list responses may omit capability metadata. Reasoning is sent as `reasoning.effort` for Responses and `reasoning_effort` for Chat Completions; the selected protocol is preserved.
 
+### Context windows
+
+Under **Settings → Models**, expand **Context window** in the provider's GPT adaptation section. Each managed GPT model has four choices:
+
+| Choice | Capacity in tokens |
+| --- | --- |
+| Default | Resolve automatically for this model and provider. |
+| 516K | `516000` |
+| 1M | `1000000` |
+| Custom | A positive safe integer entered by the user. |
+
+These use decimal units. The displayed capacity includes its source. Default uses a distinguishable explicit provider default, upstream model metadata, the configured capability catalog, the shipped exact-model preset, then the native catalog/DSH fallback. A native fallback is labeled as such. Shipped presets are dated data, not a live fetch from OpenAI: `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6.1-terra`, `gpt-6-luna`, and `gpt-5.4` use `1050000`; `gpt-4.1` uses `1047576`; `gpt-4o` uses `128000`. Only documented snapshot aliases share these presets. References and verification dates are in [the preset table](src/context-window.ts).
+
+Existing native per-model values, including catalog `modelOverrides`, and legacy JSON context overrides remain effective until deliberately edited. Saving a preset uses the native model field and clears only that model's legacy context override; Default removes both per-model overrides while retaining provider defaults and other settings. Saving unrelated settings or discovering models does not turn automatic values into manual overrides. Identical model IDs on different providers are independent. Saving Custom at a preset's exact value shows that preset after saving or reloading.
+
+Providers using native catalog `modelOverrides` keep their catalog configuration during synchronization. Discovery and stale cleanup update the plugin snapshot without creating an incompatible explicit `models` list or deleting native overrides.
+
+Native forms reject stale drafts when their automatic capacities change; refresh the form before retrying. The preset controls retain drafts across unrelated saves. If the same model changes, review its current value and use the keep-draft action before saving again.
+
+Changes apply to the next prepared call; calls already prepared retain their captured capacity. Model information, the inference model, overflow detection, and native compaction use the same effective window. Maximum output tokens and DSH's compaction policy remain independent. A larger local window does not increase the gateway's accepted limit.
+
 Preset reasoning fields are projected into the native UI rather than persisted into native model configuration. Disabling GPT adaptation restores the native model values and schema. Speed selections are persisted per session. Synchronization failures retain the previous snapshot; absent models remain stale until explicit cleanup.
 
 GPT model snapshots and speed selections are stored under `$DSH_HOME/storages/gpt-adapter`. Codex source files and imported MCP credentials are not copied there. The DSH host owns normal session transcripts and logs.

package/README.zh-CN.md

@@ -12,6 +12,7 @@
 
 - 通过 `GET /models` 发现上游模型；失效模型保留到用户主动清理。
 - 在原生模型设置页和对话菜单中提供 `low / medium / high / xhigh / max / ultra` 六档思考预设。
+- 为每个模型提供「默认、516K、1M、自定义」四档上下文窗口，展示实际容量与来源。
 - 提供独立的 Standard 和 Fast 速度选择。Fast 发送 `service_tier: "priority"`；Ultrafast 由上游明确声明或用户覆盖提供。
 - 为 GPT Responses 函数工具补齐缺失的 `strict: false`，保留可选参数。
 - 读取 Codex 指令，在下一模型步骤更新；内容不变时不重复注入。
@@ -22,14 +23,14 @@
 
 ## 兼容性与安装
 
-原生集成面向 DSH `0.2.2-rc.1`、Cordis `4.1.0`，并校验适配器源码指纹。开发依赖固定 Pi AI `1.3.0`。插件不会修改已安装的第三方包文件。当前 npm 发布版本为 `dsh-gpt-adapter@0.2.3`。
+原生集成面向 DSH `0.2.2-rc.1`、Cordis `4.1.0`，并校验适配器源码指纹。开发依赖固定 Pi AI `1.3.0`。插件不会修改已安装的第三方包文件。插件版本为 `dsh-gpt-adapter@0.2.4`。
 
 需要 Node.js `>=24.9.0` 和 DSH。源码构建另外需要 pnpm。
 
 在 `web` 配置档（profile）中安装已发布的 npm 包：
 
 ```sh
-dsh plugin --profile web add dsh-gpt-adapter@0.2.3
+dsh plugin --profile web add dsh-gpt-adapter@0.2.4
 ```
 
 安装或升级后重启 DSH 宿主。在「设置 → 模型」中配置 GPT 连接；Codex 环境复用默认开启。插件扩展现有原生设置与对话控件。
@@ -42,7 +43,7 @@ cd dsh-gpt-adapter
 pnpm install --frozen-lockfile
 mkdir -p artifacts
 pnpm pack --pack-destination artifacts
-dsh plugin --profile web add ./artifacts/dsh-gpt-adapter-0.2.3.tgz
+dsh plugin --profile web add ./artifacts/dsh-gpt-adapter-0.2.4.tgz
 ```
 
 `pnpm pack` 会自动执行生产构建。
@@ -125,6 +126,27 @@ codexCompatibility:
 
 能力优先级为用户覆盖、上游明确元数据、外部能力目录、预设。能力目录请求不携带提供商 API 密钥；模型列表可以不包含能力元数据。Responses 使用 `reasoning.effort`，Chat Completions 使用 `reasoning_effort`，保留用户选定的协议。
 
+### 上下文窗口
+
+在「设置 → 模型」中，展开提供商卡片的 GPT 自动适配区域内的「上下文窗口」，即可逐个模型设置：
+
+| 选项 | 容量（词元数） |
+| --- | --- |
+| 默认 | 根据当前模型与提供商自动解析。 |
+| 516K | `516000` |
+| 1M | `1000000` |
+| 自定义 | 用户输入的正安全整数。 |
+
+固定档使用十进制单位。界面展示实际容量和来源。「默认」依次采用可辨识的显式提供商默认值、上游模型元数据、已配置的能力目录、插件内置的精确模型预设、原生目录或 DSH 后备值；后备值会如实标注来源。内置预设是带核验日期的数据，不会实时抓取 OpenAI 页面：`gpt-6-astra`、`gpt-6.1-sol`、`gpt-6.1-terra`、`gpt-6-luna`、`gpt-5.4` 为 `1050000`，`gpt-4.1` 为 `1047576`，`gpt-4o` 为 `128000`；仅为有文档依据的快照别名复用预设。参考页面和核验日期见[预设表](src/context-window.ts)。
+
+已有原生模型数值（包括目录模型的 `modelOverrides`）和旧版 JSON 上下文覆盖继续生效，直到用户主动编辑。保存预设会使用原生模型字段，并仅清除该模型的旧版上下文覆盖；选择「默认」会删除两处逐模型覆盖，保留提供商默认值和其他设置。保存无关设置或发现模型不会把自动值固化为手动覆盖。同名模型在不同提供商下独立设置。自定义数值若恰好等于固定档，保存或重新加载后会显示对应固定档。
+
+使用原生目录 `modelOverrides` 的提供商在同步时保留目录配置。模型发现和失效清理只更新插件快照，不会生成不兼容的显式 `models` 列表，也不会删除原生覆盖。
+
+原生表单的自动容量变化后，过期草稿会被拒绝，刷新表单再保存即可。预设控件会在其他模型保存后保留草稿并续用新版本；同一模型发生变化时，先核对当前值，再点击「保留草稿继续编辑」后重新保存。
+
+修改对下一次准备的调用生效，已准备的调用继续使用原有容量。模型信息、推理模型、溢出判断和原生上下文压缩采用同一有效窗口；最大输出词元设置与 DSH 原生压缩策略保持独立。扩大本地窗口不会提高网关实际接受的上限。
+
 思考预设只投影到原生界面，不写入原生模型配置。关闭 GPT 自动适配后恢复原生值和参数结构。速度选择按会话持久化。同步失败保留旧快照，失效模型保留到主动清理。
 
 GPT 模型快照与速度选择保存在 `$DSH_HOME/storages/gpt-adapter`。Codex 源文件和导入的 MCP 凭证不会复制到该位置。正常会话记录和日志由 DSH 宿主管理。

package/dist/src/client/context-window.d.ts

@@ -0,0 +1,9 @@
+import { type ContextWindowResolution } from '../context-window.js';
+export declare function ContextWindowControl({ provider, modelId, value, revision, busy, save, }: {
+    provider: string;
+    modelId: string;
+    value: ContextWindowResolution;
+    revision: number;
+    busy: boolean;
+    save(args: Record<string, unknown>): Promise<boolean | undefined>;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/src/context-window.d.ts

@@ -0,0 +1,25 @@
+export type ContextWindowMode = 'default' | '516k' | '1m' | 'custom';
+export type ContextWindowSource = 'legacy-override' | 'native-user' | 'provider-default' | 'upstream' | 'capability-catalog' | 'official-preset' | 'native-default';
+export type ContextWindowResolution = {
+    mode: ContextWindowMode;
+    effectiveTokens: number;
+    defaultTokens: number;
+    source: ContextWindowSource;
+};
+export declare const OFFICIAL_CONTEXT_WINDOWS: Record<string, {
+    tokens: number;
+    url: string;
+    verifiedAt: string;
+}>;
+export declare function validContextWindow(value: unknown): value is number;
+export declare function contextWindowMode(tokens: number): ContextWindowMode;
+export declare function contextWindowTokens(mode: ContextWindowMode, customTokens?: number): number | undefined;
+export declare function resolveContextWindow(options: {
+    modelId: string;
+    legacy?: unknown;
+    native?: unknown;
+    providerDefault?: unknown;
+    upstream?: unknown;
+    catalog?: unknown;
+    nativeDefault?: unknown;
+}): ContextWindowResolution;

package/dist/src/host.d.ts

@@ -2,6 +2,8 @@ import { Service, type Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import { bindTypertRemote } from '@deepseek-ai/dsh-typert-protocol';
 import type { SessionId } from '@deepseek-ai/dsh-client-connection/client';
+import { type ContextWindowMode, type ContextWindowResolution } from './context-window.js';
+import { type ContextWindowEdit, type ContextWindowWriter } from './settings-overlay.js';
 import { type CodexCompatibilityConfig, type CodexCompatibilityRuntime } from './codex.js';
 import type { ModelCapabilities, ServiceTier } from './types.js';
 type RouteOptions = {
@@ -51,6 +53,7 @@ export declare class GptModels extends Service {
     private readonly options;
     private readonly settingsNs;
     codex?: CodexCompatibilityRuntime;
+    contextWriter: ContextWindowWriter | undefined;
     readonly typertRemote: ReturnType<typeof bindTypertRemote>;
     private readonly runners;
     private readonly snapshots;
@@ -85,12 +88,24 @@ export declare class GptModels extends Service {
         capabilities: {
             [x: string]: ModelCapabilities;
         };
+        contextWindows: {
+            [k: string]: ContextWindowResolution;
+        };
+        contextRevision: number;
         options: RouteOptions;
     };
     configure(provider: string, enabled: boolean): Promise<void>;
     updateOptions(provider: string, refreshIntervalMs: number, capabilityCatalogUrl: string, overridesJSON: string): Promise<void>;
     refresh(provider: string): Promise<void>;
     removeStale(provider: string): Promise<void>;
+    /** Resolve raw metadata separately from merged capabilities and cached overrides. */
+    contextWindow(provider: string, modelId: string, nativeDefault?: number): ContextWindowResolution;
+    contextWriteRevision(): number | undefined;
+    /** Public form revisions also cover changes to projected model capacities. */
+    private modelsRevision;
+    /** Remove only legacy context fields after the matching native save commits. */
+    clearLegacyContext(edits: ContextWindowEdit[], expected?: number): Promise<void>;
+    setContextWindow(provider: string, modelId: string, mode: ContextWindowMode, customTokens?: number, expectedRevision?: number): Promise<void>;
     setSpeed(sessionId: SessionId, provider: string, modelId: string, tier: ServiceTier): Promise<void>;
     speed(sessionId: SessionId, provider: string, modelId: string): {
         selected: ServiceTier;

package/dist/src/settings-overlay.d.ts

@@ -5,9 +5,21 @@ type SettingsLike = {
     write?: (ns: string, change: (current: any, base: any, schema: any) => any, expected?: number, paths?: string[][]) => Promise<void>;
 };
 export type CapabilityResolver = (provider: string, model: JsonObject, profile?: JsonObject) => ModelCapabilities | undefined;
-export declare function projectModel(provider: string, model: JsonObject, resolve: CapabilityResolver, profile?: JsonObject): JsonObject;
+export type ContextWindowEdit = {
+    provider: string;
+    modelId: string;
+    previousTokens: number | undefined;
+};
+type ContextWrites = {
+    revision(): number | undefined;
+    saved(edits: ContextWindowEdit[], revision: number | undefined): Promise<void>;
+};
+export type ContextWindowWriter = (provider: string, modelId: string, tokens: number | undefined, expected?: number) => Promise<void>;
+export declare function projectModel(provider: string, model: JsonObject, resolve: CapabilityResolver, profile?: JsonObject, includeContext?: boolean): JsonObject;
 /** A view of native configuration; the original object and its stored fields stay intact. */
 export declare function projectConfiguration(value: JsonObject | undefined, resolve: CapabilityResolver): JsonObject | undefined;
 /** Dispose returns the native settings page to its original schema and values. */
-export declare function installSettingsOverlay(settings: SettingsLike, resolve: CapabilityResolver): () => void;
+export declare function installSettingsOverlay(settings: SettingsLike, resolve: CapabilityResolver, contextWrites?: ContextWrites): (() => void) & {
+    setContextWindow: ContextWindowWriter;
+};
 export {};