illuma-agents 1.0.49 → 1.0.51

package/src/tools/search/schema.ts

@@ -1,5 +1,3 @@
-import { z } from 'zod';
-
 export enum DATE_RANGE {
   PAST_HOUR = 'h',
   PAST_24_HOURS = 'd',
@@ -38,26 +36,33 @@ Examples:
 - "in" for India
 `.trim();
 
-export const querySchema = z.string().describe(DEFAULT_QUERY_DESCRIPTION);
-export const dateSchema = z
-  .nativeEnum(DATE_RANGE)
-  .optional()
-  .describe('Date range for search results.');
-export const countrySchema = z
-  .string()
-  .optional()
-  .describe(DEFAULT_COUNTRY_DESCRIPTION);
-export const imagesSchema = z
-  .boolean()
-  .optional()
-  .describe('Whether to also run an image search.');
-
-export const videosSchema = z
-  .boolean()
-  .optional()
-  .describe('Whether to also run a video search.');
-
-export const newsSchema = z
-  .boolean()
-  .optional()
-  .describe('Whether to also run a news search.');
+export const querySchema = {
+  type: 'string',
+  description: DEFAULT_QUERY_DESCRIPTION,
+} as const;
+
+export const dateSchema = {
+  type: 'string',
+  enum: Object.values(DATE_RANGE),
+  description: 'Date range for search results.',
+} as const;
+
+export const countrySchema = {
+  type: 'string',
+  description: DEFAULT_COUNTRY_DESCRIPTION,
+} as const;
+
+export const imagesSchema = {
+  type: 'boolean',
+  description: 'Whether to also run an image search.',
+} as const;
+
+export const videosSchema = {
+  type: 'boolean',
+  description: 'Whether to also run a video search.',
+} as const;
+
+export const newsSchema = {
+  type: 'boolean',
+  description: 'Whether to also run a news search.',
+} as const;

package/src/tools/search/tool.ts

@@ -1,4 +1,3 @@
-import { z } from 'zod';
 import { tool, DynamicStructuredTool } from '@langchain/core/tools';
 import type { RunnableConfig } from '@langchain/core/runnables';
 import type * as t from './types';
@@ -422,12 +421,13 @@ function createTool({
   search,
   onSearchResults: _onSearchResults,
 }: {
-  schema: t.SearchToolSchema;
+  schema: Record<string, unknown>;
   search: ReturnType<typeof createSearchProcessor>;
   onSearchResults: t.SearchToolConfig['onSearchResults'];
-}): DynamicStructuredTool<typeof schema> {
-  return tool<typeof schema>(
-    async (params, runnableConfig) => {
+}): DynamicStructuredTool {
+  return tool(
+    async (rawParams, runnableConfig) => {
+      const params = rawParams as SearchToolParams;
       const { query, date, country: _c, images, videos, news } = params;
       const country = typeof _c === 'string' && _c ? _c : undefined;
 
@@ -531,9 +531,19 @@ Use anchor marker(s) immediately after the statement:
  * @param config - The search tool configuration
  * @returns A DynamicStructuredTool with a schema that depends on the searchProvider
  */
+/** Input params type for search tool */
+interface SearchToolParams {
+  query: string;
+  date?: DATE_RANGE;
+  country?: string;
+  images?: boolean;
+  videos?: boolean;
+  news?: boolean;
+}
+
 export const createSearchTool = (
   config: t.SearchToolConfig = {}
-): DynamicStructuredTool<typeof toolSchema> => {
+): DynamicStructuredTool => {
   const {
     searchProvider = 'serper',
     serperApiKey,
@@ -560,14 +570,7 @@ export const createSearchTool = (
 
   const logger = config.logger || createDefaultLogger();
 
-  const schemaObject: {
-    query: z.ZodString;
-    date: z.ZodOptional<z.ZodNativeEnum<typeof DATE_RANGE>>;
-    country?: z.ZodOptional<z.ZodString>;
-    images: z.ZodOptional<z.ZodBoolean>;
-    videos: z.ZodOptional<z.ZodBoolean>;
-    news: z.ZodOptional<z.ZodBoolean>;
-  } = {
+  const schemaProperties: Record<string, unknown> = {
     query: querySchema,
     date: dateSchema,
     images: imagesSchema,
@@ -576,10 +579,14 @@ export const createSearchTool = (
   };
 
   if (searchProvider === 'serper') {
-    schemaObject.country = countrySchema;
+    schemaProperties.country = countrySchema;
   }
 
-  const toolSchema = z.object(schemaObject);
+  const toolSchema = {
+    type: 'object',
+    properties: schemaProperties,
+    required: ['query'],
+  };
 
   const searchAPI = createSearchAPI({
     searchProvider,

package/src/tools/search/types.ts

@@ -1,4 +1,3 @@
-import { z } from 'zod';
 import type { Logger as WinstonLogger } from 'winston';
 import type { RunnableConfig } from '@langchain/core/runnables';
 import type { BaseReranker } from './rerankers';
@@ -659,31 +658,8 @@ export type ProcessSourcesFields = {
   skipScraping?: boolean;
 };
 
-export type SearchToolSchema = z.ZodObject<
-  {
-    query: z.ZodString;
-    date: z.ZodOptional<z.ZodNativeEnum<typeof DATE_RANGE>>;
-    country?: z.ZodOptional<z.ZodString>;
-    images: z.ZodOptional<z.ZodBoolean>;
-    videos: z.ZodOptional<z.ZodBoolean>;
-    news: z.ZodOptional<z.ZodBoolean>;
-  },
-  'strip',
-  z.ZodTypeAny,
-  {
-    query: string;
-    date?: DATE_RANGE;
-    country?: unknown;
-    images?: boolean;
-    videos?: boolean;
-    news?: boolean;
-  },
-  {
-    query: string;
-    date?: DATE_RANGE;
-    country?: unknown;
-    images?: boolean;
-    videos?: boolean;
-    news?: boolean;
-  }
->;
+export interface SearchToolSchema {
+  type: 'object';
+  properties: Record<string, unknown>;
+  required: string[];
+}

package/src/types/graph.ts

@@ -420,6 +420,25 @@ export interface StructuredOutputConfig {
   includeRaw?: boolean;
 }
 
+/**
+ * Database/API structured output format (snake_case with enabled flag).
+ * This matches the format stored in MongoDB and sent from frontends.
+ */
+export interface StructuredOutputInput {
+  /** Whether structured output is enabled */
+  enabled?: boolean;
+  /** JSON Schema defining the expected response structure */
+  schema?: Record<string, unknown>;
+  /** Name identifier for the structured output */
+  name?: string;
+  /** Description of what the structured output represents */
+  description?: string;
+  /** Mode for structured output: 'tool' | 'provider' | 'auto' */
+  mode?: StructuredOutputMode;
+  /** Whether to enforce strict schema validation */
+  strict?: boolean;
+}
+
 export interface AgentInputs {
   agentId: string;
   /** Human-readable name for the agent (used in handoff context). Defaults to agentId if not provided. */
@@ -450,9 +469,22 @@ export interface AgentInputs {
    */
   dynamicContext?: string;
   /**
-   * Structured output configuration.
+   * Structured output configuration (camelCase).
    * When set, disables streaming and returns a validated JSON response
    * conforming to the specified schema.
    */
   structuredOutput?: StructuredOutputConfig;
+  /**
+   * Structured output configuration (snake_case - database/API format).
+   * Alternative to structuredOutput for compatibility with MongoDB/frontend.
+   * Uses an `enabled` flag to control activation.
+   * @deprecated Use structuredOutput instead when possible
+   */
+  structured_output?: StructuredOutputInput;
+  /**
+   * Serializable tool definitions for event-driven execution.
+   * When provided, ToolNode operates in event-driven mode, dispatching
+   * ON_TOOL_EXECUTE events instead of invoking tools directly.
+   */
+  toolDefinitions?: LCTool[];
 }

package/src/types/tools.ts

@@ -41,6 +41,12 @@ export type ToolNodeOptions = {
   toolRegistry?: LCToolRegistry;
   /** Reference to Graph's sessions map for automatic session injection */
   sessions?: ToolSessionMap;
+  /** When true, dispatches ON_TOOL_EXECUTE events instead of invoking tools directly */
+  eventDrivenMode?: boolean;
+  /** Tool definitions for event-driven mode (used for context, not invocation) */
+  toolDefinitions?: Map<string, LCTool>;
+  /** Agent ID for event-driven mode (used to identify which agent's context to use) */
+  agentId?: string;
 };
 
 export type ToolNodeConstructorParams = ToolRefs & ToolNodeOptions;
@@ -125,6 +131,58 @@ export type LCTool = {
    * Options: 'direct', 'code_execution'
    */
   allowed_callers?: AllowedCaller[];
+  /** Response format for the tool output */
+  responseFormat?: 'content' | 'content_and_artifact';
+  /** Server name for MCP tools */
+  serverName?: string;
+  /** Tool type classification */
+  toolType?: 'builtin' | 'mcp' | 'action';
+};
+
+/** Single tool call within a batch request for event-driven execution */
+export type ToolCallRequest = {
+  /** Tool call ID from the LLM */
+  id: string;
+  /** Tool name */
+  name: string;
+  /** Tool arguments */
+  args: Record<string, unknown>;
+  /** Step ID for tracking */
+  stepId?: string;
+  /** Usage turn count for this tool */
+  turn?: number;
+};
+
+/** Batch request containing ALL tool calls for a graph step */
+export type ToolExecuteBatchRequest = {
+  /** All tool calls from the AIMessage */
+  toolCalls: ToolCallRequest[];
+  /** User ID for context */
+  userId?: string;
+  /** Agent ID for context */
+  agentId?: string;
+  /** Runtime configurable from RunnableConfig (includes user, userMCPAuthMap, etc.) */
+  configurable?: Record<string, unknown>;
+  /** Runtime metadata from RunnableConfig (includes thread_id, run_id, provider, etc.) */
+  metadata?: Record<string, unknown>;
+  /** Promise resolver - handler calls this with ALL results */
+  resolve: (results: ToolExecuteResult[]) => void;
+  /** Promise rejector - handler calls this on fatal error */
+  reject: (error: Error) => void;
+};
+
+/** Result for a single tool call in event-driven execution */
+export type ToolExecuteResult = {
+  /** Matches ToolCallRequest.id */
+  toolCallId: string;
+  /** Tool output content */
+  content: string | unknown[];
+  /** Optional artifact (for content_and_artifact format) */
+  artifact?: unknown;
+  /** Execution status */
+  status: 'success' | 'error';
+  /** Error message if status is 'error' */
+  errorMessage?: string;
 };
 
 /** Map of tool names to tool definitions */

package/src/utils/index.ts

@@ -6,3 +6,4 @@ export * from './run';
 export * from './tokens';
 export * from './toonFormat';
 export * from './contextAnalytics';
+export * from './schema';

package/src/utils/schema.ts

@@ -0,0 +1,35 @@
+// src/utils/schema.ts
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import type { ZodTypeAny } from 'zod';
+
+/** Checks if a schema is a Zod schema by looking for the _def property */
+export function isZodSchema(schema: unknown): schema is ZodTypeAny {
+  return (
+    schema != null && typeof schema === 'object' && '_def' in (schema as object)
+  );
+}
+
+/**
+ * Converts a schema to JSON schema format.
+ * Handles both Zod schemas (converts) and JSON schemas (passthrough).
+ */
+export function toJsonSchema(
+  schema: unknown,
+  name?: string,
+  description?: string
+): Record<string, unknown> {
+  if (isZodSchema(schema)) {
+    const zodSchema = schema as ZodTypeAny & {
+      describe: (desc: string) => ZodTypeAny;
+    };
+    const described =
+      description != null && description !== ''
+        ? zodSchema.describe(description)
+        : schema;
+    return zodToJsonSchema(
+      described as Parameters<typeof zodToJsonSchema>[0],
+      name ?? ''
+    );
+  }
+  return schema as Record<string, unknown>;
+}

package/src/utils/title.ts

@@ -1,4 +1,3 @@
-import { z } from 'zod';
 import { ChatPromptTemplate } from '@langchain/core/prompts';
 import { RunnableLambda, RunnableSequence } from '@langchain/core/runnables';
 import type { Runnable, RunnableConfig } from '@langchain/core/runnables';
@@ -12,22 +11,33 @@ const defaultTitlePrompt = `Analyze this conversation and provide:
 
 {convo}`;
 
-const titleSchema = z.object({
-  title: z
-    .string()
-    .describe(
-      'A concise title for the conversation in 5 words or less, without punctuation or quotation'
-    ),
-});
-
-const combinedSchema = z.object({
-  language: z.string().describe('The detected language of the conversation'),
-  title: z
-    .string()
-    .describe(
-      'A concise title for the conversation in 5 words or less, without punctuation or quotation'
-    ),
-});
+const titleSchema = {
+  type: 'object',
+  properties: {
+    title: {
+      type: 'string',
+      description:
+        'A concise title for the conversation in 5 words or less, without punctuation or quotation',
+    },
+  },
+  required: ['title'],
+} as const;
+
+const combinedSchema = {
+  type: 'object',
+  properties: {
+    language: {
+      type: 'string',
+      description: 'The detected language of the conversation',
+    },
+    title: {
+      type: 'string',
+      description:
+        'A concise title for the conversation in 5 words or less, without punctuation or quotation',
+    },
+  },
+  required: ['language', 'title'],
+} as const;
 
 export const createTitleRunnable = async (
   model: t.ChatModelInstance,
@@ -54,7 +64,8 @@ export const createTitleRunnable = async (
       input: { convo: string },
       config?: Partial<RunnableConfig>
     ): Promise<{ title: string }> => {
-      return await titleOnlyInnerChain.invoke(input, config);
+      const result = await titleOnlyInnerChain.invoke(input, config);
+      return result as { title: string };
     },
   }).withConfig({ runName: 'TitleOnlyChain' });
 
@@ -64,7 +75,8 @@ export const createTitleRunnable = async (
       input: { convo: string },
       config?: Partial<RunnableConfig>
     ): Promise<{ language: string; title: string }> => {
-      return await combinedInnerChain.invoke(input, config);
+      const result = await combinedInnerChain.invoke(input, config);
+      return result as { language: string; title: string };
     },
   }).withConfig({ runName: 'TitleLanguageChain' });
 

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 LibreChat
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/cjs/deepagents/DeepAgentBackend.cjs

@@ -1,170 +0,0 @@
-'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

@@ -1 +0,0 @@
-{"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":";;;;AAAA;;;;;;AAMG;AAkCH;;;;;;;AAOG;AACG,MAAO,gBAAiB,SAAQA,4BAAiB,CAAA;AAC5C,IAAA,EAAE;AACM,IAAA,OAAO;AACP,IAAA,cAAc;AACd,IAAA,cAAc;AACd,IAAA,WAAW;AACX,IAAA,eAAe;AACf,IAAA,YAAY;AACZ,IAAA,gBAAgB;AAEjC,IAAA,WAAA,CAAY,UAAmC,EAAE,EAAA;AAC/C,QAAA,KAAK,CAAC;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;AACzC,YAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;AACxC,YAAA,aAAa,EAAE,EAAE;AAClB,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,EAAE,GAAG,CAAA,mBAAA,EAAsB,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;QACzD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO;QACzC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,OAAO;AACvD,QAAA,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc;AAC5C,QAAA,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW;AACtC,QAAA,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe;AAC9C,QAAA,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY;AACxC,QAAA,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB;;AAGlD;;;;;AAKG;IACH,MAAM,OAAO,CAAC,OAAe,EAAA;QAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;YAC3C,OAAO;AACL,gBAAA,MAAM,EAAE,4CAA4C;AACpD,gBAAA,QAAQ,EAAE,CAAC;AACX,gBAAA,SAAS,EAAE,KAAK;aACjB;;;AAIH,QAAA,IAAI,IAAI,CAAC,eAAe,EAAE;AACxB,YAAA,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC;;;AAI7C,QAAA,OAAO,CAAC,IAAI,CAAC,8EAA8E,CAAC;QAC5F,OAAO;AACL,YAAA,MAAM,EAAE,sGAAsG;AAC9G,YAAA,QAAQ,EAAE,CAAC;AACX,YAAA,SAAS,EAAE,KAAK;SACjB;;AAGH;;AAEG;IACK,MAAM,sBAAsB,CAAC,OAAe,EAAA;AAClD,QAAA,IAAI;YACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,eAAe,CAAA,QAAA,CAAU,EAAE;AAC9D,gBAAA,MAAM,EAAE,MAAM;AACd,gBAAA,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;AAC/C,gBAAA,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;AACnB,oBAAA,IAAI,EAAE,OAAO;AACb,oBAAA,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB,CAAC;gBACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;AACjD,aAAA,CAAC;AAEF,YAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;gBAChB,OAAO;AACL,oBAAA,MAAM,EAAE,CAAA,iBAAA,EAAoB,QAAQ,CAAC,UAAU,CAAE,CAAA;AACjD,oBAAA,QAAQ,EAAE,CAAC;AACX,oBAAA,SAAS,EAAE,KAAK;iBACjB;;AAGH,YAAA,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAIjC;YAED,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;YAChD,IAAI,SAAS,GAAG,KAAK;YAErB,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE;AACvC,gBAAA,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,0BAA0B;gBAC1E,SAAS,GAAG,IAAI;;YAGlB,OAAO;gBACL,MAAM;AACN,gBAAA,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;gBACnD,SAAS;aACV;;QACD,OAAO,KAAK,EAAE;YACd,OAAO;AACL,gBAAA,MAAM,EAAE,CAAA,kBAAA,EAAqB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,eAAe,CAAE,CAAA;AACvF,gBAAA,QAAQ,EAAE,CAAC;AACX,gBAAA,SAAS,EAAE,KAAK;aACjB;;;AAIL;;AAEG;IACH,SAAS,CAAC,KAAa,EAAE,IAAa,EAAA;QACpC,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE;AACrD,YAAA,IAAI;AACF,gBAAA,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,KAAK,CAAA,QAAA,EAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA,IAAA,CAAM,CAAC;;YAC5E,OAAO,CAAC,EAAE;AACV,gBAAA,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,CAAC,CAAC;;;;AAKrE;;AAEG;AACH,IAAA,cAAc,CAAC,KAAsB,EAAA;;AAEnC,QAAA,IAAI,IAAI,CAAC,YAAY,EAAE;AACrB,YAAA,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;;;AAI1B,QAAA,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE;AAC9B,YAAA,IAAI,EAAE,aAAa;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK;AACL,YAAA,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;AACvC,YAAA,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC;AACvD,SAAA,CAAC;;AAGJ;;AAEG;AACH,IAAA,kBAAkB,CAAC,SAA8B,EAAA;;AAE/C,QAAA,IAAI,IAAI,CAAC,gBAAgB,EAAE;AACzB,YAAA,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC;;;AAIlC,QAAA,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE;AAC9B,YAAA,IAAI,EAAE,iBAAiB;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,SAAS;AACV,SAAA,CAAC;;AAGJ;;AAEG;AACK,IAAA,iBAAiB,CAAC,KAAsB,EAAA;AAC9C,QAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;AAAE,YAAA,OAAO,CAAC;AAChC,QAAA,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;AACpE,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;;AAEtD;;;;"}