illuma-agents 1.0.2

package/dist/cjs/utils/misc.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+function isPresent(value) {
+    return value != null && value !== '';
+}
+/**
+ * Unescapes a c-escaped string
+ * @param str The string to unescape
+ * @returns The unescaped string
+ */
+const unescapeString = (string) => string.replace(/\\(.)/g, (_, char) => {
+    switch (char) {
+        case 'n':
+            return '\n';
+        case 't':
+            return '\t';
+        case 'r':
+            return '\r';
+        case '"':
+            return '"';
+        case '\'':
+            return '\'';
+        case '\\':
+            return '\\';
+        default:
+            return char;
+    }
+});
+/**
+ * Recursively unescapes all string values in an object
+ * @param obj The object to unescape
+ * @returns The unescaped object
+ */
+function unescapeObject(obj, key) {
+    if (typeof obj === 'string') {
+        let unescaped = unescapeString(obj);
+        if (key === 'filePath' && unescaped.match(/^"(.+)"$/)) {
+            unescaped = unescaped.substring(1, unescaped.length - 1);
+        }
+        return unescaped;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((value) => unescapeObject(value, key === 'contextPaths' ? 'filePath' : ''));
+    }
+    if (typeof obj === 'object' && obj !== null) {
+        return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
+            key,
+            unescapeObject(value, key),
+        ]));
+    }
+    return obj;
+}
+
+exports.isPresent = isPresent;
+exports.unescapeObject = unescapeObject;
+//# sourceMappingURL=misc.cjs.map

