@n8n/n8n-nodes-langchain 2.18.2 → 2.19.0

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

@@ -13,6 +13,7 @@ export interface LcLmChatGoogleVertexV1Params {
     projectId?: { __rl: true; mode: 'list' | 'id'; value: string; cachedResultName?: string };
 /**
  * The model which will generate the completion. <a href="https://cloud.google.com/vertex-ai/generative-ai/docs/learn/models">Learn more</a>.
+ * @builderHint Default to the latest flagship Gemini on Vertex (gemini-3.1-pro). Use gemini-3.1-flash-lite for cost-efficient builds. Avoid Gemini 2.x, 1.x, and earlier.
  * @default gemini-2.5-flash
  */
     modelName?: string | Expression<string> | PlaceholderValue;

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

@@ -7,6 +7,7 @@
 export interface LcLmChatGroqV1Params {
 /**
  * The model which will generate the completion. <a href="https://console.groq.com/docs/models">Learn more</a>.
+ * @builderHint Default to a flagship model on Groq (openai/gpt-oss-120b, llama-3.3-70b-versatile, or moonshotai/kimi-k2-instruct-0905). Avoid the legacy llama3-8b-8192 default and older llama3/llama-2 variants.
  * @default llama3-8b-8192
  */
     model?: string | Expression<string>;

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

@@ -14,7 +14,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
 
   // Parameters schema
   const parametersSchema = z.object({
-    model: stringOrExpression.optional(),
+    model: stringOrExpression,
     options: z.object({ temperature: numberOrExpression.optional(), topP: numberOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), presencePenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), stop: stringOrExpression.optional() }).optional(),
   });
 

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

