@atom8n/ai-workflow-builder 1.2.0

package/dist/tools/get-node-examples.tool.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetNodeConnectionExamplesTool = exports.createGetNodeConfigurationExamplesTool = void 0;
+exports.createGetNodeExamplesTool = createGetNodeExamplesTool;
+const tools_1 = require("@langchain/core/tools");
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+const helpers_1 = require("./helpers");
+const mermaid_utils_1 = require("./utils/mermaid.utils");
+const node_configuration_utils_1 = require("./utils/node-configuration.utils");
+const templates_1 = require("./web/templates");
+const nodeRequestSchema = zod_1.z.object({
+    nodeType: zod_1.z.string().describe('The exact node type name (e.g., n8n-nodes-base.httpRequest)'),
+    nodeVersion: zod_1.z
+        .number()
+        .optional()
+        .describe('Optional specific node version to filter examples by'),
+});
+const getNodeExamplesSchema = zod_1.z.object({
+    nodes: zod_1.z
+        .array(nodeRequestSchema)
+        .min(1)
+        .max(10)
+        .describe('List of nodes to get examples for (1-10 nodes)'),
+});
+const TOOL_CONFIG = {
+    configuration: {
+        meta: {
+            toolName: 'get_node_configuration_examples',
+            displayTitle: 'Getting node configuration examples',
+        },
+        description: `Get real-world parameter configuration examples for multiple node types from community templates.
+
+Use this tool when you need reference examples for configuring node parameters:
+- When you need to understand proper parameter structure
+- To see how templated workflows configure specific integrations
+
+Parameters:
+- nodes: Array of objects with nodeType (required) and nodeVersion (optional)
+  Example: [{ nodeType: "n8n-nodes-base.httpRequest" }, { nodeType: "n8n-nodes-base.gmail", nodeVersion: 2 }]
+
+Returns markdown-formatted examples showing proven parameter configurations for each node.`,
+    },
+    connections: {
+        meta: {
+            toolName: 'get_node_connection_examples',
+            displayTitle: 'Getting node connection examples',
+        },
+        description: `Get mermaid diagrams showing how specific node types are typically connected in real workflows.
+
+Use this tool when you need to understand node connection patterns:
+- When connecting nodes with non-standard output patterns (e.g., splitInBatches, Switch, IF)
+- To see how nodes are typically placed in workflow flows
+- To understand which nodes typically come before/after specific nodes
+
+Parameters:
+- nodes: Array of objects with nodeType (required) and nodeVersion (optional)
+  Example: [{ nodeType: "n8n-nodes-base.splitInBatches" }, { nodeType: "n8n-nodes-base.if" }]
+
+Returns mermaid diagrams from community workflows containing each node.`,
+    },
+};
+async function getWorkflowsForNodeType(nodeType, logger) {
+    let stateCachedTemplates = [];
+    try {
+        const state = (0, helpers_1.getWorkflowState)();
+        stateCachedTemplates = state?.cachedTemplates ?? [];
+    }
+    catch {
+    }
+    const relevantFromState = stateCachedTemplates.filter((wf) => wf.workflow.nodes.some((n) => n.type === nodeType));
+    if (relevantFromState.length > 0) {
+        const nodeConfigs = (0, node_configuration_utils_1.getNodeConfigurationsFromTemplates)(relevantFromState, nodeType);
+        logger?.debug('Found node configurations in state cache', {
+            nodeType,
+            configCount: nodeConfigs.length,
+            workflowCount: relevantFromState.length,
+        });
+        return {
+            workflows: relevantFromState,
+            nodeConfigs,
+            newTemplates: [],
+        };
+    }
+    try {
+        const result = await (0, templates_1.fetchWorkflowsFromTemplates)({ nodes: nodeType, rows: 5 }, { maxTemplates: 5, logger });
+        if (result.workflows.length > 0) {
+            const nodeConfigs = (0, node_configuration_utils_1.getNodeConfigurationsFromTemplates)(result.workflows, nodeType);
+            logger?.debug('Fetched workflows from templates API', {
+                nodeType,
+                configCount: nodeConfigs.length,
+                workflowCount: result.workflows.length,
+            });
+            return {
+                workflows: result.workflows,
+                nodeConfigs,
+                newTemplates: result.workflows,
+            };
+        }
+    }
+    catch (error) {
+        logger?.warn('Failed to fetch node examples from templates', { nodeType, error });
+    }
+    return {
+        workflows: [],
+        nodeConfigs: [],
+        newTemplates: [],
+    };
+}
+const MAX_EXAMPLES = 1;
+function formatConnectionExamples(nodeType, workflows) {
+    const shortNodeType = nodeType.split('.').pop() ?? nodeType;
+    if (workflows.length === 0) {
+        return `## Node Connection Examples: ${nodeType}\n\nNo connection examples found.`;
+    }
+    const lines = [
+        `## Node Connection Examples: ${nodeType}`,
+        '',
+        `These mermaid diagrams show workflows containing **${shortNodeType}**.`,
+        '',
+        'Look for the target node in each diagram to understand:',
+        '- Which nodes typically come BEFORE this node (incoming connections)',
+        '- Which nodes typically come AFTER this node (outgoing connections)',
+        '- For multi-output nodes like splitInBatches: output 0 = "done" branch, output 1 = "loop" branch',
+        '',
+    ];
+    for (const workflow of workflows.slice(0, MAX_EXAMPLES)) {
+        const mermaid = (0, mermaid_utils_1.mermaidStringify)(workflow, { includeNodeParameters: false });
+        lines.push(`### Example: ${workflow.name}`, '', '```mermaid', mermaid, '```', '');
+    }
+    return lines.join('\n');
+}
+function handleToolError(error, reporter, toolName, config) {
+    if (error instanceof zod_1.z.ZodError) {
+        const validationError = new errors_1.ValidationError('Invalid input parameters', {
+            extra: { errors: error.errors },
+        });
+        reporter.error(validationError);
+        return (0, helpers_1.createErrorResponse)(config, validationError);
+    }
+    const toolError = new errors_1.ToolExecutionError(error instanceof Error ? error.message : 'Unknown error occurred', { toolName, cause: error instanceof Error ? error : undefined });
+    reporter.error(toolError);
+    return (0, helpers_1.createErrorResponse)(config, toolError);
+}
+function createGetNodeExamplesTool({ exampleType, logger }) {
+    const { meta: toolMeta, description } = TOOL_CONFIG[exampleType];
+    const dynamicTool = (0, tools_1.tool)(async (input, config) => {
+        const reporter = (0, helpers_1.createProgressReporter)(config, toolMeta.toolName, toolMeta.displayTitle);
+        try {
+            const validatedInput = getNodeExamplesSchema.parse(input);
+            const { nodes } = validatedInput;
+            reporter.start(validatedInput);
+            (0, helpers_1.reportProgress)(reporter, `Fetching examples for ${nodes.length} node(s)...`);
+            const results = await Promise.all(nodes.map(async ({ nodeType }) => await getWorkflowsForNodeType(nodeType, logger)));
+            const allNewTemplates = [];
+            let totalFound = 0;
+            const allMessages = nodes.map(({ nodeType, nodeVersion }, i) => {
+                const result = results[i];
+                allNewTemplates.push(...result.newTemplates);
+                totalFound +=
+                    exampleType === 'configuration' ? result.nodeConfigs.length : result.workflows.length;
+                return exampleType === 'configuration'
+                    ? (0, node_configuration_utils_1.formatNodeConfigurationExamples)(nodeType, result.nodeConfigs, nodeVersion)
+                    : formatConnectionExamples(nodeType, result.workflows);
+            });
+            const combinedMessage = allMessages.join('\n\n---\n\n');
+            const nodeTypes = nodes.map((n) => n.nodeType);
+            reporter.complete({ nodeTypes, totalFound, message: combinedMessage });
+            const stateUpdates = {};
+            if (allNewTemplates.length > 0) {
+                stateUpdates.cachedTemplates = allNewTemplates;
+            }
+            return (0, helpers_1.createSuccessResponse)(config, combinedMessage, Object.keys(stateUpdates).length > 0 ? stateUpdates : undefined);
+        }
+        catch (error) {
+            return handleToolError(error, reporter, toolMeta.toolName, config);
+        }
+    }, {
+        name: toolMeta.toolName,
+        description,
+        schema: getNodeExamplesSchema,
+    });
+    return { tool: dynamicTool, ...toolMeta };
+}
+const createGetNodeConfigurationExamplesTool = (logger) => createGetNodeExamplesTool({ exampleType: 'configuration', logger });
+exports.createGetNodeConfigurationExamplesTool = createGetNodeConfigurationExamplesTool;
+const createGetNodeConnectionExamplesTool = (logger) => createGetNodeExamplesTool({ exampleType: 'connections', logger });
+exports.createGetNodeConnectionExamplesTool = createGetNodeConnectionExamplesTool;
+//# sourceMappingURL=get-node-examples.tool.js.map

