@n8n/ai-utilities 0.16.1 → 0.18.0

package/dist/cjs/node-catalog/index.js

@@ -0,0 +1,40 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "./node-type-parser", "./search-engine", "./search", "./get", "./suggested", "./suggested-nodes-data", "./discriminator-utils", "./resource-operation-extractor"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.formatResourceOperationsForPrompt = exports.createResourceCacheKey = exports.extractResourceOperations = exports.extractOperationOnlyDiscriminator = exports.extractModeDiscriminator = exports.suggestedNodesData = exports.categoryList = exports.getSuggestedNodes = exports.toSnakeCase = exports.parseNodeId = exports.validatePathWithinBase = exports.isValidPathComponent = exports.getNodeTypes = exports.formatNodeResult = exports.searchCodeBuilderNodes = exports.SCORE_WEIGHTS = exports.CodeBuilderNodeSearchEngine = exports.NodeTypeParser = void 0;
+    var node_type_parser_1 = require("./node-type-parser");
+    Object.defineProperty(exports, "NodeTypeParser", { enumerable: true, get: function () { return node_type_parser_1.NodeTypeParser; } });
+    var search_engine_1 = require("./search-engine");
+    Object.defineProperty(exports, "CodeBuilderNodeSearchEngine", { enumerable: true, get: function () { return search_engine_1.CodeBuilderNodeSearchEngine; } });
+    Object.defineProperty(exports, "SCORE_WEIGHTS", { enumerable: true, get: function () { return search_engine_1.SCORE_WEIGHTS; } });
+    var search_1 = require("./search");
+    Object.defineProperty(exports, "searchCodeBuilderNodes", { enumerable: true, get: function () { return search_1.searchCodeBuilderNodes; } });
+    Object.defineProperty(exports, "formatNodeResult", { enumerable: true, get: function () { return search_1.formatNodeResult; } });
+    var get_1 = require("./get");
+    Object.defineProperty(exports, "getNodeTypes", { enumerable: true, get: function () { return get_1.getNodeTypes; } });
+    Object.defineProperty(exports, "isValidPathComponent", { enumerable: true, get: function () { return get_1.isValidPathComponent; } });
+    Object.defineProperty(exports, "validatePathWithinBase", { enumerable: true, get: function () { return get_1.validatePathWithinBase; } });
+    Object.defineProperty(exports, "parseNodeId", { enumerable: true, get: function () { return get_1.parseNodeId; } });
+    Object.defineProperty(exports, "toSnakeCase", { enumerable: true, get: function () { return get_1.toSnakeCase; } });
+    var suggested_1 = require("./suggested");
+    Object.defineProperty(exports, "getSuggestedNodes", { enumerable: true, get: function () { return suggested_1.getSuggestedNodes; } });
+    Object.defineProperty(exports, "categoryList", { enumerable: true, get: function () { return suggested_1.categoryList; } });
+    var suggested_nodes_data_1 = require("./suggested-nodes-data");
+    Object.defineProperty(exports, "suggestedNodesData", { enumerable: true, get: function () { return suggested_nodes_data_1.suggestedNodesData; } });
+    var discriminator_utils_1 = require("./discriminator-utils");
+    Object.defineProperty(exports, "extractModeDiscriminator", { enumerable: true, get: function () { return discriminator_utils_1.extractModeDiscriminator; } });
+    Object.defineProperty(exports, "extractOperationOnlyDiscriminator", { enumerable: true, get: function () { return discriminator_utils_1.extractOperationOnlyDiscriminator; } });
+    var resource_operation_extractor_1 = require("./resource-operation-extractor");
+    Object.defineProperty(exports, "extractResourceOperations", { enumerable: true, get: function () { return resource_operation_extractor_1.extractResourceOperations; } });
+    Object.defineProperty(exports, "createResourceCacheKey", { enumerable: true, get: function () { return resource_operation_extractor_1.createResourceCacheKey; } });
+    Object.defineProperty(exports, "formatResourceOperationsForPrompt", { enumerable: true, get: function () { return resource_operation_extractor_1.formatResourceOperationsForPrompt; } });
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/node-catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node-catalog/index.ts"],"names":[],"mappings":";;;;;;;;;;;;IAUA,uDAAoD;IAA3C,kHAAA,cAAc,OAAA;IAGvB,iDAA6E;IAApE,4HAAA,2BAA2B,OAAA;IAAE,8GAAA,aAAa,OAAA;IAEnD,mCAAoE;IAA3D,gHAAA,sBAAsB,OAAA;IAAE,0GAAA,gBAAgB,OAAA;IAMjD,6BAMe;IALd,mGAAA,YAAY,OAAA;IACZ,2GAAA,oBAAoB,OAAA;IACpB,6GAAA,sBAAsB,OAAA;IACtB,kGAAA,WAAW,OAAA;IACX,kGAAA,WAAW,OAAA;IAIZ,yCAA8D;IAArD,8GAAA,iBAAiB,OAAA;IAAE,yGAAA,YAAY,OAAA;IAExC,+DAIgC;IAH/B,0HAAA,kBAAkB,OAAA;IAKnB,6DAG+B;IAF9B,+HAAA,wBAAwB,OAAA;IACxB,wIAAA,iCAAiC,OAAA;IASlC,+EAIwC;IAHvC,yIAAA,yBAAyB,OAAA;IACzB,sIAAA,sBAAsB,OAAA;IACtB,iJAAA,iCAAiC,OAAA"}

