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

package/dist/interfaces/manager.d.ts

@@ -1,142 +0,0 @@
-import type { IAIProvider, IToolSchema } from './provider';
-import type { ITool, TToolExecutor, IToolExecutionContext, TToolParameters } from './tool';
-import type { TUniversalValue } from './types';
-import type { IAgentConfig, IAgent } from './agent';
-/**
- * Reusable type definitions for manager layer
- */
-/**
- * Agent creation metadata type
- * Used for storing additional information about agent creation and configuration
- */
-export type TAgentCreationMetadata = Record<string, string | number | boolean | Date>;
-/**
- * Tool execution parameters for manager operations
- * Used for tool parameter validation and execution in manager context
- */
-export type TManagerToolParameters = Record<string, string | number | boolean | string[] | number[] | boolean[]>;
-/**
- * Configuration validation result
- */
-export interface IConfigValidationResult {
-    isValid: boolean;
-    errors: string[];
-    warnings?: string[];
-}
-/**
- * AI Provider Manager interface for provider registration and selection
- */
-export interface IAIProviderManager {
-    /**
-     * Register an AI provider
-     */
-    addProvider(name: string, provider: IAIProvider): void;
-    /**
-     * Remove an AI provider
-     */
-    removeProvider(name: string): void;
-    /**
-     * Get registered provider by name
-     */
-    getProvider(name: string): IAIProvider | undefined;
-    /**
-     * Get all registered providers
-     */
-    getProviders(): Record<string, IAIProvider>;
-    /**
-     * Set current provider and model
-     */
-    setCurrentProvider(name: string, model: string): void;
-    /**
-     * Get current provider and model
-     */
-    getCurrentProvider(): {
-        provider: string;
-        model: string;
-    } | undefined;
-    /**
-     * Check if provider is configured
-     */
-    isConfigured(): boolean;
-    /**
-     * Get available models for a provider
-     */
-    getAvailableModels(providerName: string): string[];
-}
-/**
- * Tool Manager interface for tool registration and management
- */
-export interface IToolManager {
-    /**
-     * Register a tool
-     */
-    addTool(schema: IToolSchema, executor: TToolExecutor): void;
-    /**
-     * Remove a tool by name
-     */
-    removeTool(name: string): void;
-    /**
-     * Get tool interface by name
-     */
-    getTool(name: string): ITool | undefined;
-    /**
-     * Get tool schema by name
-     */
-    getToolSchema(name: string): IToolSchema | undefined;
-    /**
-     * Get all registered tools
-     */
-    getTools(): IToolSchema[];
-    /**
-     * Execute a tool
-     */
-    executeTool(name: string, parameters: TToolParameters, context?: IToolExecutionContext): Promise<TUniversalValue>;
-    /**
-     * Check if tool exists
-     */
-    hasTool(name: string): boolean;
-    /**
-     * Set allowed tools (for filtering)
-     */
-    setAllowedTools(tools: string[]): void;
-    /**
-     * Get allowed tools
-     */
-    getAllowedTools(): string[] | undefined;
-}
-/**
- * Agent creation options
- */
-export interface IAgentCreationOptions {
-    /** Override default configuration */
-    overrides?: Partial<IAgentConfig>;
-    /** Validation options */
-    validation?: {
-        strict?: boolean;
-        skipOptional?: boolean;
-    };
-    /** Additional metadata */
-    metadata?: TAgentCreationMetadata;
-}
-/**
- * Agent Factory interface for agent creation and configuration
- */
-export interface IAgentFactory {
-    /**
-     * Create agent instance
-     */
-    createAgent(config: IAgentConfig, options?: IAgentCreationOptions): IAgent<IAgentConfig>;
-    /**
-     * Validate agent configuration
-     */
-    validateConfig(config: IAgentConfig): IConfigValidationResult;
-    /**
-     * Get default configuration
-     */
-    getDefaultConfig(): IAgentConfig;
-    /**
-     * Merge configurations
-     */
-    mergeConfig(base: IAgentConfig, override: Partial<IAgentConfig>): IAgentConfig;
-}
-//# sourceMappingURL=manager.d.ts.map

