@atom8n/ai-workflow-builder 1.2.0

package/dist/subgraphs/configurator.subgraph.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfiguratorSubgraph = exports.ConfiguratorSubgraphState = void 0;
+const prompts_1 = require("@langchain/core/prompts");
+const langgraph_1 = require("@langchain/langgraph");
+const errors_1 = require("../errors");
+const configurator_prompt_1 = require("../prompts/agents/configurator.prompt");
+const subgraph_interface_1 = require("./subgraph-interface");
+const get_node_examples_tool_1 = require("../tools/get-node-examples.tool");
+const get_node_parameter_tool_1 = require("../tools/get-node-parameter.tool");
+const update_node_parameters_tool_1 = require("../tools/update-node-parameters.tool");
+const validate_configuration_tool_1 = require("../tools/validate-configuration.tool");
+const coordination_1 = require("../types/coordination");
+const langchain_1 = require("../types/langchain");
+const cache_control_1 = require("../utils/cache-control");
+const context_builders_1 = require("../utils/context-builders");
+const operations_processor_1 = require("../utils/operations-processor");
+const state_reducers_1 = require("../utils/state-reducers");
+const subgraph_helpers_1 = require("../utils/subgraph-helpers");
+exports.ConfiguratorSubgraphState = langgraph_1.Annotation.Root({
+    workflowJSON: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+        default: () => ({ nodes: [], connections: {}, name: '' }),
+    }),
+    workflowContext: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+    }),
+    instanceUrl: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+        default: () => '',
+    }),
+    userRequest: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+        default: () => '',
+    }),
+    discoveryContext: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+        default: () => null,
+    }),
+    messages: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => x.concat(y),
+        default: () => [],
+    }),
+    workflowOperations: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => {
+            if (y === null)
+                return [];
+            if (!y || y.length === 0)
+                return x ?? [];
+            return [...(x ?? []), ...y];
+        },
+        default: () => [],
+    }),
+    cachedTemplates: (0, langgraph_1.Annotation)({
+        reducer: state_reducers_1.cachedTemplatesReducer,
+        default: () => [],
+    }),
+});
+class ConfiguratorSubgraph extends subgraph_interface_1.BaseSubgraph {
+    name = 'configurator_subgraph';
+    description = 'Configures node parameters after structure is built';
+    agent;
+    toolMap;
+    instanceUrl = '';
+    create(config) {
+        this.instanceUrl = config.instanceUrl ?? '';
+        const includeExamples = config.featureFlags?.templateExamples === true;
+        const baseTools = [
+            (0, update_node_parameters_tool_1.createUpdateNodeParametersTool)(config.parsedNodeTypes, config.llm, config.logger, config.instanceUrl),
+            (0, get_node_parameter_tool_1.createGetNodeParameterTool)(),
+            (0, validate_configuration_tool_1.createValidateConfigurationTool)(config.parsedNodeTypes),
+        ];
+        const tools = includeExamples
+            ? [...baseTools, (0, get_node_examples_tool_1.createGetNodeConfigurationExamplesTool)(config.logger)]
+            : baseTools;
+        this.toolMap = new Map(tools.map((bt) => [bt.tool.name, bt.tool]));
+        const systemPromptTemplate = prompts_1.ChatPromptTemplate.fromMessages([
+            [
+                'system',
+                [
+                    {
+                        type: 'text',
+                        text: (0, configurator_prompt_1.buildConfiguratorPrompt)(),
+                    },
+                    {
+                        type: 'text',
+                        text: configurator_prompt_1.INSTANCE_URL_PROMPT,
+                        cache_control: { type: 'ephemeral' },
+                    },
+                ],
+            ],
+            ['placeholder', '{messages}'],
+        ]);
+        if (typeof config.llm.bindTools !== 'function') {
+            throw new errors_1.LLMServiceError('LLM does not support tools', {
+                llmModel: config.llm._llmType(),
+            });
+        }
+        this.agent = systemPromptTemplate.pipe(config.llm.bindTools(tools.map((bt) => bt.tool)));
+        const callAgent = async (state) => {
+            (0, cache_control_1.applySubgraphCacheMarkers)(state.messages);
+            const response = await this.agent.invoke({
+                messages: state.messages,
+                instanceUrl: state.instanceUrl ?? '',
+            });
+            if (!(0, langchain_1.isBaseMessage)(response)) {
+                throw new errors_1.LLMServiceError('Configurator agent did not return a valid message');
+            }
+            return { messages: [response] };
+        };
+        const subgraph = new langgraph_1.StateGraph(exports.ConfiguratorSubgraphState)
+            .addNode('agent', callAgent)
+            .addNode('tools', async (state) => await (0, subgraph_helpers_1.executeSubgraphTools)(state, this.toolMap))
+            .addNode('process_operations', operations_processor_1.processOperations)
+            .addEdge('__start__', 'agent')
+            .addConditionalEdges('agent', (0, subgraph_helpers_1.createStandardShouldContinue)())
+            .addEdge('tools', 'process_operations')
+            .addEdge('process_operations', 'agent');
+        return subgraph.compile();
+    }
+    transformInput(parentState) {
+        const userRequest = (0, subgraph_helpers_1.extractUserRequest)(parentState.messages);
+        const contextParts = [];
+        if (userRequest) {
+            contextParts.push('=== USER REQUEST ===');
+            contextParts.push(userRequest);
+        }
+        if (parentState.discoveryContext?.bestPractices) {
+            contextParts.push(parentState.discoveryContext.bestPractices);
+        }
+        contextParts.push('=== WORKFLOW TO CONFIGURE ===');
+        contextParts.push((0, context_builders_1.buildWorkflowJsonBlock)(parentState.workflowJSON));
+        contextParts.push('=== EXECUTION CONTEXT ===');
+        contextParts.push((0, context_builders_1.buildExecutionContextBlock)(parentState.workflowContext));
+        const contextMessage = (0, context_builders_1.createContextMessage)(contextParts);
+        return {
+            workflowJSON: parentState.workflowJSON,
+            workflowContext: parentState.workflowContext,
+            instanceUrl: this.instanceUrl,
+            userRequest,
+            discoveryContext: parentState.discoveryContext,
+            messages: [contextMessage],
+            cachedTemplates: parentState.cachedTemplates,
+        };
+    }
+    transformOutput(subgraphOutput, _parentState) {
+        const lastMessage = subgraphOutput.messages[subgraphOutput.messages.length - 1];
+        const setupInstructions = typeof lastMessage?.content === 'string' ? lastMessage.content : 'Configuration complete';
+        const nodesConfigured = subgraphOutput.workflowJSON.nodes.length;
+        const hasSetupInstructions = setupInstructions.includes('Setup') ||
+            setupInstructions.includes('setup') ||
+            setupInstructions.length > 50;
+        const logEntry = {
+            phase: 'configurator',
+            status: 'completed',
+            timestamp: Date.now(),
+            summary: `Configured ${nodesConfigured} nodes`,
+            output: setupInstructions,
+            metadata: (0, coordination_1.createConfiguratorMetadata)({
+                nodesConfigured,
+                hasSetupInstructions,
+            }),
+        };
+        return {
+            workflowJSON: subgraphOutput.workflowJSON,
+            workflowOperations: subgraphOutput.workflowOperations ?? [],
+            coordinationLog: [logEntry],
+            cachedTemplates: subgraphOutput.cachedTemplates,
+        };
+    }
+}
+exports.ConfiguratorSubgraph = ConfiguratorSubgraph;
+//# sourceMappingURL=configurator.subgraph.js.map

