@shuind/dsh-codex-harness 0.1.14 → 0.1.15

package/README.md

@@ -11,10 +11,31 @@
 - **远程搜索与压缩**：OpenAI Responses 请求默认优先使用 hosted `web_search` 和 `/responses/compact`；失败时回退到 DSH 的本地实现。
 - **上下文容量**：在 Web 中设置 `1K`–`1000K` tokens，设置值作用于下一次请求。
 
+## 可选协作提示词（私货）
+
+这段提示词默认关闭，不会注入系统提示词。需要时，在自定义 `agent.cordis.yml` 中开启：
+
+```yaml
+- id: codex-tools
+  name: '@shuind/dsh-codex-harness'
+  config:
+    collaborationPrompt: true
+```
+
+开启后，Codex preset 会在系统提示词中注入以下协作要求：
+
+```text
+Ask, align, and clarify whenever uncertainty, assumptions, tradeoffs, or decisions could materially affect the outcome.
+Understand the user's full picture, align it with your own, and leave no hidden assumptions or gaps.
+Keep only the essential logic and core actions. There's no need to explain or test what was removed or why something wasn't done.
+Convey enough valuable information with as few words as possible. Stay focused on the end goal.
+Solve problems by thinking from first principles and at a higher level.
+Make things as effortless as possible for the user.
+```
 ## 安装
 
 ```sh
-dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.14
+dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.15
 ```
 
 重启 Web，创建新会话，在模式菜单中选择 **Codex 模式**。

package/lib/index.js

@@ -726,7 +726,8 @@ const Config = z.object({
 	writeYieldTimeMs: z.number().step(1).min(0).default(250),
 	maxOutputBytes: z.number().step(1).min(1).default(64e3),
 	hostedWebSearch: z.boolean().default(true),
-	remoteCompact: z.boolean().default(true)
+	remoteCompact: z.boolean().default(true),
+	collaborationPrompt: z.boolean().default(false)
 });
 const LLM_PI_AI_SETTINGS = settingsNamespace("llm-pi-ai");
 /** Live Codex-only request controls shared by the Web controls and agent layer. */
@@ -846,15 +847,6 @@ const CODEX_BASE_PROMPT = String.raw`You are Codex, based on {{model}}. You are
 
 - 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.
 
-## Collaboration
-
-- Ask, align, and clarify whenever uncertainty, assumptions, tradeoffs, or decisions could materially affect the outcome.
-- Understand the user's full picture, align it with your own, and leave no hidden assumptions or gaps.
-- Keep only the essential logic and core actions. There's no need to explain or test what was removed or why something wasn't done.
-- Convey enough valuable information with as few words as possible. Stay focused on the end goal.
-- Solve problems by thinking from first principles and at a higher level.
-- Make things as effortless as possible for the user.
-
 ## Editing constraints
 
 - 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.
@@ -888,6 +880,19 @@ const CODEX_BASE_PROMPT = String.raw`You are Codex, based on {{model}}. You are
 - Do not dump large files into the conversation; refer to their paths.
 - Use plain text with short sections only when they improve scanability.
 `;
+const CODEX_COLLABORATION_PROMPT = String.raw`## Collaboration
+
+- Ask, align, and clarify whenever uncertainty, assumptions, tradeoffs, or decisions could materially affect the outcome.
+- Understand the user's full picture, align it with your own, and leave no hidden assumptions or gaps.
+- Keep only the essential logic and core actions. There's no need to explain or test what was removed or why something wasn't done.
+- Convey enough valuable information with as few words as possible. Stay focused on the end goal.
+- 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. */
+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.";
@@ -1257,7 +1262,8 @@ function apply(ctx, config = {}) {
 		writeYieldTimeMs: config.writeYieldTimeMs ?? 250,
 		maxOutputBytes: config.maxOutputBytes ?? 64e3,
 		hostedWebSearch: config.hostedWebSearch ?? true,
-		remoteCompact: config.remoteCompact ?? true
+		remoteCompact: config.remoteCompact ?? true,
+		collaborationPrompt: config.collaborationPrompt ?? false
 	};
 	if (ctx.fs.sandboxMode !== void 0 && ctx.get("sandboxPolicy") === void 0) throw new Error("codex: a sandboxing filesystem requires ctx.sandboxPolicy");
 	watchConfiguredGptModels(ctx);
