@zhin.js/agent 0.3.1 → 1.0.2

package/lib/subagent/subagent-system.d.ts

@@ -0,0 +1,31 @@
+import type { ModelRegistry } from '@zhin.js/ai';
+import type { ZhinAgentEventEmitter } from '../event/event-emitter.js';
+import type { ResultSink, SubagentDefinition, SubagentSystemConfig } from './contracts.js';
+import { SubagentRuntime, type SpawnOptions, type SubagentCompletePayload, type SubagentLifecycleEvent, type SubagentOrigin, type SubagentResultDelivery, type SubagentResultSender, type SubagentRuntimeOptions } from './subagent-runtime.js';
+export declare class SubagentSystem {
+    private readonly _config;
+    private readonly resultSinks;
+    private readonly senders;
+    private readonly definitions;
+    private runtime;
+    constructor(_config?: SubagentSystemConfig);
+    register(definition: SubagentDefinition): void;
+    getDefinition(name: string): SubagentDefinition | undefined;
+    attachRuntime(options: SubagentRuntimeOptions): void;
+    getRuntime(): SubagentRuntime | null;
+    addResultSink(sink: ResultSink): void;
+    addSender(sender: SubagentResultSender): void;
+    composeSender(): SubagentResultSender | null;
+    setSender(sender: SubagentResultSender): void;
+    setModelRegistry(registry: ModelRegistry | null): void;
+    setEventEmitter(emitter: ZhinAgentEventEmitter | null): void;
+    configureRouting(deps: Parameters<SubagentRuntime['configureRouting']>[0]): void;
+    spawn(options: SpawnOptions): Promise<string>;
+    spawnSync(options: SpawnOptions): Promise<string>;
+    cancel(taskId: string): boolean;
+    getRunningCount(): number;
+    dispose(): void;
+}
+export declare const defaultSubagentSystem: SubagentSystem;
+export type { SpawnOptions, SubagentCompletePayload, SubagentLifecycleEvent, SubagentOrigin, SubagentResultDelivery, SubagentResultSender, SubagentRuntimeOptions, };
+//# sourceMappingURL=subagent-system.d.ts.map

package/lib/subagent/subagent-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-system.d.ts","sourceRoot":"","sources":["../../src/subagent/subagent-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3F,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IACrE,OAAO,CAAC,OAAO,CAAgC;gBAElB,OAAO,GAAE,oBAAyB;IAE/D,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAI9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI3D,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAMpD,UAAU,IAAI,eAAe,GAAG,IAAI;IAIpC,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IASrC,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAM7C,aAAa,IAAI,oBAAoB,GAAG,IAAI;IAkB5C,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAK7C,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAItD,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI;IAI5D,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI1E,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7C,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI/B,eAAe,IAAI,MAAM;IAIzB,OAAO,IAAI,IAAI;CAMhB;AAED,eAAO,MAAM,qBAAqB,gBAAyB,CAAC;AAE5D,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GACvB,CAAC"}

package/lib/subagent/subagent-system.js

