@zhin.js/agent 0.1.25 → 0.1.26

package/lib/security/security-config.example.js

@@ -0,0 +1,166 @@
+/**
+ * Agent 安全策略配置示例
+ *
+ * 展示如何配置所有安全策略。
+ */
+/**
+ * 生产环境安全配置
+ *
+ * 严格的安全策略，适用于生产环境
+ */
+export const PRODUCTION_SECURITY_CONFIG = {
+    // 审计日志配置
+    audit: {
+        enabled: true,
+        logFile: 'data/audit/agent-audit.log',
+        minSeverity: 'info',
+        logSensitiveData: false, // 生产环境不记录敏感数据
+        retentionDays: 90, // 保留 90 天
+        maxFileSizeMB: 200, // 最大 200MB
+    },
+    // 网络策略配置
+    network: {
+        enabled: true,
+        // 允许访问的域名（白名单）
+        allowedDomains: [
+            'api.openai.com',
+            'api.anthropic.com',
+            'api.ollama.ai',
+            'github.com',
+            'api.github.com',
+            'registry.npmjs.org',
+            'api.npmjs.org',
+        ],
+        // 禁止访问的域名（黑名单）
+        blockedDomains: [
+            '*.malware.com',
+            '*.phishing.com',
+            'pastebin.com',
+            'hastebin.com',
+        ],
+        // 禁止私有 IP
+        blockPrivateIPs: true,
+        // 请求限制
+        maxRequestSize: 5 * 1024 * 1024, // 5MB
+        maxResponseSize: 20 * 1024 * 1024, // 20MB
+        requestTimeout: 15000, // 15 秒
+        rateLimit: 60, // 每分钟 60 次
+        // 禁止的协议
+        blockedProtocols: ['file', 'ftp', 'gopher', 'ssh'],
+        // 禁止的端口
+        blockedPorts: [22, 23, 25, 465, 587, 1080, 3306, 5432, 6379, 27017],
+    },
+    // 预算限制配置
+    budget: {
+        enabled: true,
+        // Token 限制
+        maxTokensPerSession: 500000, // 500K tokens
+        maxTokensPerUserPerDay: 2000000, // 2M tokens
+        // 成本限制
+        maxCostPerSession: 5.0, // $5
+        maxCostPerUserPerDay: 20.0, // $20
+        // 调用限制
+        maxToolCallsPerSession: 50,
+        maxIterationsPerSession: 15,
+        // 时长限制
+        maxSessionDuration: 1800000, // 30 分钟
+        // 警告阈值
+        warningThreshold: 75, // 75%
+        // 自动终止
+        autoTerminate: true,
+    },
+};
+/**
+ * 开发环境安全配置
+ *
+ * 宽松的安全策略，适用于开发和测试
+ */
+export const DEVELOPMENT_SECURITY_CONFIG = {
+    audit: {
+        enabled: true,
+        logFile: 'data/audit/agent-audit-dev.log',
+        minSeverity: 'warn', // 开发环境只记录警告及以上
+        logSensitiveData: true, // 开发环境可以记录敏感数据
+        retentionDays: 7, // 保留 7 天
+        maxFileSizeMB: 50, // 最大 50MB
+    },
+    network: {
+        enabled: true,
+        // 开发环境允许更多域名
+        allowedDomains: [
+            'api.openai.com',
+            'api.anthropic.com',
+            'api.ollama.ai',
+            'github.com',
+            'api.github.com',
+            'registry.npmjs.org',
+            'api.npmjs.org',
+            'localhost',
+            '127.0.0.1',
+            '*.dev',
+            '*.test',
+            '*.local',
+        ],
+        blockPrivateIPs: false, // 开发环境允许私有 IP
+        maxRequestSize: 50 * 1024 * 1024, // 50MB
+        maxResponseSize: 100 * 1024 * 1024, // 100MB
+        requestTimeout: 60000, // 60 秒
+        rateLimit: 200, // 每分钟 200 次
+        blockedProtocols: ['file', 'ftp'],
+        blockedPorts: [22, 25, 465, 587],
+    },
+    budget: {
+        enabled: true,
+        maxTokensPerSession: 2000000, // 2M tokens
+        maxTokensPerUserPerDay: 10000000, // 10M tokens
+        maxCostPerSession: 20.0, // $20
+        maxCostPerUserPerDay: 100.0, // $100
+        maxToolCallsPerSession: 200,
+        maxIterationsPerSession: 50,
+        maxSessionDuration: 7200000, // 2 小时
+        warningThreshold: 85, // 85%
+        autoTerminate: false,
+    },
+};
+/**
+ * 最小安全配置
+ *
+ * 仅启用基本安全检查，适用于受信任环境
+ */
+export const MINIMAL_SECURITY_CONFIG = {
+    audit: {
+        enabled: false,
+    },
+    network: {
+        enabled: false,
+    },
+    budget: {
+        enabled: false,
+    },
+};
+/**
+ * 根据环境获取安全配置
+ */
+export function getSecurityConfigForEnvironment(env) {
+    switch (env) {
+        case 'production':
+            return PRODUCTION_SECURITY_CONFIG;
+        case 'development':
+            return DEVELOPMENT_SECURITY_CONFIG;
+        case 'minimal':
+            return MINIMAL_SECURITY_CONFIG;
+        default:
+            return DEVELOPMENT_SECURITY_CONFIG;
+    }
+}
+/**
+ * 合并自定义配置与默认配置
+ */
+export function mergeSecurityConfig(base, custom) {
+    return {
+        audit: { ...base.audit, ...custom.audit },
+        network: { ...base.network, ...custom.network },
+        budget: { ...base.budget, ...custom.budget },
+    };
+}
+//# sourceMappingURL=security-config.example.js.map

