@zhin.js/agent 0.1.30 → 0.1.32

package/lib/zhin-agent/compaction-runtime.js

@@ -0,0 +1,78 @@
+import { autoCompactAgentMessagesIfNeeded, createAgentCompactionState, estimateAgentMessagesTokens, } from '@zhin.js/ai';
+function resolveAgentCompactionConfig(compaction, contextWindow) {
+    return {
+        enabled: compaction?.enabled !== false,
+        auto: compaction?.auto !== false,
+        keepRecentTokens: compaction?.keepRecentTokens ?? 20_000,
+        minKeepCount: compaction?.minKeepCount ?? 2,
+        contextWindow,
+    };
+}
+const compactionStateBySession = new Map();
+function getCompactionState(sessionId) {
+    let state = compactionStateBySession.get(sessionId);
+    if (!state) {
+        state = createAgentCompactionState();
+        compactionStateBySession.set(sessionId, state);
+    }
+    return state;
+}
+export async function transformContextWithCompaction(messages, signal, options) {
+    if (signal?.aborted)
+        return messages;
+    const cfg = resolveAgentCompactionConfig(options.compactionConfig, options.contextWindow);
+    if (cfg.enabled === false)
+        return messages;
+    const beforeTokens = estimateAgentMessagesTokens(messages);
+    const state = getCompactionState(options.sessionId);
+    const result = await autoCompactAgentMessagesIfNeeded({
+        model: options.model,
+        messages,
+        config: cfg,
+        state,
+        force: options.force,
+        customInstructions: options.customInstructions,
+    });
+    if (result.summary?.trim()) {
+        const anchorId = await options.host.contextRepository.resolveCompactionAnchorId(options.sessionId, cfg.keepRecentTokens ?? 20_000, cfg.minKeepCount ?? 2);
+        await options.host.contextRepository.saveSummary(options.sessionId, result.summary, anchorId);
+    }
+    if (result.wasCompacted) {
+        const afterTokens = estimateAgentMessagesTokens(result.messages);
+        options.host.emitSessionCompactEvent(options.sessionId, options.context, options.mode ?? 'text', {
+            microSavedTokens: result.microSavedTokens,
+            autoSavedTokens: result.autoSavedTokens,
+            totalTokensBefore: beforeTokens,
+            totalTokensAfter: afterTokens,
+        });
+    }
+    let out = result.messages;
+    if (options.loopHooks) {
+        out = await options.loopHooks.runTransformContext(out, {
+            sessionId: options.sessionId,
+            signal,
+        });
+    }
+    return out;
+}
+export async function manualCompactSession(repo, options) {
+    const cfg = resolveAgentCompactionConfig(options.compactionConfig, options.contextWindow);
+    if (cfg.enabled === false) {
+        return { ok: false, message: 'compaction 已禁用（ai.agent.compaction.enabled=false）' };
+    }
+    const loaded = await repo.loadContext(options.sessionId);
+    const messages = loaded.messages;
+    if (messages.length < 2) {
+        return { ok: false, message: '消息过少，无需压缩' };
+    }
+    const compacted = await transformContextWithCompaction(messages, undefined, {
+        ...options,
+        force: true,
+    });
+    const saved = estimateAgentMessagesTokens(messages) - estimateAgentMessagesTokens(compacted);
+    return {
+        ok: true,
+        message: `已压缩会话，约节省 ${Math.max(0, saved)} tokens（保留最近 ~${cfg.keepRecentTokens ?? 20_000} tokens）`,
+    };
+}
+//# sourceMappingURL=compaction-runtime.js.map

package/lib/zhin-agent/compaction-runtime.js.map

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

package/lib/zhin-agent/config.d.ts

@@ -2,6 +2,7 @@
  * ZhinAgent 配置、常量、类型定义
  */
 import type { RateLimitConfig } from '@zhin.js/ai';