@@ -8,7 +8,7 @@ export interface LcLmChatLemonadeV1Params {
 /**
  * The model which will generate the completion. Models are loaded and managed through the Lemonade server.
  */
-    model?: string | Expression<string>;
+    model: string | Expression<string>;
 /**
  * Additional options to add
  * @default {}

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

@@ -7,6 +7,7 @@
 export interface LcLmChatMinimaxV1Params {
 /**
  * The model which will generate the completion. <a href="https://platform.minimax.io/docs/api-reference/text-openai-api">Learn more</a>.
+ * @builderHint Default to the latest MiniMax-M2.x flagship (MiniMax-M2.7). Avoid MiniMax-M2 and earlier.
  * @default MiniMax-M2.7
  */
     model?: 'MiniMax-M2' | 'MiniMax-M2.1' | 'MiniMax-M2.1-highspeed' | 'MiniMax-M2.5' | 'MiniMax-M2.5-highspeed' | 'MiniMax-M2.7' | 'MiniMax-M2.7-highspeed' | Expression<string>;

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

@@ -7,6 +7,7 @@
 export interface LcLmChatMistralCloudV1Params {
 /**
  * The model which will generate the completion. <a href="https://docs.mistral.ai/platform/endpoints/">Learn more</a>.
+ * @builderHint Default to the latest flagship Mistral (mistral-large-2512, aka Mistral Large 3). Use mistral-small for cost-efficient builds. Avoid older dated snapshots and Medium/Small 2.x.
  * @default mistral-small
  */
     model?: string | Expression<string>;

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

@@ -4,9 +4,11 @@
  * Re-exports all version-specific types and provides combined union type.
  */
 
+import type { LcLmChatMoonshotV11Node } from './v11';
 import type { LcLmChatMoonshotV1Node } from './v1';
 
+export * from './v11';
 export * from './v1';
 
 // Combined union type for all versions
-export type LcLmChatMoonshotNode = LcLmChatMoonshotV1Node;
+export type LcLmChatMoonshotNode = LcLmChatMoonshotV11Node | LcLmChatMoonshotV1Node;

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

@@ -7,6 +7,7 @@
 export interface LcLmChatMoonshotV1Params {
 /**
  * The model which will generate the completion. <a href="https://platform.kimi.ai/docs/api/chat">Learn more</a>.
+ * @builderHint Default to the latest Kimi model (kimi-k2.6). Avoid kimi-k2.5, kimi-k2, kimi-k1, and earlier.
  * @default kimi-k2.5
  */
     model?: string | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-langchain/{toolSerpApi/v1.schema.js → lmChatMoonshot/v11.schema.js}

@@ -1,5 +1,5 @@
 /**
- * SerpApi (Google Search) Node - Version 1 - Zod Validation Schemas
+ * Moonshot Kimi Chat Model Node - Version 1.1 - Zod Validation Schemas
  *
  * These schemas validate node configuration at runtime.
  * Use .parse() for strict validation or .safeParse() for error handling.
@@ -10,11 +10,12 @@
  * @generated - CommonJS JavaScript for runtime loading
  */
 
-module.exports = function getSchema({ parameters, z, expressionSchema, stringOrExpression, numberOrExpression, booleanOrExpression, resourceLocatorValueSchema, resourceMapperValueSchema, filterValueSchema, assignmentCollectionValueSchema, iDataObjectSchema }) {
+module.exports = function getSchema({ parameters, z, expressionSchema, stringOrExpression, numberOrExpression, booleanOrExpression, resourceLocatorValueSchema, resourceMapperValueSchema, filterValueSchema, assignmentCollectionValueSchema, iDataObjectSchema, resolveSchema }) {
 
   // Parameters schema
   const parametersSchema = z.object({
-    options: z.object({ gl: stringOrExpression.optional(), device: z.union([z.literal('desktop'), z.literal('mobile'), z.literal('tablet'), expressionSchema]).optional(), no_cache: booleanOrExpression.optional(), google_domain: stringOrExpression.optional(), hl: stringOrExpression.optional() }).optional(),
+    model: stringOrExpression.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

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

@@ -0,0 +1,68 @@
+/**
+ * Moonshot Kimi Chat Model Node - Version 1.1
+ * For advanced usage with an AI chain
+ */
+
+
+export interface LcLmChatMoonshotV11Params {
+/**
+ * The model which will generate the completion. <a href="https://platform.kimi.ai/docs/api/chat">Learn more</a>.
+ * @default kimi-k2.6
+ */
+    model?: string | 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. The limit depends on the selected model.
+     * @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 LcLmChatMoonshotV11Credentials {
+  moonshotApi: CredentialReference;
+}
+
+interface LcLmChatMoonshotV11NodeBase {
+  type: '@n8n/n8n-nodes-langchain.lmChatMoonshot';
+  version: 1.1;
+  credentials?: LcLmChatMoonshotV11Credentials;
+  isTrigger: true;
+}
+
+export type LcLmChatMoonshotV11ParamsNode = LcLmChatMoonshotV11NodeBase & {
+  config: NodeConfig<LcLmChatMoonshotV11Params>;
+};
+
+export type LcLmChatMoonshotV11Node = LcLmChatMoonshotV11ParamsNode;

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

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     model: stringOrExpression.optional(),
-    options: z.object({ baseURL: stringOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), textFormat: z.unknown().optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), reasoningEffort: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional(), conversationId: stringOrExpression.optional(), promptCacheKey: stringOrExpression.optional(), safetyIdentifier: stringOrExpression.optional(), serviceTier: z.union([z.literal('auto'), z.literal('flex'), z.literal('default'), z.literal('priority'), expressionSchema]).optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), topLogprobs: numberOrExpression.optional(), promptConfig: z.unknown().optional() }).optional(),
+    options: z.object({ baseURL: stringOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), textFormat: z.object({ textOptions: z.object({ type: z.union([z.literal('text'), z.literal('json_schema'), z.literal('json_object'), expressionSchema]).optional(), verbosity: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), name: stringOrExpression.optional(), schema: z.union([iDataObjectSchema, z.string()]).optional(), description: stringOrExpression.optional(), strict: booleanOrExpression.optional() }).optional() }).optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), reasoningEffort: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional(), conversationId: stringOrExpression.optional(), promptCacheKey: stringOrExpression.optional(), safetyIdentifier: stringOrExpression.optional(), serviceTier: z.union([z.literal('auto'), z.literal('flex'), z.literal('default'), z.literal('priority'), expressionSchema]).optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), topLogprobs: numberOrExpression.optional(), promptConfig: z.object({ promptOptions: z.object({ promptId: stringOrExpression.optional(), version: stringOrExpression.optional(), variables: z.union([iDataObjectSchema, z.string()]).optional() }).optional() }).optional() }).optional(),
   });
 
   // Return combined config schema

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

