zames_pro 2.69.0 → 2.71.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.71.0] - 2026-10-08
+
+### Added
+
+- **subagent:** add the Task tool, enable subagents by default and instruct the model when to delegate
+
+## [2.70.0] - 2026-10-08
+
+### Added
+
+- **browser:** centralize DeepSeek UI constants and add a UI health probe
+
 ## [2.69.0] - 2026-10-08
 
 ### Changed

package/README.md

@@ -100,6 +100,10 @@ Key pieces:
 - **Project context** — reads `AGENTS.md`, `MEMORY.md`, skills (`SKILL.md`) and
   custom commands from the repo and `~/.zames`, the same idea as Codex / Claude
   Code.
+- **Subagents** — the `Task` tool delegates a self-contained sub-task to an
+  agent in its own separate chat (isolated context), which returns only a
+  report, so heavy research does not flood the main context. On by default;
+  tune with `browser.subagents` / `browser.maxSubagents`.
 - **MCP support** — plug in external tool servers (e.g. `@playwright/mcp`).
 - **Scheduling** — `/loop`, `/cron` and `/jobs` repeat tasks on a timer.
 - **Bilingual UI** — Russian / English (`/config lang`).
@@ -573,6 +577,10 @@ zames не вызывает API модели. Он запускает headless C
 - **Контекст проекта** — читает `AGENTS.md`, `MEMORY.md`, навыки (`SKILL.md`) и
   пользовательские команды из репозитория и `~/.zames`, как в Codex / Claude
   Code.
+- **Субагенты** — инструмент `Task` поручает самодостаточную подзадачу агенту
+  в отдельном чате (изолированный контекст), который возвращает только отчёт,
+  так что тяжёлая разведка не засоряет основной контекст. Включены по
+  умолчанию; настраиваются через `browser.subagents` / `browser.maxSubagents`.
 - **Поддержка MCP** — подключение внешних серверов инструментов (например,
   `@playwright/mcp`).
 - **Планировщик** — `/loop`, `/cron` и `/jobs` повторяют задачи по таймеру.

package/dist/agent-loop.js

@@ -7,7 +7,7 @@ import { substituteAttachmentMarkers } from './commands.js';
 import { normText } from './browser.js';
 import { loadHooks, runPreToolUse, runPostToolUse, } from './hooks.js';
 import { loadPermissions, decidePermission, } from './permissions.js';
-export async function runAgentLoop({ browser, tools, task, workdir, maxIterations = 0, freshChat = false, sendSystemPrompt = false, transcript = null, attachments = [], onThinking = () => { }, onSendPause = () => { }, onSendState = () => { }, onNotice = () => { }, onAssistantThought = () => { }, onToolCall = () => { }, onToolResult = () => { }, onAssistantMessage = () => { }, onChatReady = () => { }, onWarning = () => { }, debugLog = false, locale = 'ru', askDeadlineMs = 240_000, maxAfterToolRetries = 6, onAutoCompact = null, autoCompactPct = 95, contextLimit = 1_000_000, getTokenUsage = null, hooks = undefined, permissions = undefined, onAskPermission = undefined, selfImprovement = false, }) {
+export async function runAgentLoop({ browser, tools, task, workdir, maxIterations = 0, freshChat = false, sendSystemPrompt = false, transcript = null, attachments = [], onThinking = () => { }, onSendPause = () => { }, onSendState = () => { }, onNotice = () => { }, onAssistantThought = () => { }, onToolCall = () => { }, onToolResult = () => { }, onAssistantMessage = () => { }, onChatReady = () => { }, onWarning = () => { }, debugLog = false, locale = 'ru', askDeadlineMs = 240_000, maxAfterToolRetries = 6, onAutoCompact = null, autoCompactPct = 95, contextLimit = 1_000_000, getTokenUsage = null, hooks = undefined, permissions = undefined, onAskPermission = undefined, selfImprovement = false, onSubagent = null, }) {
     // Resolve the hook config ONCE per task: a read per tool call would be
     // wasteful, and a mid-task edit of hooks.json is not something to chase.
     // `undefined` means "read .zames/hooks.json"; an explicit null disables
@@ -705,6 +705,76 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
             continue;
         }
         for (const call of callsToRun) {
+            // `Task` is a SEAM, not an ordinary tool: it is handled by the caller's
+            // onSubagent callback (a separate chat with its own context). It is not
+            // in `tools` when subagents are disabled, so it is matched by name here
+            // BEFORE the unknown-tool branch. With no callback we answer honestly
+            // instead of pretending the tool exists.
+            if (call.tool === 'Task') {
+                const rawPrompt = typeof call.args.prompt === 'string' ? call.args.prompt.trim() : '';
+                const rawType = String(call.args.subagent_type ?? '').toLowerCase();
+                const subType = rawType === 'explore' ? 'explore' : 'general';
+                const rawDesc = typeof call.args.description === 'string' ? call.args.description : '';
+                if (!onSubagent || !rawPrompt) {
+                    const err = !onSubagent
+                        ? 'Subagents are not available in this run. Do the work yourself with the other tools.'
+                        : 'Task requires a non-empty `prompt` argument.';
+                    safeToolResult(err);
+                    transcript?.log('tool_error', { tool: 'Task', error: err });
+                    results.push({ tool: 'Task', result: err });
+                    continue;
+                }
+                syncToolAbort();
+                safeToolCall('Task', call.args);
+                transcript?.log('subagent_start', {
+                    type: subType,
+                    description: rawDesc,
+                    prompt: rawPrompt,
+                });
+                const poll = setInterval(syncToolAbort, 100);
+                if (typeof poll.unref === 'function')
+                    poll.unref();
+                const subStart = Date.now();
+                let subResult;
+                try {
+                    subResult = await onSubagent({
+                        prompt: rawPrompt,
+                        description: rawDesc,
+                        type: subType,
+                    });
+                }
+                catch (e) {
+                    subResult = {
+                        ok: false,
+                        text: `Subagent error: ${e.message}`,
+                    };
+                }
+                finally {
+                    clearInterval(poll);
+                }
+                const subText = String(subResult.text || '').trim();
+                const subOut = subResult.ok
+                    ? subText || '(the subagent returned no report)'
+                    : `Subagent failed: ${subText || 'unknown error'}`;
+                safeToolResult(subOut);
+                transcript?.log('subagent_done', {
+                    type: subType,
+                    ok: subResult.ok,
+                    chars: subText.length,
+                    durationMs: Date.now() - subStart,
+                });
+                results.push({ tool: 'Task', result: subOut });
+                // The subagent switched the chat underneath us and the callback has
+                // already restored the parent chat. Clear the stale-echo baseline:
+                // the capture left over from the subagent's chat would otherwise make
+                // the watchdog compare the parent's next answer against IT and fire.
+                lastRaw = '';
+                if (browser._abort || browser._stopped) {
+                    transcript?.log('user_aborted');
+                    return '(прервано пользователем)';
+                }
+                continue;
+            }
             const tool = tools.find((t) => t.name === call.tool);
             if (!tool) {
                 const err = `Unknown tool: ${call.tool}`;