package/dist/cjs/node-catalog/lean-node-type.d.ts

@@ -0,0 +1,27 @@
+import type { INodeTypeDescription, IRelatedNode } from 'n8n-workflow';
+import { type ModeDiscriminatorInfo, type OperationOnlyDiscriminatorInfo } from './discriminator-utils';
+import { type ResourceOperationInfo } from './resource-operation-extractor';
+export interface VersionDiscriminators {
+    resourceOperations: ResourceOperationInfo | null;
+    modeDiscriminator: ModeDiscriminatorInfo | null;
+    operationDiscriminator: OperationOnlyDiscriminatorInfo | null;
+}
+export interface LeanNodeTypeDescription {
+    name: string;
+    displayName: string;
+    description: string;
+    version: number | number[];
+    group: INodeTypeDescription['group'];
+    inputs: INodeTypeDescription['inputs'];
+    outputs: INodeTypeDescription['outputs'];
+    codex?: {
+        alias?: string[];
+    };
+    builderHint?: {
+        searchHint?: string;
+        relatedNodes?: IRelatedNode[];
+        inputs?: NonNullable<INodeTypeDescription['builderHint']>['inputs'];
+    };
+    discriminatorsByVersion: Map<number, VersionDiscriminators>;
+}
+export declare function toLeanNodeType(node: INodeTypeDescription): LeanNodeTypeDescription;

package/dist/cjs/node-catalog/lean-node-type.js

@@ -0,0 +1,60 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "./discriminator-utils", "./resource-operation-extractor"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.toLeanNodeType = toLeanNodeType;
+    const discriminator_utils_1 = require("./discriminator-utils");
+    const resource_operation_extractor_1 = require("./resource-operation-extractor");
+    function getVersions(node) {
+        return Array.isArray(node.version) ? node.version : [node.version];
+    }
+    function buildVersionDiscriminators(node) {
+        const out = new Map();
+        for (const version of getVersions(node)) {
+            out.set(version, {
+                resourceOperations: (0, resource_operation_extractor_1.extractResourceOperations)(node, version, undefined, {
+                    fields: { description: true, builderHint: true },
+                }),
+                modeDiscriminator: (0, discriminator_utils_1.extractModeDiscriminator)(node, version),
+                operationDiscriminator: (0, discriminator_utils_1.extractOperationOnlyDiscriminator)(node, version),
+            });
+        }
+        return out;
+    }
+    function toLeanNodeType(node) {
+        const lean = {
+            name: node.name,
+            displayName: node.displayName,
+            description: node.description,
+            version: node.version,
+            group: node.group,
+            inputs: node.inputs,
+            outputs: node.outputs,
+            discriminatorsByVersion: buildVersionDiscriminators(node),
+        };
+        if (node.codex?.alias) {
+            lean.codex = { alias: node.codex.alias };
+        }
+        if (node.builderHint) {
+            const { searchHint, relatedNodes, inputs } = node.builderHint;
+            const hint = {};
+            if (searchHint !== undefined)
+                hint.searchHint = searchHint;
+            if (relatedNodes !== undefined)
+                hint.relatedNodes = relatedNodes;
+            if (inputs !== undefined)
+                hint.inputs = inputs;
+            if (Object.keys(hint).length > 0)
+                lean.builderHint = hint;
+        }
+        return lean;
+    }
+});
+//# sourceMappingURL=lean-node-type.js.map

