@robota-sdk/agent-core 3.0.0-beta.33 → 3.0.0-beta.34

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "@robota-sdk/agent-core",
-  "version": "3.0.0-beta.33",
+  "version": "3.0.0-beta.34",
   "description": "Complete AI agent implementation with unified core and tools functionality - conversation management, plugin system, and advanced agent features",
   "type": "module",
   "main": "dist/node/index.js",
-  "module": "dist/node/index.mjs",
   "types": "dist/node/index.d.ts",
   "exports": {
     ".": {

package/dist/abstracts/abstract-agent.d.ts

@@ -1,56 +0,0 @@
-/**
- * @fileoverview Abstract Agent Base Class
- *
- * 🎯 ABSTRACT CLASS - DO NOT DEPEND ON CONCRETE IMPLEMENTATIONS
- *
- * This class defines the foundational lifecycle for agent implementations.
- * Subclasses provide provider/tool-specific behavior while inheriting the
- * shared guarantees around initialization, history, and disposal.
- */
-import type { IAgent, IAgentConfig, TUniversalMessage, IRunOptions } from '../interfaces/agent';
-export declare abstract class AbstractAgent<TConfig = IAgentConfig, TContext = IRunOptions, TMessage = TUniversalMessage> implements IAgent<TConfig, TContext, TMessage> {
-    protected history: TMessage[];
-    protected isInitialized: boolean;
-    protected config?: TConfig;
-    /**
-     * Initialize the agent (subclass responsibility)
-     */
-    protected abstract initialize(): Promise<void>;
-    /**
-     * Configure the agent with type-safe configuration
-     */
-    configure(config: TConfig): Promise<void>;
-    /**
-     * Run agent with user input and type-safe context
-     */
-    abstract run(input: string, context?: TContext): Promise<string>;
-    /**
-     * Run agent with streaming response and type-safe context
-     */
-    abstract runStream(input: string, context?: TContext): AsyncGenerator<string, void, never>;
-    /**
-     * Get conversation history with type-safe messages
-     */
-    getHistory(): TMessage[];
-    /**
-     * Clear conversation history
-     */
-    clearHistory(): void;
-    /**
-     * Add message to history
-     */
-    protected addMessage(message: TMessage): void;
-    /**
-     * Validate user input
-     */
-    protected validateInput(input: string): void;
-    /**
-     * Ensure agent is initialized before running
-     */
-    protected ensureInitialized(): Promise<void>;
-    /**
-     * Cleanup resources
-     */
-    dispose(): Promise<void>;
-}
-//# sourceMappingURL=abstract-agent.d.ts.map

package/dist/abstracts/abstract-agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract-agent.d.ts","sourceRoot":"","sources":["../../src/abstracts/abstract-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEhG,8BAAsB,aAAa,CACjC,OAAO,GAAG,YAAY,EACtB,QAAQ,GAAG,WAAW,EACtB,QAAQ,GAAG,iBAAiB,CAC5B,YAAW,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAE9C,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAM;IACnC,SAAS,CAAC,aAAa,UAAS;IAChC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9C;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAEhE;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC;IAE1F;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAI7C;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5C;;OAEG;cACa,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}

package/dist/abstracts/abstract-agent.js

@@ -1,55 +0,0 @@
-export class AbstractAgent {
-    history = [];
-    isInitialized = false;
-    config;
-    /**
-     * Configure the agent with type-safe configuration
-     */
-    async configure(config) {
-        this.config = config;
-        await this.ensureInitialized();
-    }
-    /**
-     * Get conversation history with type-safe messages
-     */
-    getHistory() {
-        return [...this.history];
-    }
-    /**
-     * Clear conversation history
-     */
-    clearHistory() {
-        this.history = [];
-    }
-    /**
-     * Add message to history
-     */
-    addMessage(message) {
-        this.history.push(message);
-    }
-    /**
-     * Validate user input
-     */
-    validateInput(input) {
-        if (!input || typeof input !== 'string') {
-            throw new Error('Input must be a non-empty string');
-        }
-    }
-    /**
-     * Ensure agent is initialized before running
-     */
-    async ensureInitialized() {
-        if (!this.isInitialized) {
-            await this.initialize();
-            this.isInitialized = true;
-        }
-    }
-    /**
-     * Cleanup resources
-     */
-    async dispose() {
-        this.clearHistory();
-        this.isInitialized = false;
-    }
-}
-//# sourceMappingURL=abstract-agent.js.map

package/dist/abstracts/abstract-agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract-agent.js","sourceRoot":"","sources":["../../src/abstracts/abstract-agent.ts"],"names":[],"mappings":"AAWA,MAAM,OAAgB,aAAa;IAMvB,OAAO,GAAe,EAAE,CAAC;IACzB,aAAa,GAAG,KAAK,CAAC;IACtB,MAAM,CAAW;IAO3B;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,MAAe;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACjC,CAAC;IAYD;;OAEG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACO,UAAU,CAAC,OAAiB;QACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,KAAa;QACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,iBAAiB;QAC/B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC7B,CAAC;CACF"}

package/dist/abstracts/abstract-ai-provider.d.ts

@@ -1,188 +0,0 @@
-/**
- * @fileoverview Abstract AI Provider Base Class
- *
- * 🎯 ABSTRACT CLASS - DO NOT DEPEND ON CONCRETE IMPLEMENTATIONS
- *
- * Defines the shared contract and helper utilities for all AI provider implementations.
- * Concrete providers should extend this class and inject their own dependencies.
- */
-import type { IAIProvider, IToolSchema, IChatOptions, IProviderRequest, IRawProviderResponse } from '../interfaces/provider';
-import type { IExecutor } from '../interfaces/executor';
-import type { TUniversalMessage } from '../interfaces/messages';
-import type { ILogger } from '../utils/logger';
-/**
- * Provider logging data type
- * Used for storing logging information in provider operations
- */
-export type TProviderLoggingData = Record<string, string | number | boolean | Date | string[]>;
-/**
- * Provider configuration base interface
- */
-export interface IProviderConfig {
-    apiKey?: string;
-    baseUrl?: string;
-    timeout?: number;
-    [key: string]: string | number | boolean | undefined;
-}
-/**
- * Enhanced provider configuration that supports executor injection
- */
-export interface IExecutorAwareProviderConfig {
-    apiKey?: string;
-    baseUrl?: string;
-    timeout?: number;
-    /**
-     * Optional executor for handling AI requests
-     * When provided, the provider will delegate all chat operations to this executor
-     * instead of making direct API calls. This enables remote execution capabilities.
-     */
-    executor?: IExecutor;
-    [key: string]: string | number | boolean | IExecutor | undefined;
-}
-/**
- * Base AI provider implementation with proper type constraints
- * All AI providers should extend this class
- *
- * ========================================
- * CRITICAL IMPLEMENTATION GUIDELINES
- * ========================================
- *
- * ALL AI PROVIDER IMPLEMENTATIONS (OpenAI, Anthropic, Google, etc.) MUST:
- *
- * 1. EXTEND THIS CLASS:
- *    ```typescript
- *    export class OpenAIProvider extends AbstractAIProvider {
- *        override readonly name = 'openai';
- *        override readonly version = '1.0.0';
- *    ```
- *
- * 2. USE IMPORTS FROM @robota-sdk/agent-core:
- *    ```typescript
- *    import { AbstractAIProvider } from '@robota-sdk/agent-core';
- *    import type {
- *        TUniversalMessage,
- *        ChatOptions,
- *        IToolCall,
- *        ToolSchema,
- *        AssistantMessage
- *    } from '@robota-sdk/agent-core';
- *    ```
- *
- * 3. USE OVERRIDE KEYWORD FOR ALL INHERITED METHODS:
- *    - override async chat(...)
- *    - override async *chatStream(...)
- *    - override supportsTools()
- *    - override validateConfig()
- *    - override async dispose()
- *
- * 4. DO NOT REDEFINE TYPES THAT EXIST IN @robota-sdk/agent-core:
- *    - TUniversalMessage
- *    - ChatOptions
- *    - IToolCall
- *    - ToolSchema
- *    - AssistantMessage
- *    - SystemMessage
- *    - UserMessage
- *    - ToolMessage
- *
- * 5. HANDLE MESSAGE CONTENT PROPERLY:
- *    - For tool calls: content should be null (not empty string)
- *    - For regular messages: content can be string or null
- *    - Always preserve null values from API responses
- *
- * 6. CALL SUPER() IN CONSTRUCTOR:
- *    ```typescript
- *    constructor(options: IProviderOptions) {
- *        super();
- *        // provider-specific initialization
- *    }
- *    ```
- *
- * This ensures ExecutionService can properly identify providers
- * and prevents type conflicts across the codebase.
- *
- * ========================================
- *
- * @template TConfig - Provider configuration type (defaults to IProviderConfig for type safety)
- * @template TUniversalMessage - Message type (defaults to TUniversalMessage for backward compatibility)
- * @template TResponse - Response type (defaults to TUniversalMessage for backward compatibility)
- */
-export declare abstract class AbstractAIProvider<TConfig = IProviderConfig> implements IAIProvider {
-    abstract readonly name: string;
-    abstract readonly version: string;
-    protected config?: TConfig;
-    protected executor?: IExecutor;
-    protected readonly logger: ILogger;
-    constructor(logger?: ILogger);
-    /**
-     * Configure the provider with type-safe configuration
-     */
-    configure(config: TConfig): Promise<void>;
-    private hasExecutor;
-    /**
-     * Each provider must implement chat using their own native SDK types internally
-     * @param messages - Array of messages from conversation history
-     * @param options - Chat options including tools, model settings, etc.
-     * @returns Promise resolving to a response
-     */
-    abstract chat(messages: TUniversalMessage[], options?: IChatOptions): Promise<TUniversalMessage>;
-    /**
-     * Each provider must implement streaming chat using their own native SDK types internally
-     * @param messages - Array of messages from conversation history
-     * @param options - Chat options including tools, model settings, etc.
-     * @returns AsyncIterable of response chunks
-     */
-    chatStream?(messages: TUniversalMessage[], options?: IChatOptions): AsyncIterable<TUniversalMessage>;
-    /**
-     * Provider-agnostic raw response API.
-     *
-     * This is the canonical "raw payload" entrypoint required by the AIProvider contract.
-     * The default implementation delegates to `chat()` and adapts the result into a
-     * RawProviderResponse shape.
-     */
-    generateResponse(payload: IProviderRequest): Promise<IRawProviderResponse>;
-    /**
-     * Provider-agnostic raw streaming API.
-     *
-     * If a provider does not implement chatStream, it does not support streaming.
-     */
-    generateStreamingResponse(payload: IProviderRequest): AsyncIterable<IRawProviderResponse>;
-    /**
-     * Default implementation - most modern providers support tools
-     * @returns true if tool calling is supported
-     */
-    supportsTools(): boolean;
-    /**
-     * Default implementation - providers can override for specific validation
-     * @returns true if configuration is valid
-     */
-    validateConfig(): boolean;
-    /**
-     * Utility method for validating TUniversalMessage array
-     * @param messages - Messages to validate
-     */
-    protected validateMessages(messages: TUniversalMessage[]): void;
-    /**
-     * Utility method for validating tool schemas
-     * @param tools - Tool schemas to validate
-     */
-    protected validateTools(tools?: IToolSchema[]): void;
-    /**
-     * Execute chat via executor.
-     *
-     * Subclasses should call this only when an executor is configured.
-     */
-    protected executeViaExecutorOrDirect(messages: TUniversalMessage[], options?: IChatOptions): Promise<TUniversalMessage>;
-    /**
-     * Execute streaming chat via executor.
-     *
-     * Subclasses should call this only when an executor is configured.
-     */
-    protected executeStreamViaExecutorOrDirect(messages: TUniversalMessage[], options?: IChatOptions): AsyncIterable<TUniversalMessage>;
-    /**
-     * Clean up resources when provider is no longer needed
-     * Override this method in subclasses for additional cleanup
-     */
-    dispose(): Promise<void>;
-}
-//# sourceMappingURL=abstract-ai-provider.d.ts.map

package/dist/abstracts/abstract-ai-provider.d.ts.map

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

package/dist/abstracts/abstract-ai-provider.js

@@ -1,258 +0,0 @@
-import { isAssistantMessage } from '../interfaces/messages';
-import { SilentLogger } from '../utils/logger';
-/**
- * Base AI provider implementation with proper type constraints
- * All AI providers should extend this class
- *
- * ========================================
- * CRITICAL IMPLEMENTATION GUIDELINES
- * ========================================
- *
- * ALL AI PROVIDER IMPLEMENTATIONS (OpenAI, Anthropic, Google, etc.) MUST:
- *
- * 1. EXTEND THIS CLASS:
- *    ```typescript
- *    export class OpenAIProvider extends AbstractAIProvider {
- *        override readonly name = 'openai';
- *        override readonly version = '1.0.0';
- *    ```
- *
- * 2. USE IMPORTS FROM @robota-sdk/agent-core:
- *    ```typescript
- *    import { AbstractAIProvider } from '@robota-sdk/agent-core';
- *    import type {
- *        TUniversalMessage,
- *        ChatOptions,
- *        IToolCall,
- *        ToolSchema,
- *        AssistantMessage
- *    } from '@robota-sdk/agent-core';
- *    ```
- *
- * 3. USE OVERRIDE KEYWORD FOR ALL INHERITED METHODS:
- *    - override async chat(...)
- *    - override async *chatStream(...)
- *    - override supportsTools()
- *    - override validateConfig()
- *    - override async dispose()
- *
- * 4. DO NOT REDEFINE TYPES THAT EXIST IN @robota-sdk/agent-core:
- *    - TUniversalMessage
- *    - ChatOptions
- *    - IToolCall
- *    - ToolSchema
- *    - AssistantMessage
- *    - SystemMessage
- *    - UserMessage
- *    - ToolMessage
- *
- * 5. HANDLE MESSAGE CONTENT PROPERLY:
- *    - For tool calls: content should be null (not empty string)
- *    - For regular messages: content can be string or null
- *    - Always preserve null values from API responses
- *
- * 6. CALL SUPER() IN CONSTRUCTOR:
- *    ```typescript
- *    constructor(options: IProviderOptions) {
- *        super();
- *        // provider-specific initialization
- *    }
- *    ```
- *
- * This ensures ExecutionService can properly identify providers
- * and prevents type conflicts across the codebase.
- *
- * ========================================
- *
- * @template TConfig - Provider configuration type (defaults to IProviderConfig for type safety)
- * @template TUniversalMessage - Message type (defaults to TUniversalMessage for backward compatibility)
- * @template TResponse - Response type (defaults to TUniversalMessage for backward compatibility)
- */
-export class AbstractAIProvider {
-    config;
-    executor;
-    logger;
-    constructor(logger = SilentLogger) {
-        this.logger = logger;
-    }
-    /**
-     * Configure the provider with type-safe configuration
-     */
-    async configure(config) {
-        this.config = config;
-        // Check if config includes executor and set it
-        if (this.hasExecutor(config) && config.executor) {
-            this.executor = config.executor;
-        }
-        // Subclasses can override for additional setup
-    }
-    hasExecutor(config) {
-        return typeof config === 'object' && config !== null && 'executor' in config;
-    }
-    /**
-     * Provider-agnostic raw response API.
-     *
-     * This is the canonical "raw payload" entrypoint required by the AIProvider contract.
-     * The default implementation delegates to `chat()` and adapts the result into a
-     * RawProviderResponse shape.
-     */
-    async generateResponse(payload) {
-        const response = await this.chat(payload.messages, {
-            ...(payload.model !== undefined && { model: payload.model }),
-            ...(payload.temperature !== undefined && { temperature: payload.temperature }),
-            ...(payload.maxTokens !== undefined && { maxTokens: payload.maxTokens }),
-            ...(payload.tools !== undefined && { tools: payload.tools }),
-        });
-        return {
-            content: response.content ?? null,
-            toolCalls: isAssistantMessage(response) ? response.toolCalls : undefined,
-            model: payload.model,
-            metadata: payload.metadata,
-        };
-    }
-    /**
-     * Provider-agnostic raw streaming API.
-     *
-     * If a provider does not implement chatStream, it does not support streaming.
-     */
-    async *generateStreamingResponse(payload) {
-        if (!this.chatStream) {
-            throw new Error(`[AI-PROVIDER] Streaming is not supported by provider "${this.name}"`);
-        }
-        for await (const chunk of this.chatStream(payload.messages, {
-            ...(payload.model !== undefined && { model: payload.model }),
-            ...(payload.temperature !== undefined && { temperature: payload.temperature }),
-            ...(payload.maxTokens !== undefined && { maxTokens: payload.maxTokens }),
-            ...(payload.tools !== undefined && { tools: payload.tools }),
-        })) {
-            yield {
-                content: chunk.content ?? null,
-                toolCalls: isAssistantMessage(chunk) ? chunk.toolCalls : undefined,
-                model: payload.model,
-                metadata: payload.metadata,
-            };
-        }
-    }
-    /**
-     * Default implementation - most modern providers support tools
-     * @returns true if tool calling is supported
-     */
-    supportsTools() {
-        return true;
-    }
-    /**
-     * Default implementation - providers can override for specific validation
-     * @returns true if configuration is valid
-     */
-    validateConfig() {
-        return true;
-    }
-    /**
-     * Utility method for validating TUniversalMessage array
-     * @param messages - Messages to validate
-     */
-    validateMessages(messages) {
-        if (!Array.isArray(messages)) {
-            throw new Error('Messages must be an array');
-        }
-        if (messages.length === 0) {
-            throw new Error('Messages array cannot be empty');
-        }
-        for (const message of messages) {
-            if (!message.role || !['user', 'assistant', 'system', 'tool'].includes(message.role)) {
-                throw new Error(`Invalid message role: ${message.role}`);
-            }
-        }
-    }
-    /**
-     * Utility method for validating tool schemas
-     * @param tools - Tool schemas to validate
-     */
-    validateTools(tools) {
-        if (!tools)
-            return;
-        if (!Array.isArray(tools)) {
-            throw new Error('Tools must be an array');
-        }
-        for (const tool of tools) {
-            if (!tool.name || typeof tool.name !== 'string') {
-                throw new Error('Tool must have a valid name');
-            }
-            if (!tool.description || typeof tool.description !== 'string') {
-                throw new Error('Tool must have a valid description');
-            }
-            if (!tool.parameters ||
-                typeof tool.parameters !== 'object' ||
-                tool.parameters === null ||
-                Array.isArray(tool.parameters)) {
-                throw new Error('Tool must have valid parameters');
-            }
-        }
-    }
-    /**
-     * Execute chat via executor.
-     *
-     * Subclasses should call this only when an executor is configured.
-     */
-    async executeViaExecutorOrDirect(messages, options) {
-        if (!this.executor) {
-            throw new Error(`Executor is required for ${this.name} provider. Configure an executor or use direct execution path.`);
-        }
-        if (!options?.model) {
-            throw new Error(`Model is required for executor execution in ${this.name} provider.`);
-        }
-        const result = await this.executor.executeChat({
-            messages,
-            options,
-            provider: this.name,
-            model: options.model,
-            ...(options.tools && { tools: options.tools }),
-        });
-        return result;
-    }
-    /**
-     * Execute streaming chat via executor.
-     *
-     * Subclasses should call this only when an executor is configured.
-     */
-    async *executeStreamViaExecutorOrDirect(messages, options) {
-        if (!this.executor || !this.executor.executeChatStream) {
-            throw new Error(`Streaming executor is required for ${this.name} provider.`);
-        }
-        if (!options?.model) {
-            throw new Error(`Model is required for executor streaming in ${this.name} provider.`);
-        }
-        // 🔍 [TOOL-FLOW] AbstractAIProvider.executeStreamViaExecutorOrDirect() - Preparing executor request
-        this.logger.debug?.('🔍 [TOOL-FLOW] AbstractAIProvider.executeStreamViaExecutorOrDirect() - Executor request', {
-            provider: this.name,
-            model: options.model,
-            hasTools: !!options.tools,
-            toolsCount: options.tools?.length || 0,
-            toolNames: options.tools?.map((t) => t.name) || [],
-        });
-        const stream = this.executor.executeChatStream({
-            messages,
-            options,
-            provider: this.name,
-            model: options.model,
-            stream: true,
-            ...(options.tools && { tools: options.tools }),
-        });
-        for await (const chunk of stream) {
-            yield chunk;
-        }
-        return;
-    }
-    /**
-     * Clean up resources when provider is no longer needed
-     * Override this method in subclasses for additional cleanup
-     */
-    async dispose() {
-        // Clean up executor if present
-        if (this.executor?.dispose) {
-            await this.executor.dispose();
-        }
-        // Subclasses can override for additional cleanup
-    }
-}
-//# sourceMappingURL=abstract-ai-provider.js.map

package/dist/abstracts/abstract-ai-provider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract-ai-provider.js","sourceRoot":"","sources":["../../src/abstracts/abstract-ai-provider.ts"],"names":[],"mappings":"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"}