@shuind/dsh-codex-harness 0.1.21 → 0.1.23

package/README.md

@@ -6,9 +6,11 @@
 
 - **精简 Codex coding-agent 提示词**：使用精简版系统提示词；身份、模型和工作目录由 `dsh-persona` 提供，避免重复的 Harness 身份说明，同时保留必要的工具契约和编码工作流。
 - **Codex 工具**：`exec_command`、`write_stdin`、`apply_patch`、`update_plan`；`apply_patch` 匹配失败时会显示文件、hunk、行号、可见空白和附近文件内容，便于修正上下文。
+- **后台任务**：`exec_command` 支持 `run_in_background: true`，立即返回 DSH `job_id`；使用 `job_output` 读取输出、`job_kill` 停止任务。任务完成时，忙碌中的 agent 会在下一步收到 inbox 注入；空闲 agent 默认保持安静，等下一次唤醒时再处理完成消息。
 - **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 不再像卡住。
@@ -16,7 +18,7 @@
 ## 安装
 
 ```sh
-dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.21
+dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.23
 ```
 
 重启 Web，创建新会话，在模式菜单中选择 **Codex 模式**。
@@ -55,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 服务，插件会跳过注册，客户端也会自动隐藏这行，不影响普通会话。
 
@@ -83,6 +85,11 @@ Codex 等待模型首个输出时，Web 输入框上方会显示 `正在等待
   name: '@shuind/dsh-codex-harness'
   config:
     collaborationPrompt: true
+
+- id: codex-jobs
+  name: '@deepseek-ai/dsh-tool-jobs'
+  config:
+    completionDelivery: quiet
 ```
 
 再写入 `preset.yml`，让 Web 中显示更清晰的名称：
