@pie-players/pie-assessment-toolkit 0.2.0

package/dist/services/tool-providers/IToolProvider.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Tool Provider Interface
+ *
+ * Unified interface for all assessment tools that require
+ * configuration, authentication, or external services.
+ *
+ * Examples: Desmos calculators, TI calculators, TTS services,
+ * translation services, dictionary APIs, etc.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+/**
+ * Tool category classification
+ */
+export type ToolCategory = "calculator" | "tts" | "translation" | "dictionary" | "annotation" | "accessibility" | "other";
+/**
+ * Tool provider capabilities descriptor
+ *
+ * Describes what features and limitations a provider has.
+ */
+export interface ToolProviderCapabilities {
+    /**
+     * Can be used offline (no network required)
+     */
+    supportsOffline: boolean;
+    /**
+     * Requires API key or authentication
+     */
+    requiresAuth: boolean;
+    /**
+     * Maximum concurrent instances (null = unlimited)
+     */
+    maxInstances?: number | null;
+    /**
+     * Provider-specific capabilities/features
+     * @example { graphing: true, scientific: true, basic: true }
+     */
+    features: Record<string, boolean>;
+}
+/**
+ * Tool Provider Interface
+ *
+ * Base interface for all tool providers in the assessment toolkit.
+ * Providers are stateless factories that create configured tool instances.
+ *
+ * @template TConfig Configuration type for this provider
+ * @template TInstance Instance type created by this provider
+ *
+ * @example
+ * ```typescript
+ * class DesmosToolProvider implements IToolProvider<DesmosConfig, CalculatorProvider> {
+ *   readonly providerId = 'desmos-calculator';
+ *   readonly providerName = 'Desmos Calculator';
+ *   readonly category = 'calculator';
+ *   // ...
+ * }
+ * ```
+ */
+export interface IToolProvider<TConfig = any, TInstance = any> {
+    /**
+     * Unique identifier for this provider
+     *
+     * @example 'desmos-calculator', 'aws-polly-tts', 'ti-calculator'
+     */
+    readonly providerId: string;
+    /**
+     * Human-readable provider name
+     *
+     * @example 'Desmos Calculator', 'AWS Polly TTS'
+     */
+    readonly providerName: string;
+    /**
+     * Tool category for this provider
+     *
+     * @example 'calculator', 'tts', 'translation'
+     */
+    readonly category: ToolCategory;
+    /**
+     * Provider version
+     *
+     * @example '1.0', '2.5', '1.10'
+     */
+    readonly version: string;
+    /**
+     * Does this provider require authentication/API keys?
+     *
+     * When true, the provider should be initialized with auth credentials
+     * or an authFetcher function to retrieve them from a backend service.
+     */
+    readonly requiresAuth: boolean;
+    /**
+     * Initialize the provider
+     *
+     * Sets up the provider with configuration and prepares it for use.
+     * For auth-based providers, this is where API keys/tokens are validated.
+     *
+     * @param config Provider configuration (may include auth)
+     * @returns Promise that resolves when provider is ready
+     * @throws Error if initialization fails
+     */
+    initialize(config: TConfig): Promise<void>;
+    /**
+     * Create a tool instance
+     *
+     * Creates a configured instance of the tool ready for use.
+     * The provider must be initialized before calling this method.
+     *
+     * @param config Instance-specific configuration (optional)
+     * @returns Tool instance ready for use
+     * @throws Error if provider not initialized
+     */
+    createInstance(config?: Partial<TConfig>): Promise<TInstance>;
+    /**
+     * Get provider capabilities
+     *
+     * Returns a description of what this provider supports.
+     *
+     * @returns Capabilities descriptor
+     */
+    getCapabilities(): ToolProviderCapabilities;
+    /**
+     * Check if provider is ready to use
+     *
+     * Returns true if initialize() has completed successfully.
+     *
+     * @returns true if provider is initialized and ready
+     */
+    isReady(): boolean;
+    /**
+     * Clean up provider resources
+     *
+     * Destroys the provider and releases any resources (connections, timers, etc.).
+     * After calling this, the provider should not be used.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=IToolProvider.d.ts.map

package/dist/services/tool-providers/IToolProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolProvider.d.ts","sourceRoot":"","sources":["../../../src/services/tool-providers/IToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,YAAY,GACZ,KAAK,GACL,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,OAAO,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACxC;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,eAAe,IAAI,wBAAwB,CAAC;IAE5C;;;;;;OAMG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB"}

package/dist/services/tool-providers/IToolProvider.js

@@ -0,0 +1,13 @@
+/**
+ * Tool Provider Interface
+ *
+ * Unified interface for all assessment tools that require
+ * configuration, authentication, or external services.
+ *
+ * Examples: Desmos calculators, TI calculators, TTS services,
+ * translation services, dictionary APIs, etc.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+export {};
+//# sourceMappingURL=IToolProvider.js.map

package/dist/services/tool-providers/IToolProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolProvider.js","sourceRoot":"","sources":["../../../src/services/tool-providers/IToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/services/tool-providers/TIToolProvider.d.ts

@@ -0,0 +1,107 @@
+/**
+ * TI Calculator Tool Provider
+ *
+ * Provides Texas Instruments calculator emulators (TI-84, TI-108, TI-34 MV).
+ *
+ * NOTE: Requires licensed TI emulator libraries from Texas Instruments.
+ * These libraries must be hosted on your server at /lib/ti/{version}/
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { CalculatorProvider, TICalculatorConfig } from "@pie-players/pie-calculator";
+import type { IToolProvider, ToolProviderCapabilities } from "./IToolProvider";
+/**
+ * TI tool provider configuration
+ */
+export interface TIToolProviderConfig {
+    /**
+     * Base URL for TI emulator libraries
+     * @default '/lib/ti'
+     * @example '/static/calculators/ti'
+     * @example 'https://cdn.example.com/ti'
+     */
+    libraryBaseUrl?: string;
+    /**
+     * TI emulator version to load
+     * @default 'v2.8.0'
+     */
+    version?: string;
+    /**
+     * Default calculator configuration applied to all instances
+     */
+    defaultConfig?: TICalculatorConfig;
+    /**
+     * Restricted mode (test mode) - disables certain features
+     * @default false
+     */
+    restrictedMode?: boolean;
+}
+/**
+ * TI Calculator Tool Provider
+ *
+ * Wraps TICalculatorProvider with the IToolProvider interface
+ * for use in the ToolProviderRegistry.
+ *
+ * TI calculators do not require API keys, but DO require
+ * licensed emulator libraries to be hosted on your server.
+ *
+ * @example
+ * ```typescript
+ * const provider = new TIToolProvider();
+ *
+ * await provider.initialize({
+ *   libraryBaseUrl: '/lib/ti',
+ *   version: 'v2.8.0',
+ *   restrictedMode: false,
+ * });
+ *
+ * const calculatorProvider = await provider.createInstance();
+ * ```
+ */
+export declare class TIToolProvider implements IToolProvider<TIToolProviderConfig, CalculatorProvider> {
+    readonly providerId = "ti-calculator";
+    readonly providerName = "Texas Instruments Calculator";
+    readonly category: "calculator";
+    readonly version = "2.8.0";
+    readonly requiresAuth = false;
+    private tiProvider;
+    private config;
+    /**
+     * Initialize TI calculator provider
+     *
+     * Loads the TI emulator libraries (ELG shared library).
+     *
+     * @param config Configuration with library base URL and version
+     * @throws Error if initialization fails or libraries not found
+     */
+    initialize(config: TIToolProviderConfig): Promise<void>;
+    /**
+     * Create a calculator provider instance
+     *
+     * Returns the initialized TI calculator provider.
+     *
+     * @param config Optional instance-specific configuration (currently unused)
+     * @returns TI calculator provider
+     * @throws Error if provider not initialized
+     */
+    createInstance(config?: Partial<TIToolProviderConfig>): Promise<CalculatorProvider>;
+    /**
+     * Get provider capabilities
+     *
+     * @returns TI calculator capabilities
+     */
+    getCapabilities(): ToolProviderCapabilities;
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if provider is initialized
+     */
+    isReady(): boolean;
+    /**
+     * Clean up provider resources
+     *
+     * Destroys the TI calculator provider and releases resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=TIToolProvider.d.ts.map

package/dist/services/tool-providers/TIToolProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TIToolProvider.d.ts","sourceRoot":"","sources":["../../../src/services/tool-providers/TIToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACX,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAEnC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cACZ,YAAW,aAAa,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;IAElE,QAAQ,CAAC,UAAU,mBAAmB;IACtC,QAAQ,CAAC,YAAY,kCAAkC;IACvD,QAAQ,CAAC,QAAQ,EAAG,YAAY,CAAU;IAC1C,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,YAAY,SAAS;IAE9B,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,MAAM,CAAqC;IAEnD;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7D;;;;;;;;OAQG;IACG,cAAc,CACnB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACpC,OAAO,CAAC,kBAAkB,CAAC;IAU9B;;;;OAIG;IACH,eAAe,IAAI,wBAAwB;IAe3C;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAQf"}

package/dist/services/tool-providers/TIToolProvider.js

@@ -0,0 +1,123 @@
+/**
+ * TI Calculator Tool Provider
+ *
+ * Provides Texas Instruments calculator emulators (TI-84, TI-108, TI-34 MV).
+ *
+ * NOTE: Requires licensed TI emulator libraries from Texas Instruments.
+ * These libraries must be hosted on your server at /lib/ti/{version}/
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import { TICalculatorProvider } from "../../tools/calculators/ti-provider";
+/**
+ * TI Calculator Tool Provider
+ *
+ * Wraps TICalculatorProvider with the IToolProvider interface
+ * for use in the ToolProviderRegistry.
+ *
+ * TI calculators do not require API keys, but DO require
+ * licensed emulator libraries to be hosted on your server.
+ *
+ * @example
+ * ```typescript
+ * const provider = new TIToolProvider();
+ *
+ * await provider.initialize({
+ *   libraryBaseUrl: '/lib/ti',
+ *   version: 'v2.8.0',
+ *   restrictedMode: false,
+ * });
+ *
+ * const calculatorProvider = await provider.createInstance();
+ * ```
+ */
+export class TIToolProvider {
+    providerId = "ti-calculator";
+    providerName = "Texas Instruments Calculator";
+    category = "calculator";
+    version = "2.8.0";
+    requiresAuth = false; // No API key needed, but requires licensed libraries
+    tiProvider = null;
+    config = null;
+    /**
+     * Initialize TI calculator provider
+     *
+     * Loads the TI emulator libraries (ELG shared library).
+     *
+     * @param config Configuration with library base URL and version
+     * @throws Error if initialization fails or libraries not found
+     */
+    async initialize(config) {
+        if (this.tiProvider) {
+            console.warn("[TIToolProvider] Already initialized, skipping reinitialization");
+            return;
+        }
+        this.config = config;
+        this.tiProvider = new TICalculatorProvider();
+        // Initialize TI emulator libraries
+        try {
+            await this.tiProvider.initialize();
+            console.log("[TIToolProvider] Initialized successfully (TI emulator libraries loaded)");
+        }
+        catch (error) {
+            console.error("[TIToolProvider] Initialization failed:", error);
+            throw new Error("Failed to initialize TI calculator provider. Ensure TI emulator libraries are available.");
+        }
+    }
+    /**
+     * Create a calculator provider instance
+     *
+     * Returns the initialized TI calculator provider.
+     *
+     * @param config Optional instance-specific configuration (currently unused)
+     * @returns TI calculator provider
+     * @throws Error if provider not initialized
+     */
+    async createInstance(config) {
+        if (!this.tiProvider) {
+            throw new Error("[TIToolProvider] Provider not initialized. Call initialize() first.");
+        }
+        return this.tiProvider;
+    }
+    /**
+     * Get provider capabilities
+     *
+     * @returns TI calculator capabilities
+     */
+    getCapabilities() {
+        return {
+            supportsOffline: true, // Works offline once libraries loaded
+            requiresAuth: false,
+            maxInstances: null, // Unlimited calculator instances
+            features: {
+                "ti-84": true,
+                "ti-108": true,
+                "ti-34-mv": true,
+                graphing: true, // TI-84 supports graphing
+                scientific: true, // All TI models support scientific functions
+            },
+        };
+    }
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if provider is initialized
+     */
+    isReady() {
+        return this.tiProvider !== null;
+    }
+    /**
+     * Clean up provider resources
+     *
+     * Destroys the TI calculator provider and releases resources.
+     */
+    destroy() {
+        if (this.tiProvider) {
+            this.tiProvider.destroy();
+            this.tiProvider = null;
+        }
+        this.config = null;
+        console.log("[TIToolProvider] Destroyed");
+    }
+}
+//# sourceMappingURL=TIToolProvider.js.map

package/dist/services/tool-providers/TIToolProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TIToolProvider.js","sourceRoot":"","sources":["../../../src/services/tool-providers/TIToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAiC3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,cAAc;IAGjB,UAAU,GAAG,eAAe,CAAC;IAC7B,YAAY,GAAG,8BAA8B,CAAC;IAC9C,QAAQ,GAAG,YAAqB,CAAC;IACjC,OAAO,GAAG,OAAO,CAAC;IAClB,YAAY,GAAG,KAAK,CAAC,CAAC,qDAAqD;IAE5E,UAAU,GAAgC,IAAI,CAAC;IAC/C,MAAM,GAAgC,IAAI,CAAC;IAEnD;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,MAA4B;QAC5C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CACX,iEAAiE,CACjE,CAAC;YACF,OAAO;QACR,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,mCAAmC;QACnC,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CACV,0EAA0E,CAC1E,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YAChE,MAAM,IAAI,KAAK,CACd,0FAA0F,CAC1F,CAAC;QACH,CAAC;IACF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CACnB,MAAsC;QAEtC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACd,qEAAqE,CACrE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,eAAe;QACd,OAAO;YACN,eAAe,EAAE,IAAI,EAAE,sCAAsC;YAC7D,YAAY,EAAE,KAAK;YACnB,YAAY,EAAE,IAAI,EAAE,iCAAiC;YACrD,QAAQ,EAAE;gBACT,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI,EAAE,0BAA0B;gBAC1C,UAAU,EAAE,IAAI,EAAE,6CAA6C;aAC/D;SACD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC3C,CAAC;CACD"}

package/dist/services/tool-providers/TTSToolProvider.d.ts

@@ -0,0 +1,143 @@
+/**
+ * TTS Tool Provider
+ *
+ * Unified provider for all TTS backends:
+ * - Browser Web Speech API (no auth)
+ * - AWS Polly (requires auth via server proxy)
+ * - Google Cloud TTS (requires auth via server proxy)
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { ITTSProvider, TTSConfig } from "@pie-players/pie-tts";
+import type { IToolProvider, ToolProviderCapabilities } from "./IToolProvider";
+/**
+ * TTS backend type
+ */
+export type TTSBackend = "browser" | "polly" | "google" | "server";
+/**
+ * TTS tool provider configuration
+ */
+export interface TTSToolProviderConfig extends Partial<TTSConfig> {
+    /**
+     * TTS backend to use
+     */
+    backend: TTSBackend;
+    /**
+     * Server API endpoint (for server backends)
+     * @example '/api/tts/synthesize'
+     * @example 'https://api.example.com/tts/synthesize'
+     */
+    apiEndpoint?: string;
+    /**
+     * Provider to use on server ('polly', 'google')
+     * Only used when backend is 'server', 'polly', or 'google'
+     */
+    serverProvider?: "polly" | "google";
+    /**
+     * Auth token (if required)
+     * Typically fetched via authFetcher in ToolProviderRegistry
+     */
+    authToken?: string;
+    /**
+     * Organization ID for multi-tenant applications
+     */
+    organizationId?: string;
+    /**
+     * Default voice to use
+     */
+    voice?: string;
+    /**
+     * Speech rate (0.25 to 4.0, default 1.0)
+     */
+    rate?: number;
+    /**
+     * Speech pitch (0 to 2, default 1.0)
+     * Note: Only browser backend supports pitch
+     */
+    pitch?: number;
+}
+/**
+ * TTS Tool Provider
+ *
+ * Wraps TTS providers (Browser, Polly, Google) with the IToolProvider interface
+ * for use in the ToolProviderRegistry.
+ *
+ * @example Browser TTS (no auth)
+ * ```typescript
+ * const provider = new TTSToolProvider();
+ * await provider.initialize({ backend: 'browser' });
+ * const ttsProvider = await provider.createInstance();
+ * ```
+ *
+ * @example Server TTS (with auth)
+ * ```typescript
+ * const provider = new TTSToolProvider();
+ * await provider.initialize({
+ *   backend: 'polly',
+ *   apiEndpoint: '/api/tts/synthesize',
+ *   authToken: 'bearer-token', // Fetched via authFetcher
+ * });
+ * const ttsProvider = await provider.createInstance();
+ * ```
+ */
+export declare class TTSToolProvider implements IToolProvider<TTSToolProviderConfig, ITTSProvider> {
+    readonly providerId = "tts-service";
+    readonly providerName = "Text-to-Speech";
+    readonly category: "tts";
+    readonly version = "1.0";
+    readonly requiresAuth: boolean;
+    private ttsProvider;
+    private config;
+    /**
+     * Create TTS tool provider
+     *
+     * @param backend TTS backend to use (default: 'browser')
+     */
+    constructor(backend?: TTSBackend);
+    /**
+     * Initialize TTS provider
+     *
+     * Sets up the appropriate TTS backend.
+     *
+     * @param config Configuration with backend type and credentials
+     * @throws Error if initialization fails or required config missing
+     */
+    initialize(config: TTSToolProviderConfig): Promise<void>;
+    /**
+     * Initialize browser TTS (Web Speech API)
+     */
+    private _initializeBrowserTTS;
+    /**
+     * Initialize server-based TTS (Polly, Google)
+     */
+    private _initializeServerTTS;
+    /**
+     * Create a TTS provider instance
+     *
+     * Returns the initialized TTS provider.
+     *
+     * @param config Optional instance-specific configuration (currently unused)
+     * @returns TTS provider
+     * @throws Error if provider not initialized
+     */
+    createInstance(config?: Partial<TTSToolProviderConfig>): Promise<ITTSProvider>;
+    /**
+     * Get provider capabilities
+     *
+     * @returns TTS capabilities based on backend
+     */
+    getCapabilities(): ToolProviderCapabilities;
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if provider is initialized
+     */
+    isReady(): boolean;
+    /**
+     * Clean up provider resources
+     *
+     * Destroys the TTS provider and releases resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=TTSToolProvider.d.ts.map

package/dist/services/tool-providers/TTSToolProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TTSToolProvider.d.ts","sourceRoot":"","sources":["../../../src/services/tool-providers/TTSToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,OAAO,CAAC,SAAS,CAAC;IAChE;;OAEG;IACH,OAAO,EAAE,UAAU,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eACZ,YAAW,aAAa,CAAC,qBAAqB,EAAE,YAAY,CAAC;IAE7D,QAAQ,CAAC,UAAU,iBAAiB;IACpC,QAAQ,CAAC,YAAY,oBAAoB;IACzC,QAAQ,CAAC,QAAQ,EAAG,KAAK,CAAU;IACnC,QAAQ,CAAC,OAAO,SAAS;IACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,MAAM,CAAsC;IAEpD;;;;OAIG;gBACS,OAAO,GAAE,UAAsB;IAI3C;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B9D;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;YACW,oBAAoB;IAgClC;;;;;;;;OAQG;IACG,cAAc,CACnB,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACrC,OAAO,CAAC,YAAY,CAAC;IAUxB;;;;OAIG;IACH,eAAe,IAAI,wBAAwB;IAkB3C;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAQf"}