@falai/agent 0.8.1 → 0.9.0-alpha-2

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

@@ -2,32 +2,47 @@
  * 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>;
+    routeHistory: SessionState<TData>["routeHistory"];
+    history?: SessionState<TData>["history"];
+    currentRouteTitle?: string;
+    currentStepDescription?: string;
+    metadata: SessionState<TData>["metadata"];
+}
 /**
  * Base message data structure
  */
@@ -50,43 +65,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 +145,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 +167,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 +185,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/src/types/route.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Route/Journey DSL type definitions
+ */
+import type { Tool } from "./tool";
+import type { StructuredSchema } from "./schema";
+import { Template } from "./template";
+/**
+ * Reference to a route
+ */
+export interface RouteRef {
+    /** Route identifier */
+    id: string;
+}
+/**
+ * Reference to a step within a route
+ */
+export interface StepRef {
+    /** Step identifier */
+    id: string;
+    /** Route this step belongs to */
+    routeId: string;
+}
+/**
+ * Forward declare Guideline and Term for circular dependency
+ */
+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<TContext = unknown, TData = unknown> {
+    /** Target route ID or title to transition to */
+    nextStep: string;
+    /** Optional AI-evaluated condition for the transition */
+    condition?: Template<TContext, TData>;
+}
+/**
+ * Function type for dynamic route completion transitions
+ * @param session - Current session step with collected data
+ * @param context - Agent context
+ * @returns Route ID/title to transition to, or transition config, or undefined to end
+ */
+export type RouteCompletionHandler<TContext = unknown, TData = unknown> = (session: {
+    data?: Partial<TData>;
+}, 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)
+ */
+export interface RouteOptions<TContext = unknown, TData = unknown> {
+    /** Custom ID for the route (optional - will generate deterministic ID from title if not provided) */
+    id?: string;
+    /** Title of the route */
+    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?: Template<TContext, TData>[];
+    /** Initial guidelines for this route */
+    guidelines?: Guideline<TContext>[];
+    /** Initial terms for the route's domain glossary */
+    terms?: Term<TContext>[];
+    /** Tools available in this route */
+    tools?: Tool<TContext, TData, unknown[], unknown>[];
+    /** Absolute rules the agent must follow in this route */
+    rules?: Template<TContext, TData>[];
+    /** Absolute prohibitions the agent must never do in this route */
+    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 */
+    responseOutputSchema?: StructuredSchema;
+    /**
+     * Required fields for route completion - must be valid keys from agent's TData type
+     * Route is considered complete when all required fields are present in agent data
+     */
+    requiredFields?: (keyof TData)[];
+    /**
+     * Optional fields that enhance the route but aren't required for completion
+     * Must be valid keys from agent's TData type
+     */
+    optionalFields?: (keyof TData)[];
+    /**
+     * Initial data to pre-populate when entering this route
+     * Useful for restoring sessions or pre-filling known information
+     * Steps with skipIf conditions will be automatically bypassed if data is present
+     * Now refers to agent-level data
+     */
+    initialData?: Partial<TData>;
+    /**
+     * NEW: Sequential steps for simple linear flows
+     * If provided, automatically chains the steps from initialStep to END_ROUTE
+     * For complex flows with branching, build the step machine manually instead
+     */
+    steps?: StepOptions<TContext, TData>[];
+    /**
+     * Configure the initial step (optional)
+     * Accepts full StepOptions configuration (id, prompt, collect, skipIf, etc.)
+     * Note: tool and step properties are ignored for initial step
+     */
+    initialStep?: Omit<StepOptions<TContext, TData>, "step">;
+    /**
+     * Configure the end step (optional)
+     * Defines what happens when the route completes (reaches END_ROUTE)
+     * Can include prompt for completion message, tool for final actions, etc.
+     * Note: step, condition, skipIf properties are ignored for end step
+     */
+    endStep?: Omit<StepOptions<TContext, TData>, "step" | "condition" | "skipIf">;
+    /**
+     * Optional transition when route completes (reaches END_ROUTE)
+     * Can be:
+     * - String: Route ID or title to transition to
+     * - Object: Transition config with optional AI-evaluated condition
+     * - Function: Dynamic logic that returns route ID, config, or undefined
+     *
+     * @example
+     * // Simple string
+     * onComplete: "feedback-collection"
+     *
+     * @example
+     * // With condition
+     * onComplete: {
+     *   nextStep: "feedback-collection",
+     *   condition: "if booking succeeded"
+     * }
+     *
+     * @example
+     * // Dynamic function
+     * onComplete: (session) => {
+     *   if (session.data?.success) return "feedback";
+     *   return "error-recovery";
+     * }
+     */
+    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>;
+}
+/**
+ * Specification for a step transition
+ */
+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 */
+    prompt?: Template<TContext, TData>;
+    /** Tools available for AI to call in this step (by ID reference or inline definition) */
+    tools?: (string | Tool<TContext, TData, unknown[], unknown>)[];
+    /** Programmatic function or tool to run before AI responds */
+    prepare?: string | Tool<TContext, TData, unknown[], unknown> | ((context: TContext, data?: Partial<TData>) => void | Promise<void>);
+    /** Programmatic function or tool to run after AI responds */
+    finalize?: string | Tool<TContext, TData, unknown[], unknown> | ((context: TContext, data?: Partial<TData>) => void | Promise<void>);
+    /** Transition to a specific step or end marker */
+    step?: StepRef | symbol;
+    /**
+     * Fields to collect from the conversation in this step
+     * These should match keys in the agent's TData schema
+     */
+    collect?: (keyof TData)[];
+    /**
+     * Function to determine if this step should be skipped
+     * If returns true, the step will be bypassed
+     * @param data - Currently collected agent-level data
+     * @returns true if step should be skipped, false otherwise
+     */
+    skipIf?: (data: Partial<TData>) => boolean;
+    /**
+     * Required data fields that must be present before entering this step
+     * If any required field is missing, step cannot be entered
+     * Must be valid keys from agent's TData type
+     */
+    requires?: (keyof TData)[];
+    /**
+     * Optional condition for this transition
+     * Description of when this transition should be taken
+     */
+    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 and create branches
+ */
+export interface StepResult<TContext = unknown, TData = unknown> extends StepRef {
+    /** Allow chaining transitions */
+    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,65 @@
+/**
+ * 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 state tracks the current position in the conversation flow
+ * and data collected at the agent level across all routes
+ */
+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;
+    };
+    /**
+     * Agent-level data collected across all routes
+     * This is the single source of truth for all collected data
+     * Routes can access and contribute to this shared data structure
+     */
+    data: 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;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErB,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/{cjs → src}/types/tool.d.ts