package/dist/cjs/node-catalog/lean-node-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-node-type.js","sourceRoot":"","sources":["../../../src/node-catalog/lean-node-type.ts"],"names":[],"mappings":";;;;;;;;;;;IAuFA,wCA0BC;IAhGD,+DAK+B;IAC/B,iFAGwC;IAmCxC,SAAS,WAAW,CAAC,IAA0B;QAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,SAAS,0BAA0B,CAClC,IAA0B;QAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAiC,CAAC;QACrD,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE;gBAChB,kBAAkB,EAAE,IAAA,wDAAyB,EAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE;oBACvE,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;iBAChD,CAAC;gBACF,iBAAiB,EAAE,IAAA,8CAAwB,EAAC,IAAI,EAAE,OAAO,CAAC;gBAC1D,sBAAsB,EAAE,IAAA,uDAAiC,EAAC,IAAI,EAAE,OAAO,CAAC;aACxE,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;IAQD,SAAgB,cAAc,CAAC,IAA0B;QACxD,MAAM,IAAI,GAA4B;YACrC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,uBAAuB,EAAE,0BAA0B,CAAC,IAAI,CAAC;SACzD,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;YAC9D,MAAM,IAAI,GAA2C,EAAE,CAAC;YACxD,IAAI,UAAU,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAC3D,IAAI,YAAY,KAAK,SAAS;gBAAE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YACjE,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC3D,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC"}

package/dist/cjs/node-catalog/node-type-parser.d.ts

@@ -0,0 +1,20 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+import { type LeanNodeTypeDescription, type VersionDiscriminators } from './lean-node-type';
+export interface ParsedNodeType {
+    id: string;
+    displayName: string;
+    description: string;
+    version: number;
+    isTrigger: boolean;
+}
+export declare class NodeTypeParser {
+    private nodeTypes;
+    private nodeTypeIndex;
+    private searchEngine;
+    constructor(nodeTypes: INodeTypeDescription[]);
+    private buildIndex;
+    private isTriggerNode;
+    searchNodeTypes(query: string, limit?: number, nodeFilter?: (nodeId: string) => boolean): ParsedNodeType[];
+    getLeanNodeType(nodeId: string, version?: number): LeanNodeTypeDescription | null;
+    getVersionDiscriminators(nodeId: string, version: number): VersionDiscriminators | null;
+}

package/dist/cjs/node-catalog/node-type-parser.js

@@ -0,0 +1,79 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "./lean-node-type", "./search-engine"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.NodeTypeParser = void 0;
+    const lean_node_type_1 = require("./lean-node-type");
+    const search_engine_1 = require("./search-engine");
+    class NodeTypeParser {
+        constructor(nodeTypes) {
+            this.nodeTypes = nodeTypes.map(lean_node_type_1.toLeanNodeType);
+            this.searchEngine = new search_engine_1.CodeBuilderNodeSearchEngine(this.nodeTypes);
+            this.nodeTypeIndex = this.buildIndex();
+        }
+        buildIndex() {
+            const index = new Map();
+            for (const nodeType of this.nodeTypes) {
+                const existing = index.get(nodeType.name) ?? [];
+                existing.push(nodeType);
+                index.set(nodeType.name, existing);
+            }
+            return index;
+        }
+        isTriggerNode(nodeType) {
+            if (nodeType.group.includes('trigger')) {
+                return true;
+            }
+            return (nodeType.name.toLowerCase().includes('trigger') ||
+                nodeType.name.toLowerCase().includes('webhook'));
+        }
+        searchNodeTypes(query, limit = 5, nodeFilter) {
+            const results = this.searchEngine.searchByName(query, limit, nodeFilter);
+            return results.map((result) => {
+                const nodeType = this.getLeanNodeType(result.name, result.version);
+                return {
+                    id: result.name,
+                    displayName: result.displayName,
+                    description: result.description,
+                    version: result.version,
+                    isTrigger: nodeType ? this.isTriggerNode(nodeType) : false,
+                };
+            });
+        }
+        getLeanNodeType(nodeId, version) {
+            const versions = this.nodeTypeIndex.get(nodeId);
+            if (!versions || versions.length === 0) {
+                return null;
+            }
+            if (version !== undefined) {
+                const match = versions.find((v) => {
+                    const nodeVersions = Array.isArray(v.version) ? v.version : [v.version];
+                    return nodeVersions.includes(version);
+                });
+                return match ?? null;
+            }
+            return versions.reduce((latest, current) => {
+                const latestMax = Array.isArray(latest.version)
+                    ? Math.max(...latest.version)
+                    : latest.version;
+                const currentMax = Array.isArray(current.version)
+                    ? Math.max(...current.version)
+                    : current.version;
+                return currentMax > latestMax ? current : latest;
+            });
+        }
+        getVersionDiscriminators(nodeId, version) {
+            const node = this.getLeanNodeType(nodeId, version);
+            return node?.discriminatorsByVersion.get(version) ?? null;
+        }
+    }
+    exports.NodeTypeParser = NodeTypeParser;
+});
+//# sourceMappingURL=node-type-parser.js.map

