@shuind/dsh-codex-harness 0.1.19 → 0.1.20

package/README.md

@@ -1,10 +1,10 @@
 # @shuind/dsh-codex-harness
 
-在 DSH 中提供 Codex preset：引入 Codex 风格的系统提示词与工具契约，支持图片输入、可选思考强度、Fast 优先级请求、OpenAI Responses 网页搜索与远程压缩，以及在 Web 设置上下文容量；旨在给来源于Codex的token提供适配harness，并兼容享受DSH生态。
+在 DSH 中提供 Codex preset：使用精简版 Codex 系统提示词与工具契约，支持图片输入、可选思考强度、Fast 优先级请求、OpenAI Responses 网页搜索与远程压缩，以及在 Web 设置上下文容量；旨在给来源于 Codex 的 token 提供适配 harness，并兼容 DSH 生态。
 
 ## 功能
 
-- **Codex coding-agent 提示词**：提供 Codex 风格的系统提示词、工具契约和编码工作流。
+- **精简 Codex coding-agent 提示词**：使用精简版系统提示词；身份、模型和工作目录由 `dsh-persona` 提供，避免重复的 Harness 身份说明，同时保留必要的工具契约和编码工作流。
 - **Codex 工具**：`exec_command`、`write_stdin`、`apply_patch`、`update_plan`。
 - **GPT 能力补全**：为 GPT 系列模型补充图片输入和思考强度选项；不会覆盖用户已有的显式配置。
 - **Fast**：仅在 Codex preset 的模型选择菜单中显示，开启后向 Responses 请求发送 `service_tier: "priority"`。
@@ -15,7 +15,7 @@
 ## 安装
 
 ```sh
-dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.19
+dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.20
 ```
 
 重启 Web，创建新会话，在模式菜单中选择 **Codex 模式**。

package/lib/index.js

@@ -949,9 +949,7 @@ function applyCodexRequestSettings(request, settings) {
 		...settings.fast ? { serviceTier: "priority" } : {}
 	};
 }
-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
+const CODEX_BASE_PROMPT = String.raw`## General
 
 - When searching for text or files, prefer using rg or rg --files respectively because rg is much faster than alternatives like grep. If rg is not available, use the next best alternative.
 
@@ -959,7 +957,6 @@ const CODEX_BASE_PROMPT = String.raw`You are Codex, based on {{model}}. You are
 
 - Default to ASCII when editing or creating files. Only introduce non-ASCII or other Unicode characters when there is a clear justification and the file already uses them.
 - Add succinct code comments that explain non-obvious code. Do not add comments that merely narrate assignments or control flow.
-- Use apply_patch for single-file edits when practical. The apply_patch tool accepts its freeform patch language; do not wrap that patch in JSON.
 - You may be in a dirty git worktree. Never revert existing changes you did not make unless the user explicitly requests it. If unrelated files are changed, leave them alone.
 
 ## Planning
