@lov3kaizen/agentsea-core 0.4.0 → 0.5.0

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { Tool, ToolCall, ToolContext, AgentConfig, LLMProvider, MemoryStore, AgentContext, AgentResponse, StreamEvent, Message, ProviderConfig, LLMResponse, LLMStreamChunk, ProviderModelConfig, ModelInfo, ModelCapabilities, AnthropicModel, AnthropicConfig, OpenAIModel, OpenAIConfig, GeminiModel, GeminiConfig, OllamaConfig as OllamaConfig$1, AnthropicModelCapabilities, OpenAIModelCapabilities, GeminiModelCapabilities, WorkflowConfig, AgentMetrics, SpanContext, OutputFormat, FormatOptions, FormattedContent, VoiceAgentConfig, VoiceMessage, STTConfig, TTSConfig, STTProvider, STTResult, TTSProvider, TTSResult, AudioFormat, TenantStorage, Tenant, TenantStatus, TenantApiKey, TenantQuota } from '@lov3kaizen/agentsea-types';
+import { Tool, ToolCall, ToolContext, AgentConfig, LLMProvider, MemoryStore, AgentContext, AgentResponse, StreamEvent, RetryConfig, Message, ProviderConfig, LLMResponse, LLMStreamChunk, ProviderModelConfig, ModelInfo, ModelCapabilities, AnthropicModel, AnthropicConfig, OpenAIModel, OpenAIConfig, GeminiModel, GeminiConfig, OllamaConfig as OllamaConfig$1, AnthropicModelCapabilities, OpenAIModelCapabilities, GeminiModelCapabilities, WorkflowConfig, AgentMetrics, SpanContext, OutputFormat, FormatOptions, FormattedContent, VoiceAgentConfig, VoiceMessage, STTConfig, TTSConfig, STTProvider, STTResult, TTSProvider, TTSResult, AudioFormat, TenantStorage, Tenant, TenantStatus, TenantApiKey, TenantQuota } from '@lov3kaizen/agentsea-types';
 export * from '@lov3kaizen/agentsea-types';
 export { AudioFormat, STTConfig, STTProvider, STTResult, TTSConfig, TTSProvider, TTSResult, Tenant, TenantApiKey, TenantContext, TenantQuota, TenantResolver, TenantSettings, TenantStatus, TenantStorage, VoiceAgentConfig, VoiceMessage, VoiceType } from '@lov3kaizen/agentsea-types';
-import { EventEmitter } from 'events';
 import { z } from 'zod';
