@falai/agent 0.6.8 → 0.7.0

package/dist/types/session.js

@@ -1,5 +1,5 @@
 /**
- * Session state types for tracking conversation progress
+ * Session step types for tracking conversation progress
  */
 /**
  * Helper to create a new session
@@ -9,8 +9,8 @@
 export function createSession(sessionId, metadata) {
     return {
         id: sessionId,
-        extracted: {},
-        extractedByRoute: {},
+        data: {},
+        dataByRoute: {},
         routeHistory: [],
         metadata: {
             ...metadata,
@@ -21,15 +21,15 @@ export function createSession(sessionId, metadata) {
 }
 /**
  * Helper to update session with new route
- * Preserves extracted data per route in extractedByRoute map
+ * Preserves collected data per route in dataByRoute map
  */
 export function enterRoute(session, routeId, routeTitle) {
-    // Save current route's extracted data before switching
-    const extractedByRoute = { ...session.extractedByRoute };
+    // Save current route's collected data before switching
+    const dataByRoute = { ...session.dataByRoute };
     if (session.currentRoute &&
-        session.extracted &&
-        Object.keys(session.extracted).length > 0) {
-        extractedByRoute[session.currentRoute.id] = session.extracted;
+        session.data &&
+        Object.keys(session.data).length > 0) {
+        dataByRoute[session.currentRoute.id] = session.data;
     }
     // Exit current route if exists
     const routeHistory = [...session.routeHistory];
@@ -39,8 +39,8 @@ export function enterRoute(session, routeId, routeTitle) {
             routeHistory[lastRouteIndex].exitedAt = new Date();
         }
     }