@@ -0,0 +1,98 @@
+import { ImResultSink } from './im-result-sink.js';
+import { SubagentRuntime, } from './subagent-runtime.js';
+export class SubagentSystem {
+    _config;
+    resultSinks = [];
+    senders = [];
+    definitions = new Map();
+    runtime = null;
+    constructor(_config = {}) {
+        this._config = _config;
+    }
+    register(definition) {
+        this.definitions.set(definition.name, definition);
+    }
+    getDefinition(name) {
+        return this.definitions.get(name);
+    }
+    attachRuntime(options) {
+        this.runtime = new SubagentRuntime(options);
+        const sender = this.composeSender();
+        if (sender)
+            this.runtime.setSender(sender);
+    }
+    getRuntime() {
+        return this.runtime;
+    }
+    addResultSink(sink) {
+        this.resultSinks.push(sink);
+        if (sink instanceof ImResultSink) {
+            this.senders.push(sink.asResultSender());
+        }
+        const sender = this.composeSender();
+        if (sender && this.runtime)
+            this.runtime.setSender(sender);
+    }
+    addSender(sender) {
+        this.senders.push(sender);
+        const composed = this.composeSender();
+        if (composed && this.runtime)
+            this.runtime.setSender(composed);
+    }
+    composeSender() {
+        if (this.senders.length === 0 && this.resultSinks.length === 0)
+            return null;
+        return async (origin, delivery) => {
+            for (const sender of this.senders) {
+                await sender(origin, delivery);
+            }
+            for (const sink of this.resultSinks) {
+                if (sink instanceof ImResultSink)
+                    continue;
+                const status = delivery.status === 'error' ? 'failed' : 'completed';
+                await sink.deliver({
+                    taskId: delivery.taskId ?? 'unknown',
+                    status,
+                    result: delivery.text,
+                });
+            }
+        };
+    }
+    setSender(sender) {
+        this.senders.length = 0;
+        this.addSender(sender);
+    }
+    setModelRegistry(registry) {
+        this.runtime?.setModelRegistry(registry);
+    }
+    setEventEmitter(emitter) {
+        this.runtime?.setEventEmitter(emitter);
+    }
+    configureRouting(deps) {
+        this.runtime?.configureRouting(deps);
+    }
+    async spawn(options) {
+        if (!this.runtime)
+            throw new Error('SubagentSystem: runtime not attached');
+        return this.runtime.spawn(options);
+    }
+    async spawnSync(options) {
+        if (!this.runtime)
+            throw new Error('SubagentSystem: runtime not attached');
+        return this.runtime.spawnSync(options);
+    }
+    cancel(taskId) {
+        return this.runtime?.cancel(taskId) ?? false;
+    }
+    getRunningCount() {
+        return this.runtime?.getRunningCount() ?? 0;
+    }
+    dispose() {
+        this.runtime?.dispose();
+        this.runtime = null;
+        this.resultSinks.length = 0;
+        this.senders.length = 0;
+    }
+}
+export const defaultSubagentSystem = new SubagentSystem({});
+//# sourceMappingURL=subagent-system.js.map

package/lib/subagent/subagent-system.js.map

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

package/lib/subagent-ai-events.d.ts

@@ -1,8 +1,8 @@
-import type { AgentLoopStandaloneCallbacks } from './zhin-agent/agent-loop-standalone.js';
-import type { Message } from '@zhin.js/core';
+import { type Message } from '@zhin.js/core';
+import type { AgentLoopStandaloneCallbacks } from './core/agent-loop-standalone.js';
 import type { McpRegistry } from './orchestrator/mcp-registry.js';