+import { EventEmitter } from 'events';
 
 declare class ToolRegistry {
     private tools;
@@ -13,7 +13,7 @@ declare class ToolRegistry {
     has(name: string): boolean;
     unregister(name: string): boolean;
     clear(): void;
-    execute(toolCall: ToolCall, context: ToolContext): Promise<any>;
+    execute(toolCall: ToolCall, context: ToolContext): Promise<unknown>;
     private executeWithRetry;
     private calculateDelay;
     private sleep;
@@ -59,6 +59,122 @@ declare const n8nListWorkflowsTool: Tool;
 declare const n8nTriggerWebhookTool: Tool;
 declare const n8nGetWorkflowTool: Tool;
 
+interface ToolDefinitionOptions<TInput extends z.ZodSchema, TOutput extends z.ZodSchema = z.ZodUnknown> {
+    name: string;
+    description: string;
+    inputSchema: TInput;
+    outputSchema?: TOutput;
+    needsApproval?: boolean;
+    retryConfig?: RetryConfig;
+}
+type ServerExecuteFn<TInput, TOutput> = (input: TInput, context: ToolContext) => Promise<TOutput>;
+type ClientExecuteFn<TInput, TOutput> = (input: TInput, context: ToolContext) => TOutput | Promise<TOutput>;
+interface ToolDefinition<TInput extends z.ZodSchema, TOutput extends z.ZodSchema> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: TInput;
+    readonly outputSchema: TOutput;
+    readonly needsApproval: boolean;
+    readonly retryConfig?: RetryConfig;
+    server(execute: ServerExecuteFn<z.infer<TInput>, z.infer<TOutput>>): ServerTool<TInput, TOutput>;
+    client(execute: ClientExecuteFn<z.infer<TInput>, z.infer<TOutput>>): ClientTool<TInput, TOutput>;
+    toTool(execute: ServerExecuteFn<z.infer<TInput>, z.infer<TOutput>>): Tool;
+}
+interface ServerTool<TInput extends z.ZodSchema, TOutput extends z.ZodSchema> extends Omit<ToolDefinition<TInput, TOutput>, 'server' | 'client' | 'toTool'> {
+    readonly environment: 'server';
+    execute(input: z.infer<TInput>, context: ToolContext): Promise<z.infer<TOutput>>;
+    toTool(): Tool;
+}
+interface ClientTool<TInput extends z.ZodSchema, TOutput extends z.ZodSchema> extends Omit<ToolDefinition<TInput, TOutput>, 'server' | 'client' | 'toTool'> {
+    readonly environment: 'client';
+    execute(input: z.infer<TInput>, context: ToolContext): z.infer<TOutput> | Promise<z.infer<TOutput>>;
+    toTool(): Tool;
+}
+interface HybridTool<TInput extends z.ZodSchema, TOutput extends z.ZodSchema> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: TInput;
+    readonly outputSchema: TOutput;
+    readonly needsApproval: boolean;
+    readonly retryConfig?: RetryConfig;
+    readonly server: ServerTool<TInput, TOutput>;
+    readonly client: ClientTool<TInput, TOutput>;
+    toTool(): Tool;
+}
+declare function toolDefinition<TInput extends z.ZodSchema, TOutput extends z.ZodSchema = z.ZodUnknown>(options: ToolDefinitionOptions<TInput, TOutput>): ToolDefinition<TInput, TOutput>;
+declare function hybridTool<TInput extends z.ZodSchema, TOutput extends z.ZodSchema = z.ZodUnknown>(options: ToolDefinitionOptions<TInput, TOutput> & {
+    server: ServerExecuteFn<z.infer<TInput>, z.infer<TOutput>>;
+    client: ClientExecuteFn<z.infer<TInput>, z.infer<TOutput>>;
+}): HybridTool<TInput, TOutput>;
+declare function serverTool<TInput extends z.ZodSchema, TOutput extends z.ZodSchema = z.ZodUnknown>(options: ToolDefinitionOptions<TInput, TOutput> & {
+    execute: ServerExecuteFn<z.infer<TInput>, z.infer<TOutput>>;
+}): ServerTool<TInput, TOutput>;
+declare function clientTool<TInput extends z.ZodSchema, TOutput extends z.ZodSchema = z.ZodUnknown>(options: ToolDefinitionOptions<TInput, TOutput> & {
+    execute: ClientExecuteFn<z.infer<TInput>, z.infer<TOutput>>;
+}): ClientTool<TInput, TOutput>;
+type ToolInput<T> = T extends ToolDefinition<infer TInput, any> ? z.infer<TInput> : T extends ServerTool<infer TInput, any> ? z.infer<TInput> : T extends ClientTool<infer TInput, any> ? z.infer<TInput> : never;
+type ToolOutput<T> = T extends ToolDefinition<any, infer TOutput> ? z.infer<TOutput> : T extends ServerTool<any, infer TOutput> ? z.infer<TOutput> : T extends ClientTool<any, infer TOutput> ? z.infer<TOutput> : never;
+declare function toLegacyTool(tool: ServerTool<any, any> | ClientTool<any, any> | HybridTool<any, any>): Tool;
+declare function toLegacyTools(tools: Array<ServerTool<any, any> | ClientTool<any, any> | HybridTool<any, any>>): Tool[];
+
+declare const calculatorDef: ToolDefinition<z.ZodObject<{
+    operation: z.ZodEnum<["add", "subtract", "multiply", "divide"]>;
+    a: z.ZodNumber;
+    b: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    operation: "add" | "subtract" | "multiply" | "divide";
+    a: number;
+    b: number;
+}, {
+    operation: "add" | "subtract" | "multiply" | "divide";
+    a: number;
+    b: number;
+}>, z.ZodObject<{
+    result: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    result: number;
+}, {
+    result: number;
+}>>;
+declare const calculatorServer: ServerTool<z.ZodObject<{
+    operation: z.ZodEnum<["add", "subtract", "multiply", "divide"]>;
+    a: z.ZodNumber;
+    b: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    operation: "add" | "subtract" | "multiply" | "divide";
+    a: number;
+    b: number;
+}, {
+    operation: "add" | "subtract" | "multiply" | "divide";
+    a: number;
+    b: number;
+}>, z.ZodObject<{
+    result: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    result: number;
+}, {
+    result: number;
+}>>;
+declare const calculatorClient: ClientTool<z.ZodObject<{
+    operation: z.ZodEnum<["add", "subtract", "multiply", "divide"]>;
+    a: z.ZodNumber;
+    b: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    operation: "add" | "subtract" | "multiply" | "divide";
+    a: number;
+    b: number;
+}, {
+    operation: "add" | "subtract" | "multiply" | "divide";
+    a: number;
+    b: number;
+}>, z.ZodObject<{
+    result: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    result: number;
+}, {
+    result: number;
+}>>;
+
 declare class AnthropicProvider implements LLMProvider {
     private client;
     constructor(apiKey?: string);
@@ -275,11 +391,11 @@ interface LoggerConfig {
 declare class Logger {
     private logger;
     constructor(config?: LoggerConfig);
-    error(message: string, meta?: any): void;
-    warn(message: string, meta?: any): void;
-    info(message: string, meta?: any): void;
-    debug(message: string, meta?: any): void;
-    child(context: Record<string, any>): Logger;
+    error(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    child(context: Record<string, unknown>): Logger;
 }
 declare const defaultLogger: Logger;
 
@@ -310,11 +426,11 @@ interface Span {
     name: string;
     startTime: Date;
     endTime?: Date;
-    attributes: Record<string, any>;
+    attributes: Record<string, unknown>;
     events: Array<{
         timestamp: Date;
         name: string;
-        attributes?: any;
+        attributes?: Record<string, unknown>;
     }>;
     status: 'ok' | 'error';
     error?: Error;
@@ -327,8 +443,8 @@ declare class Tracer {
         context: SpanContext;
     };
     endSpan(spanId: string, error?: Error): void;
-    setAttributes(spanId: string, attributes: Record<string, any>): void;
-    addEvent(spanId: string, name: string, attributes?: Record<string, any>): void;
+    setAttributes(spanId: string, attributes: Record<string, unknown>): void;
+    addEvent(spanId: string, name: string, attributes?: Record<string, unknown>): void;
     getSpan(spanId: string): Span | undefined;
     getTrace(traceId: string): Span[];
     getSpanDuration(spanId: string): number | undefined;
@@ -418,7 +534,7 @@ interface MCPTool {
     description: string;
     inputSchema: {
         type: 'object';
-        properties: Record<string, any>;
+        properties: Record<string, unknown>;
         required?: string[];
     };
 }
@@ -460,7 +576,7 @@ interface MCPCallToolRequest {
     method: 'tools/call';
     params: {
         name: string;
-        arguments?: Record<string, any>;
+        arguments?: Record<string, unknown>;
     };
 }
 interface MCPCallToolResponse {
@@ -500,12 +616,12 @@ interface MCPMessage {
     jsonrpc: '2.0';
     id?: string | number;
     method?: string;
-    params?: any;
-    result?: any;
+    params?: unknown;
+    result?: unknown;
     error?: {
         code: number;
         message: string;
-        data?: any;
+        data?: unknown;
     };
 }
 
@@ -519,11 +635,11 @@ declare class MCPClient extends EventEmitter {
     connect(): Promise<void>;
     private initialize;
     listTools(): Promise<MCPTool[]>;
-    callTool(name: string, args?: Record<string, any>): Promise<MCPCallToolResponse>;
+    callTool(name: string, args?: Record<string, unknown>): Promise<MCPCallToolResponse>;
     listResources(): Promise<MCPResource[]>;
     readResource(uri: string): Promise<MCPReadResourceResponse>;
     listPrompts(): Promise<MCPPrompt[]>;
-    getPrompt(name: string, args?: Record<string, string>): Promise<any>;
+    getPrompt(name: string, args?: Record<string, string>): Promise<unknown>;
     getServerInfo(): MCPServerInfo | null;
     disconnect(): void;
     isConnected(): boolean;
@@ -592,7 +708,7 @@ interface ACPProduct {
     };
     images?: string[];
     variants?: ACPProductVariant[];
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPProductVariant {
     id: string;
@@ -623,7 +739,7 @@ interface ACPCart {
         amount: number;
         currency: string;
     };
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPCheckoutSession {
     id: string;
@@ -639,14 +755,14 @@ interface ACPCheckoutSession {
     };
     createdAt: string;
     updatedAt: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPCustomer {
     id?: string;
     email: string;
     name?: string;
     phone?: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPAddress {
     line1: string;
@@ -660,7 +776,7 @@ interface ACPPaymentMethod {
     type: 'card' | 'delegated' | 'wallet' | 'bank_transfer';
     token?: string;
     delegatedProvider?: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPPaymentIntent {
     id: string;
@@ -670,7 +786,7 @@ interface ACPPaymentIntent {
     };
     status: 'pending' | 'processing' | 'succeeded' | 'failed' | 'cancelled';
     paymentMethod?: ACPPaymentMethod;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPOrder {
     id: string;
@@ -688,7 +804,7 @@ interface ACPOrder {
     trackingNumber?: string;
     createdAt: string;
     updatedAt: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPProductSearchQuery {
     query?: string;
@@ -717,7 +833,7 @@ interface ACPDelegatedPaymentConfig {
     merchantAccountId: string;
     returnUrl?: string;
     cancelUrl?: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPWebhookEvent {
     id: string;
@@ -730,7 +846,7 @@ interface ACPResponse<T> {
     error?: {
         code: string;
         message: string;
-        details?: any;
+        details?: unknown;
     };
 }
 interface ACPPaginationMeta {
@@ -777,22 +893,22 @@ declare function createACPTools(client: ACPClient): Tool[];
 interface ConversationTurn {
     role: 'user' | 'assistant' | 'system';
     content: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     timestamp?: Date;
 }
 interface ConversationState {
     currentStep: string;
-    data: Record<string, any>;
+    data: Record<string, unknown>;
     history: ConversationTurn[];
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
 }
 interface ConversationStep {
     id: string;
     prompt: string;
     schema?: z.ZodSchema;
-    next?: string | ((response: any, state: ConversationState) => string);
-    onComplete?: (response: any, state: ConversationState) => void | Promise<void>;
-    validation?: (response: any) => boolean | Promise<boolean>;
+    next?: string | ((response: unknown, state: ConversationState) => string);
+    onComplete?: (response: unknown, state: ConversationState) => void | Promise<void>;
+    validation?: (response: unknown) => boolean | Promise<boolean>;
     errorMessage?: string;
     maxRetries?: number;
 }
@@ -1072,4 +1188,4 @@ declare class MemoryTenantStorage implements TenantStorage {
     clear(): void;
 }
 
-export { type ACPAddress, type ACPCart, type ACPCartItem, type ACPCheckoutSession, ACPClient, type ACPConfig, type ACPCustomer, type ACPDelegatedPaymentConfig, type ACPOrder, type ACPPaginationMeta, type ACPPaymentIntent, type ACPPaymentMethod, type ACPProduct, type ACPProductSearchQuery, type ACPProductSearchResult, type ACPProductVariant, type ACPResponse, type ACPWebhookEvent, Agent, AnthropicProvider, BufferMemory, Cache, type ConfigSupports, ContentFormatter, ConversationManager, ConversationSchema, ConversationSchemaBuilder, type ConversationSchemaConfig, type ConversationState, type ConversationStep, type ConversationTurn, ElevenLabsTTSProvider, type ExtractModel, type ExtractProviderName, GeminiProvider, LMStudioProvider, LRUCache, LemonFoxSTTProvider, LemonFoxTTSProvider, LocalAIProvider, LocalWhisperProvider, type LogLevel, Logger, type LoggerConfig, type MCPCallToolRequest, type MCPCallToolResponse, MCPClient, type MCPListToolsRequest, type MCPListToolsResponse, type MCPMessage, type MCPPrompt, type MCPReadResourceRequest, type MCPReadResourceResponse, MCPRegistry, type MCPResource, type MCPServerCapabilities, type MCPServerConfig, type MCPServerInfo, type MCPTool, type MCPTransport, MemoryTenantStorage, MetricsCollector, OllamaProvider, OpenAICompatibleProvider, OpenAIProvider, type OpenAITTSConfig, OpenAITTSProvider, type OpenAIWhisperConfig, OpenAIWhisperProvider, ParallelWorkflow, PiperTTSProvider, RateLimiter, RedisMemory, type RequireCapability, SSETransport, SequentialWorkflow, SlidingWindowRateLimiter, type Span, StdioTransport, SummaryMemory, SupervisorWorkflow, TenantBufferMemory, TenantManager, type TenantManagerConfig, TextGenerationWebUIProvider, ToolRegistry, Tracer, type TypeSafeProvider, VLLMProvider, VoiceAgent, Workflow, WorkflowFactory, calculatorTool, createACPTools, createAnthropicProvider, createGeminiProvider, createOllamaProvider, createOpenAIProvider, createProvider, defaultLogger, figmaGetCommentsTool, figmaGetFileTool, figmaGetImagesTool, figmaGetNodesTool, figmaPostCommentTool, fileListTool, fileReadTool, fileWriteTool, globalMetrics, globalTracer, httpRequestTool, mcpToolToAgenticTool, n8nExecuteWorkflowTool, n8nGetExecutionTool, n8nGetWorkflowTool, n8nListWorkflowsTool, n8nTriggerWebhookTool, stringTransformTool, textSummaryTool };
+export { type ACPAddress, type ACPCart, type ACPCartItem, type ACPCheckoutSession, ACPClient, type ACPConfig, type ACPCustomer, type ACPDelegatedPaymentConfig, type ACPOrder, type ACPPaginationMeta, type ACPPaymentIntent, type ACPPaymentMethod, type ACPProduct, type ACPProductSearchQuery, type ACPProductSearchResult, type ACPProductVariant, type ACPResponse, type ACPWebhookEvent, Agent, AnthropicProvider, BufferMemory, Cache, type ClientExecuteFn, type ClientTool, type ConfigSupports, ContentFormatter, ConversationManager, ConversationSchema, ConversationSchemaBuilder, type ConversationSchemaConfig, type ConversationState, type ConversationStep, type ConversationTurn, ElevenLabsTTSProvider, type ExtractModel, type ExtractProviderName, GeminiProvider, type HybridTool, LMStudioProvider, LRUCache, LemonFoxSTTProvider, LemonFoxTTSProvider, LocalAIProvider, LocalWhisperProvider, type LogLevel, Logger, type LoggerConfig, type MCPCallToolRequest, type MCPCallToolResponse, MCPClient, type MCPListToolsRequest, type MCPListToolsResponse, type MCPMessage, type MCPPrompt, type MCPReadResourceRequest, type MCPReadResourceResponse, MCPRegistry, type MCPResource, type MCPServerCapabilities, type MCPServerConfig, type MCPServerInfo, type MCPTool, type MCPTransport, MemoryTenantStorage, MetricsCollector, OllamaProvider, OpenAICompatibleProvider, OpenAIProvider, type OpenAITTSConfig, OpenAITTSProvider, type OpenAIWhisperConfig, OpenAIWhisperProvider, ParallelWorkflow, PiperTTSProvider, RateLimiter, RedisMemory, type RequireCapability, SSETransport, SequentialWorkflow, type ServerExecuteFn, type ServerTool, SlidingWindowRateLimiter, type Span, StdioTransport, SummaryMemory, SupervisorWorkflow, TenantBufferMemory, TenantManager, type TenantManagerConfig, TextGenerationWebUIProvider, type ToolDefinition, type ToolDefinitionOptions, type ToolInput, type ToolOutput, ToolRegistry, Tracer, type TypeSafeProvider, VLLMProvider, VoiceAgent, Workflow, WorkflowFactory, calculatorClient, calculatorDef, calculatorServer, calculatorTool, clientTool, createACPTools, createAnthropicProvider, createGeminiProvider, createOllamaProvider, createOpenAIProvider, createProvider, defaultLogger, figmaGetCommentsTool, figmaGetFileTool, figmaGetImagesTool, figmaGetNodesTool, figmaPostCommentTool, fileListTool, fileReadTool, fileWriteTool, globalMetrics, globalTracer, httpRequestTool, hybridTool, mcpToolToAgenticTool, n8nExecuteWorkflowTool, n8nGetExecutionTool, n8nGetWorkflowTool, n8nListWorkflowsTool, n8nTriggerWebhookTool, serverTool, stringTransformTool, textSummaryTool, toLegacyTool, toLegacyTools, toolDefinition };