@lov3kaizen/agentsea-core 0.3.1 → 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, 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);
@@ -137,6 +253,39 @@ declare class VLLMProvider extends OpenAICompatibleProvider {
     constructor(config?: Partial<OpenAICompatibleConfig>);
 }
 
+interface TypeSafeProvider<TConfig extends ProviderModelConfig> {
+    readonly config: TConfig;
+    readonly provider: AnthropicProvider | OpenAIProvider | GeminiProvider | OllamaProvider;
+    getModelInfo(): ModelInfo | undefined;
+    supportsCapability(capability: keyof ModelCapabilities): boolean;
+}
+declare function createProvider<TConfig extends ProviderModelConfig>(config: TConfig): TypeSafeProvider<TConfig>;
+declare function createAnthropicProvider<TModel extends AnthropicModel>(config: AnthropicConfig<TModel>, options?: {
+    apiKey?: string;
+}): TypeSafeProvider<AnthropicConfig<TModel>> & {
+    provider: AnthropicProvider;
+};
+declare function createOpenAIProvider<TModel extends OpenAIModel>(config: OpenAIConfig<TModel>, options?: {
+    apiKey?: string;
+}): TypeSafeProvider<OpenAIConfig<TModel>> & {
+    provider: OpenAIProvider;
+};
+declare function createGeminiProvider<TModel extends GeminiModel>(config: GeminiConfig<TModel>, options?: {
+    apiKey?: string;
+}): TypeSafeProvider<GeminiConfig<TModel>> & {
+    provider: GeminiProvider;
+};
+declare function createOllamaProvider(config: OllamaConfig$1, options?: {
+    baseUrl?: string;
+    timeout?: number;
+}): TypeSafeProvider<OllamaConfig$1> & {
+    provider: OllamaProvider;
+};
+type ExtractModel<T extends ProviderModelConfig> = T['model'];
+type ExtractProviderName<T extends ProviderModelConfig> = T['provider'];
+type ConfigSupports<T extends ProviderModelConfig, TCapability extends keyof ModelCapabilities> = T extends AnthropicConfig<infer M> ? M extends keyof AnthropicModelCapabilities ? AnthropicModelCapabilities[M][TCapability] extends true ? true : false : false : T extends OpenAIConfig<infer M> ? M extends keyof OpenAIModelCapabilities ? OpenAIModelCapabilities[M][TCapability] extends true ? true : false : false : T extends GeminiConfig<infer M> ? M extends keyof GeminiModelCapabilities ? GeminiModelCapabilities[M][TCapability] extends true ? true : false : false : false;
+type RequireCapability<T extends ProviderModelConfig, TCapability extends keyof ModelCapabilities> = ConfigSupports<T, TCapability> extends true ? T : never;
+
 declare class BufferMemory implements MemoryStore {
     private maxMessages?;
     private store;
@@ -242,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;
 
@@ -277,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;
@@ -294,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;
@@ -385,7 +534,7 @@ interface MCPTool {
     description: string;
     inputSchema: {
         type: 'object';
-        properties: Record<string, any>;
+        properties: Record<string, unknown>;
         required?: string[];
     };
 }
@@ -427,7 +576,7 @@ interface MCPCallToolRequest {
     method: 'tools/call';
     params: {
         name: string;
-        arguments?: Record<string, any>;
+        arguments?: Record<string, unknown>;
     };
 }
 interface MCPCallToolResponse {
@@ -467,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;
     };
 }
 
@@ -486,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;
@@ -559,7 +708,7 @@ interface ACPProduct {
     };
     images?: string[];
     variants?: ACPProductVariant[];
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPProductVariant {
     id: string;
@@ -590,7 +739,7 @@ interface ACPCart {
         amount: number;
         currency: string;
     };
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPCheckoutSession {
     id: string;
@@ -606,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;
@@ -627,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;
@@ -637,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;
@@ -655,7 +804,7 @@ interface ACPOrder {
     trackingNumber?: string;
     createdAt: string;
     updatedAt: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPProductSearchQuery {
     query?: string;
@@ -684,7 +833,7 @@ interface ACPDelegatedPaymentConfig {
     merchantAccountId: string;
     returnUrl?: string;
     cancelUrl?: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 interface ACPWebhookEvent {
     id: string;
@@ -697,7 +846,7 @@ interface ACPResponse<T> {
     error?: {
         code: string;
         message: string;
-        details?: any;
+        details?: unknown;
     };
 }
 interface ACPPaginationMeta {
@@ -744,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;
 }
@@ -1039,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, ContentFormatter, ConversationManager, ConversationSchema, ConversationSchemaBuilder, type ConversationSchemaConfig, type ConversationState, type ConversationStep, type ConversationTurn, ElevenLabsTTSProvider, 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, SSETransport, SequentialWorkflow, SlidingWindowRateLimiter, type Span, StdioTransport, SummaryMemory, SupervisorWorkflow, TenantBufferMemory, TenantManager, type TenantManagerConfig, TextGenerationWebUIProvider, ToolRegistry, Tracer, VLLMProvider, VoiceAgent, Workflow, WorkflowFactory, calculatorTool, createACPTools, 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 };