dsh-parallel-tools-prompt 0.2.1-rc.2 → 0.2.1-rc.4

package/README.md

@@ -10,7 +10,8 @@
 - 使用公开 `agent/created`、`agents.roots()`、session projection 与 `systemPrompt.section()`，不替换 preset。
 - 固定 section 名称 `parallel-tools:guidance`、order 1050、禁止插值；不注入时间戳、工具列表或每轮变化的数据。
 - 同一 Agent 幂等注册；插件卸载与 Agent 释放都清理 section。插件重载时为仍存活的目标根 Agent 补挂 section；源码更新建议重启宿主加载新模块。
-- bundle 默认开启 `contextReminder`：通过公开 `agent.inject()` 在下一步骤边界注入一次带 `[parallel-tools:scheduling]` 标记的对话提醒，强调提前规划就绪批次以减少模型往返。直接使用插件时此选项默认关闭。提醒进入会话历史，卸载不会删除；已持久化标记用于避免重复注入。这不是每轮重复提醒，也不保证长期遵循。
+- 两个独立开关选择注入通道（默认只走系统提示词）：`systemPromptSection`（默认 `true`，注册 `systemPrompt.section()`）与 `contextReminder`（默认 `false`）。后者通过 `agent/pre-step` 在下一步骤追加一条带独立 `source.kind: parallel-tools-scheduling` 的 CONTEXT 提醒，写入会话历史并渲染为 CONTEXT 块，与宿主 `time-context` 同一机制；已持久化的 source 用于避免重复注入，每个 Agent 只交付一次。两者可同时开启；同时关闭则插件不注入任何内容。提醒进入历史，卸载不会删除。这不是每轮重复提醒，也不保证长期遵循。
+- 插件详情页（Plugins → 本插件）在描述与组件列表之间提供这两个开关的设置表单，开关即时写入当前 profile 的 patch。两个字段声明为 `.volatile()`，修改不重启插件：`contextReminder` 在下一步骤生效；系统提示词开关对修改之后重新组装提示词的会话生效（已建立的会话沿用旧提示词）。浏览器端由 `src/client` 经 `scripts/build-client.mjs` 构建为 `lib/client.js`，按宿主客户端模块格式封装；表单要求 profile 里条目 id 为 `parallel-tools-prompt`。
 - 单次调用合理时仍单次；路径、ID等参数必须已知；读后写、共享文件冲突、权限审批保持依赖顺序。不发明batch工具或额外规划轮次。
 - 同轮多个工具调用不代表真正同时执行；执行并发仍由DSH调度器决定。
 
@@ -22,6 +23,12 @@
 
 建议使用 `npm ci` 配合 npm lock，避免交替更新两种锁文件。包发布白名单包含构建产物、bundle patch、README、许可证与分析脚本，不包含测试、原始会话或调试捕获。`prepack` 自动构建；预发布默认 `next` tag。确认版本未占用后由维护者执行 `npm publish`；已发布版本不能覆盖。
 
+## 作为 skill 分发（其他 agent 工具）
+
+[`skills/batch-tool-calls/SKILL.md`](skills/batch-tool-calls/SKILL.md) 把规则直接写进 `description`：skill 目录里只有这一行描述常驻上下文，因此核心规则无需模型主动加载 skill 就可见；正文是同一规则的展开。复制该目录到支持 skill 的 agent 的 skills 目录即可。
+
+边界：描述在目录中可能被截断，规则放在最前面；是否遵循取决于模型与工具对 skill 目录的处理，尚未在 DSH 之外验证。不支持 skill 的工具，可把正文复制进 `AGENTS.md` / `CLAUDE.md` 等常驻指令文件。
+
 ## 开发与安装
 
 尚未发布 npm；已在本地 Web profile 链接安装并进行人工观察。一次探索任务出现连续多调用批次，但模型同时发生切换，不能据此归因于插件或宣称 token/费用节省。
@@ -40,11 +47,12 @@ npm pack --dry-run
 
 ```yaml
 enabled: true
-contextReminder: true
+systemPromptSection: true   # 默认；系统提示词通道
+contextReminder: false      # 默认；设为 true 启用 CONTEXT 提醒通道
 presetIds: [standard]
 ```
 
