@falai/agent 0.8.0 → 0.9.0-alpha-1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAOtB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAQrB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAO1B,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAOtB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}

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

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

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

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

package/dist/{core → cjs/src/core}/Agent.d.ts

@@ -1,13 +1,10 @@
 /**
  * Core Agent implementation
  */
-import type { AgentOptions, Term, Guideline, Capability } from "../types/agent";
-import type { Event, StepRef } from "../types/index";
-import type { RouteOptions } from "../types/route";
-import type { SessionStep } from "../types/session";
+import type { AgentOptions, Term, Guideline, Tool, Event, RouteOptions, SessionState, Template, StepRef, History, AgentResponseStreamChunk, AgentResponse } from "../types";
 import { Route } from "./Route";
-import { DomainRegistry } from "./DomainRegistry";
 import { PersistenceManager } from "./PersistenceManager";
+import { SessionManager } from "./SessionManager";
 /**
  * Main Agent class with generic context support
  */
@@ -15,18 +12,17 @@ export declare class Agent<TContext = unknown> {
     private readonly options;
     private terms;
     private guidelines;
-    private capabilities;
+    private tools;
     private routes;
-    private domainRegistry;
     private context;
     private persistenceManager;
     private routingEngine;
     private responseEngine;
+    private responsePipeline;
     private currentSession?;
-    /**
-     * Dynamic domain property - populated via addDomain
-     */
-    readonly domain: Record<string, Record<string, unknown>>;
+    private knowledgeBase;
+    /** Public session manager for easy session management */
+    session: SessionManager<unknown>;
     constructor(options: AgentOptions<TContext>);
     /**
      * Get agent name
@@ -40,6 +36,10 @@ export declare class Agent<TContext = unknown> {
      * Get agent goal
      */
     get goal(): string | undefined;
+    /**
+     * Get agent identity
+     */
+    get identity(): Template<TContext> | undefined;
     /**
      * Create a new route (journey)
      * @template TData - Type of data collected throughout the route
@@ -48,74 +48,54 @@ export declare class Agent<TContext = unknown> {
     /**
      * Create a domain term for the glossary
      */
-    createTerm(term: Term): this;
+    createTerm(term: Term<TContext>): this;
     /**
      * Create a behavioral guideline
      */
-    createGuideline(guideline: Guideline): this;
+    createGuideline(guideline: Guideline<TContext>): this;
     /**
-     * Add a capability
+     * Register a tool at the agent level
      */
-    createCapability(capability: Capability): this;
+    createTool(tool: Tool<TContext, unknown[], unknown, unknown>): this;
     /**
-     * Add a domain with its tools/methods
-     * Automatically tags all ToolRef objects with their domain name for security enforcement
+     * Register multiple tools at the agent level
      */
-    addDomain<TName extends string, TDomain extends Record<string, unknown>>(name: TName, domainObject: TDomain): void;
+    registerTools(tools: Tool<TContext, unknown[], unknown, unknown>[]): this;
     /**
      * Update the agent's context
-     * Triggers the onContextUpdate lifecycle hook if configured
+     * Triggers both agent-level and route-specific onContextUpdate lifecycle hooks if configured
      */
     updateContext(updates: Partial<TContext>): Promise<void>;
     /**
      * Update collected data in session with lifecycle hook support
-     * Triggers the onDataUpdate lifecycle hook if configured
+     * Triggers both agent-level and route-specific onDataUpdate lifecycle hooks if configured
      * @internal
      */
     private updateData;
     /**
      * Get current context (fetches from provider if configured)
-     * @internal
      */
-    private getContext;
+    getContext(): Promise<TContext | undefined>;
     /**
      * Generate a response based on history and context as a stream
      */
-    respondStream(params: {
-        history: Event[];
+    respondStream<TData = Record<string, unknown>>(params: {
+        history: History;
         step?: StepRef;
-        session?: SessionStep;
+        session?: SessionState<TData>;
         contextOverride?: Partial<TContext>;
         signal?: AbortSignal;
-    }): AsyncGenerator<{
-        delta: string;
-        accumulated: string;
-        done: boolean;
-        session?: SessionStep;
-        toolCalls?: Array<{
-            toolName: string;
-            arguments: Record<string, unknown>;
-        }>;
-        isRouteComplete?: boolean;
-    }>;
+    }): AsyncGenerator<AgentResponseStreamChunk<TData>>;
     /**
      * Generate a response based on history and context
      */
-    respond(params: {
-        history: Event[];
+    respond<TData = Record<string, unknown>>(params: {
+        history: History;
         step?: StepRef;
-        session?: SessionStep;
+        session?: SessionState<TData>;
         contextOverride?: Partial<TContext>;
         signal?: AbortSignal;
-    }): Promise<{
-        message: string;
-        session?: SessionStep;
-        toolCalls?: Array<{
-            toolName: string;
-            arguments: Record<string, unknown>;
-        }>;
-        isRouteComplete?: boolean;
-    }>;
+    }): Promise<AgentResponse<TData>>;
     /**
      * Get all routes
      */
@@ -123,19 +103,40 @@ export declare class Agent<TContext = unknown> {
     /**
      * Get all terms
      */
-    getTerms(): Term[];
+    getTerms(): Term<TContext>[];
+    /**
+     * Get all tools
+     */
+    getTools(): Tool<TContext, unknown[], unknown, unknown>[];
+    /**
+     * Find an available tool by name for the given route
+     * Route-level tools take precedence over agent-level tools
+     * @private
+     */
+    private findAvailableTool;
+    /**
+     * Collect all available tools for the given route and step context
+     * @private
+     */
+    private collectAvailableTools;
+    /**
+     * Execute a prepare or finalize function/tool
+     * @private
+     */
+    private executePrepareFinalize;
     /**
      * Get all guidelines
      */
-    getGuidelines(): Guideline[];
+    getGuidelines(): Guideline<TContext>[];
     /**
-     * Get all capabilities
+     * Get the agent's knowledge base
      */
-    getCapabilities(): Capability[];
+    getKnowledgeBase(): Record<string, unknown>;
     /**
-     * Get the domain registry
+     * Merge terms with route-specific taking precedence on conflicts
+     * @private
      */
-    getDomainRegistry(): DomainRegistry;
+    private mergeTerms;
     /**
      * Get the persistence manager (if configured)
      */
@@ -144,27 +145,15 @@ export declare class Agent<TContext = unknown> {
      * Check if persistence is enabled
      */
     hasPersistence(): boolean;
-    /**
-     * Get allowed domains for a specific route
-     * @param routeId - Route ID to check
-     * @returns Filtered domains object, or all domains if route has no restrictions
-     */
-    getDomainsForRoute(routeId: string): Record<string, Record<string, unknown>>;
-    /**
-     * Get allowed domains for a specific route by title
-     * @param routeTitle - Route title to check
-     * @returns Filtered domains object, or all domains if route has no restrictions
-     */
-    getDomainsForRouteByTitle(routeTitle: string): Record<string, Record<string, unknown>>;
     /**
      * Set the current session for convenience methods
      * @param session - Session step to use for subsequent calls
      */
-    setCurrentSession(session: SessionStep): void;
+    setCurrentSession(session: SessionState): void;
     /**
      * Get the current session (if set)
      */
-    getCurrentSession(): SessionStep | undefined;
+    getCurrentSession(): SessionState | undefined;
     /**
      * Clear the current session
      */
@@ -192,6 +181,15 @@ export declare class Agent<TContext = unknown> {
      *   const nextResponse = await agent.respond({ history, session: updatedSession });
      * }
      */
-    nextStepRoute(routeIdOrTitle: string, session?: SessionStep, condition?: string): SessionStep;
+    nextStepRoute(routeIdOrTitle: string, session?: SessionState, condition?: Template<TContext, unknown>, history?: Event[]): Promise<SessionState>;
+    /**
+     * Simplified respond method using SessionManager
+     * Automatically manages conversation history through the session
+     */
+    chat<TData = Record<string, unknown>>(message?: string, options?: {
+        history?: History;
+        contextOverride?: Partial<TContext>;
+        signal?: AbortSignal;
+    }): Promise<AgentResponse<TData>>;
 }
 //# sourceMappingURL=Agent.d.ts.map

package/dist/cjs/src/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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"}