@zhin.js/agent 0.3.1 → 1.0.2

package/lib/config/resolve-pipeline-binding.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 协作群 pipelineRole → agent 绑定。
+ *
+ * SSOT：`ai.agents.zhin`；可选 `ai.agents.<role>`（如 researcher）覆盖 provider/model/nickname。
+ */
+import type { PipelineRole } from '../collaboration/types.js';
+import { type AgentBindingConfig, type ResolvedAgentBinding } from './types.js';
+/** 角色昵称缺省回退（英文 role label）。 */
+export declare const PIPELINE_ROLE_LABELS: Record<PipelineRole, string>;
+export interface RoleBindingSources {
+    agents: Record<string, AgentBindingConfig>;
+}
+export declare function resolvePipelineRoleBinding(role: PipelineRole, sources: RoleBindingSources): ResolvedAgentBinding;
+/** Planner 入口（= zhin binding）的展示昵称。 */
+export declare function resolvePlannerNickname(sources: RoleBindingSources): string;
+//# sourceMappingURL=resolve-pipeline-binding.d.ts.map

package/lib/config/resolve-pipeline-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-pipeline-binding.d.ts","sourceRoot":"","sources":["../../src/config/resolve-pipeline-binding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAA2B,MAAM,YAAY,CAAC;AACzG,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAM7D,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC5C;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,kBAAkB,GAC1B,oBAAoB,CAqBtB;AAED,uCAAuC;AACvC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAE1E"}

package/lib/config/resolve-pipeline-binding.js

@@ -0,0 +1,35 @@
+import { DEFAULT_ZHIN_AGENT_NAME } from './types.js';
+/** 角色昵称缺省回退（英文 role label）。 */
+export const PIPELINE_ROLE_LABELS = {
+    planner: 'Planner',
+    researcher: 'Researcher',
+    evaluator: 'Evaluator',
+    executor: 'Executor',
+    reviewer: 'Reviewer',
+};
+export function resolvePipelineRoleBinding(role, sources) {
+    const base = sources.agents[DEFAULT_ZHIN_AGENT_NAME];
+    if (!base) {
+        throw new Error(`ai.agents.${DEFAULT_ZHIN_AGENT_NAME} is required to resolve pipeline role "${role}"`);
+    }
+    const roleAgent = sources.agents[role];
+    const provider = roleAgent?.provider ?? base.provider;
+    const model = roleAgent?.model ?? base.model;
+    const mcpServers = roleAgent?.mcpServers ?? base.mcpServers ?? [];
+    const nickname = roleAgent?.nickname
+        ?? (role === 'planner' ? base.nickname : undefined)
+        ?? PIPELINE_ROLE_LABELS[role];
+    return {
+        name: role,
+        providerAlias: provider,
+        model,
+        mcpServers,
+        nickname,
+        permission: roleAgent?.permission ?? base.permission,
+    };
+}
+/** Planner 入口（= zhin binding）的展示昵称。 */
+export function resolvePlannerNickname(sources) {
+    return resolvePipelineRoleBinding('planner', sources).nickname ?? PIPELINE_ROLE_LABELS.planner;
+}
+//# sourceMappingURL=resolve-pipeline-binding.js.map

package/lib/config/resolve-pipeline-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-pipeline-binding.js","sourceRoot":"","sources":["../../src/config/resolve-pipeline-binding.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsD,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACzG,+BAA+B;AAC/B,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAMF,MAAM,UAAU,0BAA0B,CACxC,IAAkB,EAClB,OAA2B;IAE3B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,aAAa,uBAAuB,0CAA0C,IAAI,GAAG,CAAC,CAAC;IACzG,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,SAAS,EAAE,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;IACtD,MAAM,KAAK,GAAG,SAAS,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;IAC7C,MAAM,UAAU,GAAG,SAAS,EAAE,UAAU,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAClE,MAAM,QAAQ,GACZ,SAAS,EAAE,QAAQ;WAChB,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;WAChD,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO;QACL,IAAI,EAAE,IAAI;QACV,aAAa,EAAE,QAAQ;QACvB,KAAK;QACL,UAAU;QACV,QAAQ;QACR,UAAU,EAAE,SAAS,EAAE,UAAU,IAAI,IAAI,CAAC,UAAU;KACrD,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,sBAAsB,CAAC,OAA2B;IAChE,OAAO,0BAA0B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,QAAQ,IAAI,oBAAoB,CAAC,OAAO,CAAC;AACjG,CAAC"}

