@n8n/n8n-nodes-langchain 2.21.1 → 2.22.0

package/dist/credentials/NvidiaApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { ICredentialDataDecryptedObject, ICredentialTestRequest, ICredentialType, IHttpRequestOptions, INodeProperties } from 'n8n-workflow';
+export declare class NvidiaApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: (credentials: ICredentialDataDecryptedObject, requestOptions: IHttpRequestOptions) => Promise<IHttpRequestOptions>;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/NvidiaApi.credentials.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NvidiaApi = void 0;
+class NvidiaApi {
+    constructor() {
+        this.name = 'nvidiaApi';
+        this.displayName = 'NVIDIA Nemotron';
+        this.documentationUrl = 'nvidia';
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'url',
+                type: 'string',
+                required: true,
+                default: 'https://integrate.api.nvidia.com/v1',
+                description: 'Use the default for build.nvidia.com cloud, or change it to point at a self-hosted NIM container (e.g. http://localhost:8000/v1)',
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                required: false,
+                default: '',
+                description: 'Required for build.nvidia.com cloud. Leave blank for a self-hosted NIM that does not require authentication',
+            },
+        ];
+        this.authenticate = async (credentials, requestOptions) => {
+            if (!credentials.apiKey) {
+                return requestOptions;
+            }
+            return {
+                ...requestOptions,
+                headers: {
+                    ...requestOptions.headers,
+                    Authorization: `Bearer ${credentials.apiKey}`,
+                },
+            };
+        };
+        this.test = {
+            request: {
+                baseURL: '={{ $credentials.url }}',
+                url: '/models',
+            },
+        };
+    }
+}
+exports.NvidiaApi = NvidiaApi;
+//# sourceMappingURL=NvidiaApi.credentials.js.map

package/dist/credentials/NvidiaApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NvidiaApi.credentials.js","sourceRoot":"","sources":["../../credentials/NvidiaApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,SAAS;IAAtB;QACC,SAAI,GAAG,WAAW,CAAC;QAEnB,gBAAW,GAAG,iBAAiB,CAAC;QAEhC,qBAAgB,GAAG,QAAQ,CAAC;QAE5B,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,qCAAqC;gBAC9C,WAAW,EACV,kIAAkI;aACnI;YACD;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,EAAE;gBACX,WAAW,EACV,6GAA6G;aAC9G;SACD,CAAC;QAEF,iBAAY,GAAG,KAAK,EACnB,WAA2C,EAC3C,cAAmC,EACJ,EAAE;YACjC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACzB,OAAO,cAAc,CAAC;YACvB,CAAC;YACD,OAAO;gBACN,GAAG,cAAc;gBACjB,OAAO,EAAE;oBACR,GAAG,cAAc,CAAC,OAAO;oBACzB,aAAa,EAAE,UAAU,WAAW,CAAC,MAAgB,EAAE;iBACvD;aACD,CAAC;QACH,CAAC,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,yBAAyB;gBAClC,GAAG,EAAE,SAAS;aACd;SACD,CAAC;IACH,CAAC;CAAA;AAnDD,8BAmDC"}

package/dist/known/credentials.json

@@ -169,6 +169,13 @@
       "lmLemonade"
     ]
   },
+  "nvidiaApi": {
+    "className": "NvidiaApi",
+    "sourcePath": "dist/credentials/NvidiaApi.credentials.js",
+    "supportedNodes": [
+      "lmChatNvidia"
+    ]
+  },
   "ollamaApi": {
     "className": "OllamaApi",
     "sourcePath": "dist/credentials/OllamaApi.credentials.js",

package/dist/known/nodes.json

@@ -179,6 +179,10 @@
     "className": "LmChatLemonade",
     "sourcePath": "dist/nodes/llms/LMChatLemonade/LmChatLemonade.node.js"
   },
