@n8n/n8n-nodes-langchain 2.45.3 → 2.46.0

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

@@ -0,0 +1,124 @@
+/**
+ * MongoDB Atlas Vector Store Node - Version 1.4
+ * Discriminator: mode=retrieve-as-tool
+ */
+
+
+interface Credentials {
+  mongoDb: CredentialReference;
+}
+
+/** Retrieve documents from vector store to be used as tool with AI nodes */
+export type LcVectorStoreMongoDBAtlasV14RetrieveAsToolParams = {
+  /**
+   * 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>;
+  mongoCollection?: { __rl: true; mode: 'list' | 'name'; value: string; cachedResultName?: string };
+/**
+ * The field with the embedding array
+ * @default embedding
+ */
+    embedding?: string | Expression<string>;
+/**
+ * The text field of the raw data
+ * @default text
+ */
+    metadata_field?: string | Expression<string>;
+/**
+ * The name of the vector index
+ */
+    vectorIndexName: 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?: {
+    /** Logical partition for documents. Uses metadata.namespace field for filtering.
+     */
+    namespace?: 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>;
+    }>;
+  };
+    /** MongoDB Atlas Vector Search pre-filter
+     * @hint This is a filter applied in the $vectorSearch stage &lt;a href="https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-stage/#atlas-vector-search-pre-filter"&gt;here&lt;/a&gt;
+     */
+    preFilter?: IDataObject | string | Expression<string>;
+    /** MongoDB aggregation pipeline in JSON format
+     * @hint Learn more about aggregation pipeline &lt;a href="https://docs.mongodb.com/manual/core/aggregation-pipeline/"&gt;here&lt;/a&gt;
+     */
+    postFilterPipeline?: IDataObject | string | Expression<string>;
+  };
+};
+
+export interface LcVectorStoreMongoDBAtlasV14RetrieveAsToolSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+  /**
+   * @displayOptions.show { useReranker: [true] }
+   */
+  reranker: RerankerInstance;
+}
+
+export type LcVectorStoreMongoDBAtlasV14RetrieveAsToolNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStoreMongoDBAtlas';
+  version: 1.4;
+  config: NodeConfig<LcVectorStoreMongoDBAtlasV14RetrieveAsToolParams> & { credentials?: Credentials } & { subnodes: LcVectorStoreMongoDBAtlasV14RetrieveAsToolSubnodeConfig };
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreMongoDBAtlas/v14/mode_update.schema.js

@@ -0,0 +1,31 @@
+/**
+ * MongoDB Atlas Vector Store Node - Version 1.4 - Zod Schema
+ * Discriminator: mode=update
+ *
+ * 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 }) {
+
+  // Static subnode schema
+  const subnodesSchema = z.object({
+    embedding: z.union([embeddingInstanceSchema, z.array(embeddingInstanceSchema)]),
+  }).strict();
+
+  return z.object({
+    parameters: z.object({
+      mode: z.literal('update'),
+      mongoCollection: z.union([z.object({ __rl: z.literal(true), mode: z.union([z.literal('list'), z.literal('name')]), value: z.union([z.string(), z.number()]), cachedResultName: z.string().optional(), cachedResultUrl: z.string().optional() }), expressionSchema]).optional(),
+      embedding: stringOrExpression.optional(),
+      metadata_field: stringOrExpression.optional(),
+      vectorIndexName: stringOrExpression,
+      id: stringOrExpression,
+    }).optional(),
+    subnodes: subnodesSchema,
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-langchain/vectorStoreMongoDBAtlas/v14/mode_update.ts

@@ -0,0 +1,59 @@
+/**
+ * MongoDB Atlas Vector Store Node - Version 1.4
+ * Discriminator: mode=update
+ */
+
+
+interface Credentials {
+  mongoDb: CredentialReference;
+}
+
+/** Update documents in vector store by ID */
+export type LcVectorStoreMongoDBAtlasV14UpdateParams = {
+  /**
+   * 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';
+  mongoCollection?: { __rl: true; mode: 'list' | 'name'; value: string; cachedResultName?: string };
+/**
+ * The field with the embedding array
+ * @default embedding
+ */
+    embedding?: string | Expression<string>;
+/**
+ * The text field of the raw data
+ * @default text
+ */
+    metadata_field?: string | Expression<string>;
+/**
+ * The name of the vector index
+ */
+    vectorIndexName: string | Expression<string>;
+/**
+ * ID of an embedding entry
+ */
+    id: string | Expression<string>;
+};
+
+export interface LcVectorStoreMongoDBAtlasV14UpdateSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+}
+
+export type LcVectorStoreMongoDBAtlasV14UpdateNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStoreMongoDBAtlas';
+  version: 1.4;
+  config: NodeConfig<LcVectorStoreMongoDBAtlasV14UpdateParams> & { credentials?: Credentials } & { subnodes: LcVectorStoreMongoDBAtlasV14UpdateSubnodeConfig };
+};

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