package/dist/subgraphs/configurator.subgraph.js.map

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

package/dist/subgraphs/discovery.subgraph.d.ts

@@ -0,0 +1,158 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { BaseMessage, AIMessage } from '@langchain/core/messages';
+import type { Logger } from '@n8n/backend-common';
+import type { INodeTypeDescription } from 'n8n-workflow';
+import type { BuilderFeatureFlags } from '../workflow-builder-agent';
+import { BaseSubgraph } from './subgraph-interface';
+import type { ParentGraphState } from '../parent-graph-state';
+import type { CoordinationLogEntry } from '../types/coordination';
+import type { WorkflowMetadata } from '../types/tools';
+export declare const DiscoverySubgraphState: import("@langchain/langgraph").AnnotationRoot<{
+    userRequest: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage<import("@langchain/core/messages").MessageStructure, import("@langchain/core/messages").MessageType>[], BaseMessage<import("@langchain/core/messages").MessageStructure, import("@langchain/core/messages").MessageType>[]>;
+    nodesFound: import("@langchain/langgraph").BinaryOperatorAggregate<{
+        nodeName: string;
+        version: number;
+        reasoning: string;
+        connectionChangingParameters: Array<{
+            name: string;
+            possibleValues: Array<string | boolean | number>;
+        }>;
+    }[], {
+        nodeName: string;
+        version: number;
+        reasoning: string;
+        connectionChangingParameters: Array<{
+            name: string;
+            possibleValues: Array<string | boolean | number>;
+        }>;
+    }[]>;
+    bestPractices: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+    templateIds: import("@langchain/langgraph").BinaryOperatorAggregate<number[], number[]>;
+    cachedTemplates: import("@langchain/langgraph").BinaryOperatorAggregate<WorkflowMetadata[], WorkflowMetadata[]>;
+}>;
+export interface DiscoverySubgraphConfig {
+    parsedNodeTypes: INodeTypeDescription[];
+    llm: BaseChatModel;
+    logger?: Logger;
+    featureFlags?: BuilderFeatureFlags;
+}
+export declare class DiscoverySubgraph extends BaseSubgraph<DiscoverySubgraphConfig, typeof DiscoverySubgraphState.State, typeof ParentGraphState.State> {
+    name: string;
+    description: string;
+    private agent;
+    private toolMap;
+    private logger?;
+    create(config: DiscoverySubgraphConfig): import("@langchain/langgraph").CompiledStateGraph<{
+        userRequest: string;
+        messages: BaseMessage<import("@langchain/core/messages").MessageStructure, import("@langchain/core/messages").MessageType>[];
+        nodesFound: {
+            nodeName: string;
+            version: number;
+            reasoning: string;
+            connectionChangingParameters: Array<{
+                name: string;
+                possibleValues: Array<string | boolean | number>;
+            }>;
+        }[];
+        bestPractices: string | undefined;
+        templateIds: number[];
+        cachedTemplates: WorkflowMetadata[];
+    }, {
+        userRequest?: string | undefined;
+        messages?: BaseMessage<import("@langchain/core/messages").MessageStructure, import("@langchain/core/messages").MessageType>[] | undefined;
+        nodesFound?: {
+            nodeName: string;
+            version: number;
+            reasoning: string;
+            connectionChangingParameters: Array<{
+                name: string;
+                possibleValues: Array<string | boolean | number>;
+            }>;
+        }[] | undefined;
+        bestPractices?: string | undefined;
+        templateIds?: number[] | undefined;
+        cachedTemplates?: WorkflowMetadata[] | undefined;
+    }, "agent" | "tools" | "__start__" | "format_output", {
+        userRequest: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage<import("@langchain/core/messages").MessageStructure, import("@langchain/core/messages").MessageType>[], BaseMessage<import("@langchain/core/messages").MessageStructure, import("@langchain/core/messages").MessageType>[]>;
+        nodesFound: import("@langchain/langgraph").BinaryOperatorAggregate<{
+            nodeName: string;
+            version: number;
+            reasoning: string;
+            connectionChangingParameters: Array<{
+                name: string;
+                possibleValues: Array<string | boolean | number>;
+            }>;
+        }[], {
+            nodeName: string;
+            version: number;
+            reasoning: string;
+            connectionChangingParameters: Array<{
+                name: string;
+                possibleValues: Array<string | boolean | number>;
+            }>;
+        }[]>;
+        bestPractices: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+        templateIds: import("@langchain/langgraph").BinaryOperatorAggregate<number[], number[]>;
+        cachedTemplates: import("@langchain/langgraph").BinaryOperatorAggregate<WorkflowMetadata[], WorkflowMetadata[]>;
+    }, {
+        userRequest: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage<import("@langchain/core/messages").MessageStructure, import("@langchain/core/messages").MessageType>[], BaseMessage<import("@langchain/core/messages").MessageStructure, import("@langchain/core/messages").MessageType>[]>;
+        nodesFound: import("@langchain/langgraph").BinaryOperatorAggregate<{
+            nodeName: string;
+            version: number;
+            reasoning: string;
+            connectionChangingParameters: Array<{
+                name: string;
+                possibleValues: Array<string | boolean | number>;
+            }>;
+        }[], {
+            nodeName: string;
+            version: number;
+            reasoning: string;
+            connectionChangingParameters: Array<{
+                name: string;
+                possibleValues: Array<string | boolean | number>;
+            }>;
+        }[]>;
+        bestPractices: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+        templateIds: import("@langchain/langgraph").BinaryOperatorAggregate<number[], number[]>;
+        cachedTemplates: import("@langchain/langgraph").BinaryOperatorAggregate<WorkflowMetadata[], WorkflowMetadata[]>;
+    }, import("@langchain/langgraph").StateDefinition, {
+        agent: {
+            messages: AIMessage<import("@langchain/core/messages").MessageStructure>[];
+        };
+        tools: {
+            messages?: BaseMessage[];
+            workflowOperations?: import("..").WorkflowOperation[] | null;
+            templateIds?: number[];
+            cachedTemplates?: WorkflowMetadata[];
+        };
+    }, unknown, unknown>;
+    private callAgent;
+    private formatOutput;
+    private shouldContinue;
+    transformInput(parentState: typeof ParentGraphState.State): {
+        userRequest: string;
+        messages: import("@langchain/core/messages").HumanMessage<import("@langchain/core/messages").MessageStructure>[];
+        cachedTemplates: WorkflowMetadata[];
+    };
+    transformOutput(subgraphOutput: typeof DiscoverySubgraphState.State, _parentState: typeof ParentGraphState.State): {
+        discoveryContext: {
+            nodesFound: {
+                nodeName: string;
+                version: number;
+                reasoning: string;
+                connectionChangingParameters: Array<{
+                    name: string;
+                    possibleValues: Array<string | boolean | number>;
+                }>;
+            }[];
+            bestPractices: string | undefined;
+        };
+        coordinationLog: CoordinationLogEntry[];
+        templateIds: number[];
+        cachedTemplates: WorkflowMetadata[];
+    };
+}