@@ -7,7 +7,7 @@
 export interface LcLmChatOpenAiV1Params {
 /**
  * The model which will generate the completion. <a href="https://beta.openai.com/docs/models/overview">Learn more</a>.
- * @builderHint Always default to latest mini model gpt-5-mini
+ * @builderHint Prefer the GPT-5.4 family: the flagship variant (e.g. `gpt-5.4`) for general use, a `-mini` / `-nano` variant when the task explicitly calls for cost-efficiency, or `-pro` only when the user asks for maximum capability. Never use gpt-4o, gpt-4-turbo, gpt-4, gpt-3.5, or earlier — those are superseded by the GPT-5 family and are not valid choices.
  * @default gpt-5-mini
  */
     model?: string | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-langchain/lmChatOpenAi/v11.schema.js

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     model: stringOrExpression.optional(),
-    options: z.object({ baseURL: stringOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), textFormat: z.unknown().optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), reasoningEffort: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional(), conversationId: stringOrExpression.optional(), promptCacheKey: stringOrExpression.optional(), safetyIdentifier: stringOrExpression.optional(), serviceTier: z.union([z.literal('auto'), z.literal('flex'), z.literal('default'), z.literal('priority'), expressionSchema]).optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), topLogprobs: numberOrExpression.optional(), promptConfig: z.unknown().optional() }).optional(),
+    options: z.object({ baseURL: stringOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), textFormat: z.object({ textOptions: z.object({ type: z.union([z.literal('text'), z.literal('json_schema'), z.literal('json_object'), expressionSchema]).optional(), verbosity: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), name: stringOrExpression.optional(), schema: z.union([iDataObjectSchema, z.string()]).optional(), description: stringOrExpression.optional(), strict: booleanOrExpression.optional() }).optional() }).optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), reasoningEffort: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional(), conversationId: stringOrExpression.optional(), promptCacheKey: stringOrExpression.optional(), safetyIdentifier: stringOrExpression.optional(), serviceTier: z.union([z.literal('auto'), z.literal('flex'), z.literal('default'), z.literal('priority'), expressionSchema]).optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), topLogprobs: numberOrExpression.optional(), promptConfig: z.object({ promptOptions: z.object({ promptId: stringOrExpression.optional(), version: stringOrExpression.optional(), variables: z.union([iDataObjectSchema, z.string()]).optional() }).optional() }).optional() }).optional(),
   });
 
   // Return combined config schema

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

