@lleverage-ai/agent-sdk 0.0.1

package/dist/subagents/advanced.js

@@ -0,0 +1,396 @@
+/**
+ * Advanced subagent system with context isolation and parallel execution.
+ *
+ * @packageDocumentation
+ */
+import { createSubagent } from "../subagents.js";
+// =============================================================================
+// Context Management
+// =============================================================================
+let executionIdCounter = 0;
+/**
+ * Creates an isolated context for subagent execution.
+ *
+ * By default:
+ * - Files are shared (subagent sees parent's files)
+ * - Todos are isolated (subagent gets empty todos)
+ *
+ * This follows the DeepAgentSDK pattern where files represent shared
+ * work product but todos represent the agent's internal planning.
+ *
+ * @param options - Context creation options
+ * @returns Isolated subagent context
+ *
+ * @example
+ * ```typescript
+ * const context = createSubagentContext({
+ *   parentState: parentAgent.state,
+ *   shareFiles: true,
+ *   isolateTodos: true,
+ * });
+ *
+ * // Subagent can see parent's files
+ * // Subagent has empty todos
+ * ```
+ *
+ * @category Subagents
+ */
+export function createSubagentContext(options) {
+    const { parentState, shareFiles = true, isolateTodos = true, initialTodos = [] } = options;
+    // Create isolated state
+    const state = {
+        // Share or copy files based on option
+        files: shareFiles ? parentState.files : { ...parentState.files },
+        // Isolate or inherit todos based on option
+        todos: isolateTodos ? [...initialTodos] : [...parentState.todos],
+    };
+    return {
+        state,
+        parentState,
+        filesShared: shareFiles,
+        todosIsolated: isolateTodos,
+    };
+}
+/**
+ * Merges subagent context changes back to parent.
+ *
+ * Only file changes are merged back (if files were shared).
+ * Todo changes are NOT merged (todos are isolated by design).
+ *
+ * @param context - The subagent context to merge
+ *
+ * @example
+ * ```typescript
+ * // After subagent completes
+ * mergeSubagentContext(result.context);
+ *
+ * // Parent now has any files the subagent created/modified
+ * ```
+ *
+ * @category Subagents
+ */
+export function mergeSubagentContext(context) {
+    // Only merge files if they were shared (meaning mutations affect parent)
+    // If files weren't shared, we need to copy changes back
+    if (!context.filesShared) {
+        // Merge file changes back to parent
+        Object.assign(context.parentState.files, context.state.files);
+    }
+    // Note: If filesShared is true, the state.files is the same object as
+    // parentState.files, so changes are already reflected.
+    // Todos are intentionally NOT merged - they represent the subagent's
+    // internal planning and are discarded after execution.
+}
+// =============================================================================
+// Subagent Execution
+// =============================================================================
+/**
+ * Executes a subagent with isolated context.
+ *
+ * Creates a subagent from the definition, executes the prompt,
+ * and returns the result with the final context for merging.
+ *
+ * @param options - Execution options
+ * @returns Execution result with context
+ *
+ * @example
+ * ```typescript
+ * const result = await executeSubagent({
+ *   definition: {
+ *     type: "researcher",
+ *     description: "Researches topics",
+ *     systemPrompt: "You are a research assistant.",
+ *   },
+ *   prompt: "Research the history of TypeScript",
+ *   parentAgent,
+ *   hooks,
+ *   onStep: (event) => console.log(`Step ${event.stepNumber}`),
+ * });
+ *
+ * if (result.success) {
+ *   mergeSubagentContext(result.context);
+ *   console.log(result.text);
+ * }
+ * ```
+ *
+ * @category Subagents
+ */
+export async function executeSubagent(options) {
+    const { definition, prompt, parentAgent, maxTokens, signal, onStart, onStep, onFinish, onError } = options;
+    // Generate execution ID
+    const executionId = `subagent-${++executionIdCounter}-${Date.now()}`;
+    const startTime = Date.now();
+    // Create or use provided context
+    const context = options.context ??
+        createSubagentContext({
+            parentState: parentAgent.state,
+            shareFiles: true,
+            isolateTodos: true,
+        });
+    // Emit start event
+    const startEvent = {
+        type: "subagent-start",
+        executionId,
+        subagentType: definition.type,
+        timestamp: new Date().toISOString(),
+        prompt,
+    };
+    onStart?.(startEvent);
+    try {
+        // Resolve tools for subagent
+        let subagentTools;
+        if (definition.tools) {
+            if (Array.isArray(definition.tools)) {
+                // Subset of parent tools by name
+                const parentTools = parentAgent.options.tools ?? {};
+                subagentTools = {};
+                for (const toolName of definition.tools) {
+                    const tool = parentTools[toolName];
+                    if (tool) {
+                        subagentTools[toolName] = tool;
+                    }
+                }
+            }
+            else {
+                // Use provided tools directly
+                subagentTools = definition.tools;
+            }
+        }
+        else {
+            // Inherit parent tools
+            subagentTools = parentAgent.options.tools;
+        }
+        // Create the subagent
+        const subagent = createSubagent(parentAgent, {
+            name: definition.type,
+            description: definition.description,
+            model: definition.model,
+            systemPrompt: definition.systemPrompt,
+            maxSteps: definition.maxSteps,
+            tools: subagentTools,
+        });
+        // Execute generation
+        const effectiveMaxTokens = maxTokens ?? (definition.maxSteps ?? 10) * 4096;
+        const result = await subagent.generate({
+            prompt,
+            maxTokens: effectiveMaxTokens,
+            signal,
+        });
+        // Handle interrupted results
+        if (result.status === "interrupted") {
+            const duration = Date.now() - startTime;
+            return {
+                success: false,
+                text: result.partial?.text ?? "",
+                output: undefined,
+                steps: result.partial?.steps?.length ?? 0,
+                finishReason: "interrupted",
+                duration,
+                context,
+                result,
+                error: `Subagent was interrupted: ${result.interrupt.type}`,
+            };
+        }
+        // Emit step events for each step
+        let stepNumber = 0;
+        for (const step of result.steps) {
+            stepNumber++;
+            const stepEvent = {
+                type: "subagent-step",
+                executionId,
+                subagentType: definition.type,
+                timestamp: new Date().toISOString(),
+                stepNumber,
+                toolCalls: step.toolCalls.map((tc) => ({
+                    toolName: tc.toolName,
+                    args: tc.input,
+                    result: step.toolResults.find((tr) => tr.toolCallId === tc.toolCallId)?.output,
+                })),
+                text: step.text,
+            };
+            onStep?.(stepEvent);
+        }
+        const duration = Date.now() - startTime;
+        // Emit finish event
+        const finishEvent = {
+            type: "subagent-finish",
+            executionId,
+            subagentType: definition.type,
+            timestamp: new Date().toISOString(),
+            success: true,
+            summary: result.text.slice(0, 200) + (result.text.length > 200 ? "..." : ""),
+            steps: result.steps.length,
+            duration,
+            finishReason: result.finishReason,
+        };
+        onFinish?.(finishEvent);
+        return {
+            success: true,
+            text: result.text,
+            output: result.output,
+            steps: result.steps.length,
+            finishReason: result.finishReason,
+            duration,
+            context,
+            result,
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorObj = error instanceof Error ? error : new Error(String(error));
+        // Emit error event
+        const errorEvent = {
+            type: "subagent-error",
+            executionId,
+            subagentType: definition.type,
+            timestamp: new Date().toISOString(),
+            error: errorObj,
+        };
+        onError?.(errorEvent);
+        return {
+            success: false,
+            text: "",
+            steps: 0,
+            finishReason: "error",
+            duration,
+            error: errorObj.message,
+            context,
+        };
+    }
+}
+/**
+ * Executes multiple subagents in parallel.
+ *
+ * All subagents share the same parent context initially.
+ * After completion, file changes from all subagents are merged back.
+ *
+ * Note: If multiple subagents modify the same file, the last one wins.
+ * For better conflict handling, consider using different file paths.
+ *
+ * @param tasks - Array of tasks to execute
+ * @param parentAgent - Parent agent for configuration
+ * @param onResult - Optional callback for each completed task
+ * @returns Combined results from all executions
+ *
+ * @example
+ * ```typescript
+ * const results = await executeSubagentsParallel(
+ *   [
+ *     {
+ *       definition: researcherDef,
+ *       prompt: "Research TypeScript history",
+ *     },
+ *     {
+ *       definition: coderDef,
+ *       prompt: "Write a utility function",
+ *     },
+ *   ],
+ *   parentAgent,
+ *   (result, index) => console.log(`Task ${index} completed`),
+ * );
+ *
+ * console.log(`${results.successCount}/${results.results.length} succeeded`);
+ * ```
+ *
+ * @category Subagents
+ */
+export async function executeSubagentsParallel(tasks, parentAgent, onResult) {
+    const startTime = Date.now();
+    // Create isolated contexts for each task
+    // Note: Files are shared via reference, so changes from one subagent
+    // are visible to others. This is intentional for collaboration.
+    const contexts = tasks.map(() => createSubagentContext({
+        parentState: parentAgent.state,
+        shareFiles: true,
+        isolateTodos: true,
+    }));
+    // Execute all tasks in parallel
+    const results = await Promise.all(tasks.map(async (task, index) => {
+        const result = await executeSubagent({
+            definition: task.definition,
+            prompt: task.prompt,
+            parentAgent,
+            context: contexts[index],
+        });
+        onResult?.(result, index);
+        return result;
+    }));
+    // Merge contexts (file changes already reflected due to shared reference)
+    // Just ensure any non-shared contexts are merged
+    for (const result of results) {
+        if (!result.context.filesShared) {
+            mergeSubagentContext(result.context);
+        }
+    }
+    const totalDuration = Date.now() - startTime;
+    const successCount = results.filter((r) => r.success).length;
+    const failureCount = results.length - successCount;
+    return {
+        results,
+        successCount,
+        failureCount,
+        totalDuration,
+        allSucceeded: failureCount === 0,
+    };
+}
+// =============================================================================
+// Event Emitter
+// =============================================================================
+/**
+ * Creates an event emitter for subagent lifecycle events.
+ *
+ * Provides a convenient way to handle all subagent events
+ * without passing individual callbacks.
+ *
+ * @returns Event emitter instance
+ *
+ * @example
+ * ```typescript
+ * const emitter = createSubagentEventEmitter();
+ *
+ * emitter.onStart((event) => {
+ *   console.log(`Starting ${event.subagentType}: ${event.prompt}`);
+ * });
+ *
+ * emitter.onStep((event) => {
+ *   console.log(`Step ${event.stepNumber}: ${event.toolCalls.length} tool calls`);
+ * });
+ *
+ * emitter.onFinish((event) => {
+ *   console.log(`Finished in ${event.duration}ms: ${event.summary}`);
+ * });
+ *
+ * emitter.onError((event) => {
+ *   console.error(`Error: ${event.error.message}`);
+ * });
+ * ```
+ *
+ * @category Subagents
+ */
+export function createSubagentEventEmitter() {
+    const startHandlers = [];
+    const stepHandlers = [];
+    const finishHandlers = [];
+    const errorHandlers = [];
+    return {
+        onStart(handler) {
+            startHandlers.push(handler);
+        },
+        onStep(handler) {
+            stepHandlers.push(handler);
+        },
+        onFinish(handler) {
+            finishHandlers.push(handler);
+        },
+        onError(handler) {
+            errorHandlers.push(handler);
+        },
+        removeAllListeners() {
+            startHandlers.length = 0;
+            stepHandlers.length = 0;
+            finishHandlers.length = 0;
+            errorHandlers.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=advanced.js.map

package/dist/subagents/advanced.js.map

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

package/dist/subagents/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Advanced subagent system with context isolation and parallel execution.
+ *
+ * This module provides:
+ * - Enhanced subagent definitions with output schemas and interrupt support
+ * - Context isolation (files shared, todos isolated)
+ * - Parallel execution of multiple subagents
+ * - Event streaming for subagent lifecycle
+ *
+ * @packageDocumentation
+ */
+export type { SubagentDefinition, SubagentOptions, TaskToolOptions, } from "../types.js";
+export { createSubagentContext, createSubagentEventEmitter, type EnhancedSubagentDefinition, executeSubagent, executeSubagentsParallel, mergeSubagentContext, type ParallelExecutionResult, type ParallelTask, type SubagentContext, type SubagentContextOptions, type SubagentErrorEvent, type SubagentEvent, type SubagentEventEmitter, type SubagentExecutionOptions, type SubagentExecutionResult, type SubagentFinishEvent, type SubagentStartEvent, type SubagentStepEvent, } from "./advanced.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/subagents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/subagents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAEV,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,qBAAqB,EACrB,0BAA0B,EAE1B,KAAK,0BAA0B,EAC/B,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC"}

package/dist/subagents/index.js

@@ -0,0 +1,15 @@
+/**
+ * Advanced subagent system with context isolation and parallel execution.
+ *
+ * This module provides:
+ * - Enhanced subagent definitions with output schemas and interrupt support
+ * - Context isolation (files shared, todos isolated)
+ * - Parallel execution of multiple subagents
+ * - Event streaming for subagent lifecycle
+ *
+ * @packageDocumentation
+ */
+export { 
+// Functions
+createSubagentContext, createSubagentEventEmitter, executeSubagent, executeSubagentsParallel, mergeSubagentContext, } from "./advanced.js";
+//# sourceMappingURL=index.js.map

package/dist/subagents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subagents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO;AACL,YAAY;AACZ,qBAAqB,EACrB,0BAA0B,EAG1B,eAAe,EACf,wBAAwB,EACxB,oBAAoB,GAarB,MAAM,eAAe,CAAC"}

package/dist/subagents.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Subagent creation and task delegation.
+ *
+ * @packageDocumentation
+ */
+import type { Agent, SubagentOptions } from "./types.js";
+/**
+ * Creates a subagent that inherits configuration from a parent agent.
+ *
+ * Subagents are specialized agents that can be spawned by a parent agent
+ * to handle specific tasks. They can inherit the parent's model or use
+ * their own, and can have their own tools, plugins, and configuration.
+ *
+ * **Hook Inheritance**:
+ * By default, subagents inherit all hooks from their parent agent. You can control
+ * this behavior with the `inheritHooks` option:
+ * - `true` (default): Inherit all parent hooks
+ * - `false`: No inheritance, use only subagent's own hooks
+ * - `string[]`: Inherit only specific hook events
+ *
+ * **Tool Filtering Security**:
+ * When `allowedTools` is specified, subagent gets access to only those tools.
+ * A warning is logged if dangerous tools (bash, write, edit, rm, etc.) are included
+ * without explicit opt-in via `inheritHooks: false` or specific hook controls.
+ *
+ * @param parentAgent - The parent agent to inherit configuration from
+ * @param options - Configuration options for the subagent
+ * @returns A new agent instance configured as a subagent
+ *
+ * @example
+ * ```typescript
+ * import { createAgent, createSubagent } from "@lleverage-ai/agent-sdk";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ * import { tool } from "ai";
+ * import { z } from "zod";
+ *
+ * const mainAgent = createAgent({
+ *   model: anthropic("claude-sonnet-4-20250514"),
+ *   systemPrompt: "You are a helpful assistant.",
+ *   hooks: {
+ *     PreToolUse: [{
+ *       callback: async (input) => {
+ *         console.log("Parent hook:", input.tool_name);
+ *         return {};
+ *       },
+ *     }],
+ *   },
+ * });
+ *
+ * // Create a specialized subagent for code review
+ * const reviewerAgent = createSubagent(mainAgent, {
+ *   name: "code-reviewer",
+ *   description: "Reviews code for quality and best practices",
+ *   systemPrompt: "You are an expert code reviewer.",
+ *   inheritHooks: true, // Inherits parent's PreToolUse hook
+ *   tools: {
+ *     analyze: tool({
+ *       description: "Analyze code",
+ *       inputSchema: z.object({ code: z.string() }),
+ *       execute: async ({ code }) => analyzeCode(code),
+ *     }),
+ *   },
+ * });
+ *
+ * const result = await reviewerAgent.generate({
+ *   prompt: "Review this function: function add(a, b) { return a + b; }",
+ * });
+ * ```
+ *
+ * @category Subagents
+ */
+export declare function createSubagent(parentAgent: Agent, options: SubagentOptions): Agent;
+//# sourceMappingURL=subagents.d.ts.map

package/dist/subagents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../src/subagents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAoB,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK,CAoClF"}