@agntk/core 0.3.5 → 1.1.0

package/dist/tools/spawn-agent/index.js

@@ -1,160 +1,273 @@
-/**
- * @agntk/core - Spawn Agent Tool
- * Tool for spawning sub-agents with streaming output
- */
 import { generateId, generateText } from 'ai';
 import { z } from 'zod';
-import { getSubAgentConfig, subAgentRoles } from '../../presets/sub-agent-configs.js';
+import { createLogger } from '@agntk/logger';
 import { resolveModel } from '../../models.js';
-const DESCRIPTION = `Spawn a sub-agent for a specific task.
+const log = createLogger('@agntk/core:spawn-agent');
+const DESCRIPTION = `Spawn a sub-agent to work on a specific task.
 
-Use this tool when you need to delegate complex work that requires:
-- Independent reasoning and decision-making
-- Specialized role focus (coder, researcher, analyst)
-- Autonomous task completion
+Use this tool to delegate work that benefits from:
+- Independent, focused execution
+- Parallel processing (use async: true)
+- Isolated workspace for intermediate results
 
-The sub-agent will work independently and stream its output. You will receive a summary of the results.
+The sub-agent works autonomously and writes its output to a workspace directory.
+You receive a summary and can read the full output from the workspace path.
 
-Roles:
-- coder: Code implementation specialist - best for writing, refactoring, debugging code
-- researcher: Research specialist - best for gathering and synthesizing information
-- analyst: Analysis specialist - best for data analysis and insights
-- generic: General-purpose (default)
+Parameters:
+- task (required): Clear description of what the sub-agent should accomplish
+- context: Background information the sub-agent needs
+- async: Set to true to run in background (use check_agent to poll)
+- model: Override model tier ('fast', 'standard', 'reasoning')
 
-Note: Sub-agents cannot spawn their own sub-agents (prevents infinite recursion).`;
+When async is false (default), this tool blocks until the sub-agent completes.
+When async is true, it returns immediately with an agentId for polling.`;
 export const spawnAgentParametersSchema = z.object({
-    task: z.string().describe('The task for the sub-agent to accomplish'),
-    role: z.enum(subAgentRoles).default('generic').describe('The specialized role for the sub-agent'),
-    context: z.string().optional().describe('Additional context to provide to the sub-agent'),
+    task: z.string().describe('Clear description of what the sub-agent should accomplish'),
+    context: z.string().optional().describe('Background information the sub-agent needs'),
+    async: z
+        .boolean()
+        .default(false)
+        .describe('If true, run in background and return immediately with agentId'),
+    model: z
+        .enum(['fast', 'standard', 'reasoning'])
+        .optional()
+        .describe('Model tier override (default: inherit parent)'),
 });