package/dist/cjs/utils/misc.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.cjs","sources":["../../../src/utils/misc.ts"],"sourcesContent":["export function isPresent(value: string | null | undefined): value is string {\r\n  return value != null && value !== '';\r\n}\r\n\r\n/**\r\n * Unescapes a c-escaped string\r\n * @param str The string to unescape\r\n * @returns The unescaped string\r\n */\r\nconst unescapeString = (string: string): string =>\r\n  string.replace(/\\\\(.)/g, (_, char) => {\r\n    switch (char) {\r\n    case 'n':\r\n      return '\\n';\r\n    case 't':\r\n      return '\\t';\r\n    case 'r':\r\n      return '\\r';\r\n    case '\"':\r\n      return '\"';\r\n    case '\\'':\r\n      return '\\'';\r\n    case '\\\\':\r\n      return '\\\\';\r\n    default:\r\n      return char;\r\n    }\r\n  });\r\n\r\n/**\r\n * Recursively unescapes all string values in an object\r\n * @param obj The object to unescape\r\n * @returns The unescaped object\r\n */\r\nexport function unescapeObject(obj: unknown, key?: string): unknown {\r\n  if (typeof obj === 'string') {\r\n    let unescaped = unescapeString(obj);\r\n    if (key === 'filePath' && unescaped.match(/^\"(.+)\"$/)) {\r\n      unescaped = unescaped.substring(1, unescaped.length - 1);\r\n    }\r\n    return unescaped;\r\n  }\r\n  if (Array.isArray(obj)) {\r\n    return obj.map((value) =>\r\n      unescapeObject(value, key === 'contextPaths' ? 'filePath' : '')\r\n    );\r\n  }\r\n  if (typeof obj === 'object' && obj !== null) {\r\n    return Object.fromEntries(\r\n      Object.entries(obj).map(([key, value]) => [\r\n        key,\r\n        unescapeObject(value, key),\r\n      ])\r\n    );\r\n  }\r\n  return obj;\r\n}\r\n"],"names":[],"mappings":";;AAAM,SAAU,SAAS,CAAC,KAAgC,EAAA;AACxD,IAAA,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;AACtC;AAEA;;;;AAIG;AACH,MAAM,cAAc,GAAG,CAAC,MAAc,KACpC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,IAAI,KAAI;IACnC,QAAQ,IAAI;AACZ,QAAA,KAAK,GAAG;AACN,YAAA,OAAO,IAAI;AACb,QAAA,KAAK,GAAG;AACN,YAAA,OAAO,IAAI;AACb,QAAA,KAAK,GAAG;AACN,YAAA,OAAO,IAAI;AACb,QAAA,KAAK,GAAG;AACN,YAAA,OAAO,GAAG;AACZ,QAAA,KAAK,IAAI;AACP,YAAA,OAAO,IAAI;AACb,QAAA,KAAK,IAAI;AACP,YAAA,OAAO,IAAI;AACb,QAAA;AACE,YAAA,OAAO,IAAI;;AAEf,CAAC,CAAC;AAEJ;;;;AAIG;AACa,SAAA,cAAc,CAAC,GAAY,EAAE,GAAY,EAAA;AACvD,IAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AAC3B,QAAA,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC;QACnC,IAAI,GAAG,KAAK,UAAU,IAAI,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE;AACrD,YAAA,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;;AAE1D,QAAA,OAAO,SAAS;;AAElB,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACtB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,KACnB,cAAc,CAAC,KAAK,EAAE,GAAG,KAAK,cAAc,GAAG,UAAU,GAAG,EAAE,CAAC,CAChE;;IAEH,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE;QAC3C,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK;YACxC,GAAG;AACH,YAAA,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC;AAC3B,SAAA,CAAC,CACH;;AAEH,IAAA,OAAO,GAAG;AACZ;;;;;"}

package/dist/cjs/utils/run.cjs

@@ -0,0 +1,69 @@
+'use strict';
+
+var runnables = require('@langchain/core/runnables');
+var singletons = require('@langchain/core/singletons');
+
+/**
+ * Delays the execution for a specified number of milliseconds.
+ *
+ * @param {number} ms - The number of milliseconds to delay.
+ * @return {Promise<void>} A promise that resolves after the specified delay.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+class RunnableCallable extends runnables.Runnable {
+    lc_namespace = ['langgraph'];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    func;
+    tags;
+    config;
+    trace = true;
+    recurse = true;
+    constructor(fields) {
+        super();
+        this.name = fields.name ?? fields.func.name;
+        this.func = fields.func;
+        this.config = fields.tags ? { tags: fields.tags } : undefined;
+        this.trace = fields.trace ?? this.trace;
+        this.recurse = fields.recurse ?? this.recurse;
+    }
+    async _tracedInvoke(input, config, runManager) {
+        return new Promise((resolve, reject) => {
+            const childConfig = runnables.patchConfig(config, {
+                callbacks: runManager?.getChild(),
+            });
+            void singletons.AsyncLocalStorageProviderSingleton.runWithConfig(childConfig, async () => {
+                try {
+                    const output = await this.func(input, childConfig);
+                    resolve(output);
+                }
+                catch (e) {
+                    reject(e);
+                }
+            });
+        });
+    }
+    async invoke(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    input, options
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let returnValue;
+        if (this.trace) {
+            returnValue = await this._callWithConfig(this._tracedInvoke, input, runnables.mergeConfigs(this.config, options));
+        }
+        else {
+            returnValue = await this.func(input, runnables.mergeConfigs(this.config, options));
+        }
+        if (runnables.Runnable.isRunnable(returnValue) && this.recurse) {
+            return await returnValue.invoke(input, options);
+        }
+        return returnValue;
+    }
+}
+
+exports.RunnableCallable = RunnableCallable;
+exports.sleep = sleep;
+//# sourceMappingURL=run.cjs.map

package/dist/cjs/utils/run.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.cjs","sources":["../../../src/utils/run.ts"],"sourcesContent":["import { CallbackManagerForChainRun } from '@langchain/core/callbacks/manager';\r\nimport {\r\n  mergeConfigs,\r\n  patchConfig,\r\n  Runnable,\r\n  RunnableConfig,\r\n} from '@langchain/core/runnables';\r\nimport { AsyncLocalStorageProviderSingleton } from '@langchain/core/singletons';\r\n\r\n/**\r\n * Delays the execution for a specified number of milliseconds.\r\n *\r\n * @param {number} ms - The number of milliseconds to delay.\r\n * @return {Promise<void>} A promise that resolves after the specified delay.\r\n */\r\nexport function sleep(ms: number): Promise<void> {\r\n  return new Promise((resolve) => setTimeout(resolve, ms));\r\n}\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport interface RunnableCallableArgs extends Partial<any> {\r\n  name?: string;\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  func: (...args: any[]) => any;\r\n  tags?: string[];\r\n  trace?: boolean;\r\n  recurse?: boolean;\r\n}\r\n\r\nexport class RunnableCallable<I = unknown, O = unknown> extends Runnable<I, O> {\r\n  lc_namespace: string[] = ['langgraph'];\r\n\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  func: (...args: any[]) => any;\r\n\r\n  tags?: string[];\r\n\r\n  config?: RunnableConfig;\r\n\r\n  trace: boolean = true;\r\n\r\n  recurse: boolean = true;\r\n\r\n  constructor(fields: RunnableCallableArgs) {\r\n    super();\r\n    this.name = fields.name ?? fields.func.name;\r\n    this.func = fields.func;\r\n    this.config = fields.tags ? { tags: fields.tags } : undefined;\r\n    this.trace = fields.trace ?? this.trace;\r\n    this.recurse = fields.recurse ?? this.recurse;\r\n  }\r\n\r\n  protected async _tracedInvoke(\r\n    input: I,\r\n    config?: Partial<RunnableConfig>,\r\n    runManager?: CallbackManagerForChainRun\r\n  ): Promise<O> {\r\n    return new Promise<O>((resolve, reject) => {\r\n      const childConfig = patchConfig(config, {\r\n        callbacks: runManager?.getChild(),\r\n      });\r\n      void AsyncLocalStorageProviderSingleton.runWithConfig(\r\n        childConfig,\r\n        async () => {\r\n          try {\r\n            const output = await this.func(input, childConfig);\r\n            resolve(output);\r\n          } catch (e) {\r\n            reject(e);\r\n          }\r\n        }\r\n      );\r\n    });\r\n  }\r\n\r\n  async invoke(\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    input: any,\r\n    options?: Partial<RunnableConfig> | undefined\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  ): Promise<any> {\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    let returnValue: any;\r\n\r\n    if (this.trace) {\r\n      returnValue = await this._callWithConfig(\r\n        this._tracedInvoke,\r\n        input,\r\n        mergeConfigs(this.config, options)\r\n      );\r\n    } else {\r\n      returnValue = await this.func(input, mergeConfigs(this.config, options));\r\n    }\r\n\r\n    if (Runnable.isRunnable(returnValue) && this.recurse) {\r\n      return await returnValue.invoke(input, options);\r\n    }\r\n\r\n    return returnValue;\r\n  }\r\n}"],"names":["Runnable","patchConfig","AsyncLocalStorageProviderSingleton","mergeConfigs"],"mappings":";;;;;AASA;;;;;AAKG;AACG,SAAU,KAAK,CAAC,EAAU,EAAA;AAC9B,IAAA,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1D;AAYM,MAAO,gBAA2C,SAAQA,kBAAc,CAAA;AAC5E,IAAA,YAAY,GAAa,CAAC,WAAW,CAAC;;AAGtC,IAAA,IAAI;AAEJ,IAAA,IAAI;AAEJ,IAAA,MAAM;IAEN,KAAK,GAAY,IAAI;IAErB,OAAO,GAAY,IAAI;AAEvB,IAAA,WAAA,CAAY,MAA4B,EAAA;AACtC,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI;AAC3C,QAAA,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,SAAS;QAC7D,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK;QACvC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;;AAGrC,IAAA,MAAM,aAAa,CAC3B,KAAQ,EACR,MAAgC,EAChC,UAAuC,EAAA;QAEvC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,KAAI;AACxC,YAAA,MAAM,WAAW,GAAGC,qBAAW,CAAC,MAAM,EAAE;AACtC,gBAAA,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE;AAClC,aAAA,CAAC;YACF,KAAKC,6CAAkC,CAAC,aAAa,CACnD,WAAW,EACX,YAAW;AACT,gBAAA,IAAI;oBACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC;oBAClD,OAAO,CAAC,MAAM,CAAC;;gBACf,OAAO,CAAC,EAAE;oBACV,MAAM,CAAC,CAAC,CAAC;;AAEb,aAAC,CACF;AACH,SAAC,CAAC;;AAGJ,IAAA,MAAM,MAAM;;AAEV,IAAA,KAAU,EACV;;;;AAIA,QAAA,IAAI,WAAgB;AAEpB,QAAA,IAAI,IAAI,CAAC,KAAK,EAAE;YACd,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,CACtC,IAAI,CAAC,aAAa,EAClB,KAAK,EACLC,sBAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CACnC;;aACI;AACL,YAAA,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAEA,sBAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;;QAG1E,IAAIH,kBAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE;YACpD,OAAO,MAAM,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC;;AAGjD,QAAA,OAAO,WAAW;;AAErB;;;;;"}

package/dist/cjs/utils/title.cjs

@@ -0,0 +1,111 @@
+'use strict';
+
+var zod = require('zod');
+var prompts = require('@langchain/core/prompts');
+var runnables = require('@langchain/core/runnables');
+var _enum = require('../common/enum.cjs');
+
+const defaultTitlePrompt = `Analyze this conversation and provide:
+1. The detected language of the conversation
+2. A concise title in the detected language (5 words or less, no punctuation or quotation)
+
+{convo}`;
+const titleSchema = zod.z.object({
+    title: zod.z
+        .string()
+        .describe('A concise title for the conversation in 5 words or less, without punctuation or quotation'),
+});
+const combinedSchema = zod.z.object({
+    language: zod.z.string().describe('The detected language of the conversation'),
+    title: zod.z
+        .string()
+        .describe('A concise title for the conversation in 5 words or less, without punctuation or quotation'),
+});
+const createTitleRunnable = async (model, _titlePrompt) => {
+    // Disabled since this works fine
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    /* @ts-ignore */
+    const titleLLM = model.withStructuredOutput(titleSchema);
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    /* @ts-ignore */
+    const combinedLLM = model.withStructuredOutput(combinedSchema);
+    const titlePrompt = prompts.ChatPromptTemplate.fromTemplate(_titlePrompt ?? defaultTitlePrompt).withConfig({ runName: 'TitlePrompt' });
+    const titleOnlyInnerChain = runnables.RunnableSequence.from([titlePrompt, titleLLM]);
+    const combinedInnerChain = runnables.RunnableSequence.from([titlePrompt, combinedLLM]);
+    /** Wrap titleOnlyChain in RunnableLambda to create parent span */
+    const titleOnlyChain = new runnables.RunnableLambda({
+        func: async (input, config) => {
+            return await titleOnlyInnerChain.invoke(input, config);
+        },
+    }).withConfig({ runName: 'TitleOnlyChain' });
+    /** Wrap combinedChain in RunnableLambda to create parent span */
+    const combinedChain = new runnables.RunnableLambda({
+        func: async (input, config) => {
+            return await combinedInnerChain.invoke(input, config);
+        },
+    }).withConfig({ runName: 'TitleLanguageChain' });
+    /** Runnable to add default values if needed */
+    const addDefaults = new runnables.RunnableLambda({
+        func: (result) => ({
+            language: result?.language ?? 'English',
+            title: result?.title ?? '',
+        }),
+    }).withConfig({ runName: 'AddDefaults' });
+    const combinedChainInner = runnables.RunnableSequence.from([
+        combinedChain,
+        addDefaults,
+    ]);
+    /** Wrap combinedChainWithDefaults in RunnableLambda to create parent span */
+    const combinedChainWithDefaults = new runnables.RunnableLambda({
+        func: async (input, config) => {
+            return await combinedChainInner.invoke(input, config);
+        },
+    }).withConfig({ runName: 'CombinedChainWithDefaults' });
+    return new runnables.RunnableLambda({
+        func: async (input, config) => {
+            const invokeInput = { convo: input.convo };
+            if (input.skipLanguage) {
+                return (await titleOnlyChain.invoke(invokeInput, config));
+            }
+            return await combinedChainWithDefaults.invoke(invokeInput, config);
+        },
+    }).withConfig({ runName: 'TitleGenerator' });
+};
+const defaultCompletionPrompt = `Provide a concise, 5-word-or-less title for the conversation, using title case conventions. Only return the title itself.
+
+Conversation:
+{convo}`;
+const createCompletionTitleRunnable = async (model, titlePrompt) => {
+    const completionPrompt = prompts.ChatPromptTemplate.fromTemplate(titlePrompt ?? defaultCompletionPrompt).withConfig({ runName: 'CompletionTitlePrompt' });
+    /** Runnable to extract content from model response */
+    const extractContent = new runnables.RunnableLambda({
+        func: (response) => {
+            let content = '';
+            if (typeof response.content === 'string') {
+                content = response.content;
+            }
+            else if (Array.isArray(response.content)) {
+                content = response.content
+                    .filter((part) => part.type === _enum.ContentTypes.TEXT)
+                    .map((part) => part.text)
+                    .join('');
+            }
+            return { title: content.trim() };
+        },
+    }).withConfig({ runName: 'ExtractTitle' });
+    const innerChain = runnables.RunnableSequence.from([
+        completionPrompt,
+        model,
+        extractContent,
+    ]);
+    /** Wrap in RunnableLambda to create a parent span for LangFuse */
+    return new runnables.RunnableLambda({
+        func: async (input, config) => {
+            return await innerChain.invoke(input, config);
+        },
+    }).withConfig({ runName: 'CompletionTitleChain' });
+};
+
+exports.createCompletionTitleRunnable = createCompletionTitleRunnable;
+exports.createTitleRunnable = createTitleRunnable;
+//# sourceMappingURL=title.cjs.map

package/dist/cjs/utils/title.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.cjs","sources":["../../../src/utils/title.ts"],"sourcesContent":["import { z } from 'zod';\r\nimport { ChatPromptTemplate } from '@langchain/core/prompts';\r\nimport { RunnableLambda, RunnableSequence } from '@langchain/core/runnables';\r\nimport type { Runnable, RunnableConfig } from '@langchain/core/runnables';\r\nimport type { AIMessage } from '@langchain/core/messages';\r\nimport type * as t from '@/types';\r\nimport { ContentTypes } from '@/common';\r\n\r\nconst defaultTitlePrompt = `Analyze this conversation and provide:\r\n1. The detected language of the conversation\r\n2. A concise title in the detected language (5 words or less, no punctuation or quotation)\r\n\r\n{convo}`;\r\n\r\nconst titleSchema = z.object({\r\n  title: z\r\n    .string()\r\n    .describe(\r\n      'A concise title for the conversation in 5 words or less, without punctuation or quotation'\r\n    ),\r\n});\r\n\r\nconst combinedSchema = z.object({\r\n  language: z.string().describe('The detected language of the conversation'),\r\n  title: z\r\n    .string()\r\n    .describe(\r\n      'A concise title for the conversation in 5 words or less, without punctuation or quotation'\r\n    ),\r\n});\r\n\r\nexport const createTitleRunnable = async (\r\n  model: t.ChatModelInstance,\r\n  _titlePrompt?: string\r\n): Promise<Runnable> => {\r\n  // Disabled since this works fine\r\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\r\n  /* @ts-ignore */\r\n  const titleLLM = model.withStructuredOutput(titleSchema);\r\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\r\n  /* @ts-ignore */\r\n  const combinedLLM = model.withStructuredOutput(combinedSchema);\r\n\r\n  const titlePrompt = ChatPromptTemplate.fromTemplate(\r\n    _titlePrompt ?? defaultTitlePrompt\r\n  ).withConfig({ runName: 'TitlePrompt' });\r\n\r\n  const titleOnlyInnerChain = RunnableSequence.from([titlePrompt, titleLLM]);\r\n  const combinedInnerChain = RunnableSequence.from([titlePrompt, combinedLLM]);\r\n\r\n  /** Wrap titleOnlyChain in RunnableLambda to create parent span */\r\n  const titleOnlyChain = new RunnableLambda({\r\n    func: async (\r\n      input: { convo: string },\r\n      config?: Partial<RunnableConfig>\r\n    ): Promise<{ title: string }> => {\r\n      return await titleOnlyInnerChain.invoke(input, config);\r\n    },\r\n  }).withConfig({ runName: 'TitleOnlyChain' });\r\n\r\n  /** Wrap combinedChain in RunnableLambda to create parent span */\r\n  const combinedChain = new RunnableLambda({\r\n    func: async (\r\n      input: { convo: string },\r\n      config?: Partial<RunnableConfig>\r\n    ): Promise<{ language: string; title: string }> => {\r\n      return await combinedInnerChain.invoke(input, config);\r\n    },\r\n  }).withConfig({ runName: 'TitleLanguageChain' });\r\n\r\n  /** Runnable to add default values if needed */\r\n  const addDefaults = new RunnableLambda({\r\n    func: (\r\n      result: { language: string; title: string } | undefined\r\n    ): { language: string; title: string } => ({\r\n      language: result?.language ?? 'English',\r\n      title: result?.title ?? '',\r\n    }),\r\n  }).withConfig({ runName: 'AddDefaults' });\r\n\r\n  const combinedChainInner = RunnableSequence.from([\r\n    combinedChain,\r\n    addDefaults,\r\n  ]);\r\n\r\n  /** Wrap combinedChainWithDefaults in RunnableLambda to create parent span */\r\n  const combinedChainWithDefaults = new RunnableLambda({\r\n    func: async (\r\n      input: { convo: string },\r\n      config?: Partial<RunnableConfig>\r\n    ): Promise<{ language: string; title: string }> => {\r\n      return await combinedChainInner.invoke(input, config);\r\n    },\r\n  }).withConfig({ runName: 'CombinedChainWithDefaults' });\r\n\r\n  return new RunnableLambda({\r\n    func: async (\r\n      input: {\r\n        convo: string;\r\n        inputText: string;\r\n        skipLanguage: boolean;\r\n      },\r\n      config?: Partial<RunnableConfig>\r\n    ): Promise<{ language: string; title: string } | { title: string }> => {\r\n      const invokeInput = { convo: input.convo };\r\n\r\n      if (input.skipLanguage) {\r\n        return (await titleOnlyChain.invoke(invokeInput, config)) as {\r\n          title: string;\r\n        };\r\n      }\r\n\r\n      return await combinedChainWithDefaults.invoke(invokeInput, config);\r\n    },\r\n  }).withConfig({ runName: 'TitleGenerator' });\r\n};\r\n\r\nconst defaultCompletionPrompt = `Provide a concise, 5-word-or-less title for the conversation, using title case conventions. Only return the title itself.\r\n\r\nConversation:\r\n{convo}`;\r\n\r\nexport const createCompletionTitleRunnable = async (\r\n  model: t.ChatModelInstance,\r\n  titlePrompt?: string\r\n): Promise<Runnable> => {\r\n  const completionPrompt = ChatPromptTemplate.fromTemplate(\r\n    titlePrompt ?? defaultCompletionPrompt\r\n  ).withConfig({ runName: 'CompletionTitlePrompt' });\r\n\r\n  /** Runnable to extract content from model response */\r\n  const extractContent = new RunnableLambda({\r\n    func: (response: AIMessage): { title: string } => {\r\n      let content = '';\r\n      if (typeof response.content === 'string') {\r\n        content = response.content;\r\n      } else if (Array.isArray(response.content)) {\r\n        content = response.content\r\n          .filter(\r\n            (part): part is { type: ContentTypes.TEXT; text: string } =>\r\n              part.type === ContentTypes.TEXT\r\n          )\r\n          .map((part) => part.text)\r\n          .join('');\r\n      }\r\n      return { title: content.trim() };\r\n    },\r\n  }).withConfig({ runName: 'ExtractTitle' });\r\n\r\n  const innerChain = RunnableSequence.from([\r\n    completionPrompt,\r\n    model,\r\n    extractContent,\r\n  ]);\r\n\r\n  /** Wrap in RunnableLambda to create a parent span for LangFuse */\r\n  return new RunnableLambda({\r\n    func: async (\r\n      input: { convo: string },\r\n      config?: Partial<RunnableConfig>\r\n    ): Promise<{ title: string }> => {\r\n      return await innerChain.invoke(input, config);\r\n    },\r\n  }).withConfig({ runName: 'CompletionTitleChain' });\r\n};\r\n"],"names":["z","ChatPromptTemplate","RunnableSequence","RunnableLambda","ContentTypes"],"mappings":"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"}

package/dist/cjs/utils/tokens.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+var lite = require('js-tiktoken/lite');
+var _enum = require('../common/enum.cjs');
+
+function getTokenCountForMessage(message, getTokenCount) {
+    const tokensPerMessage = 3;
+    const processValue = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (!item ||
+                    !item.type ||
+                    item.type === _enum.ContentTypes.ERROR ||
+                    item.type === _enum.ContentTypes.IMAGE_URL) {
+                    continue;
+                }
+                if (item.type === _enum.ContentTypes.TOOL_CALL && item.tool_call != null) {
+                    const toolName = item.tool_call?.name || '';
+                    if (toolName != null && toolName && typeof toolName === 'string') {
+                        numTokens += getTokenCount(toolName);
+                    }
+                    const args = item.tool_call?.args || '';
+                    if (args != null && args && typeof args === 'string') {
+                        numTokens += getTokenCount(args);
+                    }
+                    const output = item.tool_call?.output || '';
+                    if (output != null && output && typeof output === 'string') {
+                        numTokens += getTokenCount(output);
+                    }
+                    continue;
+                }
+                const nestedValue = item[item.type];
+                if (!nestedValue) {
+                    continue;
+                }
+                processValue(nestedValue);
+            }
+        }
+        else if (typeof value === 'string') {
+            numTokens += getTokenCount(value);
+        }
+        else if (typeof value === 'number') {
+            numTokens += getTokenCount(value.toString());
+        }
+        else if (typeof value === 'boolean') {
+            numTokens += getTokenCount(value.toString());
+        }
+    };
+    let numTokens = tokensPerMessage;
+    processValue(message.content);
+    return numTokens;
+}
+const createTokenCounter = async () => {
+    const res = await fetch('https://tiktoken.pages.dev/js/o200k_base.json');
+    const o200k_base = await res.json();
+    const countTokens = (text) => {
+        const enc = new lite.Tiktoken(o200k_base);
+        return enc.encode(text).length;
+    };
+    return (message) => getTokenCountForMessage(message, countTokens);
+};
+
+exports.createTokenCounter = createTokenCounter;
+exports.getTokenCountForMessage = getTokenCountForMessage;
+//# sourceMappingURL=tokens.cjs.map

