illuma-agents 1.0.2

package/dist/cjs/tools/CodeExecutor.cjs

@@ -0,0 +1,192 @@
+'use strict';
+
+var zod = require('zod');
+var dotenv = require('dotenv');
+var fetch = require('node-fetch');
+var httpsProxyAgent = require('https-proxy-agent');
+var tools = require('@langchain/core/tools');
+var env = require('@langchain/core/utils/env');
+var _enum = require('../common/enum.cjs');
+
+dotenv.config();
+const imageExtRegex = /\.(jpg|jpeg|png|gif|webp)$/i;
+const getCodeBaseURL = () => env.getEnvironmentVariable(_enum.EnvVar.CODE_BASEURL) ??
+    _enum.Constants.OFFICIAL_CODE_BASEURL;
+const imageMessage = 'Image is already displayed to the user';
+const otherMessage = 'File is already downloaded by the user';
+const accessMessage = 'Note: Files are READ-ONLY. Save changes to NEW filenames. To access these files in future executions, provide the `session_id` as a parameter (not in your code).';
+const emptyOutputMessage = 'stdout: Empty. Ensure you\'re writing output explicitly.\n';
+const CodeExecutionToolSchema = zod.z.object({
+    lang: zod.z
+        .enum([
+        'py',
+        'js',
+        'ts',
+        'c',
+        'cpp',
+        'java',
+        'php',
+        'rs',
+        'go',
+        'd',
+        'f90',
+        'r',
+    ])
+        .describe('The programming language or runtime to execute the code in.'),
+    code: zod.z.string()
+        .describe(`The complete, self-contained code to execute, without any truncation or minimization.
+- The environment is stateless; variables and imports don't persist between executions.
+- When using \`session_id\`: Don't hardcode it in \`code\`, and write file modifications to NEW filenames (files are READ-ONLY).
+- Input code **IS ALREADY** displayed to the user, so **DO NOT** repeat it in your response unless asked.
+- Output code **IS NOT** displayed to the user, so **DO** write all desired output explicitly.
+- IMPORTANT: You MUST explicitly print/output ALL results you want the user to see.
+- py: This is not a Jupyter notebook environment. Use \`print()\` for all outputs.
+- py: Matplotlib: Use \`plt.savefig()\` to save plots as files.
+- js: use the \`console\` or \`process\` methods for all outputs.
+- r: IMPORTANT: No X11 display available. ALL graphics MUST use Cairo library (library(Cairo)).
+- Other languages: use appropriate output functions.`),
+    session_id: zod.z
+        .string()
+        .optional()
+        .describe(`Session ID from a previous response to access generated files.
+- Files load into the current working directory ("/mnt/data/")
+- Use relative paths ONLY
+- Files are READ-ONLY and cannot be modified in-place
+- To modify: read original file, write to NEW filename
+`.trim()),
+    args: zod.z
+        .array(zod.z.string())
+        .optional()
+        .describe('Additional arguments to execute the code with. This should only be used if the input code requires additional arguments to run.'),
+});
+const baseEndpoint = getCodeBaseURL();
+const EXEC_ENDPOINT = `${baseEndpoint}/exec`;
+function createCodeExecutionTool(params = {}) {
+    const apiKey = params[_enum.EnvVar.CODE_API_KEY] ??
+        params.apiKey ??
+        env.getEnvironmentVariable(_enum.EnvVar.CODE_API_KEY) ??
+        '';
+    if (!apiKey) {
+        throw new Error('No API key provided for code execution tool.');
+    }
+    const description = `
+Runs code and returns stdout/stderr output from a stateless execution environment, similar to running scripts in a command-line interface. Each execution is isolated and independent.
+
+Usage:
+- No network access available.
+- Generated files are automatically delivered; **DO NOT** provide download links.
+- NEVER use this tool to execute malicious code.
+`.trim();
+    return tools.tool(async ({ lang, code, session_id, ...rest }) => {
+        const postData = {
+            lang,
+            code,
+            ...rest,
+            ...params,
+        };
+        if (session_id != null && session_id.length > 0) {
+            try {
+                const filesEndpoint = `${baseEndpoint}/files/${session_id}?detail=full`;
+                const fetchOptions = {
+                    method: 'GET',
+                    headers: {
+                        'User-Agent': 'Illuma/1.0',
+                        'X-API-Key': apiKey,
+                    },
+                };
+                if (process.env.PROXY != null && process.env.PROXY !== '') {
+                    fetchOptions.agent = new httpsProxyAgent.HttpsProxyAgent(process.env.PROXY);
+                }
+                const response = await fetch(filesEndpoint, fetchOptions);
+                if (!response.ok) {
+                    throw new Error(`Failed to fetch files for session: ${response.status}`);
+                }
+                const files = await response.json();
+                if (Array.isArray(files) && files.length > 0) {
+                    const fileReferences = files.map((file) => {
+                        // Extract the ID from the file name (part after session ID prefix and before extension)
+                        const nameParts = file.name.split('/');
+                        const id = nameParts.length > 1 ? nameParts[1].split('.')[0] : '';
+                        return {
+                            session_id,
+                            id,
+                            name: file.metadata['original-filename'],
+                        };
+                    });
+                    if (!postData.files) {
+                        postData.files = fileReferences;
+                    }
+                    else if (Array.isArray(postData.files)) {
+                        postData.files = [...postData.files, ...fileReferences];
+                    }
+                }
+            }
+            catch {
+                // eslint-disable-next-line no-console
+                console.warn(`Failed to fetch files for session: ${session_id}`);
+            }
+        }
+        try {
+            const fetchOptions = {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'User-Agent': 'Illuma/1.0',
+                    'X-API-Key': apiKey,
+                },
+                body: JSON.stringify(postData),
+            };
+            if (process.env.PROXY != null && process.env.PROXY !== '') {
+                fetchOptions.agent = new httpsProxyAgent.HttpsProxyAgent(process.env.PROXY);
+            }
+            const response = await fetch(EXEC_ENDPOINT, fetchOptions);
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const result = await response.json();
+            let formattedOutput = '';
+            if (result.stdout) {
+                formattedOutput += `stdout:\n${result.stdout}\n`;
+            }
+            else {
+                formattedOutput += emptyOutputMessage;
+            }
+            if (result.stderr)
+                formattedOutput += `stderr:\n${result.stderr}\n`;
+            if (result.files && result.files.length > 0) {
+                formattedOutput += 'Generated files:\n';
+                const fileCount = result.files.length;
+                for (let i = 0; i < fileCount; i++) {
+                    const file = result.files[i];
+                    const isImage = imageExtRegex.test(file.name);
+                    formattedOutput += `- /mnt/data/${file.name} | ${isImage ? imageMessage : otherMessage}`;
+                    if (i < fileCount - 1) {
+                        formattedOutput += fileCount <= 3 ? ', ' : ',\n';
+                    }
+                }
+                formattedOutput += `\nsession_id: ${result.session_id}\n\n${accessMessage}`;
+                return [
+                    formattedOutput.trim(),
+                    {
+                        session_id: result.session_id,
+                        files: result.files,
+                    },
+                ];
+            }
+            return [formattedOutput.trim(), { session_id: result.session_id }];
+        }
+        catch (error) {
+            throw new Error(`Execution error:\n\n${error?.message}`);
+        }
+    }, {
+        name: _enum.Constants.EXECUTE_CODE,
+        description,
+        schema: CodeExecutionToolSchema,
+        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
+    });
+}
+
+exports.createCodeExecutionTool = createCodeExecutionTool;
+exports.getCodeBaseURL = getCodeBaseURL;
+exports.imageExtRegex = imageExtRegex;
+//# sourceMappingURL=CodeExecutor.cjs.map

