@zhin.js/agent 0.3.1 → 1.0.2

package/lib/subagent/subagent-runtime.js

@@ -0,0 +1,553 @@
+/**
+ * SubagentRuntime — 后台子任务执行管理器
+ *
+ * 职责：
+ *   1. 接收主 agent 发起的 spawn 请求，创建后台子 agent
+ *   2. 为子 agent 配备受限工具集（文件/Shell/网络，不含消息/spawn/技能）
+ *   3. 管理子 agent 生命周期（运行跟踪、完成/失败回告）
+ *   4. 完成后将结果投递回主流程，由主 agent 摘要后发送到原始频道
+ */
+import { randomUUID } from 'node:crypto';
+import { Logger } from '@zhin.js/core';
+import { formatCompact, formatCompactUsage, truncatePreview } from '@zhin.js/logger';
+import { userMessageToFilterText } from '@zhin.js/ai';
+import { ensureMcpConnectionsForBinding, getMcpToolsForBinding, } from '../orchestrator/mcp-lifecycle.js';
+import { runAgentLoopStandaloneTurn } from '../core/agent-loop-standalone.js';
+import { DEFAULT_CONFIG } from '../config/index.js';
+import { applyExecPolicyToTools } from '../security/exec-policy.js';
+import { resolveSubagentAgentTools } from '../orchestrator/resolve-subagent-tools.js';
+import { createOwnerOrchestratedToolResultTransform } from '../orchestrator/owner-confirm-orchestration.js';
+import { buildSubagentUserDelivery } from '../media/subagent-user-delivery.js';
+import { loadAgentMarkdownBody } from '../discovery/agents.js';
+const EFFORT_MAX_ITERATIONS = {
+    low: 3,
+    medium: 5,
+    high: 10,
+    max: 20,
+};
+import { resolveSubagentContextMode, resolveSubagentRole, } from '../subagent-preset.js';
+import { packageSubagentResult } from '../subagent-artifact.js';
+import { buildSubagentRolePrompt, sanitizeSubagentSystemPrompt } from '../subagent-prompt.js';
+import { notifySubagentGoal, resolveSpawnExecutionKind, resolveSubagentAgentLabel, resolveSubagentDisplayLabel, } from '../subagent-goal-notify.js';
+import { SubagentAiEventReporter } from '../subagent-ai-events.js';
+const logger = new Logger(null, 'Subagent');
+// ============================================================================
+// SubagentRuntime
+// ============================================================================
+export class SubagentRuntime {
+    provider;
+    getProviderFn;
+    resolveBindingFn;
+    getMcpRegistryFn;
+    workspace;
+    createTools;
+    maxIterations;
+    maxParallelSubagents;
+    subagentTools;
+    execPolicyConfig;
+    modelRegistry;
+    runningTasks = new Map();
+    resultSender = null;
+    onSubagentUsage;
+    registerSubagentTask;
+    agentDispatcher;
+    onEvent;
+    onSubagentCompleteFn;
+    eventEmitter;
+    resolveAgentMetaFn;
+    getParentContextSnapshotFn;
+    constructor(options) {
+        this.provider = options.provider;
+        this.getProviderFn = options.getProvider ?? null;
+        this.resolveBindingFn = options.resolveBinding ?? null;
+        this.getMcpRegistryFn = options.getMcpRegistry ?? null;
+        this.workspace = options.workspace;
+        this.createTools = options.createTools;
+        this.maxIterations = options.maxIterations ?? 15;
+        this.maxParallelSubagents = options.maxParallelSubagents ?? 5;
+        this.subagentTools = options.subagentTools || [];
+        this.execPolicyConfig = options.execPolicyConfig ?? null;
+        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;
+        this.onSubagentCompleteFn = options.onSubagentComplete ?? null;
+        this.eventEmitter = options.eventEmitter ?? null;
+        this.resolveAgentMetaFn = options.resolveAgentMeta ?? null;
+        this.getParentContextSnapshotFn = options.getParentContextSnapshot ?? null;
+    }
+    setEventEmitter(emitter) {
+        this.eventEmitter = emitter;
+    }
+    setSender(sender) {
+        this.resultSender = sender;
+    }
+    setModelRegistry(registry) {
+        this.modelRegistry = registry;
+    }
+    configureRouting(deps) {
+        if (deps.getProvider)
+            this.getProviderFn = deps.getProvider;
+        if (deps.resolveBinding)
+            this.resolveBindingFn = deps.resolveBinding;
+        if (deps.getMcpRegistry)
+            this.getMcpRegistryFn = deps.getMcpRegistry;
+        if (deps.resolveAgentMeta)
+            this.resolveAgentMetaFn = deps.resolveAgentMeta;
+        if (deps.getParentContextSnapshot)
+            this.getParentContextSnapshotFn = deps.getParentContextSnapshot;
+    }
+    async enrichSpawnOptions(options) {
+        const agentName = options.agent?.trim();
+        const meta = agentName && this.resolveAgentMetaFn
+            ? await this.resolveAgentMetaFn(agentName)
+            : null;
+        const role = options.role ?? resolveSubagentRole(meta, agentName);
+        const contextMode = resolveSubagentContextMode(meta, role, options.contextMode);
+        let systemPrompt = options.systemPrompt;
+        if (!systemPrompt && meta?.filePath) {
+            try {
+                systemPrompt = await loadAgentMarkdownBody(meta.filePath);
+            }
+            catch {
+                // ignore missing body
+            }
+        }
+        let contextPreamble = options.contextPreamble;
+        if (contextMode === 'fork' && !contextPreamble && this.getParentContextSnapshotFn) {
+            contextPreamble = await this.getParentContextSnapshotFn(options.origin);
+        }
+        return {
+            ...options,
+            role,
+            contextMode,
+            systemPrompt,
+            contextPreamble,
+            _agentMeta: meta ?? undefined,
+        };
+    }
+    /** 同步执行子 agent（入站 route 用）；返回最终文本，不经过 resultSender */
+    async spawnSync(options) {
+        const capError = this.parallelCapacityError();
+        if (capError)
+            return capError;
+        const enriched = await this.enrichSpawnOptions(options);
+        const role = enriched.role || 'subtask';
+        const displayLabel = resolveSubagentDisplayLabel(enriched.label, enriched.task);
+        const taskId = randomUUID().slice(0, 8);
+        this.trackRunningTask(taskId);
+        try {
+            if (enriched.notifyContext) {
+                await notifySubagentGoal(enriched.notifyContext, {
+                    taskId,
+                    kind: resolveSpawnExecutionKind({ sync: true }),
+                    label: displayLabel,
+                    agent: enriched.agent,
+                });
+            }
+            const result = await this.runSubagent(taskId, enriched.task, displayLabel, enriched.origin, role, enriched.context, {
+                binding: enriched.binding ?? (enriched.agent ? this.resolveBindingFn?.(enriched.agent) ?? null : null),
+                systemPrompt: enriched.systemPrompt,
+                contextPreamble: enriched.contextPreamble,
+                sync: true,
+                presetName: enriched.agent ?? enriched.label,
+                keepTypingUntilUpstreamFinish: true,
+                runInput: enriched.runInput,
+                orchestrationTaskId: enriched.orchestrationTaskId,
+                agentMeta: enriched._agentMeta,
+                requestedTools: enriched.requestedTools,
+                requestedSkills: enriched.requestedSkills,
+                parentSessionLoaded: enriched.parentSessionLoaded,
+                parentLoadedSkills: enriched.parentLoadedSkills,
+            });
+            return result ?? '任务已完成，但未生成最终响应。';
+        }
+        finally {
+            this.releaseRunningTask(taskId);
+        }
+    }
+    async spawn(options) {
+        const capError = this.parallelCapacityError();
+        if (capError)
+            return capError;
+        const enriched = await this.enrichSpawnOptions(options);
+        const taskId = randomUUID().slice(0, 8);
+        const role = enriched.role || 'subtask';
+        const displayLabel = resolveSubagentDisplayLabel(enriched.label, enriched.task);
+        if (enriched.notifyContext) {
+            await notifySubagentGoal(enriched.notifyContext, {
+                taskId,
+                kind: resolveSpawnExecutionKind({ sync: false }),
+                label: displayLabel,
+                agent: enriched.agent,
+            });
+        }
+        const abortController = new AbortController();
+        this.runningTasks.set(taskId, abortController);
+        const binding = enriched.binding ?? (enriched.agent ? this.resolveBindingFn?.(enriched.agent) ?? null : null);
+        const done = this.runSubagent(taskId, enriched.task, displayLabel, enriched.origin, role, enriched.context, {
+            binding,
+            systemPrompt: enriched.systemPrompt,
+            contextPreamble: enriched.contextPreamble,
+            presetName: enriched.agent ?? enriched.label,
+            orchestrationTaskId: enriched.orchestrationTaskId,
+            agentMeta: enriched._agentMeta,
+            requestedTools: enriched.requestedTools,
+            requestedSkills: enriched.requestedSkills,
+            parentSessionLoaded: enriched.parentSessionLoaded,
+            parentLoadedSkills: enriched.parentLoadedSkills,
+        })
+            .then(() => undefined)
+            .catch((error) => {
+            logger.error({ error, taskId }, 'Subagent failed');
+        })
+            .finally(() => {
+            this.runningTasks.delete(taskId);
+        });
+        this.registerSubagentTask?.(done);
+        logger.info(formatCompact({
+            subagent: 'spawn',
+            task_id: taskId,
+            label: displayLabel,
+            agent: resolveSubagentAgentLabel(enriched.agent),
+            role,
+            task: truncatePreview(enriched.task, 300),
+        }));
+        void this.onEvent?.({
+            phase: 'spawn',
+            taskId,
+            label: displayLabel,
+            task: enriched.task,
+            origin: enriched.origin,
+            role,
+            agent: enriched.agent,
+        });
+        return `子任务 [${displayLabel}] 已启动 (id: ${taskId})，完成后会自动通知你。`;
+    }
+    getRunningCount() {
+        return this.runningTasks.size;
+    }
+    cancel(taskId) {
+        const controller = this.runningTasks.get(taskId);
+        if (!controller)
+            return false;
+        try {
+            controller.abort();
+        }
+        catch {
+            // ignore
+        }
+        this.runningTasks.delete(taskId);
+        return true;
+    }
+    parallelCapacityError() {
+        const running = this.getRunningCount();
+        if (running >= this.maxParallelSubagents) {
+            return (`并行子代理已达上限 (${running}/${this.maxParallelSubagents})。`
+                + '请等待已有任务完成，或拆分批次后再 spawn。');
+        }
+        return undefined;
+    }
+    trackRunningTask(taskId) {
+        this.runningTasks.set(taskId, new AbortController());
+    }
+    releaseRunningTask(taskId) {
+        this.runningTasks.delete(taskId);
+    }
+    // ── 内部方法 ──────────────────────────────────────────────────────
+    async runSubagent(taskId, task, label, origin, role = 'subtask', context, opts) {
+        const startedAt = Date.now();
+        const agentUserInput = opts?.runInput ?? task;
+        const inputKind = typeof agentUserInput === 'string' ? 'text' : `parts:${agentUserInput.length}`;
+        logger.info(formatCompact({
+            subagent: 'start',
+            task_id: taskId,
+            label,
+            agent: resolveSubagentAgentLabel(opts?.presetName),
+            role,
+            input: inputKind,
+            task_preview: truncatePreview(typeof agentUserInput === 'string' ? agentUserInput : userMessageToFilterText(agentUserInput), 120),
+        }));
+        logger.debug(formatCompact({ task_id: taskId, label, role }));
+        const aiEvents = this.eventEmitter
+            ? new SubagentAiEventReporter(this.eventEmitter, {
+                taskId,
+                label,
+                presetName: opts?.presetName,
+                origin,
+                keepTypingUntilUpstreamFinish: opts?.keepTypingUntilUpstreamFinish,
+            })
+            : null;
+        if (aiEvents) {
+            await aiEvents.processingStart(task);
+        }
+        await this.onEvent?.({
+            phase: 'start',
+            taskId,
+            label,
+            task,
+            origin,
+            role,
+            agent: opts?.presetName,
+        });
+        let dispatcherTaskId = opts?.orchestrationTaskId;
+        const isOrchestrationTask = !!opts?.orchestrationTaskId;
+        const binding = opts?.binding ?? null;
+        const provider = binding && this.getProviderFn
+            ? this.getProviderFn(binding.providerAlias)
+            : this.provider;
+        try {
+            let allTools = this.createTools();
+            const mcps = this.getMcpRegistryFn?.() ?? null;
+            if (mcps && binding?.mcpServers?.length) {
+                if (aiEvents) {
+                    await aiEvents.ensureMcpForBinding(mcps, binding.mcpServers);
+                }
+                else {
+                    await ensureMcpConnectionsForBinding(mcps, binding.mcpServers);
+                }
+                allTools = [...allTools, ...getMcpToolsForBinding(mcps, binding.mcpServers)];
+            }
+            let tools = resolveSubagentAgentTools({
+                allTools,
+                task,
+                role,
+                config: (this.execPolicyConfig ?? DEFAULT_CONFIG),
+                agentDispatcher: this.agentDispatcher,
+                agentMeta: opts?.agentMeta,
+                requestedTools: opts?.requestedTools,
+                parentSessionLoaded: opts?.parentSessionLoaded,
+            });
+            if (this.execPolicyConfig) {
+                tools = applyExecPolicyToTools(this.execPolicyConfig, tools, {
+                    approvalMode: this.execPolicyConfig.subagentExecApprovalMode,
+                });
+            }
+            let systemPrompt = opts?.systemPrompt;
+            if (!systemPrompt) {
+                if (this.agentDispatcher && isOrchestrationTask && dispatcherTaskId) {
+                    const taskDef = this.agentDispatcher.getTask(dispatcherTaskId);
+                    if (taskDef) {
+                        systemPrompt = buildSubagentRolePrompt(this.agentDispatcher, taskDef.role, taskDef);
+                    }
+                }
+                if (!systemPrompt && this.agentDispatcher) {
+                    const taskDef = this.agentDispatcher.createTask({
+                        name: label,
+                        description: task,
+                        role,
+                        goal: task,
+                        priority: 'medium',
+                        context,
+                    });
+                    if (!isOrchestrationTask)
+                        dispatcherTaskId = taskDef.id;
+                    systemPrompt = buildSubagentRolePrompt(this.agentDispatcher, role, taskDef);
+                }
+                else if (!systemPrompt) {
+                    systemPrompt = this.buildSubagentPrompt(task);
+                }
+            }
+            else {
+                systemPrompt = sanitizeSubagentSystemPrompt(systemPrompt);
+            }
+            if (isOrchestrationTask && dispatcherTaskId && this.agentDispatcher) {
+                this.agentDispatcher.markRunning(dispatcherTaskId, new Promise(() => { }));
+            }
+            if (opts?.contextPreamble?.trim()) {
+                systemPrompt = `${systemPrompt}\n\n## Parent session context (fork)\n${opts.contextPreamble.trim()}`;
+            }
+            const model = binding?.model || provider.models[0];
+            const bashCommMessage = origin.message;
+            await aiEvents?.agentStart(model);
+            const effortIterations = opts?.agentMeta?.effort
+                ? EFFORT_MAX_ITERATIONS[opts.agentMeta.effort]
+                : undefined;
+            const result = await runAgentLoopStandaloneTurn({
+                provider,
+                resolveProvider: this.getProviderFn ?? undefined,
+                model,
+                systemPrompt,
+                tools,
+                userInput: agentUserInput,
+                maxIterations: effortIterations ?? this.maxIterations,
+                commMessage: bashCommMessage,
+                transformToolResult: createOwnerOrchestratedToolResultTransform({
+                    commMessage: bashCommMessage,
+                    disableHardOrchestration: true,
+                }),
+                callbacks: aiEvents?.createAgentLoopCallbacks(model),
+            });
+            this.onSubagentUsage?.(result.usage);
+            const rawResult = result.content || '任务已完成，但未生成最终响应。';
+            const packaged = packageSubagentResult(rawResult, taskId);
+            const finalResult = packaged.text;
+            await aiEvents?.agentFinish(result.model ?? model, result.iterations);
+            await aiEvents?.response(finalResult, result.model ?? model, result.iterations);
+            logger.info(formatCompact({
+                subagent: 'done',
+                task_id: taskId,
+                label,
+                agent: resolveSubagentAgentLabel(opts?.presetName),
+                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,
+                agent: opts?.presetName,
+                status: 'ok',
+                result: finalResult,
+            });
+            await aiEvents?.processingFinish(finalResult, {
+                model: result.model ?? model,
+                iterations: result.iterations,
+                status: 'ok',
+            });
+            if (opts?.sync)
+                return finalResult;
+            await this.deliverAsyncResult({
+                taskId,
+                label,
+                task,
+                origin,
+                status: 'ok',
+                result: finalResult,
+                toolCalls: result.toolCalls,
+                agent: opts?.presetName,
+            });
+            return;
+        }
+        catch (error) {
+            const errorMsg = `Error: ${error instanceof Error ? error.message : String(error)}`;
+            await aiEvents?.processingError(errorMsg);
+            logger.error({ taskId, error }, 'Subagent failed');
+            logger.info(formatCompact({
+                subagent: 'done',
+                task_id: taskId,
+                label,
+                agent: resolveSubagentAgentLabel(opts?.presetName),
+                ok: false,
+                error: truncatePreview(errorMsg, 300),
+            }));
+            await this.onEvent?.({
+                phase: 'finish',
+                taskId,
+                label,
+                task,
+                origin,
+                role,
+                agent: opts?.presetName,
+                status: 'error',
+                error: errorMsg,
+            });
+            if (opts?.sync)
+                return errorMsg;
+            await this.deliverAsyncResult({
+                taskId,
+                label,
+                task,
+                origin,
+                status: 'error',
+                result: errorMsg,
+                toolCalls: [],
+                agent: opts?.presetName,
+            });
+        }
+        finally {
+            if (isOrchestrationTask && dispatcherTaskId && this.agentDispatcher) {
+                this.agentDispatcher.releaseRunning(dispatcherTaskId);
+            }
+            if (this.agentDispatcher && dispatcherTaskId && !isOrchestrationTask) {
+                this.agentDispatcher.releaseTask(dispatcherTaskId);
+            }
+        }
+        return;
+    }
+    async deliverAsyncResult(payload) {
+        if (this.onSubagentCompleteFn) {
+            try {
+                await this.onSubagentCompleteFn(payload);
+            }
+            catch (error) {
+                logger.error({ taskId: payload.taskId, error }, 'onSubagentComplete failed');
+            }
+        }
+        else {
+            logger.warn(formatCompact({ task_id: payload.taskId, error: 'no_onSubagentComplete' }));
+        }
+        if (!this.resultSender)
+            return;
+        const delivery = {
+            ...buildSubagentUserDelivery({
+                label: payload.label,
+                status: payload.status,
+                result: payload.result,
+                toolCalls: payload.toolCalls,
+            }),
+            taskId: payload.taskId,
+            status: payload.status,
+        };
+        try {
+            await this.resultSender(payload.origin, delivery);
+            logger.debug({
+                taskId: payload.taskId,
+                origin: payload.origin,
+                tool_calls: payload.toolCalls.length,
+            }, 'Subagent direct IM delivery');
+        }
+        catch (error) {
+            logger.error({ taskId: payload.taskId, error }, 'Subagent direct IM delivery failed');
+        }
+    }
+    buildSubagentPrompt(task) {
+        return `# Sub-task Agent
+
+You are a sub-agent spawned by the main agent to perform a specific task.
+
+## Your task
+${task}
+
+## Rules
+1. Focus only on the assigned task
+2. Your final reply will be reported to the main agent and relayed to the user
+3. Do not start new conversations or take on extra tasks
+4. Keep replies concise but informative
+5. Never claim success unless tool results confirm it
+6. Do not fabricate tool outputs or execution status
+
+## You may
+- Read/write files in the workspace
+- Run shell commands (no Owner online approval in this sub-agent; deny/dangerous rules still apply)
+- Search and fetch the web
+- Complete the task thoroughly
+
+## You must not
+- Send messages directly to the user
+- Spawn further sub-tasks or delegate to other agents
+- Use orchestration tools (spawn_task, discover, install_skill)
+
+## Workspace
+Workspace path: ${this.workspace}
+
+When done, provide a clear summary of findings or actions.`;
+    }
+    dispose() {
+        for (const [taskId, controller] of this.runningTasks.entries()) {
+            try {
+                controller.abort();
+            }
+            catch { /* ignore */ }
+        }
+        this.runningTasks.clear();
+    }
+}
+//# sourceMappingURL=subagent-runtime.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { AgentTool, ModelRegistry, AIProvider } from '@zhin.js/ai';
+import type { ZhinAgentEventEmitter } from '../event/event-emitter.js';
+import type { ZhinAgentConfig } from '../config/index.js';
+import { SubagentSystem } from './subagent-system.js';
+import type { SubagentCompletePayload } from './subagent-runtime.js';
+export interface SubagentSystemInitOptions {
+    provider: AIProvider;
+    config: Required<ZhinAgentConfig>;
+    modelRegistry: ModelRegistry | null;
+    emitter: ZhinAgentEventEmitter;
+    createTools: () => AgentTool[];
+    onSubagentComplete: (payload: SubagentCompletePayload) => Promise<void>;
+}
+export declare function createSubagentSystem(opts: SubagentSystemInitOptions): SubagentSystem;
+//# sourceMappingURL=subagent-system-init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-system-init.d.ts","sourceRoot":"","sources":["../../src/subagent/subagent-system-init.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAClC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,WAAW,EAAE,MAAM,SAAS,EAAE,CAAC;IAC/B,kBAAkB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,cAAc,CA2CpF"}

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

@@ -0,0 +1,53 @@
+import { formatCompact, Logger } from '@zhin.js/logger';
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { getAgentDispatcher } from '../orchestrator/agent-dispatcher.js';
+import { getActiveTurnTracker } from '../internal/turn-context.js';
+import { SubagentSystem } from './subagent-system.js';
+const logger = new Logger(null, 'ZhinAgent');
+export function createSubagentSystem(opts) {
+    const system = new SubagentSystem();
+    system.attachRuntime({
+        provider: opts.provider,
+        workspace: process.cwd(),
+        createTools: opts.createTools,
+        subagentTools: opts.config.subagentTools,
+        maxIterations: opts.config.maxSubagentIterations,
+        maxParallelSubagents: opts.config.maxParallelSubagents,
+        execPolicyConfig: opts.config,
+        modelRegistry: opts.modelRegistry,
+        agentDispatcher: getAgentDispatcher(),
+        onSubagentUsage: (usage) => getActiveTurnTracker()?.addSubagentUsage(usage),
+        registerSubagentTask: (done) => getActiveTurnTracker()?.trackSubagent(done),
+        eventEmitter: opts.emitter,
+        onEvent: (event) => {
+            const sessionId = resolveIMSessionIdFromMessage(event.origin.message);
+            const payload = opts.emitter.createPayload(sessionId, event.origin.message, 'text', {
+                source: 'subagent',
+                path: 'agent',
+                taskId: event.taskId,
+                label: event.label,
+                content: event.task,
+                status: event.status,
+                error: event.error,
+                reply: event.result,
+                agentId: event.agent,
+                hookContext: {
+                    subagentAgent: event.agent,
+                },
+            });
+            if (event.phase === 'spawn') {
+                opts.emitter.emit('ai.subagent.spawn', payload);
+            }
+            else if (event.phase === 'start') {
+                opts.emitter.emit('ai.subagent.start', payload);
+            }
+            else {
+                opts.emitter.emit('ai.subagent.finish', payload);
+            }
+        },
+        onSubagentComplete: opts.onSubagentComplete,
+    });
+    logger.debug(formatCompact({ subagent_system: 'initialized' }));
+    return system;
+}
+//# sourceMappingURL=subagent-system-init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-system-init.js","sourceRoot":"","sources":["../../src/subagent/subagent-system-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAW7C,MAAM,UAAU,oBAAoB,CAAC,IAA+B;IAClE,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IACpC,MAAM,CAAC,aAAa,CAAC;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE;QACxB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;QACxC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,qBAAqB;QAChD,oBAAoB,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB;QACtD,gBAAgB,EAAE,IAAI,CAAC,MAAM;QAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,eAAe,EAAE,kBAAkB,EAAE;QACrC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,EAAE,EAAE,gBAAgB,CAAC,KAAK,CAAC;QAC3E,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC;QAC3E,YAAY,EAAE,IAAI,CAAC,OAAO;QAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,MAAM,SAAS,GAAG,6BAA6B,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE;gBAClF,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,IAAI;gBACnB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,OAAO,EAAE,KAAK,CAAC,KAAK;gBACpB,WAAW,EAAE;oBACX,aAAa,EAAE,KAAK,CAAC,KAAK;iBAC3B;aACF,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;iBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;KAC5C,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC;AAChB,CAAC"}