@falai/agent 0.6.8 → 0.7.0

package/src/adapters/OpenSearchAdapter.ts

@@ -191,7 +191,7 @@ export class OpenSearchAdapter implements PersistenceAdapter {
               agentName: { type: "keyword" },
               status: { type: "keyword" },
               currentRoute: { type: "keyword" },
-              currentState: { type: "keyword" },
+              currentStep: { type: "keyword" },
               collectedData: { type: "object", enabled: false },
               messageCount: { type: "integer" },
               createdAt: { type: "date" },
@@ -221,7 +221,7 @@ export class OpenSearchAdapter implements PersistenceAdapter {
               role: { type: "keyword" },
               content: { type: "text" },
               route: { type: "keyword" },
-              state: { type: "keyword" },
+              step: { type: "keyword" },
               toolCalls: { type: "object", enabled: false },
               event: { type: "object", enabled: false },
               createdAt: { type: "date" },
@@ -396,10 +396,10 @@ class OpenSearchSessionRepository implements SessionRepository {
     return await this.findById(id);
   }
 
-  async updateRouteState(
+  async updateRouteStep(
     id: string,
     route?: string,
-    state?: string
+    step?: string
   ): Promise<SessionData | null> {
     const doc: Record<string, unknown> = {
       updatedAt: new Date().toISOString(),
@@ -408,8 +408,8 @@ class OpenSearchSessionRepository implements SessionRepository {
     if (route !== undefined) {
       doc.currentRoute = route;
     }
-    if (state !== undefined) {
-      doc.currentState = state;
+    if (step !== undefined) {
+      doc.currentStep = step;
     }
 
     await this.client.update({
@@ -478,7 +478,7 @@ class OpenSearchSessionRepository implements SessionRepository {
       agentName: doc.agentName as string | undefined,
       status: doc.status as SessionData["status"],
       currentRoute: doc.currentRoute as string | undefined,
-      currentState: doc.currentState as string | undefined,
+      currentStep: doc.currentStep as string | undefined,
       collectedData: doc.collectedData as Record<string, unknown> | undefined,
       messageCount: doc.messageCount as number | undefined,
       createdAt: new Date(doc.createdAt as string),
@@ -646,7 +646,7 @@ class OpenSearchMessageRepository implements MessageRepository {
       role: doc.role as MessageData["role"],
       content: doc.content as string,
       route: doc.route as string | undefined,
-      state: doc.state as string | undefined,
+      step: doc.step as string | undefined,
       toolCalls: doc.toolCalls as
         | Array<{ toolName: string; arguments: Record<string, unknown> }>
         | undefined,

package/src/adapters/PostgreSQLAdapter.ts

@@ -110,7 +110,7 @@ export class PostgreSQLAdapter implements PersistenceAdapter {
         agent_name VARCHAR(255),
         status VARCHAR(50) DEFAULT 'active',
         current_route VARCHAR(255),
-        current_state VARCHAR(255),
+        current_step VARCHAR(255),
         collected_data JSONB,
         message_count INTEGER DEFAULT 0,
         last_message_at TIMESTAMP,
@@ -133,7 +133,7 @@ export class PostgreSQLAdapter implements PersistenceAdapter {
         role VARCHAR(50) NOT NULL,
         content TEXT NOT NULL,
         route VARCHAR(255),
-        state VARCHAR(255),
+        step VARCHAR(255),
         tool_calls JSONB,
         event JSONB,
         created_at TIMESTAMP DEFAULT NOW(),
@@ -237,9 +237,9 @@ class PostgreSQLSessionRepository implements SessionRepository {
       fields.push(`current_route = $${paramIndex++}`);
       values.push(data.currentRoute);
     }
-    if (data.currentState !== undefined) {
-      fields.push(`current_state = $${paramIndex++}`);
-      values.push(data.currentState);
+    if (data.currentStep !== undefined) {
+      fields.push(`current_step = $${paramIndex++}`);
+      values.push(data.currentStep);
     }
     if (data.messageCount !== undefined) {
       fields.push(`message_count = $${paramIndex++}`);
@@ -285,14 +285,14 @@ class PostgreSQLSessionRepository implements SessionRepository {
     return await this.update(id, { collectedData });
   }
 
-  async updateRouteState(
+  async updateRouteStep(
     id: string,
     route?: string,
-    state?: string
+    step?: string
   ): Promise<SessionData | null> {
     return await this.update(id, {
       currentRoute: route,
-      currentState: state,
+      currentStep: step,
     });
   }
 
@@ -333,7 +333,7 @@ class PostgreSQLMessageRepository implements MessageRepository {
 
     const result = await this.client.query<MessageData>(
       `INSERT INTO ${this.tableName}
-       (id, session_id, user_id, role, content, route, state, tool_calls, event, created_at)
+       (id, session_id, user_id, role, content, route, step, tool_calls, event, created_at)
        VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, NOW())
        RETURNING *`,
       [
@@ -343,7 +343,7 @@ class PostgreSQLMessageRepository implements MessageRepository {
         data.role,
         data.content,
         data.route || null,
-        data.state || null,
+        data.step || null,
         JSON.stringify(data.toolCalls || null),
         JSON.stringify(data.event || null),
       ]

package/src/adapters/PrismaAdapter.ts

@@ -333,10 +333,10 @@ class PrismaSessionRepository implements SessionRepository {
     return this.unmapFields(result);
   }
 
-  async updateRouteState(
+  async updateRouteStep(
     id: string,
     route?: string,
-    state?: string
+    step?: string
   ): Promise<SessionData | null> {
     const data: Record<string, unknown> = {
       [this.fieldMap.updatedAt || "updatedAt"]: new Date(),
@@ -344,8 +344,8 @@ class PrismaSessionRepository implements SessionRepository {
     if (route !== undefined) {
       data[this.fieldMap.currentRoute || "currentRoute"] = route;
     }
-    if (state !== undefined) {
-      data[this.fieldMap.currentState || "currentState"] = state;
+    if (step !== undefined) {
+      data[this.fieldMap.currentStep || "currentStep"] = step;
     }
     const result = await this.getModel().update({
       where: { [this.fieldMap.id || "id"]: id },

package/src/adapters/RedisAdapter.ts

@@ -223,12 +223,12 @@ class RedisSessionRepository implements SessionRepository {
     return this.update(id, { collectedData });
   }
 
-  async updateRouteState(
+  async updateRouteStep(
     id: string,
     route?: string,
-    state?: string
+    step?: string
   ): Promise<SessionData | null> {
-    return this.update(id, { currentRoute: route, currentState: state });
+    return this.update(id, { currentRoute: route, currentStep: step });
   }
 
   async incrementMessageCount(id: string): Promise<SessionData | null> {

package/src/adapters/SQLiteAdapter.ts

@@ -16,15 +16,15 @@ import type {
  * SQLite database interface - matches better-sqlite3
  */
 export interface SqliteDatabase {
-  prepare(sql: string): SqliteStatement;
+  prepare(sql: string): SqliteStepment;
   exec(sql: string): void;
   close(): void;
 }
 
 /**
- * SQLite statement interface
+ * SQLite stepment interface
  */
-export interface SqliteStatement {
+export interface SqliteStepment {
   run(...params: unknown[]): { changes: number; lastInsertRowid: number };
   get(...params: unknown[]): Record<string, unknown> | undefined;
   all(...params: unknown[]): Array<Record<string, unknown>>;
@@ -95,7 +95,7 @@ export class SQLiteAdapter implements PersistenceAdapter {
         agent_name TEXT,
         status TEXT DEFAULT 'active',
         current_route TEXT,
-        current_state TEXT,
+        current_step TEXT,
         collected_data TEXT,
         message_count INTEGER DEFAULT 0,
         last_message_at TEXT,
@@ -120,7 +120,7 @@ export class SQLiteAdapter implements PersistenceAdapter {
         role TEXT NOT NULL,
         content TEXT NOT NULL,
         route TEXT,
-        state TEXT,
+        step TEXT,
         tool_calls TEXT,
         event TEXT,
         created_at TEXT NOT NULL,
@@ -232,9 +232,9 @@ class SQLiteSessionRepository implements SessionRepository {
       fields.push("current_route = ?");
       values.push(data.currentRoute);
     }
-    if (data.currentState !== undefined) {
-      fields.push("current_state = ?");
-      values.push(data.currentState);
+    if (data.currentStep !== undefined) {
+      fields.push("current_step = ?");
+      values.push(data.currentStep);
     }
     if (data.messageCount !== undefined) {
       fields.push("message_count = ?");
@@ -281,14 +281,14 @@ class SQLiteSessionRepository implements SessionRepository {
     return await this.update(id, { collectedData });
   }
 
-  async updateRouteState(
+  async updateRouteStep(
     id: string,
     route?: string,
-    state?: string
+    step?: string
   ): Promise<SessionData | null> {
     return await this.update(id, {
       currentRoute: route,
-      currentState: state,
+      currentStep: step,
     });
   }
 
@@ -321,7 +321,7 @@ class SQLiteSessionRepository implements SessionRepository {
       agentName: (row.agent_name as string) || undefined,
       status: row.status as SessionStatus,
       currentRoute: (row.current_route as string) || undefined,
-      currentState: (row.current_state as string) || undefined,
+      currentStep: (row.current_step as string) || undefined,
       collectedData: row.collected_data
         ? (JSON.parse(row.collected_data as string) as Record<string, unknown>)
         : undefined,
@@ -356,7 +356,7 @@ class SQLiteMessageRepository implements MessageRepository {
 
     const stmt = this.db.prepare(`
       INSERT INTO ${this.tableName}
-      (id, session_id, user_id, role, content, route, state, tool_calls, event, created_at)
+      (id, session_id, user_id, role, content, route, step, tool_calls, event, created_at)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
 
@@ -367,7 +367,7 @@ class SQLiteMessageRepository implements MessageRepository {
       data.role,
       data.content,
       data.route || null,
-      data.state || null,
+      data.step || null,
       JSON.stringify(data.toolCalls || null),
       JSON.stringify(data.event || null),
       now.toISOString()
@@ -436,7 +436,7 @@ class SQLiteMessageRepository implements MessageRepository {
       role: row.role as MessageData["role"],
       content: row.content as string,
       route: (row.route as string) || undefined,
-      state: (row.state as string) || undefined,
+      step: (row.step as string) || undefined,
       toolCalls: row.tool_calls
         ? (JSON.parse(row.tool_calls as string) as MessageData["toolCalls"])
         : undefined,

package/src/adapters/index.ts

@@ -30,7 +30,7 @@ export type {
 export { SQLiteAdapter } from "./SQLiteAdapter";
 export type {
   SqliteDatabase,
-  SqliteStatement,
+  SqliteStepment,
   SQLiteAdapterOptions,
 } from "./SQLiteAdapter";
 

package/src/constants/index.ts

@@ -1,10 +1,10 @@
 /**
  * Special marker to end a route/journey
  */
-export const END_STATE = Symbol("END_STATE");
+export const END_ROUTE = Symbol("END_ROUTE");
 
 /**
- * String constant for END_STATE comparisons
- * Use this when checking if currentState.id has reached END_STATE
+ * String constant for END_ROUTE comparisons
+ * Use this when checking if currentStep.id has reached END_ROUTE
  */
-export const END_STATE_ID = "END_STATE";
+export const END_ROUTE_ID = "END_ROUTE";