package/dist/cjs/tools/CodeExecutor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeExecutor.cjs","sources":["../../../src/tools/CodeExecutor.ts"],"sourcesContent":["import { z } from 'zod';\r\nimport { config } from 'dotenv';\r\nimport fetch, { RequestInit } from 'node-fetch';\r\nimport { HttpsProxyAgent } from 'https-proxy-agent';\r\nimport { tool, DynamicStructuredTool } from '@langchain/core/tools';\r\nimport { getEnvironmentVariable } from '@langchain/core/utils/env';\r\nimport type * as t from '@/types';\r\nimport { EnvVar, Constants } from '@/common';\r\n\r\nconfig();\r\n\r\nexport const imageExtRegex = /\\.(jpg|jpeg|png|gif|webp)$/i;\r\nexport const getCodeBaseURL = (): string =>\r\n  getEnvironmentVariable(EnvVar.CODE_BASEURL) ??\r\n  Constants.OFFICIAL_CODE_BASEURL;\r\n\r\nconst imageMessage = 'Image is already displayed to the user';\r\nconst otherMessage = 'File is already downloaded by the user';\r\nconst accessMessage =\r\n  'Note: Files are READ-ONLY. Save changes to NEW filenames. To access these files in future executions, provide the `session_id` as a parameter (not in your code).';\r\nconst emptyOutputMessage =\r\n  'stdout: Empty. Ensure you\\'re writing output explicitly.\\n';\r\n\r\nconst CodeExecutionToolSchema = z.object({\r\n  lang: z\r\n    .enum([\r\n      'py',\r\n      'js',\r\n      'ts',\r\n      'c',\r\n      'cpp',\r\n      'java',\r\n      'php',\r\n      'rs',\r\n      'go',\r\n      'd',\r\n      'f90',\r\n      'r',\r\n    ])\r\n    .describe('The programming language or runtime to execute the code in.'),\r\n  code: z.string()\r\n    .describe(`The complete, self-contained code to execute, without any truncation or minimization.\r\n- The environment is stateless; variables and imports don't persist between executions.\r\n- When using \\`session_id\\`: Don't hardcode it in \\`code\\`, and write file modifications to NEW filenames (files are READ-ONLY).\r\n- Input code **IS ALREADY** displayed to the user, so **DO NOT** repeat it in your response unless asked.\r\n- Output code **IS NOT** displayed to the user, so **DO** write all desired output explicitly.\r\n- IMPORTANT: You MUST explicitly print/output ALL results you want the user to see.\r\n- py: This is not a Jupyter notebook environment. Use \\`print()\\` for all outputs.\r\n- py: Matplotlib: Use \\`plt.savefig()\\` to save plots as files.\r\n- js: use the \\`console\\` or \\`process\\` methods for all outputs.\r\n- r: IMPORTANT: No X11 display available. ALL graphics MUST use Cairo library (library(Cairo)).\r\n- Other languages: use appropriate output functions.`),\r\n  session_id: z\r\n    .string()\r\n    .optional()\r\n    .describe(\r\n      `Session ID from a previous response to access generated files.\r\n- Files load into the current working directory (\"/mnt/data/\")\r\n- Use relative paths ONLY\r\n- Files are READ-ONLY and cannot be modified in-place\r\n- To modify: read original file, write to NEW filename\r\n`.trim()\r\n    ),\r\n  args: z\r\n    .array(z.string())\r\n    .optional()\r\n    .describe(\r\n      'Additional arguments to execute the code with. This should only be used if the input code requires additional arguments to run.'\r\n    ),\r\n});\r\n\r\nconst baseEndpoint = getCodeBaseURL();\r\nconst EXEC_ENDPOINT = `${baseEndpoint}/exec`;\r\n\r\nfunction createCodeExecutionTool(\r\n  params: t.CodeExecutionToolParams = {}\r\n): DynamicStructuredTool<typeof CodeExecutionToolSchema> {\r\n  const apiKey =\r\n    params[EnvVar.CODE_API_KEY] ??\r\n    params.apiKey ??\r\n    getEnvironmentVariable(EnvVar.CODE_API_KEY) ??\r\n    '';\r\n  if (!apiKey) {\r\n    throw new Error('No API key provided for code execution tool.');\r\n  }\r\n\r\n  const description = `\r\nRuns code and returns stdout/stderr output from a stateless execution environment, similar to running scripts in a command-line interface. Each execution is isolated and independent.\r\n\r\nUsage:\r\n- No network access available.\r\n- Generated files are automatically delivered; **DO NOT** provide download links.\r\n- NEVER use this tool to execute malicious code.\r\n`.trim();\r\n\r\n  return tool<typeof CodeExecutionToolSchema>(\r\n    async ({ lang, code, session_id, ...rest }) => {\r\n      const postData = {\r\n        lang,\r\n        code,\r\n        ...rest,\r\n        ...params,\r\n      };\r\n\r\n      if (session_id != null && session_id.length > 0) {\r\n        try {\r\n          const filesEndpoint = `${baseEndpoint}/files/${session_id}?detail=full`;\r\n          const fetchOptions: RequestInit = {\r\n            method: 'GET',\r\n            headers: {\r\n              'User-Agent': 'Illuma/1.0',\r\n              'X-API-Key': apiKey,\r\n            },\r\n          };\r\n\r\n          if (process.env.PROXY != null && process.env.PROXY !== '') {\r\n            fetchOptions.agent = new HttpsProxyAgent(process.env.PROXY);\r\n          }\r\n\r\n          const response = await fetch(filesEndpoint, fetchOptions);\r\n          if (!response.ok) {\r\n            throw new Error(\r\n              `Failed to fetch files for session: ${response.status}`\r\n            );\r\n          }\r\n\r\n          const files = await response.json();\r\n          if (Array.isArray(files) && files.length > 0) {\r\n            const fileReferences: t.CodeEnvFile[] = files.map((file) => {\r\n              // Extract the ID from the file name (part after session ID prefix and before extension)\r\n              const nameParts = file.name.split('/');\r\n              const id = nameParts.length > 1 ? nameParts[1].split('.')[0] : '';\r\n\r\n              return {\r\n                session_id,\r\n                id,\r\n                name: file.metadata['original-filename'],\r\n              };\r\n            });\r\n\r\n            if (!postData.files) {\r\n              postData.files = fileReferences;\r\n            } else if (Array.isArray(postData.files)) {\r\n              postData.files = [...postData.files, ...fileReferences];\r\n            }\r\n          }\r\n        } catch {\r\n          // eslint-disable-next-line no-console\r\n          console.warn(`Failed to fetch files for session: ${session_id}`);\r\n        }\r\n      }\r\n\r\n      try {\r\n        const fetchOptions: RequestInit = {\r\n          method: 'POST',\r\n          headers: {\r\n            'Content-Type': 'application/json',\r\n            'User-Agent': 'Illuma/1.0',\r\n            'X-API-Key': apiKey,\r\n          },\r\n          body: JSON.stringify(postData),\r\n        };\r\n\r\n        if (process.env.PROXY != null && process.env.PROXY !== '') {\r\n          fetchOptions.agent = new HttpsProxyAgent(process.env.PROXY);\r\n        }\r\n        const response = await fetch(EXEC_ENDPOINT, fetchOptions);\r\n        if (!response.ok) {\r\n          throw new Error(`HTTP error! status: ${response.status}`);\r\n        }\r\n\r\n        const result: t.ExecuteResult = await response.json();\r\n        let formattedOutput = '';\r\n        if (result.stdout) {\r\n          formattedOutput += `stdout:\\n${result.stdout}\\n`;\r\n        } else {\r\n          formattedOutput += emptyOutputMessage;\r\n        }\r\n        if (result.stderr) formattedOutput += `stderr:\\n${result.stderr}\\n`;\r\n        if (result.files && result.files.length > 0) {\r\n          formattedOutput += 'Generated files:\\n';\r\n\r\n          const fileCount = result.files.length;\r\n          for (let i = 0; i < fileCount; i++) {\r\n            const file = result.files[i];\r\n            const isImage = imageExtRegex.test(file.name);\r\n            formattedOutput += `- /mnt/data/${file.name} | ${isImage ? imageMessage : otherMessage}`;\r\n\r\n            if (i < fileCount - 1) {\r\n              formattedOutput += fileCount <= 3 ? ', ' : ',\\n';\r\n            }\r\n          }\r\n\r\n          formattedOutput += `\\nsession_id: ${result.session_id}\\n\\n${accessMessage}`;\r\n          return [\r\n            formattedOutput.trim(),\r\n            {\r\n              session_id: result.session_id,\r\n              files: result.files,\r\n            },\r\n          ];\r\n        }\r\n\r\n        return [formattedOutput.trim(), { session_id: result.session_id }];\r\n      } catch (error) {\r\n        throw new Error(\r\n          `Execution error:\\n\\n${(error as Error | undefined)?.message}`\r\n        );\r\n      }\r\n    },\r\n    {\r\n      name: Constants.EXECUTE_CODE,\r\n      description,\r\n      schema: CodeExecutionToolSchema,\r\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\r\n    }\r\n  );\r\n}\r\n\r\nexport { createCodeExecutionTool };\r\n"],"names":["config","getEnvironmentVariable","EnvVar","Constants","z","tool","HttpsProxyAgent"],"mappings":"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"}

