agentstudio 0.3.4 → 0.4.1

package/services/speechToText/providers/google.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * Google Cloud Speech-to-Text Provider
+ * 使用 Google Cloud Speech-to-Text API v1
+ * 文档: https://cloud.google.com/speech-to-text/docs/reference/rest/v1/speech/recognize
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleProvider = void 0;
+exports.createGoogleProvider = createGoogleProvider;
+const https_proxy_agent_1 = require("https-proxy-agent");
+const socks_proxy_agent_1 = require("socks-proxy-agent");
+class GoogleProvider {
+    name = 'google';
+    apiKey;
+    proxy;
+    // Google Cloud Speech-to-Text API 端点
+    static API_ENDPOINT = 'https://speech.googleapis.com/v1/speech:recognize';
+    constructor(config) {
+        this.apiKey = config.apiKey || '';
+        this.proxy = config.proxy;
+    }
+    validateConfig() {
+        return !!this.apiKey;
+    }
+    async transcribe(request) {
+        const startTime = Date.now();
+        if (!this.validateConfig()) {
+            throw new Error('Google provider is not configured properly');
+        }
+        // 构建请求体
+        const requestBody = {
+            config: {
+                // 音频编码格式
+                encoding: this.getEncoding(request.audioFormat),
+                // 采样率 - 对于 WebM/OGG_OPUS 格式，设置为 48000 Hz
+                sampleRateHertz: this.getSampleRate(request.audioFormat),
+                // 语言代码
+                languageCode: this.getLanguageCode(request.language),
+                // 启用自动标点
+                enableAutomaticPunctuation: true,
+                // 返回多个候选结果
+                maxAlternatives: 1,
+                // 模型选择 - 使用 latest_long 或 latest_short
+                model: 'latest_short',
+            },
+            audio: {
+                // Base64 编码的音频内容
+                content: request.audioData,
+            },
+        };
+        // 构建请求 URL（带 API Key）
+        const url = `${GoogleProvider.API_ENDPOINT}?key=${this.apiKey}`;
+        // 配置 fetch 选项
+        const fetchOptions = {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(requestBody),
+        };
+        // 配置代理
+        const agent = this.createProxyAgent();
+        if (agent) {
+            fetchOptions.agent = agent;
+        }
+        const response = await fetch(url, fetchOptions);
+        if (!response.ok) {
+            const errorText = await response.text();
+            let errorMessage = `Google API error (${response.status}): ${errorText}`;
+            // 尝试解析 JSON 错误
+            try {
+                const errorJson = JSON.parse(errorText);
+                if (errorJson.error?.message) {
+                    errorMessage = `Google API error: ${errorJson.error.message}`;
+                }
+            }
+            catch {
+                // 使用原始错误信息
+            }
+            throw new Error(errorMessage);
+        }
+        const result = (await response.json());
+        const processingTime = Date.now() - startTime;
+        // 提取转写结果
+        const transcript = this.extractTranscript(result);
+        const confidence = this.extractConfidence(result);
+        const detectedLanguage = this.extractLanguage(result);
+        return {
+            text: transcript,
+            provider: 'google',
+            processingTime,
+            confidence,
+            detectedLanguage,
+        };
+    }
+    createProxyAgent() {
+        if (!this.proxy?.enabled) {
+            return undefined;
+        }
+        if (this.proxy.type === 'env') {
+            // 使用环境变量中的代理
+            const proxyUrl = process.env.https_proxy ||
+                process.env.HTTPS_PROXY ||
+                process.env.http_proxy ||
+                process.env.HTTP_PROXY ||
+                process.env.all_proxy ||
+                process.env.ALL_PROXY;
+            if (proxyUrl) {
+                if (proxyUrl.startsWith('socks')) {
+                    return new socks_proxy_agent_1.SocksProxyAgent(proxyUrl);
+                }
+                return new https_proxy_agent_1.HttpsProxyAgent(proxyUrl);
+            }
+            return undefined;
+        }
+        if (!this.proxy.url) {
+            return undefined;
+        }
+        if (this.proxy.type === 'socks5') {
+            return new socks_proxy_agent_1.SocksProxyAgent(this.proxy.url);
+        }
+        return new https_proxy_agent_1.HttpsProxyAgent(this.proxy.url);
+    }
+    getEncoding(format) {
+        // Google Cloud Speech-to-Text 支持的编码格式
+        const formatMap = {
+            webm: 'WEBM_OPUS',
+            'audio/webm': 'WEBM_OPUS',
+            'audio/webm;codecs=opus': 'WEBM_OPUS',
+            ogg: 'OGG_OPUS',
+            'audio/ogg': 'OGG_OPUS',
+            wav: 'LINEAR16',
+            'audio/wav': 'LINEAR16',
+            mp3: 'MP3',
+            'audio/mp3': 'MP3',
+            'audio/mpeg': 'MP3',
+        };
+        return formatMap[format.toLowerCase()] || 'ENCODING_UNSPECIFIED';
+    }
+    getSampleRate(format) {
+        // WebM/OGG OPUS 通常使用 48000 Hz
+        const formatLower = format.toLowerCase();
+        if (formatLower.includes('webm') ||
+            formatLower.includes('ogg') ||
+            formatLower.includes('opus')) {
+            return 48000;
+        }
+        // 其他格式使用 16000 Hz（语音识别常用采样率）
+        return 16000;
+    }
+    getLanguageCode(language) {
+        if (!language) {
+            return 'zh-CN'; // 默认中文
+        }
+        // 直接使用传入的语言代码（如果是 BCP-47 格式）
+        if (language.includes('-')) {
+            return language;
+        }
+        // 简写映射
+        const languageMap = {
+            zh: 'zh-CN',
+            en: 'en-US',
+            ja: 'ja-JP',
+            ko: 'ko-KR',
+            es: 'es-ES',
+            fr: 'fr-FR',
+            de: 'de-DE',
+            pt: 'pt-BR',
+            ru: 'ru-RU',
+            ar: 'ar-SA',
+            hi: 'hi-IN',
+            it: 'it-IT',
+        };
+        return languageMap[language] || 'zh-CN';
+    }
+    extractTranscript(result) {
+        if (!result.results || result.results.length === 0) {
+            return '';
+        }
+        // 合并所有结果的 transcript
+        return result.results
+            .map((r) => r.alternatives?.[0]?.transcript || '')
+            .join(' ')
+            .trim();
+    }
+    extractConfidence(result) {
+        if (!result.results || result.results.length === 0) {
+            return undefined;
+        }
+        const confidence = result.results[0]?.alternatives?.[0]?.confidence;
+        return confidence !== undefined ? confidence : undefined;
+    }
+    extractLanguage(result) {
+        if (!result.results || result.results.length === 0) {
+            return undefined;
+        }
+        return result.results[0]?.languageCode;
+    }
+}
+exports.GoogleProvider = GoogleProvider;
+// 工厂函数
+function createGoogleProvider(config) {
+    return new GoogleProvider(config);
+}
+//# sourceMappingURL=google.js.map