@@ -1277,7 +1283,7 @@ function apply(ctx, config = {}) {
 	ctx.systemPrompt.section({
 		name: "codex:base",
 		order: 10,
-		text: CODEX_BASE_PROMPT
+		text: buildCodexSystemPrompt(resolved)
 	});
 	registerExecTools(ctx, resolved);
 	registerPatchTool(ctx);
@@ -1290,4 +1296,4 @@ var types_default = {
 	apply
 };
 //#endregion
-export { CODEX_SETTINGS_NAMESPACE, CODEX_SETTINGS_SCHEMA, Config, apply, applyCodexRequestSettings, 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 };

package/lib/types/index.d.ts

@@ -26,6 +26,8 @@ export interface Config {
     hostedWebSearch?: boolean;
     /** Use the provider's /responses/compact endpoint before local compaction. */
     remoteCompact?: boolean;
+    /** Inject the optional collaboration guidance into the model system prompt. */
+    collaborationPrompt?: boolean;
 }
 /** Runtime configuration schema for the Codex tool bridge. */
 export declare const Config: z<Config>;
@@ -48,6 +50,8 @@ 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. */
+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;
 declare const _default: {

package/lib/types/index.js

@@ -16,6 +16,7 @@ export const Config = z.object({
     maxOutputBytes: z.number().step(1).min(1).default(64_000),
     hostedWebSearch: z.boolean().default(true),
     remoteCompact: z.boolean().default(true),
+    collaborationPrompt: z.boolean().default(false),
 });
 const LLM_PI_AI_SETTINGS = settingsNamespace('llm-pi-ai');
 /** Live Codex-only request controls shared by the Web controls and agent layer. */
@@ -142,15 +143,6 @@ const CODEX_BASE_PROMPT = String.raw `You are Codex, based on {{model}}. You are
 
 - 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.
 
-## Collaboration
-
-- Ask, align, and clarify whenever uncertainty, assumptions, tradeoffs, or decisions could materially affect the outcome.
-- Understand the user's full picture, align it with your own, and leave no hidden assumptions or gaps.
-- Keep only the essential logic and core actions. There's no need to explain or test what was removed or why something wasn't done.
-- Convey enough valuable information with as few words as possible. Stay focused on the end goal.
-- Solve problems by thinking from first principles and at a higher level.
-- Make things as effortless as possible for the user.
-
 ## Editing constraints
 
 - 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.
@@ -184,6 +176,21 @@ const CODEX_BASE_PROMPT = String.raw `You are Codex, based on {{model}}. You are
 - Do not dump large files into the conversation; refer to their paths.
 - Use plain text with short sections only when they improve scanability.
 `;
+const CODEX_COLLABORATION_PROMPT = String.raw `## Collaboration
+
+- Ask, align, and clarify whenever uncertainty, assumptions, tradeoffs, or decisions could materially affect the outcome.
+- Understand the user's full picture, align it with your own, and leave no hidden assumptions or gaps.
+- Keep only the essential logic and core actions. There's no need to explain or test what was removed or why something wasn't done.
+- Convey enough valuable information with as few words as possible. Stay focused on the end goal.
+- 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. */
+export 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.';
@@ -443,6 +450,7 @@ export function apply(ctx, config = {}) {
         maxOutputBytes: config.maxOutputBytes ?? 64_000,
         hostedWebSearch: config.hostedWebSearch ?? true,
         remoteCompact: config.remoteCompact ?? true,
+        collaborationPrompt: config.collaborationPrompt ?? false,
     };
     if (ctx.fs.sandboxMode !== undefined && ctx.get('sandboxPolicy') === undefined) {
         throw new Error('codex: a sandboxing filesystem requires ctx.sandboxPolicy');
@@ -476,7 +484,7 @@ export function apply(ctx, config = {}) {
             return next();
         }));
     }
-    ctx.systemPrompt.section({ name: 'codex:base', order: 10, text: CODEX_BASE_PROMPT });
+    ctx.systemPrompt.section({ name: 'codex:base', order: 10, text: buildCodexSystemPrompt(resolved) });
     registerExecTools(ctx, resolved);
     registerPatchTool(ctx);
     registerPlanTool(ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuind/dsh-codex-harness",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "A minimal Codex harness for GPT models that do not fit DSH's native interface, while remaining compatible with the DSH plugin ecosystem.",
   "type": "module",
   "main": "lib/index.js",

package/presets/codex/agent.cordis.yml

@@ -17,6 +17,8 @@
 # and the four Codex core tool names; execution remains delegated to dsh.
 - id: codex-tools
   name: '@shuind/dsh-codex-harness'
+  config:
+    collaborationPrompt: false
 
 # 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