package/lib/config/types.d.ts

@@ -1,6 +1,4 @@
-import type { ProviderConfig } from '@zhin.js/ai';
-import type { SdkId } from '@zhin.js/ai';
-import type { OllamaProviderConfig } from '@zhin.js/ai';
+import type { ProviderConfig, SdkId, OllamaProviderConfig } from '@zhin.js/ai';
 export type { SdkId };
 export interface ProviderInstanceConfig extends ProviderConfig, OllamaProviderConfig {
     /** AI SDK provider id (ADR 0018 closed table) */
@@ -11,23 +9,29 @@ export interface ProviderInstanceConfig extends ProviderConfig, OllamaProviderCo
 export interface RouteMatchConfig {
     adapter?: string;
     endpoint?: string;
+    /** IM scene kind: private | group | channel */
     scene?: string;
+    /** 群/频道 scene id（与 message.$channel.id 比对） */
+    sceneId?: string;
     /** image | audio | video | text（纯文本无媒体 segment） */
     hasMedia?: string[];
     /** 子串匹配（不区分大小写） */
     contentContains?: string;
 }
+export type PermissionTaskAction = 'allow' | 'deny';
 export interface AgentBindingConfig {
     provider: string;
     model: string;
     mcpServers?: string[];
     priority?: number;
-    match?: RouteMatchConfig;
-}
-/** @deprecated 仅用于归一化旧版 ai.routes */
-export interface RouteEntryConfig {
-    priority: number;
-    match: RouteMatchConfig;
+    /** 单条或多条路由规则（ADR 0031 五 Bot 配置为数组） */
+    match?: RouteMatchConfig | RouteMatchConfig[];
+    /** Agent 昵称（LLM 自称 + IM 协作展示，ADR 0024 #11）。 */
+    nickname?: string;
+    /** spawn_task 可见子 agent 类型（glob → allow/deny，ADR 0030）。 */
+    permission?: {
+        task?: Record<string, PermissionTaskAction>;
+    };
 }
 /** 解析后的 agent 绑定（运行时） */
 export interface ResolvedAgentBinding {
@@ -35,6 +39,10 @@ export interface ResolvedAgentBinding {
     providerAlias: string;
     model: string;
     mcpServers: string[];
+    /** 展示昵称（缺省回退 role label / agent 名）。 */
+    nickname?: string;
+    /** spawn_task 子 agent 类型过滤（ADR 0030）。 */
+    permission?: AgentBindingConfig['permission'];
 }
 export declare const DEFAULT_ZHIN_AGENT_NAME = "zhin";
 //# sourceMappingURL=types.d.ts.map

package/lib/config/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,YAAY,EAAE,KAAK,EAAE,CAAC;AAEtB,MAAM,WAAW,sBAAuB,SAAQ,cAAc,EAAE,oBAAoB;IAClF,iDAAiD;IACjD,GAAG,EAAE,KAAK,CAAC;IACX,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,uBAAuB,SAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,KAAK,EAAE,CAAC;AAEtB,MAAM,WAAW,sBAAuB,SAAQ,cAAc,EAAE,oBAAoB;IAClF,iDAAiD;IACjD,GAAG,EAAE,KAAK,CAAC;IACX,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;KAC7C,CAAC;CACH;AAED,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,uBAAuB,SAAS,CAAC"}

package/lib/config/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AA6CA,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAoDA,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC"}

package/lib/config/validate-ai-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-ai-config.d.ts","sourceRoot":"","sources":["../../src/config/validate-ai-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,yBAAyB,GAAG,MAAM,EAAE,CAqDhF"}
+{"version":3,"file":"validate-ai-config.d.ts","sourceRoot":"","sources":["../../src/config/validate-ai-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,yBAAyB,GAAG,MAAM,EAAE,CA0DhF"}

package/lib/config/validate-ai-config.js

@@ -1,4 +1,5 @@
 import { isSdkId } from '@zhin.js/ai';
+import { normalizeMatchRules } from '../routing/route-matcher.js';
 import { DEFAULT_ZHIN_AGENT_NAME } from './types.js';
 export function validateAiRoutingConfig(cfg) {
     const errors = [];
@@ -30,7 +31,8 @@ export function validateAiRoutingConfig(cfg) {
             if (!srv?.trim())
                 errors.push(`ai.agents.${name}: empty mcpServers entry`);
         }
-        const hasMatch = binding.match != null && Object.keys(binding.match).length > 0;
+        const matchRules = normalizeMatchRules(binding.match);
+        const hasMatch = matchRules.length > 0;
         const hasPriority = binding.priority != null;
         if (name === DEFAULT_ZHIN_AGENT_NAME) {
             if (hasMatch || hasPriority) {
@@ -38,6 +40,9 @@ export function validateAiRoutingConfig(cfg) {
             }
             continue;
         }
+        if (binding.match != null && !hasMatch) {
+            errors.push(`ai.agents.${name}: match has no routable constraints (need adapter/endpoint/scene/sceneId/hasMedia/contentContains)`);
+        }
         if (hasMatch && typeof binding.priority !== 'number') {
             errors.push(`ai.agents.${name}: priority is required when match is set`);
         }

package/lib/config/validate-ai-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-ai-config.js","sourceRoot":"","sources":["../../src/config/validate-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGrD,MAAM,UAAU,uBAAuB,CAAC,GAA8B;IACpE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,mBAAmB,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CACT,gBAAgB,KAAK,kBAAkB,IAAI,CAAC,GAAG,yEAAyE,CACzH,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,KAAK,mBAAmB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YACzF,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,mDAAmD,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YACzE,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,mCAAmC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,aAAa,uBAAuB,cAAc,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,uBAAuB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,qBAAqB,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;gBAAE,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,0BAA0B,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAChF,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QAE7C,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;YACrC,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,aAAa,uBAAuB,0DAA0D,CAAC,CAAC;YAC9G,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,0CAA0C,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,WAAW,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,0CAA0C,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"validate-ai-config.js","sourceRoot":"","sources":["../../src/config/validate-ai-config.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,83 @@
+/**
+ * ZhinAgent 配置类型 SSOT — 供 host 契约与 zhin-agent 门面共用。
+ */
+import type { RateLimitConfig, QueueMode } from '@zhin.js/ai';
+import type { DeferredToolsConfig } from '../tool-catalog/types.js';
+import type { ModelHarnessConfig } from './model-harness.js';
+export type OnChunkCallback = (chunk: string, full: string) => void;
+export type ModelSizeHint = 'small' | 'medium' | 'large';
+export type ExecApprovalMode = 'ask' | 'allow' | 'deny';
+export type InboundGroupQueueMode = 'supersede' | 'fifo';
+export interface InboundQueueConfig {
+    groupMode?: InboundGroupQueueMode;
+    ttlMs?: number;
+    coalesceWindowMs?: number;
+}
+/** ADR 0010 — session compaction config. */
+export interface CompactionConfig {
+    enabled?: boolean;
+    auto?: boolean;
+    keepRecentTokens?: number;
+    minKeepCount?: number;
+}
+export interface ZhinAgentConfig {
+    persona?: string;
+    maxIterations?: number;
+    timeout?: number;
+    preExecTimeout?: number;
+    maxSkills?: number;
+    maxTools?: number;
+    minTopicRounds?: number;
+    slidingWindowSize?: number;
+    contextTailMessageLimit?: number;
+    topicChangeThreshold?: number;
+    rateLimit?: RateLimitConfig;
+    toneAwareness?: boolean;
+    chatModel?: string;
+    visionModel?: string;
+    contextTokens?: number;
+    maxHistoryShare?: number;
+    compaction?: CompactionConfig;
+    inboundQueue?: InboundQueueConfig;
+    disabledTools?: string[];
+    allowedTools?: string[];
+    execSecurity?: 'deny' | 'allowlist' | 'full';
+    execPreset?: 'readonly' | 'network' | 'development' | 'custom';
+    execAllowlist?: string[];
+    execApprovalMode?: ExecApprovalMode;
+    subagentExecApprovalMode?: ExecApprovalMode;
+    maxParallelSubagents?: number;
+    toolExecution?: 'parallel' | 'sequential' | 'tiered';
+    subagentAutoContinue?: boolean;
+    subagentDirectImDelivery?: boolean;
+    workerExecApprovalMode?: ExecApprovalMode;
+    taskExecApprovalMode?: ExecApprovalMode;
+    maxSubagentIterations?: number;
+    subagentTools?: string[];
+    subagentTurnWaitMs?: number;
+    modelSizeHint?: '' | 'small' | 'medium' | 'large';
+    skillInstructionMaxChars?: number;
+    modelHarness?: ModelHarnessConfig;
+    phaseTrace?: boolean;
+    promptTrace?: boolean;
+    promptTraceVerbose?: boolean;
+    promptCache?: boolean;
+    promptCacheRetention?: 'in_memory' | '24h';
+    promptCacheKeyPrefix?: string;
+    onPhaseTrace?: (event: {
+        phase: string;
+        sessionId: string;
+        extra: Record<string, unknown>;
+    }) => void;
+    deferredToolMaxResults?: number;
+    deferredTools?: DeferredToolsConfig;
+    workerBaseTools?: string[];
+    platformPromptSectionMaxChars?: number;
+    platformPromptMaxChars?: number;
+    steeringMode?: QueueMode;
+    followUpMode?: QueueMode;
+    policyDenialStopAfter?: number;
+    deferredAutoContinue?: boolean;
+    deferredAutoContinueMaxDepth?: number;
+}
+//# sourceMappingURL=zhin-agent-config.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zhin-agent-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent-config.js","sourceRoot":"","sources":["../../src/config/zhin-agent-config.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,11 @@
+export declare const SECTION_SEP = "\n\n---\n\n";
+export declare const HISTORY_CONTEXT_MARKER = "[Chat messages since your last reply - for context]";
+/** 与 @zhin.js/core `CURRENT_USER_MESSAGE_MARKER` 保持一致 */
+export declare const CURRENT_MESSAGE_MARKER = "[Current message - respond to this]";
+export { KEYWORD_TRIGGERS } from './keyword-triggers.js';
+/** 硬编排 v1 追加的总监工具 */
+export declare const HARD_ORCHESTRATION_TOOLS: readonly ["orchestration_start", "orchestration_add_task", "orchestration_status", "orchestration_complete", "orchestration_retry_task", "orchestration_skip_task"];
+export declare const DEFAULT_HARD_ORCHESTRATOR_TOOLS: readonly ["ask_user", "spawn_task", "discover", "load_tool", "load_skill", "orchestration_start", "orchestration_add_task", "orchestration_status", "orchestration_complete", "orchestration_retry_task", "orchestration_skip_task"];
+/** Deferred Worker 默认基础工具 */
+export declare const DEFAULT_WORKER_BASE_TOOLS: readonly ["bash", "read_file", "web_search"];
+//# sourceMappingURL=zhin-agent-constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent-constants.d.ts","sourceRoot":"","sources":["../../src/config/zhin-agent-constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,sBAAsB,wDAAwD,CAAC;AAC5F,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,wCAAwC,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,qBAAqB;AACrB,eAAO,MAAM,wBAAwB,qKAO3B,CAAC;AAEX,eAAO,MAAM,+BAA+B,sOAGlC,CAAC;AAEX,6BAA6B;AAC7B,eAAO,MAAM,yBAAyB,8CAI5B,CAAC"}

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

@@ -0,0 +1,26 @@
+import { DEFAULT_ALWAYS_LOADED_TOOLS, } from '../tool-catalog/types.js';
+export const SECTION_SEP = '\n\n---\n\n';
+export const HISTORY_CONTEXT_MARKER = '[Chat messages since your last reply - for context]';
+/** 与 @zhin.js/core `CURRENT_USER_MESSAGE_MARKER` 保持一致 */
+export const CURRENT_MESSAGE_MARKER = '[Current message - respond to this]';
+export { KEYWORD_TRIGGERS } from './keyword-triggers.js';
+/** 硬编排 v1 追加的总监工具 */
+export const HARD_ORCHESTRATION_TOOLS = [
+    'orchestration_start',
+    'orchestration_add_task',
+    'orchestration_status',
+    'orchestration_complete',
+    'orchestration_retry_task',
+    'orchestration_skip_task',
+];
+export const DEFAULT_HARD_ORCHESTRATOR_TOOLS = [
+    ...DEFAULT_ALWAYS_LOADED_TOOLS,
+    ...HARD_ORCHESTRATION_TOOLS,
+];
+/** Deferred Worker 默认基础工具 */
+export const DEFAULT_WORKER_BASE_TOOLS = [
+    'bash',
+    'read_file',
+    'web_search',
+];
+//# sourceMappingURL=zhin-agent-constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent-constants.js","sourceRoot":"","sources":["../../src/config/zhin-agent-constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,qDAAqD,CAAC;AAC5F,yDAAyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,qCAAqC,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,qBAAqB;AACrB,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,qBAAqB;IACrB,wBAAwB;IACxB,sBAAsB;IACtB,wBAAwB;IACxB,0BAA0B;IAC1B,yBAAyB;CACjB,CAAC;AAEX,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,GAAG,2BAA2B;IAC9B,GAAG,wBAAwB;CACnB,CAAC;AAEX,6BAA6B;AAC7B,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,MAAM;IACN,WAAW;IACX,YAAY;CACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ZhinAgentConfig } from './zhin-agent-config.js';
+export declare const DEFAULT_CONFIG: Required<ZhinAgentConfig>;
+//# sourceMappingURL=zhin-agent-defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent-defaults.d.ts","sourceRoot":"","sources":["../../src/config/zhin-agent-defaults.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,eAAO,MAAM,cAAc,EAyDX,QAAQ,CAAC,eAAe,CAAC,CAAC"}

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

@@ -0,0 +1,63 @@
+import { DEFAULT_CONTEXT_TOKENS, DEFAULT_FOLLOW_UP_MODE, DEFAULT_STEERING_MODE } from '@zhin.js/ai';
+import { DEFAULT_CONTEXT_TAIL_MESSAGE_LIMIT } from '../context/context-tail-limit.js';
+import { DEFAULT_DEFERRED_TOOLS_CONFIG, } from '../tool-catalog/types.js';
+import { DEFAULT_WORKER_BASE_TOOLS } from './zhin-agent-constants.js';
+export const DEFAULT_CONFIG = {
+    persona: 'You are Zhin, an intelligent IM assistant running in Zhin.js. Answer clearly, act through available tools when needed, and never claim actions or results unless confirmed by tool output.',
+    maxIterations: 15,
+    timeout: 120_000,
+    preExecTimeout: 15_000,
+    maxSkills: 5,
+    maxTools: 12,
+    minTopicRounds: 5,
+    slidingWindowSize: 5,
+    contextTailMessageLimit: DEFAULT_CONTEXT_TAIL_MESSAGE_LIMIT,
+    topicChangeThreshold: 0.15,
+    rateLimit: {},
+    toneAwareness: true,
+    chatModel: '',
+    visionModel: '',
+    contextTokens: DEFAULT_CONTEXT_TOKENS,
+    maxHistoryShare: 0.5,
+    compaction: {
+        enabled: true,
+        auto: true,
+        keepRecentTokens: 20_000,
+        minKeepCount: 2,
+    },
+    disabledTools: [],
+    allowedTools: [],
+    execSecurity: 'deny',
+    execPreset: 'custom',
+    execAllowlist: [],
+    execApprovalMode: 'deny',
+    subagentExecApprovalMode: 'deny',
+    maxParallelSubagents: 5,
+    toolExecution: 'tiered',
+    subagentAutoContinue: true,
+    subagentDirectImDelivery: false,
+    workerExecApprovalMode: 'deny',
+    taskExecApprovalMode: 'deny',
+    maxSubagentIterations: 25,
+    subagentTools: [],
+    subagentTurnWaitMs: 300_000,
+    modelSizeHint: '',
+    skillInstructionMaxChars: 0,
+    modelHarness: {},
+    phaseTrace: false,
+    onPhaseTrace: () => { },
+    promptTraceVerbose: false,
+    promptCacheRetention: 'in_memory',
+    promptCacheKeyPrefix: 'zhin',
+    deferredToolMaxResults: 8,
+    deferredTools: { ...DEFAULT_DEFERRED_TOOLS_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,
+};
+//# sourceMappingURL=zhin-agent-defaults.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent-defaults.js","sourceRoot":"","sources":["../../src/config/zhin-agent-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAEL,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,4LAA4L;IACrM,aAAa,EAAE,EAAE;IACjB,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE,MAAM;IACtB,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,CAAC;IACjB,iBAAiB,EAAE,CAAC;IACpB,uBAAuB,EAAE,kCAAkC;IAC3D,oBAAoB,EAAE,IAAI;IAC1B,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,sBAAsB;IACrC,eAAe,EAAE,GAAG;IACpB,UAAU,EAAE;QACV,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI;QACV,gBAAgB,EAAE,MAAM;QACxB,YAAY,EAAE,CAAC;KAChB;IACD,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;IAChB,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,MAAM;IACxB,wBAAwB,EAAE,MAAM;IAChC,oBAAoB,EAAE,CAAC;IACvB,aAAa,EAAE,QAAQ;IACvB,oBAAoB,EAAE,IAAI;IAC1B,wBAAwB,EAAE,KAAK;IAC/B,sBAAsB,EAAE,MAAM;IAC9B,oBAAoB,EAAE,MAAM;IAC5B,qBAAqB,EAAE,EAAE;IACzB,aAAa,EAAE,EAAE;IACjB,kBAAkB,EAAE,OAAO;IAC3B,aAAa,EAAE,EAAE;IACjB,wBAAwB,EAAE,CAAC;IAC3B,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;IACtB,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,WAAW;IACjC,oBAAoB,EAAE,MAAM;IAC5B,sBAAsB,EAAE,CAAC;IACzB,aAAa,EAAE,EAAE,GAAG,6BAA6B,EAAE;IACnD,eAAe,EAAE,CAAC,GAAG,yBAAyB,CAAC;IAC/C,6BAA6B,EAAE,IAAI;IACnC,sBAAsB,EAAE,IAAI;IAC5B,YAAY,EAAE,qBAAqB;IACnC,YAAY,EAAE,sBAAsB;IACpC,qBAAqB,EAAE,CAAC;IACxB,oBAAoB,EAAE,KAAK;IAC3B,4BAA4B,EAAE,CAAC;CACQ,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { AIProvider, AgentSessionStore, ContextRepository, IMSessionStore, ImTranscriptStore, MemoryAgentSessionStore, MemoryIMSessionStore, ModelRegistry } from '@zhin.js/ai';
+import type { Plugin } from '@zhin.js/core';
+import type { AgentCore } from '../core/agent-core.js';
+import type { ToolSystem } from '../tool/tool-system.js';
+import type { ContextSystem } from '../context/context-system.js';
+import type { MemorySystem } from '../memory/memory-system.js';
+import type { SessionSystem } from '../session/session-system.js';
+import type { EventSystem } from '../event/event-system.js';
+import type { AgentOrchestrator } from '../orchestrator/index.js';
+import type { SkillRegistry } from '../orchestrator/skill-registry.js';
+import type { SubagentResultSender } from '../subagent/index.js';
+import type { ResolvedAgentBinding } from './types.js';
+/** ZhinAgent 运行依赖（通过 configure() 注入） */
+export interface ZhinAgentDependencies {
+    skillRegistry: SkillRegistry;
+    orchestrator: AgentOrchestrator;
+    agentCore?: AgentCore;
+    toolSystem?: ToolSystem;
+    contextSystem?: ContextSystem;
+    memorySystem?: MemorySystem;
+    sessionSystem?: SessionSystem;
+    eventSystem?: EventSystem;
+    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;
+}
+//# sourceMappingURL=zhin-agent-dependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent-dependencies.d.ts","sourceRoot":"","sources":["../../src/config/zhin-agent-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wCAAwC;AACxC,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,EAAE,cAAc,GAAG,oBAAoB,CAAC;IACtD,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC;IAChD,aAAa,EAAE,oBAAoB,CAAC;IACpC,cAAc,EAAE,oBAAoB,CAAC;IACrC,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zhin-agent-dependencies.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent-dependencies.js","sourceRoot":"","sources":["../../src/config/zhin-agent-dependencies.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,21 @@
+import type { ZhinAgentConfig, ModelSizeHint } from './zhin-agent-config.js';
+export declare function inferModelSize(modelName: string): ModelSizeHint;
+export declare function resolveModelSize(config: Required<ZhinAgentConfig>, modelName: string): ModelSizeHint;
+export declare function resolveSkillInstructionMaxChars(config: Required<ZhinAgentConfig>, modelName: string): number;
+export declare function isPhaseTraceEnabled(config: Required<ZhinAgentConfig>, env?: NodeJS.ProcessEnv): boolean;
+export declare function isPromptTraceEnabled(config: Required<ZhinAgentConfig>, env?: NodeJS.ProcessEnv): boolean;
+export declare function isPromptTraceVerbose(config: Required<ZhinAgentConfig>, env?: NodeJS.ProcessEnv): boolean;
+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';
+};
+export declare function resolveDeferredTaskToolTimeout(config: Pick<Required<ZhinAgentConfig>, 'timeout' | 'subagentTurnWaitMs' | 'maxSubagentIterations'>): number;
+export declare function resolveWorkerSlowToolTimeout(config: Pick<Required<ZhinAgentConfig>, 'timeout' | 'maxSubagentIterations'>): number;
+//# sourceMappingURL=zhin-agent-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent-runtime.d.ts","sourceRoot":"","sources":["../../src/config/zhin-agent-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM7E,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAI/D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAGpG;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ5G;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAIpH;AAOD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAOrH;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAGrH;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,EAC5C,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAST;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,sBAAsB,GAAG,sBAAsB,CAAC,EAC9F,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,EACD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IACD,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;CAC5C,CAaA;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,GAAG,oBAAoB,GAAG,uBAAuB,CAAC,GAClG,MAAM,CAMR;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,GAAG,uBAAuB,CAAC,GAC3E,MAAM,CAGR"}

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

@@ -0,0 +1,91 @@
+import { 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;
+const TRUE_VALUES = new Set(['1', 'true', 'yes', 'on']);
+export function inferModelSize(modelName) {
+    if (SMALL_MODEL_RE.test(modelName))
+        return 'small';
+    if (MEDIUM_MODEL_RE.test(modelName))
+        return 'medium';
+    return 'large';
+}
+export function resolveModelSize(config, modelName) {
+    if (config.modelSizeHint && config.modelSizeHint !== '')
+        return config.modelSizeHint;
+    return inferModelSize(modelName);
+}
+export function resolveSkillInstructionMaxChars(config, modelName) {
+    if (config.skillInstructionMaxChars && config.skillInstructionMaxChars > 0)
+        return config.skillInstructionMaxChars;
+    const size = resolveModelSize(config, modelName);
+    switch (size) {
+        case 'small': return 1500;
+        case 'medium': return 4000;
+        case 'large': return 8000;
+    }
+}
+export function isPhaseTraceEnabled(config, env = process.env) {
+    if (config.phaseTrace)
+        return true;
+    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);
+}
+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');
+}
+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',
+    };
+}
+export function resolveDeferredTaskToolTimeout(config) {
+    const turnMs = config.timeout ?? 60_000;
+    const waitMs = config.subagentTurnWaitMs ?? 180_000;
+    const maxIter = config.maxSubagentIterations ?? 15;
+    const iterationBudget = turnMs * Math.min(maxIter, 10);
+    return Math.max(waitMs, iterationBudget, 180_000);
+}
+export function resolveWorkerSlowToolTimeout(config) {
+    const turnMs = config.timeout ?? 60_000;
+    return Math.min(180_000, Math.max(60_000, turnMs * 2));
+}
+//# sourceMappingURL=zhin-agent-runtime.js.map

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

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

package/lib/context/agents-instruction.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AGENTS.md 合并链：子目录（近）→ workspace root（远），注入 Turn envelope。
+ */
+export declare function clearAgentsInstructionCache(): void;
+export interface AgentsInstructionEntry {
+    path: string;
+    content: string;
+}
+export declare function collectAgentsInstructionChain(workspaceDir?: string): Promise<AgentsInstructionEntry[]>;
+export declare function buildAgentsEnvelopeContext(workspaceDir?: string): Promise<string | null>;
+//# sourceMappingURL=agents-instruction.d.ts.map

package/lib/context/agents-instruction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-instruction.d.ts","sourceRoot":"","sources":["../../src/context/agents-instruction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAiBD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,6BAA6B,CACjD,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA2CnC;AAED,wBAAsB,0BAA0B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS9F"}