package/dist/cjs/utils/tokens.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.cjs","sources":["../../../src/utils/tokens.ts"],"sourcesContent":["import { Tiktoken } from 'js-tiktoken/lite';\r\nimport type { BaseMessage } from '@langchain/core/messages';\r\nimport { ContentTypes } from '@/common/enum';\r\n\r\nexport function getTokenCountForMessage(message: BaseMessage, getTokenCount: (text: string) => number): number {\r\n  const tokensPerMessage = 3;\r\n\r\n  const processValue = (value: unknown): void => {\r\n    if (Array.isArray(value)) {\r\n      for (const item of value) {\r\n        if (\r\n          !item ||\r\n          !item.type ||\r\n          item.type === ContentTypes.ERROR ||\r\n          item.type === ContentTypes.IMAGE_URL\r\n        ) {\r\n          continue;\r\n        }\r\n\r\n        if (item.type === ContentTypes.TOOL_CALL && item.tool_call != null) {\r\n          const toolName = item.tool_call?.name || '';\r\n          if (toolName != null && toolName && typeof toolName === 'string') {\r\n            numTokens += getTokenCount(toolName);\r\n          }\r\n\r\n          const args = item.tool_call?.args || '';\r\n          if (args != null && args && typeof args === 'string') {\r\n            numTokens += getTokenCount(args);\r\n          }\r\n\r\n          const output = item.tool_call?.output || '';\r\n          if (output != null && output && typeof output === 'string') {\r\n            numTokens += getTokenCount(output);\r\n          }\r\n          continue;\r\n        }\r\n\r\n        const nestedValue = item[item.type];\r\n\r\n        if (!nestedValue) {\r\n          continue;\r\n        }\r\n\r\n        processValue(nestedValue);\r\n      }\r\n    } else if (typeof value === 'string') {\r\n      numTokens += getTokenCount(value);\r\n    } else if (typeof value === 'number') {\r\n      numTokens += getTokenCount(value.toString());\r\n    } else if (typeof value === 'boolean') {\r\n      numTokens += getTokenCount(value.toString());\r\n    }\r\n  };\r\n\r\n  let numTokens = tokensPerMessage;\r\n  processValue(message.content);\r\n  return numTokens;\r\n}\r\n\r\nexport const createTokenCounter = async () => {\r\n  const res = await fetch('https://tiktoken.pages.dev/js/o200k_base.json');\r\n  const o200k_base = await res.json();\r\n\r\n  const countTokens = (text: string): number => {\r\n    const enc = new Tiktoken(o200k_base);\r\n    return enc.encode(text).length;\r\n  };\r\n\r\n  return (message: BaseMessage): number => getTokenCountForMessage(message, countTokens);\r\n};"],"names":["ContentTypes","Tiktoken"],"mappings":";;;;;AAIgB,SAAA,uBAAuB,CAAC,OAAoB,EAAE,aAAuC,EAAA;IACnG,MAAM,gBAAgB,GAAG,CAAC;AAE1B,IAAA,MAAM,YAAY,GAAG,CAAC,KAAc,KAAU;AAC5C,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACxB,YAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;AACxB,gBAAA,IACE,CAAC,IAAI;oBACL,CAAC,IAAI,CAAC,IAAI;AACV,oBAAA,IAAI,CAAC,IAAI,KAAKA,kBAAY,CAAC,KAAK;AAChC,oBAAA,IAAI,CAAC,IAAI,KAAKA,kBAAY,CAAC,SAAS,EACpC;oBACA;;AAGF,gBAAA,IAAI,IAAI,CAAC,IAAI,KAAKA,kBAAY,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE;oBAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE;oBAC3C,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;AAChE,wBAAA,SAAS,IAAI,aAAa,CAAC,QAAQ,CAAC;;oBAGtC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE;oBACvC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACpD,wBAAA,SAAS,IAAI,aAAa,CAAC,IAAI,CAAC;;oBAGlC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,EAAE;oBAC3C,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC1D,wBAAA,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC;;oBAEpC;;gBAGF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAEnC,IAAI,CAAC,WAAW,EAAE;oBAChB;;gBAGF,YAAY,CAAC,WAAW,CAAC;;;AAEtB,aAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AACpC,YAAA,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC;;AAC5B,aAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YACpC,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;;AACvC,aAAA,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE;YACrC,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;;AAEhD,KAAC;IAED,IAAI,SAAS,GAAG,gBAAgB;AAChC,IAAA,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;AAC7B,IAAA,OAAO,SAAS;AAClB;AAEa,MAAA,kBAAkB,GAAG,YAAW;AAC3C,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+CAA+C,CAAC;AACxE,IAAA,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE;AAEnC,IAAA,MAAM,WAAW,GAAG,CAAC,IAAY,KAAY;AAC3C,QAAA,MAAM,GAAG,GAAG,IAAIC,aAAQ,CAAC,UAAU,CAAC;QACpC,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM;AAChC,KAAC;IAED,OAAO,CAAC,OAAoB,KAAa,uBAAuB,CAAC,OAAO,EAAE,WAAW,CAAC;AACxF;;;;;"}

