@n8n/n8n-nodes-langchain 2.45.3 → 2.46.0

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePGVector/v14/mode_retrieve_as_tool.schema.js

@@ -0,0 +1,35 @@
+/**
+ * Postgres PGVector Store Node - Version 1.4 - Zod Schema
+ * Discriminator: mode=retrieve-as-tool
+ *
+ * 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, resolveOneOfSchemas, embeddingInstanceSchema, rerankerInstanceSchema }) {
+
+  // Helper function for conditional subnode schema
+  function getSubnodesSchema() {
+    return z.object({
+      embedding: z.union([embeddingInstanceSchema, z.array(embeddingInstanceSchema)]),
+      reranker: resolveSchema({ parameters, schema: rerankerInstanceSchema, required: true, displayOptions: {"show":{"useReranker":[true]}}, defaults: {"useReranker":false} }),
+    }).strict();
+  }
+
+  return z.object({
+    parameters: z.object({
+      mode: z.literal('retrieve-as-tool'),
+      toolDescription: stringOrExpression,
+      tableName: stringOrExpression.optional(),
+      topK: numberOrExpression.optional(),
+      includeDocumentMetadata: booleanOrExpression.optional(),
+      useReranker: booleanOrExpression.optional(),
+      options: z.object({ distanceStrategy: z.union([z.literal('cosine'), z.literal('innerProduct'), z.literal('euclidean'), expressionSchema]).optional(), collection: z.object({ values: z.object({ useCollection: booleanOrExpression.optional(), collectionName: stringOrExpression.optional(), collectionTableName: stringOrExpression.optional() }).optional() }).optional(), columnNames: z.object({ values: z.object({ idColumnName: stringOrExpression.optional(), vectorColumnName: stringOrExpression.optional(), contentColumnName: stringOrExpression.optional(), metadataColumnName: stringOrExpression.optional() }).optional() }).optional(), metadata: z.object({ metadataValues: z.array(z.object({ name: stringOrExpression.optional(), value: stringOrExpression.optional() })).optional() }).optional(), skipInitializationCheck: booleanOrExpression.optional() }).optional(),
+    }).optional(),
+    subnodes: getSubnodesSchema(),
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePGVector/v14/mode_retrieve_as_tool.ts

@@ -0,0 +1,159 @@
+/**
+ * Postgres PGVector Store Node - Version 1.4
+ * Discriminator: mode=retrieve-as-tool
+ */
+
+
+interface Credentials {
+  postgres: CredentialReference;
+}
+
+/** Retrieve documents from vector store to be used as tool with AI nodes */
+export type LcVectorStorePGVectorV14RetrieveAsToolParams = {
+  /**
+   * 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';
+/**
+ * Explain to the LLM what this tool does, a good, specific description would allow LLMs to produce expected results much more often
+ */
+    toolDescription: string | Expression<string>;
+/**
+ * The table name to store the vectors in. If table does not exist, it will be created.
+ * @default n8n_vectors
+ */
+    tableName?: string | Expression<string>;
+/**
+ * Number of top results to fetch from vector store
+ * @default 4
+ */
+    topK?: number | Expression<number>;
+/**
+ * Whether or not to include document metadata
+ * @default true
+ */
+    includeDocumentMetadata?: boolean | Expression<boolean>;
+/**
+ * Whether or not to rerank results
+ * @default false
+ */
+    useReranker?: boolean | Expression<boolean>;
+/**
+ * Options
+ * @default {}
+ */
+    options?: {
+    /** The method to calculate the distance between two vectors
+     * @default cosine
+     */
+    distanceStrategy?: 'cosine' | 'innerProduct' | 'euclidean' | Expression<string>;
+    /** Collection of vectors
+     * @default {"values":{"useCollection":false,"collectionName":"n8n","collectionTable":"n8n_vector_collections"}}
+     */
+    collection?: {
+        /** Collection Settings
+     */
+    values?: {
+      /** Use Collection
+       * @default false
+       */
+      useCollection?: boolean | Expression<boolean>;
+      /** Collection Name
+       * @displayOptions.show { useCollection: [true] }
+       * @default n8n
+       */
+      collectionName?: string | Expression<string>;
+      /** Collection Table Name
+       * @displayOptions.show { useCollection: [true] }
+       * @default n8n_vector_collections
+       */
+      collectionTableName?: string | Expression<string>;
+    };
+  };
+    /** The names of the columns in the PGVector table
+     * @default {"values":{"idColumnName":"id","vectorColumnName":"embedding","contentColumnName":"text","metadataColumnName":"metadata"}}
+     */
+    columnNames?: {
+        /** Column Name Settings
+     */
+    values?: {
+      /** ID Column Name
+       * @default id
+       */
+      idColumnName?: string | Expression<string>;
+      /** Vector Column Name
+       * @default embedding
+       */
+      vectorColumnName?: string | Expression<string>;
+      /** Content Column Name
+       * @default text
+       */
+      contentColumnName?: string | Expression<string>;
+      /** Metadata Column Name
+       * @default metadata
+       */
+      metadataColumnName?: string | Expression<string>;
+    };
+  };
+    /** Metadata to filter the document by
+     * @default {}
+     */
+    metadata?: {
+        /** Fields to Set
+     */
+    metadataValues?: Array<{
+      /** Name
+       */
+      name?: string | Expression<string>;
+      /** Value
+       */
+      value?: string | Expression<string>;
+    }>;
+  };
+    /** Whether to skip creating the vector extension and tables when they already exist
+     * @default false
+     */
+    skipInitializationCheck?: boolean | Expression<boolean>;
+  };
+};
+
+export interface LcVectorStorePGVectorV14RetrieveAsToolSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+  /**
+   * @displayOptions.show { useReranker: [true] }
+   */
+  reranker: RerankerInstance;
+}
+
+export type LcVectorStorePGVectorV14RetrieveAsToolNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStorePGVector';
+  version: 1.4;
+  config: NodeConfig<LcVectorStorePGVectorV14RetrieveAsToolParams> & { credentials?: Credentials } & { subnodes: LcVectorStorePGVectorV14RetrieveAsToolSubnodeConfig };
+};

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

