@zhin.js/agent 1.1.31 → 1.1.33

package/README.md

@@ -125,7 +125,7 @@ Prompt Section 投影。身份由 owner 与本地名共同决定，重复身份
 
 ## 模块化架构（理想蓝图 8 模块）
 
-`src/` 按职责拆分为 8 个理想模块 + Workroom Kernel（单包，可选 subpath export）：
+`src/` 按职责拆分为 8 个理想模块：
 
 ```
 packages/im/agent/src/
@@ -141,26 +141,13 @@ packages/im/agent/src/
   turn/          Turn pipeline、inbound 队列、auto-continue、metrics
   config/        ZhinAgent 配置 SSOT、model harness
   resource-hub/  Skill / SubAgent / MCP / Hook support resources
-  workroom/      Workroom Kernel — versioned Journal + pure replay/decision
   zhin-agent/    ZhinAgent 门面类（单文件 index.ts）
   init/          Plugin Runtime 组合、数据库激活与 ZhinAgent dispose 生命周期
 ```
 
-Workroom Journal 以 `workroom/journal/index.ts` 作为唯一领域入口。入口只公开 Journal
-端口、错误、适配器和稳定的摘要函数；内部依赖保持单向：事件校验与受治理载荷引用位于
-底层，存储事件编解码和控制投影建立在其上，载荷发布/回放复用控制投影，Memory、File、
-Database 适配器只组合这些机制。新增存储实现应实现 `WorkroomJournal`，不应把数据库、
-文件系统或载荷治理逻辑重新放进领域入口。
+普通 `spawn_task` 只执行当前聊天的非 Workroom 子任务，不创建或修改 Run/Task facts。Workroom 的持久编排（Run/Task/Assignment、验收、Journal、Projection Outbox）由 [`@zhin.js/workroom`](../workroom/README.md) 承载。
 
-Workroom Projection Outbox 同样以 `workroom/projection-outbox/index.ts` 为唯一领域入口。
-Binding 和持久 Item 必须显式携带 `audience` 与绑定代际 `cursorId`；运行时不会猜测旧
-快照的默认 audience，也不会把旧 Run cursor 在线迁移到新绑定。Repository 只负责 CAS
-状态，Tracer 只把权威事实投影为草稿，Governance 物化可披露内容，Delivery Worker
-负责租约和外部投递，四者通过窄端口协作。
-
-普通 `spawn_task` 只执行当前聊天的非 Workroom 子任务，不创建或修改 Run/Task facts。Workroom command adapter 必须持有认证后的 Project capability；标准 Host 已装配 generation-owned Scheduler、Executor、Reviewer authority/view 与 Sponsor typed control，但不会发布模型可写的通用 transition 工具。验收不再是 `WorkroomCommand`：Task 必须先由 generation-owned `workroomAcceptancePolicyDecisionToken` 固定 immutable Contract/Policy snapshot，未 pin 不得 claim；`WorkroomKernel.evaluateTaskAcceptance()` 随后只调用同一可信端口，并用 Journal CAS 写入结构化 Acceptance Record。生产 baseline 只允许 low-risk、全机械检查且证据与 claims 完整的候选自动通过；medium/judgment 与 high/critical 路由分别持久化 Reviewer Assignment / Sponsor Gate，固定 candidate hash、Contract/Policy、owner、deadline 与恢复动作。Reviewer verdict 只能由独立 claimed Reviewer Assignment 的认证提交产生；Sponsor decision 只能经 Catalog/Profile 绑定的认证 typed control 进入，普通 discussion 不能改变状态。缺少受治理 Acceptance Projection source、可信 Risk Header、typed Check、Artifact/Effect facts 或 Context provider 时会形成可恢复的持久 blocker，而不是降级验收。
-
-`AgentResourceHub` 是 generation-owned 的 Agent 支持资源入口，管理 Skill、SubAgent、MCP 与 Hook，不拥有 Tool 或 Workroom Run/Task/Assignment 状态。Tool 只通过 `tools/<name>/index.ts` 或 `context.addTool()` 进入候选 generation，由唯一 `ToolIndex` 发布；持久编排只能通过 Workroom Kernel 与专用 typed ports。
+`AgentResourceHub` 是 generation-owned 的 Agent 支持资源入口，管理 Skill、SubAgent、MCP 与 Hook，不拥有 Tool 状态。Tool 只通过 `tools/<name>/index.ts` 或 `context.addTool()` 进入候选 generation，由唯一 `ToolIndex` 发布；持久编排位于 [`@zhin.js/workroom`](../workroom/README.md)。
 
 Agent 生命周期事件由本包的 `AIEventPayload` / `AIEventName` 定义。Runtime 消费方通过
 `subscribeAIEventsOnTarget` 订阅显式 event target；事件契约不再挂在经典 `Plugin` namespace，
@@ -177,8 +164,6 @@ permission、approval、generation lease 或 Journal。普通 npm 插件继续
 Feature；Capability Seam 属于 Advanced Root Host 扩展口，详见
 [能力接缝](../../docs/concepts/capability-seams.md)。
 