-    // Load extracted data for new route (if resuming) or start fresh
-    const newExtracted = extractedByRoute[routeId] || {};
+    // Load collected data for new route (if resuming) or start fresh
+    const newCollected = dataByRoute[routeId] || {};
     // Enter new route
     const now = new Date();
     return {
@@ -50,9 +50,9 @@ export function enterRoute(session, routeId, routeTitle) {
             title: routeTitle,
             enteredAt: now,
         },
-        currentState: undefined,
-        extracted: newExtracted, // Load route's data or start fresh
-        extractedByRoute,
+        currentStep: undefined,
+        data: newCollected, // Load route's data or start fresh
+        dataByRoute,
         routeHistory: [
             ...routeHistory,
             {
@@ -68,14 +68,14 @@ export function enterRoute(session, routeId, routeTitle) {
     };
 }
 /**
- * Helper to update session with new state
+ * Helper to update session with new step
  */
-export function enterState(session, stateId, stateDescription) {
+export function enterStep(session, stepId, stepDescription) {
     return {
         ...session,
-        currentState: {
-            id: stateId,
-            description: stateDescription,
+        currentStep: {
+            id: stepId,
+            description: stepDescription,
             enteredAt: new Date(),
         },
         metadata: {
@@ -85,23 +85,23 @@ export function enterState(session, stateId, stateDescription) {
     };
 }
 /**
- * Helper to merge extracted data into session
- * Updates both the extracted field and the extractedByRoute map
+ * Helper to merge collected data into session
+ * Updates both the data field and the dataByRoute map
  */
-export function mergeExtracted(session, extracted) {
-    const newExtracted = {
-        ...session.extracted,
-        ...extracted,
+export function mergeCollected(session, data) {
+    const newCollected = {
+        ...session.data,
+        ...data,
     };
-    // Also update the extractedByRoute map for the current route
-    const extractedByRoute = { ...session.extractedByRoute };
+    // Also update the dataByRoute map for the current route
+    const dataByRoute = { ...session.dataByRoute };
     if (session.currentRoute) {
-        extractedByRoute[session.currentRoute.id] = newExtracted;
+        dataByRoute[session.currentRoute.id] = newCollected;
     }
     return {
         ...session,
-        extracted: newExtracted,
-        extractedByRoute,
+        data: newCollected,
+        dataByRoute,
         metadata: {
             ...session.metadata,
             lastUpdatedAt: new Date(),
@@ -109,30 +109,30 @@ export function mergeExtracted(session, extracted) {
     };
 }
 /**
- * Helper to convert SessionState to persistence-friendly format
+ * Helper to convert SessionStep to persistence-friendly format
  * Used when saving to database
  */
-export function sessionStateToData(session) {
+export function sessionStepToData(session) {
     return {
         currentRoute: session.currentRoute?.id,
-        currentState: session.currentState?.id,
+        currentStep: session.currentStep?.id,
         collectedData: {
-            extracted: session.extracted,
-            extractedByRoute: session.extractedByRoute, // Include per-route data
+            data: session.data,
+            dataByRoute: session.dataByRoute, // Include per-route data
             routeHistory: session.routeHistory,
             currentRouteTitle: session.currentRoute?.title,
-            currentStateDescription: session.currentState?.description,
+            currentStepDescription: session.currentStep?.description,
             metadata: session.metadata,
         },
     };
 }
 /**
- * Helper to convert database SessionData back to SessionState
+ * Helper to convert database SessionData back to SessionStep
  * Used when loading from database
  * @param sessionId - The database session ID
  * @param data - The database session data
  */
-export function sessionDataToState(sessionId, data) {
+export function sessionDataToStep(sessionId, data) {
     const collectedData = data.collectedData || {};
     return {
         id: sessionId,
@@ -143,18 +143,16 @@ export function sessionDataToState(sessionId, data) {
                 enteredAt: new Date(),
             }
             : undefined,
-        currentState: data.currentState
+        currentStep: data.currentStep
             ? {
-                id: data.currentState,
-                description: collectedData.currentStateDescription || undefined,
+                id: data.currentStep,
+                description: collectedData.currentStepDescription || undefined,
                 enteredAt: new Date(),
             }
             : undefined,
-        extracted: collectedData.extracted || {},
-        extractedByRoute: collectedData.extractedByRoute ||
-            {}, // Restore per-route data
-        routeHistory: collectedData.routeHistory ||
-            [],
+        data: collectedData.data || {},
+        dataByRoute: collectedData.dataByRoute || {}, // Restore per-route data
+        routeHistory: collectedData.routeHistory || [],
         metadata: collectedData.metadata || {},
     };
 }

package/dist/types/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAkB,EAClB,QAA+C;IAE/C,OAAO;QACL,EAAE,EAAE,SAAS;QACb,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,EAAE;QACpB,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE;YACR,GAAG,QAAQ;YACX,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,aAAa,EAAE,IAAI,IAAI,EAAE;SAC1B;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,OAAiC,EACjC,OAAe,EACf,UAAkB;IAElB,uDAAuD;IACvD,MAAM,gBAAgB,GAAG,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACzD,IACE,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,SAAS;QACjB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EACzC,CAAC;QACD,gBAAgB,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAChE,CAAC;IAED,+BAA+B;IAC/B,MAAM,YAAY,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,cAAc,GAAG,YAAY,CAAC,SAAS,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAC7D,CAAC;QACF,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YACxB,YAAY,CAAC,cAAc,CAAC,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,MAAM,YAAY,GAAI,gBAAgB,CAAC,OAAO,CAAyB,IAAI,EAAE,CAAC;IAE9E,kBAAkB;IAClB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,GAAG,OAAO;QACV,YAAY,EAAE;YACZ,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,GAAG;SACf;QACD,YAAY,EAAE,SAAS;QACvB,SAAS,EAAE,YAAY,EAAE,mCAAmC;QAC5D,gBAAgB;QAChB,YAAY,EAAE;YACZ,GAAG,YAAY;YACf;gBACE,OAAO;gBACP,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,KAAK;aACjB;SACF;QACD,QAAQ,EAAE;YACR,GAAG,OAAO,CAAC,QAAQ;YACnB,aAAa,EAAE,GAAG;SACnB;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,OAAiC,EACjC,OAAe,EACf,gBAAyB;IAEzB,OAAO;QACL,GAAG,OAAO;QACV,YAAY,EAAE;YACZ,EAAE,EAAE,OAAO;YACX,WAAW,EAAE,gBAAgB;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB;QACD,QAAQ,EAAE;YACR,GAAG,OAAO,CAAC,QAAQ;YACnB,aAAa,EAAE,IAAI,IAAI,EAAE;SAC1B;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAiC,EACjC,SAA2B;IAE3B,MAAM,YAAY,GAAG;QACnB,GAAG,OAAO,CAAC,SAAS;QACpB,GAAG,SAAS;KACU,CAAC;IAEzB,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACzD,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,gBAAgB,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC;IAC3D,CAAC;IAED,OAAO;QACL,GAAG,OAAO;QACV,SAAS,EAAE,YAAY;QACvB,gBAAgB;QAChB,QAAQ,EAAE;YACR,GAAG,OAAO,CAAC,QAAQ;YACnB,aAAa,EAAE,IAAI,IAAI,EAAE;SAC1B;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAiC;IAMjC,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE;QACtC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE;QACtC,aAAa,EAAE;YACb,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,yBAAyB;YACrE,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,iBAAiB,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK;YAC9C,uBAAuB,EAAE,OAAO,CAAC,YAAY,EAAE,WAAW;YAC1D,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,IAIC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;IAE/C,OAAO;QACL,EAAE,EAAE,SAAS;QACb,YAAY,EAAE,IAAI,CAAC,YAAY;YAC7B,CAAC,CAAC;gBACE,EAAE,EAAE,IAAI,CAAC,YAAY;gBACrB,KAAK,EACF,aAAa,CAAC,iBAA4B,IAAI,IAAI,CAAC,YAAY;gBAClE,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB;YACH,CAAC,CAAC,SAAS;QACb,YAAY,EAAE,IAAI,CAAC,YAAY;YAC7B,CAAC,CAAC;gBACE,EAAE,EAAE,IAAI,CAAC,YAAY;gBACrB,WAAW,EACR,aAAa,CAAC,uBAAkC,IAAI,SAAS;gBAChE,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB;YACH,CAAC,CAAC,SAAS;QACb,SAAS,EAAG,aAAa,CAAC,SAAiC,IAAI,EAAE;QACjE,gBAAgB,EACb,aAAa,CAAC,gBAAqD;YACpE,EAAE,EAAE,yBAAyB;QAC/B,YAAY,EACT,aAAa,CAAC,YAAyD;YACxE,EAAE;QACJ,QAAQ,EACL,aAAa,CAAC,QAAiD,IAAI,EAAE;KACzE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"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"}

package/dist/types/tool.d.ts

@@ -1,51 +1,51 @@
 /**
  * Tool system type definitions
  */
-import type { Event, StateRef } from "./index";
+import type { Event, StepRef } from "./index";
 /**
  * Context provided to tool handlers
  */
-export interface ToolContext<TContext = unknown, TExtracted = unknown> {
+export interface ToolContext<TContext = unknown, TData = unknown> {
     /** The agent's context data */
     context: TContext;
     /** Update the agent's context (triggers lifecycle hooks if configured) */
     updateContext: (updates: Partial<TContext>) => Promise<void>;
-    /** Current state reference (if in a route) */
-    state?: StateRef;
+    /** Current step reference (if in a route) */
+    step?: StepRef;
     /** Interaction history */
     history: Event[];
-    /** Data extracted so far in the current route */
-    extracted?: Partial<TExtracted>;
+    /** Data collected so far in the current route */
+    data?: Partial<TData>;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
 }
 /**
  * Result returned by a tool
  */
-export interface ToolResult<TData = unknown, TContext = unknown, TExtracted = unknown> {
+export interface ToolResult<TResultData = unknown, TContext = unknown, TData = unknown> {
     /** The result data */
-    data: TData;
+    data: TResultData;
     /** Optional context update to be merged with current context */
     contextUpdate?: Partial<TContext>;
-    /** Optional extracted data update to be merged with session state */
-    extractedUpdate?: Partial<TExtracted>;
+    /** Optional collected data update to be merged with session step */
+    collectedUpdate?: Partial<TData>;
     /** Optional metadata about the execution */
     meta?: Record<string, unknown>;
 }
 /**
  * Handler function for a tool
  */
-export type ToolHandler<TContext, TArgs extends unknown[], TResult, TExtracted = unknown> = (context: ToolContext<TContext, TExtracted>, ...args: TArgs) => Promise<ToolResult<TResult, TContext, TExtracted>> | ToolResult<TResult, TContext, TExtracted>;
+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>;
 /**
  * Reference to a defined tool
  */
-export interface ToolRef<TContext, TArgs extends unknown[], TResult, TExtracted = unknown> {
+export interface ToolRef<TContext, TArgs extends unknown[], TResult, TData = unknown> {
     /** Tool identifier */
     id: string;
     /** Tool name */
     name: string;
     /** Tool handler function */
-    handler: ToolHandler<TContext, TArgs, TResult, TExtracted>;
+    handler: ToolHandler<TContext, TArgs, TResult, TData>;
     /** Description of what the tool does */
     description?: string;
     /** Parameter schema or description */

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

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO,EAAE,UAAU,GAAG,OAAO;IACnE,+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,8CAA8C;IAC9C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CACzB,KAAK,GAAG,OAAO,EACf,QAAQ,GAAG,OAAO,EAClB,UAAU,GAAG,OAAO;IAEpB,sBAAsB;IACtB,IAAI,EAAE,KAAK,CAAC;IACZ,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,QAAQ,EACR,KAAK,SAAS,OAAO,EAAE,EACvB,OAAO,EACP,UAAU,GAAG,OAAO,IAClB,CACF,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,EAC1C,GAAG,IAAI,EAAE,KAAK,KAEZ,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,GAClD,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,OAAO,CACtB,QAAQ,EACR,KAAK,SAAS,OAAO,EAAE,EACvB,OAAO,EACP,UAAU,GAAG,OAAO;IAEpB,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC3D,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"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,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,EAAE,WAAW,CAAC;IAClB,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,QAAQ,EACR,KAAK,SAAS,OAAO,EAAE,EACvB,OAAO,EACP,KAAK,GAAG,OAAO,IACb,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,OAAO,CACtB,QAAQ,EACR,KAAK,SAAS,OAAO,EAAE,EACvB,OAAO,EACP,KAAK,GAAG,OAAO;IAEf,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACtD,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/utils/id.d.ts

@@ -8,13 +8,18 @@
  */
 export declare function generateRouteId(title: string): string;
 /**
- * Generate a deterministic state ID
- * Format: state_{sanitized_description}_{hash} or state_{routeId}_{index}
+ * Generate a deterministic step ID
+ * Format: step_{sanitized_description}_{hash} or step_{routeId}_{index}
  */
-export declare function generateStateId(routeId: string, description?: string, index?: number): string;
+export declare function generateStepId(routeId: string, description?: string, index?: number): string;
 /**
  * Generate a deterministic tool ID
  * Format: tool_{sanitized_name}_{hash}
  */
 export declare function generateToolId(name: string): string;
+/**
+ * Generate a deterministic tool ID for inline tool handlers
+ * Format: tool_inline_{stepId}_{hash}
+ */
+export declare function generateInlineToolId(stepId: string): string;
 //# sourceMappingURL=id.d.ts.map

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

@@ -1 +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,eAAe,CAC7B,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"}
+{"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/utils/id.js

@@ -31,18 +31,18 @@ export function generateRouteId(title) {
     return `route_${sanitized}_${hash}`;
 }
 /**
- * Generate a deterministic state ID
- * Format: state_{sanitized_description}_{hash} or state_{routeId}_{index}
+ * Generate a deterministic step ID
+ * Format: step_{sanitized_description}_{hash} or step_{routeId}_{index}
  */
-export function generateStateId(routeId, description, index) {
+export function generateStepId(routeId, description, index) {
     if (description) {
         const sanitized = sanitize(description);
         const hash = simpleHash(`${routeId}_${description}`);
-        return `state_${sanitized}_${hash}`;
+        return `step_${sanitized}_${hash}`;
     }
-    // Fallback for states without descriptions
+    // Fallback for steps without descriptions
     const suffix = index !== undefined ? index : simpleHash(routeId);
-    return `state_${routeId}_${suffix}`;
+    return `step_${routeId}_${suffix}`;
 }
 /**
  * Generate a deterministic tool ID
@@ -53,4 +53,12 @@ export function generateToolId(name) {
     const hash = simpleHash(name);
     return `tool_${sanitized}_${hash}`;
 }
+/**
+ * Generate a deterministic tool ID for inline tool handlers
+ * Format: tool_inline_{stepId}_{hash}
+ */
+export function generateInlineToolId(stepId) {
+    const hash = simpleHash(`${stepId}_inline_tool`);
+    return `tool_inline_${stepId}_${hash}`;
+}
 //# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;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,MAAM,UAAU,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,MAAM,UAAU,eAAe,CAC7B,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,SAAS,SAAS,IAAI,IAAI,EAAE,CAAC;IACtC,CAAC;IACD,2CAA2C;IAC3C,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACjE,OAAO,SAAS,OAAO,IAAI,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,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"}
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;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,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,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/docs/ADAPTERS.md

@@ -2,7 +2,7 @@
 
 All adapters follow the **provider pattern** - no dependencies required in the package, users install only what they need.
 
-**NEW**: All adapters now support the new **Session State** pattern with automatic persistence of extracted data, current route/state, and conversation progress!
+**NEW**: All adapters now support the new **Session Step** pattern with automatic persistence of collected data, current route/step, and conversation progress!
 
 ### 🎯 Available Adapters
 
@@ -87,7 +87,7 @@ All adapters follow the **provider pattern** - no dependencies required in the p
 
 ## 🎯 Usage Pattern
 
-All adapters follow the same simple pattern with full session state support:
+All adapters follow the same simple pattern with full session step support:
 
 ```typescript
 import { Agent, [Adapter]Adapter } from "@falai/agent";
@@ -107,14 +107,14 @@ const agent = new Agent({
   persistence: {
     adapter,
     userId: "user_123",
-    autoSave: true, // ✨ Auto-saves session state!
+    autoSave: true, // ✨ Auto-saves session step!
   },
 });
 
 // Create a route with data extraction
 const route = agent.createRoute<YourDataType>({
   title: "My Route",
-  extractionSchema: {
+  schema: {
     type: "object",
     properties: {
       field1: { type: "string" },
@@ -124,28 +124,28 @@ const route = agent.createRoute<YourDataType>({
   },
 });
 
-// Define states
-route.initialState.transitionTo({
-  chatState: "Collect data",
-  gather: ["field1", "field2"],
+// Define steps
+route.initialStep.nextStep({
+  instructions: "Collect data",
+  collect: ["field1", "field2"],
 });
 
-// Use with session state
+// Use with session step
 const persistence = agent.getPersistenceManager();
-const { sessionData, sessionState } =
-  await persistence.createSessionWithState<YourDataType>({
+const { sessionData, sessionStep } =
+  await persistence.createSessionWithStep<YourDataType>({
     userId: "user_123",
     agentName: "My Agent",
   });
 
-// Chat with automatic session state persistence
+// Chat with automatic session step persistence
 const response = await agent.respond({
   history: [...],
-  session: sessionState, // Pass session state
+  session: sessionStep, // Pass session step
 });
 
-// Session state auto-saved! Includes extracted data
-console.log("Extracted:", response.session?.extracted);
+// Session step auto-saved! Includes collected data
+console.log("Data:", response.session?.data);
 ```
 
 ## 🔌 Optional Dependencies
@@ -206,18 +206,18 @@ export class MyCustomAdapter implements PersistenceAdapter {
 
 All adapters are fully typed with **zero `any` types** (except for Prisma's dynamic model access):
 
-- Generic client interfaces with `SessionState<TExtracted>` support
+- Generic client interfaces with `SessionStep<TData>` support
 - Typed repository methods
 - Full IDE autocomplete
 - Type-safe data extraction throughout
 
 ## 💾 What Gets Stored
 
-All adapters store session state in the `collectedData` JSON field:
+All adapters store session step in the `collectedData` JSON field:
 
 ```json
 {
-  "extracted": {
+  "data": {
     "destination": "Paris",
     "departureDate": "2025-06-15",
     "passengers": 2
@@ -230,7 +230,7 @@ All adapters store session state in the `collectedData` JSON field:
     }
   ],
   "currentRouteTitle": "Book a Flight",
-  "currentStateDescription": "Ask about travel dates",
+  "currentStepDescription": "Ask about travel dates",
   "metadata": {
     "sessionId": "session_123",
     "createdAt": "2025-10-15T10:00:00Z",
@@ -241,8 +241,8 @@ All adapters store session state in the `collectedData` JSON field:
 
 This allows:
 
-- ✅ Full session state recovery
-- ✅ Analytics on extracted data
+- ✅ Full session step recovery
+- ✅ Analytics on collected data
 - ✅ Conversation progress tracking
 - ✅ Multi-turn conversation support