package/dist/cjs/node-catalog/node-type-parser.js.map

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

package/dist/cjs/node-catalog/resource-operation-extractor.d.ts

@@ -0,0 +1,26 @@
+import { type INodeTypeDescription, type IParameterBuilderHint, type Logger } from 'n8n-workflow';
+export interface OperationInfo {
+    value: string;
+    displayName: string;
+    description?: string;
+    builderHint?: IParameterBuilderHint;
+}
+export interface ResourceInfo {
+    value: string;
+    displayName: string;
+    description?: string;
+    builderHint?: IParameterBuilderHint;
+    operations: OperationInfo[];
+}
+export interface ResourceOperationInfo {
+    resources: ResourceInfo[];
+}
+export interface ExtractOptions {
+    fields?: {
+        description?: boolean;
+        builderHint?: boolean;
+    };
+}
+export declare function extractResourceOperations(nodeType: INodeTypeDescription, nodeVersion: number, logger?: Logger, options?: ExtractOptions): ResourceOperationInfo | null;
+export declare function createResourceCacheKey(nodeName: string, version: number): string;
+export declare function formatResourceOperationsForPrompt(info: ResourceOperationInfo): string;

package/dist/cjs/node-catalog/resource-operation-extractor.js

@@ -0,0 +1,166 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "n8n-workflow"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.extractResourceOperations = extractResourceOperations;
+    exports.createResourceCacheKey = createResourceCacheKey;
+    exports.formatResourceOperationsForPrompt = formatResourceOperationsForPrompt;
+    const n8n_workflow_1 = require("n8n-workflow");
+    function isPropertyVisibleForVersion(property, nodeVersion) {
+        const displayOptions = property.displayOptions;
+        if (!displayOptions) {
+            return true;
+        }
+        const showVersion = displayOptions.show?.['@version'];
+        if (showVersion && !(0, n8n_workflow_1.checkConditions)(showVersion, [nodeVersion])) {
+            return false;
+        }
+        const hideVersion = displayOptions.hide?.['@version'];
+        if (hideVersion && (0, n8n_workflow_1.checkConditions)(hideVersion, [nodeVersion])) {
+            return false;
+        }
+        return true;
+    }
+    function findResourceProperty(properties, nodeVersion) {
+        return properties.find((prop) => prop.name === 'resource' &&
+            prop.type === 'options' &&
+            isPropertyVisibleForVersion(prop, nodeVersion));
+    }
+    function isOperationVisibleForResource(prop, resourceValue) {
+        const displayOptions = prop.displayOptions;
+        if (!displayOptions) {
+            return true;
+        }
+        const showResource = displayOptions.show?.resource;
+        if (showResource && !(0, n8n_workflow_1.checkConditions)(showResource, [resourceValue])) {
+            return false;
+        }
+        const hideResource = displayOptions.hide?.resource;
+        if (hideResource && (0, n8n_workflow_1.checkConditions)(hideResource, [resourceValue])) {
+            return false;
+        }
+        return true;
+    }
+    function findOperationProperties(properties, resourceValue, nodeVersion) {
+        return properties.filter((prop) => {
+            if (prop.name !== 'operation' || prop.type !== 'options') {
+                return false;
+            }
+            if (!isPropertyVisibleForVersion(prop, nodeVersion)) {
+                return false;
+            }
+            return isOperationVisibleForResource(prop, resourceValue);
+        });
+    }
+    function extractOptions(property, logger, options) {
+        if (!property.options || !Array.isArray(property.options)) {
+            return [];
+        }
+        const includeDescription = options?.fields?.description ?? false;
+        const includeBuilderHint = options?.fields?.builderHint ?? false;
+        return property.options
+            .filter((opt) => {
+            if (typeof opt !== 'object' || opt === null || !('name' in opt) || !('value' in opt)) {
+                return false;
+            }
+            const optName = opt.name;
+            const optValue = opt.value;
+            if (typeof optValue !== 'string') {
+                logger?.debug('Skipping non-string option value in resource/operation extraction', {
+                    propertyName: property.name,
+                    optionName: optName,
+                    valueType: typeof optValue,
+                });
+                return false;
+            }
+            return true;
+        })
+            .map((opt) => ({
+            value: opt.value,
+            displayName: opt.name,
+            ...(includeDescription && opt.description && { description: opt.description }),
+            ...(includeBuilderHint && opt.builderHint && { builderHint: opt.builderHint }),
+        }));
+    }
+    function extractResourceOperations(nodeType, nodeVersion, logger, options) {
+        const properties = nodeType.properties;
+        if (!properties || properties.length === 0) {
+            logger?.debug('extractResourceOperations: No properties found', {
+                nodeType: nodeType.name,
+                nodeVersion,
+            });
+            return null;
+        }
+        const resourceProperty = findResourceProperty(properties, nodeVersion);
+        if (!resourceProperty) {
+            return null;
+        }
+        const resourceOptions = extractOptions(resourceProperty, logger, options);
+        if (resourceOptions.length === 0) {
+            logger?.warn('extractResourceOperations: Resource property found but no string options', {
+                nodeType: nodeType.name,
+                nodeVersion,
+                propertyDefault: resourceProperty.default,
+            });
+            return null;
+        }
+        const resources = resourceOptions.map((resource) => {
+            const operationProperties = findOperationProperties(properties, resource.value, nodeVersion);
+            const allOperations = [];
+            const seenValues = new Set();
+            for (const opProp of operationProperties) {
+                const ops = extractOptions(opProp, logger, options);
+                for (const op of ops) {
+                    if (!seenValues.has(op.value)) {
+                        seenValues.add(op.value);
+                        allOperations.push({
+                            value: op.value,
+                            displayName: op.displayName,
+                            ...(op.description && { description: op.description }),
+                            ...(op.builderHint && { builderHint: op.builderHint }),
+                        });
+                    }
+                }
+            }
+            return {
+                value: resource.value,
+                displayName: resource.displayName,
+                ...(resource.description && { description: resource.description }),
+                ...(resource.builderHint && { builderHint: resource.builderHint }),
+                operations: allOperations,
+            };
+        });
+        return { resources };
+    }
+    function createResourceCacheKey(nodeName, version) {
+        return `${nodeName}:${version}`;
+    }
+    function formatResourceOperationsForPrompt(info) {
+        const parts = ['<available_resources_and_operations>'];
+        for (const resource of info.resources) {
+            if (resource.value === '__CUSTOM_API_CALL__')
+                continue;
+            parts.push(`  Resource: ${resource.displayName} (value: "${resource.value}")`);
+            const filteredOps = resource.operations.filter((op) => op.value !== '__CUSTOM_API_CALL__');
+            if (filteredOps.length > 0) {
+                parts.push('    Operations:');
+                for (const op of filteredOps) {
+                    parts.push(`      - ${op.displayName} (value: "${op.value}")`);
+                }
+            }
+            else {
+                parts.push('    Operations: none defined');
+            }
+        }
+        parts.push('</available_resources_and_operations>');
+        return parts.join('\n');
+    }
+});
+//# sourceMappingURL=resource-operation-extractor.js.map