-升级前的 legacy Run export 可用 `zhin agent legacy-runs <input>` 离线审计，遗留内嵌 payload 可用 `zhin agent legacy-payloads <input> --kind <kind>` 离线扫描。两条命令都只读输入并 create-only 输出 audit/proposal，不会自动写入新 Journal、接受旧结果、删除正文或执行迁移。
-
 **Agent Core**：`AgentCore.runText()` / `runVision()` 为 `AsyncGenerator<TurnEvent>` SSOT；`runTextTurn` 为 collector。组合层经 `composeZhinAgentRuntime` 注入 8 模块 + `createAgentCoreDepsForCompose`。
 
 可选 subpath（`package.json` `exports`）：
@@ -280,7 +265,7 @@ declare module '@zhin.js/core' {
 | Context | 用途 |
 |---------|------|
 | `ctx.ai` | 业务侧 AI 服务：会话、`createAgent`（→ `ServiceAgent`）/ `runAgent`、全局 ZhinAgent |
-| `ctx.agent` | `AgentResourceHub` 支持资源注册：`addSkill(...)`、`addSubAgent(...)`、`addMcp(...)`、`addHook(...)`；Tool 使用 `context.addTool()`，不承担 Workroom 状态编排 |
+| `ctx.agent` | `AgentResourceHub` 支持资源注册：`addSkill(...)`、`addSubAgent(...)`、`addMcp(...)`、`addHook(...)`；Tool 使用 `context.addTool()` |
 
 主包 `zhin.js` 的 `Plugin.Contexts` 类型已包含上述两项。
 
@@ -352,14 +337,17 @@ useContext('ai', async (ai) => {
     provider: 'ollama',
     model: 'qwen2.5',
     systemPrompt: '只做中英互译，不解释。',
-    includeRegisteredTools: false,
   })
   const translated = await translateAgent.run('Hello world')
 })
 ```
 
-Standalone Agent 不隐式继承主 Agent 的 native Tool。能力必须通过 `tools` 显式传入，或先用
-`ai.registerTool()` 注册；`includeRegisteredTools: false` 可为单次 Agent 建立空白能力边界。
+Standalone Agent 不隐式继承主 Agent 的 native Tool，也**默认不带** `ai.registerTool()` 注册的工具：
+能力必须通过 `tools` 显式传入，或传 `includeRegisteredTools: true` 使用已注册的工具。
+
+只需要文本（总结群聊、分类消息、改写回复）时，不要借整轮 Agent，改用 `aiCompletionToken`：
+它只做一次补全，不带任何工具，自带重试和降级，不可信内容放进 `untrusted` 按数据渲染。见
+[Host Token 总览](../../../docs/authoring/host-tokens.md)。
 适合：按场景/按接口使用不同「角色」的 Agent（代码、翻译、总结等），彼此独立。
 
 ### 3. 一次调用、单次任务（不持有 Agent 实例）
@@ -378,7 +366,7 @@ useContext('ai', async (ai) => {
 
 ### 4. 多 Agent 协作与普通 chat 委派
 
-普通 chat 可用 `spawn_task` 临时委派子代理；它没有 durable Run/Task、验收或 Project Memory 语义。Project 级多 Agent 协作由 Workroom Kernel 的 versioned Plan、Assignment、Acceptance 与投影承载。旧 `zhin.js/agent` `runPipeline` / `runParallel` / `route` 会立即调用模型且没有可靠状态边界，已在 breaking cutover 中删除；后续构图便利 API 只会生成 Plan proposal，不直接执行 Agent。
+普通 chat 可用 `spawn_task` 临时委派子代理；它没有 durable Run/Task、验收或 Project Memory 语义。Project 级多 Agent 协作由 [`@zhin.js/workroom`](../workroom/README.md) 承载。旧 `zhin.js/agent` `runPipeline` / `runParallel` / `route` 会立即调用模型且没有可靠状态边界，已在 breaking cutover 中删除；后续构图便利 API 只会生成 Plan proposal，不直接执行 Agent。
 
 ## 工具命名策略
 

package/lib/config/deprecated-agent-binding-keys.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `ai.agents.<name>.priority` / `ai.agents.<name>.match` — inbound routing
+ * fields that never took effect.
+ *
+ * IM inbound always resolves the `zhin` binding; the matcher that read these
+ * fields had no production caller. They stay accepted for compatibility:
+ * startup logs a warning, `zhin config check` reports them, and
+ * `zhin config check --fix` deletes them. Other agents are still reached by
+ * binding name (spawn_task, collaboration roles, assistant runtime).
+ */
+export declare const DEPRECATED_AGENT_BINDING_KEYS: Readonly<Record<string, string>>;
+export interface DeprecatedAgentBindingKey {
+    readonly agent: string;
+    readonly key: string;
+    readonly reason: string;
+}
+/** Deprecated routing keys present under `ai.agents`, in agent then declaration order. */
+export declare function findDeprecatedAgentBindingKeys(agents: unknown): DeprecatedAgentBindingKey[];
+/** Copy of `binding` without the deprecated routing keys. */
+export declare function stripDeprecatedAgentBindingKeys<T extends object>(binding: T): T;
+//# sourceMappingURL=deprecated-agent-binding-keys.d.ts.map

package/lib/config/deprecated-agent-binding-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-agent-binding-keys.d.ts","sourceRoot":"","sources":["../../src/config/deprecated-agent-binding-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGzE,CAAC;AAEH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,0FAA0F;AAC1F,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,yBAAyB,EAAE,CAU3F;AAED,6DAA6D;AAC7D,wBAAgB,+BAA+B,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAI/E"}

package/lib/config/deprecated-agent-binding-keys.js

@@ -0,0 +1,37 @@
+/**
+ * `ai.agents.<name>.priority` / `ai.agents.<name>.match` — inbound routing
+ * fields that never took effect.
+ *
+ * IM inbound always resolves the `zhin` binding; the matcher that read these
+ * fields had no production caller. They stay accepted for compatibility:
+ * startup logs a warning, `zhin config check` reports them, and
+ * `zhin config check --fix` deletes them. Other agents are still reached by
+ * binding name (spawn_task, collaboration roles, assistant runtime).
+ */
+export const DEPRECATED_AGENT_BINDING_KEYS = Object.freeze({
+    priority: '入站路由从未生效：IM 消息总是交给 ai.agents.zhin，其他 Agent 只按名字调用（spawn_task / 协作角色）。',
+    match: '入站路由从未生效（包括 hasMedia 等全部条件）：IM 消息总是交给 ai.agents.zhin。图片等媒体请用 ai.multimodal.perception。',
+});
+/** Deprecated routing keys present under `ai.agents`, in agent then declaration order. */
+export function findDeprecatedAgentBindingKeys(agents) {
+    if (!agents || typeof agents !== 'object' || Array.isArray(agents))
+        return [];
+    const found = [];
+    for (const [agent, binding] of Object.entries(agents)) {
+        if (!binding || typeof binding !== 'object' || Array.isArray(binding))
+            continue;
+        for (const [key, reason] of Object.entries(DEPRECATED_AGENT_BINDING_KEYS)) {
+            if (key in binding)
+                found.push({ agent, key, reason });
+        }
+    }
+    return found;
+}
+/** Copy of `binding` without the deprecated routing keys. */
+export function stripDeprecatedAgentBindingKeys(binding) {
+    const rest = { ...binding };
+    for (const key of Object.keys(DEPRECATED_AGENT_BINDING_KEYS))
+        delete rest[key];
+    return rest;
+}
+//# sourceMappingURL=deprecated-agent-binding-keys.js.map

package/lib/config/deprecated-agent-binding-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-agent-binding-keys.js","sourceRoot":"","sources":["../../src/config/deprecated-agent-binding-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC3F,QAAQ,EAAE,uEAAuE;IACjF,KAAK,EAAE,wFAAwF;CAChG,CAAC,CAAC;AAQH,0FAA0F;AAC1F,MAAM,UAAU,8BAA8B,CAAC,MAAe;IAC5D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9E,MAAM,KAAK,GAAgC,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QAChF,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,6BAA6B,CAAC,EAAE,CAAC;YAC1E,IAAI,GAAG,IAAK,OAAmC;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,+BAA+B,CAAmB,OAAU;IAC1E,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAA6B,CAAC;IACvD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/E,OAAO,IAAS,CAAC;AACnB,CAAC"}

package/lib/config/deprecated-agent-keys.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `ai.agent.*` switches retired by the config convergence review (#735).
+ *
+ * Each one is read by nothing at runtime, so removing it changes no
+ * behaviour. They stay accepted for compatibility: startup logs a warning,
+ * `zhin config check` reports them, and `zhin config check --fix` deletes
+ * them. See docs/ai/default-behavior.md for the full switch inventory.
+ */
+export declare const DEPRECATED_AGENT_CONFIG_KEYS: Readonly<Record<string, string>>;
+export interface DeprecatedAgentConfigKey {
+    readonly key: string;
+    readonly reason: string;
+}
+/** Deprecated keys present in an `ai.agent` section, in declaration order. */
+export declare function findDeprecatedAgentConfigKeys(agent: unknown): DeprecatedAgentConfigKey[];
+//# sourceMappingURL=deprecated-agent-keys.d.ts.map

package/lib/config/deprecated-agent-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-agent-keys.d.ts","sourceRoot":"","sources":["../../src/config/deprecated-agent-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxE,CAAC;AAEH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8EAA8E;AAC9E,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,EAAE,CAKxF"}

package/lib/config/deprecated-agent-keys.js

@@ -0,0 +1,23 @@
+/**
+ * `ai.agent.*` switches retired by the config convergence review (#735).
+ *
+ * Each one is read by nothing at runtime, so removing it changes no
+ * behaviour. They stay accepted for compatibility: startup logs a warning,
+ * `zhin config check` reports them, and `zhin config check --fix` deletes
+ * them. See docs/ai/default-behavior.md for the full switch inventory.
+ */
+export const DEPRECATED_AGENT_CONFIG_KEYS = Object.freeze({
+    maxSkills: '已无效果：技能目录按渐进披露常驻名称和触发说明，不再按数量截断。',
+    policyDenialStopAfter: '已无效果：被拒绝的调用由工具预算（toolBudget.failureStreakLimit / repeatLimit）处理。',
+    deferredToolMaxResults: '已无效果：使用 deferredTools.discoverTopK。',
+    taskExecApprovalMode: '已无效果：任务命令按 execApprovalMode / workerExecApprovalMode 审批。',
+});
+/** Deprecated keys present in an `ai.agent` section, in declaration order. */
+export function findDeprecatedAgentConfigKeys(agent) {
+    if (!agent || typeof agent !== 'object' || Array.isArray(agent))
+        return [];
+    return Object.entries(DEPRECATED_AGENT_CONFIG_KEYS)
+        .filter(([key]) => key in agent)
+        .map(([key, reason]) => ({ key, reason }));
+}
+//# sourceMappingURL=deprecated-agent-keys.js.map

package/lib/config/deprecated-agent-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-agent-keys.js","sourceRoot":"","sources":["../../src/config/deprecated-agent-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC1F,SAAS,EAAE,kCAAkC;IAC7C,qBAAqB,EAAE,kEAAkE;IACzF,sBAAsB,EAAE,qCAAqC;IAC7D,oBAAoB,EAAE,0DAA0D;CACjF,CAAC,CAAC;AAOH,8EAA8E;AAC9E,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3E,OAAO,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC;SAChD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,IAAK,KAAiC,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"fix-ai-config.d.ts","sourceRoot":"","sources":["../../src/config/fix-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAuE5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD;IAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CA0G9D"}
+{"version":3,"file":"fix-ai-config.d.ts","sourceRoot":"","sources":["../../src/config/fix-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAyD5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD;IAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAgH9D"}

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

@@ -1,5 +1,7 @@
 import { DEFAULT_ZHIN_AGENT_NAME } from './types.js';
 import { normalizeAiRoutingConfig } from './normalize-ai-config.js';
+import { findDeprecatedAgentConfigKeys } from './deprecated-agent-keys.js';
+import { findDeprecatedAgentBindingKeys, stripDeprecatedAgentBindingKeys } from './deprecated-agent-binding-keys.js';
 /**
  * 旧 driver 名 → sdk 的迁移映射（一次性升级专用；运行时 normalize 不再识别
  * driver，直接硬报错）。
@@ -46,18 +48,6 @@ function migrateLegacyProviderDrivers(providers) {
     }
     return { providers: out, migrated };
 }
-function mergeLegacyRoutesIntoAgents(agents, routes) {
-    for (const [name, route] of Object.entries(routes)) {
-        const existing = agents[name];
-        if (!existing)
-            continue;
-        agents[name] = {
-            ...existing,
-            priority: existing.priority ?? route.priority,
-            match: existing.match ?? route.match,
-        };
-    }
-}
 /**
  * 将旧版 ai 段归一化为当前 schema，并返回已应用的修复说明。
  * 仅用于 `zhin setup` 一次性升级；运行时 `normalizeAiRoutingConfig` 拒绝未迁移字段。
@@ -82,8 +72,16 @@ export function applyAiConfigFixes(ai) {
         ...(src.agents ?? {}),
     };
     if (hadRoutes) {
-        mergeLegacyRoutesIntoAgents(agents, legacy.routes);
-        fixes.push('merged ai.routes into ai.agents and removed ai.routes');
+        // Routes became priority/match, which never took effect either: drop them.
+        fixes.push('removed ai.routes (inbound routing never took effect)');
+    }
+    for (const { agent, key } of findDeprecatedAgentBindingKeys(agents)) {
+        fixes.push(`removed deprecated ai.agents.${agent}.${key}`);
+    }
+    for (const [name, binding] of Object.entries(agents)) {
+        if (binding && typeof binding === 'object' && !Array.isArray(binding)) {
+            agents[name] = stripDeprecatedAgentBindingKeys(binding);
+        }
     }
     // Synthesize the canonical zhin binding from legacy provider fields.
     if (hadDefaultProvider || hadLegacyAgent) {
@@ -114,6 +112,10 @@ export function applyAiConfigFixes(ai) {
         const agentSection = { ...preNormalized.agent };
         delete agentSection.chatModel;
         delete agentSection.visionModel;
+        for (const { key } of findDeprecatedAgentConfigKeys(agentSection)) {
+            delete agentSection[key];
+            fixes.push(`removed deprecated ai.agent.${key}`);
+        }
         if (Object.keys(agentSection).length > 0) {
             preNormalized.agent = agentSection;
         }
@@ -123,12 +125,6 @@ export function applyAiConfigFixes(ai) {
     }
     const normalized = normalizeAiRoutingConfig(preNormalized);
     const nextAgents = { ...normalized.agents };
-    const zhin = nextAgents[DEFAULT_ZHIN_AGENT_NAME];
-    if (zhin && (zhin.priority != null || zhin.match)) {
-        const { priority: _p, match: _m, ...rest } = zhin;
-        nextAgents[DEFAULT_ZHIN_AGENT_NAME] = rest;
-        fixes.push(`removed ai.agents.${DEFAULT_ZHIN_AGENT_NAME}.priority/match`);
-    }
     const next = {
         ...preNormalized,
         providers: normalized.providers,

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

@@ -1 +1 @@
-{"version":3,"file":"fix-ai-config.js","sourceRoot":"","sources":["../../src/config/fix-ai-config.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE;;;GAGG;AACH,MAAM,oBAAoB,GAA2B;IACnD,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,mBAAmB;IAC7B,KAAK,EAAE,mBAAmB;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,mBAAmB;CAChC,CAAC;AAEF,kEAAkE;AAClE,SAAS,4BAA4B,CACnC,SAAkB;IAElB,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5E,OAAO,EAAE,SAAS,EAAE,SAAoC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAoC,CAAC,EAAE,CAAC;QAClF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,EAAE,GAAI,KAAiC,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,MAAM,CAAC;YACrB,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBACzD,MAAM,CAAC,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;YACtD,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IACL,CAAC,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;eACnD,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EACnD,CAAC;YACD,wDAAwD;YACxD,MAAM,CAAC,GAAG,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9D,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,2BAA2B,CAClC,MAA0C,EAC1C,MAAwC;IAExC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,GAAG,QAAQ;YACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ;YAC7C,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK;SACrC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAkD;IAElD,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,EAAE,EAAE,EAAyC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,EAAwC,CAAC;IAC5D,MAAM,MAAM,GAAG,GAId,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3E,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC;IACpD,MAAM,cAAc,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAChF,8DAA8D;IAC9D,MAAM,eAAe,GAAG,4BAA4B,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpE,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;QAC7B,GAAG,CAAC,SAAS,GAAG,eAAe,CAAC,SAAkC,CAAC;IACrE,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAEhC,MAAM,MAAM,GAAG;QACb,GAAG,CAAE,GAAkE,CAAC,MAAM,IAAI,EAAE,CAAC;KAChD,CAAC;IAExC,IAAI,SAAS,EAAE,CAAC;QACd,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAO,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IACtE,CAAC;IACD,qEAAqE;IACrE,IAAI,kBAAkB,IAAI,cAAc,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe;eACvC,MAAM,CAAC,uBAAuB,CAAC,EAAE,QAAQ;eACzC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,CAAmC,CAAC,CAAC,CAAC,CAAC;eACnE,QAAQ,CAAC;QACd,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;eAC3F,MAAM,CAAC,uBAAuB,CAAC,EAAE,KAAK;eACtC,EAAE,CAAC;QACR,MAAM,CAAC,uBAAuB,CAAC,GAAG;YAChC,GAAG,MAAM,CAAC,uBAAuB,CAAC;YAClC,QAAQ,EAAE,MAAM,CAAC,uBAAuB,CAAC,EAAE,QAAQ,IAAI,aAAa;YACpE,KAAK,EAAE,MAAM,CAAC,uBAAuB,CAAC,EAAE,KAAK,IAAI,KAAK;SACvD,CAAC;QACF,IAAI,kBAAkB;YAAE,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QACtF,IAAI,cAAc;YAAE,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,aAAa,GAAG;QACpB,GAAG,GAAG;QACN,MAAM;KACK,CAAC;IACd,OAAQ,aAAyC,CAAC,MAAM,CAAC;IACzD,OAAQ,aAAyC,CAAC,eAAe,CAAC;IAClE,IAAI,aAAa,CAAC,KAAK,IAAI,OAAO,aAAa,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,YAAY,GAAG,EAAE,GAAI,aAAa,CAAC,KAAiC,EAAE,CAAC;QAC7E,OAAO,YAAY,CAAC,SAAS,CAAC;QAC9B,OAAO,YAAY,CAAC,WAAW,CAAC;QAChC,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,aAAa,CAAC,KAAK,GAAG,YAAiC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,aAAa,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,wBAAwB,CAAC,aAAa,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACjD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAClD,UAAU,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,qBAAqB,uBAAuB,iBAAiB,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,IAAI,GAA4B;QACpC,GAAG,aAAa;QAChB,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,MAAM,EAAE,UAAU;KACnB,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,eAAe,EAAE,YAAY,CAAU,EAAE,CAAC;QAC3E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,eAAe,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAElF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,MAAM,GAAG,GAAG,EAAE,GAAI,OAAmC,EAAE,CAAC;QACxD,IAAI,GAAG,CAAC,wBAAwB,IAAI,IAAI,IAAI,GAAG,CAAC,gBAAgB,IAAI,IAAI,EAAE,CAAC;YACzE,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,wBAAwB,CAAC;YACpD,OAAO,GAAG,CAAC,wBAAwB,CAAC;YACpC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"fix-ai-config.js","sourceRoot":"","sources":["../../src/config/fix-ai-config.ts"],"names":[],"mappings":"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"}

package/lib/config/index.d.ts

@@ -1,7 +1,10 @@
 export { normalizeAiRoutingConfig, normalizeProviderEntry, type NormalizedAiRoutingConfig, } from './normalize-ai-config.js';
 export { validateAiRoutingConfig } from './validate-ai-config.js';
-export { validateWorkroomDefinitions } from '../workroom/validate-catalog.js';
+export { resolvePerceptionConfig } from './perception-config.js';
+export type { PerceptionConfigInput, PerceptionMediaKind, ResolvedPerceptionConfig } from './perception-config.js';
 export { applyAiConfigFixes } from './fix-ai-config.js';
+export { DEPRECATED_AGENT_CONFIG_KEYS, findDeprecatedAgentConfigKeys, type DeprecatedAgentConfigKey, } from './deprecated-agent-keys.js';
+export { DEPRECATED_AGENT_BINDING_KEYS, findDeprecatedAgentBindingKeys, type DeprecatedAgentBindingKey, } from './deprecated-agent-binding-keys.js';
 export { AgentBindingRegistry } from './agent-binding-registry.js';
 export { DEFAULT_ZHIN_AGENT_NAME } from './types.js';
 export type { AgentBindingConfig, ResolvedAgentBinding, } from './types.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,+BAA+B,EAC/B,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kCAAkC,EAClC,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACnH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,KAAK,yBAAyB,GAC/B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,+BAA+B,EAC/B,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kCAAkC,EAClC,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC"}

package/lib/config/index.js

@@ -1,7 +1,9 @@
 export { normalizeAiRoutingConfig, normalizeProviderEntry, } from './normalize-ai-config.js';
 export { validateAiRoutingConfig } from './validate-ai-config.js';
-export { validateWorkroomDefinitions } from '../workroom/validate-catalog.js';
+export { resolvePerceptionConfig } from './perception-config.js';
 export { applyAiConfigFixes } from './fix-ai-config.js';
+export { DEPRECATED_AGENT_CONFIG_KEYS, findDeprecatedAgentConfigKeys, } from './deprecated-agent-keys.js';
+export { DEPRECATED_AGENT_BINDING_KEYS, findDeprecatedAgentBindingKeys, } from './deprecated-agent-binding-keys.js';
 export { AgentBindingRegistry } from './agent-binding-registry.js';
 export { DEFAULT_ZHIN_AGENT_NAME } from './types.js';
 export { resolveFiveAgentRoleBinding, resolvePlannerNickname, FIVE_AGENT_ROLE_LABELS, } from './resolve-five-agent-binding.js';

package/lib/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAKrD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,iCAAiC,CAAC;AAczC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAW1D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,+BAA+B,EAC/B,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kCAAkC,EAClC,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AASjC,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,GAE9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,GAE/B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAKrD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,iCAAiC,CAAC;AAczC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAW1D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,+BAA+B,EAC/B,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kCAAkC,EAClC,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AASjC,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC"}

package/lib/config/model-harness-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-harness-runtime.d.ts","sourceRoot":"","sources":["../../src/config/model-harness-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,sBAAsB,EAAE,eAAe,EAKnD,CAAC;AAYF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC,CAiB7E;AAiBD,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,oBAAoB,CA2BtB"}
+{"version":3,"file":"model-harness-runtime.d.ts","sourceRoot":"","sources":["../../src/config/model-harness-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,sBAAsB,EAAE,eAAe,EAwBnD,CAAC;AAYF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC,CAiB7E;AAwCD,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,oBAAoB,CA2BtB"}

package/lib/config/model-harness-runtime.js

@@ -3,6 +3,25 @@ export const MODEL_HARNESS_DEFAULTS = [
     { provider: 'ollama', modelPattern: /(?:qwen|llama|mistral).*(?:14b|32b)/i, maxIterations: 6 },
     { provider: 'openai', modelPattern: /gpt-4(\.|o|$)/i, maxIterations: 7 },
     { provider: 'anthropic', modelPattern: /claude-3|claude-4/i, maxIterations: 7 },
+    // MiniMax M-series (direct or routed as `minimax/minimax-m3`): strong tool use but
+    // prone to long read-only exploration before acting. Keep the configured
+    // iteration budget and steer it with guidance plus an earlier exploration nudge.
+    // It also occasionally ends a step with an empty reply; re-ask once before giving up.
+    {
+        modelPattern: /(?:^|\/)minimax-m\d/i,
+        explorationBudget: 5,
+        explorationGuidance: true,
+        emptyReplyRetries: 1,
+    },
+    // Gemini (direct `gemini-…` or routed as `google/gemini-…`): function calls
+    // occasionally end with finishReason MALFORMED_FUNCTION_CALL, and some turns
+    // end with STOP but no text. Both are transient (Gemini CLI re-asks on both),
+    // so re-ask once on the same model before showing the failure. Safety blocks
+    // are never re-asked (see provider-resilience.ts).
+    {
+        modelPattern: /(?:^|\/)gemini-/i,
+        emptyReplyRetries: 1,
+    },
 ];
 function isPlainObject(value) {
     const proto = value && typeof value === 'object'
@@ -38,11 +57,34 @@ function providerPatternToRegExp(pattern) {
     return new RegExp(`^${escaped}$`, 'i');
 }
 function sanitizeResolvedHarness(input) {
-    const maxIterationsRaw = input.maxIterations;
-    if (typeof maxIterationsRaw === 'number' && Number.isFinite(maxIterationsRaw)) {
-        return { maxIterations: maxIterationsRaw };
+    const resolved = {};
+    if (typeof input.maxIterations === 'number' && Number.isFinite(input.maxIterations)) {
+        resolved.maxIterations = input.maxIterations;
     }
-    return {};
+    if (typeof input.explorationBudget === 'number'
+        && Number.isFinite(input.explorationBudget)
+        && input.explorationBudget >= 0) {
+        resolved.explorationBudget = Math.floor(input.explorationBudget);
+    }
+    for (const key of ['iterationExtension', 'maxTotalIterations']) {
+        const value = input[key];
+        if (typeof value === 'number' && Number.isFinite(value) && value >= 0)
+            resolved[key] = Math.floor(value);
+    }
+    if (typeof input.explorationGuidance === 'boolean') {
+        resolved.explorationGuidance = input.explorationGuidance;
+    }
+    for (const key of ['emptyReplyRetries', 'requestTimeoutMs']) {
+        const value = input[key];
+        if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
+            resolved[key] = Math.floor(value);
+        }
+    }
+    return resolved;
+}
+function rowHarness(row) {
+    const { provider: _provider, modelPattern: _modelPattern, ...harness } = row;
+    return harness;
 }
 export function resolveModelHarness(providerName, modelName, config) {
     const defaultHarness = (() => {
@@ -51,7 +93,7 @@ export function resolveModelHarness(providerName, modelName, config) {
                 continue;
             if (!row.modelPattern.test(modelName))
                 continue;
-            return { maxIterations: row.maxIterations };
+            return rowHarness(row);
         }
         return {};
     })();

package/lib/config/model-harness-runtime.js.map

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

package/lib/config/model-harness.d.ts

@@ -1,5 +1,17 @@
 export interface ModelHarnessConfigItem {
     maxIterations?: number;
+    /** Consecutive read-only exploration calls before a harness note is injected; 0 disables. */
+    explorationBudget?: number;
+    /** Append exploration-discipline guidance (plan first, scope to target files) to the system prompt. */
+    explorationGuidance?: boolean;
+    /** Steps added per progress extension (overrides ai.agent.toolBudget.extendBy). */
+    iterationExtension?: number;
+    /** Hard step cap per Turn segment (overrides ai.agent.toolBudget.maxTotalIterations). */
+    maxTotalIterations?: number;
+    /** Provider quirk: extra attempts when the model returns an empty reply. */
+    emptyReplyRetries?: number;
+    /** Provider quirk: per-request timeout in ms; 0 disables. */
+    requestTimeoutMs?: number;
 }
 export interface ModelHarnessConfig {
     models?: Record<string, ModelHarnessConfigItem>;
@@ -9,8 +21,26 @@ export interface ModelHarnessRow {
     provider?: string;
     modelPattern: RegExp;
     maxIterations?: number;
+    explorationBudget?: number;
+    explorationGuidance?: boolean;
+    /** Steps added per progress extension (overrides ai.agent.toolBudget.extendBy). */
+    iterationExtension?: number;
+    /** Hard step cap per Turn segment (overrides ai.agent.toolBudget.maxTotalIterations). */
+    maxTotalIterations?: number;
+    /** Provider quirk: extra attempts when the model returns an empty reply. */
+    emptyReplyRetries?: number;
+    /** Provider quirk: per-request timeout in ms; 0 disables. */
+    requestTimeoutMs?: number;
 }
 export interface ResolvedModelHarness {
     maxIterations?: number;
+    explorationBudget?: number;
+    explorationGuidance?: boolean;
+    iterationExtension?: number;
+    maxTotalIterations?: number;
+    /** Provider quirk: extra attempts when the model returns an empty reply. */
+    emptyReplyRetries?: number;
+    /** Provider quirk: per-request timeout in ms; 0 disables. */
+    requestTimeoutMs?: number;
 }
 //# sourceMappingURL=model-harness.d.ts.map

package/lib/config/model-harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-harness.d.ts","sourceRoot":"","sources":["../../src/config/model-harness.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"model-harness.d.ts","sourceRoot":"","sources":["../../src/config/model-harness.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uGAAuG;IACvG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

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

@@ -1 +1 @@
-{"version":3,"file":"normalize-ai-config.d.ts","sourceRoot":"","sources":["../../src/config/normalize-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAsE,MAAM,aAAa,CAAC;AAEhH,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAQpB,6FAA6F;AAC7F,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,sBAAsB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9F,sBAAsB,CAuCxB;AAgCD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3C,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,GAAG,SAAS,GAAG,yBAAyB,CAqB5F"}
+{"version":3,"file":"normalize-ai-config.d.ts","sourceRoot":"","sources":["../../src/config/normalize-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAsE,MAAM,aAAa,CAAC;AAEhH,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AASpB,6FAA6F;AAC7F,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,sBAAsB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9F,sBAAsB,CAuCxB;AAgCD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3C,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,GAAG,SAAS,GAAG,yBAAyB,CA4B5F"}

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

@@ -1,5 +1,6 @@
 import { applyProviderGatewayPreset, isSdkId, validateProviderGatewayConfig } from '@zhin.js/ai';
 import { getLogger } from '@zhin.js/logger';
+import { stripDeprecatedAgentBindingKeys } from './deprecated-agent-binding-keys.js';
 const logger = getLogger('AIConfig');
 /** 统一的新写法提示（硬报错文案共用）。 */
 const PROVIDER_FORM_HINT = '命名 providers + 显式 sdk，例: providers: { my-openai: { sdk: openai, apiKey: sk-... } }';
@@ -43,7 +44,7 @@ function rejectRemovedAiConfigFields(ai) {
     if (!raw)
         return;
     if (raw.routes && typeof raw.routes === 'object' && Object.keys(raw.routes).length > 0) {
-        throw new Error('ai.routes removed; set ai.agents.<name>.priority and ai.agents.<name>.match');
+        throw new Error('ai.routes removed; inbound routing never took effect (IM messages always go to ai.agents.zhin) — delete it or run zhin config check --fix');
     }
     if (raw.pipeline && typeof raw.pipeline === 'object' && Object.keys(raw.pipeline).length > 0) {
         throw new Error('ai.pipeline removed; use ai.agents.<role>');
@@ -83,7 +84,14 @@ export function normalizeAiRoutingConfig(ai) {
             providers[alias] = normalizeProviderEntry(alias, cfg);
         }
     }
-    const agents = { ...(ai?.agents ?? {}) };
+    // priority / match never took effect; keep accepting them but drop them from the effective config.
+    const agents = {};
+    const rawAgents = ai?.agents ?? {};
+    for (const [name, binding] of Object.entries(rawAgents)) {
+        agents[name] = binding && typeof binding === 'object' && !Array.isArray(binding)
+            ? stripDeprecatedAgentBindingKeys(binding)
+            : binding;
+    }
     const mcpServerNames = (ai?.mcpServers ?? [])
         .map((server) => typeof server?.name === 'string' ? server.name.trim() : '')
         .filter(Boolean);

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

@@ -1 +1 @@
-{"version":3,"file":"normalize-ai-config.js","sourceRoot":"","sources":["../../src/config/normalize-ai-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"normalize-ai-config.js","sourceRoot":"","sources":["../../src/config/normalize-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,0BAA0B,EAAE,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAChH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C,OAAO,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AAErF,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAErC,yBAAyB;AACzB,MAAM,kBAAkB,GACtB,oFAAoF,CAAC;AAEvF,6FAA6F;AAC7F,MAAM,UAAU,sBAAsB,CACpC,KAAa,EACb,GAA+F;IAE/F,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,yEAAyE,CAC/F,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,yDAAyD,kBAAkB,EAAE,CACnG,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,EAA6B,CAAC;IACnD,OAAO,IAAI,CAAC,MAAM,CAAC;IACnB,OAAO,IAAI,CAAC,GAAG,CAAC;IAChB,OAAO,IAAI,CAAC,MAAM,CAAC;IACnB,OAAO,IAAI,CAAC,IAAI,CAAC;IACjB,MAAM,UAAU,GAAG,EAAE,GAAI,IAA0C,EAAE,CAAC;IACtE,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;QAAE,UAAU,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACxF,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ;QAAE,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3F,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ;QAAE,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAClF,kDAAkD;IAClD,MAAM,WAAW,GAAG,0BAA0B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,6FAA6F,kBAAkB,EAAE,CACvI,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,EAAE,MAAuC,EAAE,CAAC;IAChF,MAAM,QAAQ,GAAG,6BAA6B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,GAAG,EAAE,CAAC;QAC1E,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,2BAA2B,CAAC,EAAwB;IAC3D,MAAM,GAAG,GAAG,EAAyC,CAAC;IACtD,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,KAAK,CAAC,2IAA2I,CAAC,CAAC;IAC/J,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAkB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvG,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,IAAI,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,oGAAoG,CAAC,CAAC;IACxH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,4HAA4H,CAAC,CAAC;IAChJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,0HAA0H,CAAC,CAAC;IAC9I,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,WAAW,GAAG,KAAgC,CAAC;QACrD,IAAI,OAAO,WAAW,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,WAAW,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC7F,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;AACH,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAwB;IAC/D,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAEhC,MAAM,SAAS,GAA2C,EAAE,CAAC;IAC7D,MAAM,YAAY,GAAG,EAAE,EAAE,SAAS,CAAC;IACnC,IAAI,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACrF,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,SAAS;YAC9C,SAAS,CAAC,KAAK,CAAC,GAAG,sBAAsB,CACvC,KAAK,EACL,GAAiG,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mGAAmG;IACnG,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,MAAM,SAAS,GAAI,EAAiE,EAAE,MAAM,IAAI,EAAE,CAAC;IACnG,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9E,CAAC,CAAC,+BAA+B,CAAC,OAAO,CAAC;YAC1C,CAAC,CAAC,OAAO,CAAC;IACd,CAAC;IAED,MAAM,cAAc,GAAG,CAAC,EAAE,EAAE,UAAU,IAAI,EAAE,CAAC;SAC1C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3E,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AAC/C,CAAC"}

package/lib/config/perception-config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `ai.multimodal.perception` schema and validation (shared by AIService
+ * startup and `zhin config check`).
+ */
+/** Media kinds the perception pre-pass can describe. Audio stays on the STT path. */
+export type PerceptionMediaKind = 'image' | 'video' | 'file';
+export declare const PERCEPTION_MEDIA_KINDS: readonly PerceptionMediaKind[];
+/** Raw `ai.multimodal.perception` as written in config. */
+export interface PerceptionConfigInput {
+    provider?: string;
+    model?: string;
+    kinds?: readonly string[];
+    maxChars?: number;
+    timeoutMs?: number;
+    maxItemsPerTurn?: number;
+}
+export interface ResolvedPerceptionConfig {
+    readonly provider: string;
+    readonly model: string;
+    readonly kinds: readonly PerceptionMediaKind[];
+    readonly maxChars: number;
+    readonly timeoutMs: number;
+    readonly maxItemsPerTurn: number;
+}
+export declare const DEFAULT_PERCEPTION_SETTINGS: Readonly<{
+    kinds: readonly PerceptionMediaKind[];
+    maxChars: 800;
+    timeoutMs: 30000;
+    maxItemsPerTurn: 4;
+}>;
+/**
+ * Validate `ai.multimodal.perception`. `undefined` (not configured) returns
+ * `undefined`: the pre-pass is off and media handling is unchanged.
+ */
+export declare function resolvePerceptionConfig(raw: PerceptionConfigInput | undefined | null, providerAliases?: readonly string[]): ResolvedPerceptionConfig | undefined;
+//# sourceMappingURL=perception-config.d.ts.map