@shuind/dsh-codex-harness 0.1.9 → 0.1.11

package/LICENSE

@@ -1,21 +1,21 @@
-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.
+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/README.md

@@ -1,17 +1,32 @@
 # @shuind/dsh-codex-harness
 
-给 DSH 接入 Codex 风格 GPT 模型的轻量插件。
+给 DSH 接入 Codex 风格 GPT 模型的插件。
 
-DSH 继续负责会话、文件系统、Shell、Skills 和插件扩展；本包只提供 Codex 的基础提示词与工具协议。
+选择 `Codex 模式` 时，本包复用用户在 DSH 中已经配置的模型，只增加 Codex 体验层：
+
+- 检测用户配置的 GPT 系列模型；
+- 为未声明能力的 GPT 模型补充可选思考强度（`low`、`medium`、`high`、`xhigh`、`max`）；
+- 为未声明能力的 GPT 模型默认补充文本和图片输入；
+- 默认优先把 GPT Responses 请求中的 `web_search` 改为远程 hosted tool；失败时回退到保留的 DSH `web_search` function tool；
+- 默认优先调用远程 `/responses/compact`，并把返回的原生 compaction item 在后续 Responses 请求中恢复；失败时回退到保留的 DSH 本地 compaction；
+- 继续提供 Codex 的 `exec_command`、`write_stdin`、`apply_patch` 和 `update_plan`。
+
+DSH 的通用 `@deepseek-ai/dsh-llm-pi-ai` 继续负责用户配置的 provider、Responses 中转地址、API key、实际模型请求和图片附件传输。本插件不会创建新的 `openai-codex` route，也不会覆盖用户的 endpoint 或凭据。
 
 ## 安装
 
 ```sh
-dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.9
+dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.10
 ```
 
 重启 Web，创建新会话，在模式菜单中选择 `Codex 模式`。
 
+## 中转站配置
+
+请继续在 DSH 的 Models/`llm-pi-ai` 配置中填写你的 Responses 中转站地址、API key 和模型。例如 provider 下配置 `api: openai-responses`、`baseURL`、`apiKeyEnv`，并在 `models` 中填写中转站实际支持的 GPT 模型 id。Codex 模式不会替换这些配置。
+
+插件只会把缺少 `input` 或 `reasoningEfforts` 的 GPT 模型配置补成图片和思考强度能力；如果用户已经显式配置了这些字段，则保持用户配置不变。不同中转站对 GPT 模型名、图片格式、reasoning 参数和 hosted `web_search`/`responses/compact` 的支持程度不同，远程请求失败时会回退到 DSH 本地实现。
+
 如果之前安装过旧包，先移除旧包，并把旧的 Codex preset 目录备份后再重启：
 
 ```sh
@@ -19,7 +34,7 @@ dsh plugin --profile web remove @shuind/dsh-codex
 mv "$DSH_HOME/.agent-presets/codex" "$DSH_HOME/.agent-presets/codex.old"
 ```
 
-安装器会把随包提供的 preset 写入 `$DSH_HOME/.agent-presets/codex`，不会覆盖已有目录。
+安装器会把随包提供的 preset 写入 `$DSH_HOME/.agent-presets/codex`，不会覆盖已有目录。升级已有安装时，请先备份并移除旧的 `codex` preset 目录，再重启 Web，让新版本安装包含压缩组的 preset。
 
 ## 提供的工具
 
@@ -28,11 +43,11 @@ mv "$DSH_HOME/.agent-presets/codex" "$DSH_HOME/.agent-presets/codex.old"
 - `apply_patch`
 - `update_plan`
 
-工具名称、参数和结果格式兼容 Codex。Skills、文件系统策略、Shell、Terminal 等能力仍通过 DSH 的可插拔扩展提供。
+工具名称、参数和结果格式兼容 Codex。模型、思考强度、图片和搜索能力通过 DSH 的 LLM、附件和 Web seam 提供，Skills、文件系统策略、Shell、Terminal 等能力仍通过 DSH 的可插拔扩展提供。
 
 ## 兼容性
 
-- 兼容 DSH `0.1.0-rc.6` 及更新版本。
+- 兼容包含 `@deepseek-ai/dsh-llm-pi-ai` 和 `@deepseek-ai/dsh-tool-web` 的 DSH `0.1.0-rc.8` 及更新版本。
 - 兼容旧版和新版 `dsh-tool-todo`。
 - 不依赖 `registerTodosProjection`。
 - Codex 工具只在 Codex preset 中挂载，不会污染 standard、code、minimal 或其他 preset。
@@ -47,6 +62,6 @@ mv "$DSH_HOME/.agent-presets/codex" "$DSH_HOME/.agent-presets/codex.old"
   name: '@shuind/dsh-codex-harness'
 ```
 
-配置项：`defaultYieldTimeMs`、`pollYieldTimeMs`、`writeYieldTimeMs`、`maxOutputBytes`。
+配置项：`defaultYieldTimeMs`、`pollYieldTimeMs`、`writeYieldTimeMs`、`maxOutputBytes`、`hostedWebSearch`、`remoteCompact`。其中后两个默认开启，设为 `false` 可以直接使用保留的 DSH 本地 fallback。provider、Responses 中转地址、API key、模型和模型级能力继续由 DSH 的 `llm-pi-ai` 配置管理。
 
 MIT License

package/README.zh.md

@@ -1,3 +1,3 @@
-# @shuind/dsh-codex-harness
-
-中文文档已默认放在 [README.md](README.md)。
+# @shuind/dsh-codex-harness
+
+中文文档已默认放在 [README.md](README.md)。

package/cordis.patch.yml

@@ -1,5 +1,5 @@
-- insert:
-    # The bundle is host-plane installation only. The Codex tool/prompt row
-    # lives in presets/codex/agent.cordis.yml, so other presets stay unchanged.
-    - id: codex-preset-installer
-      name: '@shuind/dsh-codex-harness/installer'
+- insert:
+    # The bundle is host-plane installation only. The Codex tool/prompt row
+    # lives in presets/codex/agent.cordis.yml, so other presets stay unchanged.
+    - id: codex-preset-installer
+      name: '@shuind/dsh-codex-harness/installer'

package/lib/index.js

@@ -1,7 +1,10 @@
 import z from "@deepseek-ai/schemastery";
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { randomBytes } from "node:crypto";
 import { resolve } from "node:path";
+import { credentialRef } from "@deepseek-ai/dsh-credentials";
+import { AsyncLocalStorage } from "node:async_hooks";
 String.raw`start: begin_patch hunk+ end_patch
 begin_patch: "*** Begin Patch" LF
 end_patch: "*** End Patch" LF?
@@ -399,6 +402,309 @@ async function runWriteStdin(ctx, args, exec, config) {
 	return output;
 }
 //#endregion
