illuma-agents 1.0.45 → 1.0.49

package/dist/cjs/deepagents/DeepAgentBackend.cjs

@@ -0,0 +1,170 @@
+'use strict';
+
+var deepagents = require('deepagents');
+
+/**
+ * Deep Agent Backend
+ *
+ * A backend implementation that extends deepagents' FilesystemBackend
+ * with SSE streaming for real-time updates and integration with
+ * external code execution services.
+ */
+/**
+ * Deep Agent Backend
+ *
+ * Extends FilesystemBackend with:
+ * - SSE streaming for real-time updates
+ * - Integration with external code executor services
+ * - Event emission for todos and subagents
+ */
+class DeepAgentBackend extends deepagents.FilesystemBackend {
+    id;
+    timeout;
+    maxOutputBytes;
+    conversationId;
+    sseResponse;
+    codeExecutorUrl;
+    onTodoUpdate;
+    onSubagentUpdate;
+    constructor(options = {}) {
+        super({
+            rootDir: options.rootDir ?? process.cwd(),
+            virtualMode: options.virtualMode ?? true,
+            maxFileSizeMb: 10,
+        });
+        this.id = `deep-agent-backend-${Date.now().toString(36)}`;
+        this.timeout = options.timeout ?? 120_000;
+        this.maxOutputBytes = options.maxOutputBytes ?? 100_000;
+        this.conversationId = options.conversationId;
+        this.sseResponse = options.sseResponse;
+        this.codeExecutorUrl = options.codeExecutorUrl;
+        this.onTodoUpdate = options.onTodoUpdate;
+        this.onSubagentUpdate = options.onSubagentUpdate;
+    }
+    /**
+     * Execute a command
+     *
+     * If codeExecutorUrl is configured, uses the external sandboxed executor.
+     * Otherwise, logs a warning (shell execution may not be available).
+     */
+    async execute(command) {
+        if (!command || typeof command !== 'string') {
+            return {
+                output: 'Error: Command must be a non-empty string.',
+                exitCode: 1,
+                truncated: false,
+            };
+        }
+        // If we have a code executor URL, use that for sandboxed execution
+        if (this.codeExecutorUrl) {
+            return this.executeViaCodeExecutor(command);
+        }
+        // Log warning - direct shell execution may not be available
+        console.warn('[DeepAgentBackend] Shell execution requested but no code executor configured');
+        return {
+            output: 'Shell execution is not available in this environment. Consider using the code executor tool instead.',
+            exitCode: 1,
+            truncated: false,
+        };
+    }
+    /**
+     * Execute command via external code executor service
+     */
+    async executeViaCodeExecutor(command) {
+        try {
+            const response = await fetch(`${this.codeExecutorUrl}/execute`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    code: command,
+                    language: 'shell',
+                    timeout: this.timeout,
+                }),
+                signal: AbortSignal.timeout(this.timeout + 5000),
+            });
+            if (!response.ok) {
+                return {
+                    output: `Execution error: ${response.statusText}`,
+                    exitCode: 1,
+                    truncated: false,
+                };
+            }
+            const result = await response.json();
+            let output = result.output ?? result.error ?? '';
+            let truncated = false;
+            if (output.length > this.maxOutputBytes) {
+                output = output.slice(0, this.maxOutputBytes) + '\n... (output truncated)';
+                truncated = true;
+            }
+            return {
+                output,
+                exitCode: result.exitCode ?? (result.error ? 1 : 0),
+                truncated,
+            };
+        }
+        catch (error) {
+            return {
+                output: `Execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                exitCode: 1,
+                truncated: false,
+            };
+        }
+    }
+    /**
+     * Send an SSE event to the client
+     */
+    sendEvent(event, data) {
+        if (this.sseResponse && !this.sseResponse.headersSent) {
+            try {
+                this.sseResponse.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+            }
+            catch (e) {
+                console.warn('[DeepAgentBackend] Failed to send SSE event:', e);
+            }
+        }
+    }
+    /**
+     * Emit todo update event
+     */
+    emitTodoUpdate(todos) {
+        // Call callback if provided
+        if (this.onTodoUpdate) {
+            this.onTodoUpdate(todos);
+        }
+        // Send SSE event
+        this.sendEvent('deep_research', {
+            type: 'todo_update',
+            conversationId: this.conversationId,
+            todos,
+            progress: this.calculateProgress(todos),
+            isRunning: todos.some(t => t.status === 'in_progress'),
+        });
+    }
+    /**
+     * Emit subagent update event
+     */
+    emitSubagentUpdate(subagents) {
+        // Call callback if provided
+        if (this.onSubagentUpdate) {
+            this.onSubagentUpdate(subagents);
+        }
+        // Send SSE event
+        this.sendEvent('deep_research', {
+            type: 'subagent_update',
+            conversationId: this.conversationId,
+            subagents,
+        });
+    }
+    /**
+     * Calculate progress from todos
+     */
+    calculateProgress(todos) {
+        if (todos.length === 0)
+            return 0;
+        const completed = todos.filter(t => t.status === 'completed').length;
+        return Math.round((completed / todos.length) * 100);
+    }
+}
+
+exports.DeepAgentBackend = DeepAgentBackend;
+//# sourceMappingURL=DeepAgentBackend.cjs.map

package/dist/cjs/deepagents/DeepAgentBackend.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepAgentBackend.cjs","sources":["../../../src/deepagents/DeepAgentBackend.ts"],"sourcesContent":["/**\r\n * Deep Agent Backend\r\n * \r\n * A backend implementation that extends deepagents' FilesystemBackend\r\n * with SSE streaming for real-time updates and integration with\r\n * external code execution services.\r\n */\r\n\r\nimport { FilesystemBackend } from 'deepagents';\r\nimport type { ExecuteResponse, SandboxBackendProtocol } from 'deepagents';\r\nimport type { DeepAgentTodo, DeepAgentSubagent } from './types';\r\n\r\n/** SSE Response interface for streaming */\r\nexport interface SSEResponse {\r\n  write: (data: string) => void;\r\n  headersSent?: boolean;\r\n}\r\n\r\n/** Options for Deep Agent Backend */\r\nexport interface DeepAgentBackendOptions {\r\n  /** Root directory for file operations (default: process.cwd()) */\r\n  rootDir?: string;\r\n  /** Whether to use virtual paths (default: true) */\r\n  virtualMode?: boolean;\r\n  /** Timeout for command execution in ms (default: 120000) */\r\n  timeout?: number;\r\n  /** Max output size in bytes (default: 100000) */\r\n  maxOutputBytes?: number;\r\n  /** SSE response for streaming updates */\r\n  sseResponse?: SSEResponse;\r\n  /** Conversation ID for event tracking */\r\n  conversationId?: string;\r\n  /** Code executor API URL (optional - for sandboxed execution) */\r\n  codeExecutorUrl?: string;\r\n  /** Callback for todo changes */\r\n  onTodoUpdate?: (todos: DeepAgentTodo[]) => void;\r\n  /** Callback for subagent changes */\r\n  onSubagentUpdate?: (subagents: DeepAgentSubagent[]) => void;\r\n}\r\n\r\n/**\r\n * Deep Agent Backend\r\n * \r\n * Extends FilesystemBackend with:\r\n * - SSE streaming for real-time updates\r\n * - Integration with external code executor services\r\n * - Event emission for todos and subagents\r\n */\r\nexport class DeepAgentBackend extends FilesystemBackend implements SandboxBackendProtocol {\r\n  readonly id: string;\r\n  private readonly timeout: number;\r\n  private readonly maxOutputBytes: number;\r\n  private readonly conversationId?: string;\r\n  private readonly sseResponse?: SSEResponse;\r\n  private readonly codeExecutorUrl?: string;\r\n  private readonly onTodoUpdate?: (todos: DeepAgentTodo[]) => void;\r\n  private readonly onSubagentUpdate?: (subagents: DeepAgentSubagent[]) => void;\r\n\r\n  constructor(options: DeepAgentBackendOptions = {}) {\r\n    super({\r\n      rootDir: options.rootDir ?? process.cwd(),\r\n      virtualMode: options.virtualMode ?? true,\r\n      maxFileSizeMb: 10,\r\n    });\r\n\r\n    this.id = `deep-agent-backend-${Date.now().toString(36)}`;\r\n    this.timeout = options.timeout ?? 120_000;\r\n    this.maxOutputBytes = options.maxOutputBytes ?? 100_000;\r\n    this.conversationId = options.conversationId;\r\n    this.sseResponse = options.sseResponse;\r\n    this.codeExecutorUrl = options.codeExecutorUrl;\r\n    this.onTodoUpdate = options.onTodoUpdate;\r\n    this.onSubagentUpdate = options.onSubagentUpdate;\r\n  }\r\n\r\n  /**\r\n   * Execute a command\r\n   * \r\n   * If codeExecutorUrl is configured, uses the external sandboxed executor.\r\n   * Otherwise, logs a warning (shell execution may not be available).\r\n   */\r\n  async execute(command: string): Promise<ExecuteResponse> {\r\n    if (!command || typeof command !== 'string') {\r\n      return {\r\n        output: 'Error: Command must be a non-empty string.',\r\n        exitCode: 1,\r\n        truncated: false,\r\n      };\r\n    }\r\n\r\n    // If we have a code executor URL, use that for sandboxed execution\r\n    if (this.codeExecutorUrl) {\r\n      return this.executeViaCodeExecutor(command);\r\n    }\r\n\r\n    // Log warning - direct shell execution may not be available\r\n    console.warn('[DeepAgentBackend] Shell execution requested but no code executor configured');\r\n    return {\r\n      output: 'Shell execution is not available in this environment. Consider using the code executor tool instead.',\r\n      exitCode: 1,\r\n      truncated: false,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Execute command via external code executor service\r\n   */\r\n  private async executeViaCodeExecutor(command: string): Promise<ExecuteResponse> {\r\n    try {\r\n      const response = await fetch(`${this.codeExecutorUrl}/execute`, {\r\n        method: 'POST',\r\n        headers: { 'Content-Type': 'application/json' },\r\n        body: JSON.stringify({\r\n          code: command,\r\n          language: 'shell',\r\n          timeout: this.timeout,\r\n        }),\r\n        signal: AbortSignal.timeout(this.timeout + 5000),\r\n      });\r\n\r\n      if (!response.ok) {\r\n        return {\r\n          output: `Execution error: ${response.statusText}`,\r\n          exitCode: 1,\r\n          truncated: false,\r\n        };\r\n      }\r\n\r\n      const result = await response.json() as {\r\n        output?: string;\r\n        exitCode?: number;\r\n        error?: string;\r\n      };\r\n\r\n      let output = result.output ?? result.error ?? '';\r\n      let truncated = false;\r\n\r\n      if (output.length > this.maxOutputBytes) {\r\n        output = output.slice(0, this.maxOutputBytes) + '\\n... (output truncated)';\r\n        truncated = true;\r\n      }\r\n\r\n      return {\r\n        output,\r\n        exitCode: result.exitCode ?? (result.error ? 1 : 0),\r\n        truncated,\r\n      };\r\n    } catch (error) {\r\n      return {\r\n        output: `Execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\r\n        exitCode: 1,\r\n        truncated: false,\r\n      };\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Send an SSE event to the client\r\n   */\r\n  sendEvent(event: string, data: unknown): void {\r\n    if (this.sseResponse && !this.sseResponse.headersSent) {\r\n      try {\r\n        this.sseResponse.write(`event: ${event}\\ndata: ${JSON.stringify(data)}\\n\\n`);\r\n      } catch (e) {\r\n        console.warn('[DeepAgentBackend] Failed to send SSE event:', e);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Emit todo update event\r\n   */\r\n  emitTodoUpdate(todos: DeepAgentTodo[]): void {\r\n    // Call callback if provided\r\n    if (this.onTodoUpdate) {\r\n      this.onTodoUpdate(todos);\r\n    }\r\n\r\n    // Send SSE event\r\n    this.sendEvent('deep_research', {\r\n      type: 'todo_update',\r\n      conversationId: this.conversationId,\r\n      todos,\r\n      progress: this.calculateProgress(todos),\r\n      isRunning: todos.some(t => t.status === 'in_progress'),\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Emit subagent update event\r\n   */\r\n  emitSubagentUpdate(subagents: DeepAgentSubagent[]): void {\r\n    // Call callback if provided\r\n    if (this.onSubagentUpdate) {\r\n      this.onSubagentUpdate(subagents);\r\n    }\r\n\r\n    // Send SSE event\r\n    this.sendEvent('deep_research', {\r\n      type: 'subagent_update',\r\n      conversationId: this.conversationId,\r\n      subagents,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Calculate progress from todos\r\n   */\r\n  private calculateProgress(todos: DeepAgentTodo[]): number {\r\n    if (todos.length === 0) return 0;\r\n    const completed = todos.filter(t => t.status === 'completed').length;\r\n    return Math.round((completed / todos.length) * 100);\r\n  }\r\n}\r\n"],"names":["FilesystemBackend"],"mappings":"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"}

package/dist/cjs/deepagents/DeepAgentRuntime.cjs

@@ -0,0 +1,135 @@
+'use strict';
+
+var deepagents = require('deepagents');
+var DeepAgentBackend = require('./DeepAgentBackend.cjs');
+
+/**
+ * Deep Agent Runtime
+ *
+ * Factory for creating and managing deep agent instances with
+ * illuma-agents integration.
+ *
+ * Uses explicit any types to avoid version conflicts between
+ * langchain dependencies in deepagents vs illuma-agents.
+ */
+/** Default system prompt for deep research mode */
+const DEFAULT_DEEP_RESEARCH_PROMPT = `You are a deep research agent capable of breaking down complex tasks into manageable steps.
+
+## Todo Management
+
+You have a todo tool to track your progress. Use it to:
+1. Create a plan at the START with all tasks as "pending"
+2. Mark ONE task as "in_progress" before working on it
+3. Mark it "completed" IMMEDIATELY after finishing
+4. Update the FULL list each time (include all todos)
+
+## Best Practices
+
+- Break complex tasks into 3-7 discrete steps
+- Work through tasks sequentially
+- Keep the user informed of progress
+- If a task is blocked, mark it and move to the next
+- Summarize findings after completing all tasks
+`;
+/**
+ * Create a deep agent runtime with the provided options
+ *
+ * @param options - Configuration for the deep agent
+ * @returns The configured deep agent instance
+ */
+async function createDeepAgentRuntime(options) {
+    const { model, threadId, conversationId, workspacePath, systemPrompt, checkpointer, sseResponse, onTodoUpdate, onSubagentUpdate, requireApproval = false, codeExecutorUrl, } = options;
+    if (!threadId) {
+        throw new Error('Thread ID is required for deep agent checkpointing');
+    }
+    // Create the backend with SSE streaming
+    const backend = new DeepAgentBackend.DeepAgentBackend({
+        rootDir: workspacePath,
+        virtualMode: !workspacePath, // Use virtual mode if no workspace path
+        conversationId,
+        sseResponse,
+        codeExecutorUrl,
+        onTodoUpdate,
+        onSubagentUpdate,
+    });
+    // Build the full system prompt
+    const fullSystemPrompt = systemPrompt
+        ? `${systemPrompt}\n\n${DEFAULT_DEEP_RESEARCH_PROMPT}`
+        : DEFAULT_DEEP_RESEARCH_PROMPT;
+    // Create the deep agent with explicit any casts to avoid version conflicts
+    // between langchain types in deepagents vs illuma-agents
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const agent = deepagents.createDeepAgent({
+        model: model,
+        checkpointer: checkpointer,
+        backend,
+        systemPrompt: fullSystemPrompt,
+        // Require approval for shell commands if configured
+        interruptOn: requireApproval ? { execute: true } : undefined,
+    });
+    return {
+        agent,
+        backend,
+        threadId,
+        conversationId,
+    };
+}
+/**
+ * Run a deep agent with the given input
+ *
+ * @param runtime - The deep agent runtime
+ * @param input - User input message
+ * @param config - Optional run configuration
+ */
+async function runDeepAgent(runtime, input, config) {
+    const { agent, threadId, backend } = runtime;
+    // Stream the agent response
+    const stream = await agent.stream({ messages: [{ role: 'human', content: input }] }, {
+        configurable: { thread_id: threadId },
+        signal: config?.signal,
+    });
+    let fullResponse = '';
+    const todos = [];
+    const subagents = [];
+    for await (const event of stream) {
+        // Handle different event types
+        if ('messages' in event && Array.isArray(event.messages)) {
+            // Extract the latest AI message content
+            const lastMessage = event.messages[event.messages.length - 1];
+            if (lastMessage?.role === 'ai' && typeof lastMessage.content === 'string') {
+                const newContent = lastMessage.content.slice(fullResponse.length);
+                if (newContent && config?.onToken) {
+                    config.onToken(newContent);
+                }
+                fullResponse = lastMessage.content;
+            }
+        }
+        // Handle todo updates
+        if ('todos' in event && Array.isArray(event.todos)) {
+            todos.length = 0;
+            todos.push(...event.todos);
+            if (config?.onTodoUpdate) {
+                config.onTodoUpdate(todos);
+            }
+            backend.emitTodoUpdate(todos);
+        }
+        // Handle subagent updates
+        if ('subagents' in event && Array.isArray(event.subagents)) {
+            subagents.length = 0;
+            subagents.push(...event.subagents);
+            if (config?.onSubagentUpdate) {
+                config.onSubagentUpdate(subagents);
+            }
+            backend.emitSubagentUpdate(subagents);
+        }
+    }
+    return {
+        response: fullResponse,
+        todos,
+        subagents,
+    };
+}
+
+exports.createDeepAgentRuntime = createDeepAgentRuntime;
+exports.runDeepAgent = runDeepAgent;
+//# sourceMappingURL=DeepAgentRuntime.cjs.map

package/dist/cjs/deepagents/DeepAgentRuntime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepAgentRuntime.cjs","sources":["../../../src/deepagents/DeepAgentRuntime.ts"],"sourcesContent":["/**\r\n * Deep Agent Runtime\r\n * \r\n * Factory for creating and managing deep agent instances with\r\n * illuma-agents integration.\r\n * \r\n * Uses explicit any types to avoid version conflicts between\r\n * langchain dependencies in deepagents vs illuma-agents.\r\n */\r\n\r\nimport { createDeepAgent } from 'deepagents';\r\nimport { DeepAgentBackend } from './DeepAgentBackend';\r\nimport type { DeepAgentRuntimeOptions, DeepAgentTodo, DeepAgentSubagent } from './types';\r\n\r\n/** Default system prompt for deep research mode */\r\nconst DEFAULT_DEEP_RESEARCH_PROMPT = `You are a deep research agent capable of breaking down complex tasks into manageable steps.\r\n\r\n## Todo Management\r\n\r\nYou have a todo tool to track your progress. Use it to:\r\n1. Create a plan at the START with all tasks as \"pending\"\r\n2. Mark ONE task as \"in_progress\" before working on it\r\n3. Mark it \"completed\" IMMEDIATELY after finishing\r\n4. Update the FULL list each time (include all todos)\r\n\r\n## Best Practices\r\n\r\n- Break complex tasks into 3-7 discrete steps\r\n- Work through tasks sequentially\r\n- Keep the user informed of progress\r\n- If a task is blocked, mark it and move to the next\r\n- Summarize findings after completing all tasks\r\n`;\r\n\r\n/** Return type for createDeepAgentRuntime */\r\nexport interface DeepAgentRuntimeResult {\r\n  /** The deep agent instance */\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  agent: any;\r\n  /** The backend for execution */\r\n  backend: DeepAgentBackend;\r\n  /** Thread ID for checkpointing */\r\n  threadId: string;\r\n  /** Conversation ID for tracking */\r\n  conversationId: string;\r\n}\r\n\r\n/**\r\n * Create a deep agent runtime with the provided options\r\n * \r\n * @param options - Configuration for the deep agent\r\n * @returns The configured deep agent instance\r\n */\r\nexport async function createDeepAgentRuntime(\r\n  options: DeepAgentRuntimeOptions\r\n): Promise<DeepAgentRuntimeResult> {\r\n  const {\r\n    model,\r\n    threadId,\r\n    conversationId,\r\n    workspacePath,\r\n    systemPrompt,\r\n    checkpointer,\r\n    sseResponse,\r\n    onTodoUpdate,\r\n    onSubagentUpdate,\r\n    requireApproval = false,\r\n    codeExecutorUrl,\r\n  } = options;\r\n\r\n  if (!threadId) {\r\n    throw new Error('Thread ID is required for deep agent checkpointing');\r\n  }\r\n\r\n  // Create the backend with SSE streaming\r\n  const backend = new DeepAgentBackend({\r\n    rootDir: workspacePath,\r\n    virtualMode: !workspacePath, // Use virtual mode if no workspace path\r\n    conversationId,\r\n    sseResponse,\r\n    codeExecutorUrl,\r\n    onTodoUpdate,\r\n    onSubagentUpdate,\r\n  });\r\n\r\n  // Build the full system prompt\r\n  const fullSystemPrompt = systemPrompt \r\n    ? `${systemPrompt}\\n\\n${DEFAULT_DEEP_RESEARCH_PROMPT}`\r\n    : DEFAULT_DEEP_RESEARCH_PROMPT;\r\n\r\n  // Create the deep agent with explicit any casts to avoid version conflicts\r\n  // between langchain types in deepagents vs illuma-agents\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  const agent = createDeepAgent({\r\n    model: model as any,\r\n    checkpointer: checkpointer as any,\r\n    backend,\r\n    systemPrompt: fullSystemPrompt,\r\n    // Require approval for shell commands if configured\r\n    interruptOn: requireApproval ? { execute: true } : undefined,\r\n  } as any);\r\n\r\n  return {\r\n    agent,\r\n    backend,\r\n    threadId,\r\n    conversationId,\r\n  };\r\n}\r\n\r\n/**\r\n * Run a deep agent with the given input\r\n * \r\n * @param runtime - The deep agent runtime\r\n * @param input - User input message\r\n * @param config - Optional run configuration\r\n */\r\nexport async function runDeepAgent(\r\n  runtime: DeepAgentRuntimeResult,\r\n  input: string,\r\n  config?: {\r\n    signal?: AbortSignal;\r\n    onToken?: (token: string) => void;\r\n    onTodoUpdate?: (todos: DeepAgentTodo[]) => void;\r\n    onSubagentUpdate?: (subagents: DeepAgentSubagent[]) => void;\r\n  }\r\n): Promise<{\r\n  response: string;\r\n  todos: DeepAgentTodo[];\r\n  subagents: DeepAgentSubagent[];\r\n}> {\r\n  const { agent, threadId, backend } = runtime;\r\n\r\n  // Stream the agent response\r\n  const stream = await agent.stream(\r\n    { messages: [{ role: 'human', content: input }] },\r\n    { \r\n      configurable: { thread_id: threadId },\r\n      signal: config?.signal,\r\n    }\r\n  );\r\n\r\n  let fullResponse = '';\r\n  const todos: DeepAgentTodo[] = [];\r\n  const subagents: DeepAgentSubagent[] = [];\r\n\r\n  for await (const event of stream) {\r\n    // Handle different event types\r\n    if ('messages' in event && Array.isArray(event.messages)) {\r\n      // Extract the latest AI message content\r\n      const lastMessage = event.messages[event.messages.length - 1];\r\n      if (lastMessage?.role === 'ai' && typeof lastMessage.content === 'string') {\r\n        const newContent = lastMessage.content.slice(fullResponse.length);\r\n        if (newContent && config?.onToken) {\r\n          config.onToken(newContent);\r\n        }\r\n        fullResponse = lastMessage.content;\r\n      }\r\n    }\r\n\r\n    // Handle todo updates\r\n    if ('todos' in event && Array.isArray(event.todos)) {\r\n      todos.length = 0;\r\n      todos.push(...(event.todos as DeepAgentTodo[]));\r\n      if (config?.onTodoUpdate) {\r\n        config.onTodoUpdate(todos);\r\n      }\r\n      backend.emitTodoUpdate(todos);\r\n    }\r\n\r\n    // Handle subagent updates\r\n    if ('subagents' in event && Array.isArray(event.subagents)) {\r\n      subagents.length = 0;\r\n      subagents.push(...(event.subagents as DeepAgentSubagent[]));\r\n      if (config?.onSubagentUpdate) {\r\n        config.onSubagentUpdate(subagents);\r\n      }\r\n      backend.emitSubagentUpdate(subagents);\r\n    }\r\n  }\r\n\r\n  return {\r\n    response: fullResponse,\r\n    todos,\r\n    subagents,\r\n  };\r\n}"],"names":["DeepAgentBackend","createDeepAgent"],"mappings":"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"}

package/dist/cjs/deepagents/types.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+/**
+ * Deep Agents Types
+ *
+ * Type definitions for deep agent integration
+ *
+ * Uses generic/unknown types to avoid version conflicts between
+ * langchain dependencies in deepagents vs illuma-agents.
+ */
+/** Calculate progress from todos */
+function calculateTodoProgress(todos) {
+    if (todos.length === 0)
+        return 0;
+    const completed = todos.filter(t => t.status === 'completed').length;
+    return Math.round((completed / todos.length) * 100);
+}
+/** Default state for deep agent */
+const defaultDeepAgentState = {
+    enabled: false,
+    todos: [],
+    subagents: [],
+    progress: 0,
+    isRunning: false,
+};
+
+exports.calculateTodoProgress = calculateTodoProgress;
+exports.defaultDeepAgentState = defaultDeepAgentState;
+//# sourceMappingURL=types.cjs.map

package/dist/cjs/deepagents/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sources":["../../../src/deepagents/types.ts"],"sourcesContent":["/**\r\n * Deep Agents Types\r\n * \r\n * Type definitions for deep agent integration\r\n * \r\n * Uses generic/unknown types to avoid version conflicts between\r\n * langchain dependencies in deepagents vs illuma-agents.\r\n */\r\n\r\n/** Status of a todo item */\r\nexport type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';\r\n\r\n/** A todo item tracked by the deep agent */\r\nexport interface DeepAgentTodo {\r\n  /** Unique identifier */\r\n  id: string;\r\n  /** Task description */\r\n  content: string;\r\n  /** Current status */\r\n  status: TodoStatus;\r\n  /** Order index */\r\n  order?: number;\r\n  /** When created */\r\n  createdAt?: string;\r\n  /** When last updated */\r\n  updatedAt?: string;\r\n}\r\n\r\n/** A subagent spawned by the deep agent */\r\nexport interface DeepAgentSubagent {\r\n  /** Unique identifier */\r\n  id: string;\r\n  /** Subagent name/purpose */\r\n  name: string;\r\n  /** Description of what it's doing */\r\n  description?: string;\r\n  /** Current status */\r\n  status: 'pending' | 'running' | 'completed' | 'failed';\r\n  /** When started */\r\n  startedAt?: string;\r\n  /** When completed */\r\n  completedAt?: string;\r\n}\r\n\r\n/** State of a deep agent session */\r\nexport interface DeepAgentState {\r\n  /** Whether deep research mode is active */\r\n  enabled: boolean;\r\n  /** Current todos */\r\n  todos: DeepAgentTodo[];\r\n  /** Active subagents */\r\n  subagents: DeepAgentSubagent[];\r\n  /** Overall progress (0-100) */\r\n  progress: number;\r\n  /** Whether currently executing */\r\n  isRunning: boolean;\r\n  /** Workspace path for file operations */\r\n  workspacePath?: string;\r\n}\r\n\r\n/** Options for creating a deep agent runtime */\r\nexport interface DeepAgentRuntimeOptions {\r\n  /** The LLM model to use (BaseChatModel or model name string) */\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  model: any;\r\n  /** Thread ID for checkpointing */\r\n  threadId: string;\r\n  /** Conversation ID for event tracking */\r\n  conversationId: string;\r\n  /** Workspace path for file operations (optional) */\r\n  workspacePath?: string;\r\n  /** Custom system prompt to prepend */\r\n  systemPrompt?: string;\r\n  /** Checkpointer for state persistence (BaseCheckpointSaver) */\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  checkpointer?: any;\r\n  /** SSE response object for streaming updates */\r\n  sseResponse?: {\r\n    write: (data: string) => void;\r\n    headersSent?: boolean;\r\n  };\r\n  /** Callback for todo updates */\r\n  onTodoUpdate?: (todos: DeepAgentTodo[]) => void;\r\n  /** Callback for subagent updates */\r\n  onSubagentUpdate?: (subagents: DeepAgentSubagent[]) => void;\r\n  /** Whether to require human approval for shell commands */\r\n  requireApproval?: boolean;\r\n  /** Code executor URL for sandboxed execution */\r\n  codeExecutorUrl?: string;\r\n}\r\n\r\n/** Events emitted by the deep agent */\r\nexport interface DeepAgentEvent {\r\n  type: 'todo_update' | 'subagent_update' | 'file_change' | 'execution';\r\n  conversationId: string;\r\n  data: {\r\n    todos?: DeepAgentTodo[];\r\n    subagents?: DeepAgentSubagent[];\r\n    files?: Array<{ path: string; action: 'read' | 'write' | 'delete' }>;\r\n    execution?: { command: string; output: string; exitCode: number | null };\r\n  };\r\n}\r\n\r\n/** Calculate progress from todos */\r\nexport function calculateTodoProgress(todos: DeepAgentTodo[]): number {\r\n  if (todos.length === 0) return 0;\r\n  const completed = todos.filter(t => t.status === 'completed').length;\r\n  return Math.round((completed / todos.length) * 100);\r\n}\r\n\r\n/** Default state for deep agent */\r\nexport const defaultDeepAgentState: DeepAgentState = {\r\n  enabled: false,\r\n  todos: [],\r\n  subagents: [],\r\n  progress: 0,\r\n  isRunning: false,\r\n};\r\n"],"names":[],"mappings":";;AAAA;;;;;;;AAOG;AAgGH;AACM,SAAU,qBAAqB,CAAC,KAAsB,EAAA;AAC1D,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,CAAC;AAChC,IAAA,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;AACpE,IAAA,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;AACrD;AAEA;AACa,MAAA,qBAAqB,GAAmB;AACnD,IAAA,OAAO,EAAE,KAAK;AACd,IAAA,KAAK,EAAE,EAAE;AACT,IAAA,SAAS,EAAE,EAAE;AACb,IAAA,QAAQ,EAAE,CAAC;AACX,IAAA,SAAS,EAAE,KAAK;;;;;;"}

package/dist/cjs/main.cjs

@@ -13,10 +13,13 @@ var content = require('./messages/content.cjs');
 var tools = require('./messages/tools.cjs');
 var Graph = require('./graphs/Graph.cjs');
 var MultiAgentGraph = require('./graphs/MultiAgentGraph.cjs');
+var deepagents = require('deepagents');
+var types = require('./deepagents/types.cjs');
+var DeepAgentRuntime = require('./deepagents/DeepAgentRuntime.cjs');
+var DeepAgentBackend = require('./deepagents/DeepAgentBackend.cjs');
 var Calculator = require('./tools/Calculator.cjs');
 var CodeExecutor = require('./tools/CodeExecutor.cjs');
 var BrowserTools = require('./tools/BrowserTools.cjs');
-var DesktopTools = require('./tools/DesktopTools.cjs');
 var ProgrammaticToolCalling = require('./tools/ProgrammaticToolCalling.cjs');
 var ToolSearch = require('./tools/ToolSearch.cjs');
 var handlers = require('./tools/handlers.cjs');
@@ -79,6 +82,19 @@ exports.hasToolSearchInCurrentTurn = tools.hasToolSearchInCurrentTurn;
 exports.Graph = Graph.Graph;
 exports.StandardGraph = Graph.StandardGraph;
 exports.MultiAgentGraph = MultiAgentGraph.MultiAgentGraph;
+Object.defineProperty(exports, "FilesystemBackend", {
+	enumerable: true,
+	get: function () { return deepagents.FilesystemBackend; }
+});
+Object.defineProperty(exports, "createDeepAgent", {
+	enumerable: true,
+	get: function () { return deepagents.createDeepAgent; }
+});
+exports.calculateTodoProgress = types.calculateTodoProgress;
+exports.defaultDeepAgentState = types.defaultDeepAgentState;
+exports.createDeepAgentRuntime = DeepAgentRuntime.createDeepAgentRuntime;
+exports.runDeepAgent = DeepAgentRuntime.runDeepAgent;
+exports.DeepAgentBackend = DeepAgentBackend.DeepAgentBackend;
 exports.Calculator = Calculator.Calculator;
 exports.createCodeExecutionTool = CodeExecutor.createCodeExecutionTool;
 exports.getCodeBaseURL = CodeExecutor.getCodeBaseURL;
@@ -86,11 +102,6 @@ exports.imageExtRegex = CodeExecutor.imageExtRegex;
 exports.EBrowserTools = BrowserTools.EBrowserTools;
 exports.createBrowserTools = BrowserTools.createBrowserTools;
 exports.hasBrowserCapability = BrowserTools.hasBrowserCapability;
-exports.EDesktopTools = DesktopTools.EDesktopTools;
-exports.createDesktopTools = DesktopTools.createDesktopTools;
-exports.getDesktopToolNames = DesktopTools.getDesktopToolNames;
-exports.hasDesktopCapability = DesktopTools.hasDesktopCapability;
-exports.isDesktopTool = DesktopTools.isDesktopTool;
 exports.createProgrammaticToolCallingTool = ProgrammaticToolCalling.createProgrammaticToolCallingTool;
 exports.executeTools = ProgrammaticToolCalling.executeTools;
 exports.extractUsedToolNames = ProgrammaticToolCalling.extractUsedToolNames;

package/dist/cjs/main.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"main.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/deepagents/DeepAgentBackend.mjs

@@ -0,0 +1,168 @@
+import { FilesystemBackend } from 'deepagents';
+
+/**
+ * Deep Agent Backend
+ *
+ * A backend implementation that extends deepagents' FilesystemBackend
+ * with SSE streaming for real-time updates and integration with
+ * external code execution services.
+ */
+/**
+ * Deep Agent Backend
+ *
+ * Extends FilesystemBackend with:
+ * - SSE streaming for real-time updates
+ * - Integration with external code executor services
+ * - Event emission for todos and subagents
+ */
+class DeepAgentBackend extends FilesystemBackend {
+    id;
+    timeout;
+    maxOutputBytes;
+    conversationId;
+    sseResponse;
+    codeExecutorUrl;
+    onTodoUpdate;
+    onSubagentUpdate;
+    constructor(options = {}) {
+        super({
+            rootDir: options.rootDir ?? process.cwd(),
+            virtualMode: options.virtualMode ?? true,
+            maxFileSizeMb: 10,
+        });
+        this.id = `deep-agent-backend-${Date.now().toString(36)}`;
+        this.timeout = options.timeout ?? 120_000;
+        this.maxOutputBytes = options.maxOutputBytes ?? 100_000;
+        this.conversationId = options.conversationId;
+        this.sseResponse = options.sseResponse;
+        this.codeExecutorUrl = options.codeExecutorUrl;
+        this.onTodoUpdate = options.onTodoUpdate;
+        this.onSubagentUpdate = options.onSubagentUpdate;
+    }
+    /**
+     * Execute a command
+     *
+     * If codeExecutorUrl is configured, uses the external sandboxed executor.
+     * Otherwise, logs a warning (shell execution may not be available).
+     */
+    async execute(command) {
+        if (!command || typeof command !== 'string') {
+            return {
+                output: 'Error: Command must be a non-empty string.',
+                exitCode: 1,
+                truncated: false,
+            };
+        }
+        // If we have a code executor URL, use that for sandboxed execution
+        if (this.codeExecutorUrl) {
+            return this.executeViaCodeExecutor(command);
+        }
+        // Log warning - direct shell execution may not be available
+        console.warn('[DeepAgentBackend] Shell execution requested but no code executor configured');
+        return {
+            output: 'Shell execution is not available in this environment. Consider using the code executor tool instead.',
+            exitCode: 1,
+            truncated: false,
+        };
+    }
+    /**
+     * Execute command via external code executor service
+     */
+    async executeViaCodeExecutor(command) {
+        try {
+            const response = await fetch(`${this.codeExecutorUrl}/execute`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    code: command,
+                    language: 'shell',
+                    timeout: this.timeout,
+                }),
+                signal: AbortSignal.timeout(this.timeout + 5000),
+            });
+            if (!response.ok) {
+                return {
+                    output: `Execution error: ${response.statusText}`,
+                    exitCode: 1,
+                    truncated: false,
+                };
+            }
+            const result = await response.json();
+            let output = result.output ?? result.error ?? '';
+            let truncated = false;
+            if (output.length > this.maxOutputBytes) {
+                output = output.slice(0, this.maxOutputBytes) + '\n... (output truncated)';
+                truncated = true;
+            }
+            return {
+                output,
+                exitCode: result.exitCode ?? (result.error ? 1 : 0),
+                truncated,
+            };
+        }
+        catch (error) {
+            return {
+                output: `Execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                exitCode: 1,
+                truncated: false,
+            };
+        }
+    }
+    /**
+     * Send an SSE event to the client
+     */
+    sendEvent(event, data) {
+        if (this.sseResponse && !this.sseResponse.headersSent) {
+            try {
+                this.sseResponse.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+            }
+            catch (e) {
+                console.warn('[DeepAgentBackend] Failed to send SSE event:', e);
+            }
+        }
+    }
+    /**
+     * Emit todo update event
+     */
+    emitTodoUpdate(todos) {
+        // Call callback if provided
+        if (this.onTodoUpdate) {
+            this.onTodoUpdate(todos);
+        }
+        // Send SSE event
+        this.sendEvent('deep_research', {
+            type: 'todo_update',
+            conversationId: this.conversationId,
+            todos,
+            progress: this.calculateProgress(todos),
+            isRunning: todos.some(t => t.status === 'in_progress'),
+        });
+    }
+    /**
+     * Emit subagent update event
+     */
+    emitSubagentUpdate(subagents) {
+        // Call callback if provided
+        if (this.onSubagentUpdate) {
+            this.onSubagentUpdate(subagents);
+        }
+        // Send SSE event
+        this.sendEvent('deep_research', {
+            type: 'subagent_update',
+            conversationId: this.conversationId,
+            subagents,
+        });
+    }
+    /**
+     * Calculate progress from todos
+     */
+    calculateProgress(todos) {
+        if (todos.length === 0)
+            return 0;
+        const completed = todos.filter(t => t.status === 'completed').length;
+        return Math.round((completed / todos.length) * 100);
+    }
+}
+
+export { DeepAgentBackend };
+//# sourceMappingURL=DeepAgentBackend.mjs.map

package/dist/esm/deepagents/DeepAgentBackend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepAgentBackend.mjs","sources":["../../../src/deepagents/DeepAgentBackend.ts"],"sourcesContent":["/**\r\n * Deep Agent Backend\r\n * \r\n * A backend implementation that extends deepagents' FilesystemBackend\r\n * with SSE streaming for real-time updates and integration with\r\n * external code execution services.\r\n */\r\n\r\nimport { FilesystemBackend } from 'deepagents';\r\nimport type { ExecuteResponse, SandboxBackendProtocol } from 'deepagents';\r\nimport type { DeepAgentTodo, DeepAgentSubagent } from './types';\r\n\r\n/** SSE Response interface for streaming */\r\nexport interface SSEResponse {\r\n  write: (data: string) => void;\r\n  headersSent?: boolean;\r\n}\r\n\r\n/** Options for Deep Agent Backend */\r\nexport interface DeepAgentBackendOptions {\r\n  /** Root directory for file operations (default: process.cwd()) */\r\n  rootDir?: string;\r\n  /** Whether to use virtual paths (default: true) */\r\n  virtualMode?: boolean;\r\n  /** Timeout for command execution in ms (default: 120000) */\r\n  timeout?: number;\r\n  /** Max output size in bytes (default: 100000) */\r\n  maxOutputBytes?: number;\r\n  /** SSE response for streaming updates */\r\n  sseResponse?: SSEResponse;\r\n  /** Conversation ID for event tracking */\r\n  conversationId?: string;\r\n  /** Code executor API URL (optional - for sandboxed execution) */\r\n  codeExecutorUrl?: string;\r\n  /** Callback for todo changes */\r\n  onTodoUpdate?: (todos: DeepAgentTodo[]) => void;\r\n  /** Callback for subagent changes */\r\n  onSubagentUpdate?: (subagents: DeepAgentSubagent[]) => void;\r\n}\r\n\r\n/**\r\n * Deep Agent Backend\r\n * \r\n * Extends FilesystemBackend with:\r\n * - SSE streaming for real-time updates\r\n * - Integration with external code executor services\r\n * - Event emission for todos and subagents\r\n */\r\nexport class DeepAgentBackend extends FilesystemBackend implements SandboxBackendProtocol {\r\n  readonly id: string;\r\n  private readonly timeout: number;\r\n  private readonly maxOutputBytes: number;\r\n  private readonly conversationId?: string;\r\n  private readonly sseResponse?: SSEResponse;\r\n  private readonly codeExecutorUrl?: string;\r\n  private readonly onTodoUpdate?: (todos: DeepAgentTodo[]) => void;\r\n  private readonly onSubagentUpdate?: (subagents: DeepAgentSubagent[]) => void;\r\n\r\n  constructor(options: DeepAgentBackendOptions = {}) {\r\n    super({\r\n      rootDir: options.rootDir ?? process.cwd(),\r\n      virtualMode: options.virtualMode ?? true,\r\n      maxFileSizeMb: 10,\r\n    });\r\n\r\n    this.id = `deep-agent-backend-${Date.now().toString(36)}`;\r\n    this.timeout = options.timeout ?? 120_000;\r\n    this.maxOutputBytes = options.maxOutputBytes ?? 100_000;\r\n    this.conversationId = options.conversationId;\r\n    this.sseResponse = options.sseResponse;\r\n    this.codeExecutorUrl = options.codeExecutorUrl;\r\n    this.onTodoUpdate = options.onTodoUpdate;\r\n    this.onSubagentUpdate = options.onSubagentUpdate;\r\n  }\r\n\r\n  /**\r\n   * Execute a command\r\n   * \r\n   * If codeExecutorUrl is configured, uses the external sandboxed executor.\r\n   * Otherwise, logs a warning (shell execution may not be available).\r\n   */\r\n  async execute(command: string): Promise<ExecuteResponse> {\r\n    if (!command || typeof command !== 'string') {\r\n      return {\r\n        output: 'Error: Command must be a non-empty string.',\r\n        exitCode: 1,\r\n        truncated: false,\r\n      };\r\n    }\r\n\r\n    // If we have a code executor URL, use that for sandboxed execution\r\n    if (this.codeExecutorUrl) {\r\n      return this.executeViaCodeExecutor(command);\r\n    }\r\n\r\n    // Log warning - direct shell execution may not be available\r\n    console.warn('[DeepAgentBackend] Shell execution requested but no code executor configured');\r\n    return {\r\n      output: 'Shell execution is not available in this environment. Consider using the code executor tool instead.',\r\n      exitCode: 1,\r\n      truncated: false,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Execute command via external code executor service\r\n   */\r\n  private async executeViaCodeExecutor(command: string): Promise<ExecuteResponse> {\r\n    try {\r\n      const response = await fetch(`${this.codeExecutorUrl}/execute`, {\r\n        method: 'POST',\r\n        headers: { 'Content-Type': 'application/json' },\r\n        body: JSON.stringify({\r\n          code: command,\r\n          language: 'shell',\r\n          timeout: this.timeout,\r\n        }),\r\n        signal: AbortSignal.timeout(this.timeout + 5000),\r\n      });\r\n\r\n      if (!response.ok) {\r\n        return {\r\n          output: `Execution error: ${response.statusText}`,\r\n          exitCode: 1,\r\n          truncated: false,\r\n        };\r\n      }\r\n\r\n      const result = await response.json() as {\r\n        output?: string;\r\n        exitCode?: number;\r\n        error?: string;\r\n      };\r\n\r\n      let output = result.output ?? result.error ?? '';\r\n      let truncated = false;\r\n\r\n      if (output.length > this.maxOutputBytes) {\r\n        output = output.slice(0, this.maxOutputBytes) + '\\n... (output truncated)';\r\n        truncated = true;\r\n      }\r\n\r\n      return {\r\n        output,\r\n        exitCode: result.exitCode ?? (result.error ? 1 : 0),\r\n        truncated,\r\n      };\r\n    } catch (error) {\r\n      return {\r\n        output: `Execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\r\n        exitCode: 1,\r\n        truncated: false,\r\n      };\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Send an SSE event to the client\r\n   */\r\n  sendEvent(event: string, data: unknown): void {\r\n    if (this.sseResponse && !this.sseResponse.headersSent) {\r\n      try {\r\n        this.sseResponse.write(`event: ${event}\\ndata: ${JSON.stringify(data)}\\n\\n`);\r\n      } catch (e) {\r\n        console.warn('[DeepAgentBackend] Failed to send SSE event:', e);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Emit todo update event\r\n   */\r\n  emitTodoUpdate(todos: DeepAgentTodo[]): void {\r\n    // Call callback if provided\r\n    if (this.onTodoUpdate) {\r\n      this.onTodoUpdate(todos);\r\n    }\r\n\r\n    // Send SSE event\r\n    this.sendEvent('deep_research', {\r\n      type: 'todo_update',\r\n      conversationId: this.conversationId,\r\n      todos,\r\n      progress: this.calculateProgress(todos),\r\n      isRunning: todos.some(t => t.status === 'in_progress'),\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Emit subagent update event\r\n   */\r\n  emitSubagentUpdate(subagents: DeepAgentSubagent[]): void {\r\n    // Call callback if provided\r\n    if (this.onSubagentUpdate) {\r\n      this.onSubagentUpdate(subagents);\r\n    }\r\n\r\n    // Send SSE event\r\n    this.sendEvent('deep_research', {\r\n      type: 'subagent_update',\r\n      conversationId: this.conversationId,\r\n      subagents,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Calculate progress from todos\r\n   */\r\n  private calculateProgress(todos: DeepAgentTodo[]): number {\r\n    if (todos.length === 0) return 0;\r\n    const completed = todos.filter(t => t.status === 'completed').length;\r\n    return Math.round((completed / todos.length) * 100);\r\n  }\r\n}\r\n"],"names":[],"mappings":"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"}