-import type { SubagentOrigin } from './subagent.js';
-import type { ZhinAgentEventEmitter } from './zhin-agent/event-emitter.js';
+import type { SubagentOrigin } from './subagent/index.js';
+import type { ZhinAgentEventEmitter } from './event/event-emitter.js';
 export interface SubagentAiEventContext {
     taskId: string;
     label: string;

package/lib/subagent-ai-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-ai-events.d.ts","sourceRoot":"","sources":["../src/subagent-ai-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,2EAA2E;IAC3E,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,qBAAa,uBAAuB;IAKhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;gBAGX,OAAO,EAAE,qBAAqB,EAC9B,GAAG,EAAE,sBAAsB;IAM9C,OAAO,CAAC,OAAO;IAWT,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,eAAe,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9G,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlF,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,4BAA4B;IAmB/D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5F"}
+{"version":3,"file":"subagent-ai-events.d.ts","sourceRoot":"","sources":["../src/subagent-ai-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,2EAA2E;IAC3E,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,qBAAa,uBAAuB;IAKhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;gBAGX,OAAO,EAAE,qBAAqB,EAC9B,GAAG,EAAE,sBAAsB;IAM9C,OAAO,CAAC,OAAO;IAWT,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,eAAe,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9G,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlF,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,4BAA4B;IAmB/D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5F"}

package/lib/subagent-ai-events.js.map

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

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

@@ -1,14 +1,8 @@
-/**
- * 主 Agent 委派子任务时，向 IM 用户即时发送进度提示。
- *
- * 注意：`kind` 是用户可见的「执行通道」（异步/视觉/定时/同步/编排），
- * 与 AgentDispatcher 内部的 `AgentRole`（subtask/worker 等工具权限）不是同一概念。
- */
 import type { Message } from '@zhin.js/core';
 /** AgentTurnMessage.extra 中挂载的回调键 */
 export declare const SUBAGENT_GOAL_NOTIFY_EXTRA_KEY = "onSubagentGoal";
 /** 用户可见的执行通道（进度提示中间段） */
-export type SubagentExecutionKind = 'async' | 'sync' | 'vision' | 'draw' | 'deferred' | 'cron';
+export type SubagentExecutionKind = 'async' | 'sync' | 'deferred' | 'cron';
 export declare const SUBAGENT_EXECUTION_KIND_LABELS: Record<SubagentExecutionKind, string>;
 export interface SubagentProcessingNotice {
     taskId: string;
@@ -19,16 +13,24 @@ export interface SubagentProcessingNotice {
 }
 export type SubagentGoalNotifier = (notice: SubagentProcessingNotice) => void | Promise<void>;
 export declare function resolveSubagentDisplayLabel(label: string | undefined, task: string): string;
-/** spawn / spawnSync 的执行通道：具名 agent 优先，否则 sync/async */
+/** spawn / spawnSync 的执行通道 */
 export declare function resolveSpawnExecutionKind(options: {
     sync?: boolean;
-    agent?: string;
 }): SubagentExecutionKind;
 /** 日志与进度提示用的 agent 展示名 */
 export declare function resolveSubagentAgentLabel(agent?: string): string | undefined;
 export declare function formatSubagentExecutionKindLabel(kind: SubagentExecutionKind): string;
 /** 用户可见格式：任务【taskId】:执行通道·agent => label */
 export declare function formatSubagentProcessingMessage(notice: SubagentProcessingNotice): string;
+/**
+ * 多 Bot 同群协作时，编排/子任务进度提示若发到群里会被 peer Bot 收进引用链。
+ * 此类场景仅打日志，最终结论仍由主 Agent 正常 reply。
+ */
+export declare function shouldSuppressSubagentGoalNotifyToIm(message: Message, cell?: {
+    members: {
+        endpointId: string;
+    }[];
+}): boolean;
 export declare function getSubagentGoalNotifier(commMessage?: Message): SubagentGoalNotifier | undefined;
 export declare function notifySubagentGoal(commMessage: Message | undefined, notice: SubagentProcessingNotice): Promise<void>;
 //# sourceMappingURL=subagent-goal-notify.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"subagent-goal-notify.d.ts","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAoB,OAAO,EAAE,MAAM,eAAe,CAAC;AAE/D,qCAAqC;AACrC,eAAO,MAAM,8BAA8B,mBAAmB,CAAC;AAE/D,yBAAyB;AACzB,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/F,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAOhF,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3F;AAED,wDAAwD;AACxD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,qBAAqB,CAMxB;AAED,0BAA0B;AAC1B,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAEpF;AAED,4CAA4C;AAC5C,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAOxF;AAED,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAI/F;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAaf"}
+{"version":3,"file":"subagent-goal-notify.d.ts","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,OAAO,EAAE,MAAM,eAAe,CAAC;AAE/D,qCAAqC;AACrC,eAAO,MAAM,8BAA8B,mBAAmB,CAAC;AAE/D,yBAAyB;AACzB,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAE3E,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAKhF,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3F;AAED,8BAA8B;AAC9B,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,qBAAqB,CAGxB;AAED,0BAA0B;AAC1B,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAEpF;AAED,4CAA4C;AAC5C,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAOxF;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE;IAAE,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GAC3C,OAAO,CAMT;AAED,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAI/F;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/lib/subagent-goal-notify.js

@@ -3,8 +3,6 @@ export const SUBAGENT_GOAL_NOTIFY_EXTRA_KEY = 'onSubagentGoal';
 export const SUBAGENT_EXECUTION_KIND_LABELS = {
     async: '异步',
     sync: '同步',
-    vision: '视觉',
-    draw: '文生图',
     deferred: '编排',
     cron: '定时',
 };
@@ -14,13 +12,8 @@ export function resolveSubagentDisplayLabel(label, task) {
         return trimmed;
     return task.slice(0, 30) + (task.length > 30 ? '...' : '');
 }
-/** spawn / spawnSync 的执行通道：具名 agent 优先，否则 sync/async */
+/** spawn / spawnSync 的执行通道 */
 export function resolveSpawnExecutionKind(options) {
-    const agent = options.agent?.trim().toLowerCase();
-    if (agent === 'vision')
-        return 'vision';
-    if (agent === 'draw')
-        return 'draw';
     if (options.sync)
         return 'sync';
     return 'async';
@@ -42,6 +35,19 @@ export function formatSubagentProcessingMessage(notice) {
     const channel = agent ? `${kindLabel}·${agent}` : kindLabel;
     return `任务【${taskId}】:${channel} => ${label}`;
 }
+/**
+ * 多 Bot 同群协作时，编排/子任务进度提示若发到群里会被 peer Bot 收进引用链。
+ * 此类场景仅打日志，最终结论仍由主 Agent 正常 reply。
+ */
+export function shouldSuppressSubagentGoalNotifyToIm(message, cell) {
+    const scope = message.$channel?.type;
+    if (scope !== 'group' && scope !== 'channel')
+        return false;
+    if (!cell?.members?.length)
+        return false;
+    const endpoints = new Set(cell.members.map((m) => m.endpointId));
+    return endpoints.size >= 2;
+}
 export function getSubagentGoalNotifier(commMessage) {
     const extra = commMessage ? commMessage.extra : undefined;
     const fn = extra?.[SUBAGENT_GOAL_NOTIFY_EXTRA_KEY];

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

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

package/lib/subagent-preset.js

@@ -1,23 +1,23 @@
 const KNOWN_ROLES = new Set([
-    'main', 'subtask', 'worker', 'researcher', 'executor', 'reviewer', 'planner', 'validator',
+    'subtask', 'worker', 'researcher', 'evaluator', 'executor', 'reviewer', 'planner',
 ]);
 const PRESET_ROLE_BY_NAME = {
     reviewer: 'reviewer',
     planner: 'planner',
     researcher: 'researcher',
+    evaluator: 'evaluator',
     scout: 'researcher',
     explorer: 'researcher',
     worker: 'subtask',
     executor: 'executor',
 };
 const DEFAULT_CONTEXT_MODE_BY_ROLE = {
-    main: 'fork',
     subtask: 'fork',
     worker: 'fork',
     researcher: 'fork',
+    evaluator: 'fresh',
     executor: 'fork',
     reviewer: 'fresh',
-    validator: 'fresh',
     planner: 'fresh',
 };
 export function isAgentRole(value) {

package/lib/subagent-preset.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-preset.js","sourceRoot":"","sources":["../src/subagent-preset.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC;IAC/C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW;CAC1F,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAA8B;IACrD,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,4BAA4B,GAA2C;IAC3E,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,OAAO;IACjB,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAkC,EAClC,SAAkB;IAElB,IAAI,IAAI,EAAE,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAkC,EAClC,IAAe,EACf,QAA8B;IAE9B,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,EAAE,WAAW,CAAC;IACnC,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjE,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"subagent-preset.js","sourceRoot":"","sources":["../src/subagent-preset.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC;IAC/C,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS;CAClF,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAA8B;IACrD,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,4BAA4B,GAA2C;IAC3E,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,OAAO;IAClB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAkC,EAClC,SAAkB;IAElB,IAAI,IAAI,EAAE,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAkC,EAClC,IAAe,EACf,QAA8B;IAE9B,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,EAAE,WAAW,CAAC;IACnC,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjE,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/lib/task-executor.d.ts

@@ -1,33 +1,37 @@
+import { type Message } from '@zhin.js/core';
 import type { ZhinAgent } from './zhin-agent/index.js';
 import { type NotificationRouter } from './assistant/notification-router.js';
-import type { JobNotify } from './assistant/types.js';
+import type { JobNotify, ScheduleJobCreator, ScheduleJobExecutionPlan } from './assistant/types.js';
 export interface TaskExecutionOptions {
-    /** The prompt to send to ZhinAgent */
     prompt: string;
-    /** 投递通道 */
     notify?: JobNotify;
-    /** Whether to prepend current time info (default: false) */
     timeContext?: boolean;
+    createdBy?: ScheduleJobCreator;
+    /** 预演模式：结果回创建者，不投递 notify 目标 */
+    preview?: boolean;
+    /** 预演时使用创建者入站 Message（保留 messageId / 角色） */
+    previewCommMessage?: Message;
+    executionPlan?: ScheduleJobExecutionPlan;
+    activityFeedback?: boolean;
+    scheduleJobId?: string;
 }
 export interface TaskExecutionResult {
     success: boolean;
-    /** The text that was (or would have been) delivered */
     responseText: string;
-    /** Wall-clock duration in milliseconds */
     durationMs: number;
-    /** Error message if success=false */
     error?: string;
+    executionPlan?: ScheduleJobExecutionPlan;
 }
 export interface TaskExecutorDeps {
     agent: ZhinAgent;
-    /** Resolve an adapter by platform name. Returns object with sendMessage if found. */
     resolveAdapter: (platform: string) => {
         sendMessage: (opts: import('@zhin.js/core').SendOptions) => Promise<string>;
     } | undefined;
-    /** M3：可选注入；未提供时按 resolveAdapter 创建 */
     router?: NotificationRouter;
-    /** assistant.defaults.notify */
     defaultNotify?: JobNotify;
+    deliverIm?: (notify: JobNotify & {
+        channel: 'im';
+    }, content: string) => Promise<void>;
 }
 export declare function createTaskExecutor(deps: TaskExecutorDeps): {
     executeTask: (options: TaskExecutionOptions) => Promise<TaskExecutionResult>;

package/lib/task-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../src/task-executor.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQtD,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,qFAAqF;IACrF,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK;QAAE,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,eAAe,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS,CAAC;IAClI,sCAAsC;IACtC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,gCAAgC;IAChC,aAAa,CAAC,EAAE,SAAS,CAAC;CAC3B;AAwCD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;2BAGnB,oBAAoB,KAAG,OAAO,CAAC,mBAAmB,CAAC;+BAhD5D,MAAM,KAAK;QAAE,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,eAAe,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS;EAqGlI;AAED,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../src/task-executor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAiE,MAAM,eAAe,CAAC;AAC5G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAM9B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,wBAAwB,CAAC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,wBAAwB,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK;QAAE,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,eAAe,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS,CAAC;IAClI,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvF;AA4BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;2BAQnB,oBAAoB,KAAG,OAAO,CAAC,mBAAmB,CAAC;+BAxC5D,MAAM,KAAK;QAAE,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,eAAe,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS;EAiKlI;AAED,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/lib/task-executor.js

@@ -1,9 +1,9 @@
-import { Logger, createSyntheticMessage } from '@zhin.js/core';
+import { Logger, createSyntheticMessage, resolveIMSessionIdFromMessage } from '@zhin.js/core';
 import { createNotificationRouter, } from './assistant/notification-router.js';
+import { senderFromScheduleCreator } from './assistant/job-creator.js';
+import { buildScheduleTurnMessage } from './assistant/schedule-message.js';
+import { buildScheduleTurnPrompt } from './assistant/schedule-execution.js';
 const logger = new Logger(null, 'task-executor');
-// ─────────────────────────────────────────────────────────────────────────────
-// Per-sceneId mutex lock
-// ─────────────────────────────────────────────────────────────────────────────
 const locks = new Map();
 async function withLock(sceneId, fn) {
     const prev = locks.get(sceneId) ?? Promise.resolve();
@@ -22,9 +22,6 @@ async function withLock(sceneId, fn) {
         resolve();
     }
 }
-// ─────────────────────────────────────────────────────────────────────────────
-// OutputElement[] → string
-// ─────────────────────────────────────────────────────────────────────────────
 function elementsToText(elements) {
     return elements.map(el => {
         if (el.type === 'text')
@@ -34,50 +31,108 @@ function elementsToText(elements) {
         return '';
     }).join('\n').trim();
 }
-// ─────────────────────────────────────────────────────────────────────────────
-// Factory
-// ─────────────────────────────────────────────────────────────────────────────
 export function createTaskExecutor(deps) {
-    const router = deps.router ?? createNotificationRouter({ resolveAdapter: deps.resolveAdapter });
+    const router = deps.router ?? createNotificationRouter({
+        resolveAdapter: deps.resolveAdapter,
+        sendIm: deps.deliverIm
+            ? async (notify, content) => deps.deliverIm(notify, content)
+            : undefined,
+    });
     async function executeTask(options) {
-        const { prompt, notify, timeContext } = options;
+        const { prompt, notify, timeContext, createdBy, preview, previewCommMessage, executionPlan, activityFeedback, scheduleJobId, } = options;
         const t0 = Date.now();
         const effectiveNotify = router.resolveEffectiveNotify(notify, deps.defaultNotify);
-        try {
-            let finalPrompt = prompt;
-            if (timeContext) {
-                const now = new Date();
-                const timeStr = now.toLocaleString('zh-CN', { hour12: false });
-                const weekdays = ['日', '一', '二', '三', '四', '五', '六'];
-                const weekday = weekdays[now.getDay()];
-                finalPrompt = [
-                    `[系统] 这是定时任务自动触发，当前时间: ${timeStr} 星期${weekday}`,
-                    `你的输出将被直接发送到目标聊天中，请注意：`,
-                    `- 直接输出最终内容，不要包含任何确认、进度报告或元评论（如"收到""正在执行""已完成"等）`,
-                    `- 不要使用"为您""帮你"等对话式措辞，你不是在回复某个人的请求`,
-                    `- 像一个真实的群成员一样自然发言`,
-                    ``,
-                    `任务: ${prompt}`,
-                ].join('\n');
-            }
+        const basePrompt = executionPlan?.prompt?.trim() || prompt;
+        const finalPrompt = preview
+            ? buildScheduleTurnPrompt({ basePrompt, mode: 'preview' })
+            : timeContext
+                ? buildScheduleTurnPrompt({ basePrompt, mode: 'scheduled' })
+                : basePrompt;
+        deps.agent.initScheduleTurnContext({
+            executionPlan,
+            createdBy,
+            preview: preview || undefined,
+            activityFeedback: activityFeedback || undefined,
+            jobId: scheduleJobId,
+        });
+        const emitter = deps.agent.getEventEmitter?.() ?? {
+            emit: () => { },
+            createPayload: (_sessionId, comm) => ({
+                sessionId: resolveIMSessionIdFromMessage(comm),
+                source: 'zhin-agent',
+            }),
+        };
+        let commMessage;
+        if (preview && previewCommMessage) {
+            commMessage = buildScheduleTurnMessage({ sourceMessage: previewCommMessage });
+        }
+        else {
             const im = effectiveNotify.channel === 'im' ? effectiveNotify : undefined;
-            const sceneId = im?.sceneId || 'cron';
-            const scope = im?.scope || 'private';
-            const commMessage = createSyntheticMessage({
-                adapter: im?.platform || 'cron',
-                endpoint: im?.endpointId || 'default',
-                sender: { id: 'system', name: 'system', isMaster: true },
+            const scene = im?.target.scene;
+            const sceneId = scene?.sceneId || 'cron';
+            const scope = scene?.kind || 'private';
+            const sender = createdBy
+                ? senderFromScheduleCreator(createdBy)
+                : { id: 'system', name: 'system', isMaster: true, isTrusted: false };
+            commMessage = createSyntheticMessage({
+                adapter: scene?.platform || 'cron',
+                endpoint: scene?.endpointId || 'default',
+                sender,
                 channel: { type: scope, id: sceneId },
             });
-            const elements = await withLock(sceneId, () => deps.agent.process(finalPrompt, commMessage));
+        }
+        const dispatchSchedule = (name) => {
+            if (!activityFeedback)
+                return;
+            const sessionId = resolveIMSessionIdFromMessage(commMessage);
+            emitter.emit(name, emitter.createPayload(sessionId, commMessage, 'text'));
+        };
+        const lockKey = preview
+            ? `preview:${resolveIMSessionIdFromMessage(previewCommMessage ?? commMessage)}`
+            : (commMessage.$channel?.id ?? 'cron');
+        try {
+            dispatchSchedule('schedule.start');
+            const elements = await withLock(lockKey, () => deps.agent.process(finalPrompt, commMessage));
             const text = elementsToText(elements);
+            const captured = preview && typeof deps.agent.getLastTurnToolSnapshot === 'function'
+                ? deps.agent.getLastTurnToolSnapshot()
+                : { tools: [], skills: [] };
+            const resultPlan = preview
+                ? {
+                    prompt: basePrompt,
+                    tools: captured.tools.length ? captured.tools : executionPlan?.tools,
+                    skills: captured.skills.length ? captured.skills : executionPlan?.skills,
+                    previewSample: text || undefined,
+                    previewedAt: Date.now(),
+                    confirmed: false,
+                }
+                : executionPlan;
+            if (preview) {
+                if (text && previewCommMessage && typeof previewCommMessage.$reply === 'function') {
+                    await previewCommMessage.$reply(text);
+                }
+                return {
+                    success: true,
+                    responseText: text,
+                    durationMs: Date.now() - t0,
+                    executionPlan: resultPlan,
+                };
+            }
             if (!text) {
-                return { success: true, responseText: '', durationMs: Date.now() - t0 };
+                dispatchSchedule('schedule.finish');
+                return { success: true, responseText: '', durationMs: Date.now() - t0, executionPlan: resultPlan };
+            }
+            if (deps.deliverIm && effectiveNotify.channel === 'im') {
+                await deps.deliverIm(effectiveNotify, text);
+            }
+            else {
+                await router.deliver({ notify: effectiveNotify, content: text });
             }
-            await router.deliver({ notify: effectiveNotify, content: text });
-            return { success: true, responseText: text, durationMs: Date.now() - t0 };
+            dispatchSchedule('schedule.finish');
+            return { success: true, responseText: text, durationMs: Date.now() - t0, executionPlan: resultPlan };
         }
         catch (e) {
+            dispatchSchedule('schedule.error');
             const error = e.message || String(e);
             logger.error(`[TaskExecutor] 执行失败: ${error}`);
             return { success: false, responseText: '', durationMs: Date.now() - t0, error };

package/lib/task-executor.js.map

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

package/lib/tool/context-tools.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 运行时上下文工具（session / profile），由 ToolSystem 按 turn 注入。
+ */
+import type { AgentTool, ImTranscriptQuery, ImTranscriptStore, MemoryImTranscriptStore } from '@zhin.js/ai';
+import type { UserProfileStore } from '../user-profile.js';
+type TranscriptHistoryReader = Pick<ImTranscriptStore, 'search' | 'listRecent'> | Pick<MemoryImTranscriptStore, 'search' | 'listRecent'>;
+export declare function createImTranscriptHistoryTool(store: TranscriptHistoryReader, query: ImTranscriptQuery): AgentTool;
+export declare function createUserProfileTool(userId: string, profiles: UserProfileStore): AgentTool;
+export {};
+//# sourceMappingURL=context-tools.d.ts.map

package/lib/tool/context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/tool/context-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAyB,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACnI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAqB3D,KAAK,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC;AAEzI,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,iBAAiB,GACvB,SAAS,CAwCX;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAqD3F"}