package/services/speechToText/providers/google.js.map

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

package/services/speechToText/providers/openaiCompatible.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenAI Compatible Speech-to-Text Provider
+ * 支持 OpenAI Whisper API 和兼容接口 (如 Groq)
+ */
+import { SpeechToTextProvider, SpeechProvider, TranscribeRequest, TranscribeResponse, SpeechProviderConfig } from '../types';
+export declare class OpenAICompatibleProvider implements SpeechToTextProvider {
+    name: SpeechProvider;
+    private apiKey;
+    private baseUrl;
+    private model;
+    private proxy?;
+    constructor(config: SpeechProviderConfig);
+    validateConfig(): boolean;
+    transcribe(request: TranscribeRequest): Promise<TranscribeResponse>;
+    private getProxyAgent;
+    private getFileExtension;
+    private getMimeType;
+    private normalizeLanguage;
+}
+export declare function createOpenAIProvider(config: SpeechProviderConfig): OpenAICompatibleProvider;
+export declare function createGroqProvider(config: SpeechProviderConfig): OpenAICompatibleProvider;
+//# sourceMappingURL=openaiCompatible.d.ts.map

package/services/speechToText/providers/openaiCompatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiCompatible.d.ts","sourceRoot":"","sources":["../../../../src/services/speechToText/providers/openaiCompatible.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EAErB,MAAM,UAAU,CAAC;AAElB,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAC,CAAc;gBAEhB,MAAM,EAAE,oBAAoB;IAQxC,cAAc,IAAI,OAAO;IAInB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwFzE,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,iBAAiB;CAY1B;AAGD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,GAC3B,wBAAwB,CAO1B;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,oBAAoB,GAC3B,wBAAwB,CAO1B"}