package/dist/interfaces/manager.d.ts.map

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

package/dist/interfaces/manager.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=manager.js.map

package/dist/interfaces/manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/interfaces/manager.ts"],"names":[],"mappings":""}

package/dist/interfaces/media-provider.d.ts

@@ -1,86 +0,0 @@
-import type { TUniversalValue } from './types';
-/**
- * Provider-agnostic media output reference.
- * Providers must not return raw binary payloads in this contract.
- */
-export interface IMediaOutputRef {
-    kind: 'asset' | 'uri';
-    assetId?: string;
-    uri?: string;
-    mimeType?: string;
-    bytes?: number;
-}
-export interface IProviderMediaError {
-    code: 'PROVIDER_AUTH_ERROR' | 'PROVIDER_RATE_LIMITED' | 'PROVIDER_TIMEOUT' | 'PROVIDER_INVALID_REQUEST' | 'PROVIDER_UPSTREAM_ERROR' | 'PROVIDER_JOB_NOT_FOUND' | 'PROVIDER_JOB_NOT_CANCELLABLE';
-    message: string;
-    details?: Record<string, TUniversalValue>;
-}
-export type TProviderMediaResult<TValue> = {
-    ok: true;
-    value: TValue;
-} | {
-    ok: false;
-    error: IProviderMediaError;
-};
-export interface IInlineImageInputSource {
-    kind: 'inline';
-    mimeType: string;
-    data: string;
-}
-export interface IUriImageInputSource {
-    kind: 'uri';
-    uri: string;
-    mimeType?: string;
-}
-export type TImageInputSource = IInlineImageInputSource | IUriImageInputSource;
-export interface IImageGenerationRequest {
-    prompt: string;
-    model: string;
-}
-export interface IImageEditRequest {
-    image: TImageInputSource;
-    prompt: string;
-    model: string;
-}
-export interface IImageComposeRequest {
-    images: TImageInputSource[];
-    prompt: string;
-    model: string;
-}
-export interface IImageGenerationResult {
-    outputs: IMediaOutputRef[];
-    model: string;
-}
-export interface IImageGenerationProvider {
-    generateImage(request: IImageGenerationRequest): Promise<TProviderMediaResult<IImageGenerationResult>>;
-    editImage?(request: IImageEditRequest): Promise<TProviderMediaResult<IImageGenerationResult>>;
-    composeImage?(request: IImageComposeRequest): Promise<TProviderMediaResult<IImageGenerationResult>>;
-}
-export interface IVideoGenerationRequest {
-    prompt: string;
-    model: string;
-    durationSeconds?: number;
-    aspectRatio?: string;
-    seed?: number;
-    inputImages?: TImageInputSource[];
-}
-export interface IVideoJobAccepted {
-    jobId: string;
-    status: 'queued' | 'running';
-    createdAt: string;
-}
-export interface IVideoJobSnapshot {
-    jobId: string;
-    status: 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';
-    output?: IMediaOutputRef;
-    error?: IProviderMediaError;
-    updatedAt: string;
-}
-export interface IVideoGenerationProvider {
-    createVideo(request: IVideoGenerationRequest): Promise<TProviderMediaResult<IVideoJobAccepted>>;
-    getVideoJob(jobId: string): Promise<TProviderMediaResult<IVideoJobSnapshot>>;
-    cancelVideoJob(jobId: string): Promise<TProviderMediaResult<IVideoJobSnapshot>>;
-}
-export declare function isImageGenerationProvider(provider: object): provider is IImageGenerationProvider;
-export declare function isVideoGenerationProvider(provider: object): provider is IVideoGenerationProvider;
-//# sourceMappingURL=media-provider.d.ts.map

package/dist/interfaces/media-provider.d.ts.map

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

package/dist/interfaces/media-provider.js