package/dist/cjs/node-catalog/resource-operation-extractor.js.map

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

package/dist/cjs/node-catalog/search-engine.d.ts

@@ -0,0 +1,20 @@
+import type { INodeTypeDescription, NodeConnectionType } from 'n8n-workflow';
+import { type LeanNodeTypeDescription } from './lean-node-type';
+import type { CodeBuilderNodeSearchResult } from './types';
+export declare const SCORE_WEIGHTS: {
+    readonly CONNECTION_EXACT: 100;
+    readonly CONNECTION_IN_EXPRESSION: 50;
+};
+export declare class CodeBuilderNodeSearchEngine {
+    private readonly nodeTypes;
+    constructor(nodeTypes: Array<INodeTypeDescription | LeanNodeTypeDescription>);
+    searchByName(query: string, limit?: number, nodeFilter?: (nodeId: string) => boolean): CodeBuilderNodeSearchResult[];
+    searchByConnectionType(connectionType: NodeConnectionType, limit?: number, nameFilter?: string): CodeBuilderNodeSearchResult[];
+    formatResult(result: CodeBuilderNodeSearchResult): string;
+    getSubnodesForConnectionType(connectionType: string): string[];
+    getRelatedSubnodeIds(nodeIds: string[], excludeNodeIds: Set<string>): Set<string>;
+    getNodeType(nodeId: string): LeanNodeTypeDescription | undefined;
+    private getConnectionScore;
+    static isAiConnectionType(connectionType: string): boolean;
+    static getAiConnectionTypes(): NodeConnectionType[];
+}