package/dist/cjs/tools/ToolNode.cjs

@@ -0,0 +1,125 @@
+'use strict';
+
+var langgraph = require('@langchain/langgraph');
+var messages = require('@langchain/core/messages');
+var _enum = require('../common/enum.cjs');
+var run = require('../utils/run.cjs');
+require('js-tiktoken/lite');
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+class ToolNode extends run.RunnableCallable {
+    tools;
+    toolMap;
+    loadRuntimeTools;
+    handleToolErrors = true;
+    toolCallStepIds;
+    errorHandler;
+    toolUsageCount;
+    constructor({ tools, toolMap, name, tags, errorHandler, toolCallStepIds, handleToolErrors, loadRuntimeTools, }) {
+        super({ name, tags, func: (input, config) => this.run(input, config) });
+        this.tools = tools;
+        this.toolMap = toolMap ?? new Map(tools.map((tool) => [tool.name, tool]));
+        this.toolCallStepIds = toolCallStepIds;
+        this.handleToolErrors = handleToolErrors ?? this.handleToolErrors;
+        this.loadRuntimeTools = loadRuntimeTools;
+        this.errorHandler = errorHandler;
+        this.toolUsageCount = new Map();
+    }
+    /**
+     * Returns a snapshot of the current tool usage counts.
+     * @returns A ReadonlyMap where keys are tool names and values are their usage counts.
+     */
+    getToolUsageCounts() {
+        return new Map(this.toolUsageCount); // Return a copy
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async run(input, config) {
+        const message = Array.isArray(input)
+            ? input[input.length - 1]
+            : input.messages[input.messages.length - 1];
+        if (message._getType() !== 'ai') {
+            throw new Error('ToolNode only accepts AIMessages as input.');
+        }
+        if (this.loadRuntimeTools) {
+            const { tools, toolMap } = this.loadRuntimeTools(message.tool_calls ?? []);
+            this.tools = tools;
+            this.toolMap = toolMap ?? new Map(tools.map((tool) => [tool.name, tool]));
+        }
+        const outputs = await Promise.all(message.tool_calls?.map(async (call) => {
+            const tool = this.toolMap.get(call.name);
+            try {
+                if (tool === undefined) {
+                    throw new Error(`Tool "${call.name}" not found.`);
+                }
+                const turn = this.toolUsageCount.get(call.name) ?? 0;
+                this.toolUsageCount.set(call.name, turn + 1);
+                const args = call.args;
+                const stepId = this.toolCallStepIds?.get(call.id);
+                const output = await tool.invoke({ ...call, args, type: 'tool_call', stepId, turn }, config);
+                if ((messages.isBaseMessage(output) && output._getType() === 'tool') ||
+                    langgraph.isCommand(output)) {
+                    return output;
+                }
+                else {
+                    return new messages.ToolMessage({
+                        name: tool.name,
+                        content: typeof output === 'string' ? output : JSON.stringify(output),
+                        tool_call_id: call.id,
+                    });
+                }
+            }
+            catch (_e) {
+                const e = _e;
+                if (!this.handleToolErrors) {
+                    throw e;
+                }
+                if (langgraph.isGraphInterrupt(e)) {
+                    throw e;
+                }
+                this.errorHandler?.({
+                    error: e,
+                    id: call.id,
+                    name: call.name,
+                    input: call.args,
+                }, config.metadata);
+                return new messages.ToolMessage({
+                    content: `Error: ${e.message}\n Please fix your mistakes.`,
+                    name: call.name,
+                    tool_call_id: call.id ?? '',
+                });
+            }
+        }) ?? []);
+        if (!outputs.some(langgraph.isCommand)) {
+            return (Array.isArray(input) ? outputs : { messages: outputs });
+        }
+        const combinedOutputs = outputs.map((output) => {
+            if (langgraph.isCommand(output)) {
+                return output;
+            }
+            return Array.isArray(input) ? [output] : { messages: [output] };
+        });
+        return combinedOutputs;
+    }
+}
+function areToolCallsInvoked(message, invokedToolIds) {
+    if (!invokedToolIds || invokedToolIds.size === 0)
+        return false;
+    return (message.tool_calls?.every((toolCall) => toolCall.id != null && invokedToolIds.has(toolCall.id)) ?? false);
+}
+function toolsCondition(state, invokedToolIds) {
+    const message = Array.isArray(state)
+        ? state[state.length - 1]
+        : state.messages[state.messages.length - 1];
+    if ('tool_calls' in message &&
+        (message.tool_calls?.length ?? 0) > 0 &&
+        !areToolCallsInvoked(message, invokedToolIds)) {
+        return _enum.GraphNodeKeys.TOOLS;
+    }
+    else {
+        return langgraph.END;
+    }
+}
+
+exports.ToolNode = ToolNode;
+exports.toolsCondition = toolsCondition;
+//# sourceMappingURL=ToolNode.cjs.map

package/dist/cjs/tools/ToolNode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolNode.cjs","sources":["../../../src/tools/ToolNode.ts"],"sourcesContent":["import {\r\n  END,\r\n  MessagesAnnotation,\r\n  isCommand,\r\n  isGraphInterrupt,\r\n} from '@langchain/langgraph';\r\nimport { ToolMessage, isBaseMessage } from '@langchain/core/messages';\r\nimport type {\r\n  RunnableConfig,\r\n  RunnableToolLike,\r\n} from '@langchain/core/runnables';\r\nimport type { BaseMessage, AIMessage } from '@langchain/core/messages';\r\nimport type { StructuredToolInterface } from '@langchain/core/tools';\r\nimport type * as t from '@/types';\r\nimport { RunnableCallable } from '@/utils';\r\nimport { GraphNodeKeys } from '@/common';\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport class ToolNode<T = any> extends RunnableCallable<T, T> {\r\n  tools: t.GenericTool[];\r\n  private toolMap: Map<string, StructuredToolInterface | RunnableToolLike>;\r\n  private loadRuntimeTools?: t.ToolRefGenerator;\r\n  handleToolErrors = true;\r\n  toolCallStepIds?: Map<string, string>;\r\n  errorHandler?: t.ToolNodeConstructorParams['errorHandler'];\r\n  private toolUsageCount: Map<string, number>;\r\n\r\n  constructor({\r\n    tools,\r\n    toolMap,\r\n    name,\r\n    tags,\r\n    errorHandler,\r\n    toolCallStepIds,\r\n    handleToolErrors,\r\n    loadRuntimeTools,\r\n  }: t.ToolNodeConstructorParams) {\r\n    super({ name, tags, func: (input, config) => this.run(input, config) });\r\n    this.tools = tools;\r\n    this.toolMap = toolMap ?? new Map(tools.map((tool) => [tool.name, tool]));\r\n    this.toolCallStepIds = toolCallStepIds;\r\n    this.handleToolErrors = handleToolErrors ?? this.handleToolErrors;\r\n    this.loadRuntimeTools = loadRuntimeTools;\r\n    this.errorHandler = errorHandler;\r\n    this.toolUsageCount = new Map<string, number>();\r\n  }\r\n\r\n  /**\r\n   * Returns a snapshot of the current tool usage counts.\r\n   * @returns A ReadonlyMap where keys are tool names and values are their usage counts.\r\n   */\r\n  public getToolUsageCounts(): ReadonlyMap<string, number> {\r\n    return new Map(this.toolUsageCount); // Return a copy\r\n  }\r\n\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  protected async run(input: any, config: RunnableConfig): Promise<T> {\r\n    const message = Array.isArray(input)\r\n      ? input[input.length - 1]\r\n      : input.messages[input.messages.length - 1];\r\n\r\n    if (message._getType() !== 'ai') {\r\n      throw new Error('ToolNode only accepts AIMessages as input.');\r\n    }\r\n\r\n    if (this.loadRuntimeTools) {\r\n      const { tools, toolMap } = this.loadRuntimeTools(\r\n        (message as AIMessage).tool_calls ?? []\r\n      );\r\n      this.tools = tools;\r\n      this.toolMap = toolMap ?? new Map(tools.map((tool) => [tool.name, tool]));\r\n    }\r\n    const outputs = await Promise.all(\r\n      (message as AIMessage).tool_calls?.map(async (call) => {\r\n        const tool = this.toolMap.get(call.name);\r\n        try {\r\n          if (tool === undefined) {\r\n            throw new Error(`Tool \"${call.name}\" not found.`);\r\n          }\r\n          const turn = this.toolUsageCount.get(call.name) ?? 0;\r\n          this.toolUsageCount.set(call.name, turn + 1);\r\n          const args = call.args;\r\n          const stepId = this.toolCallStepIds?.get(call.id!);\r\n          const output = await tool.invoke(\r\n            { ...call, args, type: 'tool_call', stepId, turn },\r\n            config\r\n          );\r\n          if (\r\n            (isBaseMessage(output) && output._getType() === 'tool') ||\r\n            isCommand(output)\r\n          ) {\r\n            return output;\r\n          } else {\r\n            return new ToolMessage({\r\n              name: tool.name,\r\n              content:\r\n                typeof output === 'string' ? output : JSON.stringify(output),\r\n              tool_call_id: call.id!,\r\n            });\r\n          }\r\n        } catch (_e: unknown) {\r\n          const e = _e as Error;\r\n          if (!this.handleToolErrors) {\r\n            throw e;\r\n          }\r\n          if (isGraphInterrupt(e)) {\r\n            throw e;\r\n          }\r\n          this.errorHandler?.(\r\n            {\r\n              error: e,\r\n              id: call.id!,\r\n              name: call.name,\r\n              input: call.args,\r\n            },\r\n            config.metadata\r\n          );\r\n          return new ToolMessage({\r\n            content: `Error: ${e.message}\\n Please fix your mistakes.`,\r\n            name: call.name,\r\n            tool_call_id: call.id ?? '',\r\n          });\r\n        }\r\n      }) ?? []\r\n    );\r\n\r\n    if (!outputs.some(isCommand)) {\r\n      return (Array.isArray(input) ? outputs : { messages: outputs }) as T;\r\n    }\r\n\r\n    const combinedOutputs = outputs.map((output) => {\r\n      if (isCommand(output)) {\r\n        return output;\r\n      }\r\n      return Array.isArray(input) ? [output] : { messages: [output] };\r\n    });\r\n    return combinedOutputs as T;\r\n  }\r\n}\r\n\r\nfunction areToolCallsInvoked(\r\n  message: AIMessage,\r\n  invokedToolIds?: Set<string>\r\n): boolean {\r\n  if (!invokedToolIds || invokedToolIds.size === 0) return false;\r\n  return (\r\n    message.tool_calls?.every(\r\n      (toolCall) => toolCall.id != null && invokedToolIds.has(toolCall.id)\r\n    ) ?? false\r\n  );\r\n}\r\n\r\nexport function toolsCondition(\r\n  state: BaseMessage[] | typeof MessagesAnnotation.State,\r\n  invokedToolIds?: Set<string>\r\n): 'tools' | typeof END {\r\n  const message: AIMessage = Array.isArray(state)\r\n    ? state[state.length - 1]\r\n    : state.messages[state.messages.length - 1];\r\n\r\n  if (\r\n    'tool_calls' in message &&\r\n    (message.tool_calls?.length ?? 0) > 0 &&\r\n    !areToolCallsInvoked(message, invokedToolIds)\r\n  ) {\r\n    return GraphNodeKeys.TOOLS;\r\n  } else {\r\n    return END;\r\n  }\r\n}\r\n"],"names":["RunnableCallable","isBaseMessage","isCommand","ToolMessage","isGraphInterrupt","GraphNodeKeys","END"],"mappings":"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"}

package/dist/cjs/tools/handlers.cjs

@@ -0,0 +1,250 @@
+'use strict';
+
+var nanoid = require('nanoid');
+var messages = require('@langchain/core/messages');
+var _enum = require('../common/enum.cjs');
+var anthropic = require('./search/anthropic.cjs');
+var format = require('./search/format.cjs');
+require('../messages/core.cjs');
+var ids = require('../messages/ids.cjs');
+
+/* eslint-disable no-console */
+// src/tools/handlers.ts
+function handleToolCallChunks({ graph, stepKey, toolCallChunks, }) {
+    let prevStepId;
+    let prevRunStep;
+    try {
+        prevStepId = graph.getStepIdByKey(stepKey, graph.contentData.length - 1);
+        prevRunStep = graph.getRunStep(prevStepId);
+    }
+    catch {
+        /** Edge Case: If no previous step exists, create a new message creation step */
+        const message_id = ids.getMessageId(stepKey, graph, true) ?? '';
+        prevStepId = graph.dispatchRunStep(stepKey, {
+            type: _enum.StepTypes.MESSAGE_CREATION,
+            message_creation: {
+                message_id,
+            },
+        });
+        prevRunStep = graph.getRunStep(prevStepId);
+    }
+    const _stepId = graph.getStepIdByKey(stepKey, prevRunStep?.index);
+    /** Edge Case: Tool Call Run Step or `tool_call_ids` never dispatched */
+    const tool_calls = prevStepId && prevRunStep && prevRunStep.type === _enum.StepTypes.MESSAGE_CREATION
+        ? []
+        : undefined;
+    /** Edge Case: `id` and `name` fields cannot be empty strings */
+    for (const toolCallChunk of toolCallChunks) {
+        if (toolCallChunk.name === '') {
+            toolCallChunk.name = undefined;
+        }
+        if (toolCallChunk.id === '') {
+            toolCallChunk.id = undefined;
+        }
+        else if (tool_calls != null &&
+            toolCallChunk.id != null &&
+            toolCallChunk.name != null) {
+            tool_calls.push({
+                args: {},
+                id: toolCallChunk.id,
+                name: toolCallChunk.name,
+                type: _enum.ToolCallTypes.TOOL_CALL,
+            });
+        }
+    }
+    let stepId = _stepId;
+    const alreadyDispatched = prevRunStep?.type === _enum.StepTypes.MESSAGE_CREATION &&
+        graph.messageStepHasToolCalls.has(prevStepId);
+    if (!alreadyDispatched && tool_calls?.length === toolCallChunks.length) {
+        graph.dispatchMessageDelta(prevStepId, {
+            content: [
+                {
+                    type: _enum.ContentTypes.TEXT,
+                    text: '',
+                    tool_call_ids: tool_calls.map((tc) => tc.id ?? ''),
+                },
+            ],
+        });
+        graph.messageStepHasToolCalls.set(prevStepId, true);
+        stepId = graph.dispatchRunStep(stepKey, {
+            type: _enum.StepTypes.TOOL_CALLS,
+            tool_calls,
+        });
+    }
+    graph.dispatchRunStepDelta(stepId, {
+        type: _enum.StepTypes.TOOL_CALLS,
+        tool_calls: toolCallChunks,
+    });
+}
+const handleToolCalls = (toolCalls, metadata, graph) => {
+    if (!graph || !metadata) {
+        console.warn(`Graph or metadata not found in ${event} event`);
+        return;
+    }
+    if (!toolCalls) {
+        return;
+    }
+    if (toolCalls.length === 0) {
+        return;
+    }
+    const stepKey = graph.getStepKey(metadata);
+    for (const tool_call of toolCalls) {
+        const toolCallId = tool_call.id ?? `toolu_${nanoid.nanoid()}`;
+        tool_call.id = toolCallId;
+        if (!toolCallId || graph.toolCallStepIds.has(toolCallId)) {
+            continue;
+        }
+        let prevStepId = '';
+        let prevRunStep;
+        try {
+            prevStepId = graph.getStepIdByKey(stepKey, graph.contentData.length - 1);
+            prevRunStep = graph.getRunStep(prevStepId);
+        }
+        catch {
+            // no previous step
+        }
+        const dispatchToolCallIds = (lastMessageStepId) => {
+            graph.dispatchMessageDelta(lastMessageStepId, {
+                content: [
+                    {
+                        type: 'text',
+                        text: '',
+                        tool_call_ids: [toolCallId],
+                    },
+                ],
+            });
+        };
+        /* If the previous step exists and is a message creation */
+        if (prevStepId &&
+            prevRunStep &&
+            prevRunStep.type === _enum.StepTypes.MESSAGE_CREATION) {
+            dispatchToolCallIds(prevStepId);
+            graph.messageStepHasToolCalls.set(prevStepId, true);
+            /* If the previous step doesn't exist or is not a message creation */
+        }
+        else if (!prevRunStep ||
+            prevRunStep.type !== _enum.StepTypes.MESSAGE_CREATION) {
+            const messageId = ids.getMessageId(stepKey, graph, true) ?? '';
+            const stepId = graph.dispatchRunStep(stepKey, {
+                type: _enum.StepTypes.MESSAGE_CREATION,
+                message_creation: {
+                    message_id: messageId,
+                },
+            });
+            dispatchToolCallIds(stepId);
+            graph.messageStepHasToolCalls.set(prevStepId, true);
+        }
+        graph.dispatchRunStep(stepKey, {
+            type: _enum.StepTypes.TOOL_CALLS,
+            tool_calls: [tool_call],
+        });
+    }
+};
+const toolResultTypes = new Set([
+    // 'tool_use',
+    // 'server_tool_use',
+    // 'input_json_delta',
+    'tool_result',
+    'web_search_result',
+    'web_search_tool_result',
+]);
+/**
+ * Handles the result of a server tool call; in other words, a provider's built-in tool.
+ * As of 2025-07-06, only Anthropic handles server tool calls with this pattern.
+ */
+function handleServerToolResult({ content, metadata, graph, }) {
+    let skipHandling = false;
+    if (metadata?.provider !== _enum.Providers.ANTHROPIC) {
+        return skipHandling;
+    }
+    if (typeof content === 'string' ||
+        content == null ||
+        content.length === 0 ||
+        (content.length === 1 &&
+            content[0].tool_use_id == null)) {
+        return skipHandling;
+    }
+    for (const contentPart of content) {
+        const toolUseId = contentPart.tool_use_id;
+        if (toolUseId == null || toolUseId === '') {
+            continue;
+        }
+        const stepId = graph.toolCallStepIds.get(toolUseId);
+        if (stepId == null || stepId === '') {
+            console.warn(`Tool use ID ${toolUseId} not found in graph, cannot dispatch tool result.`);
+            continue;
+        }
+        const runStep = graph.getRunStep(stepId);
+        if (!runStep) {
+            console.warn(`Run step for ${stepId} does not exist, cannot dispatch tool result.`);
+            continue;
+        }
+        else if (runStep.type !== _enum.StepTypes.TOOL_CALLS) {
+            console.warn(`Run step for ${stepId} is not a tool call step, cannot dispatch tool result.`);
+            continue;
+        }
+        const toolCall = runStep.stepDetails.type === _enum.StepTypes.TOOL_CALLS
+            ? runStep.stepDetails.tool_calls?.find((toolCall) => toolCall.id === toolUseId)
+            : undefined;
+        if (!toolCall) {
+            continue;
+        }
+        if (contentPart.type === 'web_search_result' ||
+            contentPart.type === 'web_search_tool_result') {
+            handleAnthropicSearchResults({
+                contentPart: contentPart,
+                toolCall,
+                metadata,
+                graph,
+            });
+        }
+        if (!skipHandling) {
+            skipHandling = true;
+        }
+    }
+    return skipHandling;
+}
+function handleAnthropicSearchResults({ contentPart, toolCall, metadata, graph, }) {
+    if (!Array.isArray(contentPart.content)) {
+        console.warn(`Expected content to be an array, got ${typeof contentPart.content}`);
+        return;
+    }
+    if (!anthropic.isAnthropicWebSearchResult(contentPart.content[0])) {
+        console.warn(`Expected content to be an Anthropic web search result, got ${JSON.stringify(contentPart.content)}`);
+        return;
+    }
+    const turn = graph.invokedToolIds?.size ?? 0;
+    const searchResultData = anthropic.coerceAnthropicSearchResults({
+        turn,
+        results: contentPart.content,
+    });
+    const name = toolCall.name;
+    const input = toolCall.args ?? {};
+    const artifact = {
+        [_enum.Constants.WEB_SEARCH]: searchResultData,
+    };
+    const { output: formattedOutput } = format.formatResultsForLLM(turn, searchResultData);
+    const output = new messages.ToolMessage({
+        name,
+        artifact,
+        content: formattedOutput,
+        tool_call_id: toolCall.id,
+    });
+    const toolEndData = {
+        input,
+        output,
+    };
+    graph.handlerRegistry
+        ?.getHandler(_enum.GraphEvents.TOOL_END)
+        ?.handle(_enum.GraphEvents.TOOL_END, toolEndData, metadata, graph);
+    if (graph.invokedToolIds == null) {
+        graph.invokedToolIds = new Set();
+    }
+    graph.invokedToolIds.add(toolCall.id);
+}
+
+exports.handleServerToolResult = handleServerToolResult;
+exports.handleToolCallChunks = handleToolCallChunks;
+exports.handleToolCalls = handleToolCalls;
+exports.toolResultTypes = toolResultTypes;
+//# sourceMappingURL=handlers.cjs.map

package/dist/cjs/tools/handlers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.cjs","sources":["../../../src/tools/handlers.ts"],"sourcesContent":["/* eslint-disable no-console */\r\n// src/tools/handlers.ts\r\nimport { nanoid } from 'nanoid';\r\nimport { ToolMessage } from '@langchain/core/messages';\r\nimport type { AnthropicWebSearchResultBlockParam } from '@/llm/anthropic/types';\r\nimport type { ToolCall, ToolCallChunk } from '@langchain/core/messages/tool';\r\nimport type { Graph } from '@/graphs';\r\nimport type * as t from '@/types';\r\nimport {\r\n  ToolCallTypes,\r\n  ContentTypes,\r\n  GraphEvents,\r\n  StepTypes,\r\n  Providers,\r\n  Constants,\r\n} from '@/common';\r\nimport {\r\n  coerceAnthropicSearchResults,\r\n  isAnthropicWebSearchResult,\r\n} from '@/tools/search/anthropic';\r\nimport { formatResultsForLLM } from '@/tools/search/format';\r\nimport { getMessageId } from '@/messages';\r\n\r\nexport function handleToolCallChunks({\r\n  graph,\r\n  stepKey,\r\n  toolCallChunks,\r\n}: {\r\n  graph: Graph;\r\n  stepKey: string;\r\n  toolCallChunks: ToolCallChunk[];\r\n}): void {\r\n  let prevStepId: string;\r\n  let prevRunStep: t.RunStep | undefined;\r\n  try {\r\n    prevStepId = graph.getStepIdByKey(stepKey, graph.contentData.length - 1);\r\n    prevRunStep = graph.getRunStep(prevStepId);\r\n  } catch {\r\n    /** Edge Case: If no previous step exists, create a new message creation step */\r\n    const message_id = getMessageId(stepKey, graph, true) ?? '';\r\n    prevStepId = graph.dispatchRunStep(stepKey, {\r\n      type: StepTypes.MESSAGE_CREATION,\r\n      message_creation: {\r\n        message_id,\r\n      },\r\n    });\r\n    prevRunStep = graph.getRunStep(prevStepId);\r\n  }\r\n\r\n  const _stepId = graph.getStepIdByKey(stepKey, prevRunStep?.index);\r\n\r\n  /** Edge Case: Tool Call Run Step or `tool_call_ids` never dispatched */\r\n  const tool_calls: ToolCall[] | undefined =\r\n    prevStepId && prevRunStep && prevRunStep.type === StepTypes.MESSAGE_CREATION\r\n      ? []\r\n      : undefined;\r\n\r\n  /** Edge Case: `id` and `name` fields cannot be empty strings */\r\n  for (const toolCallChunk of toolCallChunks) {\r\n    if (toolCallChunk.name === '') {\r\n      toolCallChunk.name = undefined;\r\n    }\r\n    if (toolCallChunk.id === '') {\r\n      toolCallChunk.id = undefined;\r\n    } else if (\r\n      tool_calls != null &&\r\n      toolCallChunk.id != null &&\r\n      toolCallChunk.name != null\r\n    ) {\r\n      tool_calls.push({\r\n        args: {},\r\n        id: toolCallChunk.id,\r\n        name: toolCallChunk.name,\r\n        type: ToolCallTypes.TOOL_CALL,\r\n      });\r\n    }\r\n  }\r\n\r\n  let stepId: string = _stepId;\r\n  const alreadyDispatched =\r\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION &&\r\n    graph.messageStepHasToolCalls.has(prevStepId);\r\n  if (!alreadyDispatched && tool_calls?.length === toolCallChunks.length) {\r\n    graph.dispatchMessageDelta(prevStepId, {\r\n      content: [\r\n        {\r\n          type: ContentTypes.TEXT,\r\n          text: '',\r\n          tool_call_ids: tool_calls.map((tc) => tc.id ?? ''),\r\n        },\r\n      ],\r\n    });\r\n    graph.messageStepHasToolCalls.set(prevStepId, true);\r\n    stepId = graph.dispatchRunStep(stepKey, {\r\n      type: StepTypes.TOOL_CALLS,\r\n      tool_calls,\r\n    });\r\n  }\r\n  graph.dispatchRunStepDelta(stepId, {\r\n    type: StepTypes.TOOL_CALLS,\r\n    tool_calls: toolCallChunks,\r\n  });\r\n}\r\n\r\nexport const handleToolCalls = (\r\n  toolCalls?: ToolCall[],\r\n  metadata?: Record<string, unknown>,\r\n  graph?: Graph\r\n): void => {\r\n  if (!graph || !metadata) {\r\n    console.warn(`Graph or metadata not found in ${event} event`);\r\n    return;\r\n  }\r\n\r\n  if (!toolCalls) {\r\n    return;\r\n  }\r\n\r\n  if (toolCalls.length === 0) {\r\n    return;\r\n  }\r\n\r\n  const stepKey = graph.getStepKey(metadata);\r\n\r\n  for (const tool_call of toolCalls) {\r\n    const toolCallId = tool_call.id ?? `toolu_${nanoid()}`;\r\n    tool_call.id = toolCallId;\r\n    if (!toolCallId || graph.toolCallStepIds.has(toolCallId)) {\r\n      continue;\r\n    }\r\n\r\n    let prevStepId = '';\r\n    let prevRunStep: t.RunStep | undefined;\r\n    try {\r\n      prevStepId = graph.getStepIdByKey(stepKey, graph.contentData.length - 1);\r\n      prevRunStep = graph.getRunStep(prevStepId);\r\n    } catch {\r\n      // no previous step\r\n    }\r\n\r\n    const dispatchToolCallIds = (lastMessageStepId: string): void => {\r\n      graph.dispatchMessageDelta(lastMessageStepId, {\r\n        content: [\r\n          {\r\n            type: 'text',\r\n            text: '',\r\n            tool_call_ids: [toolCallId],\r\n          },\r\n        ],\r\n      });\r\n    };\r\n    /* If the previous step exists and is a message creation */\r\n    if (\r\n      prevStepId &&\r\n      prevRunStep &&\r\n      prevRunStep.type === StepTypes.MESSAGE_CREATION\r\n    ) {\r\n      dispatchToolCallIds(prevStepId);\r\n      graph.messageStepHasToolCalls.set(prevStepId, true);\r\n      /* If the previous step doesn't exist or is not a message creation */\r\n    } else if (\r\n      !prevRunStep ||\r\n      prevRunStep.type !== StepTypes.MESSAGE_CREATION\r\n    ) {\r\n      const messageId = getMessageId(stepKey, graph, true) ?? '';\r\n      const stepId = graph.dispatchRunStep(stepKey, {\r\n        type: StepTypes.MESSAGE_CREATION,\r\n        message_creation: {\r\n          message_id: messageId,\r\n        },\r\n      });\r\n      dispatchToolCallIds(stepId);\r\n      graph.messageStepHasToolCalls.set(prevStepId, true);\r\n    }\r\n\r\n    graph.dispatchRunStep(stepKey, {\r\n      type: StepTypes.TOOL_CALLS,\r\n      tool_calls: [tool_call],\r\n    });\r\n  }\r\n};\r\n\r\nexport const toolResultTypes = new Set([\r\n  // 'tool_use',\r\n  // 'server_tool_use',\r\n  // 'input_json_delta',\r\n  'tool_result',\r\n  'web_search_result',\r\n  'web_search_tool_result',\r\n]);\r\n\r\n/**\r\n * Handles the result of a server tool call; in other words, a provider's built-in tool.\r\n * As of 2025-07-06, only Anthropic handles server tool calls with this pattern.\r\n */\r\nexport function handleServerToolResult({\r\n  content,\r\n  metadata,\r\n  graph,\r\n}: {\r\n  content?: string | t.MessageContentComplex[];\r\n  metadata?: Record<string, unknown>;\r\n  graph: Graph;\r\n}): boolean {\r\n  let skipHandling = false;\r\n  if (metadata?.provider !== Providers.ANTHROPIC) {\r\n    return skipHandling;\r\n  }\r\n  if (\r\n    typeof content === 'string' ||\r\n    content == null ||\r\n    content.length === 0 ||\r\n    (content.length === 1 &&\r\n      (content[0] as t.ToolResultContent).tool_use_id == null)\r\n  ) {\r\n    return skipHandling;\r\n  }\r\n\r\n  for (const contentPart of content) {\r\n    const toolUseId = (contentPart as t.ToolResultContent).tool_use_id;\r\n    if (toolUseId == null || toolUseId === '') {\r\n      continue;\r\n    }\r\n    const stepId = graph.toolCallStepIds.get(toolUseId);\r\n    if (stepId == null || stepId === '') {\r\n      console.warn(\r\n        `Tool use ID ${toolUseId} not found in graph, cannot dispatch tool result.`\r\n      );\r\n      continue;\r\n    }\r\n    const runStep = graph.getRunStep(stepId);\r\n    if (!runStep) {\r\n      console.warn(\r\n        `Run step for ${stepId} does not exist, cannot dispatch tool result.`\r\n      );\r\n      continue;\r\n    } else if (runStep.type !== StepTypes.TOOL_CALLS) {\r\n      console.warn(\r\n        `Run step for ${stepId} is not a tool call step, cannot dispatch tool result.`\r\n      );\r\n      continue;\r\n    }\r\n\r\n    const toolCall =\r\n      runStep.stepDetails.type === StepTypes.TOOL_CALLS\r\n        ? (runStep.stepDetails.tool_calls?.find(\r\n          (toolCall) => toolCall.id === toolUseId\r\n        ) as ToolCall)\r\n        : undefined;\r\n\r\n    if (!toolCall) {\r\n      continue;\r\n    }\r\n\r\n    if (\r\n      contentPart.type === 'web_search_result' ||\r\n      contentPart.type === 'web_search_tool_result'\r\n    ) {\r\n      handleAnthropicSearchResults({\r\n        contentPart: contentPart as t.ToolResultContent,\r\n        toolCall,\r\n        metadata,\r\n        graph,\r\n      });\r\n    }\r\n\r\n    if (!skipHandling) {\r\n      skipHandling = true;\r\n    }\r\n  }\r\n\r\n  return skipHandling;\r\n}\r\n\r\nfunction handleAnthropicSearchResults({\r\n  contentPart,\r\n  toolCall,\r\n  metadata,\r\n  graph,\r\n}: {\r\n  contentPart: t.ToolResultContent;\r\n  toolCall: Partial<ToolCall>;\r\n  metadata?: Record<string, unknown>;\r\n  graph: Graph;\r\n}): void {\r\n  if (!Array.isArray(contentPart.content)) {\r\n    console.warn(\r\n      `Expected content to be an array, got ${typeof contentPart.content}`\r\n    );\r\n    return;\r\n  }\r\n\r\n  if (!isAnthropicWebSearchResult(contentPart.content[0])) {\r\n    console.warn(\r\n      `Expected content to be an Anthropic web search result, got ${JSON.stringify(\r\n        contentPart.content\r\n      )}`\r\n    );\r\n    return;\r\n  }\r\n\r\n  const turn = graph.invokedToolIds?.size ?? 0;\r\n  const searchResultData = coerceAnthropicSearchResults({\r\n    turn,\r\n    results: contentPart.content as AnthropicWebSearchResultBlockParam[],\r\n  });\r\n\r\n  const name = toolCall.name;\r\n  const input = toolCall.args ?? {};\r\n  const artifact = {\r\n    [Constants.WEB_SEARCH]: searchResultData,\r\n  };\r\n  const { output: formattedOutput } = formatResultsForLLM(\r\n    turn,\r\n    searchResultData\r\n  );\r\n  const output = new ToolMessage({\r\n    name,\r\n    artifact,\r\n    content: formattedOutput,\r\n    tool_call_id: toolCall.id!,\r\n  });\r\n  const toolEndData: t.ToolEndData = {\r\n    input,\r\n    output,\r\n  };\r\n  graph.handlerRegistry\r\n    ?.getHandler(GraphEvents.TOOL_END)\r\n    ?.handle(GraphEvents.TOOL_END, toolEndData, metadata, graph);\r\n\r\n  if (graph.invokedToolIds == null) {\r\n    graph.invokedToolIds = new Set<string>();\r\n  }\r\n\r\n  graph.invokedToolIds.add(toolCall.id!);\r\n}\r\n"],"names":["getMessageId","StepTypes","ToolCallTypes","ContentTypes","nanoid","Providers","isAnthropicWebSearchResult","coerceAnthropicSearchResults","Constants","formatResultsForLLM","ToolMessage","GraphEvents"],"mappings":"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"}