package/dist/esm/common/enum.mjs

@@ -0,0 +1,163 @@
+/**
+ * Enum representing the various event types emitted during the execution of runnables.
+ * These events provide real-time information about the progress and state of different components.
+ *
+ * @enum {string}
+ */
+var GraphEvents;
+(function (GraphEvents) {
+    /* Custom Events */
+    /** [Custom] Agent update event in multi-agent graph/workflow */
+    GraphEvents["ON_AGENT_UPDATE"] = "on_agent_update";
+    /** [Custom] Delta event for run steps (message creation and tool calls) */
+    GraphEvents["ON_RUN_STEP"] = "on_run_step";
+    /** [Custom] Delta event for run steps (tool calls) */
+    GraphEvents["ON_RUN_STEP_DELTA"] = "on_run_step_delta";
+    /** [Custom] Completed event for run steps (tool calls) */
+    GraphEvents["ON_RUN_STEP_COMPLETED"] = "on_run_step_completed";
+    /** [Custom] Delta events for messages */
+    GraphEvents["ON_MESSAGE_DELTA"] = "on_message_delta";
+    /** [Custom] Reasoning Delta events for messages */
+    GraphEvents["ON_REASONING_DELTA"] = "on_reasoning_delta";
+    /* Official Events */
+    /** Custom event, emitted by system */
+    GraphEvents["ON_CUSTOM_EVENT"] = "on_custom_event";
+    /** Emitted when a chat model starts processing. */
+    GraphEvents["CHAT_MODEL_START"] = "on_chat_model_start";
+    /** Emitted when a chat model streams a chunk of its response. */
+    GraphEvents["CHAT_MODEL_STREAM"] = "on_chat_model_stream";
+    /** Emitted when a chat model completes its processing. */
+    GraphEvents["CHAT_MODEL_END"] = "on_chat_model_end";
+    /** Emitted when a language model starts processing. */
+    GraphEvents["LLM_START"] = "on_llm_start";
+    /** Emitted when a language model streams a chunk of its response. */
+    GraphEvents["LLM_STREAM"] = "on_llm_stream";
+    /** Emitted when a language model completes its processing. */
+    GraphEvents["LLM_END"] = "on_llm_end";
+    /** Emitted when a chain starts processing. */
+    GraphEvents["CHAIN_START"] = "on_chain_start";
+    /** Emitted when a chain streams a chunk of its output. */
+    GraphEvents["CHAIN_STREAM"] = "on_chain_stream";
+    /** Emitted when a chain completes its processing. */
+    GraphEvents["CHAIN_END"] = "on_chain_end";
+    /** Emitted when a tool starts its operation. */
+    GraphEvents["TOOL_START"] = "on_tool_start";
+    /** Emitted when a tool completes its operation. */
+    GraphEvents["TOOL_END"] = "on_tool_end";
+    /** Emitted when a retriever starts its operation. */
+    GraphEvents["RETRIEVER_START"] = "on_retriever_start";
+    /** Emitted when a retriever completes its operation. */
+    GraphEvents["RETRIEVER_END"] = "on_retriever_end";
+    /** Emitted when a prompt starts processing. */
+    GraphEvents["PROMPT_START"] = "on_prompt_start";
+    /** Emitted when a prompt completes its processing. */
+    GraphEvents["PROMPT_END"] = "on_prompt_end";
+})(GraphEvents || (GraphEvents = {}));
+var Providers;
+(function (Providers) {
+    Providers["OPENAI"] = "openAI";
+    Providers["BEDROCK_LEGACY"] = "bedrock_legacy";
+    Providers["VERTEXAI"] = "vertexai";
+    Providers["BEDROCK"] = "bedrock";
+    Providers["ANTHROPIC"] = "anthropic";
+    Providers["MISTRALAI"] = "mistralai";
+    Providers["MISTRAL"] = "mistral";
+    Providers["OLLAMA"] = "ollama";
+    Providers["GOOGLE"] = "google";
+    Providers["AZURE"] = "azureOpenAI";
+    Providers["DEEPSEEK"] = "deepseek";
+    Providers["OPENROUTER"] = "openrouter";
+    Providers["XAI"] = "xai";
+})(Providers || (Providers = {}));
+var GraphNodeKeys;
+(function (GraphNodeKeys) {
+    GraphNodeKeys["TOOLS"] = "tools";
+    GraphNodeKeys["AGENT"] = "agent";
+    GraphNodeKeys["PRE_TOOLS"] = "pre_tools";
+    GraphNodeKeys["POST_TOOLS"] = "post_tools";
+})(GraphNodeKeys || (GraphNodeKeys = {}));
+var GraphNodeActions;
+(function (GraphNodeActions) {
+    GraphNodeActions["TOOL_NODE"] = "tool_node";
+    GraphNodeActions["CALL_MODEL"] = "call_model";
+    GraphNodeActions["ROUTE_MESSAGE"] = "route_message";
+})(GraphNodeActions || (GraphNodeActions = {}));
+var CommonEvents;
+(function (CommonEvents) {
+    CommonEvents["LANGGRAPH"] = "LangGraph";
+})(CommonEvents || (CommonEvents = {}));
+var StepTypes;
+(function (StepTypes) {
+    StepTypes["TOOL_CALLS"] = "tool_calls";
+    StepTypes["MESSAGE_CREATION"] = "message_creation";
+})(StepTypes || (StepTypes = {}));
+var ContentTypes;
+(function (ContentTypes) {
+    ContentTypes["TEXT"] = "text";
+    ContentTypes["ERROR"] = "error";
+    ContentTypes["THINK"] = "think";
+    ContentTypes["TOOL_CALL"] = "tool_call";
+    ContentTypes["IMAGE_URL"] = "image_url";
+    ContentTypes["IMAGE_FILE"] = "image_file";
+    /** Anthropic */
+    ContentTypes["THINKING"] = "thinking";
+    /** Vertex AI / Google Common */
+    ContentTypes["REASONING"] = "reasoning";
+    /** Multi-Agent Switch */
+    ContentTypes["AGENT_UPDATE"] = "agent_update";
+    /** Bedrock */
+    ContentTypes["REASONING_CONTENT"] = "reasoning_content";
+})(ContentTypes || (ContentTypes = {}));
+var ToolCallTypes;
+(function (ToolCallTypes) {
+    ToolCallTypes["FUNCTION"] = "function";
+    ToolCallTypes["RETRIEVAL"] = "retrieval";
+    ToolCallTypes["FILE_SEARCH"] = "file_search";
+    ToolCallTypes["CODE_INTERPRETER"] = "code_interpreter";
+    /* Agents Tool Call */
+    ToolCallTypes["TOOL_CALL"] = "tool_call";
+})(ToolCallTypes || (ToolCallTypes = {}));
+var Callback;
+(function (Callback) {
+    Callback["TOOL_ERROR"] = "handleToolError";
+    Callback["TOOL_START"] = "handleToolStart";
+    Callback["TOOL_END"] = "handleToolEnd";
+    /*
+    LLM_START = 'handleLLMStart',
+    LLM_NEW_TOKEN = 'handleLLMNewToken',
+    LLM_ERROR = 'handleLLMError',
+    LLM_END = 'handleLLMEnd',
+    CHAT_MODEL_START = 'handleChatModelStart',
+    CHAIN_START = 'handleChainStart',
+    CHAIN_ERROR = 'handleChainError',
+    CHAIN_END = 'handleChainEnd',
+    TEXT = 'handleText',
+    AGENT_ACTION = 'handleAgentAction',
+    AGENT_END = 'handleAgentEnd',
+    RETRIEVER_START = 'handleRetrieverStart',
+    RETRIEVER_END = 'handleRetrieverEnd',
+    RETRIEVER_ERROR = 'handleRetrieverError',
+    CUSTOM_EVENT = 'handleCustomEvent'
+    */
+})(Callback || (Callback = {}));
+var Constants;
+(function (Constants) {
+    Constants["OFFICIAL_CODE_BASEURL"] = "https://api.illuma.ai/v1";
+    Constants["EXECUTE_CODE"] = "execute_code";
+    Constants["WEB_SEARCH"] = "web_search";
+    Constants["CONTENT_AND_ARTIFACT"] = "content_and_artifact";
+})(Constants || (Constants = {}));
+var TitleMethod;
+(function (TitleMethod) {
+    TitleMethod["STRUCTURED"] = "structured";
+    TitleMethod["FUNCTIONS"] = "functions";
+    TitleMethod["COMPLETION"] = "completion";
+})(TitleMethod || (TitleMethod = {}));
+var EnvVar;
+(function (EnvVar) {
+    EnvVar["CODE_API_KEY"] = "CODE_EXECUTOR_API_KEY";
+    EnvVar["CODE_BASEURL"] = "CODE_EXECUTOR_API_BASEURL";
+})(EnvVar || (EnvVar = {}));
+
+export { Callback, CommonEvents, Constants, ContentTypes, EnvVar, GraphEvents, GraphNodeActions, GraphNodeKeys, Providers, StepTypes, TitleMethod, ToolCallTypes };
+//# sourceMappingURL=enum.mjs.map

