@shuind/dsh-codex-harness 0.1.22 → 0.1.23

package/README.md

@@ -10,6 +10,7 @@
 - **GPT 能力补全**：为 GPT 系列模型补充图片输入和思考强度选项；不会覆盖用户已有的显式配置。
 - **Fast**：仅在 Codex preset 的模型选择菜单中显示，开启后向 Responses 请求发送 `service_tier: "priority"`。
 - **旧版 Web 兼容**：在未提供新版模型设置/上下文设置 slot 的 DSH Web 中，Fast 和上下文容量会自动回退到旧版 composer slot；client 注入不依赖纯类型 slot 包。
+- **Responses 原生 apply_patch**：在 GPT Responses 请求的插件传输边界，把普通 JSON function tool 改写为 `type: "custom"` + OpenAI `lark` grammar；下一轮历史同步改写为 `custom_tool_call`。如果中转站拒绝 custom tool，则自动回退到普通 function tool，不改变 DSH 工具执行器。
 - **远程搜索与压缩**：OpenAI Responses 请求默认优先使用 hosted `web_search` 和 `/responses/compact`；失败时回退到 DSH 的本地实现。
 - **上下文容量**：在 Web 中设置 `1K`–`1000K` tokens，设置值作用于下一次请求。
 - **活动状态**：Codex 等待模型响应或进行上下文压缩时，在输入框上方显示对应状态和耗时，让长时间 Deep Diving 不再像卡住。
@@ -17,7 +18,7 @@
 ## 安装
 
 ```sh
-dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.22
+dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.23
 ```
 
 重启 Web，创建新会话，在模式菜单中选择 **Codex 模式**。
@@ -56,7 +57,7 @@ Fast 设置保存在 `codex` 命名空间，只对 Codex preset 生效。
 
 ### 活动状态
 
-Codex 等待模型首个输出时，Web 输入框上方会显示 `正在等待模型响应... · Ns`；开始上下文压缩后会切换为 `正在压缩上下文... · Ns`。收到模型输出、压缩结束或下一轮开始后自动隐藏。该状态由 Host 的 `sessionProjections` 投影驱动，因此本地压缩和远程 `/responses/compact` 都会显示同一种状态。
+Codex 等待模型首个输出时，Web 会在 `Deep diving...` 右侧显示 `正在等待模型响应... · Ns`；开始上下文压缩后会切换为 `正在压缩上下文... · Ns`。收到模型输出、压缩结束或下一轮开始后自动隐藏。该状态由 Host 的 `sessionProjections` 投影驱动，因此本地压缩和远程 `/responses/compact` 都会显示同一种状态。
 
 如果当前 DSH 组合没有加载 projection 服务，插件会跳过注册，客户端也会自动隐藏这行，不影响普通会话。
 
@@ -127,6 +128,7 @@ Make things as effortless as possible for the user.
 - preset 在创建会话时确定；已有会话不会自动切换到 Codex 模式。
 - GPT 模型的图片输入和思考强度属于能力补全；用户已明确配置的字段会被保留。
 - hosted search、远程压缩以及 reasoning 参数的可用性取决于实际 Responses 中转站和模型。
+- `apply_patch` 的 custom grammar 改写只作用于 GPT Responses 请求；中转站必须接受 OpenAI custom tools 和 Lark grammar。拒绝时插件会自动发送原始 JSON function-call 请求。
 
 ## License
 

package/lib/client.js

