llm-exe 2.3.2 → 2.3.4

package/dist/index.d.mts

@@ -226,14 +226,14 @@ declare class StringExtractParser extends BaseParser<string> {
  * Creates a parser based on the given type.
  * @template S - JSON schema type.
  * @param type - The type of parser to create.
- * @returns An instance of ListToKeyValueParser.
+ * @returns An instance of MarkdownCodeBlocksParser.
  */
 declare function createParser<T extends Extract<CreateParserType, "markdownCodeBlocks">>(type: T, options?: BaseParserOptions): MarkdownCodeBlocksParser;
 /**
  * Creates a parser based on the given type.
  * @template S - JSON schema type.
  * @param type - The type of parser to create.
- * @returns An instance of ListToKeyValueParser.
+ * @returns An instance of MarkdownCodeBlockParser.
  */
 declare function createParser<T extends Extract<CreateParserType, "markdownCodeBlock">>(type: T, options?: BaseParserOptions): MarkdownCodeBlockParser;
 /**
@@ -432,8 +432,8 @@ declare class ChatPrompt<I extends Record<string, any>> extends BasePrompt<I> {
     readonly type: ChatPromptType;
     /**
      * @property parseUserTemplates - Whether or not to allow parsing
-     * user messages with the template engine. This could be a risk,
-     * so we only parse user messages if explicitly set.
+     * user messages with the template engine. Defaults to true.
+     * Set `allowUnsafeUserTemplate: false` in options to disable.
      */
     private parseUserTemplates;
     /**
@@ -468,13 +468,13 @@ declare class ChatPrompt<I extends Record<string, any>> extends BasePrompt<I> {
      */
     addAssistantMessage(content: string): ChatPrompt<I>;
     /**
-     * addFunctionMessage Helper to add an assistant message to the prompt.
+     * addFunctionMessage Helper to add a function message to the prompt.
      * @param content The message content.
      * @return ChatPrompt so it can be chained.
      */
     addFunctionMessage(content: string, name: string, id?: string): ChatPrompt<I>;
     /**
-     * addFunctionCallMessage Helper to add an assistant message to the prompt.
+     * addFunctionCallMessage Helper to add a function_call message to the prompt.
      * @param content The message content.
      * @return ChatPrompt so it can be chained.
      */
@@ -690,7 +690,7 @@ declare class Dialogue extends BaseStateItem<IChatMessages> {
     setUserMessage(content: string | IChatMessageContentDetailed[], name?: string): this;
     setAssistantMessage(content: string | OutputResultsText): this;
     setSystemMessage(content: string): this;
-    setToolMessage(content: string, name: string, id?: string): void;
+    setToolMessage(content: string, name: string, id?: string): this;
     setFunctionMessage(content: string, name: string, id?: string): this;
     /**
      * Set
@@ -699,7 +699,7 @@ declare class Dialogue extends BaseStateItem<IChatMessages> {
         name: string;
         arguments: string;
         id?: string;
-    }): void;
+    }): this;
     setFunctionCallMessage(input: {
         name: string;
         arguments: string;
@@ -1057,6 +1057,30 @@ type AllLlm = {
     };
 };
 type AllUseLlmOptions = AllLlm & {
+    "openai.gpt-5.2": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-5-mini": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-5-nano": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-4.1": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-4.1-mini": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-4.1-nano": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.o3": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.o4-mini": {
+        input: Omit<OpenAiRequest, "model">;
+    };
     "openai.gpt-4": {
         input: OpenAiRequest;
     };
@@ -1066,6 +1090,12 @@ type AllUseLlmOptions = AllLlm & {
     "openai.gpt-4o-mini": {
         input: Omit<OpenAiRequest, "model">;
     };
+    "anthropic.claude-opus-4-6": {
+        input: Omit<AnthropicRequest, "model">;
+    };
+    "anthropic.claude-sonnet-4-6": {
+        input: Omit<AnthropicRequest, "model">;
+    };
     "anthropic.claude-sonnet-4-0": {
         input: Omit<AnthropicRequest, "model">;
     };
@@ -1120,9 +1150,15 @@ type AllUseLlmOptions = AllLlm & {
     "xai.grok-3": {
         input: OpenAiRequest;
     };
+    "xai.grok-3-mini": {
+        input: Omit<OpenAiRequest, "model">;
+    };
     "xai.grok-4": {
         input: OpenAiRequest;
     };
+    "xai.grok-4-fast": {
+        input: Omit<OpenAiRequest, "model">;
+    };
     "ollama.deepseek-r1": {
         input: GenericLLm;
     };
@@ -1466,10 +1502,14 @@ declare const configs: {
     "xai.chat.v1": Config<keyof AllLlm>;
     "xai.grok-2": Config<keyof AllLlm>;
     "xai.grok-3": Config<keyof AllLlm>;
+    "xai.grok-3-mini": Config<keyof AllLlm>;
     "xai.grok-4": Config<keyof AllLlm>;
+    "xai.grok-4-fast": Config<keyof AllLlm>;
     "amazon:anthropic.chat.v1": Config<keyof AllLlm>;
     "amazon:meta.chat.v1": Config<keyof AllLlm>;
     "anthropic.chat.v1": Config<keyof AllLlm>;
+    "anthropic.claude-opus-4-6": Config<keyof AllLlm>;
+    "anthropic.claude-sonnet-4-6": Config<keyof AllLlm>;
     "anthropic.claude-sonnet-4": Config<keyof AllLlm>;
     "anthropic.claude-opus-4": Config<keyof AllLlm>;
     "anthropic.claude-3-7-sonnet": Config<keyof AllLlm>;
@@ -1479,6 +1519,14 @@ declare const configs: {
     "anthropic.claude-3-haiku": Config<keyof AllLlm>;
     "openai.chat.v1": Config<keyof AllLlm>;
     "openai.chat-mock.v1": Config<keyof AllLlm>;
+    "openai.gpt-5.2": Config<keyof AllLlm>;
+    "openai.gpt-5-mini": Config<keyof AllLlm>;
+    "openai.gpt-5-nano": Config<keyof AllLlm>;
+    "openai.gpt-4.1": Config<keyof AllLlm>;
+    "openai.gpt-4.1-mini": Config<keyof AllLlm>;
+    "openai.gpt-4.1-nano": Config<keyof AllLlm>;
+    "openai.o3": Config<keyof AllLlm>;
+    "openai.o4-mini": Config<keyof AllLlm>;
     "openai.gpt-4o": Config<keyof AllLlm>;
     "openai.gpt-4o-mini": Config<keyof AllLlm>;
 };

package/dist/index.d.ts

@@ -226,14 +226,14 @@ declare class StringExtractParser extends BaseParser<string> {
  * Creates a parser based on the given type.
  * @template S - JSON schema type.
  * @param type - The type of parser to create.
- * @returns An instance of ListToKeyValueParser.
+ * @returns An instance of MarkdownCodeBlocksParser.
  */
 declare function createParser<T extends Extract<CreateParserType, "markdownCodeBlocks">>(type: T, options?: BaseParserOptions): MarkdownCodeBlocksParser;
 /**
  * Creates a parser based on the given type.
  * @template S - JSON schema type.
  * @param type - The type of parser to create.
- * @returns An instance of ListToKeyValueParser.
+ * @returns An instance of MarkdownCodeBlockParser.
  */
 declare function createParser<T extends Extract<CreateParserType, "markdownCodeBlock">>(type: T, options?: BaseParserOptions): MarkdownCodeBlockParser;
 /**
@@ -432,8 +432,8 @@ declare class ChatPrompt<I extends Record<string, any>> extends BasePrompt<I> {
     readonly type: ChatPromptType;
     /**
      * @property parseUserTemplates - Whether or not to allow parsing
-     * user messages with the template engine. This could be a risk,
-     * so we only parse user messages if explicitly set.
+     * user messages with the template engine. Defaults to true.
+     * Set `allowUnsafeUserTemplate: false` in options to disable.
      */
     private parseUserTemplates;
     /**
@@ -468,13 +468,13 @@ declare class ChatPrompt<I extends Record<string, any>> extends BasePrompt<I> {
      */
     addAssistantMessage(content: string): ChatPrompt<I>;
     /**
-     * addFunctionMessage Helper to add an assistant message to the prompt.
+     * addFunctionMessage Helper to add a function message to the prompt.
      * @param content The message content.
      * @return ChatPrompt so it can be chained.
      */
     addFunctionMessage(content: string, name: string, id?: string): ChatPrompt<I>;
     /**
-     * addFunctionCallMessage Helper to add an assistant message to the prompt.
+     * addFunctionCallMessage Helper to add a function_call message to the prompt.
      * @param content The message content.
      * @return ChatPrompt so it can be chained.
      */
@@ -690,7 +690,7 @@ declare class Dialogue extends BaseStateItem<IChatMessages> {
     setUserMessage(content: string | IChatMessageContentDetailed[], name?: string): this;
     setAssistantMessage(content: string | OutputResultsText): this;
     setSystemMessage(content: string): this;
-    setToolMessage(content: string, name: string, id?: string): void;
+    setToolMessage(content: string, name: string, id?: string): this;
     setFunctionMessage(content: string, name: string, id?: string): this;
     /**
      * Set
@@ -699,7 +699,7 @@ declare class Dialogue extends BaseStateItem<IChatMessages> {
         name: string;
         arguments: string;
         id?: string;
-    }): void;
+    }): this;
     setFunctionCallMessage(input: {
         name: string;
         arguments: string;
@@ -1057,6 +1057,30 @@ type AllLlm = {
     };
 };
 type AllUseLlmOptions = AllLlm & {
+    "openai.gpt-5.2": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-5-mini": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-5-nano": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-4.1": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-4.1-mini": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.gpt-4.1-nano": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.o3": {
+        input: Omit<OpenAiRequest, "model">;
+    };
+    "openai.o4-mini": {
+        input: Omit<OpenAiRequest, "model">;
+    };
     "openai.gpt-4": {
         input: OpenAiRequest;
     };
@@ -1066,6 +1090,12 @@ type AllUseLlmOptions = AllLlm & {
     "openai.gpt-4o-mini": {
         input: Omit<OpenAiRequest, "model">;
     };
+    "anthropic.claude-opus-4-6": {
+        input: Omit<AnthropicRequest, "model">;
+    };
+    "anthropic.claude-sonnet-4-6": {
+        input: Omit<AnthropicRequest, "model">;
+    };
     "anthropic.claude-sonnet-4-0": {
         input: Omit<AnthropicRequest, "model">;
     };
@@ -1120,9 +1150,15 @@ type AllUseLlmOptions = AllLlm & {
     "xai.grok-3": {
         input: OpenAiRequest;
     };
+    "xai.grok-3-mini": {
+        input: Omit<OpenAiRequest, "model">;
+    };
     "xai.grok-4": {
         input: OpenAiRequest;
     };
+    "xai.grok-4-fast": {
+        input: Omit<OpenAiRequest, "model">;
+    };
     "ollama.deepseek-r1": {
         input: GenericLLm;
     };
@@ -1466,10 +1502,14 @@ declare const configs: {
     "xai.chat.v1": Config<keyof AllLlm>;
     "xai.grok-2": Config<keyof AllLlm>;
     "xai.grok-3": Config<keyof AllLlm>;
+    "xai.grok-3-mini": Config<keyof AllLlm>;
     "xai.grok-4": Config<keyof AllLlm>;
+    "xai.grok-4-fast": Config<keyof AllLlm>;
     "amazon:anthropic.chat.v1": Config<keyof AllLlm>;
     "amazon:meta.chat.v1": Config<keyof AllLlm>;
     "anthropic.chat.v1": Config<keyof AllLlm>;
+    "anthropic.claude-opus-4-6": Config<keyof AllLlm>;
+    "anthropic.claude-sonnet-4-6": Config<keyof AllLlm>;
     "anthropic.claude-sonnet-4": Config<keyof AllLlm>;
     "anthropic.claude-opus-4": Config<keyof AllLlm>;
     "anthropic.claude-3-7-sonnet": Config<keyof AllLlm>;
@@ -1479,6 +1519,14 @@ declare const configs: {
     "anthropic.claude-3-haiku": Config<keyof AllLlm>;
     "openai.chat.v1": Config<keyof AllLlm>;
     "openai.chat-mock.v1": Config<keyof AllLlm>;
+    "openai.gpt-5.2": Config<keyof AllLlm>;
+    "openai.gpt-5-mini": Config<keyof AllLlm>;
+    "openai.gpt-5-nano": Config<keyof AllLlm>;
+    "openai.gpt-4.1": Config<keyof AllLlm>;
+    "openai.gpt-4.1-mini": Config<keyof AllLlm>;
+    "openai.gpt-4.1-nano": Config<keyof AllLlm>;
+    "openai.o3": Config<keyof AllLlm>;
+    "openai.o4-mini": Config<keyof AllLlm>;
     "openai.gpt-4o": Config<keyof AllLlm>;
     "openai.gpt-4o-mini": Config<keyof AllLlm>;
 };

package/dist/index.js

@@ -283,6 +283,10 @@ var BaseExecutor = class {
         try {
           hookFn(_metadata, this.getMetadata());
         } catch (error) {
+          console.warn(
+            `[llm-exe] Error in "${String(hook)}" hook:`,
+            error
+          );
         }
       }
     }
@@ -530,7 +534,7 @@ var BooleanParser = class extends BaseParser {
       `Invalid input. Expected string. Received ${typeof text}.`
     );
     const clean = text.toLowerCase().trim();
-    if (clean === "true") {
+    if (clean === "true" || clean === "yes" || clean === "y" || clean === "1") {
       return true;
     }
     return false;
@@ -559,7 +563,7 @@ var NumberParser = class extends BaseParser {
     super("number", options);
   }
   parse(text) {
-    const match = text.match(/\d/g);
+    const match = text.match(/-?\d+(\.\d+)?/);
     return match && isFinite(toNumber(match[0])) ? toNumber(match[0]) : -1;
   }
 };
@@ -1461,9 +1465,8 @@ var asyncCallWithTimeout = async (asyncPromise, timeLimit = 1e4) => {
       );
     }, timeLimit);
   });
-  return Promise.race([asyncPromise, timeoutPromise]).then((result) => {
+  return Promise.race([asyncPromise, timeoutPromise]).finally(() => {
     clearTimeout(timeoutHandle);
-    return result;
   });
 };
 
@@ -1609,9 +1612,13 @@ var ListToJsonParser = class extends BaseParserWithJson {
     const lines = text.split("\n");
     const output = {};
     lines.forEach((line) => {
-      const [key, value] = line.split(":");
-      if (value) {
-        output[camelCase(key)] = value.trim();
+      const colonIndex = line.indexOf(":");
+      if (colonIndex !== -1) {
+        const key = line.slice(0, colonIndex);
+        const value = line.slice(colonIndex + 1).trim();
+        if (value) {
+          output[camelCase(key)] = value;
+        }
       }
     });
     if (this.schema) {
@@ -1683,7 +1690,7 @@ var ListToArrayParser = class extends BaseParser {
     super("listToArray");
   }
   parse(text) {
-    const lines = text.split("\n").map((s) => s.replace(/^- /, "").replace(/'/g, "'").trim());
+    const lines = text.split("\n").map((s) => s.replace(/^(?:[-*] |\d+\. )/, "").replace(/'/g, "\u2019").trim());
     return lines;
   }
 };
@@ -1811,8 +1818,11 @@ function createParser(type, options = {}) {
     case "stringExtract":
       return new StringExtractParser(options);
     case "string":
-    default:
       return new StringParser();
+    default:
+      throw new Error(
+        `Invalid parser type: "${type}". Valid types are: json, string, boolean, number, stringExtract, listToArray, listToJson, listToKeyValue, replaceStringTemplate, markdownCodeBlock, markdownCodeBlocks`
+      );
   }
 }
 function createCustomParser(name, parserFn) {
@@ -2416,6 +2426,18 @@ var openAiChatMockV1 = {
 var openai = {
   "openai.chat.v1": openAiChatV1,
   "openai.chat-mock.v1": openAiChatMockV1,
+  // GPT-5 family
+  "openai.gpt-5.2": withDefaultModel(openAiChatV1, "gpt-5.2"),
+  "openai.gpt-5-mini": withDefaultModel(openAiChatV1, "gpt-5-mini"),
+  "openai.gpt-5-nano": withDefaultModel(openAiChatV1, "gpt-5-nano"),
+  // GPT-4.1 family
+  "openai.gpt-4.1": withDefaultModel(openAiChatV1, "gpt-4.1"),
+  "openai.gpt-4.1-mini": withDefaultModel(openAiChatV1, "gpt-4.1-mini"),
+  "openai.gpt-4.1-nano": withDefaultModel(openAiChatV1, "gpt-4.1-nano"),
+  // Reasoning models
+  "openai.o3": withDefaultModel(openAiChatV1, "o3"),
+  "openai.o4-mini": withDefaultModel(openAiChatV1, "o4-mini"),
+  // GPT-4o family
   "openai.gpt-4o": withDefaultModel(openAiChatV1, "gpt-4o"),
   "openai.gpt-4o-mini": withDefaultModel(openAiChatV1, "gpt-4o-mini")
 };
@@ -2454,6 +2476,20 @@ function anthropicPromptMessageCallback(_message) {
 }
 
 // src/llm/config/anthropic/promptSanitize.ts
+function mergeConsecutiveSameRole(messages) {
+  if (messages.length <= 1) return messages;
+  const merged = [messages[0]];
+  for (let i = 1; i < messages.length; i++) {
+    const prev = merged[merged.length - 1];
+    const curr = messages[i];
+    if (curr.role === prev.role && Array.isArray(prev.content) && Array.isArray(curr.content)) {
+      prev.content = [...prev.content, ...curr.content];
+    } else {
+      merged.push(curr);
+    }
+  }
+  return merged;
+}
 function anthropicPromptSanitize(_messages, _inputBodyObj, _outputObj) {
   if (typeof _messages === "string") {
     return [{ role: "user", content: _messages }].map(
@@ -2471,14 +2507,15 @@ function anthropicPromptSanitize(_messages, _inputBodyObj, _outputObj) {
   }
   if (first.role === "system" && messages.length > 0) {
     _outputObj.system = first.content;
-    return messages.map((m) => {
+    const result2 = messages.map((m) => {
       if (m.role === "system") {
         return { ...m, role: "user" };
       }
       return m;
     }).map(anthropicPromptMessageCallback);
+    return mergeConsecutiveSameRole(result2);
   }
-  return [
+  const result = [
     first,
     ...messages.map((m) => {
       if (m.role === "system") {
@@ -2487,6 +2524,7 @@ function anthropicPromptSanitize(_messages, _inputBodyObj, _outputObj) {
       return m;
     })
   ].map(anthropicPromptMessageCallback);
+  return mergeConsecutiveSameRole(result);
 }
 
 // src/llm/output/claude.ts
@@ -2735,7 +2773,16 @@ var anthropicChatV1 = {
 };
 var anthropic = {
   "anthropic.chat.v1": anthropicChatV1,
-  // Claude 4 models (latest generation)
+  // Claude 4.6 models
+  "anthropic.claude-opus-4-6": withDefaultModel(
+    anthropicChatV1,
+    "claude-opus-4-6"
+  ),
+  "anthropic.claude-sonnet-4-6": withDefaultModel(
+    anthropicChatV1,
+    "claude-sonnet-4-6"
+  ),
+  // Claude 4 models
   "anthropic.claude-sonnet-4": withDefaultModel(
     anthropicChatV1,
     "claude-sonnet-4-0"
@@ -2779,7 +2826,9 @@ var xai = {
   "xai.chat.v1": xaiChatV1,
   "xai.grok-2": withDefaultModel(xaiChatV1, "grok-2-latest"),
   "xai.grok-3": withDefaultModel(xaiChatV1, "grok-3"),
-  "xai.grok-4": withDefaultModel(xaiChatV1, "grok-4")
+  "xai.grok-3-mini": withDefaultModel(xaiChatV1, "grok-3-mini"),
+  "xai.grok-4": withDefaultModel(xaiChatV1, "grok-4"),
+  "xai.grok-4-fast": withDefaultModel(xaiChatV1, "grok-4-fast-non-reasoning")
 };
 
 // src/llm/output/_utils/combineJsonl.ts
@@ -2900,7 +2949,7 @@ function googleGeminiPromptMessageCallback(_message) {
     message.role = "model";
   }
   let { role, ...payload } = message;
-  if (typeof payload.content === "string") {
+  if (typeof payload.content === "string" && message.role !== "function") {
     parts.push({ text: message.content });
   }
   if (message.role === "function") {
@@ -2939,6 +2988,20 @@ function googleGeminiPromptMessageCallback(_message) {
 }
 
 // src/llm/config/google/promptSanitize.ts
+function mergeConsecutiveSameRole2(messages) {
+  if (messages.length <= 1) return messages;
+  const merged = [messages[0]];
+  for (let i = 1; i < messages.length; i++) {
+    const prev = merged[merged.length - 1];
+    const curr = messages[i];
+    if (curr.role === prev.role && Array.isArray(prev.parts) && Array.isArray(curr.parts)) {
+      prev.parts = [...prev.parts, ...curr.parts];
+    } else {
+      merged.push(curr);
+    }
+  }
+  return merged;
+}
 function googleGeminiPromptSanitize(_messages, _inputBodyObj, _outputObj) {
   if (typeof _messages === "string") {
     return [{ role: "user", parts: [{ text: _messages }] }];
@@ -2965,9 +3028,13 @@ function googleGeminiPromptSanitize(_messages, _inputBodyObj, _outputObj) {
           text: message.content
         }))
       };
-      return withoutSystemInstructions.map(googleGeminiPromptMessageCallback);
+      const result2 = withoutSystemInstructions.map(
+        googleGeminiPromptMessageCallback
+      );
+      return mergeConsecutiveSameRole2(result2);
     }
-    return _messages.map(googleGeminiPromptMessageCallback);
+    const result = _messages.map(googleGeminiPromptMessageCallback);
+    return mergeConsecutiveSameRole2(result);
   }
   throw new Error("Invalid messages format");
 }
@@ -4171,8 +4238,8 @@ var ChatPrompt = class extends BasePrompt {
     __publicField(this, "type", "chat");
     /**
      * @property parseUserTemplates - Whether or not to allow parsing
-     * user messages with the template engine. This could be a risk,
-     * so we only parse user messages if explicitly set.
+     * user messages with the template engine. Defaults to true.
+     * Set `allowUnsafeUserTemplate: false` in options to disable.
      */
     __publicField(this, "parseUserTemplates", true);
     if (typeof options?.allowUnsafeUserTemplate === "boolean") {
@@ -4233,7 +4300,7 @@ var ChatPrompt = class extends BasePrompt {
     return this;
   }
   /**
-   * addFunctionMessage Helper to add an assistant message to the prompt.
+   * addFunctionMessage Helper to add a function message to the prompt.
    * @param content The message content.
    * @return ChatPrompt so it can be chained.
    */
@@ -4247,7 +4314,7 @@ var ChatPrompt = class extends BasePrompt {
     return this;
   }
   /**
-   * addFunctionCallMessage Helper to add an assistant message to the prompt.
+   * addFunctionCallMessage Helper to add a function_call message to the prompt.
    * @param content The message content.
    * @return ChatPrompt so it can be chained.
    */
@@ -4802,7 +4869,7 @@ var Dialogue = class extends BaseStateItem {
     return this;
   }
   setToolMessage(content, name, id) {
-    this.setFunctionMessage(content, name, id);
+    return this.setFunctionMessage(content, name, id);
   }
   setFunctionMessage(content, name, id) {
     if (content) {
@@ -4819,7 +4886,7 @@ var Dialogue = class extends BaseStateItem {
    * Set
    */
   setToolCallMessage(input) {
-    this.setFunctionCallMessage(input);
+    return this.setFunctionCallMessage(input);
   }
   setFunctionCallMessage(input) {
     if (!input || typeof input !== "object") {

package/dist/index.mjs

@@ -220,6 +220,10 @@ var BaseExecutor = class {
         try {
           hookFn(_metadata, this.getMetadata());
         } catch (error) {
+          console.warn(
+            `[llm-exe] Error in "${String(hook)}" hook:`,
+            error
+          );
         }
       }
     }
@@ -467,7 +471,7 @@ var BooleanParser = class extends BaseParser {
       `Invalid input. Expected string. Received ${typeof text}.`
     );
     const clean = text.toLowerCase().trim();
-    if (clean === "true") {
+    if (clean === "true" || clean === "yes" || clean === "y" || clean === "1") {
       return true;
     }
     return false;
@@ -496,7 +500,7 @@ var NumberParser = class extends BaseParser {
     super("number", options);
   }
   parse(text) {
-    const match = text.match(/\d/g);
+    const match = text.match(/-?\d+(\.\d+)?/);
     return match && isFinite(toNumber(match[0])) ? toNumber(match[0]) : -1;
   }
 };
@@ -1398,9 +1402,8 @@ var asyncCallWithTimeout = async (asyncPromise, timeLimit = 1e4) => {
       );
     }, timeLimit);
   });
-  return Promise.race([asyncPromise, timeoutPromise]).then((result) => {
+  return Promise.race([asyncPromise, timeoutPromise]).finally(() => {
     clearTimeout(timeoutHandle);
-    return result;
   });
 };
 
@@ -1546,9 +1549,13 @@ var ListToJsonParser = class extends BaseParserWithJson {
     const lines = text.split("\n");
     const output = {};
     lines.forEach((line) => {
-      const [key, value] = line.split(":");
-      if (value) {
-        output[camelCase(key)] = value.trim();
+      const colonIndex = line.indexOf(":");
+      if (colonIndex !== -1) {
+        const key = line.slice(0, colonIndex);
+        const value = line.slice(colonIndex + 1).trim();
+        if (value) {
+          output[camelCase(key)] = value;
+        }
       }
     });
     if (this.schema) {
@@ -1620,7 +1627,7 @@ var ListToArrayParser = class extends BaseParser {
     super("listToArray");
   }
   parse(text) {
-    const lines = text.split("\n").map((s) => s.replace(/^- /, "").replace(/'/g, "'").trim());
+    const lines = text.split("\n").map((s) => s.replace(/^(?:[-*] |\d+\. )/, "").replace(/'/g, "\u2019").trim());
     return lines;
   }
 };
@@ -1748,8 +1755,11 @@ function createParser(type, options = {}) {
     case "stringExtract":
       return new StringExtractParser(options);
     case "string":
-    default:
       return new StringParser();
+    default:
+      throw new Error(
+        `Invalid parser type: "${type}". Valid types are: json, string, boolean, number, stringExtract, listToArray, listToJson, listToKeyValue, replaceStringTemplate, markdownCodeBlock, markdownCodeBlocks`
+      );
   }
 }
 function createCustomParser(name, parserFn) {
@@ -2353,6 +2363,18 @@ var openAiChatMockV1 = {
 var openai = {
   "openai.chat.v1": openAiChatV1,
   "openai.chat-mock.v1": openAiChatMockV1,
+  // GPT-5 family
+  "openai.gpt-5.2": withDefaultModel(openAiChatV1, "gpt-5.2"),
+  "openai.gpt-5-mini": withDefaultModel(openAiChatV1, "gpt-5-mini"),
+  "openai.gpt-5-nano": withDefaultModel(openAiChatV1, "gpt-5-nano"),
+  // GPT-4.1 family
+  "openai.gpt-4.1": withDefaultModel(openAiChatV1, "gpt-4.1"),
+  "openai.gpt-4.1-mini": withDefaultModel(openAiChatV1, "gpt-4.1-mini"),
+  "openai.gpt-4.1-nano": withDefaultModel(openAiChatV1, "gpt-4.1-nano"),
+  // Reasoning models
+  "openai.o3": withDefaultModel(openAiChatV1, "o3"),
+  "openai.o4-mini": withDefaultModel(openAiChatV1, "o4-mini"),
+  // GPT-4o family
   "openai.gpt-4o": withDefaultModel(openAiChatV1, "gpt-4o"),
   "openai.gpt-4o-mini": withDefaultModel(openAiChatV1, "gpt-4o-mini")
 };
@@ -2391,6 +2413,20 @@ function anthropicPromptMessageCallback(_message) {
 }
 
 // src/llm/config/anthropic/promptSanitize.ts
+function mergeConsecutiveSameRole(messages) {
+  if (messages.length <= 1) return messages;
+  const merged = [messages[0]];
+  for (let i = 1; i < messages.length; i++) {
+    const prev = merged[merged.length - 1];
+    const curr = messages[i];
+    if (curr.role === prev.role && Array.isArray(prev.content) && Array.isArray(curr.content)) {
+      prev.content = [...prev.content, ...curr.content];
+    } else {
+      merged.push(curr);
+    }
+  }
+  return merged;
+}
 function anthropicPromptSanitize(_messages, _inputBodyObj, _outputObj) {
   if (typeof _messages === "string") {
     return [{ role: "user", content: _messages }].map(
@@ -2408,14 +2444,15 @@ function anthropicPromptSanitize(_messages, _inputBodyObj, _outputObj) {
   }
   if (first.role === "system" && messages.length > 0) {
     _outputObj.system = first.content;
-    return messages.map((m) => {
+    const result2 = messages.map((m) => {
       if (m.role === "system") {
         return { ...m, role: "user" };
       }
       return m;
     }).map(anthropicPromptMessageCallback);
+    return mergeConsecutiveSameRole(result2);
   }
-  return [
+  const result = [
     first,
     ...messages.map((m) => {
       if (m.role === "system") {
@@ -2424,6 +2461,7 @@ function anthropicPromptSanitize(_messages, _inputBodyObj, _outputObj) {
       return m;
     })
   ].map(anthropicPromptMessageCallback);
+  return mergeConsecutiveSameRole(result);
 }
 
 // src/llm/output/claude.ts
@@ -2672,7 +2710,16 @@ var anthropicChatV1 = {
 };
 var anthropic = {
   "anthropic.chat.v1": anthropicChatV1,
-  // Claude 4 models (latest generation)
+  // Claude 4.6 models
+  "anthropic.claude-opus-4-6": withDefaultModel(
+    anthropicChatV1,
+    "claude-opus-4-6"
+  ),
+  "anthropic.claude-sonnet-4-6": withDefaultModel(
+    anthropicChatV1,
+    "claude-sonnet-4-6"
+  ),
+  // Claude 4 models
   "anthropic.claude-sonnet-4": withDefaultModel(
     anthropicChatV1,
     "claude-sonnet-4-0"
@@ -2716,7 +2763,9 @@ var xai = {
   "xai.chat.v1": xaiChatV1,
   "xai.grok-2": withDefaultModel(xaiChatV1, "grok-2-latest"),
   "xai.grok-3": withDefaultModel(xaiChatV1, "grok-3"),
-  "xai.grok-4": withDefaultModel(xaiChatV1, "grok-4")
+  "xai.grok-3-mini": withDefaultModel(xaiChatV1, "grok-3-mini"),
+  "xai.grok-4": withDefaultModel(xaiChatV1, "grok-4"),
+  "xai.grok-4-fast": withDefaultModel(xaiChatV1, "grok-4-fast-non-reasoning")
 };
 
 // src/llm/output/_utils/combineJsonl.ts
@@ -2837,7 +2886,7 @@ function googleGeminiPromptMessageCallback(_message) {
     message.role = "model";
   }
   let { role, ...payload } = message;
-  if (typeof payload.content === "string") {
+  if (typeof payload.content === "string" && message.role !== "function") {
     parts.push({ text: message.content });
   }
   if (message.role === "function") {
@@ -2876,6 +2925,20 @@ function googleGeminiPromptMessageCallback(_message) {
 }
 
 // src/llm/config/google/promptSanitize.ts
+function mergeConsecutiveSameRole2(messages) {
+  if (messages.length <= 1) return messages;
+  const merged = [messages[0]];
+  for (let i = 1; i < messages.length; i++) {
+    const prev = merged[merged.length - 1];
+    const curr = messages[i];
+    if (curr.role === prev.role && Array.isArray(prev.parts) && Array.isArray(curr.parts)) {
+      prev.parts = [...prev.parts, ...curr.parts];
+    } else {
+      merged.push(curr);
+    }
+  }
+  return merged;
+}
 function googleGeminiPromptSanitize(_messages, _inputBodyObj, _outputObj) {
   if (typeof _messages === "string") {
     return [{ role: "user", parts: [{ text: _messages }] }];
@@ -2902,9 +2965,13 @@ function googleGeminiPromptSanitize(_messages, _inputBodyObj, _outputObj) {
           text: message.content
         }))
       };
-      return withoutSystemInstructions.map(googleGeminiPromptMessageCallback);
+      const result2 = withoutSystemInstructions.map(
+        googleGeminiPromptMessageCallback
+      );
+      return mergeConsecutiveSameRole2(result2);
     }
-    return _messages.map(googleGeminiPromptMessageCallback);
+    const result = _messages.map(googleGeminiPromptMessageCallback);
+    return mergeConsecutiveSameRole2(result);
   }
   throw new Error("Invalid messages format");
 }
@@ -4108,8 +4175,8 @@ var ChatPrompt = class extends BasePrompt {
     __publicField(this, "type", "chat");
     /**
      * @property parseUserTemplates - Whether or not to allow parsing
-     * user messages with the template engine. This could be a risk,
-     * so we only parse user messages if explicitly set.
+     * user messages with the template engine. Defaults to true.
+     * Set `allowUnsafeUserTemplate: false` in options to disable.
      */
     __publicField(this, "parseUserTemplates", true);
     if (typeof options?.allowUnsafeUserTemplate === "boolean") {
@@ -4170,7 +4237,7 @@ var ChatPrompt = class extends BasePrompt {
     return this;
   }
   /**
-   * addFunctionMessage Helper to add an assistant message to the prompt.
+   * addFunctionMessage Helper to add a function message to the prompt.
    * @param content The message content.
    * @return ChatPrompt so it can be chained.
    */
@@ -4184,7 +4251,7 @@ var ChatPrompt = class extends BasePrompt {
     return this;
   }
   /**
-   * addFunctionCallMessage Helper to add an assistant message to the prompt.
+   * addFunctionCallMessage Helper to add a function_call message to the prompt.
    * @param content The message content.
    * @return ChatPrompt so it can be chained.
    */
@@ -4739,7 +4806,7 @@ var Dialogue = class extends BaseStateItem {
     return this;
   }
   setToolMessage(content, name, id) {
-    this.setFunctionMessage(content, name, id);
+    return this.setFunctionMessage(content, name, id);
   }
   setFunctionMessage(content, name, id) {
     if (content) {
@@ -4756,7 +4823,7 @@ var Dialogue = class extends BaseStateItem {
    * Set
    */
   setToolCallMessage(input) {
-    this.setFunctionCallMessage(input);
+    return this.setFunctionCallMessage(input);
   }
   setFunctionCallMessage(input) {
     if (!input || typeof input !== "object") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-exe",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "description": "Simplify building LLM-powered apps with easy-to-use base components, supporting text and chat-based prompts with handlebars template engine, output parsers, and flexible function calling capabilities.",
   "keywords": [
     "ai",
@@ -38,7 +38,7 @@
     "typecheck": "tsc --noEmit",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --config jest.config.ts --detectOpenHandles --coverage --forceExit",
     "test-examples": "eval $(cat .env) NODE_OPTIONS=--experimental-vm-modules jest --config jest.config.examples.ts --detectOpenHandles --coverage --forceExit",
-    "test-one": "eval $(cat .env) NODE_OPTIONS=--experimental-vm-modules jest --detectOpenHandles --coverage --forceExit --config jest.config.examples.ts examples/intentBot.test.ts",
+    "test-one": "eval $(cat .env) NODE_OPTIONS=--experimental-vm-modules jest --detectOpenHandles --coverage --forceExit --config jest.config.examples.ts examples/helloWorld.test.ts",
     "run-one": "eval $(cat .env) ts-node ./examples/chains/self-refinement/usage.ts",
     "build": "(concurrently \"tsc --p ./tsconfig.json -w\" \"tsc-alias -p tsconfig.json -w\")",
     "build:ci": "tsup src/index.ts --format cjs,esm --dts --clean",
@@ -46,7 +46,7 @@
     "build:package": "tsup src/index.ts --format cjs,esm --dts --clean --external jsonschema,json-schema-to-ts,exponential-backoff,@aws-sdk/credential-providers,@aws-crypto/sha256-js,@smithy/protocol-http,@smithy/signature-v4",
     "build:docs-examples": "./node_modules/.bin/esbuild examples/prompt/index.ts examples/state/index.ts --bundle --outdir=docs/.vitepress/components/examples  --platform=node --target=es6 --format=esm",
     "build:watch:docs-examples": "./node_modules/.bin/esbuild  examples/prompt/index.ts examples/state/index.ts  --watch --bundle --outdir=docs/.vitepress/components/examples  --platform=node --target=es6 --format=esm",
-    "predocs:build": "npm run build:docs-examples",
+    "predocs:build": "npm run build:docs-examples && bash scripts/generate-llms-txt.sh",
     "docs:dev": "eval $(cat docs/.env) && concurrently \"vitepress dev docs\" \"npm run build:watch:docs-examples\"",
     "docs:build": "eval $(cat docs/.env) && vitepress build docs",
     "docs:update-providers": "node docs/.vitepress/scripts/updateProviders.js",

package/readme.md

@@ -41,6 +41,8 @@ const llmExe = require("llm-exe");
 ## Overview
 
 ```ts
+import { useLlm, createChatPrompt, createParser, createLlmExecutor, defineSchema } from "llm-exe";
+
 // Prompt
 const prompt = createChatPrompt("You are a support agent. Help the user.");
 prompt.addUserMessage("I need help with my order.");
@@ -48,8 +50,16 @@ prompt.addUserMessage("I need help with my order.");
 // LLM
 const llm = useLlm("openai.gpt-4o");
 
-// Parser
-const parser = createParser("json", { schema: mySchema });
+// Parser — schema uses JSON Schema (via defineSchema)
+const schema = defineSchema({
+  type: "object",
+  properties: {
+    answer: { type: "string" },
+    action: { type: "string" },
+  },
+  required: ["answer", "action"],
+} as const);
+const parser = createParser("json", { schema });
 
 // Executor
 const executor = createLlmExecutor({ llm, prompt, parser });
@@ -71,11 +81,17 @@ Welcome back!
 #### Built-In Parsers
 
 ```ts
-createParser("stringExtract", { enum: ["yes", "no"] });
-createParser("listToJson");
-createParser("listToArray");
-createParser("markdownCodeBlock");
-// ...etc
+createParser("string");              // pass-through, returns string
+createParser("json", { schema });    // JSON with optional schema validation
+createParser("boolean");             // extracts boolean from response
+createParser("number");              // extracts number from response
+createParser("stringExtract", { enum: ["yes", "no"] }); // match one of the enum values
+createParser("listToArray");         // newline-separated list → string[]
+createParser("listToJson");          // key: value list → object (with optional schema)
+createParser("listToKeyValue");      // key: value list → Array<{ key, value }>
+createParser("markdownCodeBlock");   // single code block → { code, language }
+createParser("markdownCodeBlocks");  // multiple code blocks → Array<{ code, language }>
+createParser("replaceStringTemplate"); // handlebars-based output templating
 ```
 
 #### Custom Parsers