package/dist/esm/common/enum.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.mjs","sources":["../../../src/common/enum.ts"],"sourcesContent":["/**\r\n * Enum representing the various event types emitted during the execution of runnables.\r\n * These events provide real-time information about the progress and state of different components.\r\n *\r\n * @enum {string}\r\n */\r\nexport enum GraphEvents {\r\n  /* Custom Events */\r\n\r\n  /** [Custom] Agent update event in multi-agent graph/workflow */\r\n  ON_AGENT_UPDATE = 'on_agent_update',\r\n  /** [Custom] Delta event for run steps (message creation and tool calls) */\r\n  ON_RUN_STEP = 'on_run_step',\r\n  /** [Custom] Delta event for run steps (tool calls) */\r\n  ON_RUN_STEP_DELTA = 'on_run_step_delta',\r\n  /** [Custom] Completed event for run steps (tool calls) */\r\n  ON_RUN_STEP_COMPLETED = 'on_run_step_completed',\r\n  /** [Custom] Delta events for messages */\r\n  ON_MESSAGE_DELTA = 'on_message_delta',\r\n  /** [Custom] Reasoning Delta events for messages */\r\n  ON_REASONING_DELTA = 'on_reasoning_delta',\r\n\r\n  /* Official Events */\r\n\r\n  /** Custom event, emitted by system */\r\n  ON_CUSTOM_EVENT = 'on_custom_event',\r\n  /** Emitted when a chat model starts processing. */\r\n  CHAT_MODEL_START = 'on_chat_model_start',\r\n\r\n  /** Emitted when a chat model streams a chunk of its response. */\r\n  CHAT_MODEL_STREAM = 'on_chat_model_stream',\r\n\r\n  /** Emitted when a chat model completes its processing. */\r\n  CHAT_MODEL_END = 'on_chat_model_end',\r\n\r\n  /** Emitted when a language model starts processing. */\r\n  LLM_START = 'on_llm_start',\r\n\r\n  /** Emitted when a language model streams a chunk of its response. */\r\n  LLM_STREAM = 'on_llm_stream',\r\n\r\n  /** Emitted when a language model completes its processing. */\r\n  LLM_END = 'on_llm_end',\r\n\r\n  /** Emitted when a chain starts processing. */\r\n  CHAIN_START = 'on_chain_start',\r\n\r\n  /** Emitted when a chain streams a chunk of its output. */\r\n  CHAIN_STREAM = 'on_chain_stream',\r\n\r\n  /** Emitted when a chain completes its processing. */\r\n  CHAIN_END = 'on_chain_end',\r\n\r\n  /** Emitted when a tool starts its operation. */\r\n  TOOL_START = 'on_tool_start',\r\n\r\n  /** Emitted when a tool completes its operation. */\r\n  TOOL_END = 'on_tool_end',\r\n\r\n  /** Emitted when a retriever starts its operation. */\r\n  RETRIEVER_START = 'on_retriever_start',\r\n\r\n  /** Emitted when a retriever completes its operation. */\r\n  RETRIEVER_END = 'on_retriever_end',\r\n\r\n  /** Emitted when a prompt starts processing. */\r\n  PROMPT_START = 'on_prompt_start',\r\n\r\n  /** Emitted when a prompt completes its processing. */\r\n  PROMPT_END = 'on_prompt_end',\r\n}\r\n\r\nexport enum Providers {\r\n  OPENAI = 'openAI',\r\n  BEDROCK_LEGACY = 'bedrock_legacy',\r\n  VERTEXAI = 'vertexai',\r\n  BEDROCK = 'bedrock',\r\n  ANTHROPIC = 'anthropic',\r\n  MISTRALAI = 'mistralai',\r\n  MISTRAL = 'mistral',\r\n  OLLAMA = 'ollama',\r\n  GOOGLE = 'google',\r\n  AZURE = 'azureOpenAI',\r\n  DEEPSEEK = 'deepseek',\r\n  OPENROUTER = 'openrouter',\r\n  XAI = 'xai',\r\n}\r\n\r\nexport enum GraphNodeKeys {\r\n  TOOLS = 'tools',\r\n  AGENT = 'agent',\r\n  PRE_TOOLS = 'pre_tools',\r\n  POST_TOOLS = 'post_tools',\r\n}\r\n\r\nexport enum GraphNodeActions {\r\n  TOOL_NODE = 'tool_node',\r\n  CALL_MODEL = 'call_model',\r\n  ROUTE_MESSAGE = 'route_message',\r\n}\r\n\r\nexport enum CommonEvents {\r\n  LANGGRAPH = 'LangGraph',\r\n}\r\n\r\nexport enum StepTypes {\r\n  TOOL_CALLS = 'tool_calls',\r\n  MESSAGE_CREATION = 'message_creation',\r\n}\r\n\r\nexport enum ContentTypes {\r\n  TEXT = 'text',\r\n  ERROR = 'error',\r\n  THINK = 'think',\r\n  TOOL_CALL = 'tool_call',\r\n  IMAGE_URL = 'image_url',\r\n  IMAGE_FILE = 'image_file',\r\n  /** Anthropic */\r\n  THINKING = 'thinking',\r\n  /** Vertex AI / Google Common */\r\n  REASONING = 'reasoning',\r\n  /** Multi-Agent Switch */\r\n  AGENT_UPDATE = 'agent_update',\r\n  /** Bedrock */\r\n  REASONING_CONTENT = 'reasoning_content',\r\n}\r\n\r\nexport enum ToolCallTypes {\r\n  FUNCTION = 'function',\r\n  RETRIEVAL = 'retrieval',\r\n  FILE_SEARCH = 'file_search',\r\n  CODE_INTERPRETER = 'code_interpreter',\r\n  /* Agents Tool Call */\r\n  TOOL_CALL = 'tool_call',\r\n}\r\n\r\nexport enum Callback {\r\n  TOOL_ERROR = 'handleToolError',\r\n  TOOL_START = 'handleToolStart',\r\n  TOOL_END = 'handleToolEnd',\r\n  /*\r\n  LLM_START = 'handleLLMStart',\r\n  LLM_NEW_TOKEN = 'handleLLMNewToken',\r\n  LLM_ERROR = 'handleLLMError',\r\n  LLM_END = 'handleLLMEnd',\r\n  CHAT_MODEL_START = 'handleChatModelStart',\r\n  CHAIN_START = 'handleChainStart',\r\n  CHAIN_ERROR = 'handleChainError',\r\n  CHAIN_END = 'handleChainEnd',\r\n  TEXT = 'handleText',\r\n  AGENT_ACTION = 'handleAgentAction',\r\n  AGENT_END = 'handleAgentEnd',\r\n  RETRIEVER_START = 'handleRetrieverStart',\r\n  RETRIEVER_END = 'handleRetrieverEnd',\r\n  RETRIEVER_ERROR = 'handleRetrieverError',\r\n  CUSTOM_EVENT = 'handleCustomEvent'\r\n  */\r\n}\r\n\r\nexport enum Constants {\r\n  OFFICIAL_CODE_BASEURL = 'https://api.illuma.ai/v1',\r\n  EXECUTE_CODE = 'execute_code',\r\n  WEB_SEARCH = 'web_search',\r\n  CONTENT_AND_ARTIFACT = 'content_and_artifact',\r\n}\r\n\r\nexport enum TitleMethod {\r\n  STRUCTURED = 'structured',\r\n  FUNCTIONS = 'functions',\r\n  COMPLETION = 'completion',\r\n}\r\n\r\nexport enum EnvVar {\r\n  CODE_API_KEY = 'CODE_EXECUTOR_API_KEY',\r\n  CODE_BASEURL = 'CODE_EXECUTOR_API_BASEURL',\r\n}\r\n"],"names":[],"mappings":"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"}