@falai/agent 0.8.0 → 0.9.0-alpha-1

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

@@ -2,32 +2,48 @@
  * Persistence-related type definitions
  * Support for optional database persistence (Prisma, etc.)
  */
-import type { Event } from "./history";
+import type { Event, MessageRole } from "./history";
+import type { SessionState } from "./session";
 /**
  * Session status enum
  */
 export type SessionStatus = "active" | "completed" | "abandoned";
-/**
- * Message role enum
- */
-export type MessageRole = "user" | "agent" | "system";
 /**
  * Base session data structure
  */
-export interface SessionData {
+export interface SessionData<TData = Record<string, unknown>> {
     id: string;
     userId?: string;
     agentName?: string;
     status: SessionStatus;
     currentRoute?: string;
     currentStep?: string;
-    collectedData?: Record<string, unknown>;
+    collectedData?: CollectedStateData<TData>;
     messageCount?: number;
     lastMessageAt?: Date;
     completedAt?: Date;
     createdAt: Date;
     updatedAt: Date;
 }
+/**
+ * Data for creating a new session (subset of SessionData)
+ */
+export type CreateSessionData<TData = Record<string, unknown>> = Omit<SessionData<TData>, "id" | "createdAt" | "updatedAt"> & {
+    id?: string;
+};
+/**
+ * Structure for data collected during a session that needs to be persisted.
+ * This is a subset of SessionState, stored within SessionData.
+ */
+export interface CollectedStateData<TData = Record<string, unknown>> {
+    data: Partial<TData>;
+    dataByRoute: Record<string, Partial<TData>>;
+    routeHistory: SessionState<TData>["routeHistory"];
+    history?: SessionState<TData>["history"];
+    currentRouteTitle?: string;
+    currentStepDescription?: string;
+    metadata: SessionState<TData>["metadata"];
+}
 /**
  * Base message data structure
  */
@@ -50,43 +66,43 @@ export interface MessageData {
  * Repository interface for sessions
  * Implement this interface with your database of choice
  */
-export interface SessionRepository {
+export interface SessionRepository<TData = Record<string, unknown>> {
     /**
      * Create a new session
      */
-    create(data: Omit<SessionData, "id" | "createdAt" | "updatedAt">): Promise<SessionData>;
+    create(data: CreateSessionData<TData>): Promise<SessionData<TData>>;
     /**
      * Find session by ID
      */
-    findById(id: string): Promise<SessionData | null>;
+    findById(id: string): Promise<SessionData<TData> | null>;
     /**
      * Find active session by user ID
      */
-    findActiveByUserId(userId: string): Promise<SessionData | null>;
+    findActiveByUserId(userId: string): Promise<SessionData<TData> | null>;
     /**
      * Find all sessions for a user
      */
-    findByUserId(userId: string, limit?: number): Promise<SessionData[]>;
+    findByUserId(userId: string, limit?: number): Promise<SessionData<TData>[]>;
     /**
      * Update session
      */
-    update(id: string, data: Partial<Omit<SessionData, "id" | "createdAt">>): Promise<SessionData | null>;
+    update(id: string, data: Partial<Omit<SessionData<TData>, "id" | "createdAt">>): Promise<SessionData<TData> | null>;
     /**
      * Update session status
      */
-    updateStatus(id: string, status: SessionStatus, completedAt?: Date): Promise<SessionData | null>;
+    updateStatus(id: string, status: SessionStatus, completedAt?: Date): Promise<SessionData<TData> | null>;
     /**
      * Update collected data
      */
-    updateCollectedData(id: string, collectedData: Record<string, unknown>): Promise<SessionData | null>;
+    updateCollectedData(id: string, collectedData: CollectedStateData<TData>): Promise<SessionData<TData> | null>;
     /**
      * Update current route and step
      */
-    updateRouteStep(id: string, route?: string, step?: string): Promise<SessionData | null>;
+    updateRouteStep(id: string, route?: string, step?: string): Promise<SessionData<TData> | null>;
     /**
      * Increment message count
      */
-    incrementMessageCount(id: string): Promise<SessionData | null>;
+    incrementMessageCount(id: string): Promise<SessionData<TData> | null>;
     /**
      * Delete session
      */
@@ -130,11 +146,11 @@ export interface MessageRepository {
  * Persistence adapter interface
  * Implement this to create adapters for different databases
  */
-export interface PersistenceAdapter {
+export interface PersistenceAdapter<TData = Record<string, unknown>> {
     /**
      * Session repository
      */
-    readonly sessionRepository: SessionRepository;
+    readonly sessionRepository: SessionRepository<TData>;
     /**
      * Message repository
      */
@@ -152,11 +168,11 @@ export interface PersistenceAdapter {
 /**
  * Configuration for persistence
  */
-export interface PersistenceConfig {
+export interface PersistenceConfig<TData = Record<string, unknown>> {
     /**
      * Persistence adapter instance (e.g., PrismaAdapter)
      */
-    adapter: PersistenceAdapter;
+    adapter: PersistenceAdapter<TData>;
     /**
      * Whether to auto-save messages (default: true)
      */
@@ -170,10 +186,10 @@ export interface PersistenceConfig {
 /**
  * Options for creating a session
  */
-export interface CreateSessionOptions {
+export interface CreateSessionOptions<TData = Record<string, unknown>> {
     userId?: string;
     agentName?: string;
-    initialData?: Record<string, unknown>;
+    initialData?: Partial<TData>;
 }
 /**
  * Options for saving a message

package/dist/src/types/persistence.d.ts.map

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

package/dist/src/types/persistence.js.map

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

package/dist/{types → src/types}/route.d.ts

@@ -1,8 +1,9 @@
 /**
  * Route/Journey DSL type definitions
  */
-import type { ToolRef, ToolResult } from "./tool";
+import type { Tool } from "./tool";
 import type { StructuredSchema } from "./schema";
+import { Template } from "./template";
 /**
  * Reference to a route
  */
@@ -20,17 +21,37 @@ export interface StepRef {
     routeId: string;
 }
 /**
- * Forward declare Guideline for circular dependency
+ * Forward declare Guideline and Term for circular dependency
  */
-import type { Guideline } from "./agent";
+import type { Guideline, Term } from "./agent";
+/**
+ * Route lifecycle hooks for managing route-specific data and behavior
+ */
+export interface RouteLifecycleHooks<TContext = unknown, TData = unknown> {
+    /**
+     * Called after collected data is updated for this route (from AI response or tool execution)
+     * Useful for validation, enrichment, or persistence of route-specific collected data
+     * Return modified collected data or the same data to keep it unchanged
+     *
+     * Unlike Agent-level onDataUpdate, this only triggers for data changes in this specific route.
+     */
+    onDataUpdate?: (data: Partial<TData>, previousCollected: Partial<TData>) => Partial<TData> | Promise<Partial<TData>>;
+    /**
+     * Called after context is updated via updateContext() when this route is active
+     * Useful for route-specific context reactions, validation, or side effects
+     *
+     * Unlike Agent-level onContextUpdate, this only triggers when this specific route is active.
+     */
+    onContextUpdate?: (newContext: TContext, previousContext: TContext) => void | Promise<void>;
+}
 /**
  * Route transition configuration when route completes
  */
-export interface RouteTransitionConfig {
+export interface RouteTransitionConfig<TContext = unknown, TData = unknown> {
     /** Target route ID or title to transition to */
     nextStep: string;
     /** Optional AI-evaluated condition for the transition */
-    condition?: string;
+    condition?: Template<TContext, TData>;
 }
 /**
  * Function type for dynamic route completion transitions
@@ -40,7 +61,7 @@ export interface RouteTransitionConfig {
  */
 export type RouteCompletionHandler<TContext = unknown, TData = unknown> = (session: {
     data?: Partial<TData>;
-}, context?: TContext) => string | RouteTransitionConfig | undefined | Promise<string | RouteTransitionConfig | undefined>;
+}, context?: TContext) => string | RouteTransitionConfig<TContext, TData> | undefined | Promise<string | RouteTransitionConfig<TContext, TData> | undefined>;
 /**
  * Options for creating a route
  * @template TData - Type of data collected throughout the route (inferred from schema)
@@ -52,16 +73,22 @@ export interface RouteOptions<TContext = unknown, TData = unknown> {
     title: string;
     /** Description of what this route accomplishes */
     description?: string;
+    /** Optional identity prompt defining the agent's role and persona for this route */
+    identity?: Template<TContext, TData>;
+    /** Optional personality prompt defining the agent's communication style for this route */
+    personality?: Template<TContext, TData>;
     /** Conditions that activate this route */
-    conditions?: string[];
+    conditions?: Template<TContext, TData>[];
     /** Initial guidelines for this route */
-    guidelines?: Guideline[];
-    /** Domain names that are allowed in this route (undefined = all domains) */
-    domains?: string[];
+    guidelines?: Guideline<TContext>[];
+    /** Initial terms for the route's domain glossary */
+    terms?: Term<TContext>[];
+    /** Tools available in this route */
+    tools?: Tool<TContext, unknown[], unknown, TData>[];
     /** Absolute rules the agent must follow in this route */
-    rules?: string[];
+    rules?: Template<TContext, TData>[];
     /** Absolute prohibitions the agent must never do in this route */
-    prohibitions?: string[];
+    prohibitions?: Template<TContext, TData>[];
     /** Optional: extractions the router may return (added to routing schema) */
     routingExtrasSchema?: StructuredSchema;
     /** Optional: structured response data for this route's message generation */
@@ -82,20 +109,20 @@ export interface RouteOptions<TContext = unknown, TData = unknown> {
      * If provided, automatically chains the steps from initialStep to END_ROUTE
      * For complex flows with branching, build the step machine manually instead
      */
-    steps?: TransitionSpec<TContext, TData>[];
+    steps?: StepOptions<TContext, TData>[];
     /**
      * Configure the initial step (optional)
-     * Accepts full TransitionSpec configuration (id, instructions, collect, skipIf, etc.)
+     * Accepts full StepOptions configuration (id, prompt, collect, skipIf, etc.)
      * Note: tool and step properties are ignored for initial step
      */
-    initialStep?: Omit<TransitionSpec<TContext, TData>, "tool" | "step" | "condition">;
+    initialStep?: Omit<StepOptions<TContext, TData>, "step">;
     /**
      * Configure the end step (optional)
      * Defines what happens when the route completes (reaches END_ROUTE)
-     * Can include instructions for completion message, tool for final actions, etc.
+     * Can include prompt for completion message, tool for final actions, etc.
      * Note: step, condition, skipIf properties are ignored for end step
      */
-    endStep?: Omit<TransitionSpec<TContext, TData>, "step" | "condition" | "skipIf">;
+    endStep?: Omit<StepOptions<TContext, TData>, "step" | "condition" | "skipIf">;
     /**
      * Optional transition when route completes (reaches END_ROUTE)
      * Can be:
@@ -121,23 +148,30 @@ export interface RouteOptions<TContext = unknown, TData = unknown> {
      *   return "error-recovery";
      * }
      */
-    onComplete?: string | RouteTransitionConfig | RouteCompletionHandler<TContext, TData>;
+    onComplete?: string | RouteTransitionConfig<TContext, TData> | RouteCompletionHandler<TContext, TData>;
+    /**
+     * Route lifecycle hooks
+     */
+    hooks?: RouteLifecycleHooks<TContext, TData>;
+    /** Knowledge base specific to this route containing any JSON structure the AI should know */
+    knowledgeBase?: Record<string, unknown>;
 }
-/**
- * Inline tool handler for dynamic tool generation
- */
-export type InlineToolHandler<TContext = unknown, TData = unknown> = (context: import("./tool").ToolContext<TContext, TData>) => ToolResult<unknown, TContext, TData> | Promise<ToolResult<unknown, TContext, TData>>;
 /**
  * Specification for a step transition
  */
-export interface TransitionSpec<TContext = unknown, TData = unknown> {
+export interface StepOptions<TContext = unknown, TData = unknown> {
     /** Custom ID for this step (optional - will generate deterministic ID if not provided) */
     id?: string;
+    /** Description of the transition */
+    description?: string;
     /** Transition to a chat state with this description */
-    instructions?: string;
-    /** Transition to execute a tool */
-    tool?: // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ToolRef<TContext, any[], any, TData> | InlineToolHandler<TContext, TData>;
+    prompt?: Template<TContext, TData>;
+    /** Tools available for AI to call in this step (by ID reference or inline definition) */
+    tools?: (string | Tool<TContext, unknown[], unknown, TData>)[];
+    /** Programmatic function or tool to run before AI responds */
+    prepare?: string | Tool<TContext, unknown[], unknown, TData> | ((context: TContext, data?: Partial<TData>) => void | Promise<void>);
+    /** Programmatic function or tool to run after AI responds */
+    finalize?: string | Tool<TContext, unknown[], unknown, TData> | ((context: TContext, data?: Partial<TData>) => void | Promise<void>);
     /** Transition to a specific step or end marker */
     step?: StepRef | symbol;
     /**
@@ -162,14 +196,34 @@ export interface TransitionSpec<TContext = unknown, TData = unknown> {
      * Optional condition for this transition
      * Description of when this transition should be taken
      */
-    condition?: string;
+    when?: Template<TContext, TData>;
+}
+/**
+ * Specification for a branch in the conversation flow
+ */
+export interface BranchSpec<TContext = unknown, TData = unknown> {
+    /** User-friendly identifier for this branch (used as object key) */
+    name: string;
+    /** Optional ID for this branch (auto-generated if not provided) */
+    id?: string;
+    /** Step configuration for this branch */
+    step: StepOptions<TContext, TData>;
+}
+/**
+ * Result of a branch operation
+ * Maps branch names to their respective step results for continued chaining
+ */
+export interface BranchResult<TContext = unknown, TData = unknown> {
+    [branchName: string]: StepResult<TContext, TData>;
 }
 /**
  * Result of a transition operation
- * Combines step reference with the ability to chain transitions
+ * Combines step reference with the ability to chain transitions and create branches
  */
-export interface TransitionResult<TContext = unknown, TData = unknown> extends StepRef {
+export interface StepResult<TContext = unknown, TData = unknown> extends StepRef {
     /** Allow chaining transitions */
-    nextStep: (spec: TransitionSpec<TContext, TData>) => TransitionResult<TContext, TData>;
+    nextStep: (spec: StepOptions<TContext, TData>) => StepResult<TContext, TData>;
+    /** Create multiple branches from this step */
+    branch: (branches: BranchSpec<TContext, TData>[]) => BranchResult<TContext, TData>;
 }
 //# sourceMappingURL=route.d.ts.map

package/dist/src/types/route.d.ts.map

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

package/dist/{types → src/types}/route.js.map

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

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

@@ -0,0 +1,70 @@
+/**
+ * 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 step tracks the current position in the conversation flow
+ * and data collected during the route progression
+ */
+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;
+    };
+    /**
+     * Data collected during the current route
+     * Convenience reference to dataByRoute[currentRoute.id]
+     */
+    data?: Partial<TData>;
+    /**
+     * Data collected organized by route ID
+     * Persists data when switching between routes
+     * Allows resuming incomplete routes where they left off
+     */
+    dataByRoute?: Record<string, 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/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;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAEtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAE7C,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/src/types/session.js

@@ -0,0 +1,5 @@
+/**
+ * Session step types for tracking conversation progress
+ */
+export {};
+//# sourceMappingURL=session.js.map

package/dist/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/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/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/src/types/template.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template.js.map

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

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

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

@@ -28,7 +28,7 @@ export interface ToolResult<TResultData = unknown, TContext = unknown, TData = u
     /** 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>;
+    dataUpdate?: Partial<TData>;
     /** Optional metadata about the execution */
     meta?: Record<string, unknown>;
 }
@@ -37,20 +37,18 @@ export interface ToolResult<TResultData = unknown, TContext = unknown, TData = u
  */
 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
+ * Tool definition - plain object interface
  */
-export interface ToolRef<TContext, TArgs extends unknown[], TResult, TData = unknown> {
+export interface Tool<TContext = unknown, TArgs extends unknown[] = unknown[], TResult = unknown, TData = 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 */
+    /** 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

@@ -1 +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,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"}
+{"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,UAAU,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,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,IAAI,CACnB,QAAQ,GAAG,OAAO,EAClB,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EACnC,OAAO,GAAG,OAAO,EACjB,KAAK,GAAG,OAAO;IAEf,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,OAAO,EAAE,KAAK,CAAC,CAAC;IACtD,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/{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/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/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/src/utils/clone.js

@@ -0,0 +1,33 @@
+/* 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
+ */
+export 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/src/utils/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../../src/utils/clone.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD;;;;;GAKG;AACH,MAAM,UAAU,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/{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

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/utils/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,kBAAkB,CAAC;AACzD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAWlE"}
+{"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/{utils → src/utils}/event.js

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

package/dist/src/utils/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/utils/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,SAAS,EAAE,MAAM,UAAU,CAAC;AACjD;;GAEG;AACH,MAAM,UAAU,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,SAAS,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"}