+//#region lib/types/remote.js
+const SETTINGS_NAMESPACE = "llm-pi-ai";
+const REMOTE_COMPACTION_OPEN = "<codex-remote-compaction>";
+const REMOTE_COMPACTION_CLOSE = "</codex-remote-compaction>";
+const HOSTED_REQUESTS = new AsyncLocalStorage();
+let hostedPatchUsers = 0;
+let hostedPatchRestore;
+function isGptModel$1(model) {
+	return typeof model === "string" && /(?:^|\/)(?:gpt|chatgpt)(?:[-_.]|\d|$)/i.test(model);
+}
+function settingsOf(ctx) {
+	return ctx.get("settings")?.get?.(SETTINGS_NAMESPACE);
+}
+function profileOf(ctx, provider) {
+	return settingsOf(ctx)?.providers?.[provider];
+}
+function supportsResponses(profile, provider) {
+	return profile?.api === "openai-responses" || profile?.api === "openai-codex-responses" || profile?.api === void 0 && provider === "openai";
+}
+function responsesEndpoint(baseURL, suffix) {
+	return `${baseURL.replace(/\/+$/, "")}/${suffix}`;
+}
+function hasHeader(headers, name) {
+	return Object.keys(headers ?? {}).some((key) => key.toLowerCase() === name.toLowerCase());
+}
+async function apiHeaders(ctx, profile) {
+	const headers = {
+		...profile.headers,
+		"content-type": "application/json"
+	};
+	if (profile.apiKeyEnv !== void 0 && !hasHeader(headers, "authorization")) {
+		const resolved = await ctx.get("credentials")?.resolve(credentialRef(profile.apiKeyEnv));
+		if (resolved?.value === void 0) return void 0;
+		headers.authorization = `Bearer ${resolved.value}`;
+	}
+	return headers;
+}
+function isResponsesRequest(url) {
+	try {
+		return new URL(url).pathname.replace(/\/+$/, "").endsWith("/responses");
+	} catch {
+		return url.replace(/\/+$/, "").endsWith("/responses");
+	}
+}
+function isWebSearchTool(tool) {
+	if (typeof tool !== "object" || tool === null) return false;
+	const value = tool;
+	if (value.name === "web_search") return true;
+	const fn = value.function;
+	return typeof fn === "object" && fn !== null && fn.name === "web_search";
+}
+function hasWebSearchTool(body) {
+	return Array.isArray(body.tools) && body.tools.some(isWebSearchTool);
+}
+/** Convert a generic DSH Responses tool list to the hosted Codex variant. */
+function addHostedWebSearch(body) {
+	const tools = Array.isArray(body.tools) ? body.tools.filter((tool) => !isWebSearchTool(tool)) : [];
+	tools.push({
+		type: "web_search",
+		external_web_access: true
+	});
+	return {
+		...replaceRemoteCompactions(body),
+		tools
+	};
+}
+/** Replace the text placeholder written by dsh-compaction-basic with the native item. */
+function replaceRemoteCompactions(body) {
+	if (!Array.isArray(body.input)) return body;
+	const input = body.input.map((item) => {
+		if (typeof item !== "object" || item === null) return item;
+		const value = item;
+		const marker = (Array.isArray(value.content) ? value.content : []).find((part) => typeof part === "object" && part !== null && typeof part.text === "string" && String(part.text).includes(REMOTE_COMPACTION_OPEN));
+		if (marker === void 0) return item;
+		const text = String(marker.text);
+		const start = text.indexOf(REMOTE_COMPACTION_OPEN) + 25;
+		const end = text.indexOf(REMOTE_COMPACTION_CLOSE, start);
+		if (end < start) return item;
+		return {
+			type: "compaction",
+			encrypted_content: text.slice(start, end)
+		};
+	});
+	return {
+		...body,
+		input
+	};
+}
+function hasRemoteCompaction(body) {
+	if (!Array.isArray(body.input)) return false;
+	return body.input.some((item) => {
+		if (typeof item !== "object" || item === null) return false;
+		const content = item.content;
+		return Array.isArray(content) && content.some((part) => typeof part === "object" && part !== null && typeof part.text === "string" && String(part.text).includes(REMOTE_COMPACTION_OPEN));
+	});
+}
+function canPatchBody(body) {
+	return isGptModel$1(body.model) && (hasWebSearchTool(body) || hasRemoteCompaction(body));
+}
+/**
+* Install a scoped fetch shim for pi-ai's already-built Responses request.
+* The generic DSH adapter remains the owner of auth, streaming, replay, and
+* attachments; this shim changes only the hosted-tool portion of the wire body.
+*/
+function installGlobalHostedWebSearchPatch() {
+	const original = globalThis.fetch;
+	const patched = async (input, init) => {
+		if (!HOSTED_REQUESTS.getStore()) return original(input, init);
+		const request = new Request(input, init);
+		if (!isResponsesRequest(request.url)) return original(input, init);
+		let body;
+		try {
+			body = JSON.parse(await request.clone().text());
+		} catch {
+			return original(input, init);
+		}
+		if (!canPatchBody(body)) return original(input, init);
+		const fallbackRequest = request.clone();
+		const headers = new Headers(request.headers);
+		headers.delete("content-length");
+		const hostedRequest = new Request(request, {
+			body: JSON.stringify(hasWebSearchTool(body) ? addHostedWebSearch(body) : replaceRemoteCompactions(body)),
+			headers
+		});
+		try {
+			const hostedResponse = await original(hostedRequest);
+			if (!hostedResponse.ok) return original(fallbackRequest);
+			return hostedResponse;
+		} catch {
+			return original(fallbackRequest);
+		}
+	};
+	globalThis.fetch = patched;
+	return () => {
+		if (globalThis.fetch === patched) globalThis.fetch = original;
+	};
+}
+/** Enable the transport patch for this Codex plugin scope only. */
+function installHostedWebSearch() {
+	hostedPatchUsers += 1;
+	hostedPatchRestore ??= installGlobalHostedWebSearchPatch();
+	return () => {
+		hostedPatchUsers = Math.max(0, hostedPatchUsers - 1);
+		if (hostedPatchUsers === 0) {
+			hostedPatchRestore?.();
+			hostedPatchRestore = void 0;
+		}
+	};
+}
+/** Iterate an existing DSH stream with the hosted-request context installed. */
+function hostedWebSearchStream(next) {
+	return (async function* () {
+		const iterator = next()[Symbol.asyncIterator]();
+		let completed = false;
+		try {
+			while (true) {
+				const item = await HOSTED_REQUESTS.run(true, () => iterator.next());
+				if (item.done) {
+					completed = true;
+					return;
+				}
+				yield item.value;
+			}
+		} finally {
+			if (!completed) await iterator.return?.();
+		}
+	})();
+}
+function textOf(message) {
+	return message.content.filter((block) => block.type === "text").map((block) => block.text).join("");
+}
+function responsesInput(messages) {
+	const result = [];
+	for (const message of messages) {
+		const text = textOf(message);
+		if (message.role === "assistant") {
+			if (text.length > 0) result.push({
+				type: "message",
+				role: "assistant",
+				content: [{
+					type: "output_text",
+					text
+				}]
+			});
+			for (const block of message.content) if (block.type === "tool-call") result.push({
+				type: "function_call",
+				call_id: block.id,
+				name: block.name,
+				arguments: block.arguments
+			});
+			continue;
+		}
+		const role = message.role === "system" ? "developer" : "user";
+		if (text.length > 0) result.push({
+			type: "message",
+			role,
+			content: [{
+				type: "input_text",
+				text
+			}]
+		});
+		for (const block of message.content) {
+			if (block.type !== "tool-result") continue;
+			result.push({
+				type: "function_call_output",
+				call_id: block.toolCallId,
+				output: block.content.filter((item) => item.type === "text").map((item) => item.text).join("")
+			});
+		}
+	}
+	return result;
+}
+function responsesTools(tools) {
+	if (tools === void 0) return void 0;
+	return tools.filter((tool) => tool.name !== "web_search").map((tool) => ({
+		type: "function",
+		name: tool.name,
+		description: tool.description,
+		parameters: tool.parameters
+	}));
+}
+function compactBody(options) {
+	const tools = responsesTools(options.tools);
+	const compacted = replaceRemoteCompactions({
+		model: options.model,
+		input: responsesInput(options.messages.slice(0, -1)),
+		...options.system === void 0 ? {} : { instructions: options.system },
+		...tools === void 0 ? {} : { tools },
+		...options.maxTokens === void 0 ? {} : { max_output_tokens: options.maxTokens },
+		...options.reasoningEffort === void 0 ? {} : { reasoning: { effort: options.reasoningEffort } }
+	});
+	return options.tools?.some((tool) => tool.name === "web_search") ? addHostedWebSearch(compacted) : compacted;
+}
+function compactText(body) {
+	const output = Array.isArray(body.output) ? body.output : [];
+	const text = [];
+	for (const item of output) {
+		if (typeof item !== "object" || item === null) continue;
+		const value = item;
+		if (typeof value.encrypted_content === "string") text.push(value.encrypted_content);
+	}
+	const encrypted = text.join("\n\n").trim();
+	return encrypted.length === 0 ? "" : `${REMOTE_COMPACTION_OPEN}${encrypted}${REMOTE_COMPACTION_CLOSE}`;
+}
+async function remoteCompact(ctx, options) {
+	const profile = profileOf(ctx, options.provider);
+	if (!supportsResponses(profile, options.provider) || profile?.baseURL === void 0) throw new Error("Codex remote compaction requires an OpenAI Responses provider with baseURL");
+	const headers = await apiHeaders(ctx, profile);
+	if (headers === void 0) throw new Error("Codex remote compaction has no configured API key");
+	const response = await fetch(responsesEndpoint(profile.baseURL, "responses/compact"), {
+		method: "POST",
+		headers,
+		body: JSON.stringify(compactBody(options)),
+		...options.signal === void 0 ? {} : { signal: options.signal }
+	});
+	if (!response.ok) throw new Error(`remote compaction returned HTTP ${response.status}`);
+	const text = compactText(await response.json());
+	if (text.length === 0) throw new Error("remote compaction returned no compaction text");
+	return text;
+}
+/** Remote-first compaction waterfall with the existing DSH path as fallback. */
+function remoteCompactStream(ctx, options, next) {
+	return (async function* () {
+		try {
+			const text = await remoteCompact(ctx, options);
+			yield {
+				type: "block-start",
+				index: 0,
+				blockType: "text"
+			};
+			yield {
+				type: "text-delta",
+				index: 0,
+				text
+			};
+			yield {
+				type: "block-end",
+				index: 0,
+				block: {
+					type: "text",
+					text
+				}
+			};
+			yield {
+				type: "usage",
+				usage: {
+					inputTokens: 0,
+					outputTokens: 0
+				}
+			};
+			yield {
+				type: "finish",
+				reason: { kind: "stop" }
+			};
+		} catch (error) {
+			if (options.signal?.aborted) throw error;
+			ctx.logger.warn("codex: remote compaction failed; using dsh-compaction-basic fallback");
+			ctx.logger.warn(error);
+			yield* hostedWebSearchStream(next);
+		}
+	})();
+}
+//#endregion
 //#region lib/types/index.js
 /** Codex-compatible prompt overlay and core tools for a dsh agent preset. */
 const name = "codex";