package/lib/security/security-config.example.js.map

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

package/lib/subagent-goal-notify.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 主 Agent 委派子任务时，向 IM 用户即时发送 goal 进度提示。
+ */
+import type { ToolContext } from '@zhin.js/core';
+/** ToolContext.extra 中挂载的回调键 */
+export declare const SUBAGENT_GOAL_NOTIFY_EXTRA_KEY = "onSubagentGoal";
+export type SubagentGoalNotifier = (goal: string) => void | Promise<void>;
+export declare function truncateSubagentGoal(goal: string): string;
+/** 用户可见格式：🔧 正在执行：${goal} */
+export declare function formatSubagentProcessingMessage(goal: string): string;
+export declare function getSubagentGoalNotifier(ctx?: ToolContext): SubagentGoalNotifier | undefined;
+export declare function notifySubagentGoal(ctx: ToolContext | undefined, goal: string): Promise<void>;
+//# sourceMappingURL=subagent-goal-notify.d.ts.map

package/lib/subagent-goal-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-goal-notify.d.ts","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,gCAAgC;AAChC,eAAO,MAAM,8BAA8B,mBAAmB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAI1E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,6BAA6B;AAC7B,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,oBAAoB,GAAG,SAAS,CAG3F;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlG"}

package/lib/subagent-goal-notify.js

@@ -0,0 +1,32 @@
+/** ToolContext.extra 中挂载的回调键 */
+export const SUBAGENT_GOAL_NOTIFY_EXTRA_KEY = 'onSubagentGoal';
+const MAX_GOAL_CHARS = 500;
+export function truncateSubagentGoal(goal) {
+    const trimmed = goal.trim();
+    if (trimmed.length <= MAX_GOAL_CHARS)
+        return trimmed;
+    return `${trimmed.slice(0, MAX_GOAL_CHARS)}…`;
+}
+/** 用户可见格式：🔧 正在执行：${goal} */
+export function formatSubagentProcessingMessage(goal) {
+    return `🔧 正在执行：${truncateSubagentGoal(goal)}`;
+}
+export function getSubagentGoalNotifier(ctx) {
+    const fn = ctx?.extra?.[SUBAGENT_GOAL_NOTIFY_EXTRA_KEY];
+    return typeof fn === 'function' ? fn : undefined;
+}
+export async function notifySubagentGoal(ctx, goal) {
+    const notify = getSubagentGoalNotifier(ctx);
+    if (!notify)
+        return;
+    const trimmed = goal.trim();
+    if (!trimmed)
+        return;
+    try {
+        await notify(trimmed);
+    }
+    catch {
+        // 进度提示失败不中断子任务
+    }
+}
+//# sourceMappingURL=subagent-goal-notify.js.map

