llm-exe 2.2.0 → 2.2.1

package/dist/index.d.mts

@@ -65,20 +65,6 @@ type OpenAIChatModelName = "gpt-3.5-turbo" | "gpt-3.5-turbo-0613" | "gpt-3.5-tur
 type OpenAIConversationModelName = "davinci" | "text-curie-001" | "text-babbage-001" | "text-ada-001";
 type OpenAIEmbeddingModelName = "text-embedding-ada-002";
 type OpenAIModelName = OpenAIChatModelName | OpenAIConversationModelName | OpenAIEmbeddingModelName;
-interface LlmExecutorExecuteOptions {
-    functions?: CallableExecutorCore[];
-    functionCall?: any;
-    jsonSchema?: Record<string, any>;
-}
-type GenericFunctionCall = "auto" | "none" | "any" | {
-    name: string;
-};
-interface OpenAiLlmExecutorOptions<T extends GenericFunctionCall = "auto"> extends LlmExecutorExecuteOptions {
-    functions?: CallableExecutorCore[];
-    functionCall?: T;
-    functionCallStrictInput?: boolean;
-    jsonSchema?: Record<string, any>;
-}
 
 /**
  * BaseParser is an abstract class for parsing text and enforcing JSON schema on the parsed data.
@@ -113,21 +99,6 @@ declare abstract class BaseParserWithJson<S extends JSONSchema | undefined = und
     constructor(name: string, options: BaseParserOptionsWithSchema<S>);
 }
 
-interface OpenAiFunctionParserOptions<T extends BaseParser<any>> extends BaseParserOptions {
-    parser: T;
-}
-declare class OpenAiFunctionParser<T extends BaseParser<any>> extends BaseParser<ParserOutput<T> | {
-    name: any;
-    arguments: any;
-}> {
-    parser: T;
-    constructor(options: OpenAiFunctionParserOptions<T>);
-    parse(text: OutputResultContent[], _options?: Record<string, any>): ParserOutput<T> | {
-        name: string;
-        arguments: any;
-    };
-}
-
 interface StringParserOptions extends BaseParserOptions {
 }
 declare class StringParser extends BaseParser<string> {
@@ -330,6 +301,25 @@ declare function createParser<T extends Extract<CreateParserType, "json">, S ext
 declare function createParser<T extends CreateParserType, S extends JSONSchema | undefined = undefined>(type: T, options?: BaseParserOptionsWithSchema<S> | BaseParserOptions): JsonParser<S> | ListToJsonParser<S> | StringParser | NumberParser | BooleanParser | ListToArrayParser | ListToKeyValueParser | ReplaceStringTemplateParser | MarkdownCodeBlockParser | MarkdownCodeBlocksParser | StringExtractParser;
 declare function createCustomParser<O>(name: string, parserFn: (text: string, inputValues: ExecutorContext<any, any>) => O): CustomParser<ReturnType<typeof parserFn>>;
 
+interface LlmNativeFunctionParserOptions<T extends BaseParser<any>> extends BaseParserOptions {
+    parser: T;
+}
+declare class LlmNativeFunctionParser<T extends BaseParser<any>> extends BaseParser<ParserOutput<T> | {
+    name: any;
+    arguments: any;
+}> {
+    parser: T;
+    constructor(options: LlmNativeFunctionParserOptions<T>);
+    parse(text: OutputResultContent[], _options?: Record<string, any>): ParserOutput<T> | {
+        name: string;
+        arguments: any;
+    };
+}
+/**
+ * @deprecated Use `LlmExecutorWithFunctions` instead.
+ */
+declare const OpenAiFunctionParser: typeof LlmNativeFunctionParser;
+
 declare function replaceTemplateString(templateString?: string, substitutions?: Record<string, any>, configuration?: PromptTemplateOptions): string;
 
 declare function replaceTemplateStringAsync(templateString?: string, substitutions?: Record<string, any>, configuration?: PromptTemplateOptions): Promise<string>;
@@ -740,9 +730,14 @@ declare class LlmExecutor<Llm extends BaseLlm<any>, Prompt extends BasePrompt<Re
 /**
  * Core Executor With LLM
  */