@@ -406,15 +712,103 @@ const inject = [
 	"tools",
 	"systemPrompt",
 	"shell",
-	"fs"
+	"fs",
+	"llm",
+	"credentials"
 ];
 /** Runtime configuration schema for the Codex tool bridge. */
 const Config = z.object({
 	defaultYieldTimeMs: z.number().step(1).min(0).default(1e4),
 	pollYieldTimeMs: z.number().step(1).min(0).default(5e3),
 	writeYieldTimeMs: z.number().step(1).min(0).default(250),
-	maxOutputBytes: z.number().step(1).min(1).default(64e3)
+	maxOutputBytes: z.number().step(1).min(1).default(64e3),
+	hostedWebSearch: z.boolean().default(true),
+	remoteCompact: z.boolean().default(true)
 });
+const LLM_PI_AI_SETTINGS = settingsNamespace("llm-pi-ai");
+const GPT_REASONING_EFFORTS = {
+	low: "low",
+	medium: "medium",
+	high: "high",
+	xhigh: "xhigh",
+	max: "max"
+};
+function codexReasoningEfforts(configured) {
+	if (configured === false) return false;
+	const filtered = configured === void 0 ? {} : Object.fromEntries(Object.entries(configured).filter(([level]) => level !== "off" && level !== "minimal"));
+	return Object.keys(filtered).length === 0 ? GPT_REASONING_EFFORTS : filtered;
+}
+/** GPT model ids are the only models whose relay capabilities Codex fills in. */
+function isGptModel(id) {
+	return /(?:^|\/)(?:gpt|chatgpt)(?:[-_.]|\d|$)/i.test(id);
+}
+/** Add Codex defaults without overwriting explicit user capabilities. */
+function enrichCodexModel(model) {
+	if (!isGptModel(model.id)) return model;
+	const input = model.input === void 0 || model.input.length === 0 ? ["text", "image"] : model.input;
+	const efforts = codexReasoningEfforts(model.reasoningEfforts);
+	if (input === model.input && efforts === model.reasoningEfforts) return model;
+	return {
+		...model,
+		input,
+		reasoningEfforts: efforts
+	};
+}
+/** The settings schema keys modelOverrides by id, so its values must not carry an id field. */
+function enrichCodexOverride(id, model) {
+	if (!isGptModel(id)) return model;
+	const { id: _id, ...withoutId } = enrichCodexModel({
+		...model,
+		id
+	});
+	const inputMissing = model.input === void 0 || model.input.length === 0;
+	const nextEfforts = codexReasoningEfforts(model.reasoningEfforts);
+	const reasoningChanged = JSON.stringify(nextEfforts) !== JSON.stringify(model.reasoningEfforts);
+	if (!inputMissing && !reasoningChanged) return model;
+	return {
+		...withoutId,
+		reasoningEfforts: nextEfforts
+	};
+}
+/** Persist only missing GPT capabilities into the user's existing pi-ai model config. */
+async function enrichConfiguredGptModels(ctx) {
+	const settings = ctx.get("settings");
+	if (settings === void 0) return;
+	const current = settings.get(LLM_PI_AI_SETTINGS);
+	if (current?.providers === void 0) return;
+	const providers = {};
+	let changed = false;
+	for (const [provider, profile] of Object.entries(current.providers)) {
+		const models = profile.models;
+		const overrides = profile.modelOverrides;
+		const nextModels = Array.isArray(models) ? models.map(enrichCodexModel) : void 0;
+		const nextOverrides = overrides === void 0 ? void 0 : Object.fromEntries(Object.entries(overrides).map(([id, model]) => [id, enrichCodexOverride(id, model)]));
+		const modelsChanged = nextModels !== void 0 && nextModels.some((model, index) => model !== models?.[index]);
+		const overridesChanged = nextOverrides !== void 0 && overrides !== void 0 && Object.entries(nextOverrides).some(([id, model]) => model !== overrides[id]);
+		if (modelsChanged || overridesChanged) {
+			changed = true;
+			providers[provider] = {
+				...modelsChanged ? { models: nextModels } : {},
+				...overridesChanged ? { modelOverrides: nextOverrides } : {}
+			};
+		}
+	}
+	if (changed) await settings.update(LLM_PI_AI_SETTINGS, { providers });
+}
+/** Keep newly edited GPT model entries enriched while Codex mode is mounted. */
+function watchConfiguredGptModels(ctx) {
+	let tail = Promise.resolve();
+	const schedule = () => {
+		tail = tail.then(() => enrichConfiguredGptModels(ctx)).catch((error) => {
+			ctx.logger.warn("codex: could not enrich configured GPT model capabilities");
+			ctx.logger.warn(error);
+		});
+	};
+	ctx.on("settings/document-updated", (ns) => {
+		if (ns === LLM_PI_AI_SETTINGS) schedule();
+	});
+	schedule();
+}
 const CODEX_BASE_PROMPT = String.raw`You are Codex, based on {{model}}. You are running as a coding agent in dsh Web on a user's computer.
 
 ## General
@@ -821,9 +1215,21 @@ function apply(ctx, config = {}) {
 		defaultYieldTimeMs: config.defaultYieldTimeMs ?? 1e4,
 		pollYieldTimeMs: config.pollYieldTimeMs ?? 5e3,
 		writeYieldTimeMs: config.writeYieldTimeMs ?? 250,
-		maxOutputBytes: config.maxOutputBytes ?? 64e3
+		maxOutputBytes: config.maxOutputBytes ?? 64e3,
+		hostedWebSearch: config.hostedWebSearch ?? true,
+		remoteCompact: config.remoteCompact ?? true
 	};
 	if (ctx.fs.sandboxMode !== void 0 && ctx.get("sandboxPolicy") === void 0) throw new Error("codex: a sandboxing filesystem requires ctx.sandboxPolicy");
+	watchConfiguredGptModels(ctx);
+	if ((resolved.hostedWebSearch || resolved.remoteCompact) && typeof ctx.effect === "function") {
+		const disposeHostedWebSearch = installHostedWebSearch();
+		ctx.effect(() => disposeHostedWebSearch, "codex: Responses transport wrapper");
+	}
+	if (resolved.hostedWebSearch || resolved.remoteCompact) ctx.on("llm/stream", (options, next) => {
+		if (resolved.remoteCompact && options.purpose === "compaction" && isGptModel(options.model)) return remoteCompactStream(ctx, options, next);
+		if ((resolved.hostedWebSearch || resolved.remoteCompact) && options.purpose === void 0 && isGptModel(options.model)) return hostedWebSearchStream(next);
+		return next();
+	});
 	ctx.systemPrompt.section({
 		name: "codex:base",
 		order: 10,
@@ -840,4 +1246,4 @@ var types_default = {
 	apply
 };
 //#endregion
-export { Config, apply, types_default as default, inject, name };
+export { Config, apply, types_default as default, enrichCodexModel, inject, name };

package/lib/types/index.d.ts

@@ -13,9 +13,21 @@ export interface Config {
     writeYieldTimeMs?: number;
     /** Maximum output retained in one canonical result, in UTF-8 bytes. */
     maxOutputBytes?: number;
+    /** Send GPT Responses requests with the native hosted web_search tool first. */
+    hostedWebSearch?: boolean;
+    /** Use the provider's /responses/compact endpoint before local compaction. */
+    remoteCompact?: boolean;
 }
 /** Runtime configuration schema for the Codex tool bridge. */
 export declare const Config: z<Config>;
+export interface CodexModelProfile {
+    id: string;
+    input?: string[];
+    reasoningEfforts?: false | Record<string, string | null>;
+    [key: string]: unknown;
+}
+/** Add Codex defaults without overwriting explicit user capabilities. */
+export declare function enrichCodexModel(model: CodexModelProfile): CodexModelProfile;
 /** Mount the Codex prompt/tool layer inside one fixed agent preset. */
 export declare function apply(ctx: Context, config?: Config): void;
 declare const _default: {

package/lib/types/index.js

@@ -1,17 +1,113 @@
 /** Codex-compatible prompt overlay and core tools for a dsh agent preset. */
 import z from '@deepseek-ai/schemastery';
+import { settingsNamespace } from '@deepseek-ai/dsh-settings';
 import { defineTool } from '@deepseek-ai/dsh-tools';
 import { applyPatchHunks, parsePatch } from "./patch.js";
 import { renderExecResult, runExecCommand, runWriteStdin } from "./exec.js";
+import { hostedWebSearchStream, installHostedWebSearch, remoteCompactStream } from "./remote.js";
 export const name = 'codex';
-export const inject = ['tools', 'systemPrompt', 'shell', 'fs'];
+export const inject = ['tools', 'systemPrompt', 'shell', 'fs', 'llm', 'credentials'];
 /** Runtime configuration schema for the Codex tool bridge. */
 export const Config = z.object({
     defaultYieldTimeMs: z.number().step(1).min(0).default(10_000),
     pollYieldTimeMs: z.number().step(1).min(0).default(5_000),
     writeYieldTimeMs: z.number().step(1).min(0).default(250),
     maxOutputBytes: z.number().step(1).min(1).default(64_000),
+    hostedWebSearch: z.boolean().default(true),
+    remoteCompact: z.boolean().default(true),
 });
+const LLM_PI_AI_SETTINGS = settingsNamespace('llm-pi-ai');
+const GPT_REASONING_EFFORTS = {
+    low: 'low',
+    medium: 'medium',
+    high: 'high',
+    xhigh: 'xhigh',
+    max: 'max',
+};
+function codexReasoningEfforts(configured) {
+    if (configured === false)
+        return false;
+    const filtered = configured === undefined
+        ? {}
+        : Object.fromEntries(Object.entries(configured).filter(([level]) => level !== 'off' && level !== 'minimal'));
+    return Object.keys(filtered).length === 0 ? GPT_REASONING_EFFORTS : filtered;
+}
+/** GPT model ids are the only models whose relay capabilities Codex fills in. */
+function isGptModel(id) {
+    return /(?:^|\/)(?:gpt|chatgpt)(?:[-_.]|\d|$)/i.test(id);
+}
+/** Add Codex defaults without overwriting explicit user capabilities. */
+export function enrichCodexModel(model) {
+    if (!isGptModel(model.id))
+        return model;
+    const input = model.input === undefined || model.input.length === 0
+        ? ['text', 'image']
+        : model.input;
+    const efforts = codexReasoningEfforts(model.reasoningEfforts);
+    if (input === model.input && efforts === model.reasoningEfforts)
+        return model;
+    return { ...model, input, reasoningEfforts: efforts };
+}
+/** The settings schema keys modelOverrides by id, so its values must not carry an id field. */
+function enrichCodexOverride(id, model) {
+    if (!isGptModel(id))
+        return model;
+    const enriched = enrichCodexModel({ ...model, id });
+    const { id: _id, ...withoutId } = enriched;
+    const inputMissing = model.input === undefined || model.input.length === 0;
+    const nextEfforts = codexReasoningEfforts(model.reasoningEfforts);
+    const reasoningChanged = JSON.stringify(nextEfforts) !== JSON.stringify(model.reasoningEfforts);
+    if (!inputMissing && !reasoningChanged)
+        return model;
+    return { ...withoutId, reasoningEfforts: nextEfforts };
+}
+/** Persist only missing GPT capabilities into the user's existing pi-ai model config. */
+async function enrichConfiguredGptModels(ctx) {
+    const settings = ctx.get('settings');
+    if (settings === undefined)
+        return;
+    const current = settings.get(LLM_PI_AI_SETTINGS);
+    if (current?.providers === undefined)
+        return;
+    const providers = {};
+    let changed = false;
+    for (const [provider, profile] of Object.entries(current.providers)) {
+        const models = profile.models;
+        const overrides = profile.modelOverrides;
+        const nextModels = Array.isArray(models) ? models.map(enrichCodexModel) : undefined;
+        const nextOverrides = overrides === undefined
+            ? undefined
+            : Object.fromEntries(Object.entries(overrides).map(([id, model]) => [id, enrichCodexOverride(id, model)]));
+        const modelsChanged = nextModels !== undefined && nextModels.some((model, index) => model !== models?.[index]);
+        const overridesChanged = nextOverrides !== undefined
+            && overrides !== undefined
+            && Object.entries(nextOverrides).some(([id, model]) => model !== overrides[id]);
+        if (modelsChanged || overridesChanged) {
+            changed = true;
+            providers[provider] = {
+                ...modelsChanged ? { models: nextModels } : {},
+                ...overridesChanged ? { modelOverrides: nextOverrides } : {},
+            };
+        }
+    }
+    if (changed)
+        await settings.update(LLM_PI_AI_SETTINGS, { providers });
+}
+/** Keep newly edited GPT model entries enriched while Codex mode is mounted. */
+function watchConfiguredGptModels(ctx) {
+    let tail = Promise.resolve();
+    const schedule = () => {
+        tail = tail.then(() => enrichConfiguredGptModels(ctx)).catch(error => {
+            ctx.logger.warn('codex: could not enrich configured GPT model capabilities');
+            ctx.logger.warn(error);
+        });
+    };
+    ctx.on('settings/document-updated', (ns) => {
+        if (ns === LLM_PI_AI_SETTINGS)
+            schedule();
+    });
+    schedule();
+}
 const CODEX_BASE_PROMPT = String.raw `You are Codex, based on {{model}}. You are running as a coding agent in dsh Web on a user's computer.
 
 ## General