-**注意：profile 的 `cordis.patch.yml` 覆盖本插件时，`config` 是整体替换、不与 bundle 默认值深合并。** 覆盖项必须写全需要的字段（至少 `enabled: true`、`presetIds`），否则 `enabled` 回落为默认 `false`，插件静默不注入。验收方式：新会话的 `system/message` 中应出现 `Tool-call scheduling:`。
+**注意：profile 的 `cordis.patch.yml` 覆盖本插件时，`config` 是整体替换、不与 bundle 默认值深合并。** 覆盖项必须写全需要的字段（至少 `enabled: true`、`presetIds`），否则 `enabled` 回落为默认 `false`，插件静默不注入。验收方式：系统提示词通道看新会话 `system/message` 中是否出现 `Tool-call scheduling:`；CONTEXT 通道看会话里是否出现 `source.kind` 为 `parallel-tools-scheduling` 的消息。
 
 `presetIds` 是精确ID列表，不是正则。自定义目标仅适用于原生工具调用preset；不要把PTC加入以免对专用执行模式施加不合适的指导。根会话fork可以保留历史parentSession，不会仅因此被当作子智能体。
 

package/cordis.patch.yml

@@ -1,9 +1,10 @@
 # Installing/enabling this bundle is the explicit opt-in. Direct plugin use
-# defaults to enabled:false. No preset replacement or scheduler changes.
+# defaults to enabled:false. Guidance goes into the system prompt by default;
+# add `contextReminder: true` for the CONTEXT-message channel (or
+# `systemPromptSection: false` to use only that channel). No preset replacement or scheduler changes.
 - insert:
     - id: parallel-tools-prompt
       name: dsh-parallel-tools-prompt
       config:
         enabled: true
-        contextReminder: true
         presetIds: [standard]

package/lib/client.js