@@ -30,6 +30,8 @@ window.__ModuleLoader__.load({
 		const SETTINGS_NAMESPACE = "codex";
 		const MODEL_SETTINGS_SLOT = "conversation.input.model.settings";
 		const CONTEXT_SETTINGS_SLOT = "conversation.input.context.settings";
+		const ACTIVITY_SLOT = "conversation.chat.status";
+		const ACTIVITY_FALLBACK_SLOT = "conversation.composer.dock";
 		const FAST_FALLBACK_SLOT = "conversation.input.right";
 		const CONTEXT_FALLBACK_SLOT = "conversation.input.dock";
 		const DEFAULT_CONTEXT_WINDOW = 262144;
@@ -292,19 +294,19 @@ window.__ModuleLoader__.load({
 			}, [agentPreset, activity?.startedAt]);
 			if (agentPreset !== "codex" || activity === void 0 || activity === null) return null;
 			const label = activity.activity === "awaiting-model" ? t("activityAwaitingModel") : t("activityCompacting");
-			return (0, react_jsx_runtime.jsxs)("div", {
+			return (0, react_jsx_runtime.jsxs)("span", {
 				id: "codex-activity",
 				role: "status",
 				"aria-live": "polite",
 				style: {
-					display: "flex",
+					display: "inline-flex",
 					alignItems: "center",
 					gap: 7,
-					minHeight: 28,
-					padding: "4px 10px",
+					minHeight: 26,
 					color: "var(--dsw-alias-label-secondary)",
 					fontSize: 12,
-					lineHeight: "20px"
+					lineHeight: "20px",
+					whiteSpace: "nowrap"
 				},
 				children: [
 					(0, react_jsx_runtime.jsx)("span", {
@@ -329,6 +331,18 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
+		/** Preserve the old composer-dock footprint for hosts without the chat status seat. */
+		function ActivityDock(props) {
+			return (0, react_jsx_runtime.jsx)("div", {
+				style: {
+					display: "flex",
+					alignItems: "center",
+					minHeight: 28,
+					padding: "4px 10px"
+				},
+				children: (0, react_jsx_runtime.jsx)(ActivityLine, { ...props })
+			});
+		}
 		const inject = [
 			"slots",
 			"locale",
@@ -342,6 +356,16 @@ window.__ModuleLoader__.load({
 			const registry = ctx.slots;
 			return typeof registry.spec === "function" && registry.spec.call(ctx.slots, slot) !== void 0;
 		}
+		/** Register an optional host slot without claiming it in older SlotMap declarations. */
+		function injectOptionalActivitySlot(ctx, slot) {
+			const registry = ctx.slots;
+			registry.inject(slot, () => registry.register({
+				name: slot,
+				id: "codex-activity",
+				order: 5,
+				locale: NS
+			}, ActivityLine));
+		}
 		/** Mount Codex controls in the newest named seats, with legacy composer fallbacks. */
 		function apply(ctx) {
 			ctx.effect(() => ctx.locale.register(NS, {
@@ -382,12 +406,13 @@ window.__ModuleLoader__.load({
 				locale: NS,
 				inject: injected
 			}, LegacyContextSizeControl));
-			ctx.slots.inject("conversation.composer.dock", () => ctx.slots.register({
-				name: "conversation.composer.dock",
+			if (chooseDeclaredSlot(ACTIVITY_SLOT, ACTIVITY_FALLBACK_SLOT, (slot) => slotIsDeclared(ctx, slot)) === ACTIVITY_SLOT) injectOptionalActivitySlot(ctx, ACTIVITY_SLOT);
+			else ctx.slots.inject(ACTIVITY_FALLBACK_SLOT, () => ctx.slots.register({
+				name: ACTIVITY_FALLBACK_SLOT,
 				id: "codex-activity",
 				order: 5,
 				locale: NS
-			}, ActivityLine));
+			}, ActivityDock));
 		}
 		var client_default = {
 			inject,

package/lib/index.js

@@ -8,7 +8,12 @@ import { AsyncLocalStorage } from "node:async_hooks";
 import { z as z$1 } from "zod";
 //#region lib/types/context.js
 const CODEX_CONTEXT_MAX = 1e6;
-String.raw`start: begin_patch environment_id? hunk+ end_patch
+//#endregion
+//#region lib/types/patch.js
+/** Parser and line-oriented applicator for Codex's `apply_patch` language. */
+const APPLY_PATCH_DESCRIPTION = "Edits files using Codex patch syntax with Begin/End Patch markers and file update directives. In hunk lines, the first character is the operation marker; repeat a source-leading marker when the source line itself starts with one.";
+/** The grammar sent to providers that support OpenAI custom grammar tools. */
+const APPLY_PATCH_GRAMMAR = String.raw`start: begin_patch environment_id? hunk+ end_patch
 begin_patch: "*** Begin Patch" LF
 environment_id: "*** Environment ID: " filename LF
 end_patch: "*** End Patch" LF?
@@ -575,6 +580,134 @@ function isWebSearchTool(tool) {
 function hasWebSearchTool(body) {
 	return Array.isArray(body.tools) && body.tools.some(isWebSearchTool);
 }
+function toolName(tool) {
+	if (typeof tool !== "object" || tool === null) return void 0;
+	const value = tool;
+	if (typeof value.name === "string") return value.name;
+	const fn = value.function;
+	return typeof fn === "object" && fn !== null && typeof fn.name === "string" ? fn.name : void 0;
+}
+function isApplyPatchTool(tool) {
+	return toolName(tool) === "apply_patch";
+}
+function isFunctionApplyPatchTool(tool) {
+	if (!isApplyPatchTool(tool) || typeof tool !== "object" || tool === null) return false;
+	return tool.type !== "custom";
+}
+function hasFunctionApplyPatchTool(body) {
+	return Array.isArray(body.tools) && body.tools.some(isFunctionApplyPatchTool);
+}
+function applyPatchTool(tool) {
+	const value = tool;
+	const fn = value.function;
+	const custom = {
+		type: "custom",
+		name: "apply_patch",
+		description: typeof value.description === "string" ? value.description : typeof fn === "object" && fn !== null && typeof fn.description === "string" ? fn.description : APPLY_PATCH_DESCRIPTION,
+		format: {
+			type: "grammar",
+			syntax: "lark",
+			definition: APPLY_PATCH_GRAMMAR
+		}
+	};
+	if (value.defer_loading !== void 0) custom.defer_loading = value.defer_loading;
+	return custom;
+}
+/** Replace DSH's JSON function declaration with the Responses custom grammar tool. */
+function addCodexApplyPatch(body) {
+	if (!Array.isArray(body.tools)) return body;
+	let changed = false;
+	const tools = body.tools.map((tool) => {
+		if (!isApplyPatchTool(tool) || typeof tool !== "object" || tool === null) return tool;
+		if (tool.type === "custom") return tool;
+		changed = true;
+		return applyPatchTool(tool);
+	});
+	return changed ? {
+		...body,
+		tools
+	} : body;
+}
+function applyPatchInputOfCall(item) {
+	if (item.type !== "function_call" || item.name !== "apply_patch") return void 0;
+	if (typeof item.call_id !== "string" || item.call_id.length === 0) return void 0;
+	const raw = item.arguments;
+	const argumentsObject = typeof raw === "string" ? (() => {
+		try {
+			return JSON.parse(raw);
+		} catch {
+			return;
+		}
+	})() : raw;
+	if (typeof argumentsObject !== "object" || argumentsObject === null) return void 0;
+	const input = argumentsObject.input;
+	return typeof input === "string" ? {
+		callId: item.call_id,
+		input
+	} : void 0;
+}
+function canRewriteApplyPatchHistory(body) {
+	if (!Array.isArray(body.input)) return true;
+	return body.input.every((item) => {
+		if (typeof item !== "object" || item === null) return true;
+		const value = item;
+		return value.type !== "function_call" || value.name !== "apply_patch" || applyPatchInputOfCall(value) !== void 0;
+	});
+}
+/** Replay apply_patch calls as custom tool items after pi-ai's generic conversion. */
+function rewriteCodexApplyPatchHistory(body) {
+	if (!Array.isArray(body.input) || !canRewriteApplyPatchHistory(body)) return body;
+	const applyCallIds = /* @__PURE__ */ new Set();
+	for (const item of body.input) {
+		if (typeof item !== "object" || item === null) continue;
+		const value = item;
+		if (value.type === "custom_tool_call" && value.name === "apply_patch" && typeof value.call_id === "string") applyCallIds.add(value.call_id);
+		const call = applyPatchInputOfCall(value);
+		if (call !== void 0) applyCallIds.add(call.callId);
+	}
+	if (applyCallIds.size === 0) return body;
+	let changed = false;
+	const input = body.input.map((item) => {
+		if (typeof item !== "object" || item === null) return item;
+		const value = item;
+		const call = applyPatchInputOfCall(value);
+		if (call !== void 0) {
+			const next = {
+				type: "custom_tool_call",
+				call_id: call.callId,
+				name: "apply_patch",
+				input: call.input
+			};
+			if (typeof value.id === "string") next.id = value.id;
+			changed = true;
+			return next;
+		}
+		if (value.type === "function_call_output" && typeof value.call_id === "string" && applyCallIds.has(value.call_id)) {
+			changed = true;
+			return {
+				type: "custom_tool_call_output",
+				call_id: value.call_id,
+				output: value.output
+			};
+		}
+		return item;
+	});
+	return changed ? {
+		...body,
+		input
+	} : body;
+}
+/** Compose the plugin-only Responses rewrites without changing DSH's tool API. */
+function rewriteCodexResponsesBody(body) {
+	let next = body;
+	if (hasWebSearchTool(next)) next = addHostedWebSearch(next);
+	else if (hasRemoteCompaction(next)) next = replaceRemoteCompactions(next);
+	if (hasFunctionApplyPatchTool(next) && canRewriteApplyPatchHistory(next)) {
+		next = addCodexApplyPatch(next);
+		next = rewriteCodexApplyPatchHistory(next);
+	}
+	return next;
+}
 /** 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)) : [];
@@ -618,12 +751,13 @@ function hasRemoteCompaction(body) {
 	});
 }
 function canPatchBody(body) {
-	return isGptModel$1(body.model) && (hasWebSearchTool(body) || hasRemoteCompaction(body));
+	return isGptModel$1(body.model) && (hasWebSearchTool(body) || hasRemoteCompaction(body) || hasFunctionApplyPatchTool(body) && canRewriteApplyPatchHistory(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.
+* attachments; this shim changes only Codex's Responses tool and compaction
+* representation at the wire boundary.
 */
 function installGlobalHostedWebSearchPatch() {
 	const original = globalThis.fetch;
@@ -642,7 +776,7 @@ function installGlobalHostedWebSearchPatch() {
 		const headers = new Headers(request.headers);
 		headers.delete("content-length");
 		const hostedRequest = new Request(request, {
-			body: JSON.stringify(hasWebSearchTool(body) ? addHostedWebSearch(body) : replaceRemoteCompactions(body)),
+			body: JSON.stringify(rewriteCodexResponsesBody(body)),
 			headers
 		});
 		try {
@@ -1063,7 +1197,6 @@ function buildCodexSystemPrompt(config = {}) {
 }
 const EXEC_COMMAND_DESCRIPTION = "Runs a command in a PTY, returning output, a session ID for ongoing interaction, or a background job ID when requested.";
 const WRITE_STDIN_DESCRIPTION = "Writes characters to an existing unified exec session and returns recent output.";
-const APPLY_PATCH_DESCRIPTION = "Edits files using Codex patch syntax with Begin/End Patch markers and file update directives. In hunk lines, the first character is the operation marker; repeat a source-leading marker when the source line itself starts with one.";
 const UPDATE_PLAN_DESCRIPTION = "Updates the task plan.\nProvide an optional explanation and a list of plan items, each with a step and status.\nAt most one step can be in_progress at a time.";
 const PLAN_STATUSES = [
 	"pending",
@@ -1445,13 +1578,13 @@ function apply(ctx, config = {}) {
 	ctx.on("agent/request", async (_payload, next) => {
 		return applyCodexRequestSettings(await next(), codexSettings.current());
 	});
-	if ((resolved.hostedWebSearch || resolved.remoteCompact) && typeof ctx.effect === "function") {
+	if (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) => {
+	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);
+		if (options.purpose === void 0 && isGptModel(options.model)) return hostedWebSearchStream(next);
 		return next();
 	}));
 	ctx.on("system-prompt/assemble", async (_assembly, _context, next) => normalizeCodexPromptAssembly(await next()));

package/lib/types/client/index.d.ts

@@ -32,7 +32,8 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         };
     }
 }
-type ActivityProps = PropsRuntime<'conversation.composer.dock'> & PropsLocale<'codex'>;
+type ActivityDockProps = PropsRuntime<'conversation.composer.dock'> & PropsLocale<'codex'>;
+type ActivityProps = ActivityDockProps;
 export declare function ActivityLine({ sessionId, useSession, useSessions, useProjection, t }: ActivityProps): import("react").JSX.Element | null;
 export declare const inject: string[];
 /** Select a preferred slot when the host declares it, otherwise use a stable legacy composer seat. */

package/lib/types/client/index.js

@@ -7,6 +7,10 @@ const NS = 'codex';
 const SETTINGS_NAMESPACE = 'codex';
 const MODEL_SETTINGS_SLOT = 'conversation.input.model.settings';
 const CONTEXT_SETTINGS_SLOT = 'conversation.input.context.settings';
+// Prefer a dedicated status seat when a newer host declares it; the current
+// conversation contract falls back to the ambient composer dock below.
+const ACTIVITY_SLOT = 'conversation.chat.status';
+const ACTIVITY_FALLBACK_SLOT = 'conversation.composer.dock';
 const FAST_FALLBACK_SLOT = 'conversation.input.right';
 const CONTEXT_FALLBACK_SLOT = 'conversation.input.dock';
 const DEFAULT_CONTEXT_WINDOW = 262_144;
@@ -161,15 +165,15 @@ export function ActivityLine({ sessionId, useSession, useSessions, useProjection
     const label = activity.activity === 'awaiting-model'
         ? t('activityAwaitingModel')
         : t('activityCompacting');
-    return (_jsxs("div", { id: "codex-activity", role: "status", "aria-live": "polite", style: {
-            display: 'flex',
+    return (_jsxs("span", { id: "codex-activity", role: "status", "aria-live": "polite", style: {
+            display: 'inline-flex',
             alignItems: 'center',
             gap: 7,
-            minHeight: 28,
-            padding: '4px 10px',
+            minHeight: 26,
             color: 'var(--dsw-alias-label-secondary)',
             fontSize: 12,
             lineHeight: '20px',
+            whiteSpace: 'nowrap',
         }, children: [_jsx("span", { "aria-hidden": "true", style: {
                     width: 7,
                     height: 7,
@@ -178,6 +182,10 @@ export function ActivityLine({ sessionId, useSession, useSessions, useProjection
                     background: 'var(--dsw-static-blue-500)',
                 } }), _jsx("span", { children: label }), _jsxs("span", { style: { color: 'var(--dsw-alias-label-tertiary)' }, children: ["\u00B7 ", elapsedSeconds(activity.startedAt, now), "s"] })] }));
 }
+/** Preserve the old composer-dock footprint for hosts without the chat status seat. */
+function ActivityDock(props) {
+    return (_jsx("div", { style: { display: 'flex', alignItems: 'center', minHeight: 28, padding: '4px 10px' }, children: _jsx(ActivityLine, { ...props }) }));
+}
 export const inject = ['slots', 'locale', 'settingsScope'];
 /** Select a preferred slot when the host declares it, otherwise use a stable legacy composer seat. */
 export function chooseDeclaredSlot(preferred, fallback, isDeclared) {
@@ -187,6 +195,16 @@ function slotIsDeclared(ctx, slot) {
     const registry = ctx.slots;
     return typeof registry.spec === 'function' && registry.spec.call(ctx.slots, slot) !== undefined;
 }
+/** Register an optional host slot without claiming it in older SlotMap declarations. */
+function injectOptionalActivitySlot(ctx, slot) {
+    const registry = ctx.slots;
+    registry.inject(slot, () => registry.register({
+        name: slot,
+        id: 'codex-activity',
+        order: 5,
+        locale: NS,
+    }, ActivityLine));
+}
 /** Mount Codex controls in the newest named seats, with legacy composer fallbacks. */
 export function apply(ctx) {
     ctx.effect(() => ctx.locale.register(NS, { en, zh }), 'codex client: dictionaries');
@@ -234,12 +252,18 @@ export function apply(ctx) {
             inject: injected,
         }, LegacyContextSizeControl));
     }
-    ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
-        name: 'conversation.composer.dock',
-        id: 'codex-activity',
-        order: 5,
-        locale: NS,
-    }, ActivityLine));
+    const activitySlot = chooseDeclaredSlot(ACTIVITY_SLOT, ACTIVITY_FALLBACK_SLOT, slot => slotIsDeclared(ctx, slot));
+    if (activitySlot === ACTIVITY_SLOT) {
+        injectOptionalActivitySlot(ctx, ACTIVITY_SLOT);
+    }
+    else {
+        ctx.slots.inject(ACTIVITY_FALLBACK_SLOT, () => ctx.slots.register({
+            name: ACTIVITY_FALLBACK_SLOT,
+            id: 'codex-activity',
+            order: 5,
+            locale: NS,
+        }, ActivityDock));
+    }
 }
 export default { inject, apply };
 //# sourceMappingURL=index.js.map

package/lib/types/index.js

@@ -3,7 +3,7 @@ import z from '@deepseek-ai/schemastery';
 import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings';
 import { defineTool } from '@deepseek-ai/dsh-tools';
 import { CODEX_CONTEXT_MAX } from "./context.js";
-import { applyPatchHunks, parsePatch } from "./patch.js";
+import { APPLY_PATCH_DESCRIPTION, applyPatchHunks, parsePatch } from "./patch.js";
 import { renderExecResult, runExecCommand, runWriteStdin } from "./exec.js";
 import { hostedWebSearchStream, installHostedWebSearch, remoteCompactStream } from "./remote.js";
 import { registerCodexActivityProjection } from "./activity.js";
@@ -196,7 +196,6 @@ export function buildCodexSystemPrompt(config = {}) {
 }
 const EXEC_COMMAND_DESCRIPTION = 'Runs a command in a PTY, returning output, a session ID for ongoing interaction, or a background job ID when requested.';
 const WRITE_STDIN_DESCRIPTION = 'Writes characters to an existing unified exec session and returns recent output.';
-const APPLY_PATCH_DESCRIPTION = 'Edits files using Codex patch syntax with Begin/End Patch markers and file update directives. In hunk lines, the first character is the operation marker; repeat a source-leading marker when the source line itself starts with one.';
 const UPDATE_PLAN_DESCRIPTION = 'Updates the task plan.\nProvide an optional explanation and a list of plan items, each with a step and status.\nAt most one step can be in_progress at a time.';
 const PLAN_STATUSES = ['pending', 'in_progress', 'completed'];
 function sessionCwd(exec) {
@@ -473,23 +472,22 @@ export function apply(ctx, config = {}) {
         const request = await next();
         return applyCodexRequestSettings(request, codexSettings.current());
     });
-    if ((resolved.hostedWebSearch || resolved.remoteCompact) && typeof ctx.effect === 'function') {
+    if (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.on('llm/stream', ((options, next) => {
+        if (resolved.remoteCompact && options.purpose === 'compaction' && isGptModel(options.model)) {
+            return remoteCompactStream(ctx, options, next);
+        }
+        // Keep all ordinary GPT Responses calls inside the plugin-owned transport
+        // scope so apply_patch can use the same wire bridge even when hosted search
+        // and remote compaction are disabled.
+        if (options.purpose === undefined && isGptModel(options.model)) {
+            return hostedWebSearchStream(next);
+        }
+        return next();
+    }));
     ctx.on('system-prompt/assemble', async (_assembly, _context, next) => normalizeCodexPromptAssembly(await next()));
     ctx.systemPrompt.section({ name: 'codex:base', order: 10, text: buildCodexSystemPrompt(resolved) });
     registerExecTools(ctx, resolved);

package/lib/types/patch.d.ts

@@ -1,4 +1,5 @@
 /** Parser and line-oriented applicator for Codex's `apply_patch` language. */
+export declare const APPLY_PATCH_DESCRIPTION = "Edits files using Codex patch syntax with Begin/End Patch markers and file update directives. In hunk lines, the first character is the operation marker; repeat a source-leading marker when the source line itself starts with one.";
 /** The grammar sent to providers that support OpenAI custom grammar tools. */
 export declare const APPLY_PATCH_GRAMMAR: string;
 export type PatchLine = {

package/lib/types/patch.js

@@ -1,4 +1,5 @@
 /** Parser and line-oriented applicator for Codex's `apply_patch` language. */
+export const APPLY_PATCH_DESCRIPTION = 'Edits files using Codex patch syntax with Begin/End Patch markers and file update directives. In hunk lines, the first character is the operation marker; repeat a source-leading marker when the source line itself starts with one.';
 /** The grammar sent to providers that support OpenAI custom grammar tools. */
 export const APPLY_PATCH_GRAMMAR = String.raw `start: begin_patch environment_id? hunk+ end_patch
 begin_patch: "*** Begin Patch" LF

package/lib/types/remote.d.ts

@@ -7,6 +7,12 @@ export interface RemoteCodexConfig {
 interface JsonObject {
     [key: string]: unknown;
 }
+/** Replace DSH's JSON function declaration with the Responses custom grammar tool. */
+export declare function addCodexApplyPatch(body: JsonObject): JsonObject;
+/** Replay apply_patch calls as custom tool items after pi-ai's generic conversion. */
+export declare function rewriteCodexApplyPatchHistory(body: JsonObject): JsonObject;
+/** Compose the plugin-only Responses rewrites without changing DSH's tool API. */
+export declare function rewriteCodexResponsesBody(body: JsonObject): JsonObject;
 /** 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. */

package/lib/types/remote.js

@@ -1,5 +1,6 @@
 import { credentialRef } from '@deepseek-ai/dsh-credentials';
 import { AsyncLocalStorage } from 'node:async_hooks';
+import { APPLY_PATCH_DESCRIPTION, APPLY_PATCH_GRAMMAR } from "./patch.js";
 const SETTINGS_NAMESPACE = 'llm-pi-ai';
 const REMOTE_COMPACTION_OPEN = '<codex-remote-compaction>';
 const REMOTE_COMPACTION_CLOSE = '</codex-remote-compaction>';
@@ -59,6 +60,162 @@ function isWebSearchTool(tool) {
 function hasWebSearchTool(body) {
     return Array.isArray(body.tools) && body.tools.some(isWebSearchTool);
 }
+function toolName(tool) {
+    if (typeof tool !== 'object' || tool === null)
+        return undefined;
+    const value = tool;
+    if (typeof value.name === 'string')
+        return value.name;
+    const fn = value.function;
+    return typeof fn === 'object' && fn !== null && typeof fn.name === 'string'
+        ? fn.name
+        : undefined;
+}
+function isApplyPatchTool(tool) {
+    return toolName(tool) === 'apply_patch';
+}
+function isFunctionApplyPatchTool(tool) {
+    if (!isApplyPatchTool(tool) || typeof tool !== 'object' || tool === null)
+        return false;
+    return tool.type !== 'custom';
+}
+function hasFunctionApplyPatchTool(body) {
+    return Array.isArray(body.tools) && body.tools.some(isFunctionApplyPatchTool);
+}
+function applyPatchTool(tool) {
+    const value = tool;
+    const fn = value.function;
+    const description = typeof value.description === 'string'
+        ? value.description
+        : typeof fn === 'object' && fn !== null && typeof fn.description === 'string'
+            ? fn.description
+            : APPLY_PATCH_DESCRIPTION;
+    const custom = {
+        type: 'custom',
+        name: 'apply_patch',
+        description,
+        format: {
+            type: 'grammar',
+            syntax: 'lark',
+            definition: APPLY_PATCH_GRAMMAR,
+        },
+    };
+    if (value.defer_loading !== undefined)
+        custom.defer_loading = value.defer_loading;
+    return custom;
+}
+/** Replace DSH's JSON function declaration with the Responses custom grammar tool. */
+export function addCodexApplyPatch(body) {
+    if (!Array.isArray(body.tools))
+        return body;
+    let changed = false;
+    const tools = body.tools.map(tool => {
+        if (!isApplyPatchTool(tool) || typeof tool !== 'object' || tool === null)
+            return tool;
+        if (tool.type === 'custom')
+            return tool;
+        changed = true;
+        return applyPatchTool(tool);
+    });
+    return changed ? { ...body, tools } : body;
+}
+function applyPatchInputOfCall(item) {
+    if (item.type !== 'function_call' || item.name !== 'apply_patch')
+        return undefined;
+    if (typeof item.call_id !== 'string' || item.call_id.length === 0)
+        return undefined;
+    const raw = item.arguments;
+    const argumentsObject = typeof raw === 'string'
+        ? (() => {
+            try {
+                return JSON.parse(raw);
+            }
+            catch {
+                return undefined;
+            }
+        })()
+        : raw;
+    if (typeof argumentsObject !== 'object' || argumentsObject === null)
+        return undefined;
+    const input = argumentsObject.input;
+    return typeof input === 'string' ? { callId: item.call_id, input } : undefined;
+}
+function canRewriteApplyPatchHistory(body) {
+    if (!Array.isArray(body.input))
+        return true;
+    return body.input.every(item => {
+        if (typeof item !== 'object' || item === null)
+            return true;
+        const value = item;
+        return value.type !== 'function_call' || value.name !== 'apply_patch'
+            || applyPatchInputOfCall(value) !== undefined;
+    });
+}
+/** Replay apply_patch calls as custom tool items after pi-ai's generic conversion. */
+export function rewriteCodexApplyPatchHistory(body) {
+    if (!Array.isArray(body.input) || !canRewriteApplyPatchHistory(body))
+        return body;
+    const applyCallIds = new Set();
+    for (const item of body.input) {
+        if (typeof item !== 'object' || item === null)
+            continue;
+        const value = item;
+        if (value.type === 'custom_tool_call' && value.name === 'apply_patch' && typeof value.call_id === 'string') {
+            applyCallIds.add(value.call_id);
+        }
+        const call = applyPatchInputOfCall(value);
+        if (call !== undefined)
+            applyCallIds.add(call.callId);
+    }
+    if (applyCallIds.size === 0)
+        return body;
+    let changed = false;
+    const input = body.input.map(item => {
+        if (typeof item !== 'object' || item === null)
+            return item;
+        const value = item;
+        const call = applyPatchInputOfCall(value);
+        if (call !== undefined) {
+            const next = {
+                type: 'custom_tool_call',
+                call_id: call.callId,
+                name: 'apply_patch',
+                input: call.input,
+            };
+            if (typeof value.id === 'string')
+                next.id = value.id;
+            changed = true;
+            return next;
+        }
+        if (value.type === 'function_call_output'
+            && typeof value.call_id === 'string'
+            && applyCallIds.has(value.call_id)) {
+            changed = true;
+            return {
+                type: 'custom_tool_call_output',
+                call_id: value.call_id,
+                output: value.output,
+            };
+        }
+        return item;
+    });
+    return changed ? { ...body, input } : body;
+}
+/** Compose the plugin-only Responses rewrites without changing DSH's tool API. */
+export function rewriteCodexResponsesBody(body) {
+    let next = body;
+    if (hasWebSearchTool(next)) {
+        next = addHostedWebSearch(next);
+    }
+    else if (hasRemoteCompaction(next)) {
+        next = replaceRemoteCompactions(next);
+    }
+    if (hasFunctionApplyPatchTool(next) && canRewriteApplyPatchHistory(next)) {
+        next = addCodexApplyPatch(next);
+        next = rewriteCodexApplyPatchHistory(next);
+    }
+    return next;
+}
 /** 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)) : [];
@@ -107,12 +264,15 @@ function hasRemoteCompaction(body) {
 }
 function canPatchBody(body) {
     return isGptModel(body.model)
-        && (hasWebSearchTool(body) || hasRemoteCompaction(body));
+        && (hasWebSearchTool(body)
+            || hasRemoteCompaction(body)
+            || (hasFunctionApplyPatchTool(body) && canRewriteApplyPatchHistory(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.
+ * attachments; this shim changes only Codex's Responses tool and compaction
+ * representation at the wire boundary.
  */
 function installGlobalHostedWebSearchPatch() {
     const original = globalThis.fetch;
@@ -135,7 +295,7 @@ function installGlobalHostedWebSearchPatch() {
         const headers = new Headers(request.headers);
         headers.delete('content-length');
         const hostedRequest = new Request(request, {
-            body: JSON.stringify(hasWebSearchTool(body) ? addHostedWebSearch(body) : replaceRemoteCompactions(body)),
+            body: JSON.stringify(rewriteCodexResponsesBody(body)),
             headers,
         });
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuind/dsh-codex-harness",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "A Codex harness with a streamlined system prompt 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",