@falai/agent 0.8.1 → 0.9.0-alpha-1

package/dist/cjs/{utils → src/utils}/event.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLastMessageFromHistory = getLastMessageFromHistory;
-const history_1 = require("../types/history");
+const types_1 = require("../types");
 /**
  * Helper to extract last message from history
  */
 function getLastMessageFromHistory(history) {
     for (let i = history.length - 1; i >= 0; i--) {
         const event = history[i];
-        if (event.kind === history_1.EventKind.MESSAGE) {
+        if (event.kind === types_1.EventKind.MESSAGE) {
             if (!event.data || !("message" in event.data)) {
                 continue;
             }

package/dist/cjs/src/utils/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../../src/utils/event.ts"],"names":[],"mappings":";;AAIA,8DAWC;AAfD,oCAAiD;AACjD;;GAEG;AACH,SAAgB,yBAAyB,CAAC,OAAgB;IACxD,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAS,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,SAAS;YACX,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/cjs/src/utils/history.d.ts

@@ -0,0 +1,31 @@
+/**
+ * History normalization utilities
+ * Convert simplified history format to internal Event format
+ */
+import type { Event } from "../types";
+import type { History, HistoryItem } from "../types/history";
+/**
+ * Normalize a simplified history array to internal Event array
+ */
+export declare function normalizeHistory(history: History): Event[];
+/**
+ * Helper function to create a user message
+ */
+export declare function userMessage(content: string, name?: string): HistoryItem;
+/**
+ * Helper function to create an assistant message
+ */
+export declare function assistantMessage(content: string | null, toolCalls?: Array<{
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}>): HistoryItem;
+/**
+ * Helper function to create a tool message
+ */
+export declare function toolMessage(toolCallId: string, name: string, content: unknown): HistoryItem;
+/**
+ * Helper function to create a system message
+ */
+export declare function systemMessage(content: string): HistoryItem;
+//# sourceMappingURL=history.d.ts.map

package/dist/cjs/src/utils/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../../src/utils/history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAoB,MAAM,UAAU,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA2F7D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAEvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,CAAC,EAAE,KAAK,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC,GACD,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAE1D"}

package/dist/cjs/src/utils/history.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * History normalization utilities
+ * Convert simplified history format to internal Event format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeHistory = normalizeHistory;
+exports.userMessage = userMessage;
+exports.assistantMessage = assistantMessage;
+exports.toolMessage = toolMessage;
+exports.systemMessage = systemMessage;
+const types_1 = require("../types");
+/**
+ * Convert a simplified history item to an internal Event
+ */
+function convertHistoryItemToEvent(item) {
+    const timestamp = new Date().toISOString();
+    switch (item.role) {
+        case "user": {
+            return {
+                kind: types_1.EventKind.MESSAGE,
+                source: types_1.MessageRole.USER,
+                timestamp,
+                data: {
+                    participant: {
+                        display_name: item.name || "User",
+                    },
+                    message: item.content,
+                },
+            };
+        }
+        case "assistant": {
+            // Handle assistant message with optional tool calls
+            const event = {
+                kind: types_1.EventKind.MESSAGE,
+                source: types_1.MessageRole.ASSISTANT,
+                timestamp,
+                data: {
+                    participant: {
+                        display_name: "Assistant",
+                    },
+                    message: item.content || "",
+                },
+            };
+            // If there are tool calls, we need to create a separate tool event
+            // But for now, we'll just store the tool calls in the message data
+            if (item.tool_calls && item.tool_calls.length > 0) {
+                event.data.toolCalls = item.tool_calls;
+            }
+            return event;
+        }
+        case "tool": {
+            return {
+                kind: types_1.EventKind.TOOL,
+                source: types_1.MessageRole.AGENT,
+                timestamp,
+                data: {
+                    tool_calls: [
+                        {
+                            tool_id: item.tool_call_id,
+                            arguments: {}, // Tool results don't have arguments
+                            result: {
+                                data: item.content,
+                            },
+                        },
+                    ],
+                },
+            };
+        }
+        case "system": {
+            return {
+                kind: types_1.EventKind.MESSAGE,
+                source: types_1.MessageRole.SYSTEM,
+                timestamp,
+                data: {
+                    participant: {
+                        display_name: "System",
+                    },
+                    message: item.content,
+                },
+            };
+        }
+        default:
+            // This should never happen due to TypeScript, but fallback just in case
+            return {
+                kind: types_1.EventKind.MESSAGE,
+                source: types_1.MessageRole.SYSTEM,
+                timestamp,
+                data: {
+                    participant: {
+                        display_name: "Unknown",
+                    },
+                    message: "Unknown message type",
+                },
+            };
+    }
+}
+/**
+ * Normalize a simplified history array to internal Event array
+ */
+function normalizeHistory(history) {
+    return history.map(convertHistoryItemToEvent);
+}
+/**
+ * Helper function to create a user message
+ */
+function userMessage(content, name) {
+    return { role: "user", content, name };
+}
+/**
+ * Helper function to create an assistant message
+ */
+function assistantMessage(content, toolCalls) {
+    return { role: "assistant", content, tool_calls: toolCalls };
+}
+/**
+ * Helper function to create a tool message
+ */
+function toolMessage(toolCallId, name, content) {
+    return { role: "tool", tool_call_id: toolCallId, name, content };
+}
+/**
+ * Helper function to create a system message
+ */
+function systemMessage(content) {
+    return { role: "system", content };
+}
+//# sourceMappingURL=history.js.map

package/dist/cjs/src/utils/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../../src/utils/history.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/cjs/src/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../src/utils/id.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA2BH,0CAIC;AAMD,wCAaC;AAMD,wCAIC;AAMD,oDAGC;AAnED;;;GAGG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;QACjC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,4BAA4B;IAClD,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,KAAa;IAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,SAAS,SAAS,IAAI,IAAI,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAAe,EACf,WAAoB,EACpB,KAAc;IAEd,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,OAAO,IAAI,WAAW,EAAE,CAAC,CAAC;QACrD,OAAO,QAAQ,SAAS,IAAI,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,0CAA0C;IAC1C,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACjE,OAAO,QAAQ,OAAO,IAAI,MAAM,EAAE,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,QAAQ,SAAS,IAAI,IAAI,EAAE,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,MAAc;IACjD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,MAAM,cAAc,CAAC,CAAC;IACjD,OAAO,eAAe,MAAM,IAAI,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/cjs/src/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Utility functions and helpers
+ */
+export { generateRouteId, generateStepId, generateToolId, generateInlineToolId, } from "./id";
+export { createSession, createSessionId, enterRoute, enterStep, mergeCollected, sessionStepToData, sessionDataToStep, } from "./session";
+export { render, renderMany, renderTemplate, renderTemplateObject, formatKnowledgeBase, } from "./template";
+export { cloneDeep } from "./clone";
+export { getLastMessageFromHistory } from "./event";
+export { normalizeHistory, userMessage, assistantMessage, toolMessage, systemMessage, } from "./history";
+export { LoggerLevel, logger } from "./logger";
+export type { RetryOptions } from "./retry";
+export { retry, withTimeoutAndRetry } from "./retry";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,MAAM,CAAC;AAGd,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,MAAM,EACN,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG/C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/cjs/src/utils/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Utility functions and helpers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTimeoutAndRetry = exports.retry = exports.logger = exports.LoggerLevel = exports.systemMessage = exports.toolMessage = exports.assistantMessage = exports.userMessage = exports.normalizeHistory = exports.getLastMessageFromHistory = exports.cloneDeep = exports.formatKnowledgeBase = exports.renderTemplateObject = exports.renderTemplate = exports.renderMany = exports.render = exports.sessionDataToStep = exports.sessionStepToData = exports.mergeCollected = exports.enterStep = exports.enterRoute = exports.createSessionId = exports.createSession = exports.generateInlineToolId = exports.generateToolId = exports.generateStepId = exports.generateRouteId = void 0;
+// ID generation
+var id_1 = require("./id");
+Object.defineProperty(exports, "generateRouteId", { enumerable: true, get: function () { return id_1.generateRouteId; } });
+Object.defineProperty(exports, "generateStepId", { enumerable: true, get: function () { return id_1.generateStepId; } });
+Object.defineProperty(exports, "generateToolId", { enumerable: true, get: function () { return id_1.generateToolId; } });
+Object.defineProperty(exports, "generateInlineToolId", { enumerable: true, get: function () { return id_1.generateInlineToolId; } });
+// Session management
+var session_1 = require("./session");
+Object.defineProperty(exports, "createSession", { enumerable: true, get: function () { return session_1.createSession; } });
+Object.defineProperty(exports, "createSessionId", { enumerable: true, get: function () { return session_1.createSessionId; } });
+Object.defineProperty(exports, "enterRoute", { enumerable: true, get: function () { return session_1.enterRoute; } });
+Object.defineProperty(exports, "enterStep", { enumerable: true, get: function () { return session_1.enterStep; } });
+Object.defineProperty(exports, "mergeCollected", { enumerable: true, get: function () { return session_1.mergeCollected; } });
+Object.defineProperty(exports, "sessionStepToData", { enumerable: true, get: function () { return session_1.sessionStepToData; } });
+Object.defineProperty(exports, "sessionDataToStep", { enumerable: true, get: function () { return session_1.sessionDataToStep; } });
+// Template rendering
+var template_1 = require("./template");
+Object.defineProperty(exports, "render", { enumerable: true, get: function () { return template_1.render; } });
+Object.defineProperty(exports, "renderMany", { enumerable: true, get: function () { return template_1.renderMany; } });
+Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
+Object.defineProperty(exports, "renderTemplateObject", { enumerable: true, get: function () { return template_1.renderTemplateObject; } });
+Object.defineProperty(exports, "formatKnowledgeBase", { enumerable: true, get: function () { return template_1.formatKnowledgeBase; } });
+// Cloning utilities
+var clone_1 = require("./clone");
+Object.defineProperty(exports, "cloneDeep", { enumerable: true, get: function () { return clone_1.cloneDeep; } });
+// Event utilities
+var event_1 = require("./event");
+Object.defineProperty(exports, "getLastMessageFromHistory", { enumerable: true, get: function () { return event_1.getLastMessageFromHistory; } });
+// History utilities
+var history_1 = require("./history");
+Object.defineProperty(exports, "normalizeHistory", { enumerable: true, get: function () { return history_1.normalizeHistory; } });
+Object.defineProperty(exports, "userMessage", { enumerable: true, get: function () { return history_1.userMessage; } });
+Object.defineProperty(exports, "assistantMessage", { enumerable: true, get: function () { return history_1.assistantMessage; } });
+Object.defineProperty(exports, "toolMessage", { enumerable: true, get: function () { return history_1.toolMessage; } });
+Object.defineProperty(exports, "systemMessage", { enumerable: true, get: function () { return history_1.systemMessage; } });
+// Logging
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "LoggerLevel", { enumerable: true, get: function () { return logger_1.LoggerLevel; } });
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+var retry_1 = require("./retry");
+Object.defineProperty(exports, "retry", { enumerable: true, get: function () { return retry_1.retry; } });
+Object.defineProperty(exports, "withTimeoutAndRetry", { enumerable: true, get: function () { return retry_1.withTimeoutAndRetry; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,gBAAgB;AAChB,2BAKc;AAJZ,qGAAA,eAAe,OAAA;AACf,oGAAA,cAAc,OAAA;AACd,oGAAA,cAAc,OAAA;AACd,0GAAA,oBAAoB,OAAA;AAGtB,qBAAqB;AACrB,qCAQmB;AAPjB,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AACf,qGAAA,UAAU,OAAA;AACV,oGAAA,SAAS,OAAA;AACT,yGAAA,cAAc,OAAA;AACd,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AAGnB,qBAAqB;AACrB,uCAMoB;AALlB,kGAAA,MAAM,OAAA;AACN,sGAAA,UAAU,OAAA;AACV,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,+GAAA,mBAAmB,OAAA;AAGrB,oBAAoB;AACpB,iCAAoC;AAA3B,kGAAA,SAAS,OAAA;AAElB,kBAAkB;AAClB,iCAAoD;AAA3C,kHAAA,yBAAyB,OAAA;AAElC,oBAAoB;AACpB,qCAMmB;AALjB,2GAAA,gBAAgB,OAAA;AAChB,sGAAA,WAAW,OAAA;AACX,2GAAA,gBAAgB,OAAA;AAChB,sGAAA,WAAW,OAAA;AACX,wGAAA,aAAa,OAAA;AAGf,UAAU;AACV,mCAA+C;AAAtC,qGAAA,WAAW,OAAA;AAAE,gGAAA,MAAM,OAAA;AAI5B,iCAAqD;AAA5C,8FAAA,KAAK,OAAA;AAAE,4GAAA,mBAAmB,OAAA"}

package/dist/cjs/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAUD,eAAO,MAAM,MAAM,gBAAM,CAAC"}

package/dist/cjs/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../src/utils/logger.ts"],"names":[],"mappings":";;;;;;AAAA,wDAA2B;AAE3B,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf,gCAAiB,CAAA;AACnB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AAED;;GAEG;AACH,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,CAAC;AAE7C,oBAAoB;AACpB,kBAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAEnB,QAAA,MAAM,GAAG,kBAAG,CAAC"}

package/dist/cjs/src/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC;AAED,wBAAsB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA8BnE;AAED,eAAO,MAAM,mBAAmB,GAAU,CAAC,EACzC,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,YAAW,MAAc,EACzB,aAAY,MAAU,EACtB,gBAAe,MAAuB,KACrC,OAAO,CAAC,CAAC,CA8CX,CAAC"}

package/dist/cjs/src/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../../src/utils/retry.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/utils/session.d.ts

@@ -0,0 +1,51 @@
+import type { SessionState } from "../types/session";
+import type { CollectedStateData } from "../types/persistence";
+/**
+ * Helper to create a new session
+ * @param sessionId - Optional session ID (e.g., from database)
+ * @param metadata - Optional metadata to attach
+ */
+export declare function createSession<TData = Record<string, unknown>>(sessionId?: string, metadata?: SessionState<TData>["metadata"]): SessionState<TData>;
+/**
+ * Helper to create a new session ID
+ */
+export declare function createSessionId(): string;
+/**
+ * Clones a session to prevent mutation
+ */
+export declare function cloneSession<TData>(session: SessionState<TData>): SessionState<TData>;
+/**
+ * Helper to update session with new route
+ * Preserves collected data per route in dataByRoute map
+ */
+export declare function enterRoute<TData = Record<string, unknown>>(session: SessionState<TData>, routeId: string, routeTitle: string): SessionState<TData>;
+/**
+ * Helper to update session with new step
+ */
+export declare function enterStep<TData = Record<string, unknown>>(session: SessionState<TData>, stepId: string, stepDescription?: string): SessionState<TData>;
+/**
+ * Helper to merge collected data into session
+ * Updates both data and dataByRoute for current route
+ */
+export declare function mergeCollected<TData = Record<string, unknown>>(session: SessionState<TData>, data: Partial<unknown>): SessionState<TData>;
+/**
+ * Helper to convert SessionState to persistence-friendly format
+ * Used when saving to database
+ */
+export declare function sessionStepToData<TData = Record<string, unknown>>(session: SessionState<TData>): {
+    currentRoute?: string;
+    currentStep?: string;
+    collectedData: CollectedStateData<TData>;
+};
+/**
+ * Helper to convert database SessionData back to SessionState
+ * Used when loading from database
+ * @param sessionId - The database session ID
+ * @param data - The database session data
+ */
+export declare function sessionDataToStep<TData = Record<string, unknown>>(sessionId: string, data: {
+    currentRoute?: string;
+    currentStep?: string;
+    collectedData?: CollectedStateData<TData>;
+}): SessionState<TData>;
+//# sourceMappingURL=session.d.ts.map

package/dist/cjs/src/utils/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/utils/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GACzC,YAAY,CAAC,KAAK,CAAC,CAerB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AACD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAChC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAC3B,YAAY,CAAC,KAAK,CAAC,CAErB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,YAAY,CAAC,KAAK,CAAC,CAkDrB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,GACvB,YAAY,CAAC,KAAK,CAAC,CAarB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GACrB,YAAY,CAAC,KAAK,CAAC,CAqBrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAC3B;IACD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;CAC1C,CAcA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;CAC3C,GACA,YAAY,CAAC,KAAK,CAAC,CAiCrB"}

package/dist/cjs/{types → src/utils}/session.js

@@ -1,22 +1,23 @@
 "use strict";
-/**
- * Session step types for tracking conversation progress
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSession = createSession;
+exports.createSessionId = createSessionId;
+exports.cloneSession = cloneSession;
 exports.enterRoute = enterRoute;
 exports.enterStep = enterStep;
 exports.mergeCollected = mergeCollected;
 exports.sessionStepToData = sessionStepToData;
 exports.sessionDataToStep = sessionDataToStep;
+const clone_1 = require("./clone");
 /**
  * Helper to create a new session
  * @param sessionId - Optional session ID (e.g., from database)
  * @param metadata - Optional metadata to attach
  */
 function createSession(sessionId, metadata) {
+    const id = sessionId || `session_${Date.now()}_${Math.random().toString(36).slice(2)}`;
     return {
-        id: sessionId,
+        id,
         data: {},
         dataByRoute: {},
         routeHistory: [],
@@ -27,12 +28,24 @@ function createSession(sessionId, metadata) {
         },
     };
 }
+/**
+ * Helper to create a new session ID
+ */
+function createSessionId() {
+    return `session_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+}
+/**
+ * Clones a session to prevent mutation
+ */
+function cloneSession(session) {
+    return (0, clone_1.cloneDeep)(session);
+}
 /**
  * Helper to update session with new route
  * Preserves collected data per route in dataByRoute map
  */
 function enterRoute(session, routeId, routeTitle) {
-    // Save current route's collected data before switching
+    // Save current route's collected data before switching (if any)
     const dataByRoute = { ...session.dataByRoute };
     if (session.currentRoute &&
         session.data &&
@@ -40,7 +53,7 @@ function enterRoute(session, routeId, routeTitle) {
         dataByRoute[session.currentRoute.id] = session.data;
     }
     // Exit current route if exists
-    const routeHistory = [...session.routeHistory];
+    const routeHistory = [...(session.routeHistory || [])];
     if (session.currentRoute) {
         const lastRouteIndex = routeHistory.findIndex((r) => r.routeId === session.currentRoute?.id && !r.exitedAt);
         if (lastRouteIndex >= 0) {
@@ -94,7 +107,7 @@ function enterStep(session, stepId, stepDescription) {
 }
 /**
  * Helper to merge collected data into session
- * Updates both the data field and the dataByRoute map
+ * Updates both data and dataByRoute for current route
  */
 function mergeCollected(session, data) {
     const newCollected = {
@@ -125,9 +138,10 @@ function sessionStepToData(session) {
         currentRoute: session.currentRoute?.id,
         currentStep: session.currentStep?.id,
         collectedData: {
-            data: session.data,
-            dataByRoute: session.dataByRoute, // Include per-route data
+            data: session.data || {},
+            dataByRoute: session.dataByRoute || {}, // Include per-route data
             routeHistory: session.routeHistory,
+            history: session.history, // Include conversation history
             currentRouteTitle: session.currentRoute?.title,
             currentStepDescription: session.currentStep?.description,
             metadata: session.metadata,
@@ -141,7 +155,15 @@ function sessionStepToData(session) {
  * @param data - The database session data
  */
 function sessionDataToStep(sessionId, data) {
-    const collectedData = data.collectedData || {};
+    const collectedData = data.collectedData || {
+        data: {},
+        dataByRoute: {},
+        routeHistory: [],
+        history: [],
+        metadata: {},
+        currentRouteTitle: undefined,
+        currentStepDescription: undefined,
+    };
     return {
         id: sessionId,
         currentRoute: data.currentRoute
@@ -159,8 +181,9 @@ function sessionDataToStep(sessionId, data) {
             }
             : undefined,
         data: collectedData.data || {},
-        dataByRoute: collectedData.dataByRoute || {}, // Restore per-route data
+        dataByRoute: collectedData.dataByRoute || {},
         routeHistory: collectedData.routeHistory || [],
+        history: collectedData.history || [],
         metadata: collectedData.metadata || {},
     };
 }

package/dist/cjs/src/utils/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/utils/session.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/utils/template.d.ts

@@ -0,0 +1,107 @@
+import type { Template, TemplateContext } from "../types";
+/**
+ * Renders a template, which can be a string or a function, using the provided context.
+ * This function is asynchronous to support template functions that perform async operations.
+ *
+ * @param template - The template to render (string or function).
+ * @param params - The context object to pass to the template function.
+ * @returns A promise that resolves to the rendered string.
+ *
+ * @example
+ * ```typescript
+ * // With a string template
+ * const result1 = await render("Hello {{name}}", { context: { name: "Alice" } });
+ * // Result: "Hello Alice"
+ *
+ * // With a function template
+ * const fnTemplate = ({ context }) => `Hello ${context.name}`;
+ * const result2 = await render(fnTemplate, { context: { name: "Bob" } });
+ * // Result: "Hello Bob"
+ * ```
+ */
+export declare function render<TContext = unknown, TData = unknown>(template: Template<TContext, TData> | undefined, params: TemplateContext<TContext, TData>): Promise<string>;
+/**
+ * Renders an array of templates.
+ *
+ * @param templates - An array of templates to render.
+ * @param params - The context object.
+ * @returns A promise that resolves to an array of rendered strings.
+ */
+export declare function renderMany<TContext = unknown, TData = unknown>(templates: Template<TContext, TData>[] | undefined, params: TemplateContext<TContext, TData>): Promise<string[]>;
+/**
+ * @deprecated Use the asynchronous `render` function instead.
+ * Renders template variables in a string using the provided context.
+ * Supports {{variable}} and {{object.property}} syntax for property access.
+ *
+ * @param template - The template string containing {{variable}} placeholders
+ * @param context - The context object to pull values from
+ * @returns The rendered string with variables replaced
+ *
+ * @example
+ * ```typescript
+ * const template = "Hello {{user.name}}, welcome to {{company.name}}!";
+ * const context = {
+ *   user: { name: "Alice", age: 30 },
+ *   company: { name: "Acme Corp", location: "NYC" }
+ * };
+ * const result = renderTemplate(template, context);
+ * // Result: "Hello Alice, welcome to Acme Corp!"
+ *
+ * // Array handling
+ * const template2 = "Items: {{items}}";
+ * const context2 = { items: ["apple", "banana", "cherry"] };
+ * const result2 = renderTemplate(template2, context2);
+ * // Result: "Items: apple, banana, cherry"
+ * ```
+ */
+export declare function renderTemplate(template: string, context: Record<string, unknown> | undefined): string;
+/**
+ * @deprecated This function does not support async template functions.
+ * Renders template variables in an object recursively.
+ * Handles nested objects and arrays.
+ *
+ * @param obj - The object to render templates in
+ * @param context - The context object to pull values from
+ * @returns The object with all string templates rendered
+ */
+export declare function renderTemplateObject(obj: unknown, context: Record<string, unknown> | undefined): unknown;
+/**
+ * Formats a JSON structure into readable markdown format.
+ * Handles nested objects, arrays, and primitive values.
+ *
+ * @param data - The JSON data to format
+ * @param title - Optional title for the knowledge base section
+ * @param maxDepth - Maximum nesting depth (default: 3)
+ * @returns Formatted markdown string
+ *
+ * @example
+ * ```typescript
+ * const knowledge = {
+ *   company: {
+ *     name: "Acme Corp",
+ *     products: ["Widget A", "Widget B"],
+ *     locations: {
+ *       headquarters: "NYC",
+ *       branches: ["LA", "Chicago"]
+ *     }
+ *   }
+ * };
+ *
+ * const markdown = formatKnowledgeBase(knowledge, "Company Information");
+ * // Output:
+ * // ## Company Information
+ * //
+ * // ### company
+ * // - **name**: Acme Corp
+ * // - **products**:
+ * //   - Widget A
+ * //   - Widget B
+ * // - **locations**:
+ * //   - **headquarters**: NYC
+ * //   - **branches**:
+ * //     - LA
+ * //     - Chicago
+ * ```
+ */
+export declare function formatKnowledgeBase(data: Record<string, unknown>, title?: string, maxDepth?: number): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/cjs/src/utils/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../src/utils/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,MAAM,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAC9D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,SAAS,EAC/C,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAClE,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,GAAG,SAAS,EAClD,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,GACvC,OAAO,CAAC,MAAM,EAAE,CAAC,CAKnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,MAAM,CAeR;AAoED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,OAAO,CAsBT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,GAAE,MAAU,GACnB,MAAM,CAgBR"}