@@ -7,7 +7,7 @@
 export interface LcLmChatOpenAiV11Params {
 /**
  * The model which will generate the completion. <a href="https://beta.openai.com/docs/models/overview">Learn more</a>.
- * @builderHint Always default to latest mini model gpt-5-mini
+ * @builderHint Prefer the GPT-5.4 family: the flagship variant (e.g. `gpt-5.4`) for general use, a `-mini` / `-nano` variant when the task explicitly calls for cost-efficiency, or `-pro` only when the user asks for maximum capability. Never use gpt-4o, gpt-4-turbo, gpt-4, gpt-3.5, or earlier — those are superseded by the GPT-5 family and are not valid choices.
  * @default gpt-5-mini
  */
     model?: string | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-langchain/lmChatOpenAi/v12.schema.js

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     model: 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(),
-    options: z.object({ baseURL: stringOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), textFormat: z.unknown().optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), reasoningEffort: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional(), conversationId: stringOrExpression.optional(), promptCacheKey: stringOrExpression.optional(), safetyIdentifier: stringOrExpression.optional(), serviceTier: z.union([z.literal('auto'), z.literal('flex'), z.literal('default'), z.literal('priority'), expressionSchema]).optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), topLogprobs: numberOrExpression.optional(), promptConfig: z.unknown().optional() }).optional(),
+    options: z.object({ baseURL: stringOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), textFormat: z.object({ textOptions: z.object({ type: z.union([z.literal('text'), z.literal('json_schema'), z.literal('json_object'), expressionSchema]).optional(), verbosity: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), name: stringOrExpression.optional(), schema: z.union([iDataObjectSchema, z.string()]).optional(), description: stringOrExpression.optional(), strict: booleanOrExpression.optional() }).optional() }).optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), reasoningEffort: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional(), conversationId: stringOrExpression.optional(), promptCacheKey: stringOrExpression.optional(), safetyIdentifier: stringOrExpression.optional(), serviceTier: z.union([z.literal('auto'), z.literal('flex'), z.literal('default'), z.literal('priority'), expressionSchema]).optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), topLogprobs: numberOrExpression.optional(), promptConfig: z.object({ promptOptions: z.object({ promptId: stringOrExpression.optional(), version: stringOrExpression.optional(), variables: z.union([iDataObjectSchema, z.string()]).optional() }).optional() }).optional() }).optional(),
   });
 
   // Return combined config schema

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

@@ -7,7 +7,7 @@
 export interface LcLmChatOpenAiV12Params {
 /**
  * The model. Choose from the list, or specify an ID.
- * @builderHint Always default to latest mini model gpt-5-mini
+ * @builderHint Prefer the GPT-5.4 family: the flagship variant (e.g. `gpt-5.4`) for general use, a `-mini` / `-nano` variant when the task explicitly calls for cost-efficiency, or `-pro` only when the user asks for maximum capability. Never use gpt-4o, gpt-4-turbo, gpt-4, gpt-3.5, or earlier — those are superseded by the GPT-5 family and are not valid choices.
  * @searchListMethod searchModels
  * @default {"mode":"list","value":"gpt-5-mini"}
  */

package/dist/node-definitions/nodes/n8n-nodes-langchain/lmChatOpenAi/v13.schema.js

@@ -16,8 +16,8 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   const parametersSchema = z.object({
     model: 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(),
     responsesApiEnabled: booleanOrExpression.optional(),
-    builtInTools: resolveSchema({ parameters, schema: z.object({ webSearch: z.unknown().optional(), fileSearch: z.unknown().optional(), codeInterpreter: booleanOrExpression.optional() }), required: false, displayOptions: {"show":{"/responsesApiEnabled":[true]}} }),
-    options: z.object({ baseURL: stringOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), textFormat: z.unknown().optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), reasoningEffort: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional(), conversationId: stringOrExpression.optional(), promptCacheKey: stringOrExpression.optional(), safetyIdentifier: stringOrExpression.optional(), serviceTier: z.union([z.literal('auto'), z.literal('flex'), z.literal('default'), z.literal('priority'), expressionSchema]).optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), topLogprobs: numberOrExpression.optional(), promptConfig: z.unknown().optional() }).optional(),
+    builtInTools: resolveSchema({ parameters, schema: z.object({ webSearch: z.object({ searchContextSize: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), allowedDomains: stringOrExpression.optional(), country: stringOrExpression.optional(), city: stringOrExpression.optional(), region: stringOrExpression.optional() }).optional(), fileSearch: z.object({ vectorStoreIds: z.union([iDataObjectSchema, z.string()]).optional(), filters: z.union([iDataObjectSchema, z.string()]).optional(), maxResults: numberOrExpression.optional() }).optional(), codeInterpreter: booleanOrExpression.optional() }), required: false, displayOptions: {"show":{"/responsesApiEnabled":[true]}} }),
+    options: z.object({ baseURL: stringOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), responseFormat: z.union([z.literal('text'), z.literal('json_object'), expressionSchema]).optional(), textFormat: z.object({ textOptions: z.object({ type: z.union([z.literal('text'), z.literal('json_schema'), z.literal('json_object'), expressionSchema]).optional(), verbosity: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), name: stringOrExpression.optional(), schema: z.union([iDataObjectSchema, z.string()]).optional(), description: stringOrExpression.optional(), strict: booleanOrExpression.optional() }).optional() }).optional(), presencePenalty: numberOrExpression.optional(), temperature: numberOrExpression.optional(), reasoningEffort: z.union([z.literal('low'), z.literal('medium'), z.literal('high'), expressionSchema]).optional(), timeout: numberOrExpression.optional(), maxRetries: numberOrExpression.optional(), topP: numberOrExpression.optional(), conversationId: stringOrExpression.optional(), promptCacheKey: stringOrExpression.optional(), safetyIdentifier: stringOrExpression.optional(), serviceTier: z.union([z.literal('auto'), z.literal('flex'), z.literal('default'), z.literal('priority'), expressionSchema]).optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), topLogprobs: numberOrExpression.optional(), promptConfig: z.object({ promptOptions: z.object({ promptId: stringOrExpression.optional(), version: stringOrExpression.optional(), variables: z.union([iDataObjectSchema, z.string()]).optional() }).optional() }).optional() }).optional(),
   });
 
   // Return combined config schema