@@ -93,7 +100,7 @@ description: 使用 Codex 工具并开启可选协作提示词。
 order: 10
 ```
 
-然后在 Web 的 **Agent 预设** 中选择 `My Codex`，再新建会话。这个 preset 会加载 Codex 工具，并开启协作提示词；网页搜索、远程压缩和 Skills 等其他功能需要在同一个 `agent.cordis.yml` 中按需添加。
+然后在 Web 的 **Agent 预设** 中选择 `My Codex`，再新建会话。这个 preset 会加载 Codex 工具，并开启协作提示词；网页搜索、远程压缩、后台任务控制和 Skills 等其他功能需要在同一个 `agent.cordis.yml` 中按需添加。
 
 ### 可选协作提示词（私货）
 
@@ -121,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?
@@ -261,6 +266,7 @@ function renderExecResult(result) {
 	sections.push(`Wall time: ${result.wall_time_seconds.toFixed(4)} seconds`);
 	if (result.exit_code !== void 0) sections.push(`Process exited with code ${result.exit_code}`);
 	if (result.session_id !== void 0) sections.push(`Process running with session ID ${result.session_id}`);
+	if (result.job_id !== void 0) sections.push(`Background job ID: ${result.job_id}`);
 	if (result.original_token_count !== void 0) sections.push(`Original token count: ${result.original_token_count}`);
 	sections.push("Output:", result.output);
 	return sections.join("\n");
@@ -281,6 +287,17 @@ function terminalResult(result, maxBytes, startedAt) {
 		...result.sessionStatus.kind === "exited" ? { ...result.sessionStatus.exitCode === null ? {} : { exit_code: result.sessionStatus.exitCode } } : {}
 	});
 }
+/** Map a detached shell process onto the generic DSH job outcome contract. */
+function backgroundOutcome(process) {
+	if (process.status === "killed") return {
+		status: "killed",
+		detail: process.signal !== null ? `signal: ${process.signal}` : "killed before exit"
+	};
+	return {
+		status: "completed",
+		detail: `exit code: ${process.exitCode ?? 0}`
+	};
+}
 function sleep(ms, signal) {
 	return new Promise((resolve) => {
 		let timer;
@@ -334,6 +351,7 @@ async function runExecCommand(ctx, args, exec, config) {
 	const maxBytes = outputLimit(config.maxOutputBytes, args.max_output_tokens);
 	const workdir = sessionCwd$1(exec, args.workdir);
 	const startedAt = performance.now();
+	if (args.run_in_background === true && args.tty === true) throw new Error("run_in_background is only supported for pipe-backed commands; omit tty");
 	if (args.tty === true) {
 		const agent = exec.agent;
 		const terminals = ctx.get("terminals");
@@ -377,11 +395,42 @@ async function runExecCommand(ctx, args, exec, config) {
 		login: args.login ?? true,
 		...workdir === void 0 ? {} : { workdir },
 		stdoutMaxBytes: maxBytes,
-		signal: exec.signal,
 		...dshEnv === void 0 ? {} : { dshEnv },
 		...policy === void 0 ? {} : { sandboxPolicy: policy }
 	};
-	const process = ctx.shell.start(ctx.shell.resolve(shellRequest));
+	if (args.run_in_background === true) {
+		const owner = exec.agent;
+		if (owner === void 0) throw new Error("run_in_background requires an owning agent session");
+		const jobs = ctx.get("jobs");
+		if (jobs === void 0) throw new Error("background jobs unavailable: load @deepseek-ai/dsh-jobs and @deepseek-ai/dsh-tool-jobs");
+		if (exec.signal.aborted) {
+			exec.signal.throwIfAborted();
+			throw new Error("tool call aborted");
+		}
+		const id = jobs.start({
+			kind: "bash",
+			label: args.cmd,
+			owner,
+			outputLimitBytes: maxBytes,
+			run: () => {
+				const process = ctx.shell.start(ctx.shell.resolve(shellRequest));
+				return {
+					cancel: () => void process.kill(),
+					done: process.done.then(() => backgroundOutcome(process)),
+					readOutput: () => readShellOutput(process.readOutput(), maxBytes)
+				};
+			}
+		});
+		return withChunkId({
+			wall_time_seconds: (performance.now() - startedAt) / 1e3,
+			job_id: id,
+			output: `Started background job ${id}. Use job_output with job_id "${id}" to read output.`
+		});
+	}
+	const process = ctx.shell.start(ctx.shell.resolve({
+		...shellRequest,
+		signal: exec.signal
+	}));
 	try {
 		await waitForShell(process, normalizeWaitMs(args.yield_time_ms, config.defaultYieldTimeMs), exec.signal);
 		const output = readShellOutput(process.readOutput(), maxBytes);
@@ -531,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)) : [];
@@ -574,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;
@@ -598,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 {
@@ -1017,9 +1195,8 @@ function normalizeCodexPromptAssembly(assembly) {
 function buildCodexSystemPrompt(config = {}) {
 	return config.collaborationPrompt === true ? `${CODEX_BASE_PROMPT}\n\n${CODEX_COLLABORATION_PROMPT}` : CODEX_BASE_PROMPT;
 }
-const EXEC_COMMAND_DESCRIPTION = "Runs a command in a PTY, returning output or a session ID for ongoing interaction.";
+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",
@@ -1165,6 +1342,10 @@ function registerExecTools(ctx, config) {
 				type: "boolean",
 				description: "True allocates a PTY for the command; false or omitted uses plain pipes."
 			},
+			run_in_background: {
+				type: "boolean",
+				description: "Run as a DSH background job and return its job id immediately; collect output with job_output and stop it with job_kill. Only supported for pipe-backed commands."
+			},
 			yield_time_ms: {
 				type: "number",
 				description: "Wait before yielding output. Defaults to 10000 ms; effective range is 250-30000 ms."
@@ -1194,6 +1375,7 @@ function registerExecTools(ctx, config) {
 					},
 					exit_code: { type: "number" },
 					session_id: { type: "number" },
+					job_id: { type: "string" },
 					original_token_count: { type: "number" },
 					output: {
 						type: "string",
@@ -1396,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/exec.d.ts

@@ -6,6 +6,7 @@ export interface ExecCommandArgs {
     cmd: string;
     workdir?: string;
     tty?: boolean;
+    run_in_background?: boolean;
     yield_time_ms?: number;
     max_output_tokens?: number;
     shell?: string;
@@ -24,6 +25,7 @@ export interface ExecResult {
     wall_time_seconds: number;
     output: string;
     session_id?: number;
+    job_id?: string;
     exit_code?: number;
     original_token_count?: number;
 }

package/lib/types/exec.js

@@ -56,6 +56,8 @@ export function renderExecResult(result) {
         sections.push(`Process exited with code ${result.exit_code}`);
     if (result.session_id !== undefined)
         sections.push(`Process running with session ID ${result.session_id}`);
+    if (result.job_id !== undefined)
+        sections.push(`Background job ID: ${result.job_id}`);
     if (result.original_token_count !== undefined)
         sections.push(`Original token count: ${result.original_token_count}`);
     sections.push('Output:', result.output);
@@ -80,6 +82,16 @@ function terminalResult(result, maxBytes, startedAt) {
         } : {},
     });
 }
+/** Map a detached shell process onto the generic DSH job outcome contract. */
+function backgroundOutcome(process) {
+    if (process.status === 'killed') {
+        return {
+            status: 'killed',
+            detail: process.signal !== null ? `signal: ${process.signal}` : 'killed before exit',
+        };
+    }
+    return { status: 'completed', detail: `exit code: ${process.exitCode ?? 0}` };
+}
 function sleep(ms, signal) {
     return new Promise(resolve => {
         let timer;
@@ -144,6 +156,9 @@ export async function runExecCommand(ctx, args, exec, config) {
     const maxBytes = outputLimit(config.maxOutputBytes, args.max_output_tokens);
     const workdir = sessionCwd(exec, args.workdir);
     const startedAt = performance.now();
+    if (args.run_in_background === true && args.tty === true) {
+        throw new Error('run_in_background is only supported for pipe-backed commands; omit tty');
+    }
     if (args.tty === true) {
         const agent = exec.agent;
         const terminals = ctx.get('terminals');
@@ -187,17 +202,53 @@ export async function runExecCommand(ctx, args, exec, config) {
     }
     const policy = ctx.get('sandboxPolicy')?.resolve(exec.agent === undefined ? {} : { session: exec.agent.session });
     const dshEnv = ctx.get('shellEnv')?.collect(exec);
+    // Background jobs intentionally omit the tool-call signal. Once this call
+    // returns, the job lifetime belongs to the jobs registry, not the request.
     const shellRequest = {
         command: commandFor(args),
         ...args.shell === undefined ? {} : { shell: args.shell },
         login: args.login ?? true,
         ...workdir === undefined ? {} : { workdir },
         stdoutMaxBytes: maxBytes,
-        signal: exec.signal,
         ...dshEnv === undefined ? {} : { dshEnv },
         ...policy === undefined ? {} : { sandboxPolicy: policy },
     };
-    const process = ctx.shell.start(ctx.shell.resolve(shellRequest));
+    if (args.run_in_background === true) {
+        const owner = exec.agent;
+        if (owner === undefined)
+            throw new Error('run_in_background requires an owning agent session');
+        const jobs = ctx.get('jobs');
+        if (jobs === undefined) {
+            throw new Error('background jobs unavailable: load @deepseek-ai/dsh-jobs and @deepseek-ai/dsh-tool-jobs');
+        }
+        if (exec.signal.aborted) {
+            exec.signal.throwIfAborted();
+            throw new Error('tool call aborted');
+        }
+        const id = jobs.start({
+            kind: 'bash',
+            label: args.cmd,
+            owner,
+            outputLimitBytes: maxBytes,
+            run: () => {
+                const process = ctx.shell.start(ctx.shell.resolve(shellRequest));
+                return {
+                    cancel: () => void process.kill(),
+                    done: process.done.then(() => backgroundOutcome(process)),
+                    readOutput: () => readShellOutput(process.readOutput(), maxBytes),
+                };
+            },
+        });
+        return withChunkId({
+            wall_time_seconds: (performance.now() - startedAt) / 1000,
+            job_id: id,
+            output: `Started background job ${id}. Use job_output with job_id "${id}" to read output.`,
+        });
+    }
+    const process = ctx.shell.start(ctx.shell.resolve({
+        ...shellRequest,
+        signal: exec.signal,
+    }));
     try {
         await waitForShell(process, normalizeWaitMs(args.yield_time_ms, config.defaultYieldTimeMs), exec.signal);
         const output = readShellOutput(process.readOutput(), maxBytes);

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";
@@ -194,9 +194,8 @@ export function buildCodexSystemPrompt(config = {}) {
         ? `${CODEX_BASE_PROMPT}\n\n${CODEX_COLLABORATION_PROMPT}`
         : CODEX_BASE_PROMPT;
 }
-const EXEC_COMMAND_DESCRIPTION = 'Runs a command in a PTY, returning output or a session ID for ongoing interaction.';
+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) {
@@ -306,6 +305,7 @@ function registerExecTools(ctx, config) {
             cmd: { type: 'string', required: true, description: 'Shell command to execute.' },
             workdir: { type: 'string', description: 'Working directory for the command. Defaults to the turn cwd.' },
             tty: { type: 'boolean', description: 'True allocates a PTY for the command; false or omitted uses plain pipes.' },
+            run_in_background: { type: 'boolean', description: 'Run as a DSH background job and return its job id immediately; collect output with job_output and stop it with job_kill. Only supported for pipe-backed commands.' },
             yield_time_ms: { type: 'number', description: 'Wait before yielding output. Defaults to 10000 ms; effective range is 250-30000 ms.' },
             max_output_tokens: { type: 'number', description: 'Output token budget. Defaults to 10000 tokens; larger requests may be capped by policy.' },
             shell: { type: 'string', description: "Shell binary to launch. Defaults to the user's default shell." },
@@ -320,6 +320,7 @@ function registerExecTools(ctx, config) {
                     wall_time_seconds: { type: 'number', required: true },
                     exit_code: { type: 'number' },
                     session_id: { type: 'number' },
+                    job_id: { type: 'string' },
                     original_token_count: { type: 'number' },
                     output: { type: 'string', required: true },
                 },
@@ -471,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.21",
+  "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",
@@ -89,6 +89,7 @@
     "@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-jobs": ">=0.1.0-rc.8",
     "@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",
@@ -99,6 +100,7 @@
     "@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-tool-jobs": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1"
   },
   "peerDependenciesMeta": {
@@ -132,6 +134,9 @@
     "@deepseek-ai/dsh-invariants": {
       "optional": true
     },
+    "@deepseek-ai/dsh-jobs": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-llm": {
       "optional": true
     },
@@ -162,6 +167,9 @@
     "@deepseek-ai/dsh-terminal": {
       "optional": true
     },
+    "@deepseek-ai/dsh-tool-jobs": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-tools": {
       "optional": true
     }
@@ -177,6 +185,7 @@
     "@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-jobs": "0.1.0-rc.8",
     "@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",
@@ -187,6 +196,7 @@
     "@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-tool-jobs": "0.1.0-rc.8",
     "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",

package/presets/codex/agent.cordis.yml

@@ -21,6 +21,14 @@
   config:
     collaborationPrompt: false
 
+# Background jobs use the host-plane registry. A busy agent receives a
+# completion in its next step; an idle agent keeps it pending until the next
+# user/tool wake, so finishing work never opens an unsolicited model turn.
+- id: codex-jobs
+  name: '@deepseek-ai/dsh-tool-jobs'
+  config:
+    completionDelivery: quiet
+
 # 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.

package/presets/codex/preset.yml

@@ -1,3 +1,3 @@
 name: Codex 模式
-description: 使用精简版 Codex 提示词、exec_command、write_stdin、apply_patch 和 update_plan，并保留 dsh 的 Skills 与可插拔运行时。
+description: 使用精简版 Codex 提示词、统一执行工具、后台任务控制和 dsh Skills。
 order: 5