@@ -4,15 +4,17 @@
  * Re-exports all version-specific types and provides combined union type.
  */
 
+import type { LcVectorStoreOracleDBVectorV14Node } from './v14';
 import type { LcVectorStoreOracleDBVectorV13Node } from './v13';
 import type { LcVectorStoreOracleDBVectorV12Node } from './v12';
 import type { LcVectorStoreOracleDBVectorV11Node } from './v11';
 import type { LcVectorStoreOracleDBVectorV1Node } 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 LcVectorStoreOracleDBVectorNode = LcVectorStoreOracleDBVectorV13Node | LcVectorStoreOracleDBVectorV12Node | LcVectorStoreOracleDBVectorV11Node | LcVectorStoreOracleDBVectorV1Node;
+export type LcVectorStoreOracleDBVectorNode = LcVectorStoreOracleDBVectorV14Node | LcVectorStoreOracleDBVectorV13Node | LcVectorStoreOracleDBVectorV12Node | LcVectorStoreOracleDBVectorV11Node | LcVectorStoreOracleDBVectorV1Node;

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

@@ -0,0 +1,26 @@
+/**
+ * Oracle Database 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');
+
+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 }),
+  ]);
+};

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

@@ -0,0 +1,21 @@
+/**
+ * Oracle Database Vector Store Node - Version 1.4
+ * Re-exports all discriminator combinations.
+ */
+
+import type { LcVectorStoreOracleDBVectorV14InsertNode } from './mode_insert';
+import type { LcVectorStoreOracleDBVectorV14LoadNode } from './mode_load';
+import type { LcVectorStoreOracleDBVectorV14RetrieveNode } from './mode_retrieve';
+import type { LcVectorStoreOracleDBVectorV14RetrieveAsToolNode } from './mode_retrieve_as_tool';
+
+export * from './mode_insert';
+export * from './mode_load';
+export * from './mode_retrieve';
+export * from './mode_retrieve_as_tool';
+
+export type LcVectorStoreOracleDBVectorV14Node =
+  | LcVectorStoreOracleDBVectorV14InsertNode
+  | LcVectorStoreOracleDBVectorV14LoadNode
+  | LcVectorStoreOracleDBVectorV14RetrieveNode
+  | LcVectorStoreOracleDBVectorV14RetrieveAsToolNode
+  ;

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

@@ -0,0 +1,30 @@
+/**
+ * Oracle Database 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'),
+      tableName: stringOrExpression.optional(),
+      embeddingBatchSize: numberOrExpression.optional(),
+      options: z.record(z.string(), z.unknown()).optional(),
+    }).optional(),
+    subnodes: subnodesSchema,
+  });
+};

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

@@ -0,0 +1,60 @@
+/**
+ * Oracle Database Vector Store Node - Version 1.4
+ * Discriminator: mode=insert
+ */
+
+
+interface Credentials {
+  oracleDBApi: CredentialReference;
+}
+
+/** Insert documents into vector store */
+export type LcVectorStoreOracleDBVectorV14InsertParams = {
+  /**
+   * 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 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 documents to embed in a single batch
+ * @default 200
+ */
+    embeddingBatchSize?: number | Expression<number>;
+/**
+ * Options
+ * @default {}
+ */
+    options?: Record<string, unknown>;
+};
+
+export interface LcVectorStoreOracleDBVectorV14InsertSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+  documentLoader: DocumentLoaderInstance | DocumentLoaderInstance[];
+}
+
+export type LcVectorStoreOracleDBVectorV14InsertNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStoreOracleDBVector';
+  version: 1.4;
+  config: NodeConfig<LcVectorStoreOracleDBVectorV14InsertParams> & { credentials?: Credentials } & { subnodes: LcVectorStoreOracleDBVectorV14InsertSubnodeConfig };
+};

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

