@falai/agent 0.8.1 → 0.9.0-alpha-2

package/dist/cjs/src/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/types/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAElD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

package/dist/{types → cjs/src/types}/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":""}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/types/schema.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,65 @@
+/**
+ * Session step types for tracking conversation progress
+ */
+import type { History } from "./history";
+/**
+ * Pending route transition information
+ */
+export interface PendingTransition {
+    /** Target route ID to transition to */
+    targetRouteId: string;
+    /** Optional AI-evaluated condition for the transition */
+    condition?: string;
+    /** Reason for the transition */
+    reason: "route_complete" | "manual";
+}
+/**
+ * Session state tracks the current position in the conversation flow
+ * and data collected at the agent level across all routes
+ */
+export interface SessionState<TData = unknown> {
+    /** Unique session identifier (useful for persistence) */
+    id: string;
+    /** Current route the conversation is in */
+    currentRoute?: {
+        id: string;
+        title: string;
+        enteredAt?: Date;
+    };
+    /** Current step within the route */
+    currentStep?: {
+        id: string;
+        description?: string;
+        enteredAt?: Date;
+    };
+    /**
+     * Agent-level data collected across all routes
+     * This is the single source of truth for all collected data
+     * Routes can access and contribute to this shared data structure
+     */
+    data: Partial<TData>;
+    /** History of routes visited in this session */
+    routeHistory?: Array<{
+        routeId: string;
+        enteredAt?: Date;
+        exitedAt?: Date;
+        completed: boolean;
+    }>;
+    /**
+     * Pending route transition after completion
+     * Set when a route completes with onComplete handler
+     */
+    pendingTransition?: PendingTransition;
+    /**
+     * Conversation history managed by the session
+     * Contains the full conversation between user and assistant
+     */
+    history?: History;
+    /** Session metadata */
+    metadata?: {
+        createdAt?: Date;
+        lastUpdatedAt?: Date;
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/types/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,OAAO;IAC3C,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAC3C,YAAY,CAAC,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;IAEF,oCAAoC;IACpC,WAAW,CAAC,EAAE;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;IAEF;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErB,gDAAgD;IAChD,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,aAAa,CAAC,EAAE,IAAI,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH"}

package/dist/cjs/src/types/session.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Session step types for tracking conversation progress
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/types/session.ts"],"names":[],"mappings":";AAAA;;GAEG"}

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

@@ -0,0 +1,30 @@
+import type { SessionState } from "./session";
+import type { Event } from "./history";
+/**
+ * Context object passed to template functions for dynamic rendering.
+ */
+export interface TemplateContext<TContext = unknown, TData = unknown> {
+    /**
+     * The agent's static or dynamically-provided context.
+     */
+    context?: TContext;
+    /**
+     * The current session state, including collected data.
+     */
+    session?: SessionState<TData>;
+    /**
+     * The recent interaction history.
+     */
+    history?: Event[];
+    /**
+     * The data collected in the current route.
+     * A convenience alias for `session.data`.
+     */
+    data?: Partial<TData>;
+}
+/**
+ * Represents a string that can be either a literal or a function
+ * that dynamically generates a string from context.
+ */
+export type Template<TContext = unknown, TData = unknown> = string | ((params: TemplateContext<TContext, TData>) => string | Promise<string>);
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../src/types/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAClE;;OAEG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IACpD,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/cjs/src/types/template.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=template.js.map

package/dist/cjs/src/types/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/types/template.ts"],"names":[],"mappings":""}

package/dist/{types → cjs/src/types}/tool.d.ts

@@ -10,11 +10,13 @@ export interface ToolContext<TContext = unknown, TData = unknown> {
     context: TContext;
     /** Update the agent's context (triggers lifecycle hooks if configured) */
     updateContext: (updates: Partial<TContext>) => Promise<void>;
+    /** Update the agent's collected data (triggers lifecycle hooks if configured) */
+    updateData: (updates: Partial<TData>) => Promise<void>;
     /** Current step reference (if in a route) */
     step?: StepRef;
     /** Interaction history */
     history: Event[];
-    /** Data collected so far in the current route */
+    /** Complete agent-level data collected so far */
     data?: Partial<TData>;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
@@ -24,33 +26,35 @@ export interface ToolContext<TContext = unknown, TData = unknown> {
  */
 export interface ToolResult<TResultData = unknown, TContext = unknown, TData = unknown> {
     /** The result data */
-    data: TResultData;
+    data?: TResultData;
     /** Optional context update to be merged with current context */
     contextUpdate?: Partial<TContext>;
-    /** Optional collected data update to be merged with session step */
-    collectedUpdate?: Partial<TData>;
+    /** Optional agent-level data update to be merged with collected data */
+    dataUpdate?: Partial<TData>;
+    /** Success indicator */
+    success?: boolean;
+    /** Error message if operation failed */
+    error?: string;
     /** Optional metadata about the execution */
     meta?: Record<string, unknown>;
 }
 /**
  * Handler function for a tool
  */
-export type ToolHandler<TContext, TArgs extends unknown[], TResult, TData = unknown> = (context: ToolContext<TContext, TData>, ...args: TArgs) => Promise<ToolResult<TResult, TContext, TData>> | ToolResult<TResult, TContext, TData>;
+export type ToolHandler<TContext, TData = unknown, TArgs extends unknown[] = unknown[], TResult = unknown> = (context: ToolContext<TContext, TData>, ...args: TArgs) => Promise<ToolResult<TResult, TContext, TData>> | ToolResult<TResult, TContext, TData>;
 /**
- * Reference to a defined tool
+ * Tool definition - plain object interface
  */
-export interface ToolRef<TContext, TArgs extends unknown[], TResult, TData = unknown> {
+export interface Tool<TContext = unknown, TData = unknown, TArgs extends unknown[] = unknown[], TResult = unknown> {
     /** Tool identifier */
     id: string;
-    /** Tool name */
-    name: string;
+    /** Tool display name (shown to AI models) */
+    name?: string;
     /** Tool handler function */
-    handler: ToolHandler<TContext, TArgs, TResult, TData>;
-    /** Description of what the tool does */
+    handler: ToolHandler<TContext, TData, TArgs, TResult>;
+    /** Description of what the tool does (for AI discovery) */
     description?: string;
     /** Parameter schema or description */
     parameters?: unknown;
-    /** Domain this tool belongs to (set when added via agent.addDomain) */
-    domainName?: string;
 }
 //# sourceMappingURL=tool.d.ts.map

package/dist/cjs/src/types/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/types/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAC9D,+BAA+B;IAC/B,OAAO,EAAE,QAAQ,CAAC;IAClB,0EAA0E;IAC1E,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,iFAAiF;IACjF,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CACzB,WAAW,GAAG,OAAO,EACrB,QAAQ,GAAG,OAAO,EAClB,KAAK,GAAG,OAAO;IAEf,sBAAsB;IACtB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,wBAAwB;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,QAAQ,EACR,KAAK,GAAG,OAAO,EACf,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EACnC,OAAO,GAAG,OAAO,IACf,CACF,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,EACrC,GAAG,IAAI,EAAE,KAAK,KAEZ,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,GAC7C,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,IAAI,CACnB,QAAQ,GAAG,OAAO,EAClB,KAAK,GAAG,OAAO,EACf,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EACnC,OAAO,GAAG,OAAO;IAEjB,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACtD,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/cjs/{types → src/types}/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/types/tool.ts"],"names":[],"mappings":";AAAA;;GAEG"}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/types/tool.ts"],"names":[],"mappings":";AAAA;;GAEG"}

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

@@ -0,0 +1,8 @@
+/**
+ * Deep clone utility to avoid adding large dependencies like lodash.
+ * Handles objects, arrays, dates, and primitives.
+ * @param obj - The object to clone
+ * @returns A deep copy of the object
+ */
+export declare function cloneDeep<T>(obj: T): T;
+//# sourceMappingURL=clone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../../src/utils/clone.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CA4BtC"}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cloneDeep = cloneDeep;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Deep clone utility to avoid adding large dependencies like lodash.
+ * Handles objects, arrays, dates, and primitives.
+ * @param obj - The object to clone
+ * @returns A deep copy of the object
+ */
+function cloneDeep(obj) {
+    if (obj === null || typeof obj !== "object") {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return new Date(obj.getTime());
+    }
+    if (Array.isArray(obj)) {
+        const arrCopy = [];
+        for (let i = 0; i < obj.length; i++) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            arrCopy[i] = cloneDeep(obj[i]);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return arrCopy;
+    }
+    const objCopy = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            objCopy[key] = cloneDeep(obj[key]);
+        }
+    }
+    return objCopy;
+}
+//# sourceMappingURL=clone.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../../../src/utils/clone.ts"],"names":[],"mappings":";;AAOA,8BA4BC;AAnCD,uDAAuD;AACvD;;;;;GAKG;AACH,SAAgB,SAAS,CAAI,GAAM;IACjC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;QACxB,+DAA+D;QAC/D,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAQ,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,EAAW,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,mEAAmE;YACnE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,+DAA+D;QAC/D,OAAO,OAAc,CAAC;IACxB,CAAC;IAED,MAAM,OAAO,GAAG,EAA4B,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,OAAO,OAAY,CAAC;AACtB,CAAC"}

package/dist/{utils → cjs/src/utils}/event.d.ts

@@ -1,4 +1,4 @@
-import { type Event } from "../types/history";
+import { type Event } from "../types";
 /**
  * Helper to extract last message from history
  */

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../../src/utils/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,UAAU,CAAC;AACjD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAWlE"}

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
+ * With agent-level data, routes share the same data structure
+ */
+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 agent-level data structure
+ */
+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