package/lib/subagent-goal-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-goal-notify.js","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAKA,gCAAgC;AAChC,MAAM,CAAC,MAAM,8BAA8B,GAAG,gBAAgB,CAAC;AAI/D,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc;QAAE,OAAO,OAAO,CAAC;IACrD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC;AAChD,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,+BAA+B,CAAC,IAAY;IAC1D,OAAO,WAAW,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAiB;IACvD,MAAM,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,8BAA8B,CAAC,CAAC;IACxD,OAAO,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAE,EAA2B,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAA4B,EAAE,IAAY;IACjF,MAAM,MAAM,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC"}

package/lib/subagent.d.ts

@@ -10,17 +10,35 @@
 import type { AIProvider, AgentTool, Usage } from '@zhin.js/core';
 import type { ModelRegistry } from '@zhin.js/ai';
 import type { ZhinAgentConfig } from './zhin-agent/config.js';
+import type { FileRole } from './security/file-role-policy.js';
+import { AgentDispatcher, type AgentRole } from './orchestrator/agent-dispatcher.js';
 export interface SubagentOrigin {
     platform: string;
     botId: string;
     sceneId: string;
     senderId: string;
     sceneType: string;
+    fileRole?: FileRole;
 }
 export interface SpawnOptions {
     task: string;
     label?: string;
     origin: SubagentOrigin;
+    /** Agent 角色（可选，默认为 'subtask'） */
+    role?: AgentRole;
+    /** 任务上下文（可选） */
+    context?: Record<string, unknown>;
+}
+export interface SubagentLifecycleEvent {
+    phase: 'spawn' | 'start' | 'finish';
+    taskId: string;
+    label: string;
+    task: string;
+    origin: SubagentOrigin;
+    role?: AgentRole;
+    status?: 'ok' | 'error';
+    result?: string;
+    error?: string;
 }
 export type SubagentResultSender = (origin: SubagentOrigin, content: string) => Promise<void>;
 export interface SubagentManagerOptions {
@@ -36,6 +54,10 @@ export interface SubagentManagerOptions {
     onSubagentUsage?: (usage: Usage) => void;
     /** 注册子 agent 生命周期 Promise，供主会话在 turn 结束前可选等待 */
     registerSubagentTask?: (done: Promise<void>) => void;
+    /** Agent 调度器（可选，用于角色管理） */
+    agentDispatcher?: AgentDispatcher;
+    /** 生命周期事件回调（供上层桥接到统一事件总线） */
+    onEvent?: (event: SubagentLifecycleEvent) => void | Promise<void>;
 }
 export declare class SubagentManager {
     private provider;
@@ -49,6 +71,8 @@ export declare class SubagentManager {
     private resultSender;
     private onSubagentUsage;
     private registerSubagentTask;
+    private agentDispatcher;
+    private onEvent;
     constructor(options: SubagentManagerOptions);
     setSender(sender: SubagentResultSender): void;
     setModelRegistry(registry: ModelRegistry | null): void;

package/lib/subagent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../src/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAe9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,SAAS,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC7C,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,4CAA4C;IAC5C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACzC,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;CACtD;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAW;IAChC,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,oBAAoB,CAAyC;gBAEzD,OAAO,EAAE,sBAAsB;IAY3C,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAI7C,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAIhD,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBnD,eAAe,IAAI,MAAM;YAMX,WAAW;YA6EX,cAAc;IAwB5B,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../src/subagent.ts"],"names":[],"mappings":"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"}

package/lib/subagent.js

@@ -9,7 +9,7 @@
  */
 import { randomUUID } from 'node:crypto';
 import { Logger } from '@zhin.js/core';
-import { formatCompact, formatCompactUsage } from '@zhin.js/logger';
+import { formatCompact, formatCompactUsage, truncatePreview } from '@zhin.js/logger';
 import { createAgent } from '@zhin.js/ai';
 import { applyExecPolicyToTools } from './security/exec-policy.js';
 import { RESERVED_TOOL_NAMES, RESERVED_TOOL_NAME_PREFIXES } from './reserved-tools.js';
@@ -33,6 +33,8 @@ export class SubagentManager {
     resultSender = null;
     onSubagentUsage;
     registerSubagentTask;
+    agentDispatcher;
+    onEvent;
     constructor(options) {
         this.provider = options.provider;
         this.workspace = options.workspace;
@@ -43,6 +45,8 @@ export class SubagentManager {
         this.modelRegistry = options.modelRegistry ?? null;
         this.onSubagentUsage = options.onSubagentUsage ?? null;
         this.registerSubagentTask = options.registerSubagentTask ?? null;
+        this.agentDispatcher = options.agentDispatcher ?? null;
+        this.onEvent = options.onEvent ?? null;
     }
     setSender(sender) {
         this.resultSender = sender;
@@ -52,11 +56,12 @@ export class SubagentManager {
     }
     async spawn(options) {
         const taskId = randomUUID().slice(0, 8);
+        const role = options.role || 'subtask';
         const displayLabel = options.label ||
             options.task.slice(0, 30) + (options.task.length > 30 ? '...' : '');
         const abortController = new AbortController();
         this.runningTasks.set(taskId, abortController);
-        const done = this.runSubagent(taskId, options.task, displayLabel, options.origin)
+        const done = this.runSubagent(taskId, options.task, displayLabel, options.origin, role, options.context)
             .catch((error) => {
             logger.error({ error, taskId }, 'Subagent failed');
         })
@@ -64,30 +69,76 @@ export class SubagentManager {
             this.runningTasks.delete(taskId);
         });
         this.registerSubagentTask?.(done);
-        logger.debug(formatCompact({ spawn: taskId, label: displayLabel }));
+        logger.info(formatCompact({
+            subagent: 'spawn',
+            task_id: taskId,
+            label: displayLabel,
+            role,
+            task: truncatePreview(options.task, 300),
+        }));
+        void this.onEvent?.({
+            phase: 'spawn',
+            taskId,
+            label: displayLabel,
+            task: options.task,
+            origin: options.origin,
+            role,
+        });
         return `子任务 [${displayLabel}] 已启动 (id: ${taskId})，完成后会自动通知你。`;
     }
     getRunningCount() {
         return this.runningTasks.size;
     }
     // ── 内部方法 ──────────────────────────────────────────────────────
-    async runSubagent(taskId, task, label, origin) {
+    async runSubagent(taskId, task, label, origin, role = 'subtask', context) {
         const startedAt = Date.now();
-        logger.debug(formatCompact({ task_id: taskId, label }));
+        logger.debug(formatCompact({ task_id: taskId, label, role }));
+        await this.onEvent?.({
+            phase: 'start',
+            taskId,
+            label,
+            task,
+            origin,
+            role,
+        });
         try {
             const allTools = this.createTools();
-            let tools = createRestrictedToolView(allTools, {
-                allowedNames: this.subagentTools.length
-                    ? this.subagentTools
-                    : this.execPolicyConfig?.subagentTools?.length
-                        ? this.execPolicyConfig.subagentTools
-                        : DEFAULT_SUBAGENT_TOOL_NAMES,
-                disabledNames: this.execPolicyConfig?.disabledTools,
-            });
+            // 使用 Agent 调度器过滤工具（如果可用）
+            let tools;
+            if (this.agentDispatcher) {
+                tools = this.agentDispatcher.filterToolsByRole(allTools, role);
+            }
+            else {
+                tools = createRestrictedToolView(allTools, {
+                    allowedNames: this.subagentTools.length
+                        ? this.subagentTools
+                        : this.execPolicyConfig?.subagentTools?.length
+                            ? this.execPolicyConfig.subagentTools
+                            : DEFAULT_SUBAGENT_TOOL_NAMES,
+                    disabledNames: this.execPolicyConfig?.disabledTools,
+                });
+            }
             if (this.execPolicyConfig) {
-                tools = applyExecPolicyToTools(this.execPolicyConfig, tools);
+                tools = applyExecPolicyToTools(this.execPolicyConfig, tools, {
+                    approvalMode: this.execPolicyConfig.subagentExecApprovalMode,
+                });
+            }
+            // 使用 Agent 调度器构建提示词（如果可用）
+            let systemPrompt;
+            if (this.agentDispatcher) {
+                const taskDef = this.agentDispatcher.createTask({
+                    name: label,
+                    description: task,
+                    role,
+                    goal: task,
+                    priority: 'medium',
+                    context,
+                });
+                systemPrompt = this.agentDispatcher.buildRolePrompt(role, taskDef);
+            }
+            else {
+                systemPrompt = this.buildSubagentPrompt(task);
             }
-            const systemPrompt = this.buildSubagentPrompt(task);
             const model = this.provider.models[0];
             const contextBudget = this.execPolicyConfig
                 ? resolveContextBudget({
@@ -102,6 +153,7 @@ export class SubagentManager {
                 botId: origin.botId,
                 sceneId: origin.sceneId,
                 senderId: origin.senderId,
+                fileRole: origin.fileRole,
             };
             const agent = createAgent(this.provider, {
                 model,
@@ -120,13 +172,26 @@ export class SubagentManager {
                 const result = await runWithDirectAgentExecution(bashToolContext, () => agent.run(task));
                 this.onSubagentUsage?.(result.usage);
                 const finalResult = result.content || '任务已完成，但未生成最终响应。';
-                logger.debug(formatCompact({
+                logger.info(formatCompact({
+                    subagent: 'done',
                     task_id: taskId,
+                    label,
                     total_ms: Date.now() - startedAt,
                     usage: formatCompactUsage(result.usage),
                     iter: result.iterations,
                     model,
+                    result: truncatePreview(finalResult, 480),
                 }));
+                await this.onEvent?.({
+                    phase: 'finish',
+                    taskId,
+                    label,
+                    task,
+                    origin,
+                    role,
+                    status: 'ok',
+                    result: finalResult,
+                });
                 await this.announceResult(taskId, label, task, finalResult, origin, 'ok');
             }
             finally {
@@ -136,6 +201,23 @@ export class SubagentManager {
         catch (error) {
             const errorMsg = `Error: ${error}`;
             logger.error({ taskId, error }, 'Subagent failed');
+            logger.info(formatCompact({
+                subagent: 'done',
+                task_id: taskId,
+                label,
+                ok: false,
+                error: truncatePreview(errorMsg, 300),
+            }));
+            await this.onEvent?.({
+                phase: 'finish',
+                taskId,
+                label,
+                task,
+                origin,
+                role,
+                status: 'error',
+                error: errorMsg,
+            });
             await this.announceResult(taskId, label, task, errorMsg, origin, 'error');
         }
     }

package/lib/subagent.js.map

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

package/lib/typing-indicator/adapter-integration.d.ts

@@ -0,0 +1,140 @@
+/**
+ * 通用适配器 Typing Indicator 集成模块
+ *
+ * 为所有适配器提供统一的 Typing Indicator 集成接口，
+ * 支持自动初始化和配置管理。
+ */
+import type { Bot } from '@zhin.js/core';
+import { TypingIndicatorManager, type TypingIndicatorConfig, type TypingIndicator } from './index.js';
+/**
+ * 平台 Bot 可能具备的扩展消息编辑能力
+ */
+interface MessageEditableBot {
+    $editMessage?(messageId: string, content: string): Promise<void>;
+    $updateMessage?(messageId: string, content: string): Promise<void>;
+}
+export type BotWithEditing = Bot & Partial<MessageEditableBot>;
+export interface AdapterTypingIndicatorConfig {
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+    /** 默认表情（默认 '⏳'） */
+    defaultEmoji?: string;
+    /** 是否在完成后自动移除（默认 true） */
+    autoRemove?: boolean;
+    /** 自动移除延迟，毫秒（默认 5000） */
+    removeDelay?: number;
+    /** 私聊配置 */
+    privateConfig?: Partial<TypingIndicatorConfig>;
+    /** 群聊配置 */
+    groupConfig?: Partial<TypingIndicatorConfig>;
+    /** 平台特定配置 */
+    platformConfig?: Record<string, Partial<TypingIndicatorConfig>>;
+}
+export interface PlatformFeatures {
+    /** 平台名称 */
+    platform: string;
+    /** 是否支持消息回应（reaction） */
+    supportsReaction: boolean;
+    /** 是否支持消息编辑 */
+    supportsEdit: boolean;
+    /** 是否支持消息删除 */
+    supportsDelete: boolean;
+    /** 是否支持输入状态 */
+    supportsTyping: boolean;
+    /** 默认提示类型 */
+    defaultType: 'reaction' | 'message' | 'typing' | 'none';
+}
+export declare const PLATFORM_FEATURES: Record<string, PlatformFeatures>;
+export interface BotWithTypingIndicator extends Bot {
+    $typingIndicator?: TypingIndicatorManager;
+    $addReaction?(messageId: string, emoji: string): Promise<string | null>;
+    $removeReaction?(messageId: string, reactionId: string): Promise<void>;
+}
+export declare class AdapterTypingIndicatorManager {
+    private managers;
+    private configs;
+    /**
+     * 为 Bot 启用 Typing Indicator
+     */
+    enableForBot(bot: BotWithTypingIndicator, platform: string, config?: Partial<AdapterTypingIndicatorConfig>): TypingIndicatorManager;
+    /**
+     * 注册平台适配器
+     */
+    private registerAdapter;
+    /**
+     * 解析会话 ID
+     */
+    private parseSessionId;
+    /**
+     * 获取 Bot 的管理器
+     */
+    getManager(platform: string, botId: string): TypingIndicatorManager | undefined;
+    /**
+     * 获取 Bot 的配置
+     */
+    getConfig(platform: string, botId: string): AdapterTypingIndicatorConfig | undefined;
+    /**
+     * 停止 Bot 的所有提示
+     */
+    stopAll(platform: string, botId: string): Promise<void>;
+    /**
+     * 停止所有 Bot 的所有提示
+     */
+    stopAllBots(): Promise<void>;
+    /**
+     * 移除 Bot 的管理器
+     */
+    removeBot(platform: string, botId: string): void;
+    /**
+     * 清除所有管理器
+     */
+    clearAll(): void;
+    /**
+     * 获取所有已注册的 Bot
+     */
+    getRegisteredBots(): Array<{
+        platform: string;
+        botId: string;
+    }>;
+    /**
+     * 获取平台特性
+     */
+    getPlatformFeatures(platform: string): PlatformFeatures | undefined;
+    /**
+     * 检查平台是否支持 Typing Indicator
+     */
+    supportsTypingIndicator(platform: string): boolean;
+}
+/**
+ * 获取全局适配器 Typing Indicator 管理器
+ */
+export declare function getAdapterTypingIndicatorManager(): AdapterTypingIndicatorManager;
+/**
+ * 初始化适配器 Typing Indicator 管理器
+ */
+export declare function initAdapterTypingIndicatorManager(): AdapterTypingIndicatorManager;
+/**
+ * 为 Bot 启用 Typing Indicator
+ */
+export declare function enableTypingIndicatorForBot(bot: BotWithTypingIndicator, platform: string, config?: Partial<AdapterTypingIndicatorConfig>): TypingIndicatorManager;
+/**
+ * 快速开始提示
+ */
+export declare function startTypingForBot(bot: BotWithTypingIndicator, platform: string, options: {
+    messageId?: string;
+    sessionId: string;
+    userId?: string;
+    groupId?: string;
+    sceneType?: 'private' | 'group' | 'channel';
+}, config?: Partial<AdapterTypingIndicatorConfig>): Promise<TypingIndicator>;
+/**
+ * 快速停止提示
+ */
+export declare function stopTypingForBot(bot: BotWithTypingIndicator, platform: string, options: {
+    sessionId: string;
+    userId?: string;
+    groupId?: string;
+    sceneType?: 'private' | 'group' | 'channel';
+}): Promise<void>;
+export {};
+//# sourceMappingURL=adapter-integration.d.ts.map