package/services/speechToText/providers/openaiCompatible.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * OpenAI Compatible Speech-to-Text Provider
+ * 支持 OpenAI Whisper API 和兼容接口 (如 Groq)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAICompatibleProvider = void 0;
+exports.createOpenAIProvider = createOpenAIProvider;
+exports.createGroqProvider = createGroqProvider;
+const form_data_1 = __importDefault(require("form-data"));
+const https_1 = __importDefault(require("https"));
+const socks_proxy_agent_1 = require("socks-proxy-agent");
+const https_proxy_agent_1 = require("https-proxy-agent");
+class OpenAICompatibleProvider {
+    name;
+    apiKey;
+    baseUrl;
+    model;
+    proxy;
+    constructor(config) {
+        this.name = config.provider;
+        this.apiKey = config.apiKey || '';
+        this.baseUrl = config.baseUrl || 'https://api.openai.com/v1';
+        this.model = config.model || 'whisper-1';
+        this.proxy = config.proxy;
+    }
+    validateConfig() {
+        return !!this.apiKey && !!this.baseUrl;
+    }
+    async transcribe(request) {
+        const startTime = Date.now();
+        if (!this.validateConfig()) {
+            throw new Error(`${this.name} provider is not configured properly`);
+        }
+        // 将 base64 数据转换为 Buffer
+        const audioBuffer = Buffer.from(request.audioData, 'base64');
+        // 确定文件扩展名
+        const extension = this.getFileExtension(request.audioFormat);
+        const mimeType = this.getMimeType(request.audioFormat);
+        // 创建 FormData (使用 form-data 包，兼容性更好)
+        const formData = new form_data_1.default();
+        formData.append('file', audioBuffer, {
+            filename: `audio.${extension}`,
+            contentType: mimeType,
+        });
+        formData.append('model', this.model);
+        // 如果指定了语言，添加语言参数
+        if (request.language) {
+            formData.append('language', this.normalizeLanguage(request.language));
+        }
+        // 解析 URL
+        const url = new URL(`${this.baseUrl}/audio/transcriptions`);
+        // 获取代理 agent
+        const agent = this.getProxyAgent();
+        // 使用 https 模块发送请求 (支持代理)
+        return new Promise((resolve, reject) => {
+            const options = {
+                hostname: url.hostname,
+                port: url.port || 443,
+                path: url.pathname + url.search,
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    ...formData.getHeaders(),
+                },
+            };
+            // 如果有代理，添加 agent
+            if (agent) {
+                options.agent = agent;
+            }
+            const req = https_1.default.request(options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => (data += chunk));
+                res.on('end', () => {
+                    const processingTime = Date.now() - startTime;
+                    if (res.statusCode !== 200) {
+                        reject(new Error(`${this.name} API error (${res.statusCode}): ${data}`));
+                        return;
+                    }
+                    try {
+                        const result = JSON.parse(data);
+                        resolve({
+                            text: result.text || '',
+                            provider: this.name,
+                            processingTime,
+                            detectedLanguage: result.language,
+                        });
+                    }
+                    catch (e) {
+                        reject(new Error(`Failed to parse ${this.name} API response: ${data}`));
+                    }
+                });
+            });
+            req.on('error', (e) => {
+                reject(new Error(`${this.name} API request failed: ${e.message}`));
+            });
+            // 使用 form-data 的 pipe 方法发送数据
+            formData.pipe(req);
+        });
+    }
+    // 获取代理 agent
+    getProxyAgent() {
+        if (!this.proxy?.enabled) {
+            return undefined;
+        }
+        let proxyUrl;
+        if (this.proxy.type === 'env') {
+            // 从环境变量获取代理
+            proxyUrl =
+                process.env.https_proxy ||
+                    process.env.HTTPS_PROXY ||
+                    process.env.http_proxy ||
+                    process.env.HTTP_PROXY ||
+                    process.env.all_proxy ||
+                    process.env.ALL_PROXY;
+        }
+        else if (this.proxy.url) {
+            proxyUrl = this.proxy.url;
+        }
+        if (!proxyUrl) {
+            return undefined;
+        }
+        // 根据代理类型创建 agent
+        if (this.proxy.type === 'socks5' || proxyUrl.startsWith('socks')) {
+            return new socks_proxy_agent_1.SocksProxyAgent(proxyUrl);
+        }
+        else {
+            return new https_proxy_agent_1.HttpsProxyAgent(proxyUrl);
+        }
+    }
+    getFileExtension(format) {
+        const formatMap = {
+            webm: 'webm',
+            'audio/webm': 'webm',
+            wav: 'wav',
+            'audio/wav': 'wav',
+            mp3: 'mp3',
+            'audio/mp3': 'mp3',
+            'audio/mpeg': 'mp3',
+            m4a: 'm4a',
+            'audio/m4a': 'm4a',
+            ogg: 'ogg',
+            'audio/ogg': 'ogg',
+            flac: 'flac',
+            'audio/flac': 'flac',
+        };
+        return formatMap[format.toLowerCase()] || 'webm';
+    }
+    getMimeType(format) {
+        const mimeMap = {
+            webm: 'audio/webm',
+            wav: 'audio/wav',
+            mp3: 'audio/mpeg',
+            m4a: 'audio/m4a',
+            ogg: 'audio/ogg',
+            flac: 'audio/flac',
+        };
+        // 如果已经是 MIME 类型，直接返回
+        if (format.includes('/')) {
+            return format;
+        }
+        return mimeMap[format.toLowerCase()] || 'audio/webm';
+    }
+    normalizeLanguage(language) {
+        // OpenAI Whisper 使用 ISO-639-1 语言代码
+        const languageMap = {
+            'zh-CN': 'zh',
+            'zh-TW': 'zh',
+            'en-US': 'en',
+            'en-GB': 'en',
+            'ja-JP': 'ja',
+            'ko-KR': 'ko',
+        };
+        return languageMap[language] || language.split('-')[0];
+    }
+}
+exports.OpenAICompatibleProvider = OpenAICompatibleProvider;
+// 工厂函数
+function createOpenAIProvider(config) {
+    return new OpenAICompatibleProvider({
+        ...config,
+        provider: 'openai',
+        baseUrl: config.baseUrl || 'https://api.openai.com/v1',
+        model: config.model || 'whisper-1',
+    });
+}
+function createGroqProvider(config) {
+    return new OpenAICompatibleProvider({
+        ...config,
+        provider: 'groq',
+        baseUrl: config.baseUrl || 'https://api.groq.com/openai/v1',
+        model: config.model || 'whisper-large-v3',
+    });
+}
+//# sourceMappingURL=openaiCompatible.js.map