@@ -10,11 +10,13 @@ export interface ToolContext<TContext = unknown, TData = unknown> {
     context: TContext;
     /** Update the agent's context (triggers lifecycle hooks if configured) */
     updateContext: (updates: Partial<TContext>) => Promise<void>;
+    /** Update the agent's collected data (triggers lifecycle hooks if configured) */
+    updateData: (updates: Partial<TData>) => Promise<void>;
     /** Current step reference (if in a route) */
     step?: StepRef;
     /** Interaction history */
     history: Event[];
-    /** Data collected so far in the current route */
+    /** Complete agent-level data collected so far */
     data?: Partial<TData>;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
@@ -24,33 +26,35 @@ export interface ToolContext<TContext = unknown, TData = unknown> {
  */
 export interface ToolResult<TResultData = unknown, TContext = unknown, TData = unknown> {
     /** The result data */
-    data: TResultData;
+    data?: TResultData;
     /** 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>;
+    /** Optional agent-level data update to be merged with collected data */
+    dataUpdate?: Partial<TData>;
+    /** Success indicator */
+    success?: boolean;
+    /** Error message if operation failed */
+    error?: string;
     /** Optional metadata about the execution */
     meta?: Record<string, unknown>;
 }
 /**
  * Handler function for a tool
  */
-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>;
+export type ToolHandler<TContext, TData = unknown, TArgs extends unknown[] = unknown[], TResult = 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, TData = unknown, TArgs extends unknown[] = unknown[], TResult = 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 */
+    handler: ToolHandler<TContext, TData, TArgs, TResult>;
+    /** 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/src/types/tool.d.ts.map

@@ -0,0 +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,iFAAiF;IACjF,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,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,CAAC,EAAE,WAAW,CAAC;IACnB,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,wBAAwB;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,QAAQ,EACR,KAAK,GAAG,OAAO,EACf,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EACnC,OAAO,GAAG,OAAO,IACf,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,GAAG,OAAO,EACf,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EACnC,OAAO,GAAG,OAAO;IAEjB,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,KAAK,EAAE,OAAO,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"}