@@ -0,0 +1,112 @@
+window.__ModuleLoader__.load({
+	id: "dsh-parallel-tools-prompt",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		"use strict";
+		var __defProp = Object.defineProperty;
+		var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+		var __getOwnPropNames = Object.getOwnPropertyNames;
+		var __hasOwnProp = Object.prototype.hasOwnProperty;
+		var __export = (target, all) => {
+		  for (var name in all)
+		    __defProp(target, name, { get: all[name], enumerable: true });
+		};
+		var __copyProps = (to, from, except, desc) => {
+		  if (from && typeof from === "object" || typeof from === "function") {
+		    for (let key of __getOwnPropNames(from))
+		      if (!__hasOwnProp.call(to, key) && key !== except)
+		        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+		  }
+		  return to;
+		};
+		var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+		// src/client/index.ts
+		var index_exports = {};
+		__export(index_exports, {
+		  apply: () => apply,
+		  inject: () => inject
+		});
+		module.exports = __toCommonJS(index_exports);
+		var import_jsx_runtime = require("react/jsx-runtime");
+		var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		var inject = ["slots", "locale", "configForms"];
+		var PACKAGE = "dsh-parallel-tools-prompt";
+		var NAMESPACE = "parallel-tools-prompt";
+		var LOCALE = "settings.parallelToolsPrompt";
+		var en = {
+		  systemPrompt: "Inject into system prompt",
+		  systemPromptHint: "Static guidance section in the system prompt (default on). Applies to sessions that assemble their prompt after the change.",
+		  context: "Inject as context message",
+		  contextHint: "One-time CONTEXT message delivered at the next step, kept in the session history.",
+		  note: "Both can be on together; with both off the plugin injects nothing.",
+		  unavailable: "The plugin is not loaded or its settings are not served, so it cannot be configured right now.",
+		  readOnly: "This deployment stores settings read-only."
+		};
+		var zh = {
+		  systemPrompt: "\u6CE8\u5165\u5230\u7CFB\u7EDF\u63D0\u793A\u8BCD",
+		  systemPromptHint: "\u5728\u7CFB\u7EDF\u63D0\u793A\u8BCD\u4E2D\u52A0\u5165\u56FA\u5B9A\u7684\u8C03\u5EA6\u6307\u5F15\uFF08\u9ED8\u8BA4\u5F00\u542F\uFF09\u3002\u5BF9\u4FEE\u6539\u4E4B\u540E\u91CD\u65B0\u7EC4\u88C5\u63D0\u793A\u8BCD\u7684\u4F1A\u8BDD\u751F\u6548\u3002",
+		  context: "\u4EE5 CONTEXT \u6D88\u606F\u6CE8\u5165",
+		  contextHint: "\u5728\u4E0B\u4E00\u6B65\u9AA4\u9001\u8FBE\u4E00\u6761 CONTEXT \u6D88\u606F\uFF0C\u5E76\u4FDD\u7559\u5728\u4F1A\u8BDD\u5386\u53F2\u4E2D\u3002",
+		  note: "\u4E24\u8005\u53EF\u540C\u65F6\u5F00\u542F\uFF1B\u90FD\u5173\u95ED\u65F6\u63D2\u4EF6\u4E0D\u6CE8\u5165\u4EFB\u4F55\u5185\u5BB9\u3002",
+		  unavailable: "\u63D2\u4EF6\u672A\u52A0\u8F7D\u6216\u5176\u8BBE\u7F6E\u672A\u63D0\u4F9B\uFF0C\u6682\u65F6\u65E0\u6CD5\u914D\u7F6E\u3002",
+		  readOnly: "\u672C\u90E8\u7F72\u7684\u8BBE\u7F6E\u4E3A\u53EA\u8BFB\u3002"
+		};
+		var rowStyle = { display: "flex", alignItems: "center", justifyContent: "space-between", gap: 16, padding: "10px 0" };
+		var hintStyle = { fontSize: 12, opacity: 0.7, marginTop: 2 };
+		function Row(props) {
+		  return (0, import_jsx_runtime.jsxs)("div", {
+		    style: rowStyle,
+		    children: [
+		      (0, import_jsx_runtime.jsxs)("div", { children: [(0, import_jsx_runtime.jsx)("div", { children: props.title }), (0, import_jsx_runtime.jsx)("div", { style: hintStyle, children: props.hint })] }),
+		      (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Switch, { checked: props.checked, label: props.title, disabled: props.disabled, onChange: props.onChange })
+		    ]
+		  });
+		}
+		function Card(props) {
+		  const { t } = props;
+		  const form = props.useConfig((view) => view);
+		  if (form.status !== "ready") return (0, import_jsx_runtime.jsx)("div", { style: hintStyle, children: t("unavailable") });
+		  const values = form.value ?? {};
+		  const disabled = form.writable !== true;
+		  return (0, import_jsx_runtime.jsxs)("div", {
+		    children: [
+		      Row({
+		        title: t("systemPrompt"),
+		        hint: t("systemPromptHint"),
+		        disabled,
+		        checked: values["systemPromptSection"] !== false,
+		        onChange: (checked) => props.setField("systemPromptSection", checked)
+		      }),
+		      Row({
+		        title: t("context"),
+		        hint: t("contextHint"),
+		        disabled,
+		        checked: values["contextReminder"] === true,
+		        onChange: (checked) => props.setField("contextReminder", checked)
+		      }),
+		      (0, import_jsx_runtime.jsx)("div", { style: hintStyle, children: disabled ? t("readOnly") : t("note") })
+		    ]
+		  });
+		}
+		function apply(ctx) {
+		  ctx.effect(() => ctx.locale.register(LOCALE, { en, zh }));
+		  const form = ctx.configForms.get(NAMESPACE);
+		  const face = () => ({
+		    hooks: { config: form },
+		    setField: (field, value) => {
+		      void form.set(field, value);
+		    }
+		  });
+		  ctx.effect(() => ctx.configForms.whileServed([NAMESPACE], () => ctx.slots.inject("plugins.bundle.config", () => ctx.slots.register({
+		    name: "plugins.bundle.config",
+		    key: PACKAGE,
+		    locale: LOCALE,
+		    inject: face
+		  }, Card))));
+		}
+		return module.exports;
+	}
+});

package/lib/index.d.ts

@@ -1,18 +1,29 @@
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
-export { PARALLEL_TOOLS_PROMPT, SECTION_NAME, SECTION_ORDER } from './prompt.js';
+export { BATCH_RULE, PARALLEL_TOOLS_PROMPT, SECTION_NAME, SECTION_ORDER } from './prompt.js';
 export declare const name = "parallel-tools-prompt";
 export declare const inject: string[];