@@ -308,10 +404,33 @@ export function apply(ctx, config = {}) {
         pollYieldTimeMs: config.pollYieldTimeMs ?? 5_000,
         writeYieldTimeMs: config.writeYieldTimeMs ?? 250,
         maxOutputBytes: config.maxOutputBytes ?? 64_000,
+        hostedWebSearch: config.hostedWebSearch ?? true,
+        remoteCompact: config.remoteCompact ?? true,
     };
     if (ctx.fs.sandboxMode !== undefined && ctx.get('sandboxPolicy') === undefined) {
         throw new Error('codex: a sandboxing filesystem requires ctx.sandboxPolicy');
     }
+    // The generic pi-ai plugin remains the owner of the user's configured
+    // provider routes. Codex adds only scoped transport behavior and capability
+    // metadata; failed remote operations continue through the generic path.
+    watchConfiguredGptModels(ctx);
+    if ((resolved.hostedWebSearch || resolved.remoteCompact) && typeof ctx.effect === 'function') {
+        const disposeHostedWebSearch = installHostedWebSearch();
+        ctx.effect(() => disposeHostedWebSearch, 'codex: Responses transport wrapper');
+    }
+    if (resolved.hostedWebSearch || resolved.remoteCompact) {
+        ctx.on('llm/stream', (options, next) => {
+            if (resolved.remoteCompact && options.purpose === 'compaction' && isGptModel(options.model)) {
+                return remoteCompactStream(ctx, options, next);
+            }
+            if ((resolved.hostedWebSearch || resolved.remoteCompact)
+                && options.purpose === undefined
+                && isGptModel(options.model)) {
+                return hostedWebSearchStream(next);
+            }
+            return next();
+        });
+    }
     ctx.systemPrompt.section({ name: 'codex:base', order: 10, text: CODEX_BASE_PROMPT });
     registerExecTools(ctx, resolved);
     registerPatchTool(ctx);

