@zhin.js/agent 1.1.31 → 1.1.32

package/lib/core/missing-tool-resolver.js

@@ -0,0 +1,21 @@
+/**
+ * Auto-load for a deferred tool the model called without `load_tool`.
+ *
+ * Only names in this Turn's (already policy-filtered) catalog may load: a tool
+ * the policy removed, such as bash without a shell policy, must neither run nor
+ * be persisted into the session's loaded set.
+ */
+export function createMissingToolResolver(options) {
+    const { load } = options;
+    if (!load)
+        return undefined;
+    const allowed = new Set(options.catalog.map(entry => entry.name));
+    return async (name) => {
+        if (!allowed.has(name))
+            return undefined;
+        if (!(await load(name)))
+            return undefined;
+        return options.rebuild().find(tool => tool.name === name);
+    };
+}
+//# sourceMappingURL=missing-tool-resolver.js.map

package/lib/core/missing-tool-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-tool-resolver.js","sourceRoot":"","sources":["../../src/core/missing-tool-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAsC,OAI7E;IACA,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,OAAO,KAAK,EAAE,IAAY,EAAE,EAAE;QAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC"}

package/lib/core/progress-reporter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Brief, human-friendly progress updates during long Turns so the chat does
+ * not look frozen. Text comes from the model's own interim note or a cheap
+ * tools-off summary, and falls back to a fixed line. Raw tool calls, results,
+ * paths and code never pass the guard. Updates are throttled per Turn.
+ */
+import { type AgentMessage, type LlmCompletionPort, type Model } from '@zhin.js/ai';
+export type ProgressUpdateTrigger = 'progress' | 'extension' | 'continuation';
+export declare const PROGRESS_UPDATE_PREFIX = "\u23F3 ";
+export declare const PROGRESS_SUMMARY_TIMEOUT_MS = 8000;
+export declare function fallbackProgressText(steps: number): string;
+/** Returns natural-language progress text, or undefined if it looks like raw tool output. */
+export declare function friendlyProgressText(raw: string | undefined): string | undefined;
+export declare function buildProgressSummaryInstruction(): string;
+export interface ProgressSummaryInput {
+    readonly transport: LlmCompletionPort;
+    readonly model: Model;
+    readonly systemPrompt: string;
+    readonly messages: readonly AgentMessage[];
+    readonly sessionId?: string;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+/** Cheap tools-off completion; undefined on any failure. */
+export declare function summarizeProgress(input: ProgressSummaryInput): Promise<string | undefined>;
+export interface ProgressReportContext {
+    readonly steps: number;
+    /** The model's own interim note (text sent alongside tool calls), if any. */
+    readonly interimText?: string;
+}
+export interface TurnProgressReporterOptions {
+    readonly sink: (text: string) => Promise<void>;
+    readonly minIntervalMs: number;
+    readonly maxUpdates: number;
+    readonly summarize: () => Promise<string | undefined>;
+    readonly now?: () => number;
+}
+export declare class TurnProgressReporter {
+    #private;
+    constructor(options: TurnProgressReporterOptions);
+    /** Texts already sent to the user in this Turn. */
+    get reported(): readonly string[];
+    due(trigger: ProgressUpdateTrigger): boolean;
+    report(trigger: ProgressUpdateTrigger, context: ProgressReportContext): Promise<boolean>;
+}
+//# sourceMappingURL=progress-reporter.d.ts.map

package/lib/core/progress-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-reporter.d.ts","sourceRoot":"","sources":["../../src/core/progress-reporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AAGrB,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;AAE9E,eAAO,MAAM,sBAAsB,YAAO,CAAC;AAC3C,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAKjD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQhF;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAMxD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,4DAA4D;AAC5D,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiBhG;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,qBAAa,oBAAoB;;gBAOnB,OAAO,EAAE,2BAA2B;IAMhD,mDAAmD;IACnD,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEhC;IAED,GAAG,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO;IAStC,MAAM,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC;CAiB/F"}

package/lib/core/progress-reporter.js

@@ -0,0 +1,100 @@
+/**
+ * Brief, human-friendly progress updates during long Turns so the chat does
+ * not look frozen. Text comes from the model's own interim note or a cheap
+ * tools-off summary, and falls back to a fixed line. Raw tool calls, results,
+ * paths and code never pass the guard. Updates are throttled per Turn.
+ */
+import { assistantText, createUserMessage, } from '@zhin.js/ai';
+import { looksLikeRawToolMarkup, stripHallucinatedToolCalls, stripThinkBlocks } from './text-sanitize.js';
+export const PROGRESS_UPDATE_PREFIX = '⏳ ';
+export const PROGRESS_SUMMARY_TIMEOUT_MS = 8_000;
+const MAX_PROGRESS_CHARS = 160;
+/** Extensions are milestones, but still at most one update per this interval. */
+const EXTENSION_MIN_INTERVAL_MS = 15_000;
+export function fallbackProgressText(steps) {
+    return `还在处理，已完成 ${steps} 步，请稍候…`;
+}
+/** Returns natural-language progress text, or undefined if it looks like raw tool output. */
+export function friendlyProgressText(raw) {
+    if (!raw)
+        return undefined;
+    const text = stripHallucinatedToolCalls(stripThinkBlocks(raw)).replace(/\s+/g, ' ').trim();
+    if (!text || looksLikeRawToolMarkup(text))
+        return undefined;
+    if (/```|^[[{]|<\/?[a-z_]+[^>]*>/i.test(text))
+        return undefined;
+    if (/(?:^|[\s(（"'`])(?:~?\/|\.{1,2}\/)[\w.-]+\/[\w./-]*/.test(text))
+        return undefined;
+    if (/\b[a-z]+_[a-z_]+\s*\(|\b(?:exit code|stdout|stderr)\b/i.test(text))
+        return undefined;
+    return text.length > MAX_PROGRESS_CHARS ? `${text.slice(0, MAX_PROGRESS_CHARS - 1)}…` : text;
+}
+export function buildProgressSummaryInstruction() {
+    return [
+        '[System notice] Tools are disabled for this reply.',
+        'Write a 1-2 sentence progress update for the user in their language: what is done so far and what you will do next.',
+        'Plain natural language only: no tool names, file paths, commands, code or raw output.',
+    ].join('\n');
+}
+/** Cheap tools-off completion; undefined on any failure. */
+export async function summarizeProgress(input) {
+    const timeout = AbortSignal.timeout(input.timeoutMs ?? PROGRESS_SUMMARY_TIMEOUT_MS);
+    const signal = input.signal ? AbortSignal.any([input.signal, timeout]) : timeout;
+    try {
+        const assistant = await input.transport.complete(input.model, {
+            systemPrompt: input.systemPrompt,
+            messages: [...input.messages, createUserMessage(buildProgressSummaryInstruction())],
+            tools: undefined,
+        }, { signal, sessionId: input.sessionId });
+        return assistant.errorMessage ? undefined : assistantText(assistant).trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class TurnProgressReporter {
+    #options;
+    #now;
+    #reported = [];
+    #last;
+    #count = 0;
+    constructor(options) {
+        this.#options = options;
+        this.#now = options.now ?? Date.now;
+        this.#last = this.#now();
+    }
+    /** Texts already sent to the user in this Turn. */
+    get reported() {
+        return this.#reported;
+    }
+    due(trigger) {
+        if (this.#count >= this.#options.maxUpdates)
+            return false;
+        if (trigger === 'continuation')
+            return true;
+        const interval = trigger === 'extension'
+            ? Math.min(this.#options.minIntervalMs, EXTENSION_MIN_INTERVAL_MS)
+            : this.#options.minIntervalMs;
+        return this.#now() - this.#last >= interval;
+    }
+    async report(trigger, context) {
+        if (!this.due(trigger))
+            return false;
+        this.#last = this.#now();
+        this.#count += 1;
+        const interim = friendlyProgressText(context.interimText);
+        const fresh = interim && !this.#reported.includes(interim) ? interim : undefined;
+        const text = fresh
+            ?? friendlyProgressText(await this.#options.summarize().catch(() => undefined))
+            ?? fallbackProgressText(context.steps);
+        try {
+            await this.#options.sink(`${PROGRESS_UPDATE_PREFIX}${text}`);
+            this.#reported.push(text);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=progress-reporter.js.map

package/lib/core/progress-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-reporter.js","sourceRoot":"","sources":["../../src/core/progress-reporter.ts"],"names":[],"mappings":"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"}

package/lib/core/tool-calls-user-format.d.ts

@@ -3,6 +3,11 @@ export interface ToolCallRecord {
     args?: unknown;
     result: unknown;
 }
+/**
+ * Read-only exploration tools whose bodies (file contents, grep hits, page
+ * text) are context for the model, not answers for the user.
+ */
+export declare const EXPLORATION_TOOLS: ReadonlySet<string>;
 /**
  * Build a single user-facing message from tool call history.
  */

package/lib/core/tool-calls-user-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-calls-user-format.d.ts","sourceRoot":"","sources":["../../src/core/tool-calls-user-format.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAyBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAkB1E;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO/D"}
+{"version":3,"file":"tool-calls-user-format.d.ts","sourceRoot":"","sources":["../../src/core/tool-calls-user-format.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAID;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAmE,CAAC;AA8BtH;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CA2B1E;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO/D"}

package/lib/core/tool-calls-user-format.js

@@ -4,6 +4,15 @@
  */
 import { compactMediaToolJsonForModel, isMediaToolWithBinaryPayload, sanitizeToolResult, } from '@zhin.js/ai';
 const INTERNAL_META_TOOLS = new Set(['load_skill', 'discover', 'load_tool']);
+/**
+ * Read-only exploration tools whose bodies (file contents, grep hits, page
+ * text) are context for the model, not answers for the user.
+ */
+export const EXPLORATION_TOOLS = new Set(['read_file', 'grep', 'glob', 'list_dir', 'web_fetch']);
+/** Per-tool and total caps for the user-facing summary. */
+const MAX_TOOL_BLOCK_CHARS = 2000;
+const MAX_SUMMARY_CHARS = 3000;
+const EXPLORATION_ONLY_REPLY = '这一轮只做了资料查阅，还没有整理出结论。回复「继续」我会接着处理，或者把需求说得更具体一些再试。';
 function asString(result) {
     if (result == null)
         return '';
@@ -20,9 +29,9 @@ function formatGenericToolResult(tool, result) {
     const raw = asString(result);
     if (isMediaToolWithBinaryPayload(tool) && raw.trim().startsWith('{')) {
         const compact = compactMediaToolJsonForModel(tool, raw);
-        return compact.length > 2000 ? `${compact.slice(0, 2000)}…` : compact;
+        return truncate(compact, MAX_TOOL_BLOCK_CHARS);
     }
-    const cleaned = sanitizeToolResult(raw, { maxChars: 2000 });
+    const cleaned = sanitizeToolResult(raw, { maxChars: MAX_TOOL_BLOCK_CHARS });
     if (!cleaned)
         return '';
     return cleaned;
@@ -35,15 +44,23 @@ export function formatToolCallsForUser(toolCalls) {
         return '模型未返回可见内容（可能为推理型模型空回复或上下文过长）。可发送 /reset 后重试，或换用非推理模型。';
     }
     const otherParts = [];
+    let exploredOnly = false;
     for (const tc of toolCalls) {
         if (INTERNAL_META_TOOLS.has(tc.tool))
             continue;
+        if (EXPLORATION_TOOLS.has(tc.tool)) {
+            exploredOnly = true;
+            continue;
+        }
         const block = formatGenericToolResult(tc.tool, tc.result);
         if (block)
             otherParts.push(block);
     }
     if (otherParts.length > 0) {
-        return otherParts.join('\n\n');
+        return truncate(otherParts.join('\n\n'), MAX_SUMMARY_CHARS);
+    }
+    if (exploredOnly) {
+        return EXPLORATION_ONLY_REPLY;
     }
     return '未能从工具结果中提取有效信息，请换一种说法或缩小问题范围后重试。';
 }
@@ -75,4 +92,7 @@ function countBracketBlocks(text) {
     }
     return count;
 }
+function truncate(text, maxChars) {
+    return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+}
 //# sourceMappingURL=tool-calls-user-format.js.map

package/lib/core/tool-calls-user-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-calls-user-format.js","sourceRoot":"","sources":["../../src/core/tool-calls-user-format.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-calls-user-format.js","sourceRoot":"","sources":["../../src/core/tool-calls-user-format.ts"],"names":[],"mappings":"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"}

package/lib/core/turn-event-mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-event-mapper.d.ts","sourceRoot":"","sources":["../../src/core/turn-event-mapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CAAC,aAAa,SAAK,GAAG,oBAAoB,CAEnF;AAED,wBAAiB,yBAAyB,CACxC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,oBAAoB,GAC1B,SAAS,CAAC,SAAS,CAAC,CA0EtB"}
+{"version":3,"file":"turn-event-mapper.d.ts","sourceRoot":"","sources":["../../src/core/turn-event-mapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CAAC,aAAa,SAAK,GAAG,oBAAoB,CAEnF;AAED,wBAAiB,yBAAyB,CACxC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,oBAAoB,GAC1B,SAAS,CAAC,SAAS,CAAC,CA4EtB"}

package/lib/core/turn-event-mapper.js

@@ -22,6 +22,8 @@ export function* mapAgentEventToTurnEvents(event, state) {
                         promptTokens: usage.input,
                         completionTokens: usage.output,
                         totalTokens: usage.totalTokens,
+                        ...(usage.cacheRead > 0 ? { cacheReadTokens: usage.cacheRead } : {}),
+                        ...(usage.reasoning ? { reasoningTokens: usage.reasoning } : {}),
                     },
                 };
             }

package/lib/core/turn-event-mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"turn-event-mapper.js","sourceRoot":"","sources":["../../src/core/turn-event-mapper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"turn-event-mapper.js","sourceRoot":"","sources":["../../src/core/turn-event-mapper.ts"],"names":[],"mappings":"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"}

package/lib/core/turn-progress.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Progress-aware tool budget for one agent Turn.
+ *
+ * The configured `maxIterations` is a soft budget. When the loop reaches it,
+ * the Turn gets `extendBy` more steps only if it made progress in the recent
+ * window and is not looping or failing, up to `maxTotalIterations`. Wall-clock
+ * and token caps stop the loop at any point. When a Turn stops while the model
+ * still wants tools and progress was made, it may auto-continue from a
+ * tools-off summary inside the same Turn (same policy, ports and history).
+ */
+import type { TurnContextView } from '../context/turn-envelope.js';
+export type ToolBudgetAutoContinue = 'off' | 'master_dm' | 'on';
+export type ToolBudgetProgressUpdates = 'off' | 'private' | 'all';
+export interface ToolBudgetSettings {
+    /** Steps granted per extension when the Turn is progressing. 0 disables extensions. */
+    readonly extendBy: number;
+    /** Progress must have happened within this many recent steps to extend. */
+    readonly progressWindow: number;
+    /** Hard cap on steps per Turn segment (base + extensions). */
+    readonly maxTotalIterations: number;
+    /** Hard cap on steps for one in-turn sub-agent. */
+    readonly maxSubagentTotalIterations: number;
+    /** Wall-clock cap for the whole Turn, including continuations. 0 disables. */
+    readonly maxWallClockMs: number;
+    /** Token cap (sum of model usage) for the whole Turn. 0 disables. */
+    readonly maxTotalTokens: number;
+    /** Consecutive failed tool calls that count as stalled. */
+    readonly failureStreakLimit: number;
+    /** Consecutive repeated identical calls that count as looping. */
+    readonly repeatLimit: number;
+    /** When to auto-continue a progressing Turn that hit its budget. */
+    readonly autoContinue: ToolBudgetAutoContinue;
+    /** Maximum auto-continuations per Turn. */
+    readonly maxContinuations: number;
+    /** Progress updates to the chat during long Turns: off, private chats only, or all chats. */
+    readonly progressUpdates: ToolBudgetProgressUpdates;
+    /** Minimum time between progress updates. */
+    readonly progressMinIntervalMs: number;
+    /** Maximum progress updates per Turn. */
+    readonly progressMaxUpdates: number;
+}
+export declare const DEFAULT_TOOL_BUDGET: ToolBudgetSettings;
+export interface ToolBudgetHarnessOverride {
+    readonly iterationExtension?: number;
+    readonly maxTotalIterations?: number;
+}
+/** Group chats get progress updates only when opted in with `all`. */
+export declare function progressUpdatesAllowed(mode: ToolBudgetProgressUpdates, turn: TurnContextView | undefined): boolean;
+/** Merges defaults, `ai.agent.toolBudget` and the per-model harness, ignoring invalid values. */
+export declare function resolveToolBudget(config?: Partial<Record<keyof ToolBudgetSettings, unknown>>, harness?: ToolBudgetHarnessOverride): ToolBudgetSettings;
+/** Auto-continuation only reuses the current Turn, so it never widens authority. */
+export declare function autoContinueAllowed(mode: ToolBudgetAutoContinue, turn: TurnContextView | undefined): boolean;
+export type ToolProgressKind = 'mutation' | 'subagent' | 'new_result' | 'exploration' | 'repeat' | 'failure';
+export interface ToolProgressRecord {
+    readonly toolName: string;
+    readonly args: unknown;
+    readonly ok: boolean;
+    readonly output?: string;
+}
+export declare function isProgress(kind: ToolProgressKind): boolean;
+/** Classifies tool calls in one Turn into progress and non-progress events. */
+export declare class TurnProgressTracker {
+    #private;
+    constructor(settings: ToolBudgetSettings);
+    record(iteration: number, call: ToolProgressRecord): ToolProgressKind;
+    /** Looping on identical calls or failing repeatedly. */
+    get stalled(): boolean;
+    /** Progress happened at or after the given (1-based) iteration. */
+    progressedSince(iteration: number): boolean;
+    startSegment(): void;
+    get segmentProgressed(): boolean;
+}
+/** Instruction that resumes a Turn after an automatic continuation checkpoint. */
+export declare function buildContinuationInstruction(index: number, max: number, reported?: readonly string[]): string;
+//# sourceMappingURL=turn-progress.d.ts.map

package/lib/core/turn-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-progress.d.ts","sourceRoot":"","sources":["../../src/core/turn-progress.ts"],"names":[],"mappings":"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"}

package/lib/core/turn-progress.js

@@ -0,0 +1,152 @@
+import { classifyBashCommand } from '../security/file-policy.js';
+import { EXPLORATION_TOOLS } from './tool-calls-user-format.js';
+export const DEFAULT_TOOL_BUDGET = Object.freeze({
+    extendBy: 10,
+    progressWindow: 5,
+    maxTotalIterations: 40,
+    maxSubagentTotalIterations: 30,
+    maxWallClockMs: 10 * 60_000,
+    maxTotalTokens: 0,
+    failureStreakLimit: 3,
+    repeatLimit: 2,
+    autoContinue: 'master_dm',
+    maxContinuations: 2,
+    progressUpdates: 'private',
+    progressMinIntervalMs: 45_000,
+    progressMaxUpdates: 3,
+});
+const AUTO_CONTINUE = new Set(['off', 'master_dm', 'on']);
+const PROGRESS_UPDATES = new Set(['off', 'private', 'all']);
+/** Group chats get progress updates only when opted in with `all`. */
+export function progressUpdatesAllowed(mode, turn) {
+    if (mode === 'all')
+        return true;
+    if (mode !== 'private' || !turn)
+        return false;
+    return turn.origin.kind !== 'im' || turn.origin.scope === 'private';
+}
+/** Merges defaults, `ai.agent.toolBudget` and the per-model harness, ignoring invalid values. */
+export function resolveToolBudget(config, harness = {}) {
+    const count = (value, fallback) => typeof value === 'number' && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
+    const pick = (key) => count(config?.[key], DEFAULT_TOOL_BUDGET[key]);
+    const autoContinue = config?.autoContinue;
+    return Object.freeze({
+        extendBy: count(harness.iterationExtension, pick('extendBy')),
+        progressWindow: Math.max(1, pick('progressWindow')),
+        maxTotalIterations: count(harness.maxTotalIterations, pick('maxTotalIterations')),
+        maxSubagentTotalIterations: pick('maxSubagentTotalIterations'),
+        maxWallClockMs: pick('maxWallClockMs'),
+        maxTotalTokens: pick('maxTotalTokens'),
+        failureStreakLimit: Math.max(1, pick('failureStreakLimit')),
+        repeatLimit: Math.max(1, pick('repeatLimit')),
+        autoContinue: AUTO_CONTINUE.has(autoContinue)
+            ? autoContinue
+            : DEFAULT_TOOL_BUDGET.autoContinue,
+        maxContinuations: pick('maxContinuations'),
+        progressUpdates: PROGRESS_UPDATES.has(config?.progressUpdates)
+            ? config?.progressUpdates
+            : DEFAULT_TOOL_BUDGET.progressUpdates,
+        progressMinIntervalMs: pick('progressMinIntervalMs'),
+        progressMaxUpdates: pick('progressMaxUpdates'),
+    });
+}
+/** Auto-continuation only reuses the current Turn, so it never widens authority. */
+export function autoContinueAllowed(mode, turn) {
+    if (mode === 'on')
+        return true;
+    if (mode !== 'master_dm' || !turn)
+        return false;
+    return turn.principal.roles.includes('master')
+        && turn.origin.kind === 'im'
+        && turn.origin.scope === 'private';
+}
+const MUTATING_TOOLS = new Set(['write_file', 'edit_file', 'multi_edit', 'apply_patch']);
+const MUTATING_NAME = /(?:^|_)(?:create|schedule|add|update|delete|remove|send|set|write|edit|move|rename|commit)(?:_|$)/;
+export function isProgress(kind) {
+    return kind === 'mutation' || kind === 'subagent' || kind === 'new_result';
+}
+/** Classifies tool calls in one Turn into progress and non-progress events. */
+export class TurnProgressTracker {
+    #signatures = new Set();
+    #settings;
+    #lastProgressIteration = -1;
+    #failureStreak = 0;
+    #repeatStreak = 0;
+    #segmentProgress = 0;
+    constructor(settings) {
+        this.#settings = settings;
+    }
+    record(iteration, call) {
+        const kind = this.#classify(call);
+        if (kind === 'failure')
+            this.#failureStreak += 1;
+        else
+            this.#failureStreak = 0;
+        if (kind === 'repeat')
+            this.#repeatStreak += 1;
+        else if (kind !== 'failure')
+            this.#repeatStreak = 0;
+        if (isProgress(kind)) {
+            this.#lastProgressIteration = iteration;
+            this.#segmentProgress += 1;
+        }
+        return kind;
+    }
+    /** Looping on identical calls or failing repeatedly. */
+    get stalled() {
+        return this.#failureStreak >= this.#settings.failureStreakLimit
+            || this.#repeatStreak >= this.#settings.repeatLimit;
+    }
+    /** Progress happened at or after the given (1-based) iteration. */
+    progressedSince(iteration) {
+        return this.#lastProgressIteration > 0 && this.#lastProgressIteration >= iteration;
+    }
+    startSegment() {
+        this.#segmentProgress = 0;
+    }
+    get segmentProgressed() {
+        return this.#segmentProgress > 0;
+    }
+    #classify(call) {
+        if (!call.ok)
+            return 'failure';
+        const signature = `${call.toolName}:${stableStringify(call.args)}`;
+        if (this.#signatures.has(signature))
+            return 'repeat';
+        this.#signatures.add(signature);
+        if (call.toolName === 'spawn_task') {
+            return call.output?.includes('已完成') ? 'subagent' : 'exploration';
+        }
+        if (call.toolName === 'bash') {
+            const command = call.args?.command;
+            return typeof command === 'string' && !classifyBashCommand(command).isReadOnly
+                ? 'mutation'
+                : 'exploration';
+        }
+        if (EXPLORATION_TOOLS.has(call.toolName))
+            return 'exploration';
+        if (MUTATING_TOOLS.has(call.toolName) || MUTATING_NAME.test(call.toolName))
+            return 'mutation';
+        return 'new_result';
+    }
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value) ?? 'undefined';
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+    return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${stableStringify(entry)}`).join(',')}}`;
+}
+/** Instruction that resumes a Turn after an automatic continuation checkpoint. */
+export function buildContinuationInstruction(index, max, reported = []) {
+    return [
+        `[System notice] Automatic continuation ${index}/${max}: the previous step budget ran out while the task was progressing.`,
+        'Continue the same task from your summary above with the same tools and permissions.',
+        'Do not repeat finished work. When the task is done, reply to the user with the result.',
+        ...(reported.length
+            ? ['Progress updates already sent to the user (do not repeat them):', ...reported.map(text => `- ${text}`)]
+            : []),
+    ].join('\n');
+}
+//# sourceMappingURL=turn-progress.js.map

package/lib/core/turn-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-progress.js","sourceRoot":"","sources":["../../src/core/turn-progress.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAkChE,MAAM,CAAC,MAAM,mBAAmB,GAAuB,MAAM,CAAC,MAAM,CAAC;IACnE,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,CAAC;IACjB,kBAAkB,EAAE,EAAE;IACtB,0BAA0B,EAAE,EAAE;IAC9B,cAAc,EAAE,EAAE,GAAG,MAAM;IAC3B,cAAc,EAAE,CAAC;IACjB,kBAAkB,EAAE,CAAC;IACrB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,WAAW;IACzB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,SAAS;IAC1B,qBAAqB,EAAE,MAAM;IAC7B,kBAAkB,EAAE,CAAC;CACtB,CAAC,CAAC;AAOH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAyB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AAClF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAA4B,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvF,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CAAC,IAA+B,EAAE,IAAiC;IACvG,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC;AACtE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,iBAAiB,CAC/B,MAA2D,EAC3D,UAAqC,EAAE;IAEvC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,QAAgB,EAAE,EAAE,CACjD,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnG,MAAM,IAAI,GAAG,CAAC,GAA0E,EAAE,EAAE,CAC1F,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,MAAM,EAAE,YAAY,CAAC;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7D,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACnD,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjF,0BAA0B,EAAE,IAAI,CAAC,4BAA4B,CAAC;QAC9D,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACtC,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACtC,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC3D,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,YAAY,EAAE,aAAa,CAAC,GAAG,CAAC,YAAsC,CAAC;YACrE,CAAC,CAAC,YAAsC;YACxC,CAAC,CAAC,mBAAmB,CAAC,YAAY;QACpC,gBAAgB,EAAE,IAAI,CAAC,kBAAkB,CAAC;QAC1C,eAAe,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,eAA4C,CAAC;YACzF,CAAC,CAAC,MAAM,EAAE,eAA4C;YACtD,CAAC,CAAC,mBAAmB,CAAC,eAAe;QACvC,qBAAqB,EAAE,IAAI,CAAC,uBAAuB,CAAC;QACpD,kBAAkB,EAAE,IAAI,CAAC,oBAAoB,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,IAA4B,EAAE,IAAiC;IACjG,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,IAAI,KAAK,WAAW,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;WACzC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI;WACzB,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC;AACvC,CAAC;AAiBD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AACzF,MAAM,aAAa,GAAG,mGAAmG,CAAC;AAE1H,MAAM,UAAU,UAAU,CAAC,IAAsB;IAC/C,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,CAAC;AAC7E,CAAC;AAED,+EAA+E;AAC/E,MAAM,OAAO,mBAAmB;IACrB,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,SAAS,CAAqB;IACvC,sBAAsB,GAAG,CAAC,CAAC,CAAC;IAC5B,cAAc,GAAG,CAAC,CAAC;IACnB,aAAa,GAAG,CAAC,CAAC;IAClB,gBAAgB,GAAG,CAAC,CAAC;IAErB,YAAY,QAA4B;QACtC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,SAAiB,EAAE,IAAwB;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;;YAC5C,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QAC7B,IAAI,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;aAC1C,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACpD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC;YACxC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wDAAwD;IACxD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC,kBAAkB;eAC1D,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;IACxD,CAAC;IAED,mEAAmE;IACnE,eAAe,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,sBAAsB,GAAG,CAAC,IAAI,IAAI,CAAC,sBAAsB,IAAI,SAAS,CAAC;IACrF,CAAC;IAED,YAAY;QACV,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,IAAwB;QAChC,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAC/B,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,QAAQ,CAAC;QACrD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAI,IAAI,CAAC,IAA0C,EAAE,OAAO,CAAC;YAC1E,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,UAAU;gBAC5E,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,aAAa,CAAC;QACpB,CAAC;QACD,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,aAAa,CAAC;QAC/D,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,UAAU,CAAC;QAC9F,OAAO,YAAY,CAAC;IACtB,CAAC;CACF;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC;IAC7F,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACxG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAC5G,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,4BAA4B,CAAC,KAAa,EAAE,GAAW,EAAE,WAA8B,EAAE;IACvG,OAAO;QACL,0CAA0C,KAAK,IAAI,GAAG,oEAAoE;QAC1H,qFAAqF;QACrF,wFAAwF;QACxF,GAAG,CAAC,QAAQ,CAAC,MAAM;YACjB,CAAC,CAAC,CAAC,iEAAiE,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC3G,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/lib/deferred-worker-runner.d.ts

@@ -3,6 +3,7 @@
  */
 import { type Message } from '@zhin.js/core';
 import { type AIProvider, type AgentTool, type ModelRegistry, type LlmApiRuntime } from '@zhin.js/ai';
+import type { ToolInvocationPolicy } from '@zhin.js/tool';
 import type { ToolCallRecord } from './core/tool-calls-user-format.js';
 import { type ZhinAgentConfig, type ExecApprovalMode } from './config/index.js';
 /** 回传给主 Agent 的摘要最大字符数 */
@@ -23,6 +24,11 @@ export interface DeferredWorkerRunOptions {
     llmRuntime?: LlmApiRuntime;
     summaryMaxChars?: number;
     onEvent?: (event: DeferredWorkerLifecycleEvent) => void | Promise<void>;
+    /**
+     * Frozen snapshot of the spawning turn's shell/filesystem policy. Omitted
+     * means no shell: a worker never inherits live turn authority implicitly.
+     */
+    turnPolicy?: Readonly<Pick<ToolInvocationPolicy, 'shell' | 'filesystem'>>;
 }
 export interface DeferredWorkerLifecycleEvent {
     phase: 'start' | 'finish';

package/lib/deferred-worker-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deferred-worker-runner.d.ts","sourceRoot":"","sources":["../src/deferred-worker-runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAmH,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAIvN,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAqI,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAA+B,MAAM,mBAAmB,CAAC;AAOhP,0BAA0B;AAC1B,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,qBAAa,oBAAoB;IACzB,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAkMhF"}
+{"version":3,"file":"deferred-worker-runner.d.ts","sourceRoot":"","sources":["../src/deferred-worker-runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAmH,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvN,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAqI,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAA+B,MAAM,mBAAmB,CAAC;AAOhP,0BAA0B;AAC1B,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC;CAC3E;AAID,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,qBAAa,oBAAoB;IACzB,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAqMhF"}

package/lib/deferred-worker-runner.js

@@ -16,6 +16,7 @@ const logger = getLogger('DeferredWorker');
 const ORCHESTRATOR_TOOL_SET = new Set(DEFAULT_ALWAYS_LOADED_TOOLS);
 /** 回传给主 Agent 的摘要最大字符数 */
 export const DEFAULT_WORKER_SUMMARY_MAX_CHARS = 1500;
+const DEFERRED_WORKER_NO_SHELL_POLICY = Object.freeze({});
 export class DeferredWorkerRunner {
     async runSync(options) {
         const { goal, toolQuery, deferredCatalog, workerBaseTools, allToolsByName, origin, maxToolResults, provider, execPolicyConfig, execApprovalMode, modelRegistry, summaryMaxChars = DEFAULT_WORKER_SUMMARY_MAX_CHARS, onEvent, } = options;
@@ -109,6 +110,9 @@ ${goal}`;
                 userInput: goal,
                 maxIterations,
                 commMessage: origin,
+                // Deferred workers can outlive the turn that started them, so they never
+                // borrow its live authority: only an explicit frozen policy grants shell.
+                turnPolicy: options.turnPolicy ?? DEFERRED_WORKER_NO_SHELL_POLICY,
                 ...buildAgentPromptCacheStreamOptions(execPolicyConfig ?? {}, {
                     modelSdk: llmModel.sdk,
                     provider: provider.name,