@falai/agent 0.1.3 → 0.1.5

package/README.md

@@ -103,6 +103,7 @@ interface SupportContext {
 // 2️⃣ Create AI provider (choose one)
 const ai = new GeminiProvider({
   apiKey: process.env.GEMINI_API_KEY!,
+  model: "models/gemini-2.5-flash",
 });
 
 // Or use OpenAI:
@@ -236,6 +237,7 @@ const fetchUserProfile = defineTool<
     return { data: profile };
   },
   {
+    id: "tool_fetch_user_profile", // Optional: custom ID for persistence
     description: "Retrieves user profile information from the database",
   }
 );
@@ -261,6 +263,7 @@ const agent = new Agent({
   ai: provider,
   routes: [
     {
+      id: "route_user_onboarding", // Optional: custom ID for consistency
       title: "User Onboarding",
       description: "Guide new users through account setup",
       conditions: ["User is new and needs onboarding"],
@@ -277,6 +280,7 @@ const agent = new Agent({
 
 // Option B: Programmatic (build flows dynamically)
 const onboardingRoute = agent.createRoute({
+  id: "route_user_onboarding", // Optional: custom ID
   title: "User Onboarding",
   description: "Guide new users through account setup",
   conditions: ["User is new and needs onboarding"],
@@ -324,14 +328,20 @@ const agent = new Agent({
   name: "HealthBot",
   ai: provider,
   routes: [
-    { title: "Schedule Appointment", conditions: ["User wants to schedule"] },
     {
+      id: "route_schedule", // Custom ID
+      title: "Schedule Appointment",
+      conditions: ["User wants to schedule"],
+    },
+    {
+      id: "route_reschedule", // Custom ID
       title: "Reschedule Appointment",
       conditions: ["User wants to reschedule"],
     },
   ],
   observations: [
     {
+      id: "obs_appointment_intent", // Custom ID for tracking
       description: "User mentions appointment but intent is unclear",
       routeRefs: ["Schedule Appointment", "Reschedule Appointment"], // By title
     },
@@ -340,11 +350,13 @@ const agent = new Agent({
 
 // Option B: Programmatic
 const scheduleRoute = agent.createRoute({
+  id: "route_schedule", // Custom ID
   title: "Schedule Appointment",
   conditions: ["User wants to schedule"],
 });
 
 const rescheduleRoute = agent.createRoute({
+  id: "route_reschedule", // Custom ID
   title: "Reschedule Appointment",
   conditions: ["User wants to reschedule"],
 });
@@ -388,6 +400,49 @@ agent
   });
 ```
 
+### 🆔 Deterministic IDs & Persistence
+
+All entities (routes, states, observations, tools) have **deterministic IDs** by default, ensuring consistency across server restarts:
+
+```typescript
+import {
+  generateRouteId,
+  generateToolId,
+  generateObservationId,
+} from "@falai/agent";
+
+// Auto-generated deterministic IDs (recommended)
+const route = agent.createRoute({
+  title: "User Onboarding",
+  // ID will be: route_user_onboarding_{hash}
+});
+
+// Or provide custom IDs when you need specific control
+const route = agent.createRoute({
+  id: "my_custom_route_id", // Custom ID for database persistence
+  title: "User Onboarding",
+});
+
+// Generate IDs manually if needed
+const routeId = generateRouteId("User Onboarding");
+const toolId = generateToolId("fetch_user_data");
+
+// Custom timestamps for events (useful for historical data)
+const event = createMessageEvent(
+  EventSource.CUSTOMER,
+  "Alice",
+  "Hello!",
+  "2025-10-13T10:30:00Z" // Optional: custom timestamp
+);
+```
+
+**Why this matters:**
+
+- ✅ **Database Safe** - Store IDs in your database without worrying about changes
+- ✅ **Analytics Ready** - Track metrics and user journeys reliably
+- ✅ **Multi-Instance** - Deploy multiple server instances with consistent IDs
+- ✅ **Migration Friendly** - IDs remain stable during deployments
+
 ### ⚙️ Advanced Configuration
 
 Fine-tune AI provider behavior - works with both Gemini and OpenAI:

package/dist/cjs/constants/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Special marker to end a route/journey
+ */
+export declare const END_ROUTE: unique symbol;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,SAAS,eAAsB,CAAC"}

package/dist/cjs/constants/index.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Special marker to end a route/journey
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.END_ROUTE = void 0;
+exports.END_ROUTE = Symbol("END_ROUTE");
+//# sourceMappingURL=index.js.map

package/dist/cjs/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEU,QAAA,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC"}

package/dist/cjs/core/Agent.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Core Agent implementation
+ */
+import type { AgentOptions, Term, Guideline, Capability } from "../types/agent";
+import type { Event, StateRef } from "../types/index";
+import type { RouteOptions } from "../types/route";
+import { Route } from "./Route";
+import { DomainRegistry } from "./DomainRegistry";
+import { Observation } from "./Observation";
+/**
+ * Main Agent class with generic context support
+ */
+export declare class Agent<TContext = unknown> {
+    private readonly options;
+    private terms;
+    private guidelines;
+    private capabilities;
+    private routes;
+    private observations;
+    private domainRegistry;
+    /**
+     * Dynamic domain property - populated via addDomain
+     */
+    readonly domain: Record<string, Record<string, unknown>>;
+    constructor(options: AgentOptions<TContext>);
+    /**
+     * Get agent name
+     */
+    get name(): string;
+    /**
+     * Get agent description
+     */
+    get description(): string | undefined;
+    /**
+     * Get agent goal
+     */
+    get goal(): string | undefined;
+    /**
+     * Create a new route (journey)
+     */
+    createRoute(options: RouteOptions): Route<TContext>;
+    /**
+     * Create a domain term for the glossary
+     */
+    createTerm(term: Term): this;
+    /**
+     * Create a behavioral guideline
+     */
+    createGuideline(guideline: Guideline): this;
+    /**
+     * Add a capability
+     */
+    createCapability(capability: Capability): this;
+    /**
+     * Create an observation for disambiguation
+     */
+    createObservation(description: string): Observation;
+    /**
+     * Add a domain with its tools/methods
+     */
+    addDomain<TName extends string, TDomain extends Record<string, unknown>>(name: TName, domainObject: TDomain): void;
+    /**
+     * Generate a response based on history and context
+     */
+    respond(params: {
+        history: Event[];
+        state?: StateRef;
+        contextOverride?: Partial<TContext>;
+        signal?: AbortSignal;
+    }): Promise<{
+        message: string;
+        route?: {
+            id: string;
+            title: string;
+        } | null;
+        state?: {
+            id: string;
+            description?: string;
+        } | null;
+        toolCalls?: Array<{
+            toolName: string;
+            arguments: Record<string, unknown>;
+        }>;
+    }>;
+    /**
+     * Get all routes
+     */
+    getRoutes(): Route<TContext>[];
+    /**
+     * Get all terms
+     */
+    getTerms(): Term[];
+    /**
+     * Get all guidelines
+     */
+    getGuidelines(): Guideline[];
+    /**
+     * Get all capabilities
+     */
+    getCapabilities(): Capability[];
+    /**
+     * Get all observations
+     */
+    getObservations(): Observation[];
+    /**
+     * Get the domain registry
+     */
+    getDomainRegistry(): DomainRegistry;
+}
+//# sourceMappingURL=Agent.d.ts.map

package/dist/cjs/core/Agent.d.ts.map

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

package/dist/cjs/core/Agent.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * Core Agent implementation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+const Route_1 = require("./Route");
+const DomainRegistry_1 = require("./DomainRegistry");
+const PromptBuilder_1 = require("./PromptBuilder");
+const Observation_1 = require("./Observation");
+/**
+ * Main Agent class with generic context support
+ */
+class Agent {
+    constructor(options) {
+        this.options = options;
+        this.terms = [];
+        this.guidelines = [];
+        this.capabilities = [];
+        this.routes = [];
+        this.observations = [];
+        this.domainRegistry = new DomainRegistry_1.DomainRegistry();
+        /**
+         * Dynamic domain property - populated via addDomain
+         */
+        this.domain = {};
+        // Initialize with default values
+        if (!this.options.maxEngineIterations) {
+            this.options.maxEngineIterations = 1;
+        }
+        // Initialize from options
+        if (options.terms) {
+            this.terms = [...options.terms];
+        }
+        if (options.guidelines) {
+            options.guidelines.forEach((guideline) => {
+                this.createGuideline(guideline);
+            });
+        }
+        if (options.capabilities) {
+            options.capabilities.forEach((capability) => {
+                this.createCapability(capability);
+            });
+        }
+        if (options.routes) {
+            options.routes.forEach((routeOptions) => {
+                this.createRoute(routeOptions);
+            });
+        }
+        if (options.observations) {
+            options.observations.forEach((obsOptions) => {
+                const obs = this.createObservation(obsOptions.description);
+                // If route refs were provided, resolve and disambiguate
+                if (obsOptions.routeRefs && obsOptions.routeRefs.length > 0) {
+                    const resolvedRoutes = obsOptions.routeRefs
+                        .map((ref) => {
+                        // Try to find route by ID or title
+                        return this.routes.find((r) => r.id === ref || r.title === ref);
+                    })
+                        .filter((r) => r !== undefined);
+                    if (resolvedRoutes.length > 0) {
+                        obs.disambiguate(resolvedRoutes);
+                    }
+                }
+            });
+        }
+    }
+    /**
+     * Get agent name
+     */
+    get name() {
+        return this.options.name;
+    }
+    /**
+     * Get agent description
+     */
+    get description() {
+        return this.options.description;
+    }
+    /**
+     * Get agent goal
+     */
+    get goal() {
+        return this.options.goal;
+    }
+    /**
+     * Create a new route (journey)
+     */
+    createRoute(options) {
+        const route = new Route_1.Route(options);
+        this.routes.push(route);
+        return route;
+    }
+    /**
+     * Create a domain term for the glossary
+     */
+    createTerm(term) {
+        this.terms.push(term);
+        return this;
+    }
+    /**
+     * Create a behavioral guideline
+     */
+    createGuideline(guideline) {
+        const guidelineWithId = {
+            ...guideline,
+            id: guideline.id || `guideline_${this.guidelines.length}`,
+            enabled: guideline.enabled !== false, // Default to true
+        };
+        this.guidelines.push(guidelineWithId);
+        return this;
+    }
+    /**
+     * Add a capability
+     */
+    createCapability(capability) {
+        const capabilityWithId = {
+            ...capability,
+            id: capability.id || `capability_${this.capabilities.length}`,
+        };
+        this.capabilities.push(capabilityWithId);
+        return this;
+    }
+    /**
+     * Create an observation for disambiguation
+     */
+    createObservation(description) {
+        const observation = new Observation_1.Observation({ description });
+        this.observations.push(observation);
+        return observation;
+    }
+    /**
+     * Add a domain with its tools/methods
+     */
+    addDomain(name, domainObject) {
+        this.domainRegistry.register(name, domainObject);
+        // Attach to the domain property for easy access
+        this.domain[name] = domainObject;
+    }
+    /**
+     * Generate a response based on history and context
+     */
+    async respond(params) {
+        const { history, contextOverride, signal } = params;
+        // Merge context
+        const effectiveContext = {
+            ...this.options.context,
+            ...contextOverride,
+        };
+        // Build prompt
+        const promptBuilder = new PromptBuilder_1.PromptBuilder();
+        // Add agent identity
+        if (this.options.description) {
+            promptBuilder.addAgentIdentity({
+                name: this.options.name,
+                description: this.options.description,
+            });
+        }
+        // Add interaction history
+        promptBuilder.addInteractionHistoryForMessageGeneration(history);
+        // Add glossary
+        if (this.terms.length > 0) {
+            promptBuilder.addGlossary(this.terms);
+        }
+        // Add guidelines (convert to GuidelineMatch format, filter enabled only)
+        const enabledGuidelines = this.guidelines.filter((g) => g.enabled !== false);
+        if (enabledGuidelines.length > 0) {
+            const guidelineMatches = enabledGuidelines.map((g) => ({
+                guideline: g,
+            }));
+            promptBuilder.addGuidelinesForMessageGeneration(guidelineMatches);
+        }
+        // Add capabilities
+        if (this.capabilities.length > 0) {
+            promptBuilder.addCapabilitiesForMessageGeneration(this.capabilities);
+        }
+        // Add observations
+        if (this.observations.length > 0) {
+            const observationsWithRoutes = this.observations
+                .map((obs) => ({
+                description: obs.description,
+                routes: obs.getRoutes().map((routeRef) => {
+                    const route = this.routes.find((r) => r.id === routeRef.id);
+                    return { title: route?.title || routeRef.id };
+                }),
+            }))
+                .filter((obs) => obs.routes.length > 0);
+            if (observationsWithRoutes.length > 0) {
+                promptBuilder.addObservations(observationsWithRoutes);
+            }
+        }
+        // Add active routes
+        if (this.routes.length > 0) {
+            promptBuilder.addActiveRoutes(this.routes.map((r) => ({
+                title: r.title,
+                description: r.description,
+                conditions: r.conditions,
+            })));
+        }
+        // Add JSON response schema instructions
+        promptBuilder.addJsonResponseSchema();
+        // Build final prompt
+        const prompt = promptBuilder.build();
+        // Generate message using AI provider with JSON mode enabled
+        const result = await this.options.ai.generateMessage({
+            prompt,
+            history,
+            context: effectiveContext,
+            signal,
+            parameters: {
+                jsonMode: true,
+            },
+        });
+        // Parse structured response
+        let message = result.message;
+        let route = null;
+        let state = null;
+        let toolCalls;
+        if (result.structured) {
+            // Extract data from structured response
+            message = result.structured.message || message;
+            // Find route by title
+            if (result.structured.route) {
+                const foundRoute = this.routes.find((r) => r.title === result.structured?.route);
+                if (foundRoute) {
+                    route = {
+                        id: foundRoute.id,
+                        title: foundRoute.title,
+                    };
+                }
+            }
+            // Create state reference if provided
+            if (result.structured.state) {
+                state = {
+                    id: "dynamic_state",
+                    description: result.structured.state,
+                };
+            }
+            // Extract tool calls
+            if (result.structured.toolCalls &&
+                result.structured.toolCalls.length > 0) {
+                toolCalls = result.structured.toolCalls;
+            }
+        }
+        return {
+            message,
+            route: route || undefined,
+            state: state || undefined,
+            toolCalls,
+        };
+    }
+    /**
+     * Get all routes
+     */
+    getRoutes() {
+        return [...this.routes];
+    }
+    /**
+     * Get all terms
+     */
+    getTerms() {
+        return [...this.terms];
+    }
+    /**
+     * Get all guidelines
+     */
+    getGuidelines() {
+        return [...this.guidelines];
+    }
+    /**
+     * Get all capabilities
+     */
+    getCapabilities() {
+        return [...this.capabilities];
+    }
+    /**
+     * Get all observations
+     */
+    getObservations() {
+        return [...this.observations];
+    }
+    /**
+     * Get the domain registry
+     */
+    getDomainRegistry() {
+        return this.domainRegistry;
+    }
+}
+exports.Agent = Agent;
+//# sourceMappingURL=Agent.js.map

package/dist/cjs/core/Agent.js.map

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

package/dist/cjs/core/DomainRegistry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Domain registry for organizing agent capabilities by domain
+ */
+/**
+ * Registry that holds domain-specific tools and methods
+ */
+export declare class DomainRegistry {
+    private domains;
+    /**
+     * Register a new domain with its methods/tools
+     */
+    register<TDomain extends Record<string, unknown>>(name: string, domain: TDomain): void;
+    /**
+     * Get a registered domain
+     */
+    get<TDomain extends Record<string, unknown>>(name: string): TDomain | undefined;
+    /**
+     * Check if a domain is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered domains as a single object
+     */
+    all(): Record<string, Record<string, unknown>>;
+}
+//# sourceMappingURL=DomainRegistry.d.ts.map

package/dist/cjs/core/DomainRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/DomainRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAmD;IAElE;;OAEG;IACH,QAAQ,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,IAAI;IAOP;;OAEG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,MAAM,GACX,OAAO,GAAG,SAAS;IAItB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAO/C"}

package/dist/cjs/core/DomainRegistry.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Domain registry for organizing agent capabilities by domain
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainRegistry = void 0;
+/**
+ * Registry that holds domain-specific tools and methods
+ */
+class DomainRegistry {
+    constructor() {
+        this.domains = new Map();
+    }
+    /**
+     * Register a new domain with its methods/tools
+     */
+    register(name, domain) {
+        if (this.domains.has(name)) {
+            throw new Error(`Domain "${name}" is already registered`);
+        }
+        this.domains.set(name, domain);
+    }
+    /**
+     * Get a registered domain
+     */
+    get(name) {
+        return this.domains.get(name);
+    }
+    /**
+     * Check if a domain is registered
+     */
+    has(name) {
+        return this.domains.has(name);
+    }
+    /**
+     * Get all registered domains as a single object
+     */
+    all() {
+        const result = {};
+        for (const [name, domain] of this.domains) {
+            result[name] = domain;
+        }
+        return result;
+    }
+}
+exports.DomainRegistry = DomainRegistry;
+//# sourceMappingURL=DomainRegistry.js.map

package/dist/cjs/core/DomainRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainRegistry.js","sourceRoot":"","sources":["../../../src/core/DomainRegistry.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,MAAa,cAAc;IAA3B;QACU,YAAO,GAAyC,IAAI,GAAG,EAAE,CAAC;IAyCpE,CAAC;IAvCC;;OAEG;IACH,QAAQ,CACN,IAAY,EACZ,MAAe;QAEf,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,yBAAyB,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,GAAG,CACD,IAAY;QAEZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAwB,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,GAAG;QACD,MAAM,MAAM,GAA4C,EAAE,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACxB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA1CD,wCA0CC"}

package/dist/cjs/core/Events.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Event utilities and helpers
+ */
+import type { Event, EmittedEvent, MessageEventData, ToolEventData, ToolCall } from "../types/history";
+import { EventSource } from "../types/history";
+/**
+ * Adapt an event for inclusion in prompts
+ * Transforms event data into a serializable format
+ */
+export declare function adaptEvent(e: Event | EmittedEvent): string;
+/**
+ * Create a message event
+ */
+export declare function createMessageEvent(source: EventSource, participantName: string, message: string, timestamp?: string): Event<MessageEventData>;
+/**
+ * Create a tool event
+ */
+export declare function createToolEvent(source: EventSource, toolCalls: ToolCall[], timestamp?: string): Event<ToolEventData>;
+//# sourceMappingURL=Events.d.ts.map

package/dist/cjs/core/Events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Events.d.ts","sourceRoot":"","sources":["../../../src/core/Events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAa,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,MAAM,CA+C1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,KAAK,CAAC,gBAAgB,CAAC,CAUzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,QAAQ,EAAE,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,KAAK,CAAC,aAAa,CAAC,CAStB"}