@robota-sdk/agent-core 3.0.0-beta.7 → 3.0.0-beta.71

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@robota-sdk/agent-core",
-  "version": "3.0.0-beta.7",
+  "version": "3.0.0-beta.71",
   "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": {
     ".": {
       "types": "./dist/node/index.d.ts",
+      "source": "./src/index.ts",
       "node": {
         "import": "./dist/node/index.js",
         "require": "./dist/node/index.cjs"
@@ -79,7 +79,7 @@
     "eslint": "^8.56.0",
     "openapi-types": "^12.1.3",
     "rimraf": "^5.0.5",
-    "tsup": "^8.0.1",
+    "tsdown": "^0.22.0",
     "typescript": "^5.3.3",
     "vitest": "^1.1.0"
   },
@@ -87,15 +87,18 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsdown",
+    "build:js": "tsdown --no-dts",
+    "build:types": "tsdown --dts",
     "dev": "tsup --watch",
     "clean": "rimraf dist",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "lint": "eslint src --ext .ts,.tsx",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint:fix": "eslint src --ext .ts,.tsx --fix",
     "scenario:verify": "pnpm exec tsx examples/verify-offline.ts",
-    "scenario:record": "node ../../scripts/harness/record-owner-scenario.mjs --scope packages/agents --output examples/scenarios/offline-verify.record.json -- pnpm scenario:verify"
+    "scenario:record": "node ../../scripts/harness/record-owner-scenario.mjs --scope packages/agent-core --output examples/scenarios/offline-verify.record.json -- pnpm scenario:verify"
   }
 }

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,CAC/B,OAAO,GAAG,YAAY,EACtB,QAAQ,GAAG,WAAW,EACtB,QAAQ,GAAG,iBAAiB,CAC9B,YAAW,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC5C,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;CAIjC"}

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;IAKrB,OAAO,GAAe,EAAE,CAAC;IACzB,aAAa,GAAG,KAAK,CAAC;IACtB,MAAM,CAAW;IAO3B;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,MAAe;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACnC,CAAC;IAYD;;OAEG;IACH,UAAU;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,YAAY;QACR,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACO,UAAU,CAAC,OAAiB;QAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,KAAa;QACjC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACxD,CAAC;IACL,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC9B,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC/B,CAAC;CACJ"}

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

@@ -1,187 +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/agents:
- *    ```typescript
- *    import { AbstractAIProvider } from '@robota-sdk/agents';
- *    import type {
- *        TUniversalMessage,
- *        ChatOptions,
- *        IToolCall,
- *        ToolSchema,
- *        AssistantMessage
- *    } from '@robota-sdk/agents';
- *    ```
- *
- * 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/agents:
- *    - 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>;
-    /**
-     * 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
-     */
-    abstract 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,252 +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/agents:
- *    ```typescript
- *    import { AbstractAIProvider } from '@robota-sdk/agents';
- *    import type {
- *        TUniversalMessage,
- *        ChatOptions,
- *        IToolCall,
- *        ToolSchema,
- *        AssistantMessage
- *    } from '@robota-sdk/agents';
- *    ```
- *
- * 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/agents:
- *    - 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 (config && typeof config === 'object' && 'executor' in config && config.executor) {
-            this.executor = config.executor;
-        }
-        // Subclasses can override for additional setup
-    }
-    /**
-     * 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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"}