package/dist/node-definitions/nodes/n8n-nodes-langchain/lmChatOpenAi/v13.ts

@@ -7,7 +7,7 @@
 export interface LcLmChatOpenAiV13Params {
 /**
  * The model. Choose from the list, or specify an ID.
- * @builderHint Always default to latest mini model gpt-5-mini
+ * @builderHint Prefer the GPT-5.4 family: the flagship variant (e.g. `gpt-5.4`) for general use, a `-mini` / `-nano` variant when the task explicitly calls for cost-efficiency, or `-pro` only when the user asks for maximum capability. Never use gpt-4o, gpt-4-turbo, gpt-4, gpt-3.5, or earlier — those are superseded by the GPT-5 family and are not valid choices.
  * @searchListMethod searchModels
  * @default {"mode":"list","value":"gpt-5-mini"}
  */

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

@@ -7,6 +7,7 @@
 export interface LcLmChatOpenRouterV1Params {
 /**
  * The model which will generate the completion. <a href="https://openrouter.ai/docs/models">Learn more</a>.
+ * @builderHint Default to a current flagship (e.g. openai/gpt-5.4, anthropic/claude-sonnet-4.6, google/gemini-3.1-pro-preview). Avoid openai/gpt-4o, anthropic/claude-3.x, and other pre-2026 models.
  * @default openai/gpt-4.1-mini
  */
     model?: string | Expression<string>;

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

@@ -7,6 +7,7 @@
 export interface LcLmChatVercelAiGatewayV1Params {
 /**
  * The model which will generate the completion
+ * @builderHint Default to a current flagship (e.g. openai/gpt-5.4, anthropic/claude-sonnet-4.6, google/gemini-3.1-pro). Avoid the openai/gpt-4o default and other pre-2026 models.
  * @default openai/gpt-4o
  */
     model?: string | Expression<string>;

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

@@ -7,6 +7,7 @@
 export interface LcLmChatXAiGrokV1Params {
 /**
  * The model which will generate the completion. <a href="https://docs.x.ai/docs/models">Learn more</a>.
+ * @builderHint Default to the latest flagship Grok (grok-4.20-0309-reasoning, or grok-4.20-multi-agent-0309 for agent workloads). Avoid grok-4, grok-2, and grok-1 variants.
  * @default grok-2-vision-1212
  */
     model?: string | Expression<string>;

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

@@ -14,7 +14,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
 
   // Parameters schema
   const parametersSchema = z.object({
-    model: stringOrExpression.optional(),
+    model: stringOrExpression,
     options: z.object({ temperature: numberOrExpression.optional(), topP: numberOrExpression.optional(), frequencyPenalty: numberOrExpression.optional(), presencePenalty: numberOrExpression.optional(), maxTokens: numberOrExpression.optional(), stop: stringOrExpression.optional() }).optional(),
   });
 

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

@@ -8,7 +8,7 @@ export interface LcLmLemonadeV1Params {
 /**
  * The model which will generate the completion. Models are loaded and managed through the Lemonade server.
  */
-    model?: string | Expression<string>;
+    model: string | Expression<string>;
 /**
  * Additional options to add
  * @default {}

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

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     serverTransport: z.union([z.literal('httpStreamable'), z.literal('sse'), expressionSchema]).optional(),
-    endpointUrl: stringOrExpression.optional(),
+    endpointUrl: stringOrExpression,
     authentication: z.union([z.literal('bearerAuth'), z.literal('headerAuth'), z.literal('mcpOAuth2Api'), z.literal('multipleHeadersAuth'), z.literal('none'), expressionSchema]).optional(),
     tool: 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(),
     inputMode: z.union([z.literal('manual'), z.literal('json')]).optional(),

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

@@ -13,7 +13,7 @@ export interface LcMcpClientV1Params {
 /**
  * The URL of the MCP server to connect to
  */
-    endpointUrl?: string | Expression<string> | PlaceholderValue;
+    endpointUrl: string | Expression<string> | PlaceholderValue;
 /**
  * The way to authenticate with your endpoint
  * @default none

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

@@ -14,7 +14,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
 
   // Parameters schema
   const parametersSchema = z.object({
-    sseEndpoint: stringOrExpression.optional(),
+    sseEndpoint: stringOrExpression,
     authentication: z.union([z.literal('bearerAuth'), z.literal('headerAuth'), z.literal('none'), expressionSchema]).optional(),
     include: z.union([z.literal('all'), z.literal('selected'), z.literal('except'), expressionSchema]).optional(),
     includeTools: resolveSchema({ parameters, schema: z.array(z.string()), required: false, displayOptions: {"show":{"include":["selected"]}}, defaults: {"include":"all"} }),

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

@@ -8,7 +8,7 @@ export interface LcMcpClientToolV1Params {
 /**
  * SSE Endpoint of your MCP server
  */
-    sseEndpoint?: string | Expression<string> | PlaceholderValue;
+    sseEndpoint: string | Expression<string> | PlaceholderValue;
 /**
  * The way to authenticate with your endpoint
  * @default none

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

@@ -14,7 +14,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
 
   // Parameters schema
   const parametersSchema = z.object({
-    endpointUrl: stringOrExpression.optional(),
+    endpointUrl: stringOrExpression,
     serverTransport: z.union([z.literal('httpStreamable'), z.literal('sse'), expressionSchema]).optional(),
     authentication: z.union([z.literal('bearerAuth'), z.literal('headerAuth'), z.literal('none'), expressionSchema]).optional(),
     include: z.union([z.literal('all'), z.literal('selected'), z.literal('except'), expressionSchema]).optional(),

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

@@ -8,7 +8,7 @@ export interface LcMcpClientToolV11Params {
 /**
  * Endpoint of your MCP server
  */
-    endpointUrl?: string | Expression<string> | PlaceholderValue;
+    endpointUrl: string | Expression<string> | PlaceholderValue;
 /**
  * The transport used by your endpoint
  * @default sse

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

@@ -14,7 +14,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
 
   // Parameters schema
   const parametersSchema = z.object({
-    endpointUrl: stringOrExpression.optional(),
+    endpointUrl: stringOrExpression,
     serverTransport: z.union([z.literal('httpStreamable'), z.literal('sse'), expressionSchema]).optional(),
     authentication: z.union([z.literal('bearerAuth'), z.literal('headerAuth'), z.literal('mcpOAuth2Api'), z.literal('multipleHeadersAuth'), z.literal('none'), expressionSchema]).optional(),
     include: z.union([z.literal('all'), z.literal('selected'), z.literal('except'), expressionSchema]).optional(),

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

@@ -8,7 +8,7 @@ export interface LcMcpClientToolV12Params {
 /**
  * Endpoint of your MCP server
  */
-    endpointUrl?: string | Expression<string> | PlaceholderValue;
+    endpointUrl: string | Expression<string> | PlaceholderValue;
 /**
  * The transport used by your endpoint
  * @default httpStreamable

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

@@ -20,7 +20,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     authentication: z.union([z.literal('none'), z.literal('bearerAuth'), z.literal('headerAuth'), expressionSchema]).optional(),
-    path: stringOrExpression.optional(),
+    path: stringOrExpression,
   });
 
   // Return combined config schema

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

@@ -13,7 +13,7 @@ export interface LcMcpTriggerV1Params {
 /**
  * The base path for this MCP server
  */
-    path?: string | Expression<string> | PlaceholderValue;
+    path: string | Expression<string> | PlaceholderValue;
 }
 
 export interface LcMcpTriggerV1SubnodeConfig {

package/dist/node-definitions/nodes/n8n-nodes-langchain/mcpTrigger/v11.schema.js

@@ -20,7 +20,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     authentication: z.union([z.literal('none'), z.literal('bearerAuth'), z.literal('headerAuth'), expressionSchema]).optional(),
-    path: stringOrExpression.optional(),
+    path: stringOrExpression,
   });
 
   // Return combined config schema

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

@@ -13,7 +13,7 @@ export interface LcMcpTriggerV11Params {
 /**
  * The base path for this MCP server
  */
-    path?: string | Expression<string> | PlaceholderValue;
+    path: string | Expression<string> | PlaceholderValue;
 }
 
 export interface LcMcpTriggerV11SubnodeConfig {

package/dist/node-definitions/nodes/n8n-nodes-langchain/mcpTrigger/v2.schema.js

@@ -20,7 +20,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     authentication: z.union([z.literal('none'), z.literal('bearerAuth'), z.literal('headerAuth'), expressionSchema]).optional(),
-    path: stringOrExpression.optional(),
+    path: stringOrExpression,
   });
 
   // Return combined config schema

package/dist/node-definitions/nodes/n8n-nodes-langchain/mcpTrigger/v2.ts

@@ -13,7 +13,7 @@ export interface LcMcpTriggerV2Params {
 /**
  * The base path for this MCP server
  */
-    path?: string | Expression<string> | PlaceholderValue;
+    path: string | Expression<string> | PlaceholderValue;
 }
 
 export interface LcMcpTriggerV2SubnodeConfig {

package/dist/node-definitions/nodes/n8n-nodes-langchain/memoryBufferWindow/v13.schema.js

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     sessionIdType: z.union([z.literal('fromInput'), z.literal('customKey'), expressionSchema]).optional(),
-    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["fromInput","customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
+    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
     contextWindowLength: numberOrExpression.optional(),
   });
 

package/dist/node-definitions/nodes/n8n-nodes-langchain/memoryBufferWindow/v13.ts

@@ -12,9 +12,8 @@ export interface LcMemoryBufferWindowV13Params {
  */
     sessionIdType?: 'fromInput' | 'customKey' | Expression<string>;
 /**
- * Session Key From Previous Node
- * @displayOptions.show { sessionIdType: ["fromInput"] }
- * @default ={{ $json.sessionId }}
+ * The key to use to store session ID in the memory
+ * @displayOptions.show { sessionIdType: ["customKey"] }
  */
     sessionKey?: string | Expression<string> | PlaceholderValue;
 /**

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

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     sessionIdType: z.union([z.literal('fromInput'), z.literal('customKey'), expressionSchema]).optional(),
-    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["fromInput","customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
+    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
     collectionName: stringOrExpression.optional(),
     databaseName: stringOrExpression.optional(),
     contextWindowLength: numberOrExpression.optional(),

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

@@ -12,9 +12,8 @@ export interface LcMemoryMongoDbChatV1Params {
  */
     sessionIdType?: 'fromInput' | 'customKey' | Expression<string>;
 /**
- * Session Key From Previous Node
- * @displayOptions.show { sessionIdType: ["fromInput"] }
- * @default ={{ $json.sessionId }}
+ * The key to use to store session ID in the memory
+ * @displayOptions.show { sessionIdType: ["customKey"] }
  */
     sessionKey?: string | Expression<string> | PlaceholderValue;
 /**

package/dist/node-definitions/nodes/n8n-nodes-langchain/memoryPostgresChat/v12.schema.js

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     sessionIdType: z.union([z.literal('fromInput'), z.literal('customKey'), expressionSchema]).optional(),
-    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["fromInput","customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
+    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
     tableName: stringOrExpression.optional(),
     contextWindowLength: numberOrExpression.optional(),
   });

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

@@ -12,9 +12,8 @@ export interface LcMemoryPostgresChatV12Params {
  */
     sessionIdType?: 'fromInput' | 'customKey' | Expression<string>;
 /**
- * Session Key From Previous Node
- * @displayOptions.show { sessionIdType: ["fromInput"] }
- * @default ={{ $json.sessionId }}
+ * The key to use to store session ID in the memory
+ * @displayOptions.show { sessionIdType: ["customKey"] }
  */
     sessionKey?: string | Expression<string> | PlaceholderValue;
 /**

package/dist/node-definitions/nodes/n8n-nodes-langchain/memoryPostgresChat/v13.schema.js

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     sessionIdType: z.union([z.literal('fromInput'), z.literal('customKey'), expressionSchema]).optional(),
-    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["fromInput","customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
+    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
     tableName: stringOrExpression.optional(),
     contextWindowLength: numberOrExpression.optional(),
   });

package/dist/node-definitions/nodes/n8n-nodes-langchain/memoryPostgresChat/v13.ts

@@ -12,9 +12,8 @@ export interface LcMemoryPostgresChatV13Params {
  */
     sessionIdType?: 'fromInput' | 'customKey' | Expression<string>;
 /**
- * Session Key From Previous Node
- * @displayOptions.show { sessionIdType: ["fromInput", "customKey"] }
- * @default ={{ $json.sessionId }}
+ * The key to use to store session ID in the memory
+ * @displayOptions.show { sessionIdType: ["customKey"] }
  */
     sessionKey?: string | Expression<string> | PlaceholderValue;
 /**

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

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     sessionIdType: z.union([z.literal('fromInput'), z.literal('customKey'), expressionSchema]).optional(),
-    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["fromInput","customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
+    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
     sessionTTL: numberOrExpression.optional(),
     contextWindowLength: numberOrExpression.optional(),
   });

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

@@ -12,9 +12,8 @@ export interface LcMemoryRedisChatV14Params {
  */
     sessionIdType?: 'fromInput' | 'customKey' | Expression<string>;
 /**
- * Session Key From Previous Node
- * @displayOptions.show { sessionIdType: ["fromInput"] }
- * @default ={{ $json.sessionId }}
+ * The key to use to store session ID in the memory
+ * @displayOptions.show { sessionIdType: ["customKey"] }
  */
     sessionKey?: string | Expression<string> | PlaceholderValue;
 /**

package/dist/node-definitions/nodes/n8n-nodes-langchain/memoryRedisChat/v15.schema.js

@@ -15,7 +15,7 @@ module.exports = function getSchema({ parameters, z, expressionSchema, stringOrE
   // Parameters schema
   const parametersSchema = z.object({
     sessionIdType: z.union([z.literal('fromInput'), z.literal('customKey'), expressionSchema]).optional(),
-    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["fromInput","customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
+    sessionKey: resolveSchema({ parameters, schema: stringOrExpression, required: false, displayOptions: {"show":{"sessionIdType":["customKey"]}}, defaults: {"sessionIdType":"fromInput"} }),
     sessionTTL: numberOrExpression.optional(),
     contextWindowLength: numberOrExpression.optional(),
   });