+import { type QueueMode } from '@zhin.js/ai';
 import type { ModelHarnessConfig } from './model-harness.js';
 export type ModelSizeHint = 'small' | 'medium' | 'large';
 export type ExecApprovalMode = 'ask' | 'allow' | 'deny';
@@ -24,6 +25,13 @@ export declare const HISTORY_CONTEXT_MARKER = "[Chat messages since your last re
 /** 与 @zhin.js/core `CURRENT_USER_MESSAGE_MARKER` 保持一致 */
 export declare const CURRENT_MESSAGE_MARKER = "[Current message - respond to this]";
 export type OnChunkCallback = (chunk: string, full: string) => void;
+/** ADR 0010 — session compaction config. */
+export interface CompactionConfig {
+    enabled?: boolean;
+    auto?: boolean;
+    keepRecentTokens?: number;
+    minKeepCount?: number;
+}
 /** 上下文感知内置工具的关键词触发正则 */
 export declare const KEYWORD_TRIGGERS: {
     readonly chatHistory: RegExp;
@@ -43,11 +51,10 @@ export interface ZhinAgentConfig {
     toneAwareness?: boolean;
     /** 聊天任务使用的模型（覆盖自动选择） */
     chatModel?: string;
-    /** 纯闲聊(0工具)使用的轻量模型，留空则复用 chatModel */
-    chatLiteModel?: string;
     visionModel?: string;
     contextTokens?: number;
     maxHistoryShare?: number;
+    compaction?: CompactionConfig;
     disabledTools?: string[];
     allowedTools?: string[];
     execSecurity?: 'deny' | 'allowlist' | 'full';
@@ -92,14 +99,27 @@ export interface ZhinAgentConfig {
     platformPromptSectionMaxChars?: number;
     /** 单 slot 平台 prompt 合计上限（字符） */
     platformPromptMaxChars?: number;
+    /** steer 队列 drain 模式（ADR 0009 Grill #13） */
+    steeringMode?: QueueMode;
+    /** followUp 队列 drain 模式（ADR 0009 Grill #13） */
+    followUpMode?: QueueMode;
     /**
      * 同一轮对话内累计多少次策略/安全拒绝后强制结束工具循环（默认 2，传给 Agent）。
      * 设为 0 禁用熔断。
      */
     policyDenialStopAfter?: number;
+    /**
+     * @deprecated Worker 结果经 run_deferred_task 同步回传主 Agent，不再使用独立 auto_continue 回合。
+     */
+    deferredAutoContinue?: boolean;
+    /** @deprecated 见 deferredAutoContinue */
+    deferredAutoContinueMaxDepth?: number;
 }
 /** 主 Agent 默认常驻编排工具（不含 activate_skill：执行一律经 Worker；文生图走 deferred） */
 export declare const DEFAULT_ORCHESTRATOR_TOOLS: readonly ["tool_search", "run_deferred_task", "ask_user", "spawn_task"];
+/** 硬编排 v1 追加的总监工具 */
+export declare const HARD_ORCHESTRATION_TOOLS: readonly ["orchestration_start", "orchestration_add_task", "orchestration_status", "orchestration_complete", "orchestration_retry_task", "orchestration_skip_task", "orchestration_patch_state"];
+export declare const DEFAULT_HARD_ORCHESTRATOR_TOOLS: readonly ["tool_search", "run_deferred_task", "ask_user", "spawn_task", "orchestration_start", "orchestration_add_task", "orchestration_status", "orchestration_complete", "orchestration_retry_task", "orchestration_skip_task", "orchestration_patch_state"];
 /** 不进入主编排也不进入 deferred 目录 */
 export declare const DEFERRED_CATALOG_EXCLUDED_TOOLS: readonly ["activate_skill", "install_skill"];
 /** @deprecated 使用 DEFERRED_CATALOG_EXCLUDED_TOOLS */

package/lib/zhin-agent/config.d.ts.map

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

package/lib/zhin-agent/config.js

@@ -1,7 +1,7 @@
 /**
  * ZhinAgent 配置、常量、类型定义
  */
-import { DEFAULT_CONTEXT_TOKENS } from '@zhin.js/ai';
+import { DEFAULT_CONTEXT_TOKENS, DEFAULT_FOLLOW_UP_MODE, DEFAULT_STEERING_MODE } from '@zhin.js/ai';
 const SMALL_MODEL_RE = /[:\-_](0\.5|1\.?[58]?|[3-8])b\b/i;
 const MEDIUM_MODEL_RE = /[:\-_](14|[12][0-9]|32)b\b/i;
 /**
@@ -54,6 +54,20 @@ export const DEFAULT_ORCHESTRATOR_TOOLS = [
     'ask_user',
     'spawn_task',
 ];
+/** 硬编排 v1 追加的总监工具 */
+export const HARD_ORCHESTRATION_TOOLS = [
+    'orchestration_start',
+    'orchestration_add_task',
+    'orchestration_status',
+    'orchestration_complete',
+    'orchestration_retry_task',
+    'orchestration_skip_task',
+    'orchestration_patch_state',
+];
+export const DEFAULT_HARD_ORCHESTRATOR_TOOLS = [
+    ...DEFAULT_ORCHESTRATOR_TOOLS,
+    ...HARD_ORCHESTRATION_TOOLS,
+];
 /** 不进入主编排也不进入 deferred 目录 */
 export const DEFERRED_CATALOG_EXCLUDED_TOOLS = ['activate_skill', 'install_skill'];
 /** @deprecated 使用 DEFERRED_CATALOG_EXCLUDED_TOOLS */
@@ -80,10 +94,15 @@ export const DEFAULT_CONFIG = {
     rateLimit: {},
     toneAwareness: true,
     chatModel: '',
-    chatLiteModel: '',
     visionModel: '',
     contextTokens: DEFAULT_CONTEXT_TOKENS,
     maxHistoryShare: 0.5,
+    compaction: {
+        enabled: true,
+        auto: true,
+        keepRecentTokens: 20_000,
+        minKeepCount: 2,
+    },
     disabledTools: [],
     allowedTools: [],
     execSecurity: 'deny',
@@ -106,7 +125,11 @@ export const DEFAULT_CONFIG = {
     workerBaseTools: [...DEFAULT_WORKER_BASE_TOOLS],
     platformPromptSectionMaxChars: 2048,
     platformPromptMaxChars: 4096,
+    steeringMode: DEFAULT_STEERING_MODE,
+    followUpMode: DEFAULT_FOLLOW_UP_MODE,
     policyDenialStopAfter: 2,
+    deferredAutoContinue: false,
+    deferredAutoContinueMaxDepth: 8,
 };
 /** `env` 参数主要用于测试注入，运行时默认读取 `process.env`。 */
 export function isPhaseTraceEnabled(config, env = process.env) {

package/lib/zhin-agent/config.js.map

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

package/lib/zhin-agent/deferred-auto-continue.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Deferred worker 完成后自动唤醒主 Agent 续聊（方案 B）。
+ */
+import { type UserMessage } from '@zhin.js/ai';
+import type { DeferredWorkerResult } from '../deferred-worker-runner.js';
+import type { ZhinAgentConfig } from './config.js';
+export declare const DEFERRED_AUTO_CONTINUE_MARKER = "[Deferred worker \u5B8C\u6210 \u2014 \u81EA\u52A8\u7EED\u804A]";
+export declare function isDeferredAutoContinueEnabled(config: Required<ZhinAgentConfig>, env?: NodeJS.ProcessEnv): boolean;
+export declare function shouldDeferredAutoContinue(config: Required<ZhinAgentConfig>, result: DeferredWorkerResult, depth: number, persisted: boolean, env?: NodeJS.ProcessEnv): boolean;
+export declare function buildDeferredAutoContinueUserMessage(taskId: string, goal: string, status: DeferredWorkerResult['status']): UserMessage;
+//# sourceMappingURL=deferred-auto-continue.d.ts.map

package/lib/zhin-agent/deferred-auto-continue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-auto-continue.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/deferred-auto-continue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,6BAA6B,mEAAgC,CAAC;AAK3E,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAKT;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EACjC,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAMT;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACrC,WAAW,CAWb"}

package/lib/zhin-agent/deferred-auto-continue.js

@@ -0,0 +1,41 @@
+/**
+ * Deferred worker 完成后自动唤醒主 Agent 续聊（方案 B）。
+ */
+import { createUserMessage } from '@zhin.js/ai';
+import { resolveSubagentDisplayLabel } from '../subagent-goal-notify.js';
+import { extractDeferredBody } from './deferred-delivery.js';
+export const DEFERRED_AUTO_CONTINUE_MARKER = '[Deferred worker 完成 — 自动续聊]';
+const FALSE_ENV = new Set(['0', 'false', 'off', 'no']);
+const TRUE_ENV = new Set(['1', 'true', 'on', 'yes']);
+export function isDeferredAutoContinueEnabled(config, env = process.env) {
+    const raw = env.ZHIN_DEFERRED_AUTO_CONTINUE?.trim().toLowerCase();
+    if (raw && FALSE_ENV.has(raw))
+        return false;
+    if (raw && TRUE_ENV.has(raw))
+        return true;
+    return config.deferredAutoContinue;
+}
+export function shouldDeferredAutoContinue(config, result, depth, persisted, env = process.env) {
+    if (!isDeferredAutoContinueEnabled(config, env))
+        return false;
+    if (!persisted)
+        return false;
+    if (result.status === 'error')
+        return false;
+    if (depth >= config.deferredAutoContinueMaxDepth)
+        return false;
+    return extractDeferredBody(result).trim().length > 0;
+}
+export function buildDeferredAutoContinueUserMessage(taskId, goal, status) {
+    const label = resolveSubagentDisplayLabel(undefined, goal);
+    const text = [
+        DEFERRED_AUTO_CONTINUE_MARKER,
+        `任务【${taskId}】· ${label}`,
+        `Worker 状态：${status}。`,
+        '请根据上下文中 `[Deferred worker 完成]` 的 Worker 输出继续推进任务（含答题、提交、后续 API 调用）；无需等待用户输入。',
+        '若任务已全部完成，向用户简要汇报结果；否则继续调用工具（含 run_deferred_task）执行下一步。',
+        '不要向用户重复粘贴 Worker 的完整原始输出。',
+    ].join('\n');
+    return createUserMessage(text);
+}
+//# sourceMappingURL=deferred-auto-continue.js.map

package/lib/zhin-agent/deferred-auto-continue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-auto-continue.js","sourceRoot":"","sources":["../../src/zhin-agent/deferred-auto-continue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,CAAC,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE3E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAErD,MAAM,UAAU,6BAA6B,CAC3C,MAAiC,EACjC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,GAAG,GAAG,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,IAAI,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,MAAM,CAAC,oBAAoB,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAiC,EACjC,MAA4B,EAC5B,KAAa,EACb,SAAkB,EAClB,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC,6BAA6B,CAAC,MAAM,EAAE,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,IAAI,MAAM,CAAC,4BAA4B;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,MAAc,EACd,IAAY,EACZ,MAAsC;IAEtC,MAAM,KAAK,GAAG,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG;QACX,6BAA6B;QAC7B,MAAM,MAAM,MAAM,KAAK,EAAE;QACzB,aAAa,MAAM,GAAG;QACtB,8EAA8E;QAC9E,wDAAwD;QACxD,2BAA2B;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/lib/zhin-agent/deferred-delivery.d.ts

@@ -0,0 +1,9 @@
+import type { OutputElement } from '@zhin.js/ai';
+import type { DeferredWorkerResult } from '../deferred-worker-runner.js';
+import type { ToolContext } from '../orchestrator/types.js';
+import type { SubagentResultSender } from '../subagent.js';
+export declare function extractDeferredBody(result: DeferredWorkerResult): string;
+export declare function deliverDeferredWorkerResult(sender: SubagentResultSender, context: ToolContext, goal: string, taskId: string, result: DeferredWorkerResult): Promise<void>;
+/** deferred auto-continue 完成后将主 Agent 续聊回复推送到 IM */
+export declare function deliverDeferredAutoContinueReply(sender: SubagentResultSender, context: ToolContext, elements: OutputElement[]): Promise<void>;
+//# sourceMappingURL=deferred-delivery.d.ts.map

package/lib/zhin-agent/deferred-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-delivery.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/deferred-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG3D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAaxE;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,oDAAoD;AACpD,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/lib/zhin-agent/deferred-delivery.js

@@ -0,0 +1,35 @@
+import { truncatePreview } from '@zhin.js/logger';
+import { originFromToolContext } from '../builtin/spawn-task-tool.js';
+import { buildSubagentUserDelivery } from '../media/subagent-user-delivery.js';
+import { resolveSubagentDisplayLabel } from '../subagent-goal-notify.js';
+export function extractDeferredBody(result) {
+    try {
+        const parsed = JSON.parse(result.summary);
+        if (parsed.error?.trim())
+            return parsed.error.trim();
+        if (parsed.summary?.trim())
+            return parsed.summary.trim();
+    }
+    catch {
+        // fall through
+    }
+    return result.summary.trim();
+}
+export async function deliverDeferredWorkerResult(sender, context, goal, taskId, result) {
+    const label = resolveSubagentDisplayLabel(undefined, goal);
+    const body = extractDeferredBody(result) || truncatePreview(goal, 300);
+    const delivery = buildSubagentUserDelivery({
+        label: `deferred:${taskId} ${label}`,
+        status: result.status === 'error' ? 'error' : 'ok',
+        result: body,
+        toolCalls: result.toolCalls ?? [],
+    });
+    await sender(originFromToolContext(context), delivery);
+}
+/** deferred auto-continue 完成后将主 Agent 续聊回复推送到 IM */
+export async function deliverDeferredAutoContinueReply(sender, context, elements) {
+    if (!elements.length)
+        return;
+    await sender(originFromToolContext(context), { text: '', elements });
+}
+//# sourceMappingURL=deferred-delivery.js.map

package/lib/zhin-agent/deferred-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-delivery.js","sourceRoot":"","sources":["../../src/zhin-agent/deferred-delivery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,MAAM,UAAU,mBAAmB,CAAC,MAA4B;IAC9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAIvC,CAAC;QACF,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrD,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAA4B,EAC5B,OAAoB,EACpB,IAAY,EACZ,MAAc,EACd,MAA4B;IAE5B,MAAM,KAAK,GAAG,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,yBAAyB,CAAC;QACzC,KAAK,EAAE,YAAY,MAAM,IAAI,KAAK,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAClD,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,MAA4B,EAC5B,OAAoB,EACpB,QAAyB;IAEzB,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO;IAC7B,MAAM,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/lib/zhin-agent/index.d.ts

@@ -16,23 +16,25 @@
  *  12. 多模态输入：图片/音频直接传给视觉模型
  */
 import type { Plugin } from '@zhin.js/core';
-import type { AIProvider, AgentTool, ContentPart } from '@zhin.js/ai';
+import type { AIProvider, AgentTool, AgentMessage, ContentPart, ImageContent } from '@zhin.js/ai';
 import type { Tool, ToolContext } from '../orchestrator/types.js';
 import type { SkillRegistry } from '../orchestrator/skill-registry.js';
 import type { AgentOrchestrator } from '../orchestrator/index.js';
 import { type SessionManager } from '@zhin.js/ai';
-import type { ChatHistoryContext } from '@zhin.js/ai';
-import { type IMSessionStore } from '@zhin.js/ai';
+import { MemoryAgentSessionStore, type AgentSessionStore, type ContextRepository, type IMSessionStore, type ImTranscriptStore } from '@zhin.js/ai';
 import type { OutputElement } from '@zhin.js/ai';
 import { type ZhinAgentTurnMetrics } from './turn-metrics.js';
+import { TurnTracker } from './turn-tracker.js';
 import { ZhinAgentEventEmitter } from './event-emitter.js';
 import type { ModelRegistry } from '@zhin.js/ai';
 import { UserProfileStore } from '../user-profile.js';
-import { SubagentManager, type SubagentResultSender } from '../subagent.js';
+import { SubagentManager, type SubagentOrigin, type SubagentResultSender } from '../subagent.js';
 import { type ZhinAgentConfig, type OnChunkCallback } from './config.js';
 import type { ResolvedAgentBinding } from '../config/types.js';
+import type { DeferredWorkerResult } from '../deferred-worker-runner.js';
 export type { ZhinAgentConfig, OnChunkCallback } from './config.js';
 export type { ZhinAgentTurnMetrics, ZhinAgentTurnPath } from './turn-metrics.js';
+export { PromptAccessDeniedError } from './prompt-access.js';
 export { formatAiHandlerCompleteLog, formatZhinAgentTurnUsage } from './turn-metrics.js';
 export * from './prompt-builder.js';
 export * from './prompt-templates.js';
@@ -45,8 +47,10 @@ export declare class ZhinAgent {
     private skillRegistry;
     private orchestrator;
     private sessions;
-    private chatHistory;
     private imSessionStore;
+    private agentSessionStore;
+    private contextRepository;
+    private imTranscriptStore;
     private memory;
     private externalTools;
     private userProfiles;
@@ -61,7 +65,10 @@ export declare class ZhinAgent {
     private deferredCatalog;
     private readonly deferredWorkerRunner;
     private lastToolSearchDeferredStats?;
-    private readonly turnTracker;
+    private readonly promptController;
+    private deferredResultSender;
+    private deferredAutoContinueDepthBySession;
+    private lastTurnMetrics;
     private memoryPersistenceReady;
     private resolveMemoryPersistenceReady;
     private memoryPersistenceDone;
@@ -70,16 +77,22 @@ export declare class ZhinAgent {
     setSkillRegistry(registry: SkillRegistry): void;
     setOrchestrator(orchestrator: AgentOrchestrator): void;
     setSessionManager(manager: SessionManager): void;
-    setChatHistory(history: ChatHistoryContext): void;
     setIMSessionStore(store: IMSessionStore): void;
+    setAgentSessionStore(store: AgentSessionStore | MemoryAgentSessionStore): void;
+    setContextRepository(repo: ContextRepository): void;
+    setImTranscriptStore(store: ImTranscriptStore): void;
+    getContextRepository(): ContextRepository;
+    getAgentSessionStore(): AgentSessionStore | MemoryAgentSessionStore;
+    getImTranscriptStore(): ImTranscriptStore;
     setModelRegistry(registry: ModelRegistry): void;
     setHostPlugin(plugin: Plugin): void;
     setProviderResolver(resolver: (alias: string) => AIProvider): void;
+    private wireLlmApiLayer;
     /** 入站回合注入 ai.agents.<name> 绑定（zhin 或其它 route 摘要路径） */
     setActiveBinding(binding: ResolvedAgentBinding | null): void;
     getActiveBinding(): ResolvedAgentBinding | null;
     getTurnProvider(): AIProvider;
-    /** @deprecated 消息事实源已迁至 chat_messages，保留空实现以兼容旧 bootstrap */
+    /** @deprecated 消息事实源已迁至 im_transcripts / agent_messages，保留空实现以兼容旧 bootstrap */
     upgradeMemoryToDatabase(_msgModel: unknown, _sumModel: unknown): Promise<void>;
     /** 等待 DB store 注入（bootstrap 会 mark；已 mark 时立即返回） */
     waitForMemoryPersistence(): Promise<void>;
@@ -87,7 +100,16 @@ export declare class ZhinAgent {
     upgradeProfilesToDatabase(model: any): void;
     initSubagentManager(createTools: () => AgentTool[]): void;
     setSubagentSender(sender: SubagentResultSender): void;
+    setDeferredResultSender(sender: SubagentResultSender): void;
+    getDeferredResultSender(): SubagentResultSender | null;
+    getDeferredAutoContinueDepth(sessionKey: string): number;
+    resetDeferredAutoContinueDepth(sessionKey: string): void;
+    continueAfterDeferredWorker(context: ToolContext, taskId: string, goal: string, result: DeferredWorkerResult): Promise<void>;
+    getActiveTurnTracker(): TurnTracker | undefined;
+    runInTurnContext<T>(turnId: string, fn: () => Promise<T>): Promise<T>;
     getSubagentManager(): SubagentManager | null;
+    /** fork 模式：主会话 active_leaf 链快照（不含 spawn_task / tool_search 编排噪声） */
+    buildParentContextSnapshotForSubagent(origin: SubagentOrigin): Promise<string | undefined>;
     getEventEmitter(): ZhinAgentEventEmitter;
     getUserProfiles(): UserProfileStore;
     registerTool(tool: AgentTool): () => void;
@@ -98,11 +120,38 @@ export declare class ZhinAgent {
     private beginActiveTurn;
     private finalizeActiveTurn;
     private emitSessionNewEvent;
-    private emitSessionCompactEvent;
-    /** 旁听由 zhin `message.receive` 写入 chat_messages，此处保留空实现 */
+    emitSessionCompactEvent(sessionId: string, context: ToolContext, mode: 'text' | 'multimodal', info: {
+        microSavedTokens: number;
+        autoSavedTokens: number;
+        totalTokensBefore: number;
+        totalTokensAfter: number;
+    }): void;
+    private assertMasterForPromptControl;
+    subscribe(listener: (event: import('@zhin.js/ai').AgentEvent, signal: AbortSignal) => void | Promise<void>): () => void;
+    abort(): void;
+    waitForIdle(): Promise<void>;
+    isPromptBusy(): boolean;
+    clearSteeringQueue(sessionKey?: string): void;
+    clearFollowUpQueue(sessionKey?: string): void;
+    steer(message: AgentMessage, context: ToolContext): void;
+    followUp(message: AgentMessage, context: ToolContext): void;
+    /**
+     * 对齐 Agent.prompt：入队并执行 LLM turn（需 IM ToolContext）。
+     * process() / processMultimodal() 在 agentLoop 路径下内部委托此方法。
+     */
+    prompt(input: string | AgentMessage | AgentMessage[], context: ToolContext, options?: {
+        images?: ImageContent[];
+        onChunk?: OnChunkCallback;
+    }): Promise<void>;
+    /** 旁听由 zhin `message.receive` 写入 im_transcripts，此处保留空实现 */
     appendPassiveGroupChatter(_context: ToolContext, _rawContent: string): Promise<void>;
-    /** 归档当前场景 active 会话（/new、ai.clear）；下次 @ 将创建新 session 纪元 */
+    /** 归档当前场景 active 会话（/reset）；下次 @ 将创建新 session 纪元 */
     archiveSessionForContext(context: ToolContext): Promise<boolean>;
+    /** 手动压缩当前 session epoch（/compact） */
+    compactSessionForContext(context: ToolContext): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
     process(content: string, context: ToolContext, externalTools?: Tool[], onChunk?: OnChunkCallback): Promise<OutputElement[]>;
     private resolveAgentToolsForTurn;
     private runDeferredWorker;

package/lib/zhin-agent/index.d.ts.map

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