@zhin.js/agent 0.2.1 → 0.3.1

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

@@ -3,7 +3,13 @@
  */
 import type { RateLimitConfig } from '@zhin.js/ai';
 import { type QueueMode } from '@zhin.js/ai';
+import type { AIProvider, AgentSessionStore, ContextRepository, IMSessionStore, ImTranscriptStore, MemoryAgentSessionStore, MemoryIMSessionStore, ModelRegistry, SessionManager } from '@zhin.js/ai';
+import type { Plugin } from '@zhin.js/core';
 import type { ModelHarnessConfig } from './model-harness.js';
+import type { AgentOrchestrator } from '../orchestrator/index.js';
+import type { SkillRegistry } from '../orchestrator/skill-registry.js';
+import type { SubagentResultSender } from '../subagent.js';
+import type { ResolvedAgentBinding } from '../config/types.js';
 export type ModelSizeHint = 'small' | 'medium' | 'large';
 export type ExecApprovalMode = 'ask' | 'allow' | 'deny';
 /**
@@ -83,6 +89,16 @@ export interface ZhinAgentConfig {
     modelHarness?: ModelHarnessConfig;
     /** 输出回合 phase 观测日志（或通过 ZHIN_AGENT_PHASE_TRACE 环境变量开启） */
     phaseTrace?: boolean;