-/** Stable marker so a reload never injects the reminder twice into one session. */
-export declare const CONTEXT_MARKER = "[parallel-tools:scheduling]";
-export declare const CONTEXT_REMINDER = "[parallel-tools:scheduling] Every response: before answering, check what else the current subgoal already has ready and issue ALL ready, independent tool calls together in this one response \u2014 same-tool calls on different targets, parallel reads, independent searches and checks. Each response is one model round trip; issuing ready work one call at a time spends one round trip per call. Hold a call only for real dependencies: its arguments need an earlier result, read-before-edit, shared-file or approval ordering. A single call is fine when nothing else is ready; never invent calls to fill a batch.";
+/** Model-facing text of the optional context-channel reminder. */
+export declare const CONTEXT_REMINDER = "Every response: before answering, check what else the current subgoal already has ready and issue ALL ready, independent tool calls together in this one response \u2014 same-tool calls on different targets, parallel reads, independent searches and checks. Each response is one model round trip; issuing ready work one call at a time spends one round trip per call. Hold a call only for real dependencies: its arguments need an earlier result, read-before-edit, shared-file or approval ordering. A single call is fine when nothing else is ready; never invent calls to fill a batch.";
+/** Source kind of the reminder message; the host renders unknown context kinds as CONTEXT blocks. */
+export declare const CONTEXT_SOURCE_KIND = "parallel-tools-scheduling";
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        [CONTEXT_SOURCE_KIND]: {
+            kind: typeof CONTEXT_SOURCE_KIND;
+            form: 'notice';
+            summary: string;
+        };
+    }
+}
 export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     debugEnabled: z<boolean, boolean, "defined">;
     debugSessionId: z<string, string, "defined">;
     debugOutputDir: z<string, string, "defined">;
     debugMaxCalls: z<number, number, "defined">;
     enabled: z<boolean, boolean, "defined">;
-    contextReminder: z<boolean, boolean, "defined">;
+    systemPromptSection: z<boolean, boolean, "volatile-defined">;
+    contextReminder: z<boolean, boolean, "volatile-defined">;
     presetIds: z<string[], string[], "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     debugEnabled: z<boolean, boolean, "defined">;
@@ -20,7 +31,8 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     debugOutputDir: z<string, string, "defined">;
     debugMaxCalls: z<number, number, "defined">;
     enabled: z<boolean, boolean, "defined">;
-    contextReminder: z<boolean, boolean, "defined">;
+    systemPromptSection: z<boolean, boolean, "volatile-defined">;
+    contextReminder: z<boolean, boolean, "volatile-defined">;
     presetIds: z<string[], string[], "defined">;
 }>>, "plain">;
 export type Config = ReturnType<typeof Config>;

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAIzC,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjF,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,MAAM,UAAmD,CAAC;AAEvE,mFAAmF;AACnF,eAAO,MAAM,cAAc,gCAAgC,CAAC;AAC5D,eAAO,MAAM,gBAAgB,qmBAAslB,CAAC;AAEpnB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;aAejB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AA4D/C,8EAA8E;AAC9E,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAiCxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAKzC,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7F,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,MAAM,UAAmD,CAAC;AAEvE,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,ykBAAokB,CAAC;AAElmB,qGAAqG;AACrG,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,gBAAgB;QACxB,CAAC,mBAAmB,CAAC,EAAE;YAAE,IAAI,EAAE,OAAO,mBAAmB,CAAC;YAAC,IAAI,EAAE,QAAQ,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9F;CACF;AASD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;aAkBjB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AAuD/C,8EAA8E;AAC9E,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAyDxD"}

package/lib/index.js

@@ -2,29 +2,40 @@ import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import z from '@deepseek-ai/schemastery';
 import { PARALLEL_TOOLS_PROMPT, SECTION_NAME, SECTION_ORDER } from './prompt.js';
 import { installPromptDebug } from './debug.js';
-export { PARALLEL_TOOLS_PROMPT, SECTION_NAME, SECTION_ORDER } from './prompt.js';
+export { BATCH_RULE, PARALLEL_TOOLS_PROMPT, SECTION_NAME, SECTION_ORDER } from './prompt.js';
 export const name = 'parallel-tools-prompt';
 export const inject = ['agents', 'systemPrompt', 'sessionProjections'];