@@ -970,16 +967,10 @@ const CODEX_BASE_PROMPT = String.raw`You are Codex, based on {{model}}. You are
 ## dsh session
 
 - The user and you share one workspace. Inspect the repository and every applicable AGENTS.md before editing.
-- This session's preset was selected when the session was created and stays fixed for its lifetime. Do not attempt to switch the preset or replace its tool catalog while the session is running.
-- dsh provides the execution, filesystem, session, policy, and Skills capabilities behind these tools. Use those extension points as supplied; do not invent a second harness or bypass the filesystem service for file edits.
-- The core Codex tool names, arguments, and result formats are fixed: use exec_command for terminal work, write_stdin for an existing interactive command, apply_patch for file changes, and update_plan for multi-step tasks.
 
 ## Task execution
 
 - Keep the user informed with concise progress updates and lead with the result.
-- Prefer existing functions and extension points over new machinery.
-- Do not claim that a command, edit, or test succeeded unless it actually succeeded.
-- Use the exact tool names and argument formats supplied by this session; do not invent replacement editing tools.
 
 ## Presenting your work
 
@@ -996,13 +987,26 @@ const CODEX_COLLABORATION_PROMPT = String.raw`## Collaboration
 - Solve problems by thinking from first principles and at a higher level.
 - Make things as effortless as possible for the user.
 `;
-/** Build the Codex system prompt with optional, user-enabled collaboration guidance. */
+/** Put the agent persona first and omit the generic Harness identity opener. */
+function normalizeCodexPromptAssembly(assembly) {
+	const sections = assembly.sections.filter((section) => section.name !== "harness:identity");
+	const persona = sections.find((section) => section.name === "deployment:persona");
+	if (persona === void 0) return {
+		...assembly,
+		sections
+	};
+	return {
+		...assembly,
+		sections: [persona, ...sections.filter((section) => section.name !== "deployment:persona")]
+	};
+}
+/** Build the Codex operating prompt with optional, user-enabled collaboration guidance. */
 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 WRITE_STDIN_DESCRIPTION = "Writes characters to an existing unified exec session and returns recent output.";
-const APPLY_PATCH_DESCRIPTION = "The `apply_patch` tool can be used to edit files. This is a FREEFORM tool, so do not wrap the patch in JSON.";
+const APPLY_PATCH_DESCRIPTION = "Edits files using a patch.";
 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",
@@ -1388,6 +1392,7 @@ function apply(ctx, config = {}) {
 		if ((resolved.hostedWebSearch || resolved.remoteCompact) && options.purpose === void 0 && 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,
@@ -1404,4 +1409,4 @@ var types_default = {
 	apply
 };
 //#endregion
-export { CODEX_SETTINGS_NAMESPACE, CODEX_SETTINGS_SCHEMA, Config, apply, applyCodexRequestSettings, buildCodexSystemPrompt, types_default as default, enrichCodexModel, inject, name };
+export { CODEX_SETTINGS_NAMESPACE, CODEX_SETTINGS_SCHEMA, Config, apply, applyCodexRequestSettings, buildCodexSystemPrompt, types_default as default, enrichCodexModel, inject, name, normalizeCodexPromptAssembly };

package/lib/types/index.d.ts

@@ -2,6 +2,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { LlmCallConfig } from '@deepseek-ai/dsh-llm';
+import type { PromptAssembly } from '@deepseek-ai/dsh-system-prompt';
 declare module '@deepseek-ai/dsh-llm' {
     interface LlmCallConfig {
         /** Codex request context capacity override, in tokens. */
@@ -50,7 +51,9 @@ export interface CodexModelProfile {
 export declare function enrichCodexModel(model: CodexModelProfile): CodexModelProfile;
 /** Apply the live Codex controls to one agent request without leaking them to other routes. */
 export declare function applyCodexRequestSettings(request: LlmCallConfig, settings: CodexSettings): LlmCallConfig;
-/** Build the Codex system prompt with optional, user-enabled collaboration guidance. */
+/** Put the agent persona first and omit the generic Harness identity opener. */
+export declare function normalizeCodexPromptAssembly(assembly: PromptAssembly): PromptAssembly;
+/** Build the Codex operating prompt with optional, user-enabled collaboration guidance. */
 export declare function buildCodexSystemPrompt(config?: Pick<Config, 'collaborationPrompt'>): string;
 /** Mount the Codex prompt/tool layer inside one fixed agent preset. */
 export declare function apply(ctx: Context, config?: Config): void;

package/lib/types/index.js

@@ -138,9 +138,8 @@ export function applyCodexRequestSettings(request, settings) {
         ...settings.fast ? { serviceTier: 'priority' } : {},
     };
 }
-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
+// The shipped persona owns the single Codex identity line, model, and working directory.
+const CODEX_BASE_PROMPT = String.raw `## General
 
 - When searching for text or files, prefer using rg or rg --files respectively because rg is much faster than alternatives like grep. If rg is not available, use the next best alternative.
 