@@ -4,15 +4,17 @@
  * Re-exports all version-specific types and provides combined union type.
  */
 
+import type { LcVectorStorePineconeV14Node } from './v14';
 import type { LcVectorStorePineconeV13Node } from './v13';
 import type { LcVectorStorePineconeV12Node } from './v12';
 import type { LcVectorStorePineconeV11Node } from './v11';
 import type { LcVectorStorePineconeV1Node } from './v1';
 
+export * from './v14';
 export * from './v13';
 export * from './v12';
 export * from './v11';
 export * from './v1';
 
 // Combined union type for all versions
-export type LcVectorStorePineconeNode = LcVectorStorePineconeV13Node | LcVectorStorePineconeV12Node | LcVectorStorePineconeV11Node | LcVectorStorePineconeV1Node;
+export type LcVectorStorePineconeNode = LcVectorStorePineconeV14Node | LcVectorStorePineconeV13Node | LcVectorStorePineconeV12Node | LcVectorStorePineconeV11Node | LcVectorStorePineconeV1Node;

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePinecone/v14/index.schema.js

@@ -0,0 +1,28 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4 - Zod Schema Factory
+ * Exports a factory that unions all discriminator schemas.
+ *
+ * Schema helpers (z, expressionSchema, etc.) are passed as parameters
+ * by the schema-validator, not imported from external files.
+ *
+ * @generated - CommonJS JavaScript for runtime loading
+ */
+
+const getInsertSchema = require('./mode_insert.schema');
+const getLoadSchema = require('./mode_load.schema');
+const getRetrieveSchema = require('./mode_retrieve.schema');
+const getRetrieveAsToolSchema = require('./mode_retrieve_as_tool.schema');
+const getUpdateSchema = require('./mode_update.schema');
+
+module.exports = function getSchema(helpers) {
+  const { parameters, z } = helpers;
+  // Apply discriminator default if not set
+  const effectiveParams = parameters.mode === undefined ? { ...parameters, mode: 'retrieve' } : parameters;
+  return z.union([
+    getInsertSchema({ ...helpers, parameters: effectiveParams }),
+    getLoadSchema({ ...helpers, parameters: effectiveParams }),
+    getRetrieveSchema({ ...helpers, parameters: effectiveParams }),
+    getRetrieveAsToolSchema({ ...helpers, parameters: effectiveParams }),
+    getUpdateSchema({ ...helpers, parameters: effectiveParams }),
+  ]);
+};

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

