hyperclaw 5.4.0 → 5.4.2

package/dist/voice-transcription-Bz2y0nPK.js

@@ -0,0 +1,170 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const https = require_chunk.__toESM(require("https"));
+
+//#region src/services/voice-transcription.ts
+require_paths$1.init_paths();
+const MAX_AUDIO_BYTES = 25 * 1024 * 1024;
+const ALLOWED_AUDIO_EXTENSIONS = new Set([
+	".ogg",
+	".oga",
+	".mp3",
+	".wav",
+	".m4a",
+	".mp4",
+	".mpeg",
+	".webm"
+]);
+function sanitizeForError(value) {
+	return String(value ?? "").replace(/[\r\n\t]+/g, " ").slice(0, 160);
+}
+async function loadAudioInput(audioPathOrBuffer) {
+	if (Buffer.isBuffer(audioPathOrBuffer)) {
+		if (audioPathOrBuffer.length === 0) throw new Error("Audio input is empty");
+		if (audioPathOrBuffer.length > MAX_AUDIO_BYTES) throw new Error(`Audio input exceeds ${MAX_AUDIO_BYTES} bytes`);
+		return audioPathOrBuffer;
+	}
+	const resolvedPath = path.default.resolve(audioPathOrBuffer);
+	const ext = path.default.extname(resolvedPath).toLowerCase();
+	if (!ALLOWED_AUDIO_EXTENSIONS.has(ext)) throw new Error(`Unsupported audio file type: ${ext || "unknown"}`);
+	const buf = await fs_extra.default.readFile(resolvedPath);
+	if (buf.length === 0) throw new Error("Audio input is empty");
+	if (buf.length > MAX_AUDIO_BYTES) throw new Error(`Audio input exceeds ${MAX_AUDIO_BYTES} bytes`);
+	return buf;
+}
+async function getConfig() {
+	try {
+		const cfg = await fs_extra.default.readJson(require_paths.getConfigPath());
+		const providerId = cfg?.provider?.providerId;
+		const apiKey = cfg?.provider?.apiKey;
+		return {
+			providerId,
+			apiKey
+		};
+	} catch {
+		return {};
+	}
+}
+async function transcribeWithWhisper(buffer, apiKey) {
+	return new Promise((resolve, reject) => {
+		const boundary = "----HyperClaw" + Date.now();
+		const header = [
+			`--${boundary}`,
+			"Content-Disposition: form-data; name=\"file\"; filename=\"audio.ogg\"",
+			"Content-Type: application/octet-stream",
+			"",
+			""
+		].join("\r\n");
+		const footer = `\r\n--${boundary}\r\nContent-Disposition: form-data; name="model"\r\n\r\nwhisper-1\r\n--${boundary}--\r\n`;
+		const body = Buffer.concat([
+			Buffer.from(header, "utf8"),
+			buffer,
+			Buffer.from(footer, "utf8")
+		]);
+		const req = https.default.request({
+			hostname: "api.openai.com",
+			port: 443,
+			path: "/v1/audio/transcriptions",
+			method: "POST",
+			headers: {
+				"Authorization": `Bearer ${apiKey}`,
+				"Content-Type": `multipart/form-data; boundary=${boundary}`,
+				"Content-Length": body.length
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const j = JSON.parse(data);
+					resolve(j.text?.trim() || "[No transcription]");
+				} catch {
+					resolve(`[Transcription error: ${data.slice(0, 100)}]`);
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(body);
+		req.end();
+	});
+}
+async function transcribeWithGemini(buffer, apiKey) {
+	const base64 = buffer.toString("base64");
+	const payload = JSON.stringify({
+		contents: [{ parts: [{ text: "Transcribe this audio to text. Output only the transcription, no other text." }, { inlineData: {
+			mimeType: "audio/ogg",
+			data: base64
+		} }] }],
+		generationConfig: { maxOutputTokens: 1024 }
+	});
+	return new Promise((resolve, reject) => {
+		const req = https.default.request({
+			hostname: "generativelanguage.googleapis.com",
+			port: 443,
+			path: "/v1beta/models/gemini-2.0-flash:generateContent?key=" + encodeURIComponent(apiKey),
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				"Content-Length": Buffer.byteLength(payload)
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const j = JSON.parse(data);
+					const text = j.candidates?.[0]?.content?.parts?.[0]?.text?.trim();
+					resolve(text || "[No transcription]");
+				} catch {
+					resolve(`[Transcription error: ${data.slice(0, 100)}]`);
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(payload);
+		req.end();
+	});
+}
+/**
+
+* Transcribe audio using configured provider or fallbacks.
+
+* Providers: OpenAI (Whisper), Google (Gemini), OpenRouter.
+
+* Env: OPENAI_API_KEY, WHISPER_API_KEY, GOOGLE_AI_API_KEY.
+
+*/
+async function transcribeVoiceNote(audioPathOrBuffer, apiKey) {
+	let buffer;
+	try {
+		buffer = await loadAudioInput(audioPathOrBuffer);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	const cfg = await getConfig();
+	const openaiKey = apiKey || process.env.OPENAI_API_KEY || process.env.WHISPER_API_KEY || (cfg.providerId === "openai" || cfg.providerId === "openrouter" ? cfg.apiKey : "");
+	const googleKey = process.env.GOOGLE_AI_API_KEY || (cfg.providerId === "google" ? cfg.apiKey : "");
+	if (cfg.providerId === "google" && googleKey) try {
+		return await transcribeWithGemini(buffer, googleKey);
+	} catch {}
+	if ((cfg.providerId === "openrouter" || cfg.providerId === "openai") && openaiKey) try {
+		return await transcribeWithWhisper(buffer, openaiKey);
+	} catch {}
+	if (openaiKey) try {
+		return await transcribeWithWhisper(buffer, openaiKey);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	if (googleKey) try {
+		return await transcribeWithGemini(buffer, googleKey);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	return "[Voice note — add OPENAI_API_KEY or GOOGLE_AI_API_KEY (or select OpenAI/Google provider in the wizard) for transcription]";
+}
+
+//#endregion
+exports.transcribeVoiceNote = transcribeVoiceNote;

package/dist/voice-transcription-CVFcHpPF.js

@@ -0,0 +1,170 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const https = require_chunk.__toESM(require("https"));
+
+//#region src/services/voice-transcription.ts
+require_paths$1.init_paths();
+const MAX_AUDIO_BYTES = 25 * 1024 * 1024;
+const ALLOWED_AUDIO_EXTENSIONS = new Set([
+	".ogg",
+	".oga",
+	".mp3",
+	".wav",
+	".m4a",
+	".mp4",
+	".mpeg",
+	".webm"
+]);
+function sanitizeForError(value) {
+	return String(value ?? "").replace(/[\r\n\t]+/g, " ").slice(0, 160);
+}
+async function loadAudioInput(audioPathOrBuffer) {
+	if (Buffer.isBuffer(audioPathOrBuffer)) {
+		if (audioPathOrBuffer.length === 0) throw new Error("Audio input is empty");
+		if (audioPathOrBuffer.length > MAX_AUDIO_BYTES) throw new Error(`Audio input exceeds ${MAX_AUDIO_BYTES} bytes`);
+		return audioPathOrBuffer;
+	}
+	const resolvedPath = path.default.resolve(audioPathOrBuffer);
+	const ext = path.default.extname(resolvedPath).toLowerCase();
+	if (!ALLOWED_AUDIO_EXTENSIONS.has(ext)) throw new Error(`Unsupported audio file type: ${ext || "unknown"}`);
+	const buf = await fs_extra.default.readFile(resolvedPath);
+	if (buf.length === 0) throw new Error("Audio input is empty");
+	if (buf.length > MAX_AUDIO_BYTES) throw new Error(`Audio input exceeds ${MAX_AUDIO_BYTES} bytes`);
+	return buf;
+}
+async function getConfig() {
+	try {
+		const cfg = await fs_extra.default.readJson(require_paths.getConfigPath());
+		const providerId = cfg?.provider?.providerId;
+		const apiKey = cfg?.provider?.apiKey;
+		return {
+			providerId,
+			apiKey
+		};
+	} catch {
+		return {};
+	}
+}
+async function transcribeWithWhisper(buffer, apiKey) {
+	return new Promise((resolve, reject) => {
+		const boundary = "----HyperClaw" + Date.now();
+		const header = [
+			`--${boundary}`,
+			"Content-Disposition: form-data; name=\"file\"; filename=\"audio.ogg\"",
+			"Content-Type: application/octet-stream",
+			"",
+			""
+		].join("\r\n");
+		const footer = `\r\n--${boundary}\r\nContent-Disposition: form-data; name="model"\r\n\r\nwhisper-1\r\n--${boundary}--\r\n`;
+		const body = Buffer.concat([
+			Buffer.from(header, "utf8"),
+			buffer,
+			Buffer.from(footer, "utf8")
+		]);
+		const req = https.default.request({
+			hostname: "api.openai.com",
+			port: 443,
+			path: "/v1/audio/transcriptions",
+			method: "POST",
+			headers: {
+				"Authorization": `Bearer ${apiKey}`,
+				"Content-Type": `multipart/form-data; boundary=${boundary}`,
+				"Content-Length": body.length
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const j = JSON.parse(data);
+					resolve(j.text?.trim() || "[No transcription]");
+				} catch {
+					resolve(`[Transcription error: ${data.slice(0, 100)}]`);
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(body);
+		req.end();
+	});
+}
+async function transcribeWithGemini(buffer, apiKey) {
+	const base64 = buffer.toString("base64");
+	const payload = JSON.stringify({
+		contents: [{ parts: [{ text: "Transcribe this audio to text. Output only the transcription, no other text." }, { inlineData: {
+			mimeType: "audio/ogg",
+			data: base64
+		} }] }],
+		generationConfig: { maxOutputTokens: 1024 }
+	});
+	return new Promise((resolve, reject) => {
+		const req = https.default.request({
+			hostname: "generativelanguage.googleapis.com",
+			port: 443,
+			path: "/v1beta/models/gemini-2.0-flash:generateContent?key=" + encodeURIComponent(apiKey),
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				"Content-Length": Buffer.byteLength(payload)
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const j = JSON.parse(data);
+					const text = j.candidates?.[0]?.content?.parts?.[0]?.text?.trim();
+					resolve(text || "[No transcription]");
+				} catch {
+					resolve(`[Transcription error: ${data.slice(0, 100)}]`);
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(payload);
+		req.end();
+	});
+}
+/**
+
+* Transcribe audio using configured provider or fallbacks.
+
+* Providers: OpenAI (Whisper), Google (Gemini), OpenRouter.
+
+* Env: OPENAI_API_KEY, WHISPER_API_KEY, GOOGLE_AI_API_KEY.
+
+*/
+async function transcribeVoiceNote(audioPathOrBuffer, apiKey) {
+	let buffer;
+	try {
+		buffer = await loadAudioInput(audioPathOrBuffer);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	const cfg = await getConfig();
+	const openaiKey = apiKey || process.env.OPENAI_API_KEY || process.env.WHISPER_API_KEY || (cfg.providerId === "openai" || cfg.providerId === "openrouter" ? cfg.apiKey : "");
+	const googleKey = process.env.GOOGLE_AI_API_KEY || (cfg.providerId === "google" ? cfg.apiKey : "");
+	if (cfg.providerId === "google" && googleKey) try {
+		return await transcribeWithGemini(buffer, googleKey);
+	} catch {}
+	if ((cfg.providerId === "openrouter" || cfg.providerId === "openai") && openaiKey) try {
+		return await transcribeWithWhisper(buffer, openaiKey);
+	} catch {}
+	if (openaiKey) try {
+		return await transcribeWithWhisper(buffer, openaiKey);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	if (googleKey) try {
+		return await transcribeWithGemini(buffer, googleKey);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	return "[Voice note — add OPENAI_API_KEY or GOOGLE_AI_API_KEY (or select OpenAI/Google provider in the wizard) for transcription]";
+}
+
+//#endregion
+exports.transcribeVoiceNote = transcribeVoiceNote;

package/dist/voice-transcription-CvQuWPYK.js

@@ -0,0 +1,170 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const https = require_chunk.__toESM(require("https"));
+
+//#region src/services/voice-transcription.ts
+require_paths$1.init_paths();
+const MAX_AUDIO_BYTES = 25 * 1024 * 1024;
+const ALLOWED_AUDIO_EXTENSIONS = new Set([
+	".ogg",
+	".oga",
+	".mp3",
+	".wav",
+	".m4a",
+	".mp4",
+	".mpeg",
+	".webm"
+]);
+function sanitizeForError(value) {
+	return String(value ?? "").replace(/[\r\n\t]+/g, " ").slice(0, 160);
+}
+async function loadAudioInput(audioPathOrBuffer) {
+	if (Buffer.isBuffer(audioPathOrBuffer)) {
+		if (audioPathOrBuffer.length === 0) throw new Error("Audio input is empty");
+		if (audioPathOrBuffer.length > MAX_AUDIO_BYTES) throw new Error(`Audio input exceeds ${MAX_AUDIO_BYTES} bytes`);
+		return audioPathOrBuffer;
+	}
+	const resolvedPath = path.default.resolve(audioPathOrBuffer);
+	const ext = path.default.extname(resolvedPath).toLowerCase();
+	if (!ALLOWED_AUDIO_EXTENSIONS.has(ext)) throw new Error(`Unsupported audio file type: ${ext || "unknown"}`);
+	const buf = await fs_extra.default.readFile(resolvedPath);
+	if (buf.length === 0) throw new Error("Audio input is empty");
+	if (buf.length > MAX_AUDIO_BYTES) throw new Error(`Audio input exceeds ${MAX_AUDIO_BYTES} bytes`);
+	return buf;
+}
+async function getConfig() {
+	try {
+		const cfg = await fs_extra.default.readJson(require_paths.getConfigPath());
+		const providerId = cfg?.provider?.providerId;
+		const apiKey = cfg?.provider?.apiKey;
+		return {
+			providerId,
+			apiKey
+		};
+	} catch {
+		return {};
+	}
+}
+async function transcribeWithWhisper(buffer, apiKey) {
+	return new Promise((resolve, reject) => {
+		const boundary = "----HyperClaw" + Date.now();
+		const header = [
+			`--${boundary}`,
+			"Content-Disposition: form-data; name=\"file\"; filename=\"audio.ogg\"",
+			"Content-Type: application/octet-stream",
+			"",
+			""
+		].join("\r\n");
+		const footer = `\r\n--${boundary}\r\nContent-Disposition: form-data; name="model"\r\n\r\nwhisper-1\r\n--${boundary}--\r\n`;
+		const body = Buffer.concat([
+			Buffer.from(header, "utf8"),
+			buffer,
+			Buffer.from(footer, "utf8")
+		]);
+		const req = https.default.request({
+			hostname: "api.openai.com",
+			port: 443,
+			path: "/v1/audio/transcriptions",
+			method: "POST",
+			headers: {
+				"Authorization": `Bearer ${apiKey}`,
+				"Content-Type": `multipart/form-data; boundary=${boundary}`,
+				"Content-Length": body.length
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const j = JSON.parse(data);
+					resolve(j.text?.trim() || "[No transcription]");
+				} catch {
+					resolve(`[Transcription error: ${data.slice(0, 100)}]`);
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(body);
+		req.end();
+	});
+}
+async function transcribeWithGemini(buffer, apiKey) {
+	const base64 = buffer.toString("base64");
+	const payload = JSON.stringify({
+		contents: [{ parts: [{ text: "Transcribe this audio to text. Output only the transcription, no other text." }, { inlineData: {
+			mimeType: "audio/ogg",
+			data: base64
+		} }] }],
+		generationConfig: { maxOutputTokens: 1024 }
+	});
+	return new Promise((resolve, reject) => {
+		const req = https.default.request({
+			hostname: "generativelanguage.googleapis.com",
+			port: 443,
+			path: "/v1beta/models/gemini-2.0-flash:generateContent?key=" + encodeURIComponent(apiKey),
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				"Content-Length": Buffer.byteLength(payload)
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const j = JSON.parse(data);
+					const text = j.candidates?.[0]?.content?.parts?.[0]?.text?.trim();
+					resolve(text || "[No transcription]");
+				} catch {
+					resolve(`[Transcription error: ${data.slice(0, 100)}]`);
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(payload);
+		req.end();
+	});
+}
+/**
+
+* Transcribe audio using configured provider or fallbacks.
+
+* Providers: OpenAI (Whisper), Google (Gemini), OpenRouter.
+
+* Env: OPENAI_API_KEY, WHISPER_API_KEY, GOOGLE_AI_API_KEY.
+
+*/
+async function transcribeVoiceNote(audioPathOrBuffer, apiKey) {
+	let buffer;
+	try {
+		buffer = await loadAudioInput(audioPathOrBuffer);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	const cfg = await getConfig();
+	const openaiKey = apiKey || process.env.OPENAI_API_KEY || process.env.WHISPER_API_KEY || (cfg.providerId === "openai" || cfg.providerId === "openrouter" ? cfg.apiKey : "");
+	const googleKey = process.env.GOOGLE_AI_API_KEY || (cfg.providerId === "google" ? cfg.apiKey : "");
+	if (cfg.providerId === "google" && googleKey) try {
+		return await transcribeWithGemini(buffer, googleKey);
+	} catch {}
+	if ((cfg.providerId === "openrouter" || cfg.providerId === "openai") && openaiKey) try {
+		return await transcribeWithWhisper(buffer, openaiKey);
+	} catch {}
+	if (openaiKey) try {
+		return await transcribeWithWhisper(buffer, openaiKey);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	if (googleKey) try {
+		return await transcribeWithGemini(buffer, googleKey);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	return "[Voice note — add OPENAI_API_KEY or GOOGLE_AI_API_KEY (or select OpenAI/Google provider in the wizard) for transcription]";
+}
+
+//#endregion
+exports.transcribeVoiceNote = transcribeVoiceNote;

package/dist/voice-transcription-YqndiLA7.js

@@ -0,0 +1,170 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const https = require_chunk.__toESM(require("https"));
+
+//#region src/services/voice-transcription.ts
+require_paths$1.init_paths();
+const MAX_AUDIO_BYTES = 25 * 1024 * 1024;
+const ALLOWED_AUDIO_EXTENSIONS = new Set([
+	".ogg",
+	".oga",
+	".mp3",
+	".wav",
+	".m4a",
+	".mp4",
+	".mpeg",
+	".webm"
+]);
+function sanitizeForError(value) {
+	return String(value ?? "").replace(/[\r\n\t]+/g, " ").slice(0, 160);
+}
+async function loadAudioInput(audioPathOrBuffer) {
+	if (Buffer.isBuffer(audioPathOrBuffer)) {
+		if (audioPathOrBuffer.length === 0) throw new Error("Audio input is empty");
+		if (audioPathOrBuffer.length > MAX_AUDIO_BYTES) throw new Error(`Audio input exceeds ${MAX_AUDIO_BYTES} bytes`);
+		return audioPathOrBuffer;
+	}
+	const resolvedPath = path.default.resolve(audioPathOrBuffer);
+	const ext = path.default.extname(resolvedPath).toLowerCase();
+	if (!ALLOWED_AUDIO_EXTENSIONS.has(ext)) throw new Error(`Unsupported audio file type: ${ext || "unknown"}`);
+	const buf = await fs_extra.default.readFile(resolvedPath);
+	if (buf.length === 0) throw new Error("Audio input is empty");
+	if (buf.length > MAX_AUDIO_BYTES) throw new Error(`Audio input exceeds ${MAX_AUDIO_BYTES} bytes`);
+	return buf;
+}
+async function getConfig() {
+	try {
+		const cfg = await fs_extra.default.readJson(require_paths.getConfigPath());
+		const providerId = cfg?.provider?.providerId;
+		const apiKey = cfg?.provider?.apiKey;
+		return {
+			providerId,
+			apiKey
+		};
+	} catch {
+		return {};
+	}
+}
+async function transcribeWithWhisper(buffer, apiKey) {
+	return new Promise((resolve, reject) => {
+		const boundary = "----HyperClaw" + Date.now();
+		const header = [
+			`--${boundary}`,
+			"Content-Disposition: form-data; name=\"file\"; filename=\"audio.ogg\"",
+			"Content-Type: application/octet-stream",
+			"",
+			""
+		].join("\r\n");
+		const footer = `\r\n--${boundary}\r\nContent-Disposition: form-data; name="model"\r\n\r\nwhisper-1\r\n--${boundary}--\r\n`;
+		const body = Buffer.concat([
+			Buffer.from(header, "utf8"),
+			buffer,
+			Buffer.from(footer, "utf8")
+		]);
+		const req = https.default.request({
+			hostname: "api.openai.com",
+			port: 443,
+			path: "/v1/audio/transcriptions",
+			method: "POST",
+			headers: {
+				"Authorization": `Bearer ${apiKey}`,
+				"Content-Type": `multipart/form-data; boundary=${boundary}`,
+				"Content-Length": body.length
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const j = JSON.parse(data);
+					resolve(j.text?.trim() || "[No transcription]");
+				} catch {
+					resolve(`[Transcription error: ${data.slice(0, 100)}]`);
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(body);
+		req.end();
+	});
+}
+async function transcribeWithGemini(buffer, apiKey) {
+	const base64 = buffer.toString("base64");
+	const payload = JSON.stringify({
+		contents: [{ parts: [{ text: "Transcribe this audio to text. Output only the transcription, no other text." }, { inlineData: {
+			mimeType: "audio/ogg",
+			data: base64
+		} }] }],
+		generationConfig: { maxOutputTokens: 1024 }
+	});
+	return new Promise((resolve, reject) => {
+		const req = https.default.request({
+			hostname: "generativelanguage.googleapis.com",
+			port: 443,
+			path: "/v1beta/models/gemini-2.0-flash:generateContent?key=" + encodeURIComponent(apiKey),
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				"Content-Length": Buffer.byteLength(payload)
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const j = JSON.parse(data);
+					const text = j.candidates?.[0]?.content?.parts?.[0]?.text?.trim();
+					resolve(text || "[No transcription]");
+				} catch {
+					resolve(`[Transcription error: ${data.slice(0, 100)}]`);
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(payload);
+		req.end();
+	});
+}
+/**
+
+* Transcribe audio using configured provider or fallbacks.
+
+* Providers: OpenAI (Whisper), Google (Gemini), OpenRouter.
+
+* Env: OPENAI_API_KEY, WHISPER_API_KEY, GOOGLE_AI_API_KEY.
+
+*/
+async function transcribeVoiceNote(audioPathOrBuffer, apiKey) {
+	let buffer;
+	try {
+		buffer = await loadAudioInput(audioPathOrBuffer);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	const cfg = await getConfig();
+	const openaiKey = apiKey || process.env.OPENAI_API_KEY || process.env.WHISPER_API_KEY || (cfg.providerId === "openai" || cfg.providerId === "openrouter" ? cfg.apiKey : "");
+	const googleKey = process.env.GOOGLE_AI_API_KEY || (cfg.providerId === "google" ? cfg.apiKey : "");
+	if (cfg.providerId === "google" && googleKey) try {
+		return await transcribeWithGemini(buffer, googleKey);
+	} catch {}
+	if ((cfg.providerId === "openrouter" || cfg.providerId === "openai") && openaiKey) try {
+		return await transcribeWithWhisper(buffer, openaiKey);
+	} catch {}
+	if (openaiKey) try {
+		return await transcribeWithWhisper(buffer, openaiKey);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	if (googleKey) try {
+		return await transcribeWithGemini(buffer, googleKey);
+	} catch (e) {
+		return `[Transcription failed: ${sanitizeForError(e?.message)}]`;
+	}
+	return "[Voice note — add OPENAI_API_KEY or GOOGLE_AI_API_KEY (or select OpenAI/Google provider in the wizard) for transcription]";
+}
+
+//#endregion
+exports.transcribeVoiceNote = transcribeVoiceNote;