package/dist/subgraphs/discovery.subgraph.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscoverySubgraph = exports.DiscoverySubgraphState = void 0;
+const messages_1 = require("@langchain/core/messages");
+const prompts_1 = require("@langchain/core/prompts");
+const tools_1 = require("@langchain/core/tools");
+const langgraph_1 = require("@langchain/langgraph");
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+const discovery_prompt_1 = require("../prompts/agents/discovery.prompt");
+const subgraph_interface_1 = require("./subgraph-interface");
+const get_best_practices_tool_1 = require("../tools/get-best-practices.tool");
+const get_workflow_examples_tool_1 = require("../tools/get-workflow-examples.tool");
+const node_details_tool_1 = require("../tools/node-details.tool");
+const node_search_tool_1 = require("../tools/node-search.tool");
+const coordination_1 = require("../types/coordination");
+const cache_control_1 = require("../utils/cache-control");
+const context_builders_1 = require("../utils/context-builders");
+const state_reducers_1 = require("../utils/state-reducers");
+const subgraph_helpers_1 = require("../utils/subgraph-helpers");
+const discoveryOutputSchema = zod_1.z.object({
+    nodesFound: zod_1.z
+        .array(zod_1.z.object({
+        nodeName: zod_1.z.string().describe('The internal name of the node (e.g., n8n-nodes-base.gmail)'),
+        version: zod_1.z
+            .number()
+            .describe('The version number of the node (e.g., 1, 1.1, 2, 3, 3.2, etc.)'),
+        reasoning: zod_1.z.string().describe('Why this node is relevant for the workflow'),
+        connectionChangingParameters: zod_1.z
+            .array(zod_1.z.object({
+            name: zod_1.z
+                .string()
+                .describe('Parameter name (e.g., "mode", "operation", "hasOutputParser")'),
+            possibleValues: zod_1.z
+                .array(zod_1.z.union([zod_1.z.string(), zod_1.z.boolean(), zod_1.z.number()]))
+                .describe('Possible values this parameter can take'),
+        }))
+            .describe('Parameters that affect node connections (inputs/outputs). ONLY include if parameter appears in <input> or <output> expressions'),
+    }))
+        .describe('List of n8n nodes identified as necessary for the workflow'),
+});
+exports.DiscoverySubgraphState = langgraph_1.Annotation.Root({
+    userRequest: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+        default: () => '',
+    }),
+    messages: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => x.concat(y),
+        default: () => [],
+    }),
+    nodesFound: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+        default: () => [],
+    }),
+    bestPractices: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+    }),
+    templateIds: (0, langgraph_1.Annotation)({
+        reducer: state_reducers_1.appendArrayReducer,
+        default: () => [],
+    }),
+    cachedTemplates: (0, langgraph_1.Annotation)({
+        reducer: state_reducers_1.cachedTemplatesReducer,
+        default: () => [],
+    }),
+});
+class DiscoverySubgraph extends subgraph_interface_1.BaseSubgraph {
+    name = 'discovery_subgraph';
+    description = 'Discovers nodes and context for the workflow';
+    agent;
+    toolMap;
+    logger;
+    create(config) {
+        this.logger = config.logger;
+        const includeExamples = config.featureFlags?.templateExamples === true;
+        const baseTools = [
+            (0, get_best_practices_tool_1.createGetBestPracticesTool)(),
+            (0, node_search_tool_1.createNodeSearchTool)(config.parsedNodeTypes),
+            (0, node_details_tool_1.createNodeDetailsTool)(config.parsedNodeTypes, config.logger),
+        ];
+        const tools = includeExamples
+            ? [...baseTools, (0, get_workflow_examples_tool_1.createGetWorkflowExamplesTool)(config.logger)]
+            : baseTools;
+        this.toolMap = new Map(tools.map((bt) => [bt.tool.name, bt.tool]));
+        const submitTool = (0, tools_1.tool)(() => { }, {
+            name: 'submit_discovery_results',
+            description: 'Submit the final discovery results',
+            schema: discoveryOutputSchema,
+        });
+        const discoveryPrompt = (0, discovery_prompt_1.buildDiscoveryPrompt)({ includeExamples });
+        const systemPrompt = prompts_1.ChatPromptTemplate.fromMessages([
+            [
+                'system',
+                [
+                    {
+                        type: 'text',
+                        text: discoveryPrompt,
+                        cache_control: { type: 'ephemeral' },
+                    },
+                ],
+            ],
+            ['human', '{prompt}'],
+            ['placeholder', '{messages}'],
+        ]);
+        if (typeof config.llm.bindTools !== 'function') {
+            throw new errors_1.LLMServiceError('LLM does not support tools', {
+                llmModel: config.llm._llmType(),
+            });
+        }
+        const allTools = [...tools.map((bt) => bt.tool), submitTool];
+        this.agent = systemPrompt.pipe(config.llm.bindTools(allTools));
+        const subgraph = new langgraph_1.StateGraph(exports.DiscoverySubgraphState)
+            .addNode('agent', this.callAgent.bind(this))
+            .addNode('tools', async (state) => await (0, subgraph_helpers_1.executeSubgraphTools)(state, this.toolMap))
+            .addNode('format_output', this.formatOutput.bind(this))
+            .addEdge('__start__', 'agent')
+            .addConditionalEdges('agent', this.shouldContinue.bind(this), {
+            tools: 'tools',
+            format_output: 'format_output',
+            end: langgraph_1.END,
+        })
+            .addEdge('tools', 'agent')
+            .addEdge('format_output', langgraph_1.END);
+        return subgraph.compile();
+    }
+    async callAgent(state) {
+        if (state.messages.length > 0) {
+            (0, cache_control_1.applySubgraphCacheMarkers)(state.messages);
+        }
+        const response = (await this.agent.invoke({
+            messages: state.messages,
+            prompt: state.userRequest,
+            techniques: (0, discovery_prompt_1.formatTechniqueList)(),
+            exampleCategorizations: (0, discovery_prompt_1.formatExampleCategorizations)(),
+        }));
+        return { messages: [response] };
+    }
+    formatOutput(state) {
+        const lastMessage = state.messages.at(-1);
+        let output;
+        if (lastMessage && (0, messages_1.isAIMessage)(lastMessage) && lastMessage.tool_calls) {
+            const submitCall = lastMessage.tool_calls.find((tc) => tc.name === 'submit_discovery_results');
+            if (submitCall) {
+                output = submitCall.args;
+            }
+        }
+        if (!output) {
+            this.logger?.error('[Discovery] No submit tool call found in last message');
+            return {
+                nodesFound: [],
+                templateIds: [],
+            };
+        }
+        const bestPracticesTool = state.messages.find((m) => m.getType() === 'tool' && m?.text?.startsWith('<best_practices>'));
+        return {
+            nodesFound: output.nodesFound,
+            bestPractices: bestPracticesTool?.text,
+            templateIds: state.templateIds ?? [],
+        };
+    }
+    shouldContinue(state) {
+        const lastMessage = state.messages[state.messages.length - 1];
+        if (lastMessage &&
+            (0, messages_1.isAIMessage)(lastMessage) &&
+            lastMessage.tool_calls &&
+            lastMessage.tool_calls.length > 0) {
+            const submitCall = lastMessage.tool_calls.find((tc) => tc.name === 'submit_discovery_results');
+            if (submitCall) {
+                return 'format_output';
+            }
+            return 'tools';
+        }
+        this.logger?.warn('[Discovery Subgraph] Agent stopped without submitting results');
+        return 'end';
+    }
+    transformInput(parentState) {
+        const userRequest = (0, subgraph_helpers_1.extractUserRequest)(parentState.messages, 'Build a workflow');
+        const contextParts = [];
+        contextParts.push('<user_request>');
+        contextParts.push(userRequest);
+        contextParts.push('</user_request>');
+        if (parentState.workflowJSON.nodes.length > 0) {
+            contextParts.push('<existing_workflow_summary>');
+            contextParts.push((0, context_builders_1.buildWorkflowSummary)(parentState.workflowJSON));
+            contextParts.push('</existing_workflow_summary>');
+        }
+        const contextMessage = (0, context_builders_1.createContextMessage)(contextParts);
+        return {
+            userRequest,
+            messages: [contextMessage],
+            cachedTemplates: parentState.cachedTemplates,
+        };
+    }
+    transformOutput(subgraphOutput, _parentState) {
+        const nodesFound = subgraphOutput.nodesFound || [];
+        const templateIds = subgraphOutput.templateIds || [];
+        const discoveryContext = {
+            nodesFound,
+            bestPractices: subgraphOutput.bestPractices,
+        };
+        const logEntry = {
+            phase: 'discovery',
+            status: 'completed',
+            timestamp: Date.now(),
+            summary: `Discovered ${nodesFound.length} nodes`,
+            metadata: (0, coordination_1.createDiscoveryMetadata)({
+                nodesFound: nodesFound.length,
+                nodeTypes: nodesFound.map((n) => n.nodeName),
+                hasBestPractices: !!subgraphOutput.bestPractices,
+            }),
+        };
+        return {
+            discoveryContext,
+            coordinationLog: [logEntry],
+            templateIds,
+            cachedTemplates: subgraphOutput.cachedTemplates,
+        };
+    }
+}
+exports.DiscoverySubgraph = DiscoverySubgraph;
+//# sourceMappingURL=discovery.subgraph.js.map