+  "lmChatNvidia": {
+    "className": "LmChatNvidia",
+    "sourcePath": "dist/nodes/llms/LmChatNvidia/LmChatNvidia.node.js"
+  },
   "lmChatOllama": {
     "className": "LmChatOllama",
     "sourcePath": "dist/nodes/llms/LMChatOllama/LmChatOllama.node.js"

package/dist/node-definitions/.nodes-hash

@@ -1 +1 @@
-ff47fff86853860dcdd797e46375f50f97848b8bb7310a6bf78fdcd9289ace21
+332eed85fca9e6b84de508e09d6d2995f8e7d80ba058aea3f85c1db368194ac0

package/dist/node-definitions/index.ts

@@ -46,6 +46,7 @@ import type { LcLmChatLemonadeNode } from './nodes/n8n-nodes-langchain/lmChatLem
 import type { LcLmChatMinimaxNode } from './nodes/n8n-nodes-langchain/lmChatMinimax';
 import type { LcLmChatMistralCloudNode } from './nodes/n8n-nodes-langchain/lmChatMistralCloud';
 import type { LcLmChatMoonshotNode } from './nodes/n8n-nodes-langchain/lmChatMoonshot';
+import type { LcLmChatNvidiaNode } from './nodes/n8n-nodes-langchain/lmChatNvidia';
 import type { LcLmChatOllamaNode } from './nodes/n8n-nodes-langchain/lmChatOllama';
 import type { LcLmChatOpenAiNode } from './nodes/n8n-nodes-langchain/lmChatOpenAi';
 import type { LcLmChatOpenRouterNode } from './nodes/n8n-nodes-langchain/lmChatOpenRouter';
@@ -142,6 +143,7 @@ export * from './nodes/n8n-nodes-langchain/lmChatLemonade';
 export * from './nodes/n8n-nodes-langchain/lmChatMinimax';
 export * from './nodes/n8n-nodes-langchain/lmChatMistralCloud';
 export * from './nodes/n8n-nodes-langchain/lmChatMoonshot';
+export * from './nodes/n8n-nodes-langchain/lmChatNvidia';
 export * from './nodes/n8n-nodes-langchain/lmChatOllama';
 export * from './nodes/n8n-nodes-langchain/lmChatOpenAi';
 export * from './nodes/n8n-nodes-langchain/lmChatOpenRouter';
@@ -243,6 +245,7 @@ export type KnownNodeType =
   | '@n8n/n8n-nodes-langchain.lmChatMinimax'
   | '@n8n/n8n-nodes-langchain.lmChatMoonshot'
   | '@n8n/n8n-nodes-langchain.lmChatLemonade'
+  | '@n8n/n8n-nodes-langchain.lmChatNvidia'
   | '@n8n/n8n-nodes-langchain.lmChatOllama'
   | '@n8n/n8n-nodes-langchain.lmChatOpenRouter'
   | '@n8n/n8n-nodes-langchain.lmChatVercelAiGateway'
@@ -337,6 +340,7 @@ export type AllNodeTypes =
   | LcLmChatMinimaxNode
   | LcLmChatMistralCloudNode
   | LcLmChatMoonshotNode
+  | LcLmChatNvidiaNode
   | LcLmChatOllamaNode
   | LcLmChatOpenAiNode
   | LcLmChatOpenRouterNode

package/dist/node-definitions/nodes/n8n-nodes-langchain/agent/v3.ts

@@ -17,7 +17,12 @@ export interface LcAgentV3Params {
  * @displayOptions.show { promptType: ["define"] }
  */
     text: string | Expression<string>;
-  hasOutputParser?: boolean;
+/**
+ * Require Specific Output Format
+ * @builderHint Set to `true` when you need structured JSON output. The agent then requires an `outputParser` entry in its `subnodes` config (typically an `outputParserStructured` node defined via the `outputParser({...})` SDK factory). With `hasOutputParser: false` the agent returns a plain string in `$json.output`.
+ * @default false
+ */
+    hasOutputParser?: boolean;
   needsFallback?: boolean;
   options?: {
     /** The message that will be sent to the agent before the conversation starts

package/dist/node-definitions/nodes/n8n-nodes-langchain/agent/v31.ts

@@ -17,7 +17,12 @@ export interface LcAgentV31Params {
  * @default ={{ $json.guardrailsInput }}
  */
     text?: string | Expression<string>;
-  hasOutputParser?: boolean;
+/**
+ * Require Specific Output Format
+ * @builderHint Set to `true` when you need structured JSON output. The agent then requires an `outputParser` entry in its `subnodes` config (typically an `outputParserStructured` node defined via the `outputParser({...})` SDK factory). With `hasOutputParser: false` the agent returns a plain string in `$json.output`.
+ * @default false
+ */
+    hasOutputParser?: boolean;
   needsFallback?: boolean;
   options?: {
     /** The message that will be sent to the agent before the conversation starts

package/dist/node-definitions/nodes/n8n-nodes-langchain/agentTool/v3.ts

@@ -16,7 +16,12 @@ export interface LcAgentToolV3Params {
  * @placeholderSupported false
  */
     text: string | Expression<string>;
-  hasOutputParser?: boolean;
+/**
+ * Require Specific Output Format
+ * @builderHint Set to `true` when you need structured JSON output. The agent then requires an `outputParser` entry in its `subnodes` config (typically an `outputParserStructured` node defined via the `outputParser({...})` SDK factory). With `hasOutputParser: false` the agent returns a plain string in `$json.output`.
+ * @default false
+ */
+    hasOutputParser?: boolean;
   needsFallback?: boolean;
   options?: {
     /** The message that will be sent to the agent before the conversation starts

package/dist/node-definitions/nodes/n8n-nodes-langchain/lmChatNvidia/index.ts

@@ -0,0 +1,12 @@
+/**
+ * NVIDIA Nemotron Chat Model Node Types
+ *
+ * Re-exports all version-specific types and provides combined union type.
+ */
+
+import type { LcLmChatNvidiaV1Node } from './v1';
+
+export * from './v1';
+
+// Combined union type for all versions
+export type LcLmChatNvidiaNode = LcLmChatNvidiaV1Node;

package/dist/node-definitions/nodes/n8n-nodes-langchain/lmChatNvidia/v1.schema.js

@@ -0,0 +1,25 @@
+/**
+ * NVIDIA Nemotron Chat Model Node - Version 1 - Zod Validation Schemas
+ *
+ * These schemas validate node configuration at runtime.
+ * Use .parse() for strict validation or .safeParse() for error handling.
+ *
+ * Schema helpers (z, expressionSchema, etc.) are passed as parameters
+ * by the schema-validator, not imported from external files.
+ *
+ * @generated - CommonJS JavaScript for runtime loading
+ */
+
+module.exports = function getSchema({ parameters, z, expressionSchema, stringOrExpression, numberOrExpression, booleanOrExpression, resourceLocatorValueSchema, resourceMapperValueSchema, filterValueSchema, assignmentCollectionValueSchema, iDataObjectSchema, resolveSchema }) {
+
+  // Parameters schema
+  const parametersSchema = z.object({
+    model: z.union([z.literal('nvidia/llama-3.3-nemotron-super-49b-v1'), z.literal('nvidia/llama-3.1-nemotron-70b-instruct'), z.literal('nvidia/llama-3.1-nemotron-nano-8b-v1'), z.literal('nvidia/nemotron-4-340b-instruct'), z.literal('nvidia/nemotron-mini-4b-instruct'), expressionSchema]).optional(),
+    options: z.object({ frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional() }).optional(),
+  });
+
+  // Return combined config schema
+  return z.object({
+    parameters: parametersSchema.nullable().optional(),
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/lmChatNvidia/v1.ts

@@ -0,0 +1,68 @@
+/**
+ * NVIDIA Nemotron Chat Model Node - Version 1
+ * NVIDIA Nemotron models from build.nvidia.com or self-hosted NIM
+ */
+
+
+export interface LcLmChatNvidiaV1Params {
+/**
+ * The Nemotron model which will generate the completion. <a href="https://build.nvidia.com/models">Learn more</a>.
+ * @default nvidia/llama-3.3-nemotron-super-49b-v1
+ */
+    model?: 'nvidia/llama-3.3-nemotron-super-49b-v1' | 'nvidia/llama-3.1-nemotron-70b-instruct' | 'nvidia/llama-3.1-nemotron-nano-8b-v1' | 'nvidia/nemotron-4-340b-instruct' | 'nvidia/nemotron-mini-4b-instruct' | Expression<string>;
+/**
+ * Additional options to add
+ * @default {}
+ */
+    options?: {
+    /** Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model's likelihood to repeat the same line verbatim
+     * @default 0
+     */
+    frequencyPenalty?: number | Expression<number>;
+    /** The maximum number of tokens to generate in the completion. Use -1 for the model default.
+     * @default -1
+     */
+    maxTokens?: number | Expression<number>;
+    /** Response Format
+     * @default text
+     */
+    responseFormat?: 'text' | 'json_object' | Expression<string>;
+    /** Positive values penalize new tokens based on whether they appear in the text so far, increasing the model's likelihood to talk about new topics
+     * @default 0
+     */
+    presencePenalty?: number | Expression<number>;
+    /** Controls randomness: Lowering results in less random completions. As the temperature approaches zero, the model will become deterministic and repetitive.
+     * @default 0.7
+     */
+    temperature?: number | Expression<number>;
+    /** Maximum amount of time a request is allowed to take in milliseconds
+     * @default 360000
+     */
+    timeout?: number | Expression<number>;
+    /** Maximum number of retries to attempt
+     * @default 2
+     */
+    maxRetries?: number | Expression<number>;
+    /** Controls diversity via nucleus sampling: 0.5 means half of all likelihood-weighted options are considered. We generally recommend altering this or temperature but not both.
+     * @default 1
+     */
+    topP?: number | Expression<number>;
+  };
+}
+
+export interface LcLmChatNvidiaV1Credentials {
+  nvidiaApi: CredentialReference;
+}
+
+interface LcLmChatNvidiaV1NodeBase {
+  type: '@n8n/n8n-nodes-langchain.lmChatNvidia';
+  version: 1;
+  credentials?: LcLmChatNvidiaV1Credentials;
+  isTrigger: true;
+}
+
+export type LcLmChatNvidiaV1ParamsNode = LcLmChatNvidiaV1NodeBase & {
+  config: NodeConfig<LcLmChatNvidiaV1Params>;
+};
+
+export type LcLmChatNvidiaV1Node = LcLmChatNvidiaV1ParamsNode;

package/dist/node-definitions/nodes/n8n-nodes-langchain/mcpClientTool/v1.ts

@@ -1,6 +1,6 @@
 /**
  * MCP Client Tool Node - Version 1
- * Connect tools from an MCP Server
+ * Connect to a custom MCP server
  */
 
 

package/dist/node-definitions/nodes/n8n-nodes-langchain/mcpClientTool/v11.ts

@@ -1,6 +1,6 @@
 /**
  * MCP Client Tool Node - Version 1.1
- * Connect tools from an MCP Server
+ * Connect to a custom MCP server
  */
 
 

package/dist/node-definitions/nodes/n8n-nodes-langchain/mcpClientTool/v12.ts

@@ -1,6 +1,6 @@
 /**
  * MCP Client Tool Node - Version 1.2
- * Connect tools from an MCP Server
+ * Connect to a custom MCP server
  */
 
 

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v1/mode_insert.ts

@@ -10,6 +10,26 @@ interface Credentials {
 
 /** Insert documents into vector store */
 export type LcVectorStoreAzureAISearchV1InsertParams = {
+  /**
+   * Sits on the main flow — pipe the documents you want to embed into this node. Declare with `vectorStore({...})`. Required subnodes: `embedding` and `documentLoader`. If the goal is letting an LLM query the store, use `mode: 'retrieve-as-tool'` instead.
+   * <patterns>
+   * <pattern title="insert mode — upsert documents (generic, works for any vectorStore* node)">
+   * // Substitute the type literal and provider-specific parameters (e.g. pineconeIndex,
+   * // qdrantCollection, supabaseTableName) — see the rest of this file for the exact shape.
+   * const store = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: {
+   *       mode: 'insert',
+   *       // ...provider-specific parameters
+   *     },
+   *     subnodes: { embedding: embeddingsOpenAi, documentLoader: defaultDataLoader }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'insert';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v1/mode_load.ts

@@ -10,6 +10,26 @@ interface Credentials {
 
 /** Get many ranked documents from vector store for query */
 export type LcVectorStoreAzureAISearchV1LoadParams = {
+  /**
+   * One-shot similarity search on the main flow using the `prompt` parameter. Declare with `vectorStore({...})`. Required subnodes: `embedding`. For LLM-driven querying (RAG), use `mode: 'retrieve-as-tool'` instead.
+   * <patterns>
+   * <pattern title="load mode — one-shot similarity search (generic)">
+   * // Substitute the type literal and provider-specific parameters — see the rest of this file.
+   * const lookup = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: {
+   *       mode: 'load',
+   *       prompt: expr('{{ $json.query }}'),
+   *       // ...provider-specific parameters
+   *     },
+   *     subnodes: { embedding: embeddingsOpenAi }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'load';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v1/mode_retrieve.ts

@@ -10,6 +10,31 @@ interface Credentials {
 
 /** Retrieve documents from vector store to be used as vector store with AI nodes */
 export type LcVectorStoreAzureAISearchV1RetrieveParams = {
+  /**
+   * Exposes the store as an `ai_vectorStore` subnode for another node (e.g. `toolVectorStore`). Declare with `vectorStore({...})`. Required subnodes: `embedding`. For RAG with an AI Agent directly, prefer `mode: 'retrieve-as-tool'`.
+   * <patterns>
+   * <pattern title="retrieve mode — feed another node as a subnode (generic)">
+   * // Substitute the type literal and provider-specific parameters — see the rest of this file.
+   * const store = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: { mode: 'retrieve' /* + provider-specific parameters *\/ },
+   *     subnodes: { embedding: embeddingsOpenAi }
+   *   }
+   * });
+   * 
+   * const retrieverTool = tool({
+   *   type: '@n8n/n8n-nodes-langchain.toolVectorStore',
+   *   config: {
+   *     name: 'KB Retriever',
+   *     parameters: { description: 'Search the product knowledge base' },
+   *     subnodes: { vectorStore: store, model: openAiModel }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'retrieve';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v1/mode_retrieve_as_tool.ts

@@ -10,6 +10,36 @@ interface Credentials {
 
 /** Retrieve documents from vector store to be used as tool with AI nodes */
 export type LcVectorStoreAzureAISearchV1RetrieveAsToolParams = {
+  /**
+   * Canonical RAG mode — declare with the `tool({...})` factory (NOT `vectorStore`) and plug into an AI Agent's `subnodes.tools`. Required subnodes: `embedding`. Set `toolDescription` so the agent knows when to call it.
+   * <patterns>
+   * <pattern title="retrieve-as-tool mode — RAG via AI Agent (generic, works for any vectorStore* node)">
+   * // Substitute the type literal and provider-specific parameters — see the rest of this file
+   * // for the exact shape (e.g. pineconeIndex, qdrantCollection, supabaseTableName).
+   * const knowledgeBase = tool({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: {
+   *       mode: 'retrieve-as-tool',
+   *       toolDescription: 'Search the product knowledge base',
+   *       // ...provider-specific parameters
+   *     },
+   *     subnodes: { embedding: embeddingsOpenAi }
+   *   }
+   * });
+   * 
+   * const agent = node({
+   *   type: '@n8n/n8n-nodes-langchain.agent',
+   *   config: {
+   *     name: 'Support Agent',
+   *     parameters: { promptType: 'define', text: expr('{{ $json.question }}') },
+   *     subnodes: { model: openAiModel, tools: [knowledgeBase] }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'retrieve-as-tool';
 /**
  * Name of the vector store

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v1/mode_update.ts

@@ -10,6 +10,22 @@ interface Credentials {
 
 /** Update documents in vector store by ID */
 export type LcVectorStoreAzureAISearchV1UpdateParams = {
+  /**
+   * Updates a single document by `id`. Declare with `vectorStore({...})`. Required subnodes: `embedding`. Only available on stores whose `operationModes` enables it — most providers omit this mode.
+   * <patterns>
+   * <pattern title="update mode — update document by ID (generic)">
+   * // Substitute the type literal and provider-specific parameters — see the rest of this file.
+   * const store = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: { mode: 'update', id: expr('{{ $json.docId }}') },
+   *     subnodes: { embedding: embeddingsOpenAi }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'update';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v11/mode_insert.ts

@@ -10,6 +10,26 @@ interface Credentials {
 
 /** Insert documents into vector store */
 export type LcVectorStoreAzureAISearchV11InsertParams = {
+  /**
+   * Sits on the main flow — pipe the documents you want to embed into this node. Declare with `vectorStore({...})`. Required subnodes: `embedding` and `documentLoader`. If the goal is letting an LLM query the store, use `mode: 'retrieve-as-tool'` instead.
+   * <patterns>
+   * <pattern title="insert mode — upsert documents (generic, works for any vectorStore* node)">
+   * // Substitute the type literal and provider-specific parameters (e.g. pineconeIndex,
+   * // qdrantCollection, supabaseTableName) — see the rest of this file for the exact shape.
+   * const store = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: {
+   *       mode: 'insert',
+   *       // ...provider-specific parameters
+   *     },
+   *     subnodes: { embedding: embeddingsOpenAi, documentLoader: defaultDataLoader }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'insert';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v11/mode_load.ts

@@ -10,6 +10,26 @@ interface Credentials {
 
 /** Get many ranked documents from vector store for query */
 export type LcVectorStoreAzureAISearchV11LoadParams = {
+  /**
+   * One-shot similarity search on the main flow using the `prompt` parameter. Declare with `vectorStore({...})`. Required subnodes: `embedding`. For LLM-driven querying (RAG), use `mode: 'retrieve-as-tool'` instead.
+   * <patterns>
+   * <pattern title="load mode — one-shot similarity search (generic)">
+   * // Substitute the type literal and provider-specific parameters — see the rest of this file.
+   * const lookup = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: {
+   *       mode: 'load',
+   *       prompt: expr('{{ $json.query }}'),
+   *       // ...provider-specific parameters
+   *     },
+   *     subnodes: { embedding: embeddingsOpenAi }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'load';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v11/mode_retrieve.ts

@@ -10,6 +10,31 @@ interface Credentials {
 
 /** Retrieve documents from vector store to be used as vector store with AI nodes */
 export type LcVectorStoreAzureAISearchV11RetrieveParams = {
+  /**
+   * Exposes the store as an `ai_vectorStore` subnode for another node (e.g. `toolVectorStore`). Declare with `vectorStore({...})`. Required subnodes: `embedding`. For RAG with an AI Agent directly, prefer `mode: 'retrieve-as-tool'`.
+   * <patterns>
+   * <pattern title="retrieve mode — feed another node as a subnode (generic)">
+   * // Substitute the type literal and provider-specific parameters — see the rest of this file.
+   * const store = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: { mode: 'retrieve' /* + provider-specific parameters *\/ },
+   *     subnodes: { embedding: embeddingsOpenAi }
+   *   }
+   * });
+   * 
+   * const retrieverTool = tool({
+   *   type: '@n8n/n8n-nodes-langchain.toolVectorStore',
+   *   config: {
+   *     name: 'KB Retriever',
+   *     parameters: { description: 'Search the product knowledge base' },
+   *     subnodes: { vectorStore: store, model: openAiModel }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'retrieve';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v11/mode_retrieve_as_tool.ts

@@ -10,6 +10,36 @@ interface Credentials {
 
 /** Retrieve documents from vector store to be used as tool with AI nodes */
 export type LcVectorStoreAzureAISearchV11RetrieveAsToolParams = {
+  /**
+   * Canonical RAG mode — declare with the `tool({...})` factory (NOT `vectorStore`) and plug into an AI Agent's `subnodes.tools`. Required subnodes: `embedding`. Set `toolDescription` so the agent knows when to call it.
+   * <patterns>
+   * <pattern title="retrieve-as-tool mode — RAG via AI Agent (generic, works for any vectorStore* node)">
+   * // Substitute the type literal and provider-specific parameters — see the rest of this file
+   * // for the exact shape (e.g. pineconeIndex, qdrantCollection, supabaseTableName).
+   * const knowledgeBase = tool({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: {
+   *       mode: 'retrieve-as-tool',
+   *       toolDescription: 'Search the product knowledge base',
+   *       // ...provider-specific parameters
+   *     },
+   *     subnodes: { embedding: embeddingsOpenAi }
+   *   }
+   * });
+   * 
+   * const agent = node({
+   *   type: '@n8n/n8n-nodes-langchain.agent',
+   *   config: {
+   *     name: 'Support Agent',
+   *     parameters: { promptType: 'define', text: expr('{{ $json.question }}') },
+   *     subnodes: { model: openAiModel, tools: [knowledgeBase] }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'retrieve-as-tool';
 /**
  * Name of the vector store

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v11/mode_update.ts

@@ -10,6 +10,22 @@ interface Credentials {
 
 /** Update documents in vector store by ID */
 export type LcVectorStoreAzureAISearchV11UpdateParams = {
+  /**
+   * Updates a single document by `id`. Declare with `vectorStore({...})`. Required subnodes: `embedding`. Only available on stores whose `operationModes` enables it — most providers omit this mode.
+   * <patterns>
+   * <pattern title="update mode — update document by ID (generic)">
+   * // Substitute the type literal and provider-specific parameters — see the rest of this file.
+   * const store = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: { mode: 'update', id: expr('{{ $json.docId }}') },
+   *     subnodes: { embedding: embeddingsOpenAi }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'update';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreAzureAISearch/v12/mode_insert.ts

@@ -10,6 +10,26 @@ interface Credentials {
 
 /** Insert documents into vector store */
 export type LcVectorStoreAzureAISearchV12InsertParams = {
+  /**
+   * Sits on the main flow — pipe the documents you want to embed into this node. Declare with `vectorStore({...})`. Required subnodes: `embedding` and `documentLoader`. If the goal is letting an LLM query the store, use `mode: 'retrieve-as-tool'` instead.
+   * <patterns>
+   * <pattern title="insert mode — upsert documents (generic, works for any vectorStore* node)">
+   * // Substitute the type literal and provider-specific parameters (e.g. pineconeIndex,
+   * // qdrantCollection, supabaseTableName) — see the rest of this file for the exact shape.
+   * const store = vectorStore({
+   *   type: '@n8n/n8n-nodes-langchain.vectorStoreXxx',
+   *   config: {
+   *     name: 'Knowledge Base',
+   *     parameters: {
+   *       mode: 'insert',
+   *       // ...provider-specific parameters
+   *     },
+   *     subnodes: { embedding: embeddingsOpenAi, documentLoader: defaultDataLoader }
+   *   }
+   * });
+   * </pattern>
+   * </patterns>
+   */
   mode: 'insert';
 /**
  * The name of the Azure AI Search index. Will be created automatically if it does not exist.