@falai/agent 0.9.0 → 0.9.2

package/src/index.ts

@@ -18,8 +18,7 @@ export type {
 export { adaptEvent, convertHistoryToEvents } from "./core/Events";
 export { PersistenceManager } from "./core/PersistenceManager";
 export { SessionManager } from "./core/SessionManager";
-export { ToolExecutor } from "./core/ToolExecutor";
-export type { ToolExecutionResult } from "./core/ToolExecutor";
+export { ToolManager, ToolCreationError, ToolExecutionError } from "./core/ToolManager";
 
 // Providers
 export { GeminiProvider } from "./providers/GeminiProvider";
@@ -102,7 +101,6 @@ export type {
   StepRef,
   RouteOptions,
   StepOptions,
-  StepResult,
   RouteTransitionConfig,
   RouteCompletionHandler,
   SessionState,
@@ -111,6 +109,13 @@ export type {
   ToolResult,
   ToolHandler,
   Tool,
+
+  DataEnrichmentConfig,
+  ValidationConfig,
+  ValidationError,
+  ApiCallConfig,
+  ComputationConfig,
+  ToolScope,
   AiProvider,
   GenerateMessageInput,
   GenerateMessageOutput,

package/src/types/agent.ts

@@ -99,7 +99,7 @@ export interface AgentOptions<TContext = unknown, TData = unknown> {
   /** Initial guidelines for agent behavior */
   guidelines?: Guideline<TContext, TData>[];
   /** Global tools available to all routes */
-  tools?: Tool<TContext, TData, unknown[], unknown>[];
+  tools?: Tool<TContext, TData, unknown>[];
   /** Initial routes (will be instantiated as Route objects) */
   routes?: RouteOptions<TContext, TData>[];
   /** Optional persistence configuration for auto-saving sessions and messages */

package/src/types/index.ts

@@ -45,8 +45,8 @@ export type {
   RouteRef,
   StepRef,
   StepOptions,
-  StepResult,
   BranchSpec,
+  StepResult,
   BranchResult,
   RouteCompletionHandler,
   RouteTransitionConfig,
@@ -58,7 +58,18 @@ export * from "./route";
 export type { SessionState, PendingTransition } from "./session";
 
 // Tool types
-export type { Tool, ToolContext, ToolResult, ToolHandler } from "./tool";
+export type { 
+  Tool, 
+  ToolContext, 
+  ToolResult, 
+  ToolHandler,
+  ToolExecutionResult,
+  DataEnrichmentConfig,
+  ValidationConfig,
+  ApiCallConfig,
+  ComputationConfig
+} from "./tool";
+export { ToolScope } from "./tool";
 
 // AI provider types
 export type {

package/src/types/route.ts

@@ -104,7 +104,7 @@ export interface RouteOptions<TContext = unknown, TData = unknown> {
   /** Initial terms for the route's domain glossary */
   terms?: Term<TContext>[];
   /** Tools available in this route */
-  tools?: Tool<TContext, TData, unknown[], unknown>[];
+  tools?: Tool<TContext, TData>[];
   /** Absolute rules the agent must follow in this route */
   rules?: Template<TContext, TData>[];
   /** Absolute prohibitions the agent must never do in this route */
@@ -197,16 +197,16 @@ export interface StepOptions<TContext = unknown, TData = unknown> {
   /** 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>)[];
+  tools?: (string | Tool<TContext, TData>)[];
   /** Programmatic function or tool to run before AI responds */
   prepare?:
     | string
-    | Tool<TContext, TData, unknown[], unknown>
+    | Tool<TContext, TData>
     | ((context: TContext, data?: Partial<TData>) => void | Promise<void>);
   /** Programmatic function or tool to run after AI responds */
   finalize?:
     | string
-    | Tool<TContext, TData, unknown[], unknown>
+    | Tool<TContext, TData>
     | ((context: TContext, data?: Partial<TData>) => void | Promise<void>);
   /** Transition to a specific step or end marker */
   step?: StepRef | symbol;
@@ -267,4 +267,6 @@ export interface StepResult<TContext = unknown, TData = unknown>
   branch: (
     branches: BranchSpec<TContext, TData>[]
   ) => BranchResult<TContext, TData>;
+  /** Shortcut to end the current route */
+  endRoute: (options?: Omit<StepOptions<TContext, TData>, "step">) => StepResult<TContext, TData>;
 }

package/src/types/tool.ts

@@ -1,36 +1,44 @@
+/* eslint @typescript-eslint/no-explicit-any: "off"*/
 /**
  * Tool system type definitions
  */
 
-import type { Event, StepRef } from "./index";
+import type { Event, StepRef, ValidationResult } from "./index";
 
 /**
  * Context provided to tool handlers
  */
-export interface ToolContext<TContext = unknown, TData = unknown> {
+export interface ToolContext<TContext = any, TData = any> {
   /** The agent's context data */
   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;
+  /** Complete agent-level data collected so far */
+  data: Partial<TData>;
   /** Interaction history */
   history: Event[];
-  /** Complete agent-level data collected so far */
-  data?: Partial<TData>;
+  /** Current step reference (if in a route) */
+  step?: StepRef;
   /** Additional metadata */
   metadata?: Record<string, unknown>;
+
+  /** 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>;
+  /** Get a specific field from collected data */
+  getField<K extends keyof TData>(key: K): TData[K] | undefined;
+  /** Set a specific field in collected data */
+  setField<K extends keyof TData>(key: K, value: TData[K]): Promise<void>;
+  /** Check if a field exists in collected data */
+  hasField<K extends keyof TData>(key: K): boolean;
 }
 
 /**
  * Result returned by a tool
  */
 export interface ToolResult<
-  TResultData = unknown,
-  TContext = unknown,
-  TData = unknown
+  TResultData = any,
+  TContext = any,
+  TData = any
 > {
   /** The result data */
   data?: TResultData;
@@ -50,34 +58,117 @@ export interface ToolResult<
  * Handler function for a tool
  */
 export type ToolHandler<
-  TContext,
-  TData = unknown,
-  TArgs extends unknown[] = unknown[],
-  TResult = unknown
+  TContext = any,
+  TData = any,
+  TResult = any
 > = (
   context: ToolContext<TContext, TData>,
-  ...args: TArgs
+  args?: Record<string, unknown>
 ) =>
-  | Promise<ToolResult<TResult, TContext, TData>>
-  | ToolResult<TResult, TContext, TData>;
+    | Promise<TResult | ToolResult<TResult, TContext, TData>>
+    | TResult
+    | ToolResult<TResult, TContext, TData>;
 
 /**
  * Tool definition - plain object interface
  */
 export interface Tool<
-  TContext = unknown,
-  TData = unknown,
-  TArgs extends unknown[] = unknown[],
-  TResult = unknown
+  TContext = any,
+  TData = any,
+  TResult = any
 > {
   /** Tool identifier */
   id: string;
   /** Tool display name (shown to AI models) */
   name?: string;
   /** Tool handler function */
-  handler: ToolHandler<TContext, TData, TArgs, TResult>;
+  handler: ToolHandler<TContext, TData, TResult>;
   /** Description of what the tool does (for AI discovery) */
   description?: string;
   /** Parameter schema or description */
   parameters?: unknown;
 }
+
+
+
+/**
+ * Tool execution result
+ */
+export interface ToolExecutionResult {
+  success: boolean;
+  data?: unknown;
+  error?: string;
+  contextUpdate?: Record<string, unknown>;
+  dataUpdate?: Record<string, unknown>;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Tool scope enumeration
+ */
+export enum ToolScope {
+  AGENT = 'agent',
+  ROUTE = 'route',
+  STEP = 'step',
+  REGISTERED = 'registered',
+  ALL = 'all'
+}
+
+
+
+/**
+ * Configuration for data enrichment tools
+ */
+export interface DataEnrichmentConfig<TContext, TData, TFields extends keyof TData> {
+  id: string;
+  name?: string;
+  description?: string;
+  fields: TFields[];
+  enricher: (
+    context: TContext,
+    data: Pick<TData, TFields>
+  ) => Promise<Partial<TData>> | Partial<TData>;
+}
+
+/**
+ * Configuration for validation tools
+ */
+export interface ValidationConfig<TContext, TData, TFields extends keyof TData> {
+  id: string;
+  name?: string;
+  description?: string;
+  fields: TFields[];
+  validator: (
+    context: TContext,
+    data: Pick<TData, TFields>
+  ) => Promise<ValidationResult> | ValidationResult;
+}
+
+/**
+ * Configuration for API call tools
+ */
+export interface ApiCallConfig<TContext, TData, TResult> {
+  id: string;
+  name?: string;
+  description?: string;
+  endpoint: string | ((context: TContext, data: Partial<TData>) => string);
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+  headers?: Record<string, string> | ((context: TContext) => Record<string, string>);
+  body?: (context: TContext, data: Partial<TData>, args?: Record<string, unknown>) => unknown;
+  transform?: (response: unknown) => TResult;
+}
+
+/**
+ * Configuration for computation tools
+ */
+export interface ComputationConfig<TContext, TData, TResult> {
+  id: string;
+  name?: string;
+  description?: string;
+  inputs: (keyof TData)[];
+  compute: (
+    context: TContext,
+    inputs: Partial<TData>,
+    args?: Record<string, unknown>
+  ) => Promise<TResult> | TResult;
+}

package/dist/cjs/src/core/ToolExecutor.d.ts

@@ -1,45 +0,0 @@
-/**
- * ToolExecutor - Simple utility for executing tools with context
- *
- * Tools execute BEFORE message generation to enrich context with data.
- * The LLM sees the enriched context when generating responses.
- */
-import type { Event, Tool } from "../types";
-export interface ToolExecutionResult {
-    toolName: string;
-    success: boolean;
-    data?: unknown;
-    contextUpdate?: Record<string, unknown>;
-    dataUpdate?: Record<string, unknown>;
-    error?: string;
-}
-export interface ExecuteToolParams<TContext = unknown, TData = unknown> {
-    tool: Tool<TContext, TData, unknown[], unknown>;
-    context: TContext;
-    updateContext: (updates: Partial<TContext>) => Promise<void>;
-    updateData: (updates: Partial<TData>) => Promise<void>;
-    history: Event[];
-    data?: Partial<TData>;
-    toolArguments?: Record<string, unknown>;
-}
-export interface ExecuteToolsParams<TContext = unknown, TData = unknown> {
-    tools: Array<Tool<TContext, TData, unknown[], unknown>>;
-    context: TContext;
-    updateContext: (updates: Partial<TContext>) => Promise<void>;
-    updateData: (updates: Partial<TData>) => Promise<void>;
-    history: Event[];
-    data?: Partial<TData>;
-}
-export declare class ToolExecutor<TContext = unknown, TData = unknown> {
-    /**
-     * Execute a single tool with context and collected data
-     * @param params - Execution parameters
-     */
-    executeTool(params: ExecuteToolParams<TContext, TData>): Promise<ToolExecutionResult>;
-    /**
-     * Execute multiple tools in sequence
-     * @param params - Execution parameters
-     */
-    executeTools(params: ExecuteToolsParams<TContext, TData>): Promise<ToolExecutionResult[]>;
-}
-//# sourceMappingURL=ToolExecutor.d.ts.map

package/dist/cjs/src/core/ToolExecutor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolExecutor.d.ts","sourceRoot":"","sources":["../../../../src/core/ToolExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAe,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACpE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,EAAE,QAAQ,CAAC;IAClB,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACrE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,QAAQ,CAAC;IAClB,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACvB;AAED,qBAAa,YAAY,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAC3D;;;OAGG;IACG,WAAW,CACf,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,GACzC,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;;OAGG;IACG,YAAY,CAChB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC1C,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAqClC"}

package/dist/cjs/src/core/ToolExecutor.js

@@ -1,84 +0,0 @@
-"use strict";
-/**
- * ToolExecutor - Simple utility for executing tools with context
- *
- * Tools execute BEFORE message generation to enrich context with data.
- * The LLM sees the enriched context when generating responses.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolExecutor = void 0;
-class ToolExecutor {
-    /**
-     * Execute a single tool with context and collected data
-     * @param params - Execution parameters
-     */
-    async executeTool(params) {
-        const { tool, context, updateContext, updateData, history, data, toolArguments } = params;
-        try {
-            // Build tool context with complete agent data
-            const toolContext = {
-                context,
-                updateContext,
-                updateData,
-                history,
-                data,
-            };
-            // Execute tool
-            const result = await tool.handler(toolContext, toolArguments);
-            // Apply data updates from tool result
-            if (result.dataUpdate) {
-                await updateData(result.dataUpdate);
-            }
-            // Return execution result
-            return {
-                toolName: tool.id || "unknown",
-                success: true,
-                data: result.data,
-                contextUpdate: result.contextUpdate,
-                dataUpdate: result.dataUpdate,
-            };
-        }
-        catch (error) {
-            return {
-                toolName: tool.id || "unknown",
-                success: false,
-                error: error instanceof Error ? error.message : String(error),
-            };
-        }
-    }
-    /**
-     * Execute multiple tools in sequence
-     * @param params - Execution parameters
-     */
-    async executeTools(params) {
-        const { tools, context, updateContext, updateData, history, data } = params;
-        const results = [];
-        for (const tool of tools) {
-            const result = await this.executeTool({
-                tool,
-                context,
-                updateContext,
-                updateData,
-                history,
-                data,
-            });
-            results.push(result);
-            // If tool failed, stop execution chain
-            if (!result.success) {
-                console.error(`[ToolExecutor] Tool ${tool.id || "unknown"} failed:`, result.error);
-                break;
-            }
-            // Apply context updates from tool result
-            if (result.contextUpdate) {
-                await updateContext(result.contextUpdate);
-            }
-            // Apply data updates from tool result
-            if (result.dataUpdate) {
-                await updateData(result.dataUpdate);
-            }
-        }
-        return results;
-    }
-}
-exports.ToolExecutor = ToolExecutor;
-//# sourceMappingURL=ToolExecutor.js.map

package/dist/cjs/src/core/ToolExecutor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolExecutor.js","sourceRoot":"","sources":["../../../../src/core/ToolExecutor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAgCH,MAAa,YAAY;IACvB;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,MAA0C;QAE1C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,GAC9E,MAAM,CAAC;QACT,IAAI,CAAC;YACH,8CAA8C;YAC9C,MAAM,WAAW,GAAiC;gBAChD,OAAO;gBACP,aAAa;gBACb,UAAU;gBACV,OAAO;gBACP,IAAI;aACL,CAAC;YAEF,eAAe;YACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;YAE9D,sCAAsC;YACtC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACtC,CAAC;YAED,0BAA0B;YAC1B,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,SAAS;gBAC9B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,SAAS;gBAC9B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,MAA2C;QAE3C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAC5E,MAAM,OAAO,GAA0B,EAAE,CAAC;QAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;gBACpC,IAAI;gBACJ,OAAO;gBACP,aAAa;gBACb,UAAU;gBACV,OAAO;gBACP,IAAI;aACL,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,uCAAuC;YACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CACX,uBAAuB,IAAI,CAAC,EAAE,IAAI,SAAS,UAAU,EACrD,MAAM,CAAC,KAAK,CACb,CAAC;gBACF,MAAM;YACR,CAAC;YAED,yCAAyC;YACzC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,MAAM,aAAa,CAAC,MAAM,CAAC,aAAkC,CAAC,CAAC;YACjE,CAAC;YAED,sCAAsC;YACtC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,UAAU,CAAC,MAAM,CAAC,UAA4B,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAxFD,oCAwFC"}

package/dist/src/core/ToolExecutor.d.ts

@@ -1,45 +0,0 @@
-/**
- * ToolExecutor - Simple utility for executing tools with context
- *
- * Tools execute BEFORE message generation to enrich context with data.
- * The LLM sees the enriched context when generating responses.
- */
-import type { Event, Tool } from "../types";
-export interface ToolExecutionResult {
-    toolName: string;
-    success: boolean;
-    data?: unknown;
-    contextUpdate?: Record<string, unknown>;
-    dataUpdate?: Record<string, unknown>;
-    error?: string;
-}
-export interface ExecuteToolParams<TContext = unknown, TData = unknown> {
-    tool: Tool<TContext, TData, unknown[], unknown>;
-    context: TContext;
-    updateContext: (updates: Partial<TContext>) => Promise<void>;
-    updateData: (updates: Partial<TData>) => Promise<void>;
-    history: Event[];
-    data?: Partial<TData>;
-    toolArguments?: Record<string, unknown>;
-}
-export interface ExecuteToolsParams<TContext = unknown, TData = unknown> {
-    tools: Array<Tool<TContext, TData, unknown[], unknown>>;
-    context: TContext;
-    updateContext: (updates: Partial<TContext>) => Promise<void>;
-    updateData: (updates: Partial<TData>) => Promise<void>;
-    history: Event[];
-    data?: Partial<TData>;
-}
-export declare class ToolExecutor<TContext = unknown, TData = unknown> {
-    /**
-     * Execute a single tool with context and collected data
-     * @param params - Execution parameters
-     */
-    executeTool(params: ExecuteToolParams<TContext, TData>): Promise<ToolExecutionResult>;
-    /**
-     * Execute multiple tools in sequence
-     * @param params - Execution parameters
-     */
-    executeTools(params: ExecuteToolsParams<TContext, TData>): Promise<ToolExecutionResult[]>;
-}
-//# sourceMappingURL=ToolExecutor.d.ts.map

package/dist/src/core/ToolExecutor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolExecutor.d.ts","sourceRoot":"","sources":["../../../src/core/ToolExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAe,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACpE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,EAAE,QAAQ,CAAC;IAClB,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACrE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,QAAQ,CAAC;IAClB,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACvB;AAED,qBAAa,YAAY,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAC3D;;;OAGG;IACG,WAAW,CACf,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,GACzC,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;;OAGG;IACG,YAAY,CAChB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC1C,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAqClC"}

package/dist/src/core/ToolExecutor.js

@@ -1,80 +0,0 @@
-/**
- * ToolExecutor - Simple utility for executing tools with context
- *
- * Tools execute BEFORE message generation to enrich context with data.
- * The LLM sees the enriched context when generating responses.
- */
-export class ToolExecutor {
-    /**
-     * Execute a single tool with context and collected data
-     * @param params - Execution parameters
-     */
-    async executeTool(params) {
-        const { tool, context, updateContext, updateData, history, data, toolArguments } = params;
-        try {
-            // Build tool context with complete agent data
-            const toolContext = {
-                context,
-                updateContext,
-                updateData,
-                history,
-                data,
-            };
-            // Execute tool
-            const result = await tool.handler(toolContext, toolArguments);
-            // Apply data updates from tool result
-            if (result.dataUpdate) {
-                await updateData(result.dataUpdate);
-            }
-            // Return execution result
-            return {
-                toolName: tool.id || "unknown",
-                success: true,
-                data: result.data,
-                contextUpdate: result.contextUpdate,
-                dataUpdate: result.dataUpdate,
-            };
-        }
-        catch (error) {
-            return {
-                toolName: tool.id || "unknown",
-                success: false,
-                error: error instanceof Error ? error.message : String(error),
-            };
-        }
-    }
-    /**
-     * Execute multiple tools in sequence
-     * @param params - Execution parameters
-     */
-    async executeTools(params) {
-        const { tools, context, updateContext, updateData, history, data } = params;
-        const results = [];
-        for (const tool of tools) {
-            const result = await this.executeTool({
-                tool,
-                context,
-                updateContext,
-                updateData,
-                history,
-                data,
-            });
-            results.push(result);
-            // If tool failed, stop execution chain
-            if (!result.success) {
-                console.error(`[ToolExecutor] Tool ${tool.id || "unknown"} failed:`, result.error);
-                break;
-            }
-            // Apply context updates from tool result
-            if (result.contextUpdate) {
-                await updateContext(result.contextUpdate);
-            }
-            // Apply data updates from tool result
-            if (result.dataUpdate) {
-                await updateData(result.dataUpdate);
-            }
-        }
-        return results;
-    }
-}
-//# sourceMappingURL=ToolExecutor.js.map

package/dist/src/core/ToolExecutor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolExecutor.js","sourceRoot":"","sources":["../../../src/core/ToolExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,MAAM,OAAO,YAAY;IACvB;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,MAA0C;QAE1C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,GAC9E,MAAM,CAAC;QACT,IAAI,CAAC;YACH,8CAA8C;YAC9C,MAAM,WAAW,GAAiC;gBAChD,OAAO;gBACP,aAAa;gBACb,UAAU;gBACV,OAAO;gBACP,IAAI;aACL,CAAC;YAEF,eAAe;YACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;YAE9D,sCAAsC;YACtC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACtC,CAAC;YAED,0BAA0B;YAC1B,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,SAAS;gBAC9B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,SAAS;gBAC9B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,MAA2C;QAE3C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAC5E,MAAM,OAAO,GAA0B,EAAE,CAAC;QAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;gBACpC,IAAI;gBACJ,OAAO;gBACP,aAAa;gBACb,UAAU;gBACV,OAAO;gBACP,IAAI;aACL,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,uCAAuC;YACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CACX,uBAAuB,IAAI,CAAC,EAAE,IAAI,SAAS,UAAU,EACrD,MAAM,CAAC,KAAK,CACb,CAAC;gBACF,MAAM;YACR,CAAC;YAED,yCAAyC;YACzC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,MAAM,aAAa,CAAC,MAAM,CAAC,aAAkC,CAAC,CAAC;YACjE,CAAC;YAED,sCAAsC;YACtC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,UAAU,CAAC,MAAM,CAAC,UAA4B,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}