package/lib/types/patch.js

@@ -1,20 +1,20 @@
 /** Parser and line-oriented applicator for Codex's `apply_patch` language. */
 /** The grammar sent to providers that support OpenAI custom grammar tools. */
-export const APPLY_PATCH_GRAMMAR = String.raw `start: begin_patch hunk+ end_patch
-begin_patch: "*** Begin Patch" LF
-end_patch: "*** End Patch" LF?
-hunk: add_hunk | delete_hunk | update_hunk
-add_hunk: "*** Add File: " filename LF add_line+
-delete_hunk: "*** Delete File: " filename LF
-update_hunk: "*** Update File: " filename LF change_move? change?
-filename: /(.+)/
-add_line: "+" /(.*)/ LF -> line
-change_move: "*** Move to: " filename LF
-change: (change_context | change_line)+ eof_line?
-change_context: ("@@" | "@@ " /(.+)/) LF
-change_line: ("+" | "-" | " ") /(.*)/ LF
-eof_line: "*** End of File" LF
-%import common.LF
+export const APPLY_PATCH_GRAMMAR = String.raw `start: begin_patch hunk+ end_patch
+begin_patch: "*** Begin Patch" LF
+end_patch: "*** End Patch" LF?
+hunk: add_hunk | delete_hunk | update_hunk
+add_hunk: "*** Add File: " filename LF add_line+
+delete_hunk: "*** Delete File: " filename LF
+update_hunk: "*** Update File: " filename LF change_move? change?
+filename: /(.+)/
+add_line: "+" /(.*)/ LF -> line
+change_move: "*** Move to: " filename LF
+change: (change_context | change_line)+ eof_line?
+change_context: ("@@" | "@@ " /(.+)/) LF
+change_line: ("+" | "-" | " ") /(.*)/ LF
+eof_line: "*** End of File" LF
+%import common.LF
 `;
 function invalid(message) {
     throw new Error(`apply_patch: ${message}`);

package/lib/types/remote.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { GenerateOptions, StreamChunk } from '@deepseek-ai/dsh-llm';
+export interface RemoteCodexConfig {
+    hostedWebSearch: boolean;
+    remoteCompact: boolean;
+}
+interface JsonObject {
+    [key: string]: unknown;
+}
+/** Convert a generic DSH Responses tool list to the hosted Codex variant. */
+export declare function addHostedWebSearch(body: JsonObject): JsonObject;
+/** Replace the text placeholder written by dsh-compaction-basic with the native item. */
+export declare function replaceRemoteCompactions(body: JsonObject): JsonObject;
+/** Enable the transport patch for this Codex plugin scope only. */
+export declare function installHostedWebSearch(): () => void;
+/** Iterate an existing DSH stream with the hosted-request context installed. */
+export declare function hostedWebSearchStream(next: () => AsyncIterable<StreamChunk>): AsyncIterable<StreamChunk>;
+/** Remote-first compaction waterfall with the existing DSH path as fallback. */
+export declare function remoteCompactStream(ctx: Context, options: GenerateOptions, next: () => AsyncIterable<StreamChunk>): AsyncIterable<StreamChunk>;
+export {};
+//# sourceMappingURL=remote.d.ts.map

package/lib/types/remote.js

@@ -0,0 +1,324 @@
+import { credentialRef } from '@deepseek-ai/dsh-credentials';
+import { AsyncLocalStorage } from 'node:async_hooks';
+const SETTINGS_NAMESPACE = 'llm-pi-ai';
+const REMOTE_COMPACTION_OPEN = '<codex-remote-compaction>';
+const REMOTE_COMPACTION_CLOSE = '</codex-remote-compaction>';
+const HOSTED_REQUESTS = new AsyncLocalStorage();
+let hostedPatchUsers = 0;
+let hostedPatchRestore;
+function isGptModel(model) {
+    return typeof model === 'string' && /(?:^|\/)(?:gpt|chatgpt)(?:[-_.]|\d|$)/i.test(model);
+}
+function settingsOf(ctx) {
+    const provider = ctx.get('settings');
+    return provider?.get?.(SETTINGS_NAMESPACE);
+}
+function profileOf(ctx, provider) {
+    return settingsOf(ctx)?.providers?.[provider];
+}
+function supportsResponses(profile, provider) {
+    return profile?.api === 'openai-responses'
+        || profile?.api === 'openai-codex-responses'
+        || (profile?.api === undefined && provider === 'openai');
+}
+function responsesEndpoint(baseURL, suffix) {
+    return `${baseURL.replace(/\/+$/, '')}/${suffix}`;
+}
+function hasHeader(headers, name) {
+    return Object.keys(headers ?? {}).some(key => key.toLowerCase() === name.toLowerCase());
+}
+async function apiHeaders(ctx, profile) {
+    const headers = { ...profile.headers, 'content-type': 'application/json' };
+    if (profile.apiKeyEnv !== undefined && !hasHeader(headers, 'authorization')) {
+        const credentials = ctx.get('credentials');
+        const resolved = await credentials?.resolve(credentialRef(profile.apiKeyEnv));
+        if (resolved?.value === undefined)
+            return undefined;
+        headers.authorization = `Bearer ${resolved.value}`;
+    }
+    return headers;
+}
+function isResponsesRequest(url) {
+    try {
+        const path = new URL(url).pathname.replace(/\/+$/, '');
+        return path.endsWith('/responses');
+    }
+    catch {
+        return url.replace(/\/+$/, '').endsWith('/responses');
+    }
+}
+function isWebSearchTool(tool) {
+    if (typeof tool !== 'object' || tool === null)
+        return false;
+    const value = tool;
+    if (value.name === 'web_search')
+        return true;
+    const fn = value.function;
+    return typeof fn === 'object' && fn !== null && fn.name === 'web_search';
+}
+function hasWebSearchTool(body) {
+    return Array.isArray(body.tools) && body.tools.some(isWebSearchTool);
+}
+/** Convert a generic DSH Responses tool list to the hosted Codex variant. */
+export function addHostedWebSearch(body) {
+    const tools = Array.isArray(body.tools) ? body.tools.filter(tool => !isWebSearchTool(tool)) : [];
+    tools.push({ type: 'web_search', external_web_access: true });
+    return { ...replaceRemoteCompactions(body), tools };
+}
+/** Replace the text placeholder written by dsh-compaction-basic with the native item. */
+export function replaceRemoteCompactions(body) {
+    if (!Array.isArray(body.input))
+        return body;
+    const input = body.input.map(item => {
+        if (typeof item !== 'object' || item === null)
+            return item;
+        const value = item;
+        const content = Array.isArray(value.content) ? value.content : [];
+        const marker = content.find(part => (typeof part === 'object'
+            && part !== null
+            && typeof part.text === 'string'
+            && String(part.text).includes(REMOTE_COMPACTION_OPEN)));
+        if (marker === undefined)
+            return item;
+        const text = String(marker.text);
+        const start = text.indexOf(REMOTE_COMPACTION_OPEN) + REMOTE_COMPACTION_OPEN.length;
+        const end = text.indexOf(REMOTE_COMPACTION_CLOSE, start);
+        if (end < start)
+            return item;
+        return {
+            type: 'compaction',
+            encrypted_content: text.slice(start, end),
+        };
+    });
+    return { ...body, input };
+}
+function hasRemoteCompaction(body) {
+    if (!Array.isArray(body.input))
+        return false;
+    return body.input.some(item => {
+        if (typeof item !== 'object' || item === null)
+            return false;
+        const content = item.content;
+        return Array.isArray(content) && content.some(part => (typeof part === 'object'
+            && part !== null
+            && typeof part.text === 'string'
+            && String(part.text).includes(REMOTE_COMPACTION_OPEN)));
+    });
+}
+function canPatchBody(body) {
+    return isGptModel(body.model)
+        && (hasWebSearchTool(body) || hasRemoteCompaction(body));
+}
+/**
+ * Install a scoped fetch shim for pi-ai's already-built Responses request.
+ * The generic DSH adapter remains the owner of auth, streaming, replay, and
+ * attachments; this shim changes only the hosted-tool portion of the wire body.
+ */
+function installGlobalHostedWebSearchPatch() {
+    const original = globalThis.fetch;
+    const patched = async (input, init) => {
+        if (!HOSTED_REQUESTS.getStore())
+            return original(input, init);
+        const request = new Request(input, init);
+        if (!isResponsesRequest(request.url))
+            return original(input, init);
+        let body;
+        try {
+            body = JSON.parse(await request.clone().text());
+        }
+        catch {
+            return original(input, init);
+        }
+        if (!canPatchBody(body))
+            return original(input, init);
+        const fallbackRequest = request.clone();
+        const headers = new Headers(request.headers);
+        headers.delete('content-length');
+        const hostedRequest = new Request(request, {
+            body: JSON.stringify(hasWebSearchTool(body) ? addHostedWebSearch(body) : replaceRemoteCompactions(body)),
+            headers,
+        });
+        try {
+            const hostedResponse = await original(hostedRequest);
+            // A rejected hosted-tool request is retried with the untouched request so
+            // dsh-tool-web can still produce the normal local function-tool path.
+            if (!hostedResponse.ok)
+                return original(fallbackRequest);
+            return hostedResponse;
+        }
+        catch {
+            // Network and transport failures must have the same fallback behavior as
+            // an HTTP rejection; the local function-tool path remains available.
+            return original(fallbackRequest);
+        }
+    };
+    globalThis.fetch = patched;
+    return () => {
+        if (globalThis.fetch === patched)
+            globalThis.fetch = original;
+    };
+}
+/** Enable the transport patch for this Codex plugin scope only. */
+export function installHostedWebSearch() {
+    hostedPatchUsers += 1;
+    hostedPatchRestore ??= installGlobalHostedWebSearchPatch();
+    return () => {
+        hostedPatchUsers = Math.max(0, hostedPatchUsers - 1);
+        if (hostedPatchUsers === 0) {
+            hostedPatchRestore?.();
+            hostedPatchRestore = undefined;
+        }
+    };
+}
+/** Iterate an existing DSH stream with the hosted-request context installed. */
+export function hostedWebSearchStream(next) {
+    return (async function* () {
+        const iterator = next()[Symbol.asyncIterator]();
+        let completed = false;
+        try {
+            while (true) {
+                const item = await HOSTED_REQUESTS.run(true, () => iterator.next());
+                if (item.done) {
+                    completed = true;
+                    return;
+                }
+                yield item.value;
+            }
+        }
+        finally {
+            if (!completed)
+                await iterator.return?.();
+        }
+    })();
+}
+function textOf(message) {
+    return message.content
+        .filter(block => block.type === 'text')
+        .map(block => block.text)
+        .join('');
+}
+function responsesInput(messages) {
+    const result = [];
+    for (const message of messages) {
+        const text = textOf(message);
+        if (message.role === 'assistant') {
+            if (text.length > 0)
+                result.push({
+                    type: 'message',
+                    role: 'assistant',
+                    content: [{ type: 'output_text', text }],
+                });
+            for (const block of message.content) {
+                if (block.type === 'tool-call') {
+                    result.push({
+                        type: 'function_call',
+                        call_id: block.id,
+                        name: block.name,
+                        arguments: block.arguments,
+                    });
+                }
+            }
+            continue;
+        }
+        const role = message.role === 'system' ? 'developer' : 'user';
+        if (text.length > 0)
+            result.push({
+                type: 'message',
+                role,
+                content: [{ type: 'input_text', text }],
+            });
+        for (const block of message.content) {
+            if (block.type !== 'tool-result')
+                continue;
+            result.push({
+                type: 'function_call_output',
+                call_id: block.toolCallId,
+                output: block.content.filter(item => item.type === 'text').map(item => item.text).join(''),
+            });
+        }
+    }
+    return result;
+}
+function responsesTools(tools) {
+    if (tools === undefined)
+        return undefined;
+    return tools.filter(tool => tool.name !== 'web_search').map(tool => ({
+        type: 'function',
+        name: tool.name,
+        description: tool.description,
+        parameters: tool.parameters,
+    }));
+}
+function compactBody(options) {
+    const tools = responsesTools(options.tools);
+    const body = {
+        model: options.model,
+        // dsh-compaction-basic appends an instruction for its local summarizer.
+        // The hosted compact endpoint owns summarization and must not receive it.
+        input: responsesInput(options.messages.slice(0, -1)),
+        ...options.system === undefined ? {} : { instructions: options.system },
+        ...tools === undefined ? {} : { tools },
+        ...options.maxTokens === undefined ? {} : { max_output_tokens: options.maxTokens },
+        ...options.reasoningEffort === undefined ? {} : { reasoning: { effort: options.reasoningEffort } },
+    };
+    const compacted = replaceRemoteCompactions(body);
+    return options.tools?.some(tool => tool.name === 'web_search') ? addHostedWebSearch(compacted) : compacted;
+}
+function compactText(body) {
+    const output = Array.isArray(body.output) ? body.output : [];
+    const text = [];
+    for (const item of output) {
+        if (typeof item !== 'object' || item === null)
+            continue;
+        const value = item;
+        if (typeof value.encrypted_content === 'string')
+            text.push(value.encrypted_content);
+    }
+    const encrypted = text.join('\n\n').trim();
+    return encrypted.length === 0 ? '' : `${REMOTE_COMPACTION_OPEN}${encrypted}${REMOTE_COMPACTION_CLOSE}`;
+}
+async function remoteCompact(ctx, options) {
+    const profile = profileOf(ctx, options.provider);
+    if (!supportsResponses(profile, options.provider) || profile?.baseURL === undefined) {
+        throw new Error('Codex remote compaction requires an OpenAI Responses provider with baseURL');
+    }
+    const headers = await apiHeaders(ctx, profile);
+    if (headers === undefined)
+        throw new Error('Codex remote compaction has no configured API key');
+    const response = await fetch(responsesEndpoint(profile.baseURL, 'responses/compact'), {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(compactBody(options)),
+        ...options.signal === undefined ? {} : { signal: options.signal },
+    });
+    if (!response.ok)
+        throw new Error(`remote compaction returned HTTP ${response.status}`);
+    const body = await response.json();
+    const text = compactText(body);
+    if (text.length === 0)
+        throw new Error('remote compaction returned no compaction text');
+    return text;
+}
+/** Remote-first compaction waterfall with the existing DSH path as fallback. */
+export function remoteCompactStream(ctx, options, next) {
+    return (async function* () {
+        try {
+            const text = await remoteCompact(ctx, options);
+            yield { type: 'block-start', index: 0, blockType: 'text' };
+            yield { type: 'text-delta', index: 0, text };
+            yield { type: 'block-end', index: 0, block: { type: 'text', text } };
+            yield { type: 'usage', usage: { inputTokens: 0, outputTokens: 0 } };
+            yield { type: 'finish', reason: { kind: 'stop' } };
+        }
+        catch (error) {
+            if (options.signal?.aborted)
+                throw error;
+            ctx.logger.warn('codex: remote compaction failed; using dsh-compaction-basic fallback');
+            ctx.logger.warn(error);
+            // The local fallback still replays the marker through a later GPT
+            // Responses request, so it needs the same scoped wire context.
+            yield* hostedWebSearchStream(next);
+        }
+    })();
+}
+//# sourceMappingURL=remote.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuind/dsh-codex-harness",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "A minimal Codex harness for GPT models that do not fit DSH's native interface, while remaining compatible with the DSH plugin ecosystem.",
   "type": "module",
   "main": "lib/index.js",
@@ -67,41 +67,85 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",
     "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-credentials": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-fs": ">=0.0.1-rc.1",
     "@deepseek-ai/dsh-invariants": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-sandbox": ">=0.0.1-rc.1",
     "@deepseek-ai/dsh-sandbox-policy": ">=0.0.1-rc.1",
     "@deepseek-ai/dsh-shell": ">=0.0.1-rc.5",
     "@deepseek-ai/dsh-shell-env": ">=0.0.1-rc.3",
     "@deepseek-ai/dsh-system-prompt": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-tool-web": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-tool-todo": ">=0.0.1-rc.1",
     "@deepseek-ai/dsh-terminal": ">=0.0.1-rc.3",
     "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": { "optional": true },
-    "@deepseek-ai/dsh-agent": { "optional": true },
-    "@deepseek-ai/dsh-fs": { "optional": true },
-    "@deepseek-ai/dsh-invariants": { "optional": true },
-    "@deepseek-ai/dsh-sandbox": { "optional": true },
-    "@deepseek-ai/dsh-sandbox-policy": { "optional": true },
-    "@deepseek-ai/dsh-shell": { "optional": true },
-    "@deepseek-ai/dsh-shell-env": { "optional": true },
-    "@deepseek-ai/dsh-system-prompt": { "optional": true },
-    "@deepseek-ai/dsh-tool-todo": { "optional": true },
-    "@deepseek-ai/dsh-terminal": { "optional": true },
-    "@deepseek-ai/dsh-tools": { "optional": true }
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-credentials": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-fs": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-invariants": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-sandbox": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-sandbox-policy": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-shell": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-shell-env": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-web": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-todo": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-terminal": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-credentials": "0.1.0-rc.8",
     "@deepseek-ai/dsh-fs": "0.1.0-rc.6",
     "@deepseek-ai/dsh-invariants": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
     "@deepseek-ai/dsh-sandbox": "0.1.0-rc.6",
     "@deepseek-ai/dsh-sandbox-policy": "0.1.0-rc.6",
     "@deepseek-ai/dsh-shell": "0.1.0-rc.6",
     "@deepseek-ai/dsh-shell-env": "0.1.0-rc.6",
     "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tool-web": "0.1.0-rc.8",
     "@deepseek-ai/dsh-tool-todo": "0.1.0-rc.6",
     "@deepseek-ai/dsh-terminal": "0.1.0-rc.6",
     "@deepseek-ai/dsh-tools": "0.1.0-rc.6",

package/presets/codex/agent.cordis.yml

@@ -18,6 +18,19 @@
 - id: codex-tools
   name: '@shuind/dsh-codex-harness'
 
+# The generic DSH pi-ai adapter still owns the user's configured provider,
+# endpoint, API key, and model. Codex's remote-first transport wrapper is
+# installed only in this Codex scope and falls back to the generic DSH path.
+
+# Keep the local tool mounted as the fallback. Codex rewrites the final GPT
+# Responses request to a hosted web_search tool first; a failed remote request
+# is retried through this unchanged local function-tool path.
+- id: codex-web-search
+  name: '@deepseek-ai/dsh-tool-web'
+  config:
+    search: true
+    fetch: false
+
 # PTY execution is optional. Pipe-backed exec_command remains available on all
 # platforms through the shell capability consumed by the Codex tool layer.
 - id: codex-terminal
@@ -35,6 +48,29 @@
       config:
         timeoutMs: 300000
 
+# Context compaction is agent-scoped in Web. The token meter stays on the host
+# plane, while this group owns the backend, `/compact`, and optional tool-result
+# pruning for Codex sessions.
+- id: compaction
+  name: cordis:group
+  group: true
+  isolate:
+    compaction: true
+    toolResultPruner: true
+  config:
+    - id: compaction-basic
+      name: '@deepseek-ai/dsh-compaction-basic'
+
+    - id: command-compact
+      name: '@deepseek-ai/dsh-command-compact'
+
+    - id: tool-result-pruner
+      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+      config:
+        thresholdChars: 8192
+        headChars: 4096
+        tailChars: 1024
+
 # Skills are the dsh extensibility seam and do not change the four Codex core
 # tool names.
 - id: skill-filesystem

package/presets/codex/preset.yml

@@ -1,3 +1,3 @@
-name: Codex 模式
-description: 使用 Codex 的基础提示词、exec_command、write_stdin、apply_patch 和 update_plan，并保留 dsh 的 Skills 与可插拔运行时。
-order: 5
+name: Codex 模式
+description: 使用 Codex 的基础提示词、exec_command、write_stdin、apply_patch 和 update_plan，并保留 dsh 的 Skills 与可插拔运行时。
+order: 5