dsh-gpt-adapter 0.0.0-stage → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lxjmaster
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,126 @@
-# Temporary Holding Version
+# DSH GPT Adapter
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![DSH plugin](https://img.shields.io/badge/DeepSeek%20Harness-plugin-2563eb)](https://github.com/deepseek-ai/deepseek-harness)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+English | [Simplified Chinese](README.zh-CN.md)
+
+A third-party DeepSeek Harness (DSH) plugin for GPT models and existing Codex environments.
+Install one plugin to reuse local Codex instructions, skills, enabled plugin resources, and MCP server configurations without moving or rewriting Codex files.
+
+## Features
+
+- 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.
+- 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.
+- Register Codex local skills and enabled plugin skills with their original resource paths.
+- Mount enabled Codex MCP servers through the official DSH MCP client and reconcile changed connections automatically.
+
+Reasoning and speed presets are requests to the configured gateway, not guarantees of upstream support. User overrides, explicit upstream capability metadata, and external catalogs take precedence over presets.
+
+## 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 package has not been published to npm.
+
+Requires Node.js `>=24.9.0` and pnpm.
+
+```sh
+git clone https://github.com/lxjmaster/dsh-gpt-adapter.git
+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.2.tgz
+```
+
+`pnpm pack` runs the production build. Restart the DSH host after upgrading the installed package.
+
+## Automated releases
+
+The `Release` workflow runs on pushes to `main` and manual dispatches. For a formal `X.Y.Z` version, it runs the test suite, creates `vX.Y.Z`, creates the matching GitHub Release, and publishes the package to npm. Prerelease versions are skipped, and existing tags or npm versions are reused safely.
+
+Add an npm access token as the repository secret `NPM_TOKEN` before the first release.
+Configure GPT connections as usual under **Settings → Models**. The plugin extends the existing native settings and conversation controls.
+
+## Codex environment reuse
+
+Codex compatibility is enabled by default. The root is the plugin's `codexHome` override, then `CODEX_HOME`, then `~/.codex`.
+
+| Resource                       | Behavior                                                                                                                                          |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `config.toml`                  | Read user configuration in place, then trusted project `.codex/config.toml` layers from repository root to cwd; connection secrets stay in memory |
+| Global instructions            | First nonempty `AGENTS.override.md`, otherwise `AGENTS.md`                                                                                        |
+| Project instructions           | Repository root to current DSH working directory; first nonempty override, base file, or configured fallback per directory                        |
+| DSH/shared global instructions | Retained from `~/.dsh/AGENTS.md` and `~/.agents/AGENTS.md` (or their configured environment roots)                                                |
+| Local overlays                 | Existing `AGENTS.local.md` and `CLAUDE.local.md` remain applicable                                                                                |
+| Codex skills                   | Discover `skills/` and `skills/.system/`; bodies load on demand                                                                                   |
+| Shared/project skills          | Retain native discovery and include `.agents/skills` at every directory from cwd to repository root; nearer project skills take precedence        |
+| Skill enablement               | Honor ordered `skills.config` name/path selectors and `skills.bundled.enabled`                                                                    |
+| Enabled plugins                | Read declared skill roots and inline or file-referenced `mcpServers`; disabled plugins stay disabled                                              |
+
+The compatibility layer reads project instructions through DSH's filesystem, selects candidates using Codex precedence, and replaces native messages only for covered scopes. Additional nested instruction updates remain applicable. It does not import Codex's built-in system prompt. Configured fallback filenames such as `CLAUDE.md` are used only when supplied in Codex configuration. Instructions are recorded as ordinary user context with a bounded byte budget, including an explicit zero budget; they do not override system, developer, or direct user instructions. Existing conversation history is retained when the plugin is removed.
+
+Plugin resources are resolved from the configured local marketplace, or the newest locally cached version in the matching marketplace. Nothing is downloaded automatically. Plugin skills use `<plugin>-<skill>` names to fit DSH's skill-name format and avoid cross-plugin collisions. Original skill paths and relative resources remain intact.
+
+## MCP compatibility
+
+The plugin automatically starts enabled MCP commands and connects configured HTTP endpoints for each Agent session. It imports `mcp_servers` and the MCP resources declared by enabled plugins. Trusted project overrides apply within that Agent's scope; concurrent sessions do not share imported tool registrations. Untrusted project configuration is skipped.
+
+Supported configuration includes:
+
+- stdio `command`, `args`, `cwd`, `env`, and `env_vars`;
+- Streamable HTTP `url`, `http_headers`, `env_http_headers`, and `bearer_token_env_var`;
+- `enabled`, startup/tool timeouts, `enabled_tools`, and `disabled_tools`;
+- plugin-root substitutions in plugin server declarations.
+
+Global server names are retained where DSH permits them. Plugin servers use a plugin prefix. Unchanged connections are preserved. Changed or removed connections are disposed before replacement. Invalid configuration retains the last working snapshot, including individually invalid server entries. With automatic refresh enabled, failed startup retries with exponential backoff for up to ten attempts; a manual refresh resets that budget. The default two-second refresh detects configuration and plugin-resource changes; native skill watchers detect skill file changes.
+
+Credentials are not copied into DSH settings, plugin caches, or this repository. Status responses contain only resource names, states, and sanitized reason codes. Missing environment variables must exist in the DSH host environment to be inherited.
+
+This is environment compatibility, not a replacement Codex runtime. Codex OAuth/keychain sessions, Codex App IPC services, hooks, app components, permission policies, and proprietary commands are not automatically reproduced. Standard MCPs using configured headers/environment can be reused; servers requiring unavailable runtime authentication or services report a connection failure. Plugin hooks/apps/commands are reported as unsupported rather than executed. DSH retains its own approval and sandbox behavior.
+
+Inspect status through the authenticated host method `gptModels/codexStatus`; use `gptModels/refreshCodex` to request a configuration refresh. Resource states are `loading`, `loaded`, `disabled`, `unsupported`, or `failed`. A loaded MCP entry means its initial connection and tool discovery completed; subsequent reconnection is managed by DSH.
+
+## Optional controls
+
+No per-server reconfiguration is needed. The existing `gpt-adapter` plugin settings also expose:
+
+```yaml
+codexCompatibility:
+  enabled: true
+  # codexHome: /path/to/existing/codex-home
+  importInstructions: true
+  importSkills: true
+  importMcpServers: true
+  importPluginResources: true
+  watch: true
+  pollIntervalMs: 2000
+  mcpAllowlist: []
+```
+
+An empty `mcpAllowlist` imports all enabled declared servers. A nonempty list filters by the original server key. Disabling or removing the plugin withdraws its runtime registrations and leaves Codex files untouched. Native DSH model configuration and other plugins remain in place.
+
+## GPT model controls and storage
+
+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.
+
+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.
+
+## Development
+
+```sh
+pnpm install --frozen-lockfile
+pnpm check
+pnpm test
+pnpm build
+```
+
+Tests use temporary directories, synthetic credentials, simulated upstream streams, and a real local fixture MCP process. They do not establish real-account support, upstream reasoning quality, external MCP authentication, or Codex App runtime availability.
+
+## License
+
+[MIT](LICENSE). See [third-party notices](THIRD_PARTY_NOTICES.md) for reused DeepSeek Harness assets. This project is independently maintained and is not affiliated with DeepSeek or OpenAI.

package/README.zh-CN.md

@@ -0,0 +1,126 @@
+# DSH GPT Adapter
+
+[![DSH 插件](https://img.shields.io/badge/DeepSeek%20Harness-plugin-2563eb)](https://github.com/deepseek-ai/deepseek-harness)
+[![MIT 许可证](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+[英文版](README.md) | 简体中文
+
+面向 DeepSeek Harness（DSH）的第三方 GPT 模型与 Codex 环境兼容插件。
+安装一个插件，即可直接读取原有 Codex 指令、技能、已启用插件资源及 MCP 服务器配置，无需移动或改写 Codex 文件。
+
+## 功能
+
+- 通过 `GET /models` 发现上游模型；失效模型保留到用户主动清理。
+- 在原生模型设置页和对话菜单中提供 `low / medium / high / xhigh / max / ultra` 六档思考预设。
+- 提供独立的 Standard 和 Fast 速度选择。Fast 发送 `service_tier: "priority"`；Ultrafast 由上游明确声明或用户覆盖提供。
+- 为 GPT Responses 函数工具补齐缺失的 `strict: false`，保留可选参数。
+- 读取 Codex 指令，在下一模型步骤更新；内容不变时不重复注入。
+- 挂载 Codex 本地技能和已启用插件技能，保持原始资源路径。
+- 通过 DSH 官方 MCP 客户端挂载 Codex 已启用服务器，并自动对账连接变化。
+
+思考和速度预设代表发往网关的请求，不保证所有上游都支持。用户覆盖、上游明确的能力元数据和外部能力目录优先于预设。
+
+## 兼容性与安装
+
+原生集成面向 DSH `0.2.2-rc.1`、Cordis `4.1.0`，并校验适配器源码指纹。开发依赖固定 Pi AI `1.3.0`。插件不会修改已安装的第三方包文件，目前未发布到 npm。
+
+需要 Node.js `>=24.9.0` 和 pnpm。
+
+```sh
+git clone https://github.com/lxjmaster/dsh-gpt-adapter.git
+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.2.tgz
+```
+
+`pnpm pack` 会自动执行生产构建。升级安装包后重启 DSH 宿主。
+
+## 自动发布
+
+`Release` 工作流会在推送到 `main` 或手动运行时执行。版本号为正式的 `X.Y.Z` 时，工作流会运行测试、创建 `vX.Y.Z` 标签、创建对应的 GitHub Release，并将包发布到 npm。预发布版本会跳过；已有标签或 npm 版本会安全复用。
+
+首次发布前，请在仓库 Secrets 中添加 npm 访问令牌 `NPM_TOKEN`。
+在「设置 → 模型」中照常配置 GPT 连接；插件扩展现有原生设置与对话控件。
+
+## 复用 Codex 环境
+
+默认启用 Codex 兼容。目录优先级为插件的 `codexHome` 覆盖、`CODEX_HOME` 环境变量、`~/.codex`。
+
+| 资源               | 行为                                                                                                |
+| ------------------ | --------------------------------------------------------------------------------------------------- |
+| `config.toml`      | 原地读取用户配置，再从仓库根到当前目录叠加受信任项目的 `.codex/config.toml`；连接凭证只保存在内存中 |
+| 全局指令           | 优先读取非空 `AGENTS.override.md`，否则读取 `AGENTS.md`                                             |
+| 项目指令           | 从仓库根到 DSH 当前工作目录，逐级选择首个非空的覆盖文件、基础文件或已配置后备文件                   |
+| DSH 与共享全局指令 | 保留 `~/.dsh/AGENTS.md` 与 `~/.agents/AGENTS.md`，也支持对应环境变量指定的目录                      |
+| 本地覆盖文件       | 保留 `AGENTS.local.md` 与 `CLAUDE.local.md`                                                         |
+| Codex 技能         | 发现 `skills/` 和 `skills/.system/`，正文按需加载                                                   |
+| 共享与项目技能     | 保留原生发现机制，并补齐当前目录到仓库根每一级 `.agents/skills`；更近的项目技能优先                 |
+| 技能开关           | 遵循有序的 `skills.config` 名称/路径选择器，以及 `skills.bundled.enabled`                           |
+| 已启用插件         | 读取声明的技能目录和内联或文件引用形式的 `mcpServers`；禁用插件不加载                               |
+
+兼容层通过 DSH 文件系统读取项目指令，按 Codex 优先级选择候选文件，只替换已覆盖作用域内的原生指令消息；额外发现的子目录指令更新仍然保留。它不会导入 Codex 内置系统提示词。`CLAUDE.md` 等后备文件仅在 Codex 配置明确声明时使用。指令以有字节预算的普通用户上下文写入会话，明确配置的零预算也会生效；指令不覆盖系统、开发者或用户直接指令。移除插件不会删除已有会话历史。
+
+插件资源优先来自已配置的本地市场目录，否则使用匹配市场中最新的本地缓存版本，不会自动下载。插件技能使用 `<插件名>-<技能名>`，以符合 DSH 命名格式并避免跨插件冲突。技能原始路径和相对资源引用保持不变。
+
+## MCP 兼容
+
+插件会为每个会话代理（Agent）自动启动已启用的 MCP 命令并连接已配置的 HTTP 端点。导入来源包括 `mcp_servers` 和已启用插件声明的 MCP 资源。受信任项目的覆盖配置只在该会话代理的作用域内生效，并行会话不会共用导入工具的注册；未受信任项目的配置会跳过。
+
+支持的配置包括：
+
+- 标准输入输出连接的 `command`、`args`、`cwd`、`env`、`env_vars`；
+- 流式 HTTP 连接的 `url`、`http_headers`、`env_http_headers`、`bearer_token_env_var`；
+- `enabled`、启动/工具超时、`enabled_tools`、`disabled_tools`；
+- 插件服务器声明中的插件根目录变量替换。
+
+全局服务器名称在 DSH 允许时原样保留，插件服务器增加插件名前缀。未变化的连接继续复用；变更或删除的连接先卸载再替换。配置损坏时保留上一份有效快照，单个服务器配置无效时也会保留其可用连接。开启自动刷新时，启动失败会按指数退避间隔重试，最多尝试十次；手动刷新会重置次数。默认每两秒检查配置与插件资源变化，技能文件变化由原生监视器处理。
+
+凭证不会复制到 DSH 设置、插件缓存或本仓库。状态接口只返回资源名、状态和经过脱敏的原因代码。需要继承的环境变量必须存在于 DSH 宿主环境中。
+
+本插件提供环境兼容，不会重新实现 Codex 运行时。Codex 的 OAuth/钥匙串会话、App 专属进程通信服务、Hooks、应用组件、权限策略和专用命令不会自动重现。使用配置中的请求头或环境变量认证的标准 MCP 可以复用；依赖缺失认证或运行时服务的服务器会报告连接失败。插件的 Hooks、应用和命令明确标为不支持，不会自动执行。审批和沙箱仍由 DSH 自身管理。
+
+通过已认证的宿主方法 `gptModels/codexStatus` 查看状态，使用 `gptModels/refreshCodex` 请求刷新。资源状态为 `loading`（加载中）、`loaded`（已加载）、`disabled`（已禁用）、`unsupported`（不支持）或 `failed`（失败）。MCP 的已加载状态表示首次连接和工具发现已完成，后续重连由 DSH 管理。
+
+## 可选控制项
+
+无需逐个服务器重复配置。现有 `gpt-adapter` 插件设置还提供以下控制项：
+
+```yaml
+codexCompatibility:
+  enabled: true
+  # codexHome: /path/to/existing/codex-home
+  importInstructions: true
+  importSkills: true
+  importMcpServers: true
+  importPluginResources: true
+  watch: true
+  pollIntervalMs: 2000
+  mcpAllowlist: []
+```
+
+空 `mcpAllowlist` 表示导入所有已启用的声明服务器；非空列表按原始服务器名筛选。禁用或移除插件会撤销它拥有的运行时注册，不改动 Codex 文件。原生 DSH 模型配置与其他插件保留。
+
+## GPT 模型控制与存储
+
+能力优先级为用户覆盖、上游明确元数据、外部能力目录、预设。能力目录请求不携带提供商 API 密钥；模型列表可以不包含能力元数据。Responses 使用 `reasoning.effort`，Chat Completions 使用 `reasoning_effort`，保留用户选定的协议。
+
+思考预设只投影到原生界面，不写入原生模型配置。关闭 GPT 自动适配后恢复原生值和参数结构。速度选择按会话持久化。同步失败保留旧快照，失效模型保留到主动清理。
+
+GPT 模型快照与速度选择保存在 `$DSH_HOME/storages/gpt-adapter`。Codex 源文件和导入的 MCP 凭证不会复制到该位置。正常会话记录和日志由 DSH 宿主管理。
+
+## 开发
+
+```sh
+pnpm install --frozen-lockfile
+pnpm check
+pnpm test
+pnpm build
+```
+
+测试使用临时目录、合成凭证、模拟上游流，以及真实的本地测试 MCP 进程；不证明真实账户能力、上游思考质量、外部 MCP 认证或 Codex App 运行时可用性。
+
+## 许可证
+
+采用 [MIT 许可证](LICENSE)。复用的 DeepSeek Harness 资源见[第三方声明](THIRD_PARTY_NOTICES.md)。本项目独立维护，与 DeepSeek、OpenAI 无隶属关系。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,33 @@
+# Third-party notices
+
+The plugin uses the native adapter, model menu, and Models settings components
+from the pinned `@deepseek-ai/dsh-llm-pi-ai`,
+`@deepseek-ai/dsh-client-ui-model-selection`, and
+`@deepseek-ai/dsh-client-ui-settings-models`, and `@deepseek-ai/dsh-mcp-client` version `0.2.2-rc.1` packages.
+Original project: https://github.com/deepseek-ai/deepseek-harness
+
+The build records native source hashes and reads native Models CSS class names.
+The runtime extends the native adapter and injects controls into existing UI
+slots. MCP tool filtering uses the pinned client’s public tool-name encoding. Installed third-party package files are never modified.
+
+## DeepSeek Harness — MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# Extend the existing native adapter and UI; preserve official profile entries.
+- insert:
+    - id: gpt-adapter
+      name: dsh-gpt-adapter
+      config:
+        routes: {}
+        codexCompatibility:
+          enabled: true

package/dist/src/bridge.d.ts

@@ -0,0 +1,10 @@
+import type { ModelCapabilities, PreparedGptRequest, RequestSelection, SyncSnapshot } from './types.js';
+/** Host-facing bridge kept small so it can be implemented against DSH's adapter seam. */
+export type GptCapabilityProvider = {
+    currentSnapshot(): SyncSnapshot | undefined;
+    resolveCapabilities(modelId: string): ModelCapabilities | undefined;
+};
+export type GptRequestBridge = {
+    prepare(selection: RequestSelection): PreparedGptRequest;
+};
+export declare function createRequestBridge(provider: GptCapabilityProvider): GptRequestBridge;

package/dist/src/capabilities.d.ts

@@ -0,0 +1,14 @@
+import type { ModelCapabilities, ModelOverride, ReasoningChoice, ServiceTier, ServiceTierChoice, UpstreamModel } from './types.js';
+/**
+ * Baseline catalog for known GPT families. This data is deliberately separate
+ * from `/models`: the upstream list identifies models but does not guarantee
+ * complete reasoning or service-tier metadata.
+ */
+export declare const GPT_REASONING_LEVELS: readonly ["low", "medium", "high", "xhigh", "max", "ultra"];
+export declare function isGptModel(model: UpstreamModel): boolean;
+export declare function resolveCapabilities(model: UpstreamModel, revision: string, override?: ModelOverride): ModelCapabilities;
+export declare function mergeCapabilities(capabilities: ModelCapabilities, override: ModelOverride | undefined, revision: string): ModelCapabilities;
+export declare function capabilityForSelection(capabilities: ModelCapabilities, reasoningId: string | null | undefined, serviceTier: ServiceTier | undefined): {
+    reasoning?: ReasoningChoice;
+    serviceTier: ServiceTierChoice;
+};

package/dist/src/client/compat-slots.d.ts

@@ -0,0 +1,15 @@
+import type { ConnectionHandle, SessionId } from '@deepseek-ai/dsh-client-connection/client';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        'conversation.input.left': {
+            kind: 'list';
+            scope: 'session';
+        };
+    }
+    interface SessionStandardProps {
+        sessionId: SessionId;
+    }
+}
+export type ClientContext = import('@deepseek-ai/cordis').Context & {
+    connection: ConnectionHandle;
+};

package/dist/src/client/index.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/dist/src/codex-config.d.ts

@@ -0,0 +1,67 @@
+export type JsonObject = Record<string, any>;
+export type CompatibilityItem = {
+    name: string;
+    kind: 'config' | 'plugin' | 'mcp' | 'instructions' | 'skills';
+    state: 'loading' | 'loaded' | 'disabled' | 'unsupported' | 'failed';
+    reason?: string;
+};
+export type CodexMcpConfig = {
+    serverName: string;
+    source: string;
+    transport: 'stdio' | 'streamable-http';
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+    startupTimeoutMs: number;
+    toolCallTimeoutMs: number;
+    enabledTools?: string[];
+    disabledTools: string[];
+};
+export type SkillRoot = {
+    path: string;
+    plugin?: string;
+    pluginId?: string;
+};
+export type CodexSnapshot = {
+    config: JsonObject;
+    mcp: CodexMcpConfig[];
+    skillRoots: SkillRoot[];
+    items: CompatibilityItem[];
+};
+export declare const object: (v: unknown) => JsonObject;
+export declare const strings: (v: unknown) => string[];
+export declare function resolveCodexHome(configured?: string): string;
+export declare function optionalText(path: string): Promise<string | undefined>;
+/** Minimal execution-world filesystem used by project readers. */
+export type ProjectFileSystem = {
+    resolve(path: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<any>;
+    stat(target: any, signal?: AbortSignal): Promise<unknown>;
+    readText(target: any, signal?: AbortSignal): Promise<string>;
+};
+export declare function projectText(path: string, fs?: ProjectFileSystem, signal?: AbortSignal): Promise<string | undefined>;
+/** Repository root to cwd; without a repository only cwd participates. */
+export declare function projectDirectories(cwd: string, fs?: ProjectFileSystem, signal?: AbortSignal): Promise<string[]>;
+export declare function readCodexConfig(home: string, cwd?: string, fs?: ProjectFileSystem, signal?: AbortSignal): Promise<JsonObject>;
+export declare function normalizeCodexMcp(name: string, value: unknown, source: string, base: string, environment?: NodeJS.ProcessEnv): CodexMcpConfig | undefined;
+export declare function discoverCodexSnapshot(home: string, options: {
+    importPluginResources: boolean;
+    mcpAllowlist: string[];
+}, context?: {
+    cwd?: string;
+    fs?: ProjectFileSystem;
+    signal?: AbortSignal;
+    previous?: CodexSnapshot;
+}): Promise<CodexSnapshot>;
+export declare function skillEnabled(config: JsonObject, skill: {
+    name: string;
+    path?: string;
+}, plugin?: string): boolean;
+export declare function skillEnabledWithFs(config: JsonObject, skill: {
+    name: string;
+    path?: string;
+}, plugin: string | undefined, fs: ProjectFileSystem, signal?: AbortSignal): Promise<boolean>;

package/dist/src/codex-instructions.d.ts

@@ -0,0 +1,9 @@
+import { type JsonObject, type ProjectFileSystem } from './codex-config.js';
+export type CodexInstructionFile = {
+    path: string;
+    content: string;
+};
+export declare function loadCodexInstructions(home: string, cwd: string, config: JsonObject, dshHome?: string, agentsHome?: string, fs?: ProjectFileSystem, signal?: AbortSignal): Promise<CodexInstructionFile[]>;
+export declare function renderCodexInstructions(files: CodexInstructionFile[], maxBytes?: number): string;
+/** A logged user-message baseline, never an unlogged mutation of LLM requests. */
+export declare function installCodexInstructions(ctx: any, home: string): void;

package/dist/src/codex.d.ts

@@ -0,0 +1,24 @@
+import { type CompatibilityItem } from './codex-config.js';
+export type CodexCompatibilityConfig = {
+    enabled: boolean;
+    codexHome?: string;
+    importInstructions: boolean;
+    importSkills: boolean;
+    importMcpServers: boolean;
+    importPluginResources: boolean;
+    watch: boolean;
+    pollIntervalMs: number;
+    mcpAllowlist: string[];
+};
+export type CodexCompatibilityRuntime = {
+    status(): {
+        enabled: boolean;
+        refreshing: boolean;
+        items: CompatibilityItem[];
+    };
+    refresh(): Promise<void>;
+    dispose(): Promise<void>;
+};
+export declare function installCodexCompatibility(ctx: any, config: CodexCompatibilityConfig): CodexCompatibilityRuntime;
+export { discoverCodexSnapshot, normalizeCodexMcp, readCodexConfig, resolveCodexHome, } from './codex-config.js';
+export { loadCodexInstructions, renderCodexInstructions, } from './codex-instructions.js';

package/dist/src/host.d.ts

@@ -0,0 +1,111 @@
+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 CodexCompatibilityConfig, type CodexCompatibilityRuntime } from './codex.js';
+import type { ModelCapabilities, ServiceTier } from './types.js';
+type RouteOptions = {
+    enabled: boolean;
+    refreshIntervalMs: number;
+    capabilityCatalogUrl?: string;
+    overridesJSON: string;
+};
+export type PluginConfig = {
+    routes: Record<string, RouteOptions>;
+    codexCompatibility?: Partial<CodexCompatibilityConfig>;
+};
+export declare const name = "gpt-adapter";
+export declare const inject: string[];
+export declare const Config: z<PluginConfig, {
+    routes: {
+        get(): PluginConfig['routes'];
+    };
+    codexCompatibility: CodexCompatibilityConfig;
+}>;
+type BaseModelInfo = {
+    provider: string;
+    id: string;
+    name: string;
+    reasoning?: unknown;
+    [key: string]: unknown;
+};
+type NativeRequest = {
+    reasoningEffort?: string;
+    sessionId?: string;
+};
+export type NativeExtension = {
+    model: BaseModelInfo;
+    preserveReasoning?: boolean;
+    prepare(options: NativeRequest): {
+        payload: Record<string, unknown>;
+        observe(event: unknown): void;
+    };
+};
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        gptModels: GptModels;
+    }
+}
+/** Source-mode Remote markers are consumed by the existing authenticated Gateway. */
+export declare class GptModels extends Service {
+    private readonly options;
+    private readonly settingsNs;
+    codex?: CodexCompatibilityRuntime;
+    readonly typertRemote: ReturnType<typeof bindTypertRemote>;
+    private readonly runners;
+    private readonly snapshots;
+    private readonly speeds;
+    private readonly results;
+    private readonly store;
+    private readonly nativeDescribe;
+    private closed;
+    private speedWrites;
+    constructor(ctx: Context, options: PluginConfig, settingsNs: string);
+    initialize(): Promise<void>;
+    private configuredProfiles;
+    private routeOptions;
+    enabledProviders(): string[];
+    private startRunner;
+    private profile;
+    private routeConfig;
+    private publish;
+    codexStatus(): {
+        enabled: boolean;
+        refreshing: boolean;
+        items: import("./codex-config.js").CompatibilityItem[];
+    };
+    refreshCodex(): Promise<void>;
+    status(provider: string): {
+        enabled: boolean;
+        status: import("./runtime.js").SyncStatus;
+        models: {
+            id: string;
+            stale: boolean;
+        }[];
+        capabilities: {
+            [x: string]: ModelCapabilities;
+        };
+        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>;
+    setSpeed(sessionId: SessionId, provider: string, modelId: string, tier: ServiceTier): Promise<void>;
+    speed(sessionId: SessionId, provider: string, modelId: string): {
+        selected: ServiceTier;
+        last: {
+            requested: string;
+            actual?: string;
+        } | null;
+    };
+    /** The same effective capability supplies the native settings page and requests. */
+    capability(provider: string, modelId: string, displayName?: string, profileOverride?: {
+        api?: string;
+        reasoning?: string;
+    }): ModelCapabilities | undefined;
+    /** Capture request controls for the version-checked native runtime extension. */
+    capture(provider: string, modelId: string, base: BaseModelInfo): NativeExtension | undefined;
+}
+export declare function apply(ctx: Context, config: ReturnType<typeof Config>): Promise<void>;
+export {};

package/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './capabilities.js';
+export * from './sync.js';
+export * from './bridge.js';
+export * from './runtime.js';
+export * from './storage.js';

package/dist/src/native-adapter.d.ts

@@ -0,0 +1,18 @@
+import type { NativeExtension } from './host.js';
+type Snapshot = {
+    profiles: Map<string, Record<string, any>>;
+    models: {
+        stream(model: any, context: any, options: any): any;
+        [key: string]: any;
+    };
+};
+type NativeAdapter = {
+    current(): Snapshot;
+    modelInfo(snapshot: Snapshot, provider: string, model: string): any;
+    streamWithSnapshot(options: any, snapshot: Snapshot): AsyncIterable<any>;
+    prepareCall(provider: string, model: string, signal?: AbortSignal): Promise<any>;
+    stream(options: any): AsyncIterable<any>;
+};
+/** Install a disposable extension without replacing the host's plugin entries. */
+export declare function installNativeAdapterBridge(prototype: NativeAdapter, capture: (provider: string, model: string, base: any) => NativeExtension | undefined): () => void;
+export {};

package/dist/src/runtime.d.ts

@@ -0,0 +1,27 @@
+import { type FetchLike } from './sync.js';
+import type { SyncConfig, SyncSnapshot } from './types.js';
+export type SyncStatus = {
+    state: 'idle' | 'refreshing' | 'ready' | 'error' | 'stopped';
+    error?: string;
+    fetchedAt?: string;
+};
+/** Owns exactly one route: single-flight refresh, bounded I/O, and disposal. */
+export declare class ModelSynchronizer {
+    private readonly readConfig;
+    private readonly publish;
+    private readonly fetchImpl;
+    private snapshot;
+    private pending;
+    private timer;
+    private abort;
+    private stopped;
+    private started;
+    private status;
+    constructor(readConfig: () => Promise<SyncConfig>, publish: (snapshot: SyncSnapshot) => Promise<void>, fetchImpl?: FetchLike, initial?: SyncSnapshot);
+    current(): SyncSnapshot | undefined;
+    getStatus(): SyncStatus;
+    start(): void;
+    refresh(): Promise<SyncSnapshot>;
+    removeStale(ids: readonly string[]): Promise<SyncSnapshot>;
+    dispose(): void;
+}