@@ -0,0 +1,35 @@
+/**
+ * Oracle Database 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'),
+      tableName: stringOrExpression.optional(),
+      prompt: stringOrExpression,
+      topK: numberOrExpression.optional(),
+      includeDocumentMetadata: booleanOrExpression.optional(),
+      useReranker: booleanOrExpression.optional(),
+      options: z.object({ distanceStrategy: z.union([z.literal('COSINE'), z.literal('DOT'), z.literal('EUCLIDEAN'), z.literal('MANHATTAN'), z.literal('EUCLIDEAN_SQUARED'), z.literal('HAMMING'), expressionSchema]).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/vectorStoreOracleDBVector/v14/mode_load.ts

@@ -0,0 +1,97 @@
+/**
+ * Oracle Database Vector Store Node - Version 1.4
+ * Discriminator: mode=load
+ */
+
+
+interface Credentials {
+  oracleDBApi: CredentialReference;
+}
+
+/** Get many ranked documents from vector store for query */
+export type LcVectorStoreOracleDBVectorV14LoadParams = {
+  /**
+   * 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 table name to store the vectors in. If table does not exist, it will be created.
+ * @default n8n_vectors
+ */
+    tableName?: string | Expression<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?: {
+    /** The method to calculate the distance between two vectors
+     * @default COSINE
+     */
+    distanceStrategy?: 'COSINE' | 'DOT' | 'EUCLIDEAN' | 'MANHATTAN' | 'EUCLIDEAN_SQUARED' | 'HAMMING' | 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 LcVectorStoreOracleDBVectorV14LoadSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+  /**
+   * @displayOptions.show { useReranker: [true] }
+   */
+  reranker: RerankerInstance;
+}
+
+export type LcVectorStoreOracleDBVectorV14LoadNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStoreOracleDBVector';
+  version: 1.4;
+  config: NodeConfig<LcVectorStoreOracleDBVectorV14LoadParams> & { credentials?: Credentials } & { subnodes: LcVectorStoreOracleDBVectorV14LoadSubnodeConfig };
+};

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

@@ -0,0 +1,32 @@
+/**
+ * Oracle Database 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'),
+      tableName: stringOrExpression.optional(),
+      useReranker: booleanOrExpression.optional(),
+      options: z.object({ distanceStrategy: z.union([z.literal('COSINE'), z.literal('DOT'), z.literal('EUCLIDEAN'), z.literal('MANHATTAN'), z.literal('EUCLIDEAN_SQUARED'), z.literal('HAMMING'), expressionSchema]).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/vectorStoreOracleDBVector/v14/mode_retrieve.ts

@@ -0,0 +1,88 @@
+/**
+ * Oracle Database Vector Store Node - Version 1.4
+ * Discriminator: mode=retrieve
+ */
+
+
+interface Credentials {
+  oracleDBApi: CredentialReference;
+}
+
+/** Retrieve documents from vector store to be used as vector store with AI nodes */
+export type LcVectorStoreOracleDBVectorV14RetrieveParams = {
+  /**
+   * 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 table name to store the vectors in. If table does not exist, it will be created.
+ * @default n8n_vectors
+ */
+    tableName?: string | Expression<string>;
+/**
+ * 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' | 'DOT' | 'EUCLIDEAN' | 'MANHATTAN' | 'EUCLIDEAN_SQUARED' | 'HAMMING' | 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 LcVectorStoreOracleDBVectorV14RetrieveSubnodeConfig {
+  embedding: EmbeddingInstance | EmbeddingInstance[];
+  /**
+   * @displayOptions.show { useReranker: [true] }
+   */
+  reranker: RerankerInstance;
+}
+
+export type LcVectorStoreOracleDBVectorV14RetrieveNode = {
+  type: '@n8n/n8n-nodes-langchain.vectorStoreOracleDBVector';
+  version: 1.4;
+  config: NodeConfig<LcVectorStoreOracleDBVectorV14RetrieveParams> & { credentials?: Credentials } & { subnodes: LcVectorStoreOracleDBVectorV14RetrieveSubnodeConfig };
+};

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

@@ -0,0 +1,35 @@
+/**
+ * Oracle Database 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,
+      tableName: stringOrExpression.optional(),
+      topK: numberOrExpression.optional(),
+      includeDocumentMetadata: booleanOrExpression.optional(),
+      useReranker: booleanOrExpression.optional(),
+      options: z.object({ distanceStrategy: z.union([z.literal('COSINE'), z.literal('DOT'), z.literal('EUCLIDEAN'), z.literal('MANHATTAN'), z.literal('EUCLIDEAN_SQUARED'), z.literal('HAMMING'), expressionSchema]).optional(), metadata: z.object({ metadataValues: z.array(z.object({ name: stringOrExpression.optional(), value: stringOrExpression.optional() })).optional() }).optional() }).optional(),
+    }).optional(),
+    subnodes: getSubnodesSchema(),
+  });
+};