package/dist/subgraphs/discovery.subgraph.js.map

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

package/dist/subgraphs/subgraph-interface.d.ts

@@ -0,0 +1,23 @@
+type StateRecord = Record<string, unknown>;
+interface InvokeConfig {
+    recursionLimit?: number;
+}
+export interface ISubgraph<TConfig = unknown, TChildState extends StateRecord = StateRecord, TParentState extends StateRecord = StateRecord> {
+    name: string;
+    description: string;
+    create(config: TConfig): {
+        invoke: (input: Partial<TChildState>, config?: InvokeConfig) => Promise<TChildState>;
+    };
+    transformInput: (parentState: TParentState) => Partial<TChildState>;
+    transformOutput: (childOutput: TChildState, parentState: TParentState) => Partial<TParentState>;
+}
+export declare abstract class BaseSubgraph<TConfig = unknown, TChildState extends StateRecord = StateRecord, TParentState extends StateRecord = StateRecord> implements ISubgraph<TConfig, TChildState, TParentState> {
+    abstract name: string;
+    abstract description: string;
+    abstract create(config: TConfig): {
+        invoke: (input: Partial<TChildState>, config?: InvokeConfig) => Promise<TChildState>;
+    };
+    abstract transformInput(parentState: TParentState): Partial<TChildState>;
+    abstract transformOutput(childOutput: TChildState, parentState: TParentState): Partial<TParentState>;
+}
+export {};

package/dist/subgraphs/subgraph-interface.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSubgraph = void 0;
+class BaseSubgraph {
+}
+exports.BaseSubgraph = BaseSubgraph;
+//# sourceMappingURL=subgraph-interface.js.map

package/dist/subgraphs/subgraph-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph-interface.js","sourceRoot":"","sources":["../../src/subgraphs/subgraph-interface.ts"],"names":[],"mappings":";;;AAoBA,MAAsB,YAAY;CA2BjC;AA3BD,oCA2BC"}