package/dist/tools/get-node-examples.tool.js.map

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

package/dist/tools/get-node-parameter.tool.d.ts

@@ -0,0 +1,4 @@
+import type { Logger } from '@n8n/backend-common';
+import type { BuilderTool, BuilderToolBase } from '../utils/stream-processor';
+export declare const GET_NODE_PARAMETER_TOOL: BuilderToolBase;
+export declare function createGetNodeParameterTool(logger?: Logger): BuilderTool;

package/dist/tools/get-node-parameter.tool.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_NODE_PARAMETER_TOOL = void 0;
+exports.createGetNodeParameterTool = createGetNodeParameterTool;
+const tools_1 = require("@langchain/core/tools");
+const get_1 = __importDefault(require("lodash/get"));
+const zod_1 = require("zod");
+const constants_1 = require("../constants");
+const helpers_1 = require("../tools/helpers");
+const errors_1 = require("../errors");
+const progress_1 = require("./helpers/progress");
+const response_1 = require("./helpers/response");
+const validation_1 = require("./helpers/validation");
+const DISPLAY_TITLE = 'Getting node parameter';
+const getNodeParameterSchema = zod_1.z.object({
+    nodeId: zod_1.z.string().describe('The ID of the node to extract parameter value'),
+    path: zod_1.z
+        .string()
+        .describe('Path to the specific parameter to extract, e.g., "url" or "options.baseUrl"'),
+});
+function extractParameterValue(node, path) {
+    const nodeParameters = node.parameters;
+    return (0, get_1.default)(nodeParameters, path);
+}
+function formatNodeParameter(path, value) {
+    const parts = [];
+    parts.push('<node_parameter>');
+    parts.push('<parameter_path>');
+    parts.push(path);
+    parts.push('</parameter_path>');
+    parts.push('<parameter_value>');
+    if (typeof value === 'string') {
+        parts.push(value);
+    }
+    else {
+        parts.push(JSON.stringify(value, null, 2));
+    }
+    parts.push('</parameter_value>');
+    parts.push('</node_parameter>');
+    return parts.join('\n');
+}
+exports.GET_NODE_PARAMETER_TOOL = {
+    toolName: 'get_node_parameter',
+    displayTitle: DISPLAY_TITLE,
+};
+function createGetNodeParameterTool(logger) {
+    const dynamicTool = (0, tools_1.tool)((input, config) => {
+        const reporter = (0, progress_1.createProgressReporter)(config, exports.GET_NODE_PARAMETER_TOOL.toolName, DISPLAY_TITLE);
+        try {
+            const validatedInput = getNodeParameterSchema.parse(input);
+            const { nodeId, path } = validatedInput;
+            reporter.start(validatedInput);
+            logger?.debug(`Looking up parameter ${path} for ${nodeId}...`);
+            (0, progress_1.reportProgress)(reporter, `Looking up parameter ${path} for ${nodeId}...`);
+            const state = (0, helpers_1.getWorkflowState)();
+            const workflow = (0, helpers_1.getCurrentWorkflow)(state);
+            const node = (0, validation_1.validateNodeExists)(nodeId, workflow.nodes);
+            if (!node) {
+                logger?.debug(`Node with ID ${nodeId} not found`);
+                const error = (0, validation_1.createNodeNotFoundError)(nodeId);
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const parameterValue = extractParameterValue(node, path);
+            if (parameterValue === undefined) {
+                logger?.debug(`Parameter path ${path} not found in node ${node.name}`);
+                const error = new errors_1.ValidationError(`Parameter path "${path}" not found in node "${node.name}"`, {
+                    extra: { nodeId, path },
+                });
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            logger?.debug(`Parameter value for path ${path} in node ${node.name} retrieved`);
+            const formattedParameterValue = formatNodeParameter(path, parameterValue);
+            if (formattedParameterValue.length > constants_1.MAX_PARAMETER_VALUE_LENGTH) {
+                const error = (0, helpers_1.createNodeParameterTooLargeError)(nodeId, path, constants_1.MAX_PARAMETER_VALUE_LENGTH);
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const output = {
+                message: 'Parameter value retrieved successfully',
+            };
+            reporter.complete(output);
+            return (0, response_1.createSuccessResponse)(config, formattedParameterValue);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                const validationError = new errors_1.ValidationError('Invalid input parameters', {
+                    extra: { errors: error.errors },
+                });
+                reporter.error(validationError);
+                return (0, response_1.createErrorResponse)(config, validationError);
+            }
+            const toolError = new errors_1.ToolExecutionError(error instanceof Error ? error.message : 'Unknown error occurred', {
+                toolName: exports.GET_NODE_PARAMETER_TOOL.toolName,
+                cause: error instanceof Error ? error : undefined,
+            });
+            reporter.error(toolError);
+            return (0, response_1.createErrorResponse)(config, toolError);
+        }
+    }, {
+        name: exports.GET_NODE_PARAMETER_TOOL.toolName,
+        description: 'Get the value of a specific parameter of a specific node. Use this ONLY to retrieve parameters omitted in the workflow JSON context because of the size.',
+        schema: getNodeParameterSchema,
+    });
+    return {
+        tool: dynamicTool,
+        ...exports.GET_NODE_PARAMETER_TOOL,
+    };
+}
+//# sourceMappingURL=get-node-parameter.tool.js.map

package/dist/tools/get-node-parameter.tool.js.map

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

package/dist/tools/get-workflow-examples.tool.d.ts

@@ -0,0 +1,34 @@
+import type { Logger } from '@n8n/backend-common';
+import { z } from 'zod';
+import type { BuilderToolBase } from '../utils/stream-processor';
+export declare const GET_WORKFLOW_EXAMPLES_TOOL: BuilderToolBase;
+export declare function createGetWorkflowExamplesTool(logger?: Logger): {
+    toolName: string;
+    displayTitle: string;
+    getCustomDisplayTitle?: (values: Record<string, unknown>) => string;
+    tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        queries: z.ZodArray<z.ZodObject<{
+            search: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            search?: string | undefined;
+        }, {
+            search?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        queries: {
+            search?: string | undefined;
+        }[];
+    }, {
+        queries: {
+            search?: string | undefined;
+        }[];
+    }>, {
+        queries: {
+            search?: string | undefined;
+        }[];
+    }, {
+        queries: {
+            search?: string | undefined;
+        }[];
+    }, import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
+};

package/dist/tools/get-workflow-examples.tool.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_WORKFLOW_EXAMPLES_TOOL = void 0;
+exports.createGetWorkflowExamplesTool = createGetWorkflowExamplesTool;
+const tools_1 = require("@langchain/core/tools");
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+const helpers_1 = require("./helpers");
+const mermaid_utils_1 = require("./utils/mermaid.utils");
+const templates_1 = require("./web/templates");
+const workflowExampleQuerySchema = zod_1.z.object({
+    search: zod_1.z.string().optional().describe('Search term to find workflow examples'),
+});
+const getWorkflowExamplesSchema = zod_1.z.object({
+    queries: zod_1.z
+        .array(workflowExampleQuerySchema)
+        .min(1)
+        .describe('Array of search queries to find workflow examples'),
+});
+function buildQueryIdentifier(query) {
+    const parts = [];
+    if (query.search) {
+        parts.push(`search: ${query.search}`);
+    }
+    return parts.join(',');
+}
+function buildResponseMessage(output) {
+    if (output.examples.length === 0) {
+        return 'No workflow examples found';
+    }
+    const sections = [`Found ${output.totalResults} workflow example(s):`];
+    for (const example of output.examples) {
+        sections.push(`\n## ${example.name}`);
+        if (example.description) {
+            sections.push(example.description);
+        }
+        sections.push(example.workflow);
+    }
+    return sections.join('\n');
+}
+exports.GET_WORKFLOW_EXAMPLES_TOOL = {
+    toolName: 'get_workflow_examples',
+    displayTitle: 'Retrieving workflow examples',
+};
+const TOOL_DESCRIPTION = `Retrieve workflow examples from n8n's workflow library to use as reference for building workflows.
+
+This tool searches for existing workflow examples that match specific criteria.
+The retrieved workflows serve as reference material to understand common patterns, node usage and connections.
+Consider these workflows as ideal solutions.
+The workflows will be returned in a token efficient format rather than JSON.
+
+Usage:
+- Provide search criteria to find relevant workflow examples
+- Results include workflow metadata, summaries, and full workflow data for reference
+
+Parameters:
+- search: Keywords to search for in workflow names/descriptions based on the user prompt`;
+function createGetWorkflowExamplesTool(logger) {
+    const dynamicTool = (0, tools_1.tool)(async (input, config) => {
+        const reporter = (0, helpers_1.createProgressReporter)(config, exports.GET_WORKFLOW_EXAMPLES_TOOL.toolName, exports.GET_WORKFLOW_EXAMPLES_TOOL.displayTitle);
+        try {
+            const validatedInput = getWorkflowExamplesSchema.parse(input);
+            const { queries } = validatedInput;
+            reporter.start(validatedInput);
+            let allResults = [];
+            let allTemplateIds = [];
+            const batchReporter = (0, helpers_1.createBatchProgressReporter)(reporter, 'Retrieving workflow examples');
+            batchReporter.init(queries.length);
+            for (const query of queries) {
+                const identifier = buildQueryIdentifier(query);
+                try {
+                    batchReporter.next(identifier);
+                    const result = await (0, templates_1.fetchWorkflowsFromTemplates)({ search: query.search }, { logger });
+                    allResults = allResults.concat(result.workflows);
+                    allTemplateIds = allTemplateIds.concat(result.templateIds);
+                }
+                catch (error) {
+                    logger?.error('Error fetching workflow examples', { error });
+                }
+            }
+            batchReporter.complete();
+            const uniqueWorkflows = new Map();
+            for (const workflow of allResults) {
+                if (!uniqueWorkflows.has(workflow.name)) {
+                    uniqueWorkflows.set(workflow.name, workflow);
+                }
+            }
+            const deduplicatedResults = Array.from(uniqueWorkflows.values());
+            const processedResults = (0, mermaid_utils_1.processWorkflowExamples)(deduplicatedResults, {
+                includeNodeParameters: false,
+            });
+            const formattedResults = deduplicatedResults.map((workflow, index) => ({
+                name: workflow.name,
+                description: workflow.description,
+                workflow: processedResults[index].mermaid,
+            }));
+            const output = {
+                examples: formattedResults,
+                totalResults: deduplicatedResults.length,
+            };
+            const responseMessage = buildResponseMessage(output);
+            reporter.complete(output);
+            const uniqueTemplateIds = [...new Set(allTemplateIds)];
+            logger?.debug('Caching workflow templates in state', {
+                templateCount: deduplicatedResults.length,
+                templateNames: deduplicatedResults.map((w) => w.name),
+            });
+            return (0, helpers_1.createSuccessResponse)(config, responseMessage, {
+                templateIds: uniqueTemplateIds,
+                cachedTemplates: deduplicatedResults,
+            });
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                const validationError = new errors_1.ValidationError('Invalid input parameters', {
+                    extra: { errors: error.errors },
+                });
+                reporter.error(validationError);
+                return (0, helpers_1.createErrorResponse)(config, validationError);
+            }
+            const toolError = new errors_1.ToolExecutionError(error instanceof Error ? error.message : 'Unknown error occurred', {
+                toolName: exports.GET_WORKFLOW_EXAMPLES_TOOL.toolName,
+                cause: error instanceof Error ? error : undefined,
+            });
+            reporter.error(toolError);
+            return (0, helpers_1.createErrorResponse)(config, toolError);
+        }
+    }, {
+        name: exports.GET_WORKFLOW_EXAMPLES_TOOL.toolName,
+        description: TOOL_DESCRIPTION,
+        schema: getWorkflowExamplesSchema,
+    });
+    return {
+        tool: dynamicTool,
+        ...exports.GET_WORKFLOW_EXAMPLES_TOOL,
+    };
+}
+//# sourceMappingURL=get-workflow-examples.tool.js.map

package/dist/tools/get-workflow-examples.tool.js.map

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

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

@@ -0,0 +1,4 @@
+export * from './progress';
+export * from './response';
+export * from './validation';
+export * from './state';

package/dist/tools/helpers/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./progress"), exports);
+__exportStar(require("./response"), exports);
+__exportStar(require("./validation"), exports);
+__exportStar(require("./state"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,6CAA2B;AAG3B,6CAA2B;AAG3B,+CAA6B;AAG7B,0CAAwB"}

package/dist/tools/helpers/progress.d.ts

@@ -0,0 +1,9 @@
+import type { ToolRunnableConfig } from '@langchain/core/tools';
+import type { LangGraphRunnableConfig } from '@langchain/langgraph';
+import type { ToolError, ProgressReporter, BatchReporter } from '../../types/tools';
+export declare function createProgressReporter<TToolName extends string = string>(config: ToolRunnableConfig & LangGraphRunnableConfig, toolName: TToolName, displayTitle: string, customTitle?: string): ProgressReporter;
+export declare function reportStart<T>(reporter: ProgressReporter, input: T): void;
+export declare function reportProgress(reporter: ProgressReporter, message: string, data?: Record<string, unknown>): void;
+export declare function reportComplete<T>(reporter: ProgressReporter, output: T): void;
+export declare function reportError(reporter: ProgressReporter, error: ToolError): void;
+export declare function createBatchProgressReporter(reporter: ProgressReporter, scope: string): BatchReporter;