package/services/speechToText/providers/openaiCompatible.js.map

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

package/services/speechToText/providers/tencent.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tencent Cloud (腾讯云) Speech-to-Text Provider
+ * 使用腾讯云语音识别服务 - 一句话识别
+ * 文档: https://cloud.tencent.com/document/product/1093
+ */
+import { SpeechToTextProvider, TranscribeRequest, TranscribeResponse, SpeechProviderConfig } from '../types';
+export declare class TencentProvider implements SpeechToTextProvider {
+    name: 'tencent';
+    private secretId;
+    private secretKey;
+    private appId;
+    private static readonly API_HOST;
+    private static readonly API_VERSION;
+    private static readonly REGION;
+    constructor(config: SpeechProviderConfig);
+    validateConfig(): boolean;
+    transcribe(request: TranscribeRequest): Promise<TranscribeResponse>;
+    private generateHeaders;
+    private getEngineType;
+    private getVoiceFormat;
+}
+export declare function createTencentProvider(config: SpeechProviderConfig): TencentProvider;
+//# sourceMappingURL=tencent.d.ts.map

package/services/speechToText/providers/tencent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tencent.d.ts","sourceRoot":"","sources":["../../../../src/services/speechToText/providers/tencent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB,qBAAa,eAAgB,YAAW,oBAAoB;IAC1D,IAAI,EAAE,SAAS,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IAGtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAgB;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAEnC,MAAM,EAAE,oBAAoB;IAOxC,cAAc,IAAI,OAAO;IAInB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2DzE,OAAO,CAAC,eAAe;IAiFvB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,cAAc;CAmBvB;AAGD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,oBAAoB,GAC3B,eAAe,CAEjB"}