@@ -1,13 +0,0 @@
-export function isImageGenerationProvider(provider) {
-    return ('generateImage' in provider &&
-        typeof provider.generateImage === 'function');
-}
-export function isVideoGenerationProvider(provider) {
-    return ('createVideo' in provider &&
-        'getVideoJob' in provider &&
-        'cancelVideoJob' in provider &&
-        typeof provider.createVideo === 'function' &&
-        typeof provider.getVideoJob === 'function' &&
-        typeof provider.cancelVideoJob === 'function');
-}
-//# sourceMappingURL=media-provider.js.map

package/dist/interfaces/media-provider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"media-provider.js","sourceRoot":"","sources":["../../src/interfaces/media-provider.ts"],"names":[],"mappings":"AA0GA,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,CACL,eAAe,IAAI,QAAQ;QAC3B,OACE,QAGD,CAAC,aAAa,KAAK,UAAU,CAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,CACL,aAAa,IAAI,QAAQ;QACzB,aAAa,IAAI,QAAQ;QACzB,gBAAgB,IAAI,QAAQ;QAC5B,OACE,QAGD,CAAC,WAAW,KAAK,UAAU;QAC5B,OACE,QAGD,CAAC,WAAW,KAAK,UAAU;QAC5B,OACE,QAGD,CAAC,cAAc,KAAK,UAAU,CAChC,CAAC;AACJ,CAAC"}

package/dist/interfaces/messages.d.ts