@@ -148,7 +147,6 @@ const CODEX_BASE_PROMPT = String.raw `You are Codex, based on {{model}}. You are
 
 - Default to ASCII when editing or creating files. Only introduce non-ASCII or other Unicode characters when there is a clear justification and the file already uses them.
 - Add succinct code comments that explain non-obvious code. Do not add comments that merely narrate assignments or control flow.
-- Use apply_patch for single-file edits when practical. The apply_patch tool accepts its freeform patch language; do not wrap that patch in JSON.
 - You may be in a dirty git worktree. Never revert existing changes you did not make unless the user explicitly requests it. If unrelated files are changed, leave them alone.
 
 ## Planning
@@ -159,16 +157,10 @@ const CODEX_BASE_PROMPT = String.raw `You are Codex, based on {{model}}. You are
 ## dsh session
 
 - The user and you share one workspace. Inspect the repository and every applicable AGENTS.md before editing.
-- This session's preset was selected when the session was created and stays fixed for its lifetime. Do not attempt to switch the preset or replace its tool catalog while the session is running.
-- dsh provides the execution, filesystem, session, policy, and Skills capabilities behind these tools. Use those extension points as supplied; do not invent a second harness or bypass the filesystem service for file edits.
-- The core Codex tool names, arguments, and result formats are fixed: use exec_command for terminal work, write_stdin for an existing interactive command, apply_patch for file changes, and update_plan for multi-step tasks.
 
 ## Task execution
 
 - Keep the user informed with concise progress updates and lead with the result.
-- Prefer existing functions and extension points over new machinery.
-- Do not claim that a command, edit, or test succeeded unless it actually succeeded.
-- Use the exact tool names and argument formats supplied by this session; do not invent replacement editing tools.
 
 ## Presenting your work
 
@@ -185,7 +177,18 @@ const CODEX_COLLABORATION_PROMPT = String.raw `## Collaboration
 - Solve problems by thinking from first principles and at a higher level.
 - Make things as effortless as possible for the user.
 `;
-/** Build the Codex system prompt with optional, user-enabled collaboration guidance. */
+/** Put the agent persona first and omit the generic Harness identity opener. */
+export function normalizeCodexPromptAssembly(assembly) {
+    const sections = assembly.sections.filter(section => section.name !== 'harness:identity');
+    const persona = sections.find(section => section.name === 'deployment:persona');
+    if (persona === undefined)
+        return { ...assembly, sections };
+    return {
+        ...assembly,
+        sections: [persona, ...sections.filter(section => section.name !== 'deployment:persona')],
+    };
+}
+/** Build the Codex operating prompt with optional, user-enabled collaboration guidance. */
 export function buildCodexSystemPrompt(config = {}) {
     return config.collaborationPrompt === true
         ? `${CODEX_BASE_PROMPT}\n\n${CODEX_COLLABORATION_PROMPT}`
@@ -193,7 +196,7 @@ export function buildCodexSystemPrompt(config = {}) {
 }
 const EXEC_COMMAND_DESCRIPTION = 'Runs a command in a PTY, returning output or a session ID for ongoing interaction.';
 const WRITE_STDIN_DESCRIPTION = 'Writes characters to an existing unified exec session and returns recent output.';
-const APPLY_PATCH_DESCRIPTION = 'The `apply_patch` tool can be used to edit files. This is a FREEFORM tool, so do not wrap the patch in JSON.';
+const APPLY_PATCH_DESCRIPTION = 'Edits files using a patch.';
 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) {
@@ -485,6 +488,7 @@ export function apply(ctx, config = {}) {
             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);
     registerPatchTool(ctx);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shuind/dsh-codex-harness",
-  "version": "0.1.19",
-  "description": "A minimal Codex harness for GPT models that do not fit DSH's native interface, while remaining compatible with the DSH plugin ecosystem.",
+  "version": "0.1.20",
+  "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",
   "types": "lib/types/index.d.ts",

package/presets/codex/agent.cordis.yml

@@ -4,6 +4,7 @@
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
+    # Keep identity, model, cwd, and runtime context in one persona section.
     text: >-
       You are Codex, a coding agent based on the {{model}} model. Your working directory is {{cwd}}.
     includeRuntimeContext: true

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