@@ -0,0 +1,24 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4
+ * Re-exports all discriminator combinations.
+ */
+
+import type { LcVectorStorePineconeV14InsertNode } from './mode_insert';
+import type { LcVectorStorePineconeV14LoadNode } from './mode_load';
+import type { LcVectorStorePineconeV14RetrieveNode } from './mode_retrieve';
+import type { LcVectorStorePineconeV14RetrieveAsToolNode } from './mode_retrieve_as_tool';
+import type { LcVectorStorePineconeV14UpdateNode } from './mode_update';
+
+export * from './mode_insert';
+export * from './mode_load';
+export * from './mode_retrieve';
+export * from './mode_retrieve_as_tool';
+export * from './mode_update';
+
+export type LcVectorStorePineconeV14Node =
+  | LcVectorStorePineconeV14InsertNode
+  | LcVectorStorePineconeV14LoadNode
+  | LcVectorStorePineconeV14RetrieveNode
+  | LcVectorStorePineconeV14RetrieveAsToolNode
+  | LcVectorStorePineconeV14UpdateNode
+  ;

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePinecone/v14/mode_insert.schema.js

@@ -0,0 +1,30 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4 - Zod Schema
+ * Discriminator: mode=insert
+ *
+ * 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, embeddingInstanceSchema, documentLoaderInstanceSchema }) {
+
+  // Static subnode schema
+  const subnodesSchema = z.object({
+    embedding: z.union([embeddingInstanceSchema, z.array(embeddingInstanceSchema)]),
+    documentLoader: z.union([documentLoaderInstanceSchema, z.array(documentLoaderInstanceSchema)]),
+  }).strict();
+
+  return z.object({
+    parameters: z.object({
+      mode: z.literal('insert'),
+      pineconeIndex: z.union([z.object({ __rl: z.literal(true), mode: z.union([z.literal('list'), z.literal('id')]), value: z.union([z.string(), z.number()]), cachedResultName: z.string().optional(), cachedResultUrl: z.string().optional() }), expressionSchema]).optional(),
+      embeddingBatchSize: numberOrExpression.optional(),
+      options: z.object({ clearNamespace: booleanOrExpression.optional(), pineconeNamespace: stringOrExpression.optional() }).optional(),
+    }).optional(),
+    subnodes: subnodesSchema,
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePinecone/v14/mode_insert.ts

@@ -0,0 +1,64 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4
+ * Discriminator: mode=insert
+ */
+
+
+interface Credentials {
+  pineconeApi: CredentialReference;
+}
+
+/** Insert documents into vector store */
+export type LcVectorStorePineconeV14InsertParams = {
+  /**
+   * 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';
+  pineconeIndex?: { __rl: true; mode: 'list' | 'id'; value: string; cachedResultName?: string };
+/**
+ * Number of documents to embed in a single batch
+ * @default 200
+ */
+    embeddingBatchSize?: number | Expression<number>;
+/**
+ * Options
+ * @default {}
+ */
+    options?: {
+    /** Whether to clear the namespace before inserting new data
+     * @default false
+     */
+    clearNamespace?: boolean | Expression<boolean>;
+    /** Partition the records in an index into namespaces. Queries and other operations are then limited to one namespace, so different requests can search different subsets of your index.
+     */
+    pineconeNamespace?: string | Expression<string>;
+  };
+};
+
+export interface LcVectorStorePineconeV14InsertSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+  documentLoader: DocumentLoaderInstance | DocumentLoaderInstance[];
+}
+
+export type LcVectorStorePineconeV14InsertNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStorePinecone';
+  version: 1.4;
+  config: NodeConfig<LcVectorStorePineconeV14InsertParams> & { credentials?: Credentials } & { subnodes: LcVectorStorePineconeV14InsertSubnodeConfig };
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePinecone/v14/mode_load.schema.js

@@ -0,0 +1,35 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4 - Zod Schema
+ * Discriminator: mode=load
+ *
+ * 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, resolveOneOfSchemas, embeddingInstanceSchema, rerankerInstanceSchema }) {
+
+  // Helper function for conditional subnode schema
+  function getSubnodesSchema() {
+    return z.object({
+      embedding: z.union([embeddingInstanceSchema, z.array(embeddingInstanceSchema)]),
+      reranker: resolveSchema({ parameters, schema: rerankerInstanceSchema, required: true, displayOptions: {"show":{"useReranker":[true]}}, defaults: {"useReranker":false} }),
+    }).strict();
+  }
+
+  return z.object({
+    parameters: z.object({
+      mode: z.literal('load'),
+      pineconeIndex: z.union([z.object({ __rl: z.literal(true), mode: z.union([z.literal('list'), z.literal('id')]), value: z.union([z.string(), z.number()]), cachedResultName: z.string().optional(), cachedResultUrl: z.string().optional() }), expressionSchema]).optional(),
+      prompt: stringOrExpression,
+      topK: numberOrExpression.optional(),
+      includeDocumentMetadata: booleanOrExpression.optional(),
+      useReranker: booleanOrExpression.optional(),
+      options: z.object({ pineconeNamespace: stringOrExpression.optional(), metadata: z.object({ metadataValues: z.array(z.object({ name: stringOrExpression.optional(), value: stringOrExpression.optional() })).optional() }).optional() }).optional(),
+    }).optional(),
+    subnodes: getSubnodesSchema(),
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePinecone/v14/mode_load.ts

@@ -0,0 +1,92 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4
+ * Discriminator: mode=load
+ */
+
+
+interface Credentials {
+  pineconeApi: CredentialReference;
+}
+
+/** Get many ranked documents from vector store for query */
+export type LcVectorStorePineconeV14LoadParams = {
+  /**
+   * 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';
+  pineconeIndex?: { __rl: true; mode: 'list' | 'id'; value: string; cachedResultName?: string };
+/**
+ * Search prompt to retrieve matching documents from the vector store using similarity-based ranking
+ */
+    prompt: string | Expression<string>;
+/**
+ * Number of top results to fetch from vector store
+ * @default 4
+ */
+    topK?: number | Expression<number>;
+/**
+ * Whether or not to include document metadata
+ * @default true
+ */
+    includeDocumentMetadata?: boolean | Expression<boolean>;
+/**
+ * Whether or not to rerank results
+ * @default false
+ */
+    useReranker?: boolean | Expression<boolean>;
+/**
+ * Options
+ * @default {}
+ */
+    options?: {
+    /** Partition the records in an index into namespaces. Queries and other operations are then limited to one namespace, so different requests can search different subsets of your index.
+     */
+    pineconeNamespace?: string | Expression<string>;
+    /** Metadata to filter the document by
+     * @default {}
+     */
+    metadata?: {
+        /** Fields to Set
+     */
+    metadataValues?: Array<{
+      /** Name
+       */
+      name?: string | Expression<string>;
+      /** Value
+       */
+      value?: string | Expression<string>;
+    }>;
+  };
+  };
+};
+
+export interface LcVectorStorePineconeV14LoadSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+  /**
+   * @displayOptions.show { useReranker: [true] }
+   */
+  reranker: RerankerInstance;
+}
+
+export type LcVectorStorePineconeV14LoadNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStorePinecone';
+  version: 1.4;
+  config: NodeConfig<LcVectorStorePineconeV14LoadParams> & { credentials?: Credentials } & { subnodes: LcVectorStorePineconeV14LoadSubnodeConfig };
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePinecone/v14/mode_retrieve.schema.js

@@ -0,0 +1,32 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4 - Zod Schema
+ * Discriminator: mode=retrieve
+ *
+ * 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, resolveOneOfSchemas, embeddingInstanceSchema, rerankerInstanceSchema }) {
+
+  // Helper function for conditional subnode schema
+  function getSubnodesSchema() {
+    return z.object({
+      embedding: z.union([embeddingInstanceSchema, z.array(embeddingInstanceSchema)]),
+      reranker: resolveSchema({ parameters, schema: rerankerInstanceSchema, required: true, displayOptions: {"show":{"useReranker":[true]}}, defaults: {"useReranker":false} }),
+    }).strict();
+  }
+
+  return z.object({
+    parameters: z.object({
+      mode: z.literal('retrieve').default('retrieve'),
+      pineconeIndex: z.union([z.object({ __rl: z.literal(true), mode: z.union([z.literal('list'), z.literal('id')]), value: z.union([z.string(), z.number()]), cachedResultName: z.string().optional(), cachedResultUrl: z.string().optional() }), expressionSchema]).optional(),
+      useReranker: booleanOrExpression.optional(),
+      options: z.object({ pineconeNamespace: stringOrExpression.optional(), metadata: z.object({ metadataValues: z.array(z.object({ name: stringOrExpression.optional(), value: stringOrExpression.optional() })).optional() }).optional() }).optional(),
+    }).optional(),
+    subnodes: getSubnodesSchema(),
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePinecone/v14/mode_retrieve.ts

@@ -0,0 +1,83 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4
+ * Discriminator: mode=retrieve
+ */
+
+
+interface Credentials {
+  pineconeApi: CredentialReference;
+}
+
+/** Retrieve documents from vector store to be used as vector store with AI nodes */
+export type LcVectorStorePineconeV14RetrieveParams = {
+  /**
+   * 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';
+  pineconeIndex?: { __rl: true; mode: 'list' | 'id'; value: string; cachedResultName?: string };
+/**
+ * Whether or not to rerank results
+ * @default false
+ */
+    useReranker?: boolean | Expression<boolean>;
+/**
+ * Options
+ * @default {}
+ */
+    options?: {
+    /** Partition the records in an index into namespaces. Queries and other operations are then limited to one namespace, so different requests can search different subsets of your index.
+     */
+    pineconeNamespace?: string | Expression<string>;
+    /** Metadata to filter the document by
+     * @default {}
+     */
+    metadata?: {
+        /** Fields to Set
+     */
+    metadataValues?: Array<{
+      /** Name
+       */
+      name?: string | Expression<string>;
+      /** Value
+       */
+      value?: string | Expression<string>;
+    }>;
+  };
+  };
+};
+
+export interface LcVectorStorePineconeV14RetrieveSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+  /**
+   * @displayOptions.show { useReranker: [true] }
+   */
+  reranker: RerankerInstance;
+}
+
+export type LcVectorStorePineconeV14RetrieveNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStorePinecone';
+  version: 1.4;
+  config: NodeConfig<LcVectorStorePineconeV14RetrieveParams> & { credentials?: Credentials } & { subnodes: LcVectorStorePineconeV14RetrieveSubnodeConfig };
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStorePinecone/v14/mode_retrieve_as_tool.schema.js

@@ -0,0 +1,35 @@
+/**
+ * Pinecone Vector Store Node - Version 1.4 - Zod Schema
+ * Discriminator: mode=retrieve-as-tool
+ *
+ * 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, resolveOneOfSchemas, embeddingInstanceSchema, rerankerInstanceSchema }) {
+
+  // Helper function for conditional subnode schema
+  function getSubnodesSchema() {
+    return z.object({
+      embedding: z.union([embeddingInstanceSchema, z.array(embeddingInstanceSchema)]),
+      reranker: resolveSchema({ parameters, schema: rerankerInstanceSchema, required: true, displayOptions: {"show":{"useReranker":[true]}}, defaults: {"useReranker":false} }),
+    }).strict();
+  }
+
+  return z.object({
+    parameters: z.object({
+      mode: z.literal('retrieve-as-tool'),
+      toolDescription: stringOrExpression,
+      pineconeIndex: z.union([z.object({ __rl: z.literal(true), mode: z.union([z.literal('list'), z.literal('id')]), value: z.union([z.string(), z.number()]), cachedResultName: z.string().optional(), cachedResultUrl: z.string().optional() }), expressionSchema]).optional(),
+      topK: numberOrExpression.optional(),
+      includeDocumentMetadata: booleanOrExpression.optional(),
+      useReranker: booleanOrExpression.optional(),
+      options: z.object({ pineconeNamespace: stringOrExpression.optional(), metadata: z.object({ metadataValues: z.array(z.object({ name: stringOrExpression.optional(), value: stringOrExpression.optional() })).optional() }).optional() }).optional(),
+    }).optional(),
+    subnodes: getSubnodesSchema(),
+  });
+};