@accomplish_ai/agent-core 0.0.0-pr-353-20260205225158

package/dist/services/permission-handler.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Permission Request Handler
+ *
+ * Reusable logic for handling permission and question requests.
+ * This module manages request state, timeouts, and validation.
+ * The Electron-specific parts (IPC, HTTP servers) remain in the desktop app.
+ */
+import type { PermissionRequest } from '../common/types/permission.js';
+/**
+ * Generic pending request interface
+ */
+export interface PendingRequest<T> {
+    resolve: (result: T) => void;
+    reject: (error: Error) => void;
+    timeoutId: NodeJS.Timeout;
+}
+/**
+ * Validation result for permission request data
+ */
+export interface PermissionValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Raw file permission request data (from HTTP request body)
+ */
+export interface FilePermissionRequestData {
+    operation?: string;
+    filePath?: string;
+    filePaths?: string[];
+    targetPath?: string;
+    contentPreview?: string;
+}
+/**
+ * Raw question request data (from HTTP request body)
+ */
+export interface QuestionRequestData {
+    question?: string;
+    header?: string;
+    options?: Array<{
+        label: string;
+        description?: string;
+    }>;
+    multiSelect?: boolean;
+}
+/**
+ * Question response data
+ */
+export interface QuestionResponseData {
+    selectedOptions?: string[];
+    customText?: string;
+    denied?: boolean;
+}
+/**
+ * Handles permission and question request lifecycle.
+ * Manages pending requests, timeouts, and validation.
+ */
+export declare class PermissionRequestHandler {
+    private pendingPermissions;
+    private pendingQuestions;
+    private defaultTimeoutMs;
+    constructor(timeoutMs?: number);
+    /**
+     * Create a new permission request and wait for response
+     * @param timeoutMs - Optional timeout override
+     * @returns Promise that resolves when user responds
+     */
+    createPermissionRequest(timeoutMs?: number): {
+        requestId: string;
+        promise: Promise<boolean>;
+    };
+    /**
+     * Create a new question request and wait for response
+     * @param timeoutMs - Optional timeout override
+     * @returns Promise that resolves when user responds
+     */
+    createQuestionRequest(timeoutMs?: number): {
+        requestId: string;
+        promise: Promise<QuestionResponseData>;
+    };
+    /**
+     * Resolve a pending permission request
+     * @param requestId - The request ID to resolve
+     * @param allowed - Whether permission was granted
+     * @returns true if request was found and resolved, false otherwise
+     */
+    resolvePermissionRequest(requestId: string, allowed: boolean): boolean;
+    /**
+     * Resolve a pending question request
+     * @param requestId - The request ID to resolve
+     * @param response - The user's response
+     * @returns true if request was found and resolved, false otherwise
+     */
+    resolveQuestionRequest(requestId: string, response: QuestionResponseData): boolean;
+    /**
+     * Validate file permission request data
+     * @param data - Raw request data to validate
+     * @returns Validation result with error message if invalid
+     */
+    validateFilePermissionRequest(data: unknown): PermissionValidationResult;
+    /**
+     * Validate question request data
+     * @param data - Raw request data to validate
+     * @returns Validation result with error message if invalid
+     */
+    validateQuestionRequest(data: unknown): PermissionValidationResult;
+    /**
+     * Build a PermissionRequest object for file operations
+     * @param requestId - The request ID
+     * @param taskId - The associated task ID
+     * @param data - The validated request data
+     * @returns PermissionRequest object ready to send to the UI
+     */
+    buildFilePermissionRequest(requestId: string, taskId: string, data: FilePermissionRequestData): PermissionRequest;
+    /**
+     * Build a PermissionRequest object for questions
+     * @param requestId - The request ID
+     * @param taskId - The associated task ID
+     * @param data - The validated request data
+     * @returns PermissionRequest object ready to send to the UI
+     */
+    buildQuestionRequest(requestId: string, taskId: string, data: QuestionRequestData): PermissionRequest;
+    /**
+     * Check if there are any pending permission requests
+     */
+    hasPendingPermissions(): boolean;
+    /**
+     * Check if there are any pending question requests
+     */
+    hasPendingQuestions(): boolean;
+    /**
+     * Get the count of pending permission requests
+     */
+    getPendingPermissionCount(): number;
+    /**
+     * Get the count of pending question requests
+     */
+    getPendingQuestionCount(): number;
+    /**
+     * Clear all pending requests (e.g., on shutdown)
+     * Rejects all pending promises with a cancellation error
+     */
+    clearAll(): void;
+}
+//# sourceMappingURL=permission-handler.d.ts.map