-/** Stable marker so a reload never injects the reminder twice into one session. */
-export const CONTEXT_MARKER = '[parallel-tools:scheduling]';
-export const CONTEXT_REMINDER = `${CONTEXT_MARKER} Every response: before answering, check what else the current subgoal already has ready and issue ALL ready, independent tool calls together in this one response — same-tool calls on different targets, parallel reads, independent searches and checks. Each response is one model round trip; issuing ready work one call at a time spends one round trip per call. Hold a call only for real dependencies: its arguments need an earlier result, read-before-edit, shared-file or approval ordering. A single call is fine when nothing else is ready; never invent calls to fill a batch.`;
+/** Model-facing text of the optional context-channel reminder. */
+export const CONTEXT_REMINDER = 'Every response: before answering, check what else the current subgoal already has ready and issue ALL ready, independent tool calls together in this one response — same-tool calls on different targets, parallel reads, independent searches and checks. Each response is one model round trip; issuing ready work one call at a time spends one round trip per call. Hold a call only for real dependencies: its arguments need an earlier result, read-before-edit, shared-file or approval ordering. A single call is fine when nothing else is ready; never invent calls to fill a batch.';
+/** Source kind of the reminder message; the host renders unknown context kinds as CONTEXT blocks. */
+export const CONTEXT_SOURCE_KIND = 'parallel-tools-scheduling';
+/** True when the session transcript already carries our sourced reminder. */
+function hasReminder(agent) {
+    return agent.session.snapshotEvents().some(event => event.type === 'user/message'
+        && event.data?.source?.kind === CONTEXT_SOURCE_KIND);
+}
 export const Config = z.object({
     debugEnabled: z.boolean().default(false).description('Capture normalized LLM system prompts locally, only with an explicit session and enable sentinel. Sensitive: disable after diagnosis.'),
     debugSessionId: z.string().default(''),
     debugOutputDir: z.string().default(''),
     debugMaxCalls: z.natural().min(1).max(10).default(3),
     enabled: z.boolean().default(false).description('Enable static tool-call scheduling guidance. The bundle explicitly opts in; direct plugin use is disabled by default.'),
-    contextReminder: z.boolean().default(false).description('Additionally inject a one-time scheduling reminder as model-facing conversation context at the next step boundary. Persists in the session transcript; survives reloads without duplication.'),
+    systemPromptSection: z.boolean().default(true).volatile().description('Inject the static scheduling guidance as a system-prompt section (default true). May be combined with contextReminder; with both off the plugin injects nothing.'),
+    contextReminder: z.boolean().default(false).volatile().description('Inject a one-time scheduling reminder as a CONTEXT message at the next step boundary (default false). Persists in the session transcript; never duplicated across reloads. Independent of systemPromptSection.'),
     presetIds: z.array(z.string().pattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/))
         .max(32).default(['standard']).description('Exact preset IDs to target at agent creation. Root agents only; use native-tool presets, not PTC. An empty list disables all targets.'),
 });
+/** Read a switch live: volatile fields are references whose value may change without a reload. */
+function flag(value) {
+    return typeof value === 'boolean' ? value : value.get();
+}
 /**
  * Attach or re-attach the guidance section to one already-eligible live agent.
  * Idempotent via the registration guard; shared by `agent/created` and
  * reload-time catch-up, so a plugin reload cannot silently drop guidance from
  * agents that survive it (the old instance's disposal removed its sections).
  */