+    /** 记录发往 LLM 的提示词规模分段（或通过 ZHIN_AGENT_PROMPT_TRACE；默认随 phaseTrace 开启） */
+    promptTrace?: boolean;
+    /** promptTrace 时输出 system 首尾预览（或 ZHIN_AGENT_PROMPT_TRACE_VERBOSE） */
+    promptTraceVerbose?: boolean;
+    /** Provider prompt cache（anthropic / openai / openai-compatible）；默认启用，仅显式 false 禁用 */
+    promptCache?: boolean;
+    /** OpenAI `prompt_cache_retention`（默认 in_memory；部分模型支持 24h） */
+    promptCacheRetention?: 'in_memory' | '24h';
+    /** OpenAI `prompt_cache_key` 前缀（默认 zhin） */
+    promptCacheKeyPrefix?: string;
     /** phase 观测回调（测试或自定义遥测；与 phaseTrace 同时生效） */
     onPhaseTrace?: (event: {
         phase: string;
@@ -116,10 +132,10 @@ export interface ZhinAgentConfig {
     deferredAutoContinueMaxDepth?: number;
 }
 /** 主 Agent 默认常驻编排工具（不含 activate_skill：执行一律经 Worker；文生图走 deferred） */
-export declare const DEFAULT_ORCHESTRATOR_TOOLS: readonly ["tool_search", "web_search", "run_deferred_task", "ask_user", "spawn_task"];
+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", "web_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"];
+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 */
@@ -127,12 +143,46 @@ export declare const TOOL_SEARCH_EXCLUDED_TOOLS: readonly ["activate_skill", "in
 /** Deferred Worker 默认基础工具 */
 export declare const DEFAULT_WORKER_BASE_TOOLS: readonly ["bash", "read_file", "web_search"];
 /** @deprecated 使用 DEFAULT_ORCHESTRATOR_TOOLS */
-export declare const DEFAULT_TOOL_SEARCH_ORCHESTRATOR_TOOLS: readonly ["tool_search", "web_search", "run_deferred_task", "ask_user", "spawn_task"];
+export declare const DEFAULT_TOOL_SEARCH_ORCHESTRATOR_TOOLS: readonly ["tool_search", "run_deferred_task", "ask_user", "spawn_task"];
 /** @deprecated 使用 DEFAULT_WORKER_BASE_TOOLS */
 export declare const DEFAULT_TOOL_SEARCH_WORKER_BASE_TOOLS: readonly ["bash", "read_file", "web_search"];
+/** ZhinAgent 运行依赖（通过 setter 或 configure() 注入） */
+export interface ZhinAgentDependencies {
+    skillRegistry: SkillRegistry;
+    orchestrator: AgentOrchestrator;
+    sessionManager: SessionManager;
+    imSessionStore: IMSessionStore | MemoryIMSessionStore;
+    agentSessionStore: AgentSessionStore | MemoryAgentSessionStore;
+    contextRepository: ContextRepository;
+    imTranscriptStore: ImTranscriptStore;
+    modelRegistry: ModelRegistry;
+    hostPlugin: Plugin;
+    providerResolver: (alias: string) => AIProvider;
+    activeBinding: ResolvedAgentBinding;
+    subagentSender: SubagentResultSender;
+    deferredResultSender: SubagentResultSender;
+    bootstrapContext: string;
+    activeSkillsContext: string;
+    skillsSummaryXML: string;
+}
 export declare const DEFAULT_CONFIG: Required<ZhinAgentConfig>;
 /** `env` 参数主要用于测试注入，运行时默认读取 `process.env`。 */
 export declare function isPhaseTraceEnabled(config: Required<ZhinAgentConfig>, env?: NodeJS.ProcessEnv): boolean;
+/** 默认随 phaseTrace 开启；可单独用 `ZHIN_AGENT_PROMPT_TRACE` 或 `ai.agent.promptTrace` 控制。 */
+export declare function isPromptTraceEnabled(config: Required<ZhinAgentConfig>, env?: NodeJS.ProcessEnv): boolean;
+export declare function isPromptTraceVerbose(config: Required<ZhinAgentConfig>, env?: NodeJS.ProcessEnv): boolean;
+/** Provider prompt cache：默认启用；`promptCache: false` 或 `ZHIN_AGENT_PROMPT_CACHE=0` 显式禁用。 */
+export declare function isPromptCacheEnabled(config: Pick<ZhinAgentConfig, 'promptCache'>, modelSdk: string | undefined, env?: NodeJS.ProcessEnv): boolean;
+export declare function buildAgentPromptCacheStreamOptions(config: Pick<ZhinAgentConfig, 'promptCache' | 'promptCacheRetention' | 'promptCacheKeyPrefix'>, parts: {
+    modelSdk: string | undefined;
+    provider: string;
+    modelId: string;
+    label: string;
+}, env?: NodeJS.ProcessEnv): {
+    promptCache: boolean;
+    promptCacheKey?: string;
+    promptCacheRetention?: 'in_memory' | '24h';
+};
 /** run_deferred_task 外层超时：须覆盖 Worker 多轮 LLM + MCP（默认远高于 Agent 30s 工具超时） */
 export declare function resolveDeferredTaskToolTimeout(config: Pick<Required<ZhinAgentConfig>, 'timeout' | 'subagentTurnWaitMs' | 'maxSubagentIterations'>): number;
 /** Worker 内慢工具（MCP 等）默认超时 */

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, DEFAULT_FOLLOW_UP_MODE, DEFAULT_STEERING_MODE } from '@zhin.js/ai';
+import { DEFAULT_CONTEXT_TOKENS, DEFAULT_FOLLOW_UP_MODE, DEFAULT_STEERING_MODE, buildPromptCacheKey } 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;
 /**
@@ -50,7 +50,6 @@ export const KEYWORD_TRIGGERS = {
 /** 主 Agent 默认常驻编排工具（不含 activate_skill：执行一律经 Worker；文生图走 deferred） */
 export const DEFAULT_ORCHESTRATOR_TOOLS = [
     'tool_search',
-    'web_search',
     'run_deferred_task',
     'ask_user',
     'spawn_task',
@@ -122,6 +121,9 @@ export const DEFAULT_CONFIG = {
     modelHarness: {},
     phaseTrace: false,
     onPhaseTrace: () => { },
+    promptTraceVerbose: false,
+    promptCacheRetention: 'in_memory',
+    promptCacheKeyPrefix: 'zhin',
     deferredToolMaxResults: 8,
     orchestratorTools: [...DEFAULT_ORCHESTRATOR_TOOLS],
     workerBaseTools: [...DEFAULT_WORKER_BASE_TOOLS],
@@ -140,6 +142,55 @@ export function isPhaseTraceEnabled(config, env = process.env) {
     const raw = env.ZHIN_AGENT_PHASE_TRACE?.trim().toLowerCase();
     return !!raw && TRUE_VALUES.has(raw);
 }
+function envFlagEnabled(env, key) {
+    const raw = env[key]?.trim().toLowerCase();
+    return !!raw && TRUE_VALUES.has(raw);
+}
+/** 默认随 phaseTrace 开启；可单独用 `ZHIN_AGENT_PROMPT_TRACE` 或 `ai.agent.promptTrace` 控制。 */
+export function isPromptTraceEnabled(config, env = process.env) {
+    if (config.promptTrace === true)
+        return true;
+    if (config.promptTrace === false) {
+        return envFlagEnabled(env, 'ZHIN_AGENT_PROMPT_TRACE');
+    }
+    if (envFlagEnabled(env, 'ZHIN_AGENT_PROMPT_TRACE'))
+        return true;
+    return isPhaseTraceEnabled(config, env);
+}
+export function isPromptTraceVerbose(config, env = process.env) {
+    if (config.promptTraceVerbose)
+        return true;
+    return envFlagEnabled(env, 'ZHIN_AGENT_PROMPT_TRACE_VERBOSE');
+}
+/** Provider prompt cache：默认启用；`promptCache: false` 或 `ZHIN_AGENT_PROMPT_CACHE=0` 显式禁用。 */
+export function isPromptCacheEnabled(config, modelSdk, env = process.env) {
+    const supported = modelSdk === 'anthropic'
+        || modelSdk === 'openai'
+        || modelSdk === 'openai-compatible';
+    if (!supported)
+        return false;
+    if (config.promptCache === false)
+        return false;
+    const raw = env.ZHIN_AGENT_PROMPT_CACHE?.trim().toLowerCase();
+    if (raw && ['0', 'false', 'no', 'off'].includes(raw))
+        return false;
+    return true;
+}
+export function buildAgentPromptCacheStreamOptions(config, parts, env = process.env) {
+    const promptCache = isPromptCacheEnabled(config, parts.modelSdk, env);
+    if (!promptCache)
+        return { promptCache: false };
+    return {
+        promptCache: true,
+        promptCacheKey: buildPromptCacheKey({
+            prefix: config.promptCacheKeyPrefix ?? 'zhin',
+            label: parts.label,
+            provider: parts.provider,
+            modelId: parts.modelId,
+        }),
+        promptCacheRetention: config.promptCacheRetention ?? 'in_memory',
+    };
+}
 /** run_deferred_task 外层超时：须覆盖 Worker 多轮 LLM + MCP（默认远高于 Agent 30s 工具超时） */
 export function resolveDeferredTaskToolTimeout(config) {
     const turnMs = config.timeout ?? 60_000;

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/index.d.ts

@@ -20,8 +20,6 @@ import type { AIProvider, AgentTool, AgentMessage, ContentPart, ImageContent } f
 import type { Tool, Message } 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 { 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';
@@ -29,17 +27,19 @@ import { ZhinAgentEventEmitter } from './event-emitter.js';
 import type { ModelRegistry } from '@zhin.js/ai';
 import { UserProfileStore } from '../user-profile.js';
 import { SubagentManager, type SubagentOrigin, type SubagentResultSender } from '../subagent.js';
-import { type ZhinAgentConfig, type OnChunkCallback } from './config.js';
+import { type ZhinAgentConfig, type OnChunkCallback, type ZhinAgentDependencies } 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 { IAgentTurnProcessor, IAgentSessionManager, IAgentDiagnostics, IAgentConfigurator } from './interfaces.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';
 export * from './task-continuation.js';
-export declare class ZhinAgent {
+import type { IAgentTurnProcessor, IAgentSessionManager, IAgentDiagnostics, IAgentConfigurator } from './interfaces.js';
+export declare class ZhinAgent implements IAgentTurnProcessor, IAgentSessionManager, IAgentDiagnostics, IAgentConfigurator {
     private provider;
     private providerResolver;
     private activeBinding;
@@ -61,6 +61,8 @@ export declare class ZhinAgent {
     private skillsSummaryXML;
     private modelRegistry;
     private phaseTraceEnabled;
+    private promptTraceEnabled;
+    private promptTraceVerbose;
     private readonly emitter;
     private deferredCatalog;
     private readonly deferredWorkerRunner;
@@ -73,22 +75,25 @@ export declare class ZhinAgent {
     private resolveMemoryPersistenceReady;
     private memoryPersistenceDone;
     private get phaseConfig();
+    private get promptTraceConfig();
     constructor(provider: AIProvider, config?: ZhinAgentConfig);
+    /**
+     * 统一依赖注入入口。替代逐字段 setter。
+     * 所有 setter 现委托到此方法；新代码优先使用 configure()。
+     */
+    configure(deps: Partial<ZhinAgentDependencies>): void;
+    /** @deprecated 使用 configure({ skillRegistry }) */
     setSkillRegistry(registry: SkillRegistry): void;
+    /** @deprecated 使用 configure({ orchestrator }) */
     setOrchestrator(orchestrator: AgentOrchestrator): void;
-    setSessionManager(manager: SessionManager): 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;
+    /** @deprecated 使用 configure({ modelRegistry }) */
     setModelRegistry(registry: ModelRegistry): void;
+    /** @deprecated 使用 configure({ hostPlugin }) */
     setHostPlugin(plugin: Plugin): void;
+    /** @deprecated 使用 configure({ providerResolver }) */
     setProviderResolver(resolver: (alias: string) => AIProvider): void;
     private wireLlmApiLayer;
-    /** 入站回合注入 ai.agents.<name> 绑定（zhin 或其它 route 摘要路径） */
+    /** @deprecated 使用 configure({ activeBinding }) */
     setActiveBinding(binding: ResolvedAgentBinding | null): void;
     getActiveBinding(): ResolvedAgentBinding | null;
     getTurnProvider(): AIProvider;
@@ -99,7 +104,9 @@ export declare class ZhinAgent {
     markMemoryPersistenceReady(): void;
     upgradeProfilesToDatabase(model: any): void;
     initSubagentManager(createTools: () => AgentTool[]): void;
+    /** @deprecated 使用 configure({ subagentSender }) */
     setSubagentSender(sender: SubagentResultSender): void;
+    /** @deprecated 使用 configure({ deferredResultSender }) */
     setDeferredResultSender(sender: SubagentResultSender): void;
     getDeferredResultSender(): SubagentResultSender | null;
     getDeferredAutoContinueDepth(sessionKey: string): number;
@@ -113,9 +120,6 @@ export declare class ZhinAgent {
     getEventEmitter(): ZhinAgentEventEmitter;
     getUserProfiles(): UserProfileStore;
     registerTool(tool: AgentTool): () => void;
-    setBootstrapContext(context: string): void;
-    setActiveSkillsContext(content: string): void;
-    setSkillsSummaryXML(xml: string): void;
     getLastTurnMetrics(): ZhinAgentTurnMetrics | null;
     private beginActiveTurn;
     private finalizeActiveTurn;

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":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EAGb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,uBAAuB,EAMvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGjG,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EAGrB,MAAM,aAAa,CAAC;AAerB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAQ/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACzF,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AAUvC,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,cAAc,CAAqE;IAC3F,OAAO,CAAC,iBAAiB,CAA8C;IACvE,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,mBAAmB,CAAc;IACzC,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8B;IACnE,OAAO,CAAC,2BAA2B,CAAC,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,kCAAkC,CAA6B;IACvE,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,sBAAsB,CAAgB;IAC9C,OAAO,CAAC,6BAA6B,CAAc;IACnD,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,KAAK,WAAW,GAEtB;gBAEW,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,eAAe;IAiC1D,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAK/C,eAAe,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI;IAKtD,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAKhD,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAI9C,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,uBAAuB,GAAG,IAAI;IAI9E,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAInD,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAIpD,oBAAoB,IAAI,iBAAiB;IAIzC,oBAAoB,IAAI,iBAAiB,GAAG,uBAAuB;IAInE,oBAAoB,IAAI,iBAAiB;IAIzC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAK/C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAInC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI;IAKlE,OAAO,CAAC,eAAe;IAiBvB,sDAAsD;IACtD,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI;IAW5D,gBAAgB,IAAI,oBAAoB,GAAG,IAAI;IAI/C,eAAe,IAAI,UAAU;IAY7B,+EAA+E;IACzE,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpF,oDAAoD;IAC9C,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB/C,0BAA0B,IAAI,IAAI;IAMlC,yBAAyB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAI3C,mBAAmB,CAAC,WAAW,EAAE,MAAM,SAAS,EAAE,GAAG,IAAI;IAyCzD,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAMrD,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAI3D,uBAAuB,IAAI,oBAAoB,GAAG,IAAI;IAItD,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIxD,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIlD,2BAA2B,CAC/B,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAkChB,oBAAoB,IAAI,WAAW,GAAG,SAAS;IAI/C,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKrE,kBAAkB,IAAI,eAAe,GAAG,IAAI;IAI5C,oEAAoE;IAC9D,qCAAqC,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAShG,eAAe,IAAI,qBAAqB;IAIxC,eAAe,IAAI,gBAAgB;IAInC,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,IAAI;IAKzC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK1C,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7C,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAItC,kBAAkB,IAAI,oBAAoB,GAAG,IAAI;IAIjD,OAAO,CAAC,eAAe;YAMT,kBAAkB;IAShC,OAAO,CAAC,mBAAmB;IAc3B,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EACpB,IAAI,EAAE,MAAM,GAAG,YAAY,EAC3B,IAAI,EAAE;QACJ,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GACA,IAAI;IAaP,OAAO,CAAC,4BAA4B;IAapC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAIvH,KAAK,IAAI,IAAI;IAIb,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,YAAY,IAAI,OAAO;IAIvB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7C,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7C,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;IAMxD,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;IAM3D;;;OAGG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,EAAE,EAC7C,WAAW,EAAE,OAAO,EACpB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,eAAe,CAAA;KAAE,GAC/D,OAAO,CAAC,IAAI,CAAC;IAqBhB,2DAA2D;IACrD,yBAAyB,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F,oDAAoD;IAC9C,4BAA4B,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAY1E,qCAAqC;IAC/B,4BAA4B,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAuB7F,OAAO,CACX,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,EACpB,aAAa,GAAE,IAAI,EAAO,EAC1B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC;IAK3B,OAAO,CAAC,wBAAwB;YAOlB,iBAAiB;IAS/B,OAAO,CAAC,sBAAsB;IAIxB,iBAAiB,CACrB,KAAK,EAAE,WAAW,EAAE,EACpB,WAAW,EAAE,OAAO,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC;IAU3B,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,IAAI;CAiChB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/index.ts"],"names":[],"mappings":"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"}

package/lib/zhin-agent/index.js

@@ -16,10 +16,9 @@
  *  12. 多模态输入：图片/音频直接传给视觉模型
  */
 import { randomUUID } from 'node:crypto';
-import { getPlugin } from '@zhin.js/core';
 import { formatCompact, Logger } from '@zhin.js/logger';
 import { createMemorySessionManager, resolveIMSessionIdFromMessage, } from '@zhin.js/ai';
-import { ConversationMemory, createMemoryContextRepository, MemoryIMSessionStore, MemoryImTranscriptStore, getModel, registerLlmApiFromProviders, setLegacyProviderResolver, } from '@zhin.js/ai';
+import { ConversationMemory, createMemoryContextRepository, MemoryIMSessionStore, MemoryImTranscriptStore, getModel, registerLlmApiFromProviders, sdkEntryFromProvider, } from '@zhin.js/ai';
 import { TurnTracker } from './turn-tracker.js';
 import { ZhinAgentEventEmitter } from './event-emitter.js';
 import { UserProfileStore } from '../user-profile.js';
@@ -27,7 +26,7 @@ import { RateLimiter } from '@zhin.js/ai';
 import { SubagentManager } from '../subagent.js';
 import { buildParentContextPreamble } from '../subagent-parent-context.js';
 import { getAgentDispatcher } from '../orchestrator/agent-dispatcher.js';
-import { DEFAULT_CONFIG, isPhaseTraceEnabled, } from './config.js';
+import { DEFAULT_CONFIG, isPhaseTraceEnabled, isPromptTraceEnabled, isPromptTraceVerbose, } from './config.js';
 import { DeferredWorkerRunner } from '../deferred-worker-runner.js';
 import { deliverDeferredAutoContinueReply } from './deferred-delivery.js';
 import { processTextTurn, processMultimodalTurn } from './turn-pipeline.js';
@@ -74,6 +73,8 @@ export class ZhinAgent {
     skillsSummaryXML = '';
     modelRegistry = null;
     phaseTraceEnabled;
+    promptTraceEnabled;
+    promptTraceVerbose;
     emitter = new ZhinAgentEventEmitter();
     deferredCatalog = [];
     deferredWorkerRunner = new DeferredWorkerRunner();
@@ -88,10 +89,18 @@ export class ZhinAgent {
     get phaseConfig() {
         return { phaseTraceEnabled: this.phaseTraceEnabled, onPhaseTrace: this.config.onPhaseTrace };
     }
+    get promptTraceConfig() {
+        return {
+            promptTraceEnabled: this.promptTraceEnabled,
+            promptTraceVerbose: this.promptTraceVerbose,
+        };
+    }
     constructor(provider, config) {
         this.provider = provider;
         this.config = { ...DEFAULT_CONFIG, ...config };
         this.phaseTraceEnabled = isPhaseTraceEnabled(this.config);
+        this.promptTraceEnabled = isPromptTraceEnabled(this.config);
+        this.promptTraceVerbose = isPromptTraceVerbose(this.config);
         this.memoryPersistenceReady = new Promise((resolve) => {
             this.resolveMemoryPersistenceReady = resolve;
         });
@@ -116,73 +125,85 @@ export class ZhinAgent {
         // DB 注入完成前由 waitForMemoryPersistence 等待；useDatabase:false 时由 bootstrap 立即 mark
     }
     // ── DI setters ──────────────────────────────────────────────────────
-    setSkillRegistry(registry) {
-        this.skillRegistry = registry;
-        logger.debug(`SkillRegistry connected (${registry.size} skills)`);
-    }
-    setOrchestrator(orchestrator) {
-        this.orchestrator = orchestrator;
-        logger.debug('AgentOrchestrator connected for MCP and resources');
-    }
-    setSessionManager(manager) {
-        this.sessions.dispose();
-        this.sessions = manager;
-    }
-    setIMSessionStore(store) {
-        this.imSessionStore = store;
-    }
-    setAgentSessionStore(store) {
-        this.agentSessionStore = store;
-    }
-    setContextRepository(repo) {
-        this.contextRepository = repo;
-    }
-    setImTranscriptStore(store) {
-        this.imTranscriptStore = store;
-    }
-    getContextRepository() {
-        return this.contextRepository;
-    }
-    getAgentSessionStore() {
-        return this.agentSessionStore;
-    }
-    getImTranscriptStore() {
-        return this.imTranscriptStore;
-    }
-    setModelRegistry(registry) {
-        this.modelRegistry = registry;
-        this.subagentManager?.setModelRegistry(registry);
-    }
-    setHostPlugin(plugin) {
-        this.emitter.setHostPlugin(plugin);
-    }
-    setProviderResolver(resolver) {
-        this.providerResolver = resolver;
-        this.wireLlmApiLayer();
-    }
+    /**
+     * 统一依赖注入入口。替代逐字段 setter。
+     * 所有 setter 现委托到此方法；新代码优先使用 configure()。
+     */
+    configure(deps) {
+        if (deps.skillRegistry !== undefined) {
+            this.skillRegistry = deps.skillRegistry;
+            logger.debug(`SkillRegistry connected (${deps.skillRegistry.size} skills)`);
+        }
+        if (deps.orchestrator !== undefined) {
+            this.orchestrator = deps.orchestrator;
+            logger.debug('AgentOrchestrator connected for MCP and resources');
+        }
+        if (deps.sessionManager !== undefined) {
+            this.sessions.dispose();
+            this.sessions = deps.sessionManager;
+        }
+        if (deps.imSessionStore !== undefined)
+            this.imSessionStore = deps.imSessionStore;
+        if (deps.agentSessionStore !== undefined)
+            this.agentSessionStore = deps.agentSessionStore;
+        if (deps.contextRepository !== undefined)
+            this.contextRepository = deps.contextRepository;
+        if (deps.imTranscriptStore !== undefined)
+            this.imTranscriptStore = deps.imTranscriptStore;
+        if (deps.modelRegistry !== undefined) {
+            this.modelRegistry = deps.modelRegistry;
+            this.subagentManager?.setModelRegistry(deps.modelRegistry);
+        }
+        if (deps.hostPlugin !== undefined)
+            this.emitter.setHostPlugin(deps.hostPlugin);
+        if (deps.providerResolver !== undefined) {
+            this.providerResolver = deps.providerResolver;
+            this.wireLlmApiLayer();
+        }
+        if (deps.activeBinding !== undefined) {
+            this.activeBinding = deps.activeBinding;
+            if (deps.activeBinding) {
+                const patch = bindingToModelConfig(deps.activeBinding);
+                this.config = { ...this.config, ...patch };
+            }
+        }
+        if (deps.subagentSender !== undefined) {
+            this.subagentManager?.setSender(deps.subagentSender);
+        }
+        if (deps.deferredResultSender !== undefined)
+            this.deferredResultSender = deps.deferredResultSender;
+        if (deps.bootstrapContext !== undefined) {
+            this.bootstrapContext = deps.bootstrapContext;
+            logger.debug(`Bootstrap context set (${deps.bootstrapContext.length} chars)`);
+        }
+        if (deps.activeSkillsContext !== undefined)
+            this.activeSkillsContext = deps.activeSkillsContext || '';
+        if (deps.skillsSummaryXML !== undefined)
+            this.skillsSummaryXML = deps.skillsSummaryXML || '';
+    }
+    /** @deprecated 使用 configure({ skillRegistry }) */
+    setSkillRegistry(registry) { this.configure({ skillRegistry: registry }); }
+    /** @deprecated 使用 configure({ orchestrator }) */
+    setOrchestrator(orchestrator) { this.configure({ orchestrator }); }
+    /** @deprecated 使用 configure({ modelRegistry }) */
+    setModelRegistry(registry) { this.configure({ modelRegistry: registry }); }
+    /** @deprecated 使用 configure({ hostPlugin }) */
+    setHostPlugin(plugin) { this.configure({ hostPlugin: plugin }); }
+    /** @deprecated 使用 configure({ providerResolver }) */
+    setProviderResolver(resolver) { this.configure({ providerResolver: resolver }); }
     wireLlmApiLayer() {
-        const resolve = (alias) => {
-            if (alias === this.provider.name)
-                return this.provider;
-            return this.providerResolver?.(alias);
-        };
-        setLegacyProviderResolver(resolve);
-        registerLlmApiFromProviders([{
-                alias: this.provider.name,
-                provider: this.provider,
-                config: { api: 'openai-completions' },
-                models: [],
-            }], resolve);
-    }
-    /** 入站回合注入 ai.agents.<name> 绑定（zhin 或其它 route 摘要路径） */
+        registerLlmApiFromProviders([sdkEntryFromProvider(this.provider)], (alias) => {
+            const p = alias === this.provider.name ? this.provider : this.providerResolver?.(alias);
+            return p?.models ?? [];
+        });
+    }
+    /** @deprecated 使用 configure({ activeBinding }) */
     setActiveBinding(binding) {
-        this.activeBinding = binding;
-        if (binding) {
-            const patch = bindingToModelConfig(binding);
-            this.config = {
-                ...this.config,
-                ...patch,
-            };
+        if (binding === null) {
+            this.activeBinding = null;
+        }
+        else {
+            this.configure({ activeBinding: binding });
         }
     }
     getActiveBinding() {
@@ -273,14 +294,10 @@ export class ZhinAgent {
         });
         logger.debug('SubagentManager initialized');
     }
-    setSubagentSender(sender) {
-        if (this.subagentManager) {
-            this.subagentManager.setSender(sender);
-        }
-    }
-    setDeferredResultSender(sender) {
-        this.deferredResultSender = sender;
-    }
+    /** @deprecated 使用 configure({ subagentSender }) */
+    setSubagentSender(sender) { this.configure({ subagentSender: sender }); }
+    /** @deprecated 使用 configure({ deferredResultSender }) */
+    setDeferredResultSender(sender) { this.configure({ deferredResultSender: sender }); }
     getDeferredResultSender() {
         return this.deferredResultSender;
     }
@@ -346,16 +363,6 @@ export class ZhinAgent {
         this.externalTools.set(tool.name, tool);
         return () => { this.externalTools.delete(tool.name); };
     }
-    setBootstrapContext(context) {
-        this.bootstrapContext = context;
-        logger.debug(`Bootstrap context set (${context.length} chars)`);
-    }
-    setActiveSkillsContext(content) {
-        this.activeSkillsContext = content || '';
-    }
-    setSkillsSummaryXML(xml) {
-        this.skillsSummaryXML = xml || '';
-    }
     getLastTurnMetrics() {
         return this.lastTurnMetrics;
     }
@@ -391,8 +398,11 @@ export class ZhinAgent {
     }
     // ── prompt() / steer / followUp (ADR 0009 D6) ─────────────────────
     assertMasterForPromptControl(commMessage) {
+        const plugin = this.emitter.getHostPlugin();
+        if (!plugin) {
+            throw new PromptAccessDeniedError('steer/followUp 需要有效的 master 上下文');
+        }
         try {
-            const plugin = getPlugin().root ?? getPlugin();
             const role = resolveToolRequesterRole(plugin, commMessage);
             if (role !== 'master') {
                 throw new PromptAccessDeniedError('steer/followUp 仅 master 可用');
@@ -523,21 +533,20 @@ export class ZhinAgent {
         if (this.promptController) {
             this.promptController.abort();
         }
-        if (this.imSessionStore && typeof this.imSessionStore.dispose === 'function') {
-            this.imSessionStore.dispose();
-        }
-        if (this.agentSessionStore && typeof this.agentSessionStore.dispose === 'function') {
-            this.agentSessionStore.dispose();
-        }
-        if (this.contextRepository && typeof this.contextRepository.dispose === 'function') {
-            this.contextRepository.dispose();
-        }
-        if (this.imTranscriptStore && typeof this.imTranscriptStore.dispose === 'function') {
-            this.imTranscriptStore.dispose();
-        }
+        // 使用 Disposable 接口统一清理资源（运行时 has-dispose 检查）
+        const tryDispose = (obj) => {
+            if (obj && typeof obj.dispose === 'function') {
+                obj.dispose?.();
+            }
+        };
+        tryDispose(this.imSessionStore);
+        tryDispose(this.agentSessionStore);
+        tryDispose(this.contextRepository);
+        tryDispose(this.imTranscriptStore);
         this.deferredAutoContinueDepthBySession.clear();
         this.deferredCatalog = [];
         this.lastTurnMetrics = null;
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- disposed, fields intentionally nulled
         this.provider = null;
         this.providerResolver = null;
         this.skillRegistry = null;