package/dist/services/permission-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-handler.d.ts","sourceRoot":"","sources":["../../src/services/permission-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAiB,iBAAiB,EAAoB,MAAM,+BAA+B,CAAC;AAExG;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,kBAAkB,CAA8C;IACxE,OAAO,CAAC,gBAAgB,CAA2D;IACnF,OAAO,CAAC,gBAAgB,CAAS;gBAErB,SAAS,GAAE,MAAsC;IAI7D;;;;OAIG;IACH,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE;IAgB7F;;;;OAIG;IACH,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;KAAE;IAgBxG;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAYtE;;;;;OAKG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO;IAYlF;;;;OAIG;IACH,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,0BAA0B;IA2BxE;;;;OAIG;IACH,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,0BAA0B;IAclE;;;;;;OAMG;IACH,0BAA0B,CACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,yBAAyB,GAC9B,iBAAiB;IAcpB;;;;;;OAMG;IACH,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,mBAAmB,GACxB,iBAAiB;IAapB;;OAEG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,yBAAyB,IAAI,MAAM;IAInC;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAIjC;;;OAGG;IACH,QAAQ,IAAI,IAAI;CAajB"}

package/dist/services/permission-handler.js

@@ -0,0 +1,207 @@
+/**
+ * Permission Request Handler
+ *
+ * Reusable logic for handling permission and question requests.
+ * This module manages request state, timeouts, and validation.
+ * The Electron-specific parts (IPC, HTTP servers) remain in the desktop app.
+ */
+import { FILE_OPERATIONS, PERMISSION_REQUEST_TIMEOUT_MS, createFilePermissionRequestId, createQuestionRequestId, } from '../common/index.js';
+/**
+ * Handles permission and question request lifecycle.
+ * Manages pending requests, timeouts, and validation.
+ */
+export class PermissionRequestHandler {
+    pendingPermissions = new Map();
+    pendingQuestions = new Map();
+    defaultTimeoutMs;
+    constructor(timeoutMs = PERMISSION_REQUEST_TIMEOUT_MS) {
+        this.defaultTimeoutMs = timeoutMs;
+    }
+    /**
+     * Create a new permission request and wait for response
+     * @param timeoutMs - Optional timeout override
+     * @returns Promise that resolves when user responds
+     */
+    createPermissionRequest(timeoutMs) {
+        const requestId = createFilePermissionRequestId();
+        const timeout = timeoutMs ?? this.defaultTimeoutMs;
+        const promise = new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                this.pendingPermissions.delete(requestId);
+                reject(new Error('Permission request timed out'));
+            }, timeout);
+            this.pendingPermissions.set(requestId, { resolve, reject, timeoutId });
+        });
+        return { requestId, promise };
+    }
+    /**
+     * Create a new question request and wait for response
+     * @param timeoutMs - Optional timeout override
+     * @returns Promise that resolves when user responds
+     */
+    createQuestionRequest(timeoutMs) {
+        const requestId = createQuestionRequestId();
+        const timeout = timeoutMs ?? this.defaultTimeoutMs;
+        const promise = new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                this.pendingQuestions.delete(requestId);
+                reject(new Error('Question request timed out'));
+            }, timeout);
+            this.pendingQuestions.set(requestId, { resolve, reject, timeoutId });
+        });
+        return { requestId, promise };
+    }
+    /**
+     * Resolve a pending permission request
+     * @param requestId - The request ID to resolve
+     * @param allowed - Whether permission was granted
+     * @returns true if request was found and resolved, false otherwise
+     */
+    resolvePermissionRequest(requestId, allowed) {
+        const pending = this.pendingPermissions.get(requestId);
+        if (!pending) {
+            return false;
+        }
+        clearTimeout(pending.timeoutId);
+        pending.resolve(allowed);
+        this.pendingPermissions.delete(requestId);
+        return true;
+    }
+    /**
+     * Resolve a pending question request
+     * @param requestId - The request ID to resolve
+     * @param response - The user's response
+     * @returns true if request was found and resolved, false otherwise
+     */
+    resolveQuestionRequest(requestId, response) {
+        const pending = this.pendingQuestions.get(requestId);
+        if (!pending) {
+            return false;
+        }
+        clearTimeout(pending.timeoutId);
+        pending.resolve(response);
+        this.pendingQuestions.delete(requestId);
+        return true;
+    }
+    /**
+     * Validate file permission request data
+     * @param data - Raw request data to validate
+     * @returns Validation result with error message if invalid
+     */
+    validateFilePermissionRequest(data) {
+        if (!data || typeof data !== 'object') {
+            return { valid: false, error: 'Invalid request data' };
+        }
+        const requestData = data;
+        // Check required fields
+        if (!requestData.operation) {
+            return { valid: false, error: 'operation is required' };
+        }
+        if (!requestData.filePath && (!requestData.filePaths || requestData.filePaths.length === 0)) {
+            return { valid: false, error: 'operation and either filePath or filePaths are required' };
+        }
+        // Validate operation type
+        if (!FILE_OPERATIONS.includes(requestData.operation)) {
+            return {
+                valid: false,
+                error: `Invalid operation. Must be one of: ${FILE_OPERATIONS.join(', ')}`,
+            };
+        }
+        return { valid: true };
+    }
+    /**
+     * Validate question request data
+     * @param data - Raw request data to validate
+     * @returns Validation result with error message if invalid
+     */
+    validateQuestionRequest(data) {
+        if (!data || typeof data !== 'object') {
+            return { valid: false, error: 'Invalid request data' };
+        }
+        const requestData = data;
+        if (!requestData.question) {
+            return { valid: false, error: 'question is required' };
+        }
+        return { valid: true };
+    }
+    /**
+     * Build a PermissionRequest object for file operations
+     * @param requestId - The request ID
+     * @param taskId - The associated task ID
+     * @param data - The validated request data
+     * @returns PermissionRequest object ready to send to the UI
+     */
+    buildFilePermissionRequest(requestId, taskId, data) {
+        return {
+            id: requestId,
+            taskId,
+            type: 'file',
+            fileOperation: data.operation,
+            filePath: data.filePath,
+            filePaths: data.filePaths,
+            targetPath: data.targetPath,
+            contentPreview: data.contentPreview?.substring(0, 500),
+            createdAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Build a PermissionRequest object for questions
+     * @param requestId - The request ID
+     * @param taskId - The associated task ID
+     * @param data - The validated request data
+     * @returns PermissionRequest object ready to send to the UI
+     */
+    buildQuestionRequest(requestId, taskId, data) {
+        return {
+            id: requestId,
+            taskId,
+            type: 'question',
+            question: data.question,
+            header: data.header,
+            options: data.options,
+            multiSelect: data.multiSelect,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Check if there are any pending permission requests
+     */
+    hasPendingPermissions() {
+        return this.pendingPermissions.size > 0;
+    }
+    /**
+     * Check if there are any pending question requests
+     */
+    hasPendingQuestions() {
+        return this.pendingQuestions.size > 0;
+    }
+    /**
+     * Get the count of pending permission requests
+     */
+    getPendingPermissionCount() {
+        return this.pendingPermissions.size;
+    }
+    /**
+     * Get the count of pending question requests
+     */
+    getPendingQuestionCount() {
+        return this.pendingQuestions.size;
+    }
+    /**
+     * Clear all pending requests (e.g., on shutdown)
+     * Rejects all pending promises with a cancellation error
+     */
+    clearAll() {
+        for (const [requestId, pending] of this.pendingPermissions) {
+            clearTimeout(pending.timeoutId);
+            pending.reject(new Error('Request cancelled'));
+        }
+        this.pendingPermissions.clear();
+        for (const [requestId, pending] of this.pendingQuestions) {
+            clearTimeout(pending.timeoutId);
+            pending.reject(new Error('Request cancelled'));
+        }
+        this.pendingQuestions.clear();
+    }
+}
+//# sourceMappingURL=permission-handler.js.map

package/dist/services/permission-handler.js.map

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

package/dist/services/speech.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Speech-to-Text service using ElevenLabs API
+ *
+ * This service handles:
+ * - API key validation
+ * - Audio transcription via ElevenLabs STT API
+ *
+ * The service requires a SecureStorage instance to be provided,
+ * allowing it to be used in different environments (Electron, CLI, etc.)
+ */
+import type { SecureStorage } from '../storage/secure-storage.js';
+export interface TranscriptionResult {
+    text: string;
+    confidence?: number;
+    duration: number;
+    timestamp: number;
+}
+export interface TranscriptionError {
+    code: string;
+    message: string;
+}
+/**
+ * Speech service that uses ElevenLabs API for transcription.
+ * Requires a SecureStorage instance for API key management.
+ */
+export declare class SpeechService {
+    private storage;
+    constructor(storage: SecureStorage);
+    /**
+     * Get the configured ElevenLabs API key
+     */
+    getElevenLabsApiKey(): string | null;
+    /**
+     * Check if ElevenLabs is configured
+     */
+    isElevenLabsConfigured(): boolean;
+    /**
+     * Validate ElevenLabs API key by making a test request
+     */
+    validateElevenLabsApiKey(apiKey?: string): Promise<{
+        valid: boolean;
+        error?: string;
+    }>;
+    /**
+     * Transcribe audio using ElevenLabs Speech-to-Text API
+     *
+     * @param audioData - Audio data as Buffer (from renderer via IPC)
+     * @param mimeType - MIME type of the audio (e.g., 'audio/webm')
+     * @returns Transcription result or error
+     */
+    transcribeAudio(audioData: Buffer, mimeType?: string): Promise<{
+        success: true;
+        result: TranscriptionResult;
+    } | {
+        success: false;
+        error: TranscriptionError;
+    }>;
+}
+/**
+ * Create a new SpeechService instance
+ */
+export declare function createSpeechService(storage: SecureStorage): SpeechService;
+//# sourceMappingURL=speech.d.ts.map

package/dist/services/speech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.d.ts","sourceRoot":"","sources":["../../src/services/speech.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAKlE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;gBAEnB,OAAO,EAAE,aAAa;IAIlC;;OAEG;IACH,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAKpC;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAIjC;;OAEG;IACG,wBAAwB,CAC5B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA+C9C;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAqB,GAC9B,OAAO,CACN;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,GAC9C;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,kBAAkB,CAAA;KAAE,CAChD;CAyLF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAEzE"}

package/dist/services/speech.js

@@ -0,0 +1,253 @@
+/**
+ * Speech-to-Text service using ElevenLabs API
+ *
+ * This service handles:
+ * - API key validation
+ * - Audio transcription via ElevenLabs STT API
+ *
+ * The service requires a SecureStorage instance to be provided,
+ * allowing it to be used in different environments (Electron, CLI, etc.)
+ */
+import { fetchWithTimeout } from '../utils/fetch.js';
+const ELEVENLABS_API_TIMEOUT_MS = 30000;
+const DEFAULT_ELEVENLABS_STT_MODEL_ID = 'scribe_v2';
+/**
+ * Speech service that uses ElevenLabs API for transcription.
+ * Requires a SecureStorage instance for API key management.
+ */
+export class SpeechService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Get the configured ElevenLabs API key
+     */
+    getElevenLabsApiKey() {
+        const key = this.storage.getApiKey('elevenlabs');
+        return key && key.trim() ? key : null;
+    }
+    /**
+     * Check if ElevenLabs is configured
+     */
+    isElevenLabsConfigured() {
+        return this.getElevenLabsApiKey() !== null;
+    }
+    /**
+     * Validate ElevenLabs API key by making a test request
+     */
+    async validateElevenLabsApiKey(apiKey) {
+        const key = apiKey || this.getElevenLabsApiKey();
+        if (!key || !key.trim()) {
+            return { valid: false, error: 'API key is required' };
+        }
+        try {
+            const response = await fetchWithTimeout('https://api.elevenlabs.io/v1/models', {
+                method: 'GET',
+                headers: {
+                    'xi-api-key': key.trim(),
+                },
+            }, ELEVENLABS_API_TIMEOUT_MS);
+            if (response.ok) {
+                return { valid: true };
+            }
+            if (response.status === 401 || response.status === 403) {
+                return {
+                    valid: false,
+                    error: 'Invalid API key. Please check your ElevenLabs API key.',
+                };
+            }
+            const errorData = await response.json().catch(() => ({}));
+            const errorMessage = errorData?.error?.message ||
+                `API returned status ${response.status}`;
+            return { valid: false, error: `API error: ${errorMessage}` };
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                return {
+                    valid: false,
+                    error: 'Request timed out. Please check your internet connection.',
+                };
+            }
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return { valid: false, error: `Network error: ${message}` };
+        }
+    }
+    /**
+     * Transcribe audio using ElevenLabs Speech-to-Text API
+     *
+     * @param audioData - Audio data as Buffer (from renderer via IPC)
+     * @param mimeType - MIME type of the audio (e.g., 'audio/webm')
+     * @returns Transcription result or error
+     */
+    async transcribeAudio(audioData, mimeType = 'audio/webm') {
+        const apiKey = this.getElevenLabsApiKey();
+        const modelId = process.env.ELEVENLABS_STT_MODEL_ID?.trim() ||
+            DEFAULT_ELEVENLABS_STT_MODEL_ID;
+        if (!apiKey) {
+            return {
+                success: false,
+                error: {
+                    code: 'MISSING_API_KEY',
+                    message: 'ElevenLabs API key is not configured. Please add it in settings.',
+                },
+            };
+        }
+        const startTime = Date.now();
+        console.log('[ElevenLabs] Starting transcription:', {
+            audioSize: audioData.length,
+            mimeType,
+            modelId,
+        });
+        try {
+            // Create a Blob from the Buffer for FormData
+            // Use Uint8Array to ensure proper typing for Blob constructor
+            const uint8Array = new Uint8Array(audioData);
+            const blob = new Blob([uint8Array], { type: mimeType });
+            console.log('[ElevenLabs] Created blob:', {
+                blobSize: blob.size,
+                blobType: blob.type,
+            });
+            // Create FormData for multipart upload
+            const formData = new FormData();
+            formData.append('file', blob, 'audio.webm');
+            formData.append('model_id', modelId);
+            const response = await fetchWithTimeout('https://api.elevenlabs.io/v1/speech-to-text', {
+                method: 'POST',
+                headers: {
+                    'xi-api-key': apiKey,
+                },
+                body: formData,
+            }, ELEVENLABS_API_TIMEOUT_MS);
+            const duration = Date.now() - startTime;
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => '');
+                let errorData = {};
+                try {
+                    errorData = JSON.parse(errorText);
+                }
+                catch {
+                    // Not JSON, use raw text
+                }
+                console.error('[ElevenLabs] API error:', {
+                    status: response.status,
+                    statusText: response.statusText,
+                    errorData: JSON.stringify(errorData, null, 2),
+                    errorText: errorText.substring(0, 500),
+                });
+                if (response.status === 401 || response.status === 403) {
+                    return {
+                        success: false,
+                        error: {
+                            code: 'INVALID_API_KEY',
+                            message: 'Invalid or expired ElevenLabs API key. Please check your settings.',
+                        },
+                    };
+                }
+                if (response.status === 429) {
+                    return {
+                        success: false,
+                        error: {
+                            code: 'RATE_LIMIT',
+                            message: 'Rate limit exceeded. Please wait a moment and try again.',
+                        },
+                    };
+                }
+                // ElevenLabs can return errors in different formats
+                // detail can be: string, { message: string }, or other object structures
+                const detail = errorData?.detail;
+                let errorMessage;
+                if (typeof detail === 'string') {
+                    errorMessage = detail;
+                }
+                else if (detail && typeof detail === 'object') {
+                    // detail could be { message: string } or { status: string, message: string } etc.
+                    const detailObj = detail;
+                    const detailMessage = detailObj.message ?? detailObj.status;
+                    if (typeof detailMessage === 'string') {
+                        errorMessage = detailMessage;
+                    }
+                    else if (detailMessage !== undefined) {
+                        errorMessage = JSON.stringify(detailMessage);
+                    }
+                    else {
+                        errorMessage = JSON.stringify(detail);
+                    }
+                }
+                else if (errorData?.error?.message) {
+                    const nestedMessage = errorData
+                        .error.message;
+                    errorMessage =
+                        typeof nestedMessage === 'string'
+                            ? nestedMessage
+                            : JSON.stringify(nestedMessage);
+                }
+                else if (errorData?.message) {
+                    const rootMessage = errorData.message;
+                    errorMessage =
+                        typeof rootMessage === 'string'
+                            ? rootMessage
+                            : JSON.stringify(rootMessage);
+                }
+                else if (errorText) {
+                    errorMessage = errorText.substring(0, 200);
+                }
+                else {
+                    errorMessage = response.statusText || 'Unknown API error';
+                }
+                return {
+                    success: false,
+                    error: {
+                        code: 'TRANSCRIPTION_FAILED',
+                        message: `Transcription failed: ${errorMessage}`,
+                    },
+                };
+            }
+            const result = (await response.json());
+            if (!result.text) {
+                return {
+                    success: false,
+                    error: {
+                        code: 'EMPTY_RESULT',
+                        message: 'No speech was recognized. Please try again.',
+                    },
+                };
+            }
+            return {
+                success: true,
+                result: {
+                    text: result.text.trim(),
+                    confidence: result.confidence,
+                    duration,
+                    timestamp: Date.now(),
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                return {
+                    success: false,
+                    error: {
+                        code: 'TIMEOUT',
+                        message: 'Transcription request timed out. Please try again.',
+                    },
+                };
+            }
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                success: false,
+                error: {
+                    code: 'NETWORK_ERROR',
+                    message: `Network error during transcription: ${message}`,
+                },
+            };
+        }
+    }
+}
+/**
+ * Create a new SpeechService instance
+ */
+export function createSpeechService(storage) {
+    return new SpeechService(storage);
+}
+//# sourceMappingURL=speech.js.map