-function attach(ctx, agent, config, presetIds, registrations, active) {
+function attach(ctx, agent, config, presetIds, registrations, active, reminderAgents) {
     if (registrations.has(agent))
         return;
     const { header } = agent.session;
@@ -38,34 +49,24 @@ function attach(ctx, agent, config, presetIds, registrations, active) {
         ?? header.agentPreset;
     if (preset === undefined || !presetIds.has(preset))
         return;
-    // Conversation-level reminder: rides model-facing context at the nearest step
-    // boundary and persists in the transcript, so it stays proximal to generation.
-    // The transcript scan keeps reloads from stacking duplicate reminders.
-    if (config.contextReminder) {
-        try {
-            const already = agent.session.snapshotEvents().some(event => event.type === 'user/message' && JSON.stringify(event.data?.content ?? '').includes(CONTEXT_MARKER));
-            if (!already) {
-                agent.inject(createUserMessage({
-                    content: [{ type: 'text', text: CONTEXT_REMINDER }],
-                    source: { kind: 'user' },
-                }));
-            }
-        }
-        catch { /* reminder must never break attach */ }
-    }
+    // Conversation-level reminder: appended by the pre-step listener below once
+    // this agent is eligible (agent.inject only accepts user-kind messages).
+    reminderAgents.add(agent);
     const registration = {};
     // Returning the disposer is essential: ctx.effect does not implicitly adopt
     // arbitrary registrations executed inside its callback on another fiber.
     registration.release = agent.ctx.effect(() => {
+        // Registered unconditionally; the text is resolved at assembly time, so the
+        // switch applies the next time the host assembles a system prompt.
         const disposeSection = agent.ctx.systemPrompt.section({
             name: SECTION_NAME,
             order: SECTION_ORDER,
             interpolate: false,
-            text: PARALLEL_TOOLS_PROMPT,
+            text: () => (flag(config.systemPromptSection) ? PARALLEL_TOOLS_PROMPT : ''),
         });
         return () => {
             try {
-                return disposeSection();
+                return disposeSection?.();
             }
             finally {
                 registrations.delete(agent);
@@ -87,6 +88,7 @@ export function apply(ctx, config) {
     const presetIds = new Set(config.presetIds);
     const registrations = new WeakMap();
     const active = new Set();
+    const reminderAgents = new WeakSet();
     // Agent contexts are not children of this plugin's fiber. Explicitly give the
     // plugin ownership of their effect disposers as well as agent-local ownership.
     ctx.effect(() => async () => {
@@ -94,8 +96,32 @@ export function apply(ctx, config) {
             await registration.release?.();
         active.clear();
     });
+    // Same channel the host's own context plugins (e.g. time-context) use: after
+    // downstream listeners accept the step, append one sourced message to the
+    // step's messages; the host persists it and renders it as a CONTEXT block.
+    {
+        const delivered = new WeakSet();
+        ctx.on('agent/pre-step', async ({ agent, signal }, next) => {
+            const decision = await next();
+            if (decision.kind === 'reject' || signal.aborted)
+                return decision;
+            if (!flag(config.contextReminder) || !reminderAgents.has(agent) || delivered.has(agent))
+                return decision;
+            const present = hasReminder(agent) || decision.messages.some(m => m.source.kind === CONTEXT_SOURCE_KIND);
+            delivered.add(agent);
+            if (present)
+                return decision;
+            return {
+                ...decision,
+                messages: [...decision.messages, createUserMessage({
+                        content: [{ type: 'text', text: CONTEXT_REMINDER }],
+                        source: { kind: CONTEXT_SOURCE_KIND, form: 'notice', summary: 'Parallel tool-call scheduling reminder' },
+                    })],
+            };
+        }, { prepend: true });
+    }
     ctx.on('agent/created', ({ agent }) => {
-        attach(ctx, agent, config, presetIds, registrations, active);
+        attach(ctx, agent, config, presetIds, registrations, active, reminderAgents);
     });
     // A plugin reload disposes the previous instance's section registrations, and
     // the host does not replay `agent/created` for agents that stay alive. Attach
@@ -106,7 +132,7 @@ export function apply(ctx, config) {
         // previous instance's disposal. The no-op disposer satisfies the effect
         // contract; per-agent cleanup is owned by each registration instead.
         for (const agent of ctx.agents.roots())
-            attach(ctx, agent, config, presetIds, registrations, active);
+            attach(ctx, agent, config, presetIds, registrations, active, reminderAgents);
         return () => { };
     });
 }

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7F,MAAM,CAAC,MAAM,IAAI,GAAG,uBAAuB,CAAC;AAC5C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,cAAc,EAAE,oBAAoB,CAAC,CAAC;AAEvE,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG,ikBAAikB,CAAC;AAElmB,qGAAqG;AACrG,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAQ/D,6EAA6E;AAC7E,SAAS,WAAW,CAAC,KAAY;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CACjD,KAAK,CAAC,IAAI,KAAK,cAAc;WACzB,KAAK,CAAC,IAAmD,EAAE,MAAM,EAAE,IAAI,KAAK,mBAAmB,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,uIAAuI,CAAC;IAC7L,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAC7C,uHAAuH,CACxH;IACD,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,CACnE,kKAAkK,CACnK;IACD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,CAChE,gNAAgN,CACjN;IACD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;SACzE,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CACxC,uIAAuI,CACxI;CACJ,CAAC,CAAC;AAIH,kGAAkG;AAClG,SAAS,IAAI,CAAC,KAAkC;IAC9C,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;AAC1D,CAAC;AAID;;;;;GAKG;AACH,SAAS,MAAM,CAAC,GAAY,EAAE,KAAY,EAAE,MAAc,EAAE,SAAsB,EAAE,aAA2C,EAAE,MAAyB,EAAE,cAA8B;IACxL,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO;IACrC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;IACjC,yEAAyE;IACzE,4EAA4E;IAC5E,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO;IAC9E,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO;IAChD,MAAM,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC;WACtE,MAAM,CAAC,WAAW,CAAC;IACxB,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO;IAE3D,4EAA4E;IAC5E,yEAAyE;IACzE,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAE1B,MAAM,YAAY,GAAiB,EAAE,CAAC;IACtC,4EAA4E;IAC5E,yEAAyE;IACzE,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;QAC3C,4EAA4E;QAC5E,mEAAmE;QACnE,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC;YACpD,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,KAAK;YAClB,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,IAAI,CAAC;gBACH,OAAO,cAAc,EAAE,EAAE,CAAC;YAC5B,CAAC;oBAAS,CAAC;gBACT,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC3B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,MAAc;IAChD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,kBAAkB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,cAAc;YACvE,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO;IAE5B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,IAAI,OAAO,EAAuB,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAC;IACvC,MAAM,cAAc,GAAG,IAAI,OAAO,EAAS,CAAC;IAE5C,8EAA8E;IAC9E,+EAA+E;IAC/E,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;QAC1B,KAAK,MAAM,YAAY,IAAI,CAAC,GAAG,MAAM,CAAC;YAAE,MAAM,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QACvE,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAGH,6EAA6E;IAC7E,0EAA0E;IAC1E,2EAA2E;IAC3E,CAAC;QACC,MAAM,SAAS,GAAG,IAAI,OAAO,EAAS,CAAC;QACvC,GAAG,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE;YACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC;YAC9B,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,QAAQ,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACzG,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;YACzG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,OAAO;gBAAE,OAAO,QAAQ,CAAC;YAC7B,OAAO;gBACL,GAAG,QAAQ;gBACX,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;wBACjD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;wBACnD,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,wCAAwC,EAAE;qBACzG,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,GAAG,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,EAAE,KAAK,EAAE,EAAa,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAC9E,8EAA8E;IAC9E,2EAA2E;IAC3E,6DAA6D;IAC7D,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;QACd,wEAAwE;QACxE,wEAAwE;QACxE,qEAAqE;QACrE,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE;YAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QACrH,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/prompt.d.ts

@@ -1,5 +1,8 @@
 /** Stable prompt bytes: no runtime interpolation, tool inventory, or per-turn state. */
 export declare const SECTION_NAME = "parallel-tools:guidance";
 export declare const SECTION_ORDER = 1050;
-export declare const PARALLEL_TOOLS_PROMPT = "Tool-call scheduling:\n- Before each response, briefly check what else the current subgoal already has ready: same-tool calls on different targets, parallel reads, independent searches and checks. Issue every ready, independent call together in THIS response.\n- Hold a call only when its arguments depend on an earlier result, or ordering is required (read-before-edit, shared file, approval flow). A later combined decision does not make independent collection sequential.\n- A single call is correct when nothing else is ready; never invent or duplicate calls to fill a batch. Keep scheduling internal: no planning-only turn, no shell wrappers or delegation just to simulate batching.\n- Several calls in one response do not force simultaneous execution; the host scheduler, permissions, and all safety rules still apply.";
+/** Single source of truth: also the description of skills/batch-tool-calls/SKILL.md (a test keeps them identical). */
+export declare const BATCH_RULE = "Before every response that uses tools, (1) list what the current subgoal already has ready, (2) issue ALL ready, independent calls together in one response (parallel reads, searches, checks), (3) split only for real dependencies (needs an earlier result, read-before-edit, shared-file or approval order). One call per response wastes a model round trip; a single call is fine when nothing else is ready, so never invent calls to fill a batch. No planning-only turn, no shell wrappers or delegation to simulate batching.";
+/** The "Tool-call scheduling:" prefix is the verification marker searched for in system/message. */
+export declare const PARALLEL_TOOLS_PROMPT = "Tool-call scheduling: Before every response that uses tools, (1) list what the current subgoal already has ready, (2) issue ALL ready, independent calls together in one response (parallel reads, searches, checks), (3) split only for real dependencies (needs an earlier result, read-before-edit, shared-file or approval order). One call per response wastes a model round trip; a single call is fine when nothing else is ready, so never invent calls to fill a batch. No planning-only turn, no shell wrappers or delegation to simulate batching.";
 //# sourceMappingURL=prompt.d.ts.map

package/lib/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,eAAO,MAAM,YAAY,4BAA4B,CAAC;AACtD,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,eAAO,MAAM,qBAAqB,6zBAIsG,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,eAAO,MAAM,YAAY,4BAA4B,CAAC;AACtD,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,sHAAsH;AACtH,eAAO,MAAM,UAAU,4gBAA4gB,CAAC;AAEpiB,oGAAoG;AACpG,eAAO,MAAM,qBAAqB,kiBAAwC,CAAC"}

package/lib/prompt.js

@@ -1,9 +1,8 @@
 /** Stable prompt bytes: no runtime interpolation, tool inventory, or per-turn state. */
 export const SECTION_NAME = 'parallel-tools:guidance';
 export const SECTION_ORDER = 1050;
-export const PARALLEL_TOOLS_PROMPT = `Tool-call scheduling:
-- Before each response, briefly check what else the current subgoal already has ready: same-tool calls on different targets, parallel reads, independent searches and checks. Issue every ready, independent call together in THIS response.
-- Hold a call only when its arguments depend on an earlier result, or ordering is required (read-before-edit, shared file, approval flow). A later combined decision does not make independent collection sequential.
-- A single call is correct when nothing else is ready; never invent or duplicate calls to fill a batch. Keep scheduling internal: no planning-only turn, no shell wrappers or delegation just to simulate batching.
-- Several calls in one response do not force simultaneous execution; the host scheduler, permissions, and all safety rules still apply.`;
+/** Single source of truth: also the description of skills/batch-tool-calls/SKILL.md (a test keeps them identical). */
+export const BATCH_RULE = `Before every response that uses tools, (1) list what the current subgoal already has ready, (2) issue ALL ready, independent calls together in one response (parallel reads, searches, checks), (3) split only for real dependencies (needs an earlier result, read-before-edit, shared-file or approval order). One call per response wastes a model round trip; a single call is fine when nothing else is ready, so never invent calls to fill a batch. No planning-only turn, no shell wrappers or delegation to simulate batching.`;
+/** The "Tool-call scheduling:" prefix is the verification marker searched for in system/message. */
+export const PARALLEL_TOOLS_PROMPT = `Tool-call scheduling: ${BATCH_RULE}`;
 //# sourceMappingURL=prompt.js.map

package/lib/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;wIAImG,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC,sHAAsH;AACtH,MAAM,CAAC,MAAM,UAAU,GAAG,ygBAAygB,CAAC;AAEpiB,oGAAoG;AACpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,UAAU,EAAE,CAAC"}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Parallel tool scheduling",
+    "description": "Plan ready tool-call batches to reduce model round trips in DeepSeek Harness"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "并行工具调度",
+    "description": "引导模型把已就绪的工具调用合并为一批，减少 DeepSeek Harness 中的模型往返次数"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-parallel-tools-prompt",
-  "version": "0.2.1-rc.2",
+  "version": "0.2.1-rc.4",
   "description": "Plan ready tool-call batches to reduce model round trips in DeepSeek Harness",
   "repository": {
     "type": "git",
@@ -20,9 +20,11 @@
       "types": "./lib/index.d.ts",
       "import": "./lib/index.js"
     },
+    "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
     "./package.json": "./package.json"
   },
-  "files": ["lib", "cordis.patch.yml", "README.md", "LICENSE", "scripts/analyze-session.mjs"],
+  "files": ["lib", "locale", "cordis.patch.yml", "README.md", "LICENSE", "skills", "scripts/analyze-session.mjs"],
   "engines": {
     "node": ">=24.9.0",
     "dsh": ">=0.2.1-rc.3"
@@ -30,10 +32,18 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-plugin-manager"
+      ],
+      "platform": "web"
     }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node scripts/build-client.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "prepack": "npm run build"
@@ -61,6 +71,7 @@
     "@deepseek-ai/cordis-plugin-loader": "1.0.6",
     "@types/node": "^24.0.0",
     "@types/js-yaml": "^4.0.9",
+    "esbuild": "^0.28.2",
     "js-yaml": "^4.1.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"

package/skills/batch-tool-calls/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: batch-tool-calls
+description: "Before every response that uses tools, (1) list what the current subgoal already has ready, (2) issue ALL ready, independent calls together in one response (parallel reads, searches, checks), (3) split only for real dependencies (needs an earlier result, read-before-edit, shared-file or approval order). One call per response wastes a model round trip; a single call is fine when nothing else is ready, so never invent calls to fill a batch. No planning-only turn, no shell wrappers or delegation to simulate batching."
+---
+
+# Batch ready tool calls
+
+Each response is one model round trip. Issuing ready work one call at a time spends one round trip per call.
+
+Before each response:
+
+1. Check what else the current subgoal already has ready: same-tool calls on different targets, parallel reads, independent searches and checks.
+2. Issue every ready, independent call together in this one response.
+3. Hold a call only for real dependencies: its arguments need an earlier result, read-before-edit, shared-file or approval ordering.
+4. A single call is fine when nothing else is ready. Never invent calls to fill a batch.
+
+Plan the next batch after the results return; do not add a separate planning round.