-/**
- * Execute function for spawn agent tool
- */
+export function generateAgentId(task) {
+    const slug = task
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .slice(0, 3)
+        .join('-');
+    const suffix = generateId().slice(0, 4);
+    return `${slug || 'agent'}-${suffix}`;
+}
 async function executeSpawnAgent(input, options) {
-    const { maxSpawnDepth = 1, currentDepth = 0, createAgent, onStream, } = options;
-    const { task, role, context } = input;
-    // Prevent spawning if at max depth or no factory
+    const { maxSpawnDepth = 2, currentDepth = 0, createAgent, registry, workspacePath, onStream, onActivity, } = options;
+    const { task, context, model: modelTier } = input;
+    const isAsync = input.async;
     if (currentDepth >= maxSpawnDepth) {
         return {
             success: false,
+            agentId: '',
+            workspacePath: '',
             error: 'Maximum spawn depth reached. Sub-agents cannot spawn further sub-agents.',
-            suggestion: 'Complete this task directly instead of delegating.',
+            errorType: 'depth_exceeded',
+            message: 'Complete this task directly instead of delegating.',
         };
     }
     if (!createAgent) {
         return {
             success: false,
+            agentId: '',
+            workspacePath: '',
             error: 'Agent factory not configured. Sub-agent spawning is disabled.',
         };
     }
-    const agentId = generateId();
-    const roleConfig = getSubAgentConfig(role);
-    // Build the sub-agent prompt
-    const fullPrompt = context
-        ? `Context:\n${context}\n\nTask:\n${task}`
-        : task;
-    // Stream start event
-    if (onStream) {
-        onStream({
-            type: 'sub-agent-stream',
-            agentId,
-            role,
-            text: '',
-            status: 'streaming',
+    const agentId = generateAgentId(task);
+    const agentWorkspacePath = workspacePath ? `${workspacePath}/${agentId}` : agentId;
+    log.info('Spawning sub-agent', { agentId, task: task.slice(0, 80), async: isAsync });
+    const registryEntry = {
+        agentId,
+        task,
+        status: 'running',
+        workspacePath: agentWorkspacePath,
+        startedAt: new Date().toISOString(),
+    };
+    if (registry) {
+        await registry.register(registryEntry);
+    }
+    const instructions = buildSubAgentInstructions(task, agentWorkspacePath);
+    const fullPrompt = context ? `Context:\n${context}\n\nTask:\n${task}` : task;
+    const subAgent = createAgent({
+        task,
+        instructions,
+        workspacePath: agentWorkspacePath,
+        model: modelTier,
+    });
+    if (isAsync) {
+        runSubAgentInBackground(subAgent, fullPrompt, agentId, task, agentWorkspacePath, registry ?? null, onStream ?? null, onActivity ?? null).catch((err) => {
+            log.error('Background sub-agent failed', {
+                agentId,
+                error: err instanceof Error ? err.message : String(err),
+            });
         });
+        return {
+            success: true,
+            agentId,
+            workspacePath: agentWorkspacePath,
+            status: 'running',
+            message: `Sub-agent "${agentId}" started in background. Use check_agent to poll status.`,
+        };
+    }
+    return runSubAgentSync(subAgent, fullPrompt, agentId, task, agentWorkspacePath, registry ?? null, onStream ?? null, onActivity ?? null);
+}
+async function runSubAgentSync(subAgent, prompt, agentId, task, agentWorkspacePath, registry, onStream, onActivity) {
+    if (onStream) {
+        onStream({ type: 'sub-agent-stream', agentId, text: '', status: 'streaming' });
     }
     try {
-        // Create and run the sub-agent
-        const subAgent = createAgent({
-            role,
-            instructions: roleConfig.instructions,
-        });
-        const stream = subAgent.stream({ prompt: fullPrompt });
-        // Stream sub-agent output
+        const stream = subAgent.stream({ prompt });
         for await (const chunk of stream.fullStream) {
+            if (onActivity) {
+                onActivity({ type: 'sub-agent-activity', agentId, task, chunk });
+            }
             if (chunk.type === 'text-delta' && chunk.text) {
                 if (onStream) {
-                    onStream({
-                        type: 'sub-agent-stream',
-                        agentId,
-                        role,
-                        text: chunk.text,
-                        status: 'streaming',
-                    });
+                    onStream({ type: 'sub-agent-stream', agentId, text: chunk.text, status: 'streaming' });
                 }
             }
         }
-        // Get final result
         const result = await stream.text;
-        // Stream completion event
         if (onStream) {
-            onStream({
-                type: 'sub-agent-stream',
-                agentId,
-                role,
-                text: result,
-                status: 'complete',
+            onStream({ type: 'sub-agent-stream', agentId, text: result, status: 'complete' });
+        }
+        const summary = await extractSummary(result, task);
+        if (registry) {
+            await registry.update(agentId, {
+                status: 'completed',
+                completedAt: new Date().toISOString(),
+                summary,
             });
         }
-        // Extract semantic summary using LLM instead of blind truncation
-        const summary = await extractSummary(result, role, task);
         return {
             success: true,
             agentId,
-            role,
             summary,
-            message: `Sub-agent (${role}) completed the task.`,
+            workspacePath: agentWorkspacePath,
+            message: `Sub-agent "${agentId}" completed the task. Full output at ${agentWorkspacePath}`,
         };
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-        // Stream error event
+        const errorType = classifyError(error);
         if (onStream) {
             onStream({
                 type: 'sub-agent-stream',
                 agentId,
-                role,
                 text: `Error: ${errorMessage}`,
                 status: 'complete',
             });
         }
+        if (registry) {
+            await registry.update(agentId, {
+                status: 'failed',
+                completedAt: new Date().toISOString(),
+                error: errorMessage,
+                errorType,
+            });
+        }
         return {
             success: false,
             agentId,
-            role,
+            workspacePath: agentWorkspacePath,
             error: errorMessage,
+            errorType,
         };
     }
 }
-/**
- * Extract a semantic summary from sub-agent output using a fast model.
- * Falls back to first 500 chars if the summarization call fails.
- */
-async function extractSummary(fullOutput, role, originalTask) {
-    // Short outputs don't need summarization
+async function runSubAgentInBackground(subAgent, prompt, agentId, task, agentWorkspacePath, registry, onStream, onActivity) {
+    try {
+        const stream = subAgent.stream({ prompt });
+        for await (const chunk of stream.fullStream) {
+            if (onActivity) {
+                onActivity({ type: 'sub-agent-activity', agentId, task, chunk });
+            }
+            if (chunk.type === 'text-delta' && chunk.text && onStream) {
+                onStream({ type: 'sub-agent-stream', agentId, text: chunk.text, status: 'streaming' });
+            }
+        }
+        const result = await stream.text;
+        if (onStream) {
+            onStream({ type: 'sub-agent-stream', agentId, text: result, status: 'complete' });
+        }
+        const summary = await extractSummary(result, task);
+        if (registry) {
+            await registry.update(agentId, {
+                status: 'completed',
+                completedAt: new Date().toISOString(),
+                summary,
+            });
+        }
+        log.info('Background sub-agent completed', { agentId });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        const errorType = classifyError(error);
+        if (onStream) {
+            onStream({
+                type: 'sub-agent-stream',
+                agentId,
+                text: `Error: ${errorMessage}`,
+                status: 'complete',
+            });
+        }
+        if (registry) {
+            await registry.update(agentId, {
+                status: 'failed',
+                completedAt: new Date().toISOString(),
+                error: errorMessage,
+                errorType,
+            });
+        }
+        log.error('Background sub-agent failed', { agentId, error: errorMessage, errorType });
+    }
+}
+function buildSubAgentInstructions(task, workspacePath) {
+    return `You are a sub-agent working on a specific task. Focus exclusively on this task and produce thorough results.
+
+Your workspace directory is: ${workspacePath}
+Write your output, notes, and intermediate results to this directory.
+
+When you finish:
+1. Write a clear summary of what you accomplished
+2. Note any issues encountered or decisions made
+3. Save detailed results to your workspace directory
+
+Task: ${task}`;
+}
+async function extractSummary(fullOutput, originalTask) {
     if (fullOutput.length <= 500) {
         return fullOutput;
     }
     try {
         const { text } = await generateText({
-            model: resolveModel({ tier: 'fast' }),
-            system: `You are summarizing the output of a sub-agent (role: ${role}). Write a clear, actionable summary that captures the key findings, decisions, and results. Be concise but preserve critical details.`,
+            model: resolveModel({ tier: 'fast' }).model,
+            system: `You are summarizing the output of a sub-agent. Write a clear, actionable summary that captures key findings, decisions, and results. Be concise but preserve critical details.`,
             prompt: `Original task: ${originalTask}\n\nSub-agent output:\n${fullOutput}`,
             maxRetries: 1,
         });
         return text;
     }
-    catch (_e) {
-        // Fallback: return the beginning of the output if summarization fails
+    catch {
         return `${fullOutput.slice(0, 500)}...\n[Summary extraction failed, showing first 500 chars]`;
     }
 }
-/**
- * Creates a spawn agent tool definition for use with AI SDK
- *
- * @param options - Spawn options including depth limits, agent factory, and stream callback
- * @returns Tool definition object compatible with AI SDK
- */
+function classifyError(error) {
+    if (!(error instanceof Error))
+        return 'task_failed';
+    const msg = error.message.toLowerCase();
+    if (msg.includes('timeout') || msg.includes('step limit') || msg.includes('max steps')) {
+        return 'timeout';
+    }
+    if (msg.includes('rate limit') ||
+        msg.includes('401') ||
+        msg.includes('403') ||
+        msg.includes('429') ||
+        msg.includes('api') ||
+        msg.includes('network') ||
+        msg.includes('fetch failed') ||
+        msg.includes('econnrefused')) {
+        return 'api_error';
+    }
+    if (msg.includes('depth') || msg.includes('recursion')) {
+        return 'depth_exceeded';
+    }
+    return 'task_failed';
+}
 export function createSpawnAgentTool(options = {}) {
     return {
         description: DESCRIPTION,

package/dist/tools/spawn-agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/spawn-agent/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA2C5C,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;kFAe8D,CAAC;AAEnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACrE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACjG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAC1F,CAAC,CAAC;AAcH;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAC9B,KAAsB,EACtB,OAA0B;IAE1B,MAAM,EACJ,aAAa,GAAG,CAAC,EACjB,YAAY,GAAG,CAAC,EAChB,WAAW,EACX,QAAQ,GACT,GAAG,OAAO,CAAC;IAEZ,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAEtC,iDAAiD;IACjD,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,0EAA0E;YACjF,UAAU,EAAE,oDAAoD;SACjE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,+DAA+D;SACvE,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE3C,6BAA6B;IAC7B,MAAM,UAAU,GAAG,OAAO;QACxB,CAAC,CAAC,aAAa,OAAO,cAAc,IAAI,EAAE;QAC1C,CAAC,CAAC,IAAI,CAAC;IAET,qBAAqB;IACrB,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC;YACP,IAAI,EAAE,kBAAkB;YACxB,OAAO;YACP,IAAI;YACJ,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACH,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,WAAW,CAAC;YAC3B,IAAI;YACJ,YAAY,EAAE,UAAU,CAAC,YAAY;SACtC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEvD,0BAA0B;QAC1B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC9C,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,CAAC;wBACP,IAAI,EAAE,kBAAkB;wBACxB,OAAO;wBACP,IAAI;wBACJ,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,MAAM,EAAE,WAAW;qBACpB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAEjC,0BAA0B;QAC1B,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC;gBACP,IAAI,EAAE,kBAAkB;gBACxB,OAAO;gBACP,IAAI;gBACJ,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC;QAED,iEAAiE;QACjE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAEzD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI;YACJ,OAAO;YACP,OAAO,EAAE,cAAc,IAAI,uBAAuB;SACnD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAE9E,qBAAqB;QACrB,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC;gBACP,IAAI,EAAE,kBAAkB;gBACxB,OAAO;gBACP,IAAI;gBACJ,IAAI,EAAE,UAAU,YAAY,EAAE;gBAC9B,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO;YACP,IAAI;YACJ,KAAK,EAAE,YAAY;SACpB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAC3B,UAAkB,EAClB,IAAY,EACZ,YAAoB;IAEpB,yCAAyC;IACzC,IAAI,UAAU,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC;YAClC,KAAK,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YACrC,MAAM,EAAE,wDAAwD,IAAI,wIAAwI;YAC5M,MAAM,EAAE,kBAAkB,YAAY,0BAA0B,UAAU,EAAE;YAC5E,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,EAAW,EAAE,CAAC;QACrB,sEAAsE;QACtE,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,2DAA2D,CAAC;IAChG,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAA6B,EAAE;IAClE,OAAO;QACL,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,CAAC,KAAsB,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/spawn-agent/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/spawn-agent/registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Sub-agent registry and persistence.
+ * Tracks the status, task, and lifecycle of all spawned agents.
+ * Provides methods for registering, updating, and persisting sub-agent metadata to disk.
+ */
+export type AgentStatus = 'running' | 'completed' | 'failed';
+export type SpawnErrorType = 'timeout' | 'api_error' | 'depth_exceeded' | 'task_failed';
+export interface AgentRegistryEntry {
+    agentId: string;
+    task: string;
+    status: AgentStatus;
+    workspacePath: string;
+    startedAt: string;
+    completedAt?: string;
+    summary?: string;
+    error?: string;
+    errorType?: SpawnErrorType;
+    tokenUsage?: {
+        input: number;
+        output: number;
+    };
+}
+export declare class AgentRegistry {
+    private readonly agents;
+    private persistPath;
+    setPersistPath(path: string): void;
+    register(entry: AgentRegistryEntry): Promise<void>;
+    update(agentId: string, updates: Partial<AgentRegistryEntry>): Promise<void>;
+    get(agentId: string): AgentRegistryEntry | undefined;
+    getAll(statusFilter?: AgentStatus): AgentRegistryEntry[];
+    hasRunning(): boolean;
+    getCounts(): Record<AgentStatus, number>;
+    private persist;
+    loadFromDisk(path: string): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/spawn-agent/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tools/spawn-agent/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAExF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,WAAW,CAAuB;IAE1C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlF,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIpD,MAAM,CAAC,YAAY,CAAC,EAAE,WAAW,GAAG,kBAAkB,EAAE;IAQxD,UAAU,IAAI,OAAO;IAIrB,SAAS,IAAI,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC;YAQ1B,OAAO;IAkBf,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBhD"}

package/dist/tools/spawn-agent/registry.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Sub-agent registry and persistence.
+ * Tracks the status, task, and lifecycle of all spawned agents.
+ * Provides methods for registering, updating, and persisting sub-agent metadata to disk.
+ */
+import { writeFile, readFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:agent-registry');
+export class AgentRegistry {
+    agents = new Map();
+    persistPath = null;
+    setPersistPath(path) {
+        this.persistPath = path;
+    }
+    async register(entry) {
+        this.agents.set(entry.agentId, entry);
+        log.debug('Agent registered', { agentId: entry.agentId, task: entry.task.slice(0, 50) });
+        await this.persist();
+    }
+    async update(agentId, updates) {
+        const entry = this.agents.get(agentId);
+        if (!entry) {
+            log.warn('Attempted to update non-existent agent', { agentId });
+            return;
+        }
+        Object.assign(entry, updates);
+        log.debug('Agent updated', { agentId, status: entry.status });
+        await this.persist();
+    }
+    get(agentId) {
+        return this.agents.get(agentId);
+    }
+    getAll(statusFilter) {
+        const entries = Array.from(this.agents.values());
+        if (statusFilter) {
+            return entries.filter((e) => e.status === statusFilter);
+        }
+        return entries;
+    }
+    hasRunning() {
+        return Array.from(this.agents.values()).some((e) => e.status === 'running');
+    }
+    getCounts() {
+        const counts = { running: 0, completed: 0, failed: 0 };
+        for (const entry of this.agents.values()) {
+            counts[entry.status]++;
+        }
+        return counts;
+    }
+    async persist() {
+        if (!this.persistPath)
+            return;
+        try {
+            const dir = dirname(this.persistPath);
+            if (!existsSync(dir)) {
+                await mkdir(dir, { recursive: true });
+            }
+            const data = JSON.stringify(Array.from(this.agents.values()), null, 2);
+            await writeFile(this.persistPath, data, 'utf-8');
+        }
+        catch (err) {
+            log.warn('Registry persist failed', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    async loadFromDisk(path) {
+        this.persistPath = path;
+        if (!existsSync(path))
+            return;
+        try {
+            const data = await readFile(path, 'utf-8');
+            const entries = JSON.parse(data);
+            for (const entry of entries) {
+                this.agents.set(entry.agentId, entry);
+            }
+            log.info('Registry loaded from disk', { count: entries.length, path });
+        }
+        catch (err) {
+            log.warn('Registry load failed', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/spawn-agent/registry.js.map

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

package/dist/tools/utils/errors.d.ts

@@ -1,5 +1,6 @@
 /**
- * Tool Error utilities
+ * @fileoverview Tool execution error handling.
+ * Provides specialized error classes and types for common tool failures.
  */
 export declare enum ToolErrorType {
     COMMAND_BLOCKED = "COMMAND_BLOCKED",

package/dist/tools/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,aAAa;IACvB,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB;AAED,qBAAa,SAAU,SAAQ,KAAK;aAGhB,IAAI,EAAE,aAAa;aACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAMnD,MAAM;;;;;CAOP"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,aAAa;IACvB,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB;AAED,qBAAa,SAAU,SAAQ,KAAK;aAGhB,IAAI,EAAE,aAAa;aACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAMnD,MAAM;;;;;CAOP"}

package/dist/tools/utils/errors.js

@@ -1,5 +1,6 @@
 /**
- * Tool Error utilities
+ * @fileoverview Tool execution error handling.
+ * Provides specialized error classes and types for common tool failures.
  */
 export var ToolErrorType;
 (function (ToolErrorType) {

package/dist/tools/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/tools/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,oDAAmC,CAAA;IACnC,wDAAuC,CAAA;IACvC,sDAAqC,CAAA;IACrC,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;AACzB,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IACA;IAHlB,YACE,OAAe,EACC,IAAmB,EACnB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAe;QACnB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/tools/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,oDAAmC,CAAA;IACnC,wDAAuC,CAAA;IACvC,sDAAqC,CAAA;IACrC,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;AACzB,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IACA;IAHlB,YACE,OAAe,EACC,IAAmB,EACnB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAe;QACnB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/utils/shell.d.ts

@@ -1,17 +1,6 @@
 export declare function isDangerousCommand(command: string): boolean;
-/**
- * Ensure the requested cwd is within workspaceRoot (or is workspaceRoot itself).
- * Returns the resolved cwd, or throws if the path escapes the workspace.
- */
 export declare function validateCwd(cwd: string, workspaceRoot: string): string;
-/**
- * Build a sanitized copy of process.env suitable for child processes.
- * Strips all credential-like keys; always preserves PATH, HOME, USER, TERM, LANG, etc.
- */
 export declare function buildSanitizedEnv(extra?: Record<string, string>): Record<string, string>;
-/**
- * Redact API keys and secrets from command output before returning to the LLM.
- */
 export declare function sanitizeOutput(output: string): string;
 export interface ShellOptions {
     cwd?: string;

package/dist/tools/utils/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/shell.ts"],"names":[],"mappings":"AA4FA,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAYtE;AA6BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxB;AAgBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA2EtB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAuBD"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/shell.ts"],"names":[],"mappings":"AAuDA,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAYtE;AAwBD,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiB5F;AAYD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAqEtB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAuBD"}