@agntk/core 0.1.0

package/dist/tools/shell/background.js

@@ -0,0 +1,229 @@
+/**
+ * @agntk/core - Background Process Management Tool
+ *
+ * Manages long-running background processes with session tracking.
+ * Ported from @agntk/brain shell to consolidate shell tools.
+ */
+import { tool } from 'ai';
+import { z } from 'zod';
+import { spawn } from 'node:child_process';
+import { isDangerousCommand } from '../utils/shell.js';
+import { MAX_COMMAND_LENGTH, MAX_CWD_LENGTH } from './constants.js';
+// ============================================================================
+// Session Store
+// ============================================================================
+const MAX_BUFFER = 1024 * 1024; // 1MB
+const ROLLING_BUFFER = 512 * 1024; // 512KB
+const backgroundSessions = new Map();
+function generateSessionId() {
+    return `bg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+/** Get all sessions (for testing). */
+export function getBackgroundSessions() {
+    return backgroundSessions;
+}
+/** Clear all sessions (for testing). */
+export function clearBackgroundSessions() {
+    for (const session of backgroundSessions.values()) {
+        if (session.status === 'running') {
+            try {
+                session.process.kill('SIGTERM');
+            }
+            catch (_e) { /* ignore */ }
+        }
+    }
+    backgroundSessions.clear();
+}
+// ============================================================================
+// Background Process Lifecycle
+// ============================================================================
+function startBackgroundProcess(command, options = {}) {
+    const sessionId = generateSessionId();
+    const { cwd = process.cwd(), env } = options;
+    const proc = spawn('bash', ['-c', command], {
+        cwd,
+        env: { ...process.env, ...env, TERM: 'dumb' },
+        detached: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    const session = {
+        id: sessionId,
+        command,
+        process: proc,
+        stdout: '',
+        stderr: '',
+        startedAt: Date.now(),
+        status: 'running',
+        cwd,
+    };
+    proc.stdout?.on('data', (data) => {
+        session.stdout += data.toString();
+        if (session.stdout.length > MAX_BUFFER) {
+            session.stdout = session.stdout.slice(-ROLLING_BUFFER);
+        }
+    });
+    proc.stderr?.on('data', (data) => {
+        session.stderr += data.toString();
+        if (session.stderr.length > MAX_BUFFER) {
+            session.stderr = session.stderr.slice(-ROLLING_BUFFER);
+        }
+    });
+    proc.on('close', (code) => {
+        session.status = code === 0 ? 'completed' : 'failed';
+        session.exitCode = code ?? 1;
+    });
+    proc.on('error', () => {
+        session.status = 'failed';
+        session.exitCode = 1;
+    });
+    backgroundSessions.set(sessionId, session);
+    return session;
+}
+// ============================================================================
+// Tool Factory
+// ============================================================================
+const backgroundInputSchema = z.object({
+    operation: z.enum(['start', 'status', 'output', 'stop', 'list']).describe('Operation to perform'),
+    command: z.string().max(MAX_COMMAND_LENGTH).optional().describe('Command to run (required for start)'),
+    sessionId: z.string().optional().describe('Session ID (required for status/output/stop)'),
+    cwd: z.string().max(MAX_CWD_LENGTH).optional().describe('Working directory (for start)'),
+    env: z.record(z.string()).optional().describe('Environment variables (for start)'),
+});
+/**
+ * Create a background process management tool.
+ *
+ * @example
+ * ```typescript
+ * const tools = { shell: createShellTool('/my/project'), background: createBackgroundTool() };
+ * ```
+ */
+export function createBackgroundTool() {
+    return tool({
+        description: `Run long-running processes in the background without blocking.
+
+Operations:
+- start: Start a new background process, returns session ID
+- status: Check if a process is still running
+- output: Get stdout/stderr from a running or completed process
+- stop: Terminate a background process
+- list: List all active background sessions
+
+Use this tool for:
+- Development servers (npm run dev, python -m http.server)
+- Long-running builds or tests
+- Watch commands (npm run watch)
+- Database servers or other daemons
+
+Examples:
+- { "operation": "start", "command": "npm run dev" }
+- { "operation": "status", "sessionId": "bg-123-abc" }
+- { "operation": "output", "sessionId": "bg-123-abc" }
+- { "operation": "stop", "sessionId": "bg-123-abc" }
+- { "operation": "list" }`,
+        inputSchema: backgroundInputSchema,
+        execute: async ({ operation, command, sessionId, cwd, env }) => {
+            switch (operation) {
+                case 'start': {
+                    if (!command) {
+                        return JSON.stringify({ success: false, error: 'Command is required for start operation' });
+                    }
+                    if (isDangerousCommand(command)) {
+                        return JSON.stringify({ success: false, error: 'Command blocked for safety', blocked: true });
+                    }
+                    const session = startBackgroundProcess(command, { cwd, env });
+                    return JSON.stringify({
+                        success: true,
+                        sessionId: session.id,
+                        command: command.slice(0, 100),
+                        status: 'running',
+                        message: 'Process started in background. Use status/output to monitor.',
+                    });
+                }
+                case 'status': {
+                    if (!sessionId) {
+                        return JSON.stringify({ success: false, error: 'Session ID is required for status operation' });
+                    }
+                    const session = backgroundSessions.get(sessionId);
+                    if (!session) {
+                        return JSON.stringify({ success: false, error: `Session not found: ${sessionId}` });
+                    }
+                    return JSON.stringify({
+                        success: true,
+                        sessionId: session.id,
+                        status: session.status,
+                        exitCode: session.exitCode,
+                        runningFor: session.status === 'running'
+                            ? Math.round((Date.now() - session.startedAt) / 1000) + 's'
+                            : undefined,
+                        command: session.command.slice(0, 100),
+                    });
+                }
+                case 'output': {
+                    if (!sessionId) {
+                        return JSON.stringify({ success: false, error: 'Session ID is required for output operation' });
+                    }
+                    const session = backgroundSessions.get(sessionId);
+                    if (!session) {
+                        return JSON.stringify({ success: false, error: `Session not found: ${sessionId}` });
+                    }
+                    return JSON.stringify({
+                        success: true,
+                        sessionId: session.id,
+                        status: session.status,
+                        stdout: session.stdout.slice(-10000),
+                        stderr: session.stderr.slice(-5000),
+                        exitCode: session.exitCode,
+                    });
+                }
+                case 'stop': {
+                    if (!sessionId) {
+                        return JSON.stringify({ success: false, error: 'Session ID is required for stop operation' });
+                    }
+                    const session = backgroundSessions.get(sessionId);
+                    if (!session) {
+                        return JSON.stringify({ success: false, error: `Session not found: ${sessionId}` });
+                    }
+                    if (session.status !== 'running') {
+                        return JSON.stringify({
+                            success: true,
+                            message: `Session already ${session.status}`,
+                            exitCode: session.exitCode,
+                        });
+                    }
+                    try {
+                        session.process.kill('SIGTERM');
+                        session.status = 'stopped';
+                        setTimeout(() => {
+                            try {
+                                if (session.status === 'running') {
+                                    session.process.kill('SIGKILL');
+                                }
+                            }
+                            catch (_e) { /* ignore */ }
+                        }, 5000);
+                        return JSON.stringify({ success: true, message: 'Process terminated', sessionId: session.id });
+                    }
+                    catch (error) {
+                        return JSON.stringify({
+                            success: false,
+                            error: `Failed to stop process: ${error instanceof Error ? error.message : String(error)}`,
+                        });
+                    }
+                }
+                case 'list': {
+                    const sessions = Array.from(backgroundSessions.values()).map((s) => ({
+                        sessionId: s.id,
+                        command: s.command.slice(0, 50),
+                        status: s.status,
+                        startedAt: new Date(s.startedAt).toISOString(),
+                        exitCode: s.exitCode,
+                    }));
+                    return JSON.stringify({ success: true, count: sessions.length, sessions });
+                }
+                default:
+                    return JSON.stringify({ success: false, error: `Unknown operation: ${operation}` });
+            }
+        },
+    });
+}
+//# sourceMappingURL=background.js.map

package/dist/tools/shell/background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.js","sourceRoot":"","sources":["../../../src/tools/shell/background.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkBjE,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;AACtC,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ;AAE3C,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEhE,SAAS,iBAAiB;IACxB,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,uBAAuB;IACrC,KAAK,MAAM,OAAO,IAAI,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,OAAO,EAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,SAAS,sBAAsB,CAC7B,OAAe,EACf,UAA0D,EAAE;IAE5D,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;IACtC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAE7C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE;QAC1C,GAAG;QACH,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;QAC7C,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAsB;QACjC,EAAE,EAAE,SAAS;QACb,OAAO;QACP,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,MAAM,EAAE,SAAS;QACjB,GAAG;KACJ,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACvC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YACvC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACvC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YACvC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;QACrD,OAAO,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;QAC1B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACjG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACtG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACzF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACxF,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CACnF,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;0BAoBS;QACtB,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE;YAC7D,QAAQ,SAAS,EAAE,CAAC;gBAClB,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC,CAAC;oBAC9F,CAAC;oBACD,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;wBAChC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;oBAChG,CAAC;oBAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;oBAC9D,OAAO,IAAI,CAAC,SAAS,CAAC;wBACpB,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,OAAO,CAAC,EAAE;wBACrB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;wBAC9B,MAAM,EAAE,SAAS;wBACjB,OAAO,EAAE,8DAA8D;qBACxE,CAAC,CAAC;gBACL,CAAC;gBAED,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC,CAAC;oBAClG,CAAC;oBACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAClD,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,SAAS,EAAE,EAAE,CAAC,CAAC;oBACtF,CAAC;oBACD,OAAO,IAAI,CAAC,SAAS,CAAC;wBACpB,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,OAAO,CAAC,EAAE;wBACrB,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,UAAU,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS;4BACtC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG;4BAC3D,CAAC,CAAC,SAAS;wBACb,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;qBACvC,CAAC,CAAC;gBACL,CAAC;gBAED,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC,CAAC;oBAClG,CAAC;oBACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAClD,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,SAAS,EAAE,EAAE,CAAC,CAAC;oBACtF,CAAC;oBACD,OAAO,IAAI,CAAC,SAAS,CAAC;wBACpB,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,OAAO,CAAC,EAAE;wBACrB,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;wBACpC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;wBACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;qBAC3B,CAAC,CAAC;gBACL,CAAC;gBAED,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC,CAAC;oBAChG,CAAC;oBACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAClD,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,SAAS,EAAE,EAAE,CAAC,CAAC;oBACtF,CAAC;oBACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;wBACjC,OAAO,IAAI,CAAC,SAAS,CAAC;4BACpB,OAAO,EAAE,IAAI;4BACb,OAAO,EAAE,mBAAmB,OAAO,CAAC,MAAM,EAAE;4BAC5C,QAAQ,EAAE,OAAO,CAAC,QAAQ;yBAC3B,CAAC,CAAC;oBACL,CAAC;oBACD,IAAI,CAAC;wBACH,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;wBAChC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;wBAC3B,UAAU,CAAC,GAAG,EAAE;4BACd,IAAI,CAAC;gCACH,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oCACjC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gCAClC,CAAC;4BACH,CAAC;4BAAC,OAAO,EAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;wBACxC,CAAC,EAAE,IAAI,CAAC,CAAC;wBACT,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjG,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,IAAI,CAAC,SAAS,CAAC;4BACpB,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;yBAC3F,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACnE,SAAS,EAAE,CAAC,CAAC,EAAE;wBACf,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;wBAC/B,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;wBAC9C,QAAQ,EAAE,CAAC,CAAC,QAAQ;qBACrB,CAAC,CAAC,CAAC;oBACJ,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC7E,CAAC;gBAED;oBACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,SAAS,EAAE,EAAE,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Shell tool constants
+ */
+export declare const SHELL_DESCRIPTION = "Execute shell commands for tasks that specialized tools cannot accomplish.\nThis tool runs bash commands with safety checks and optional allowlisting.\n\nWhen to use this tool:\n- Running build commands (npm run build, make, cargo build)\n- Installing packages (npm install, pip install)\n- Running scripts (./scripts/deploy.sh)\n- Git operations not covered by specialized tools (git stash, git cherry-pick)\n- System inspection (ls, find, df, du)\n- Development servers (npm run dev, python -m http.server)\n\nWhen NOT to use this tool:\n- Reading/writing files \u2192 use fs tool\n- Searching code \u2192 use fs tool with grep action\n- Background processes that need monitoring \u2192 use delegate tool with background action\n- Any task where a specialized tool exists\n\nSafety features:\n- Dangerous command patterns are blocked (rm -rf /, sudo, etc.)\n- Interactive commands are rejected (vim, nano, htop)\n- Commands can be allowlisted for repeated use without re-confirmation\n- Timeout protection (default 30s, max 5min)\n\nCommand allowlisting:\nUse allow: true on first execution to add a command pattern to the allowlist.\nSubsequent calls with the same command won't require the \"allow\" flag.\nThis is useful for commands you'll run repeatedly (npm test, make build, etc.)\n\nParameters explained:\n- command: Required. The bash command to execute.\n- cwd: Working directory (default: project root).\n- timeout: Timeout in milliseconds (default: 30000, max: 300000).\n- allow: If true, add this command pattern to the allowlist.\n- stream: If true, stream output in chunks (for long-running commands).\n\nYou should:\n1. Prefer specialized tools when available\n2. Use allow: true for commands you'll run repeatedly\n3. Set appropriate timeout for long-running commands\n4. Use stream: true for commands with continuous output\n5. Check exitCode to determine success (0 = success)\n6. Review stderr even on success for warnings";
+export declare const DEFAULT_TIMEOUT = 30000;
+export declare const MAX_TIMEOUT = 300000;
+export declare const MAX_COMMAND_LENGTH = 10000;
+export declare const MAX_CWD_LENGTH = 1000;
+export declare const INTERACTIVE_COMMANDS: readonly ["vi", "vim", "nvim", "nano", "emacs", "pico", "htop", "top", "less", "more", "man", "screen", "tmux", "ssh", "telnet", "ftp"];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/shell/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,iBAAiB,65DAyCgB,CAAC;AAE/C,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,WAAW,SAAS,CAAC;AAClC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,eAAO,MAAM,oBAAoB,yIAIvB,CAAC"}

package/dist/tools/shell/constants.js

@@ -0,0 +1,55 @@
+/**
+ * Shell tool constants
+ */
+export const SHELL_DESCRIPTION = `Execute shell commands for tasks that specialized tools cannot accomplish.
+This tool runs bash commands with safety checks and optional allowlisting.
+
+When to use this tool:
+- Running build commands (npm run build, make, cargo build)
+- Installing packages (npm install, pip install)
+- Running scripts (./scripts/deploy.sh)
+- Git operations not covered by specialized tools (git stash, git cherry-pick)
+- System inspection (ls, find, df, du)
+- Development servers (npm run dev, python -m http.server)
+
+When NOT to use this tool:
+- Reading/writing files → use fs tool
+- Searching code → use fs tool with grep action
+- Background processes that need monitoring → use delegate tool with background action
+- Any task where a specialized tool exists
+
+Safety features:
+- Dangerous command patterns are blocked (rm -rf /, sudo, etc.)
+- Interactive commands are rejected (vim, nano, htop)
+- Commands can be allowlisted for repeated use without re-confirmation
+- Timeout protection (default 30s, max 5min)
+
+Command allowlisting:
+Use allow: true on first execution to add a command pattern to the allowlist.
+Subsequent calls with the same command won't require the "allow" flag.
+This is useful for commands you'll run repeatedly (npm test, make build, etc.)
+
+Parameters explained:
+- command: Required. The bash command to execute.
+- cwd: Working directory (default: project root).
+- timeout: Timeout in milliseconds (default: 30000, max: 300000).
+- allow: If true, add this command pattern to the allowlist.
+- stream: If true, stream output in chunks (for long-running commands).
+
+You should:
+1. Prefer specialized tools when available
+2. Use allow: true for commands you'll run repeatedly
+3. Set appropriate timeout for long-running commands
+4. Use stream: true for commands with continuous output
+5. Check exitCode to determine success (0 = success)
+6. Review stderr even on success for warnings`;
+export const DEFAULT_TIMEOUT = 30000;
+export const MAX_TIMEOUT = 300000;
+export const MAX_COMMAND_LENGTH = 10000;
+export const MAX_CWD_LENGTH = 1000;
+export const INTERACTIVE_COMMANDS = [
+    'vi', 'vim', 'nvim', 'nano', 'emacs', 'pico',
+    'htop', 'top', 'less', 'more', 'man',
+    'screen', 'tmux', 'ssh', 'telnet', 'ftp',
+];
+//# sourceMappingURL=constants.js.map

package/dist/tools/shell/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/shell/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAyCa,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAC5C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK;IACpC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK;CAChC,CAAC"}

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

@@ -0,0 +1,7 @@
+export { createShellTool, shellTool, executeShellCommand } from './tools.js';
+export { createBackgroundTool, clearBackgroundSessions, getBackgroundSessions } from './background.js';
+export type { BackgroundSession } from './background.js';
+export { addToAllowlist, clearAllowlist, getAllowlist } from './utils.js';
+export type { ShellInput, ShellResult } from './types.js';
+export { SHELL_DESCRIPTION, DEFAULT_TIMEOUT, MAX_TIMEOUT, INTERACTIVE_COMMANDS, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACpG,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/tools/shell/index.js

@@ -0,0 +1,5 @@
+export { createShellTool, shellTool, executeShellCommand } from './tools.js';
+export { createBackgroundTool, clearBackgroundSessions, getBackgroundSessions } from './background.js';
+export { addToAllowlist, clearAllowlist, getAllowlist } from './utils.js';
+export { SHELL_DESCRIPTION, DEFAULT_TIMEOUT, MAX_TIMEOUT, INTERACTIVE_COMMANDS, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/shell/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEpG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvE,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,22 @@
+export declare function createShellTool(workspaceRoot: string): import("ai").Tool<{
+    command: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    allow?: boolean | undefined;
+    stream?: boolean | undefined;
+}, string>;
+export declare const shellTool: import("ai").Tool<{
+    command: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    allow?: boolean | undefined;
+    stream?: boolean | undefined;
+}, string>;
+export declare const executeShellCommand: import("ai").ToolExecuteFunction<{
+    command: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    allow?: boolean | undefined;
+    stream?: boolean | undefined;
+}, string>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/shell/tools.ts"],"names":[],"mappings":"AAUA,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM;;;;;;WAwEpD;AAED,eAAO,MAAM,SAAS;;;;;;UAAiC,CAAC;AAGxD,eAAO,MAAM,mBAAmB;;;;;;UAAqB,CAAC"}

package/dist/tools/shell/tools.js

@@ -0,0 +1,70 @@
+import { tool } from 'ai';
+import { executeCommand, isDangerousCommand } from '../utils/shell.js';
+import { success, error } from '../utils/tool-result.js';
+import { ToolError, ToolErrorType } from '../utils/errors.js';
+import { SHELL_DESCRIPTION, DEFAULT_TIMEOUT } from './constants.js';
+import { shellInputSchema } from './types.js';
+import { isInteractiveCommand, isCommandAllowed, addToAllowlist } from './utils.js';
+export function createShellTool(workspaceRoot) {
+    return tool({
+        description: SHELL_DESCRIPTION,
+        inputSchema: shellInputSchema,
+        execute: async (input) => {
+            const { command, cwd, timeout = DEFAULT_TIMEOUT, allow = false, stream = false } = input;
+            if (isDangerousCommand(command)) {
+                throw new ToolError('Command blocked for safety. This command pattern is potentially destructive.', ToolErrorType.COMMAND_BLOCKED, { command: command.slice(0, 100), patterns: 'rm -rf, sudo, shutdown, etc.' });
+            }
+            if (isInteractiveCommand(command)) {
+                const firstWord = command.trim().split(/\s+/)[0];
+                return error(`Interactive command '${firstWord}' not supported`, {
+                    suggestion: 'Use the fs tool to read/write files, or run non-interactive alternatives.',
+                });
+            }
+            if (allow && !isCommandAllowed(command)) {
+                addToAllowlist(command);
+            }
+            const effectiveCwd = cwd ?? workspaceRoot;
+            const result = await executeCommand(command, {
+                cwd: effectiveCwd,
+                timeout,
+                maxBuffer: stream ? 10 * 1024 * 1024 : 1024 * 1024,
+            });
+            if (result.error) {
+                return error(result.error, {
+                    command: command.slice(0, 100),
+                    cwd: effectiveCwd,
+                });
+            }
+            if (result.killed) {
+                return error('Command timed out', {
+                    timeout,
+                    durationMs: result.durationMs,
+                    stdoutPreview: result.stdout.slice(0, 500),
+                    stderrPreview: result.stderr.slice(0, 500),
+                    hint: 'Increase timeout or use delegate with background action for long-running commands.',
+                });
+            }
+            const output = {
+                stdout: result.stdout,
+                stderr: result.stderr,
+                exitCode: result.exitCode,
+                durationMs: Math.round(result.durationMs),
+            };
+            if (result.exitCode !== 0) {
+                return success({
+                    ...output,
+                    status: 'failed',
+                    hint: 'Non-zero exit code indicates command failure. Check stderr for details.',
+                });
+            }
+            return success({
+                ...output,
+                status: 'success',
+            });
+        },
+    });
+}
+export const shellTool = createShellTool(process.cwd());
+// Direct export for testing (bypasses optional `execute` type from AI SDK)
+export const executeShellCommand = shellTool.execute;
+//# sourceMappingURL=tools.js.map

package/dist/tools/shell/tools.js.map

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

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

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export declare const shellInputSchema: z.ZodObject<{
+    command: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    allow: z.ZodOptional<z.ZodBoolean>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    allow?: boolean | undefined;
+    stream?: boolean | undefined;
+}, {
+    command: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    allow?: boolean | undefined;
+    stream?: boolean | undefined;
+}>;
+export type ShellInput = z.infer<typeof shellInputSchema>;
+export interface ShellResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    durationMs: number;
+    status: 'success' | 'failed';
+    hint?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/shell/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/tools/shell/types.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { MAX_COMMAND_LENGTH, MAX_CWD_LENGTH, MAX_TIMEOUT } from './constants.js';
+export const shellInputSchema = z.object({
+    command: z.string().max(MAX_COMMAND_LENGTH).describe('Bash command to execute'),
+    cwd: z.string().max(MAX_CWD_LENGTH).optional().describe('Working directory'),
+    timeout: z.number().min(100).max(MAX_TIMEOUT).optional().describe('Timeout in ms (default: 30000)'),
+    allow: z.boolean().optional().describe('Add to allowlist for future calls'),
+    stream: z.boolean().optional().describe('Stream output (for long commands)'),
+});
+//# sourceMappingURL=types.js.map

package/dist/tools/shell/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/shell/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC/E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC5E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACnG,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC3E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAC7E,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+export declare function isInteractiveCommand(command: string): boolean;
+export declare function getCommandPattern(command: string): string;
+export declare function isCommandAllowed(command: string): boolean;
+export declare function addToAllowlist(command: string): void;
+export declare function clearAllowlist(): void;
+export declare function getAllowlist(): string[];
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tools/shell/utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC"}

package/dist/tools/shell/utils.js

@@ -0,0 +1,26 @@
+import { INTERACTIVE_COMMANDS } from './constants.js';
+const allowedCommands = new Set();
+export function isInteractiveCommand(command) {
+    const firstWord = command.trim().split(/\s+/)[0];
+    return firstWord ? INTERACTIVE_COMMANDS.includes(firstWord) : false;
+}
+export function getCommandPattern(command) {
+    const normalized = command.trim().replace(/\s+/g, ' ');
+    const firstWord = normalized.split(' ')[0];
+    return firstWord ?? normalized;
+}
+export function isCommandAllowed(command) {
+    const pattern = getCommandPattern(command);
+    return allowedCommands.has(pattern);
+}
+export function addToAllowlist(command) {
+    const pattern = getCommandPattern(command);
+    allowedCommands.add(pattern);
+}
+export function clearAllowlist() {
+    allowedCommands.clear();
+}
+export function getAllowlist() {
+    return Array.from(allowedCommands);
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/tools/shell/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;AAE1C,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,CAAC,CAAE,oBAA0C,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,SAAS,IAAI,UAAU,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3C,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,eAAe,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,96 @@
+/**
+ * @agntk/core - Spawn Agent Tool
+ * Tool for spawning sub-agents with streaming output
+ */
+import { z } from 'zod';
+export interface SpawnAgentOptions {
+    /**
+     * Maximum spawn depth to prevent infinite recursion
+     * Sub-agents spawned by this tool will have depth-1
+     */
+    maxSpawnDepth?: number;
+    /**
+     * Current spawn depth (0 = main agent)
+     */
+    currentDepth?: number;
+    /**
+     * Agent factory function - must be provided to enable spawning
+     * This is called to create the sub-agent instance
+     */
+    createAgent?: (options: {
+        role: string;
+        instructions?: string;
+        tools?: string[];
+        maxSpawnDepth?: number;
+    }) => {
+        stream: (input: {
+            prompt: string;
+        }) => {
+            fullStream: AsyncIterable<{
+                type: string;
+                textDelta?: string;
+            }>;
+            text: Promise<string>;
+        };
+    };
+    /**
+     * Optional callback for streaming sub-agent output
+     * Called with each text delta chunk
+     */
+    onStream?: (data: SubAgentStreamData) => void;
+}
+export interface SubAgentStreamData {
+    type: 'sub-agent-stream';
+    agentId: string;
+    role: string;
+    text: string;
+    status: 'streaming' | 'complete';
+}
+export declare const spawnAgentParametersSchema: z.ZodObject<{
+    task: z.ZodString;
+    role: z.ZodDefault<z.ZodEnum<["coder", "researcher", "analyst", "generic"]>>;
+    context: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    role: "generic" | "coder" | "researcher" | "analyst";
+    task: string;
+    context?: string | undefined;
+}, {
+    task: string;
+    role?: "generic" | "coder" | "researcher" | "analyst" | undefined;
+    context?: string | undefined;
+}>;
+export type SpawnAgentInput = z.infer<typeof spawnAgentParametersSchema>;
+export interface SpawnAgentResult {
+    success: boolean;
+    agentId?: string;
+    role?: string;
+    summary?: string;
+    message?: string;
+    error?: string;
+    suggestion?: string;
+}
+/**
+ * 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
+ */
+export declare function createSpawnAgentTool(options?: SpawnAgentOptions): {
+    description: string;
+    inputSchema: z.ZodObject<{
+        task: z.ZodString;
+        role: z.ZodDefault<z.ZodEnum<["coder", "researcher", "analyst", "generic"]>>;
+        context: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        role: "generic" | "coder" | "researcher" | "analyst";
+        task: string;
+        context?: string | undefined;
+    }, {
+        task: string;
+        role?: "generic" | "coder" | "researcher" | "analyst" | undefined;
+        context?: string | undefined;
+    }>;
+    execute: (input: SpawnAgentInput) => Promise<SpawnAgentResult>;
+};
+export default createSpawnAgentTool;
+//# sourceMappingURL=index.d.ts.map