@@ -1,97 +0,0 @@
-/**
- * Message Contracts (Single Source of Truth)
- *
- * IMPORTANT:
- * - This module is owned by the `interfaces` layer.
- * - All message types used across the SDK must be defined here to avoid drift.
- * - Runtime values (variables/classes/objects) and compile-time types can share the same name in TypeScript.
- *   Prefixing type aliases (`T*`) and interfaces (`I*`) reduces value/type name collision risk and review overhead.
- */
-/**
- * Universal message role type - provider-independent neutral role.
- */
-export type TUniversalMessageRole = 'user' | 'assistant' | 'system' | 'tool';
-/**
- * Message metadata used across conversation history and provider adapters.
- */
-export type TUniversalMessageMetadata = Record<string, string | number | boolean | Date | string[] | number[] | Record<string, number>>;
-/**
- * Universal multimodal message part contracts.
- */
-export interface ITextMessagePart {
-    type: 'text';
-    text: string;
-}
-export interface IInlineImageMessagePart {
-    type: 'image_inline';
-    mimeType: string;
-    data: string;
-}
-export interface IUriImageMessagePart {
-    type: 'image_uri';
-    uri: string;
-    mimeType?: string;
-}
-export type TUniversalMessagePart = ITextMessagePart | IInlineImageMessagePart | IUriImageMessagePart;
-/**
- * Tool call (OpenAI tool calling format).
- */
-export interface IToolCall {
-    id: string;
-    type: 'function';
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-/**
- * Base message contract shared by all message variants.
- */
-export interface IBaseMessage {
-    /** Message creation timestamp */
-    timestamp: Date;
-    /** Additional metadata */
-    metadata?: TUniversalMessageMetadata;
-}
-export interface IUserMessage extends IBaseMessage {
-    role: 'user';
-    content: string;
-    parts?: TUniversalMessagePart[];
-    name?: string;
-}
-export interface IAssistantMessage extends IBaseMessage {
-    role: 'assistant';
-    /** Assistant response content (can be null when making tool calls) */
-    content: string | null;
-    parts?: TUniversalMessagePart[];
-    toolCalls?: IToolCall[];
-}
-export interface ISystemMessage extends IBaseMessage {
-    role: 'system';
-    content: string;
-    parts?: TUniversalMessagePart[];
-    name?: string;
-}
-export interface IToolMessage extends IBaseMessage {
-    role: 'tool';
-    content: string;
-    parts?: TUniversalMessagePart[];
-    toolCallId: string;
-    name?: string;
-}
-/**
- * Universal message union used across the SDK as the canonical contract.
- */
-export type TUniversalMessage = IUserMessage | IAssistantMessage | ISystemMessage | IToolMessage;
-/**
- * Type guards for the canonical TUniversalMessage union.
- *
- * NOTE:
- * - These guards are owned by the `interfaces` layer and must not depend on managers/services.
- * - Call sites should use these guards instead of importing from manager layers.
- */
-export declare function isUserMessage(message: TUniversalMessage): message is IUserMessage;
-export declare function isAssistantMessage(message: TUniversalMessage): message is IAssistantMessage;
-export declare function isSystemMessage(message: TUniversalMessage): message is ISystemMessage;
-export declare function isToolMessage(message: TUniversalMessage): message is IToolMessage;
-//# sourceMappingURL=messages.d.ts.map

package/dist/interfaces/messages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/interfaces/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAC5C,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAChF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,uBAAuB,GACvB,oBAAoB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,yBAAyB,CAAC;CACtC;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,IAAI,EAAE,WAAW,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,iBAAiB,GAAG,cAAc,GAAG,YAAY,CAAC;AAEjG;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,IAAI,YAAY,CAEjF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,IAAI,iBAAiB,CAE3F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,IAAI,cAAc,CAErF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,IAAI,YAAY,CAEjF"}

package/dist/interfaces/messages.js

@@ -1,29 +0,0 @@
-/**
- * Message Contracts (Single Source of Truth)
- *
- * IMPORTANT:
- * - This module is owned by the `interfaces` layer.
- * - All message types used across the SDK must be defined here to avoid drift.
- * - Runtime values (variables/classes/objects) and compile-time types can share the same name in TypeScript.
- *   Prefixing type aliases (`T*`) and interfaces (`I*`) reduces value/type name collision risk and review overhead.
- */
-/**
- * Type guards for the canonical TUniversalMessage union.
- *
- * NOTE:
- * - These guards are owned by the `interfaces` layer and must not depend on managers/services.
- * - Call sites should use these guards instead of importing from manager layers.
- */
-export function isUserMessage(message) {
-    return message.role === 'user';
-}
-export function isAssistantMessage(message) {
-    return message.role === 'assistant';
-}
-export function isSystemMessage(message) {
-    return message.role === 'system';
-}
-export function isToolMessage(message) {
-    return message.role === 'tool';
-}
-//# sourceMappingURL=messages.js.map

package/dist/interfaces/messages.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/interfaces/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiGH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;AACjC,CAAC"}

package/dist/interfaces/progress-reporting.d.ts

@@ -1,86 +0,0 @@
-import type { ITool, TToolParameters } from './tool';
-/**
- * Execution step definition for tools that support step-by-step progress reporting
- */
-export interface IToolExecutionStep {
-    /** Unique identifier for this step */
-    id: string;
-    /** Human-readable name of the step */
-    name: string;
-    /** Tool-provided estimated duration for this step in milliseconds */
-    estimatedDuration: number;
-    /** Optional description of what this step does */
-    description?: string;
-}
-/**
- * Progress callback function type for real-time progress updates
- */
-export type TToolProgressCallback = (step: string, progress: number) => void;
-/**
- * 🆕 IProgressReportingTool - Optional interface for tools that can provide their own progress information
- *
- * This interface extends the standard ITool to allow tools to optionally provide:
- * - Estimated execution duration
- * - Step-by-step execution plans
- * - Real-time progress callbacks
- *
- * Benefits:
- * - Tools can provide accurate progress information based on their internal knowledge
- * - No simulation or fake progress - only real tool-provided estimates
- * - Completely optional - existing tools work unchanged
- * - Tools can self-report progress for better user experience
- */
-export interface IProgressReportingTool extends ITool {
-    /**
-     * Get estimated execution duration for given parameters (optional)
-     *
-     * Tools can implement this to provide accurate time estimates based on:
-     * - Parameter complexity (e.g., search query length, file size)
-     * - Historical execution data
-     * - Internal optimization knowledge
-     *
-     * @param parameters - The parameters that will be passed to execute()
-     * @returns Estimated duration in milliseconds, or undefined if not available
-     */
-    getEstimatedDuration?(parameters: TToolParameters): number;
-    /**
-     * Get execution steps for given parameters (optional)
-     *
-     * Tools can implement this to provide step-by-step execution plans:
-     * - webSearch: [query processing, API call, result parsing, filtering]
-     * - fileSearch: [file scanning, content reading, pattern matching, result formatting]
-     * - github-mcp: [authentication, API request, response processing, data transformation]
-     *
-     * @param parameters - The parameters that will be passed to execute()
-     * @returns Array of execution steps, or undefined if not available
-     */
-    getExecutionSteps?(parameters: TToolParameters): IToolExecutionStep[];
-    /**
-     * Set progress callback for real-time updates (optional)
-     *
-     * Tools can implement this to provide real-time progress updates during execution:
-     * - Called when each step starts/completes
-     * - Progress value between 0-100 representing completion percentage
-     * - Step name helps users understand what's currently happening
-     *
-     * @param callback - Function to call with progress updates
-     */
-    setProgressCallback?(callback: TToolProgressCallback): void;
-}
-/**
- * Type guard to check if a tool implements progress reporting
- */
-export declare function isProgressReportingTool(tool: ITool): tool is IProgressReportingTool;
-/**
- * Helper function to safely get estimated duration from any tool
- */
-export declare function getToolEstimatedDuration(tool: ITool, parameters: TToolParameters): number | undefined;
-/**
- * Helper function to safely get execution steps from any tool
- */
-export declare function getToolExecutionSteps(tool: ITool, parameters: TToolParameters): IToolExecutionStep[] | undefined;
-/**
- * Helper function to safely set progress callback on any tool
- */
-export declare function setToolProgressCallback(tool: ITool, callback: TToolProgressCallback): boolean;
-//# sourceMappingURL=progress-reporting.d.ts.map

package/dist/interfaces/progress-reporting.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"progress-reporting.d.ts","sourceRoot":"","sources":["../../src/interfaces/progress-reporting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IAEX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAE1B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;AAE7E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sBAAuB,SAAQ,KAAK;IACnD;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAAC;IAE3D;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,CAAC,UAAU,EAAE,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAEtE;;;;;;;;;OASG;IACH,mBAAmB,CAAC,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC7D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,sBAAsB,CAInF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,KAAK,EACX,UAAU,EAAE,eAAe,GAC1B,MAAM,GAAG,SAAS,CAKpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,KAAK,EACX,UAAU,EAAE,eAAe,GAC1B,kBAAkB,EAAE,GAAG,SAAS,CAKlC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAM7F"}

package/dist/interfaces/progress-reporting.js

@@ -1,35 +0,0 @@
-/**
- * Type guard to check if a tool implements progress reporting
- */
-export function isProgressReportingTool(tool) {
-    return ('getEstimatedDuration' in tool || 'getExecutionSteps' in tool || 'setProgressCallback' in tool);
-}
-/**
- * Helper function to safely get estimated duration from any tool
- */
-export function getToolEstimatedDuration(tool, parameters) {
-    if (isProgressReportingTool(tool) && tool.getEstimatedDuration) {
-        return tool.getEstimatedDuration(parameters);
-    }
-    return undefined;
-}
-/**
- * Helper function to safely get execution steps from any tool
- */
-export function getToolExecutionSteps(tool, parameters) {
-    if (isProgressReportingTool(tool) && tool.getExecutionSteps) {
-        return tool.getExecutionSteps(parameters);
-    }
-    return undefined;
-}
-/**
- * Helper function to safely set progress callback on any tool
- */
-export function setToolProgressCallback(tool, callback) {
-    if (isProgressReportingTool(tool) && tool.setProgressCallback) {
-        tool.setProgressCallback(callback);
-        return true;
-    }
-    return false;
-}
-//# sourceMappingURL=progress-reporting.js.map

package/dist/interfaces/progress-reporting.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"progress-reporting.js","sourceRoot":"","sources":["../../src/interfaces/progress-reporting.ts"],"names":[],"mappings":"AA8EA;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAW;IACjD,OAAO,CACL,sBAAsB,IAAI,IAAI,IAAI,mBAAmB,IAAI,IAAI,IAAI,qBAAqB,IAAI,IAAI,CAC/F,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAW,EACX,UAA2B;IAE3B,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAW,EACX,UAA2B;IAE3B,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAW,EAAE,QAA+B;IAClF,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC9D,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}