@yeaft/webchat-agent 1.0.426 → 1.0.427

package/local-runtime/version.json

@@ -1 +1 @@
-{"version":"1.0.426"}
+{"version":"1.0.427"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "1.0.426",
+  "version": "1.0.427",
   "description": "Remote worker agent for Yeaft Web Code Agent — connects the native Yeaft engine, CLI providers, and workbench tools",
   "main": "index.js",
   "type": "module",

package/yeaft/prompts.js

@@ -472,9 +472,9 @@ const TOOL_GUIDANCE_GROUPS = Object.freeze([
     zh: 'Shell 命令保持非交互、确定性并设置合理 timeout；包含空格的路径要引用，未经授权不要执行破坏性操作。',
   },
   {
-    tools: ['StartPlan', 'TodoWrite'],
-    en: 'For non-trivial multi-step work, use `StartPlan` before execution and keep the visible `TodoWrite` checklist current; do not stop after planning unless user input genuinely blocks the first step.',
-    zh: '非平凡多步骤任务在执行前使用 `StartPlan`，并持续更新可见的 `TodoWrite` checklist；只有用户信息确实阻塞第一步时才在规划后停下。',
+    tools: ['TodoWrite'],
+    en: 'For non-trivial multi-step work, write a brief visible plan and call `TodoWrite` in the same assistant response as the first independent work tools. Do not spend a separate model round entering planning mode, and do not stop after planning unless user input genuinely blocks the first step.',
+    zh: '非平凡多步骤任务先写简短可见计划，并在同一个 assistant response 中把 `TodoWrite` 与第一批独立工作工具一起发出。不要用单独的模型回合进入规划模式；只有用户信息确实阻塞第一步时才在规划后停下。',
   },
   {
     tools: ['SpawnAgent', 'PromptAgent', 'WaitAgent', 'CloseAgent', 'ListAgents'],

package/yeaft/tools/activation.js

@@ -20,7 +20,6 @@ export const ALWAYS_VISIBLE_TOOL_NAMES = Object.freeze([
   'Glob',
   'Grep',
   'ListDir',
-  'StartPlan',
   'TodoWrite',
   'ViewImage',
 ]);
@@ -52,6 +51,11 @@ export const CONDITIONAL_BUILTIN_TOOL_NAMES = new Set([
   'ListAgents',
   'RouteForward',
   'CreateWorkItem',
+  // Legacy compatibility only. New planning is a single provider response:
+  // visible prose + TodoWrite + the first independent work tools. Keeping the
+  // definition registered lets old direct callers resolve it without paying a
+  // dedicated StartPlan -> provider -> TodoWrite round trip on every new task.
+  'StartPlan',
   'JsRepl',
   'NotebookEdit',
   'ImageGeneration',

package/yeaft/tools/todo-write.js

@@ -33,6 +33,11 @@ WHEN TO USE:
 - The user gave you a list of things to do (numbered/comma-separated), or
 - You're about to start a non-trivial, multi-file change.
 
+FIRST CALL — PLAN WITHOUT AN EXTRA MODEL ROUND:
+- Write a short visible prose plan in the same assistant response: problem, approach, and risks.
+- Call TodoWrite directly; do not call a separate planning-mode tool first.
+- If the first work tools and arguments are known, emit them beside TodoWrite in that same response.
+
 HOW TO USE:
 - First call: enumerate all the todos with status "pending", set exactly one to "in_progress".
 - Each subsequent call: rewrite the FULL list — mark the just-finished item "completed", mark the next item "in_progress".
@@ -53,6 +58,11 @@ WHEN NOT TO USE:
 - 用户给了你一份待办列表（编号/逗号分隔），或
 - 你即将开始一个非平凡的多文件改动。
 
+首次调用——不要浪费额外模型回合进入规划模式：
+- 在同一个 assistant response 中先写简短可见计划：问题、方案和风险。
+- 直接调用 TodoWrite，不要先调用单独的规划模式工具。
+- 如果第一批工作工具及参数已经确定，把它们和 TodoWrite 在同一响应中发出。
+
 如何使用：
 - 首次调用：枚举所有 todo，状态为 "pending"，将其中恰好一个设为 "in_progress"。
 - 每次后续调用：重写完整列表——将刚完成的项标记为 "completed"，将下一项标记为 "in_progress"。