-declare class LlmExecutorOpenAiFunctions<Llm extends BaseLlm, Prompt extends BasePrompt<Record<string, any>>, Parser extends BaseParser, State extends BaseState> extends LlmExecutor<Llm, Prompt, Parser, State> {
+declare class LlmExecutorWithFunctions<Llm extends BaseLlm, Prompt extends BasePrompt<Record<string, any>>, Parser extends BaseParser, State extends BaseState> extends LlmExecutor<Llm, Prompt, Parser, State> {
     constructor(llmConfiguration: ExecutorWithLlmOptions<Llm, Prompt, Parser, State>, options?: CoreExecutorExecuteOptions<LlmExecutorHooks>);
-    execute<T extends GenericFunctionCall>(_input: PromptInput<Prompt>, _options: OpenAiLlmExecutorOptions<T>): Promise<ParserOutput<Parser>>;
+    execute<T extends GenericFunctionCall>(_input: PromptInput<Prompt>, _options: LlmExecutorWithFunctionsOptions<T>): Promise<ParserOutput<Parser>>;
+}
+/**
+ * @deprecated Use `LlmExecutorWithFunctions` instead.
+ */
+declare class LlmExecutorOpenAiFunctions<Llm extends BaseLlm, Prompt extends BasePrompt<Record<string, any>>, Parser extends BaseParser, State extends BaseState> extends LlmExecutorWithFunctions<Llm, Prompt, Parser, State> {
 }
 
 /**
@@ -763,6 +758,7 @@ declare function createCoreExecutor<I extends PlainObject, O>(handler: (input: I
  * @returns  - A new LlmExecutor instance.
  */
 declare function createLlmExecutor<Llm extends BaseLlm<any>, Prompt extends BasePrompt<any>, Parser extends BaseParser, State extends BaseState>(llmConfiguration: ExecutorWithLlmOptions<Llm, Prompt, Parser, State>, options?: CoreExecutorExecuteOptions<LlmExecutorHooks>): LlmExecutor<Llm, Prompt, Parser, State>;
+declare function createLlmFunctionExecutor<Llm extends BaseLlm, Prompt extends BasePrompt<Record<string, any>>, Parser extends BaseParser, State extends BaseState>(llmConfiguration: ExecutorWithLlmOptions<Llm, Prompt, Parser, State>, options?: CoreExecutorExecuteOptions<LlmExecutorHooks>): LlmExecutorWithFunctions<Llm, Prompt, Parser, State>;
 
 declare const hookOnComplete = "onComplete";
 declare const hookOnError = "onError";
@@ -829,6 +825,20 @@ interface CallableExecutorCore {
     description: string;
     parameters?: Record<string, any>;
 }
+interface LlmExecutorExecuteOptions {
+    functions?: CallableExecutorCore[];
+    functionCall?: any;
+    jsonSchema?: Record<string, any>;
+}
+type GenericFunctionCall = "auto" | "none" | "any" | {
+    name: string;
+};
+interface LlmExecutorWithFunctionsOptions<T extends GenericFunctionCall = "auto"> extends LlmExecutorExecuteOptions {
+    functions?: CallableExecutorCore[];
+    functionCall?: T;
+    functionCallStrictInput?: boolean;
+    jsonSchema?: Record<string, any>;
+}
 
 type CreateParserType = "json" | "string" | "boolean" | "number" | "stringExtract" | "listToArray" | "listToJson" | "listToKeyValue" | "replaceStringTemplate" | "markdownCodeBlocks" | "markdownCodeBlock";
 interface BaseParserOptions {
@@ -1260,7 +1270,7 @@ declare const configs: {
 };
 
 declare function useLlm<T extends keyof typeof configs>(provider: T, options?: AllUseLlmOptions[T]["input"]): {
-    call: (messages: string | IChatMessages, options?: OpenAiLlmExecutorOptions) => Promise<{
+    call: (messages: string | IChatMessages, options?: LlmExecutorWithFunctionsOptions) => Promise<{
         getResultContent: (index?: number) => OutputResultContent[];
         getResultText: () => string;
         getResult: () => OutputResult;
@@ -1280,7 +1290,7 @@ declare function useLlm<T extends keyof typeof configs>(provider: T, options?: A
 };
 
 declare function createEmbedding<T extends EmbeddingProviderKey>(provider: T, options: AllEmbedding[T]["input"]): {
-    call: (messages: string | string[], options?: OpenAiLlmExecutorOptions) => Promise<{
+    call: (messages: string | string[], options?: LlmExecutorWithFunctionsOptions) => Promise<{
         getEmbedding: (index?: number) => number[];
         getResult: () => EmbeddingOutputResult;
     }>;
@@ -1298,4 +1308,4 @@ declare function createEmbedding<T extends EmbeddingProviderKey>(provider: T, op
     };
 };
 
-export { BaseExecutor, type BaseLlm, BaseParser, BasePrompt, BaseStateItem, ChatPrompt, CustomParser, DefaultState, DefaultStateItem, type EmbeddingProviderKey, type ExecutorContext, type IChatMessages, LlmExecutorOpenAiFunctions, type LlmProvider, type LlmProviderKey, type OpenAIModelName, OpenAiFunctionParser, TextPrompt, type UseLlmKey, createCallableExecutor, createChatPrompt, createCoreExecutor, createCustomParser, createDialogue, createEmbedding, createLlmExecutor, createParser, createPrompt, createState, createStateItem, defineSchema, registerHelpers, registerPartials, useExecutors, useLlm, index as utils };
+export { BaseExecutor, type BaseLlm, BaseParser, BasePrompt, BaseStateItem, ChatPrompt, CustomParser, DefaultState, DefaultStateItem, type EmbeddingProviderKey, type ExecutorContext, type IChatMessages, LlmExecutorOpenAiFunctions, LlmExecutorWithFunctions, LlmNativeFunctionParser, type LlmProvider, type LlmProviderKey, type OpenAIModelName, OpenAiFunctionParser, TextPrompt, type UseLlmKey, createCallableExecutor, createChatPrompt, createCoreExecutor, createCustomParser, createDialogue, createEmbedding, createLlmExecutor, createLlmFunctionExecutor, createParser, createPrompt, createState, createStateItem, defineSchema, registerHelpers, registerPartials, useExecutors, useLlm, index as utils };

package/dist/index.d.ts

@@ -65,20 +65,6 @@ type OpenAIChatModelName = "gpt-3.5-turbo" | "gpt-3.5-turbo-0613" | "gpt-3.5-tur
 type OpenAIConversationModelName = "davinci" | "text-curie-001" | "text-babbage-001" | "text-ada-001";
 type OpenAIEmbeddingModelName = "text-embedding-ada-002";
 type OpenAIModelName = OpenAIChatModelName | OpenAIConversationModelName | OpenAIEmbeddingModelName;
-interface LlmExecutorExecuteOptions {
-    functions?: CallableExecutorCore[];
-    functionCall?: any;
-    jsonSchema?: Record<string, any>;
-}
-type GenericFunctionCall = "auto" | "none" | "any" | {
-    name: string;
-};
-interface OpenAiLlmExecutorOptions<T extends GenericFunctionCall = "auto"> extends LlmExecutorExecuteOptions {
-    functions?: CallableExecutorCore[];
-    functionCall?: T;
-    functionCallStrictInput?: boolean;
-    jsonSchema?: Record<string, any>;
-}
 
 /**
  * BaseParser is an abstract class for parsing text and enforcing JSON schema on the parsed data.
@@ -113,21 +99,6 @@ declare abstract class BaseParserWithJson<S extends JSONSchema | undefined = und
     constructor(name: string, options: BaseParserOptionsWithSchema<S>);
 }
 
-interface OpenAiFunctionParserOptions<T extends BaseParser<any>> extends BaseParserOptions {
-    parser: T;
-}
-declare class OpenAiFunctionParser<T extends BaseParser<any>> extends BaseParser<ParserOutput<T> | {
-    name: any;
-    arguments: any;
-}> {
-    parser: T;
-    constructor(options: OpenAiFunctionParserOptions<T>);
-    parse(text: OutputResultContent[], _options?: Record<string, any>): ParserOutput<T> | {
-        name: string;
-        arguments: any;
-    };
-}
-
 interface StringParserOptions extends BaseParserOptions {
 }
 declare class StringParser extends BaseParser<string> {
@@ -330,6 +301,25 @@ declare function createParser<T extends Extract<CreateParserType, "json">, S ext
 declare function createParser<T extends CreateParserType, S extends JSONSchema | undefined = undefined>(type: T, options?: BaseParserOptionsWithSchema<S> | BaseParserOptions): JsonParser<S> | ListToJsonParser<S> | StringParser | NumberParser | BooleanParser | ListToArrayParser | ListToKeyValueParser | ReplaceStringTemplateParser | MarkdownCodeBlockParser | MarkdownCodeBlocksParser | StringExtractParser;
 declare function createCustomParser<O>(name: string, parserFn: (text: string, inputValues: ExecutorContext<any, any>) => O): CustomParser<ReturnType<typeof parserFn>>;
 
+interface LlmNativeFunctionParserOptions<T extends BaseParser<any>> extends BaseParserOptions {
+    parser: T;
+}
+declare class LlmNativeFunctionParser<T extends BaseParser<any>> extends BaseParser<ParserOutput<T> | {
+    name: any;
+    arguments: any;
+}> {
+    parser: T;
+    constructor(options: LlmNativeFunctionParserOptions<T>);
+    parse(text: OutputResultContent[], _options?: Record<string, any>): ParserOutput<T> | {
+        name: string;
+        arguments: any;
+    };
+}
+/**
+ * @deprecated Use `LlmExecutorWithFunctions` instead.
+ */
+declare const OpenAiFunctionParser: typeof LlmNativeFunctionParser;
+
 declare function replaceTemplateString(templateString?: string, substitutions?: Record<string, any>, configuration?: PromptTemplateOptions): string;
 
 declare function replaceTemplateStringAsync(templateString?: string, substitutions?: Record<string, any>, configuration?: PromptTemplateOptions): Promise<string>;
@@ -740,9 +730,14 @@ declare class LlmExecutor<Llm extends BaseLlm<any>, Prompt extends BasePrompt<Re
 /**
  * Core Executor With LLM
  */
-declare class LlmExecutorOpenAiFunctions<Llm extends BaseLlm, Prompt extends BasePrompt<Record<string, any>>, Parser extends BaseParser, State extends BaseState> extends LlmExecutor<Llm, Prompt, Parser, State> {
+declare class LlmExecutorWithFunctions<Llm extends BaseLlm, Prompt extends BasePrompt<Record<string, any>>, Parser extends BaseParser, State extends BaseState> extends LlmExecutor<Llm, Prompt, Parser, State> {
     constructor(llmConfiguration: ExecutorWithLlmOptions<Llm, Prompt, Parser, State>, options?: CoreExecutorExecuteOptions<LlmExecutorHooks>);
-    execute<T extends GenericFunctionCall>(_input: PromptInput<Prompt>, _options: OpenAiLlmExecutorOptions<T>): Promise<ParserOutput<Parser>>;
+    execute<T extends GenericFunctionCall>(_input: PromptInput<Prompt>, _options: LlmExecutorWithFunctionsOptions<T>): Promise<ParserOutput<Parser>>;
+}
+/**
+ * @deprecated Use `LlmExecutorWithFunctions` instead.
+ */
+declare class LlmExecutorOpenAiFunctions<Llm extends BaseLlm, Prompt extends BasePrompt<Record<string, any>>, Parser extends BaseParser, State extends BaseState> extends LlmExecutorWithFunctions<Llm, Prompt, Parser, State> {
 }
 
 /**
@@ -763,6 +758,7 @@ declare function createCoreExecutor<I extends PlainObject, O>(handler: (input: I
  * @returns  - A new LlmExecutor instance.
  */
 declare function createLlmExecutor<Llm extends BaseLlm<any>, Prompt extends BasePrompt<any>, Parser extends BaseParser, State extends BaseState>(llmConfiguration: ExecutorWithLlmOptions<Llm, Prompt, Parser, State>, options?: CoreExecutorExecuteOptions<LlmExecutorHooks>): LlmExecutor<Llm, Prompt, Parser, State>;
+declare function createLlmFunctionExecutor<Llm extends BaseLlm, Prompt extends BasePrompt<Record<string, any>>, Parser extends BaseParser, State extends BaseState>(llmConfiguration: ExecutorWithLlmOptions<Llm, Prompt, Parser, State>, options?: CoreExecutorExecuteOptions<LlmExecutorHooks>): LlmExecutorWithFunctions<Llm, Prompt, Parser, State>;
 
 declare const hookOnComplete = "onComplete";
 declare const hookOnError = "onError";
@@ -829,6 +825,20 @@ interface CallableExecutorCore {
     description: string;
     parameters?: Record<string, any>;
 }
+interface LlmExecutorExecuteOptions {
+    functions?: CallableExecutorCore[];
+    functionCall?: any;
+    jsonSchema?: Record<string, any>;
+}
+type GenericFunctionCall = "auto" | "none" | "any" | {
+    name: string;
+};
+interface LlmExecutorWithFunctionsOptions<T extends GenericFunctionCall = "auto"> extends LlmExecutorExecuteOptions {
+    functions?: CallableExecutorCore[];
+    functionCall?: T;
+    functionCallStrictInput?: boolean;
+    jsonSchema?: Record<string, any>;
+}
 
 type CreateParserType = "json" | "string" | "boolean" | "number" | "stringExtract" | "listToArray" | "listToJson" | "listToKeyValue" | "replaceStringTemplate" | "markdownCodeBlocks" | "markdownCodeBlock";
 interface BaseParserOptions {
@@ -1260,7 +1270,7 @@ declare const configs: {
 };
 
 declare function useLlm<T extends keyof typeof configs>(provider: T, options?: AllUseLlmOptions[T]["input"]): {
-    call: (messages: string | IChatMessages, options?: OpenAiLlmExecutorOptions) => Promise<{
+    call: (messages: string | IChatMessages, options?: LlmExecutorWithFunctionsOptions) => Promise<{
         getResultContent: (index?: number) => OutputResultContent[];
         getResultText: () => string;
         getResult: () => OutputResult;
@@ -1280,7 +1290,7 @@ declare function useLlm<T extends keyof typeof configs>(provider: T, options?: A
 };
 
 declare function createEmbedding<T extends EmbeddingProviderKey>(provider: T, options: AllEmbedding[T]["input"]): {
-    call: (messages: string | string[], options?: OpenAiLlmExecutorOptions) => Promise<{
+    call: (messages: string | string[], options?: LlmExecutorWithFunctionsOptions) => Promise<{
         getEmbedding: (index?: number) => number[];
         getResult: () => EmbeddingOutputResult;
     }>;
@@ -1298,4 +1308,4 @@ declare function createEmbedding<T extends EmbeddingProviderKey>(provider: T, op
     };
 };
 
-export { BaseExecutor, type BaseLlm, BaseParser, BasePrompt, BaseStateItem, ChatPrompt, CustomParser, DefaultState, DefaultStateItem, type EmbeddingProviderKey, type ExecutorContext, type IChatMessages, LlmExecutorOpenAiFunctions, type LlmProvider, type LlmProviderKey, type OpenAIModelName, OpenAiFunctionParser, TextPrompt, type UseLlmKey, createCallableExecutor, createChatPrompt, createCoreExecutor, createCustomParser, createDialogue, createEmbedding, createLlmExecutor, createParser, createPrompt, createState, createStateItem, defineSchema, registerHelpers, registerPartials, useExecutors, useLlm, index as utils };
+export { BaseExecutor, type BaseLlm, BaseParser, BasePrompt, BaseStateItem, ChatPrompt, CustomParser, DefaultState, DefaultStateItem, type EmbeddingProviderKey, type ExecutorContext, type IChatMessages, LlmExecutorOpenAiFunctions, LlmExecutorWithFunctions, LlmNativeFunctionParser, type LlmProvider, type LlmProviderKey, type OpenAIModelName, OpenAiFunctionParser, TextPrompt, type UseLlmKey, createCallableExecutor, createChatPrompt, createCoreExecutor, createCustomParser, createDialogue, createEmbedding, createLlmExecutor, createLlmFunctionExecutor, createParser, createPrompt, createState, createStateItem, defineSchema, registerHelpers, registerPartials, useExecutors, useLlm, index as utils };

package/dist/index.js

@@ -47,6 +47,8 @@ __export(index_exports, {
   DefaultState: () => DefaultState,
   DefaultStateItem: () => DefaultStateItem,
   LlmExecutorOpenAiFunctions: () => LlmExecutorOpenAiFunctions,
+  LlmExecutorWithFunctions: () => LlmExecutorWithFunctions,
+  LlmNativeFunctionParser: () => LlmNativeFunctionParser,
   OpenAiFunctionParser: () => OpenAiFunctionParser,
   TextPrompt: () => TextPrompt,
   createCallableExecutor: () => createCallableExecutor,
@@ -56,6 +58,7 @@ __export(index_exports, {
   createDialogue: () => createDialogue,
   createEmbedding: () => createEmbedding,
   createLlmExecutor: () => createLlmExecutor,
+  createLlmFunctionExecutor: () => createLlmFunctionExecutor,
   createParser: () => createParser,
   createPrompt: () => createPrompt,
   createState: () => createState,
@@ -390,6 +393,79 @@ var BaseParserWithJson = class extends BaseParser {
   }
 };
 
+// src/utils/modules/assert.ts
+function assert(condition, message) {
+  if (condition === void 0 || condition === null || condition === false) {
+    if (typeof message === "string") {
+      throw new Error(message);
+    } else if (message instanceof Error) {
+      throw message;
+    } else {
+      throw new Error(`Assertion error`);
+    }
+  }
+}
+
+// src/parser/parsers/StringParser.ts
+var StringParser = class extends BaseParser {
+  constructor(options) {
+    super("string", options);
+  }
+  parse(text, _options) {
+    assert(
+      typeof text === "string",
+      `Invalid input. Expected string. Received ${typeof text}.`
+    );
+    const parsed = text.toString();
+    return parsed;
+  }
+};
+
+// src/parser/parsers/BooleanParser.ts
+var BooleanParser = class extends BaseParser {
+  constructor(options) {
+    super("boolean", options);
+  }
+  parse(text) {
+    assert(
+      typeof text === "string",
+      `Invalid input. Expected string. Received ${typeof text}.`
+    );
+    const clean = text.toLowerCase().trim();
+    if (clean === "true") {
+      return true;
+    }
+    return false;
+  }
+};
+
+// src/utils/modules/isFinite.ts
+function isFinite(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+
+// src/utils/modules/toNumber.ts
+function toNumber(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string" && value.trim() !== "") {
+    return Number(value);
+  }
+  return NaN;
+}
+
+// src/parser/parsers/NumberParser.ts
+var NumberParser = class extends BaseParser {
+  constructor(options) {
+    super("number", options);
+  }
+  parse(text) {
+    const match = text.match(/\d/g);
+    return match && isFinite(toNumber(match[0])) ? toNumber(match[0]) : -1;
+  }
+};
+
 // src/utils/index.ts
 var utils_exports = {};
 __export(utils_exports, {
@@ -409,19 +485,6 @@ __export(utils_exports, {
   replaceTemplateStringAsync: () => replaceTemplateStringAsync
 });
 
-// src/utils/modules/assert.ts
-function assert(condition, message) {
-  if (condition === void 0 || condition === null || condition === false) {
-    if (typeof message === "string") {
-      throw new Error(message);
-    } else if (message instanceof Error) {
-      throw message;
-    } else {
-      throw new Error(`Assertion error`);
-    }
-  }
-}
-
 // src/utils/modules/defineSchema.ts
 var import_json_schema_to_ts = require("json-schema-to-ts");
 function defineSchema(obj) {
@@ -467,17 +530,6 @@ function importHelpers(_helpers) {
   return helpers;
 }
 
-// src/utils/modules/toNumber.ts
-function toNumber(value) {
-  if (typeof value === "number") {
-    return value;
-  }
-  if (typeof value === "string" && value.trim() !== "") {
-    return Number(value);
-  }
-  return NaN;
-}
-
 // src/utils/modules/get.ts
 function get(obj, path, defaultValue) {
   if (obj == null || path === "" || Array.isArray(path) && path.length === 0) {
@@ -1377,82 +1429,6 @@ function registerPartials(partials2) {
   hbsAsync.registerPartials(partials2);
 }
 
-// src/llm/output/_utils/getResultText.ts
-function getResultText(content) {
-  if (content.length === 1 && content.every((a) => a.type === "text")) {
-    return content[0]?.text || "";
-  }
-  return "";
-}
-
-// src/parser/parsers/OpenAiFunctionParser.ts
-var OpenAiFunctionParser = class extends BaseParser {
-  constructor(options) {
-    super("openAiFunction", options, "function_call");
-    __publicField(this, "parser");
-    this.parser = options.parser;
-  }
-  parse(text, _options) {
-    const functionUse = text?.find((a) => a.type === "function_use");
-    if (functionUse && "name" in functionUse && "input" in functionUse) {
-      return {
-        name: functionUse.name,
-        arguments: maybeParseJSON(functionUse.input)
-      };
-    }
-    return this.parser.parse(getResultText(text));
-  }
-};
-
-// src/parser/parsers/StringParser.ts
-var StringParser = class extends BaseParser {
-  constructor(options) {
-    super("string", options);
-  }
-  parse(text, _options) {
-    assert(
-      typeof text === "string",
-      `Invalid input. Expected string. Received ${typeof text}.`
-    );
-    const parsed = text.toString();
-    return parsed;
-  }
-};
-
-// src/parser/parsers/BooleanParser.ts
-var BooleanParser = class extends BaseParser {
-  constructor(options) {
-    super("boolean", options);
-  }
-  parse(text) {
-    assert(
-      typeof text === "string",
-      `Invalid input. Expected string. Received ${typeof text}.`
-    );
-    const clean = text.toLowerCase().trim();
-    if (clean === "true") {
-      return true;
-    }
-    return false;
-  }
-};
-
-// src/utils/modules/isFinite.ts
-function isFinite(value) {
-  return typeof value === "number" && Number.isFinite(value);
-}
-
-// src/parser/parsers/NumberParser.ts
-var NumberParser = class extends BaseParser {
-  constructor(options) {
-    super("number", options);
-  }
-  parse(text) {
-    const match = text.match(/\d/g);
-    return match && isFinite(toNumber(match[0])) ? toNumber(match[0]) : -1;
-  }
-};
-
 // src/parser/_utils.ts
 var import_jsonschema = require("jsonschema");
 function enforceParserSchema(schema, parsed) {
@@ -1745,6 +1721,34 @@ function createCustomParser(name, parserFn) {
   return new CustomParser(name, parserFn);
 }
 
+// src/llm/output/_utils/getResultText.ts
+function getResultText(content) {
+  if (content.length === 1 && content.every((a) => a.type === "text")) {
+    return content[0]?.text || "";
+  }
+  return "";
+}
+
+// src/parser/parsers/LlmNativeFunctionParser.ts
+var LlmNativeFunctionParser = class extends BaseParser {
+  constructor(options) {
+    super("openAiFunction", options, "function_call");
+    __publicField(this, "parser");
+    this.parser = options.parser;
+  }
+  parse(text, _options) {
+    const functionUse = text?.find((a) => a.type === "function_use");
+    if (functionUse && "name" in functionUse && "input" in functionUse) {
+      return {
+        name: functionUse.name,
+        arguments: maybeParseJSON(functionUse.input)
+      };
+    }
+    return this.parser.parse(getResultText(text));
+  }
+};
+var OpenAiFunctionParser = LlmNativeFunctionParser;
+
 // src/executor/llm.ts
 var LlmExecutor = class extends BaseExecutor {
   constructor(llmConfiguration, options) {
@@ -1820,20 +1824,12 @@ var LlmExecutor = class extends BaseExecutor {
   }
 };
 
-// src/executor/_functions.ts
-function createCoreExecutor(handler, options) {
-  return new CoreExecutor({ handler }, options);
-}
-function createLlmExecutor(llmConfiguration, options) {
-  return new LlmExecutor(llmConfiguration, options);
-}
-
 // src/executor/llm-openai-function.ts
-var LlmExecutorOpenAiFunctions = class extends LlmExecutor {
+var LlmExecutorWithFunctions = class extends LlmExecutor {
   constructor(llmConfiguration, options) {
     super(
       Object.assign({}, llmConfiguration, {
-        parser: new OpenAiFunctionParser({
+        parser: new LlmNativeFunctionParser({
           parser: llmConfiguration.parser || new StringParser()
         })
       }),
@@ -1844,6 +1840,22 @@ var LlmExecutorOpenAiFunctions = class extends LlmExecutor {
     return super.execute(_input, _options);
   }
 };
+var LlmExecutorOpenAiFunctions = class extends LlmExecutorWithFunctions {
+};
+
+// src/executor/_functions.ts
+function createCoreExecutor(handler, options) {
+  return new CoreExecutor({ handler }, options);
+}
+function createLlmExecutor(llmConfiguration, options) {
+  return new LlmExecutor(llmConfiguration, options);
+}
+function createLlmFunctionExecutor(llmConfiguration, options) {
+  return new LlmExecutorWithFunctions(
+    llmConfiguration,
+    options
+  );
+}
 
 // src/utils/modules/enforceResultAttributes.ts
 function enforceResultAttributes(input) {
@@ -3134,11 +3146,20 @@ async function parseHeaders(config, replacements, payload) {
 
 // src/llm/output/_utils/cleanJsonSchemaFor.ts
 var providerFieldExclusions = {
-  "openai.chat": ["default"]
+  "openai.chat": ["default"],
+  // fields to exclude for openai.chat
+  "anthropic.chat": []
   // fields to exclude for openai.chat
 };
 function cleanJsonSchemaFor(schema = {}, provider) {
   const clone = deepClone(schema);
+  if (Object.keys(clone).length === 0) {
+    return {
+      type: "object",
+      properties: {},
+      required: []
+    };
+  }
   const exclusions = providerFieldExclusions[provider] || [];
   function removeDisallowedFields(obj) {
     if (Array.isArray(obj)) {
@@ -3167,7 +3188,7 @@ async function useLlm_call(state, messages, _options) {
     })
   );
   if (_options && _options?.jsonSchema) {
-    if (state.provider === "openai.chat") {
+    if (state.provider.startsWith("openai")) {
       const curr = input["response_format"] || {};
       input["response_format"] = Object.assign(curr, {
         type: "json_schema",
@@ -3180,7 +3201,7 @@ async function useLlm_call(state, messages, _options) {
     }
   }
   if (_options && _options?.functionCall) {
-    if (state.provider === "anthropic.chat") {
+    if (state.provider.startsWith("anthropic")) {
       if (_options?.functionCall === "none") {
         _options.functions = [];
       } else if (_options?.functionCall === "auto" || _options?.functionCall === "any") {
@@ -3188,7 +3209,7 @@ async function useLlm_call(state, messages, _options) {
       } else {
         input["tool_choice"] = _options?.functionCall;
       }
-    } else if (state.provider === "openai.chat") {
+    } else if (state.provider.startsWith("openai")) {
       input["tool_choice"] = normalizeFunctionCall(
         _options?.functionCall,
         "openai"
@@ -3196,13 +3217,13 @@ async function useLlm_call(state, messages, _options) {
     }
   }
   if (_options && _options?.functions?.length) {
-    if (state.provider === "anthropic.chat") {
+    if (state.provider.startsWith("anthropic")) {
       input["tools"] = _options.functions.map((f) => ({
         name: f.name,
         description: f.description,
-        input_schema: f.parameters
+        input_schema: cleanJsonSchemaFor(f.parameters, "anthropic.chat")
       }));
-    } else if (state.provider === "openai.chat") {
+    } else if (state.provider.startsWith("openai")) {
       input["tools"] = _options.functions.map((f) => {
         const props = {
           name: f?.name,
@@ -4448,6 +4469,12 @@ var Dialogue = class extends BaseStateItem {
     return this;
   }
   setFunctionCallMessage(input) {
+    if (!input?.function_call) {
+      throw new LlmExeError(`Invalid arguments`, "state", {
+        error: `Invalid arguments: missing required function_call`,
+        module: "dialogue"
+      });
+    }
     this.value.push({
       role: "assistant",
       function_call: {
@@ -4607,6 +4634,8 @@ function createStateItem(name, defaultValue) {
   DefaultState,
   DefaultStateItem,
   LlmExecutorOpenAiFunctions,
+  LlmExecutorWithFunctions,
+  LlmNativeFunctionParser,
   OpenAiFunctionParser,
   TextPrompt,
   createCallableExecutor,
@@ -4616,6 +4645,7 @@ function createStateItem(name, defaultValue) {
   createDialogue,
   createEmbedding,
   createLlmExecutor,
+  createLlmFunctionExecutor,
   createParser,
   createPrompt,
   createState,

package/dist/index.mjs

@@ -333,6 +333,79 @@ var BaseParserWithJson = class extends BaseParser {
   }
 };
 
+// src/utils/modules/assert.ts
+function assert(condition, message) {
+  if (condition === void 0 || condition === null || condition === false) {
+    if (typeof message === "string") {
+      throw new Error(message);
+    } else if (message instanceof Error) {
+      throw message;
+    } else {
+      throw new Error(`Assertion error`);
+    }
+  }
+}
+
+// src/parser/parsers/StringParser.ts
+var StringParser = class extends BaseParser {
+  constructor(options) {
+    super("string", options);
+  }
+  parse(text, _options) {
+    assert(
+      typeof text === "string",
+      `Invalid input. Expected string. Received ${typeof text}.`
+    );
+    const parsed = text.toString();
+    return parsed;
+  }
+};
+
+// src/parser/parsers/BooleanParser.ts
+var BooleanParser = class extends BaseParser {
+  constructor(options) {
+    super("boolean", options);
+  }
+  parse(text) {
+    assert(
+      typeof text === "string",
+      `Invalid input. Expected string. Received ${typeof text}.`
+    );
+    const clean = text.toLowerCase().trim();
+    if (clean === "true") {
+      return true;
+    }
+    return false;
+  }
+};
+
+// src/utils/modules/isFinite.ts
+function isFinite(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+
+// src/utils/modules/toNumber.ts
+function toNumber(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string" && value.trim() !== "") {
+    return Number(value);
+  }
+  return NaN;
+}
+
+// src/parser/parsers/NumberParser.ts
+var NumberParser = class extends BaseParser {
+  constructor(options) {
+    super("number", options);
+  }
+  parse(text) {
+    const match = text.match(/\d/g);
+    return match && isFinite(toNumber(match[0])) ? toNumber(match[0]) : -1;
+  }
+};
+
 // src/utils/index.ts
 var utils_exports = {};
 __export(utils_exports, {
@@ -352,19 +425,6 @@ __export(utils_exports, {
   replaceTemplateStringAsync: () => replaceTemplateStringAsync
 });
 
-// src/utils/modules/assert.ts
-function assert(condition, message) {
-  if (condition === void 0 || condition === null || condition === false) {
-    if (typeof message === "string") {
-      throw new Error(message);
-    } else if (message instanceof Error) {
-      throw message;
-    } else {
-      throw new Error(`Assertion error`);
-    }
-  }
-}
-
 // src/utils/modules/defineSchema.ts
 import { asConst } from "json-schema-to-ts";
 function defineSchema(obj) {
@@ -410,17 +470,6 @@ function importHelpers(_helpers) {
   return helpers;
 }
 
-// src/utils/modules/toNumber.ts
-function toNumber(value) {
-  if (typeof value === "number") {
-    return value;
-  }
-  if (typeof value === "string" && value.trim() !== "") {
-    return Number(value);
-  }
-  return NaN;
-}
-
 // src/utils/modules/get.ts
 function get(obj, path, defaultValue) {
   if (obj == null || path === "" || Array.isArray(path) && path.length === 0) {
@@ -1320,82 +1369,6 @@ function registerPartials(partials2) {
   hbsAsync.registerPartials(partials2);
 }
 
-// src/llm/output/_utils/getResultText.ts
-function getResultText(content) {
-  if (content.length === 1 && content.every((a) => a.type === "text")) {
-    return content[0]?.text || "";
-  }
-  return "";
-}
-
-// src/parser/parsers/OpenAiFunctionParser.ts
-var OpenAiFunctionParser = class extends BaseParser {
-  constructor(options) {
-    super("openAiFunction", options, "function_call");
-    __publicField(this, "parser");
-    this.parser = options.parser;
-  }
-  parse(text, _options) {
-    const functionUse = text?.find((a) => a.type === "function_use");
-    if (functionUse && "name" in functionUse && "input" in functionUse) {
-      return {
-        name: functionUse.name,
-        arguments: maybeParseJSON(functionUse.input)
-      };
-    }
-    return this.parser.parse(getResultText(text));
-  }
-};
-
-// src/parser/parsers/StringParser.ts
-var StringParser = class extends BaseParser {
-  constructor(options) {
-    super("string", options);
-  }
-  parse(text, _options) {
-    assert(
-      typeof text === "string",
-      `Invalid input. Expected string. Received ${typeof text}.`
-    );
-    const parsed = text.toString();
-    return parsed;
-  }
-};
-
-// src/parser/parsers/BooleanParser.ts
-var BooleanParser = class extends BaseParser {
-  constructor(options) {
-    super("boolean", options);
-  }
-  parse(text) {
-    assert(
-      typeof text === "string",
-      `Invalid input. Expected string. Received ${typeof text}.`
-    );
-    const clean = text.toLowerCase().trim();
-    if (clean === "true") {
-      return true;
-    }
-    return false;
-  }
-};
-
-// src/utils/modules/isFinite.ts
-function isFinite(value) {
-  return typeof value === "number" && Number.isFinite(value);
-}
-
-// src/parser/parsers/NumberParser.ts
-var NumberParser = class extends BaseParser {
-  constructor(options) {
-    super("number", options);
-  }
-  parse(text) {
-    const match = text.match(/\d/g);
-    return match && isFinite(toNumber(match[0])) ? toNumber(match[0]) : -1;
-  }
-};
-
 // src/parser/_utils.ts
 import { validate as validateSchema } from "jsonschema";
 function enforceParserSchema(schema, parsed) {
@@ -1688,6 +1661,34 @@ function createCustomParser(name, parserFn) {
   return new CustomParser(name, parserFn);
 }
 
+// src/llm/output/_utils/getResultText.ts
+function getResultText(content) {
+  if (content.length === 1 && content.every((a) => a.type === "text")) {
+    return content[0]?.text || "";
+  }
+  return "";
+}
+
+// src/parser/parsers/LlmNativeFunctionParser.ts
+var LlmNativeFunctionParser = class extends BaseParser {
+  constructor(options) {
+    super("openAiFunction", options, "function_call");
+    __publicField(this, "parser");
+    this.parser = options.parser;
+  }
+  parse(text, _options) {
+    const functionUse = text?.find((a) => a.type === "function_use");
+    if (functionUse && "name" in functionUse && "input" in functionUse) {
+      return {
+        name: functionUse.name,
+        arguments: maybeParseJSON(functionUse.input)
+      };
+    }
+    return this.parser.parse(getResultText(text));
+  }
+};
+var OpenAiFunctionParser = LlmNativeFunctionParser;
+
 // src/executor/llm.ts
 var LlmExecutor = class extends BaseExecutor {
   constructor(llmConfiguration, options) {
@@ -1763,20 +1764,12 @@ var LlmExecutor = class extends BaseExecutor {
   }
 };
 
-// src/executor/_functions.ts
-function createCoreExecutor(handler, options) {
-  return new CoreExecutor({ handler }, options);
-}
-function createLlmExecutor(llmConfiguration, options) {
-  return new LlmExecutor(llmConfiguration, options);
-}
-
 // src/executor/llm-openai-function.ts
-var LlmExecutorOpenAiFunctions = class extends LlmExecutor {
+var LlmExecutorWithFunctions = class extends LlmExecutor {
   constructor(llmConfiguration, options) {
     super(
       Object.assign({}, llmConfiguration, {
-        parser: new OpenAiFunctionParser({
+        parser: new LlmNativeFunctionParser({
           parser: llmConfiguration.parser || new StringParser()
         })
       }),
@@ -1787,6 +1780,22 @@ var LlmExecutorOpenAiFunctions = class extends LlmExecutor {
     return super.execute(_input, _options);
   }
 };
+var LlmExecutorOpenAiFunctions = class extends LlmExecutorWithFunctions {
+};
+
+// src/executor/_functions.ts
+function createCoreExecutor(handler, options) {
+  return new CoreExecutor({ handler }, options);
+}
+function createLlmExecutor(llmConfiguration, options) {
+  return new LlmExecutor(llmConfiguration, options);
+}
+function createLlmFunctionExecutor(llmConfiguration, options) {
+  return new LlmExecutorWithFunctions(
+    llmConfiguration,
+    options
+  );
+}
 
 // src/utils/modules/enforceResultAttributes.ts
 function enforceResultAttributes(input) {
@@ -3077,11 +3086,20 @@ async function parseHeaders(config, replacements, payload) {
 
 // src/llm/output/_utils/cleanJsonSchemaFor.ts
 var providerFieldExclusions = {
-  "openai.chat": ["default"]
+  "openai.chat": ["default"],
+  // fields to exclude for openai.chat
+  "anthropic.chat": []
   // fields to exclude for openai.chat
 };
 function cleanJsonSchemaFor(schema = {}, provider) {
   const clone = deepClone(schema);
+  if (Object.keys(clone).length === 0) {
+    return {
+      type: "object",
+      properties: {},
+      required: []
+    };
+  }
   const exclusions = providerFieldExclusions[provider] || [];
   function removeDisallowedFields(obj) {
     if (Array.isArray(obj)) {
@@ -3110,7 +3128,7 @@ async function useLlm_call(state, messages, _options) {
     })
   );
   if (_options && _options?.jsonSchema) {
-    if (state.provider === "openai.chat") {
+    if (state.provider.startsWith("openai")) {
       const curr = input["response_format"] || {};
       input["response_format"] = Object.assign(curr, {
         type: "json_schema",
@@ -3123,7 +3141,7 @@ async function useLlm_call(state, messages, _options) {
     }
   }
   if (_options && _options?.functionCall) {
-    if (state.provider === "anthropic.chat") {
+    if (state.provider.startsWith("anthropic")) {
       if (_options?.functionCall === "none") {
         _options.functions = [];
       } else if (_options?.functionCall === "auto" || _options?.functionCall === "any") {
@@ -3131,7 +3149,7 @@ async function useLlm_call(state, messages, _options) {
       } else {
         input["tool_choice"] = _options?.functionCall;
       }
-    } else if (state.provider === "openai.chat") {
+    } else if (state.provider.startsWith("openai")) {
       input["tool_choice"] = normalizeFunctionCall(
         _options?.functionCall,
         "openai"
@@ -3139,13 +3157,13 @@ async function useLlm_call(state, messages, _options) {
     }
   }
   if (_options && _options?.functions?.length) {
-    if (state.provider === "anthropic.chat") {
+    if (state.provider.startsWith("anthropic")) {
       input["tools"] = _options.functions.map((f) => ({
         name: f.name,
         description: f.description,
-        input_schema: f.parameters
+        input_schema: cleanJsonSchemaFor(f.parameters, "anthropic.chat")
       }));
-    } else if (state.provider === "openai.chat") {
+    } else if (state.provider.startsWith("openai")) {
       input["tools"] = _options.functions.map((f) => {
         const props = {
           name: f?.name,
@@ -4391,6 +4409,12 @@ var Dialogue = class extends BaseStateItem {
     return this;
   }
   setFunctionCallMessage(input) {
+    if (!input?.function_call) {
+      throw new LlmExeError(`Invalid arguments`, "state", {
+        error: `Invalid arguments: missing required function_call`,
+        module: "dialogue"
+      });
+    }
     this.value.push({
       role: "assistant",
       function_call: {
@@ -4549,6 +4573,8 @@ export {
   DefaultState,
   DefaultStateItem,
   LlmExecutorOpenAiFunctions,
+  LlmExecutorWithFunctions,
+  LlmNativeFunctionParser,
   OpenAiFunctionParser,
   TextPrompt,
   createCallableExecutor,
@@ -4558,6 +4584,7 @@ export {
   createDialogue,
   createEmbedding,
   createLlmExecutor,
+  createLlmFunctionExecutor,
   createParser,
   createPrompt,
   createState,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-exe",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "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,8 @@
     "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/helloWorldReasoning.test.ts",
+    "test-one": "eval $(cat .env) NODE_OPTIONS=--experimental-vm-modules jest --detectOpenHandles --coverage --forceExit --config jest.config.examples.ts examples/intentBot.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",
     "build:browser": "tsup src/script.ts --format iife --platform browser --target es6 --sourcemap --clean --external '**'",
@@ -46,8 +47,8 @@
     "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",
-    "docs:dev": "(concurrently \"vitepress dev docs\" \"npm run build:watch:docs-examples\")",
-    "docs:build": "vitepress build docs",
+    "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",
     "lint": "eslint .",
     "format:check": "prettier --check \"src\"",
     "format:write": "prettier --write \"src\"",
@@ -88,7 +89,7 @@
     "tsconfig-paths": "4.2.0",
     "tsup": "^8.4.0",
     "typescript": "5.8.3",
-    "vitepress": "^1.3.2"
+    "vitepress": "^1.6.3"
   },
   "repository": {
     "type": "git",

package/readme.md

@@ -6,81 +6,151 @@ A package that provides simplified base components to make building and maintain
 
 - Write functions powered by LLM's with easy to use building blocks.
 - Pure Javascript and Typescript. Allows you to pass and infer types.
+- Supercharge your prompts by using handlebars within prompt template.
 - Support for text-based (llama-3) and chat-based prompts. (gpt-4o, claude-3.5, grok-3, Gemini, Bedrock, Ollama, etc)
 - Call LLM's from different providers without changing your code. (OpenAi/Anthropic/xAI/Google/AWS Bedrock/Ollama/Deepseek)
-- Supercharge your prompts by using handlebars within prompt template.
 - Allow LLM's to call functions (or call other LLM executors).
 - Not very opinionated. You have control on how you use it.
 
-![llm-exe](https://assets.llm-exe.com/llm-exe-featured.jpg)
-
+![llm-exe](https://assets.llm-exe.com/llm-exe-featured-2025.png)
 
 See full docs here: [https://llm-exe.com](https://llm-exe.com)
 
-
 ---
+
 # Install
 
 Install llm-exe using npm.
+
 ```
 npm i llm-exe
 ```
 
+ESM-first. CommonJS works too.
+
 ```typescript
+// ESM
 import * as llmExe from "llm-exe";
+// or specific modules
+import { useLlm, createChatPrompt, createParser } from "llm-exe";
+
+// CommonJS
+const llmExe = require("llm-exe");
+```
 
-// or 
+## Overview
 
-import { /* specific modules */ } from from "llm-exe"
+```ts
+// Prompt
+const prompt = createChatPrompt("You are a support agent. Help the user.");
+prompt.addUserMessage("I need help with my order.");
+
+// LLM
+const llm = useLlm("openai.gpt-4o");
+
+// Parser
+const parser = createParser("json", { schema: mySchema });
+
+// Executor
+const executor = createLlmExecutor({ llm, prompt, parser });
+await executor.execute({ input: "..." });
+```
+
+#### Prompt Helpers
+
+```ts
+const prompt = createChatPrompt(`
+{{#if user.isFirstTime}}
+Welcome!
+{{else}}
+Welcome back!
+{{/if}}
+`);
+```
+
+#### Built-In Parsers
+
+```ts
+createParser("stringExtract", { enum: ["yes", "no"] });
+createParser("listToJson");
+createParser("listToArray");
+createParser("markdownCodeBlock");
+// ...etc
+```
+
+#### Custom Parsers
+
+```ts
+const parser = createCustomParser("MyUppercaseParser", (output, input) => {
+  return output.toUpperCase();
+});
+```
+
+#### State
+
+```ts
+const dialogue = createDialogue("chat");
+dialogue.setUserMessage("Hi");
+dialogue.setAssistantMessage("Hello!");
+dialogue.getHistory(); // returns chat array
+```
+
+#### Hooks
+
+```ts
+executor.on("onSuccess", console.log);
+executor.on("onError", console.error);
 ```
 
 ## Basic Example
+
 Below is simple example:
+
 ```typescript
-import * as llmExe from "llm-exe";
+// 1. Use the model you want
+const llm = useLlm("openai.gpt-4o");
+
+// 2. Create a parameterized prompt
+const instruction = `
+You are a classifier. Given a user message, reply with the category it belongs to.
+Pick from only the following options:
+
+{{#each options}}- {{this}}
+{{/each}}
+
+Respond with only one of the options.`;
+
+const prompt = createChatPrompt<{ options: string[]; input: string }>(
+  instruction
+).addUserMessage("{{input}}"); // placeholder for message content
+
+// 3. Create a parser that ensures a clean match
+const parser = createParser("stringExtract", {
+  enum: ["billing", "support", "cancel", "unknown"],
+});
+
+// 4. Create the executor
+const classifyMessage = createLlmExecutor({
+  llm,
+  prompt,
+  parser,
+});
+
+// 5. Pass in options and a message — like a real function!
+// classifyMessage.execute is typed based on the prompt/parser!
+const result = await classifyMessage.execute({
+  input: "Hi, I'm moving and no longer need this service.",
+  options: ["billing", "support", "cancel", "unknown"],
+});
+
+console.log(result); // => "cancel"
+```
+
+### Further Reading
+
+[Find llm-exe on Medium](https://medium.com/llm-exe)
 
-/**
- * Define a yes/no llm-powered function
- */
-export async function YesOrNoBot<I extends string>(input: I) {
-  const llm = llmExe.useLlm("openai.gpt-4o-mini");
-
-  const instruction = `You are not an assistant, I need you to reply with only 
-  'yes' or 'no' as an answer to the question below. Do not explain yourself 
-  or ask questions. Answer with only yes or no.`;
-
-  const prompt = llmExe
-    .createChatPrompt(instruction)
-    .addUserMessage(input)
-    .addUserMessage(`yes or no:`);
-
-  const parser = llmExe.createParser("stringExtract", { enum: ["yes", "no"] });
-  return llmExe.createLlmExecutor({ llm, prompt, parser }).execute({ input });
-}
-
-const isTheSkyBlue = await YesOrNoBot(`Is AI cool?`)
-
-/**
- * 
- * The prompt sent to the LLM would be: 
- * (line breaks added for readability)
- * 
- * [{ 
- *   role: 'system', 
- *    content: 'You are not an assistant, I need you to reply with only 
-  'yes' or 'no' as an answer to the question asked by the user. Do not explain yourself 
-  or ask questions. Answer only with yes or no.' 
- * },
- * { 
- *   role: 'user',
- *   content: 'Is AI cool?'
- * }]
- * 
- */
-
-/**
- * 
- * console.log(isTheSkyBlue)
- * yes
- * /
-```
+- [Prompt: Create Typed, Modular Prompt Templates in TypeScript](https://medium.com/llm-exe/llm-exe-intro-prompt-3d9d40dc923d)
+- [LLM: Keep Your Code Clean While Switching Models](https://medium.com/llm-exe/llm-exe-intro-llm-2f5f35e60caf)
+- [Parser: Parse, Validate, and Structure AI Responses](https://medium.com/llm-exe/llm-exe-intro-parser-aed787f81082)
+- [Executor: Prompt, Parse, and Execute with Type Safety](https://medium.com/llm-exe/llm-exe-intro-llm-executor-52bb95c76c84)