@polpo-ai/tools 0.2.4

package/dist/audio-tools.js

@@ -0,0 +1,552 @@
+/**
+ * Audio tools for speech-to-text (STT) and text-to-speech (TTS).
+ *
+ * Provides agent capabilities to:
+ * - Transcribe audio files to text (audio_transcribe)
+ * - Generate speech audio from text (audio_speak)
+ *
+ * Architecture: direct fetch() to provider REST APIs — zero vendor SDK dependencies.
+ *
+ * Supported providers:
+ *   STT: openai (Whisper), deepgram (Nova)
+ *   TTS: openai (gpt-4o-mini-tts / tts-1), deepgram (Aura), elevenlabs, edge (free, local)
+ *
+ * Edge TTS: Uses Microsoft Edge's neural TTS engine via the `edge-tts` CLI.
+ * Free, no API key, ~400 voices in 60+ languages. Auto-selects voice from
+ * language + gender params. Also used as automatic fallback when cloud providers fail.
+ * Install: `pip install edge-tts`
+ *
+ * Credential resolution order (same as email/image tools):
+ *   1. Agent vault (per-agent credentials — e.g. service "openai" key "key")
+ *   2. Environment variables (global fallback)
+ *   3. Edge TTS (automatic fallback — no credentials needed)
+ *
+ * Environment variables (fallback):
+ *   OPENAI_API_KEY    — openai provider (STT + TTS)
+ *   DEEPGRAM_API_KEY  — deepgram provider (STT + TTS)
+ *   ELEVENLABS_API_KEY — elevenlabs provider (TTS)
+ */
+import { readFileSync, writeFileSync, mkdirSync, statSync } from "node:fs";
+import { resolve, dirname, extname } from "node:path";
+import { execFile } from "node:child_process";
+import { Type } from "@sinclair/typebox";
+import { resolveAllowedPaths, assertPathAllowed } from "./path-sandbox.js";
+// ─── Constants ───
+const MAX_AUDIO_SIZE = 25 * 1024 * 1024; // 25 MB (OpenAI Whisper limit)
+const DEFAULT_TIMEOUT = 120_000; // 2 min for audio processing
+// ─── Helpers ───
+function requireEnv(key) {
+    const val = process.env[key];
+    if (!val)
+        throw new Error(`Missing environment variable: ${key}. Set it before using this tool.`);
+    return val;
+}
+/** Build a FormData-like multipart body for fetch (Node 18+). */
+function audioFormData(fileBuffer, filename, fields) {
+    const form = new FormData();
+    const blob = new Blob([new Uint8Array(fileBuffer)], { type: mimeFromExt(extname(filename)) });
+    form.append("file", blob, filename);
+    for (const [k, v] of Object.entries(fields)) {
+        form.append(k, v);
+    }
+    return { body: form };
+}
+function mimeFromExt(ext) {
+    const map = {
+        ".mp3": "audio/mpeg",
+        ".wav": "audio/wav",
+        ".flac": "audio/flac",
+        ".ogg": "audio/ogg",
+        ".m4a": "audio/mp4",
+        ".webm": "audio/webm",
+        ".mp4": "audio/mp4",
+        ".mpeg": "audio/mpeg",
+        ".mpga": "audio/mpeg",
+    };
+    return map[ext.toLowerCase()] ?? "application/octet-stream";
+}
+// ─── Tool: audio_transcribe ───
+const AudioTranscribeSchema = Type.Object({
+    path: Type.String({ description: "Path to the audio file to transcribe (mp3, wav, flac, ogg, m4a, webm)" }),
+    provider: Type.Optional(Type.Union([
+        Type.Literal("openai"),
+        Type.Literal("deepgram"),
+    ], { description: "STT provider (default: openai)" })),
+    model: Type.Optional(Type.String({ description: "Model name. OpenAI: 'whisper-1' (default). Deepgram: 'nova-3' (default)." })),
+    language: Type.Optional(Type.String({ description: "ISO 639-1 language code (e.g. 'en', 'it', 'es'). Helps accuracy." })),
+    prompt: Type.Optional(Type.String({ description: "Optional context/prompt to guide transcription (OpenAI only)" })),
+});
+function createTranscribeTool(cwd, sandbox, vault) {
+    return {
+        name: "audio_transcribe",
+        label: "Transcribe Audio",
+        description: "Transcribe an audio file to text using speech-to-text AI. " +
+            "Supports mp3, wav, flac, ogg, m4a, webm formats. Max file size: 25 MB. " +
+            "Providers: openai (Whisper, default), deepgram (Nova). " +
+            "Credentials resolved from: agent vault > OPENAI_API_KEY or DEEPGRAM_API_KEY env var.",
+        parameters: AudioTranscribeSchema,
+        async execute(_id, params, signal) {
+            const filePath = resolve(cwd, params.path);
+            assertPathAllowed(filePath, sandbox, "audio_transcribe");
+            const provider = params.provider ?? "openai";
+            let fileBuffer;
+            try {
+                fileBuffer = readFileSync(filePath);
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `Error reading audio file: ${err.message}` }],
+                    details: { error: "file_read_error" },
+                };
+            }
+            if (fileBuffer.byteLength > MAX_AUDIO_SIZE) {
+                return {
+                    content: [{ type: "text", text: `Audio file too large: ${(fileBuffer.byteLength / 1024 / 1024).toFixed(1)} MB (max ${MAX_AUDIO_SIZE / 1024 / 1024} MB)` }],
+                    details: { error: "file_too_large", size: fileBuffer.byteLength },
+                };
+            }
+            try {
+                if (provider === "openai") {
+                    return await transcribeOpenAI(filePath, fileBuffer, params, vault, signal);
+                }
+                else {
+                    return await transcribeDeepgram(filePath, fileBuffer, params, vault, signal);
+                }
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `Transcription error (${provider}): ${err.message}` }],
+                    details: { provider, error: err.message },
+                };
+            }
+        },
+    };
+}
+async function transcribeOpenAI(filePath, fileBuffer, params, vault, signal) {
+    const apiKey = vault?.getKey("openai", "key") ?? requireEnv("OPENAI_API_KEY");
+    const model = params.model ?? "whisper-1";
+    const fields = { model };
+    if (params.language)
+        fields.language = params.language;
+    if (params.prompt)
+        fields.prompt = params.prompt;
+    fields.response_format = "verbose_json";
+    const { body } = audioFormData(fileBuffer, filePath.split("/").pop(), fields);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
+    if (signal)
+        signal.addEventListener("abort", () => controller.abort(), { once: true });
+    const response = await fetch("https://api.openai.com/v1/audio/transcriptions", {
+        method: "POST",
+        headers: { Authorization: `Bearer ${apiKey}` },
+        body,
+        signal: controller.signal,
+    });
+    clearTimeout(timer);
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`OpenAI API ${response.status}: ${errText}`);
+    }
+    const data = await response.json();
+    const info = [
+        `Language: ${data.language ?? "unknown"}`,
+        `Duration: ${data.duration ? `${data.duration.toFixed(1)}s` : "unknown"}`,
+        `Model: ${model}`,
+    ].join(" | ");
+    return {
+        content: [{ type: "text", text: `${info}\n\n${data.text}` }],
+        details: {
+            provider: "openai",
+            model,
+            language: data.language,
+            duration: data.duration,
+            textLength: data.text.length,
+        },
+    };
+}
+async function transcribeDeepgram(filePath, fileBuffer, params, vault, signal) {
+    const apiKey = vault?.getKey("deepgram", "key") ?? requireEnv("DEEPGRAM_API_KEY");
+    const model = params.model ?? "nova-3";
+    const queryParams = new URLSearchParams({
+        model,
+        smart_format: "true",
+        punctuate: "true",
+    });
+    if (params.language)
+        queryParams.set("language", params.language);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
+    if (signal)
+        signal.addEventListener("abort", () => controller.abort(), { once: true });
+    const ext = extname(filePath).toLowerCase();
+    const mime = mimeFromExt(ext);
+    const response = await fetch(`https://api.deepgram.com/v1/listen?${queryParams}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Token ${apiKey}`,
+            "Content-Type": mime,
+        },
+        body: new Uint8Array(fileBuffer),
+        signal: controller.signal,
+    });
+    clearTimeout(timer);
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`Deepgram API ${response.status}: ${errText}`);
+    }
+    const data = await response.json();
+    const transcript = data.results?.channels?.[0]?.alternatives?.[0]?.transcript ?? "";
+    const confidence = data.results?.channels?.[0]?.alternatives?.[0]?.confidence;
+    const duration = data.metadata?.duration;
+    const info = [
+        `Confidence: ${confidence ? `${(confidence * 100).toFixed(1)}%` : "unknown"}`,
+        `Duration: ${duration ? `${duration.toFixed(1)}s` : "unknown"}`,
+        `Model: ${model}`,
+    ].join(" | ");
+    return {
+        content: [{ type: "text", text: `${info}\n\n${transcript}` }],
+        details: {
+            provider: "deepgram",
+            model,
+            confidence,
+            duration,
+            textLength: transcript.length,
+        },
+    };
+}
+// ─── Tool: audio_speak ───
+const AudioSpeakSchema = Type.Object({
+    text: Type.String({ description: "Text to convert to speech" }),
+    path: Type.String({ description: "Output file path (e.g. 'output.mp3'). Format inferred from extension." }),
+    provider: Type.Optional(Type.Union([
+        Type.Literal("openai"),
+        Type.Literal("deepgram"),
+        Type.Literal("elevenlabs"),
+        Type.Literal("edge"),
+    ], { description: "TTS provider. 'openai' (default), 'deepgram', 'elevenlabs', or 'edge' (free, local Microsoft Edge TTS — no API key needed). If the chosen provider fails, edge-tts is tried as automatic fallback." })),
+    model: Type.Optional(Type.String({ description: "Model name. OpenAI: 'tts-1' (default), 'tts-1-hd', 'gpt-4o-mini-tts'. Deepgram: 'aura-2-en' (default). ElevenLabs: 'eleven_multilingual_v2' (default)." })),
+    voice: Type.Optional(Type.String({ description: "Voice name/ID. OpenAI: alloy, echo, fable, onyx, nova, shimmer (default: alloy). ElevenLabs: voice ID. Edge: full voice name like 'it-IT-DiegoNeural' (auto-selected from language+gender if omitted)." })),
+    language: Type.Optional(Type.String({ description: "ISO 639-1 language code (e.g. 'it', 'en', 'es'). Used by edge provider to select the right voice. Also useful for other providers with multilingual models." })),
+    gender: Type.Optional(Type.Union([
+        Type.Literal("male"),
+        Type.Literal("female"),
+    ], { description: "Voice gender preference. Used by edge provider to pick the right voice when no explicit voice is given. For other providers, choose the voice directly." })),
+    speed: Type.Optional(Type.Number({ description: "Playback speed 0.25-4.0 (OpenAI only, default: 1.0)" })),
+    instructions: Type.Optional(Type.String({ description: "Voice style instructions (OpenAI gpt-4o-mini-tts only, e.g. 'Speak in a cheerful tone')" })),
+});
+function createSpeakTool(cwd, sandbox, vault) {
+    return {
+        name: "audio_speak",
+        label: "Text to Speech",
+        description: "Generate speech audio from text using text-to-speech AI. " +
+            "Output format is inferred from file extension (mp3, wav, flac, opus, aac, pcm). " +
+            "Providers: openai (default), deepgram (Aura), elevenlabs, edge (free, no API key — Microsoft Edge neural voices). " +
+            "If the chosen provider fails (quota, auth, billing), edge-tts is tried automatically as fallback. " +
+            "Use 'language' (ISO 639-1) and 'gender' params to help select the right voice, especially for edge provider. " +
+            "Credentials resolved from: agent vault > OPENAI_API_KEY, DEEPGRAM_API_KEY, or ELEVENLABS_API_KEY env var.",
+        parameters: AudioSpeakSchema,
+        async execute(_id, params, signal) {
+            const filePath = resolve(cwd, params.path);
+            assertPathAllowed(filePath, sandbox, "audio_speak");
+            const provider = params.provider ?? "openai";
+            // Direct edge-tts request — no fallback needed
+            if (provider === "edge") {
+                try {
+                    return await speakEdgeTts(filePath, params, signal);
+                }
+                catch (err) {
+                    return {
+                        content: [{ type: "text", text: `TTS error (edge): ${err.message}` }],
+                        details: { provider: "edge", error: err.message },
+                    };
+                }
+            }
+            // Cloud provider with edge-tts fallback
+            try {
+                if (provider === "openai") {
+                    return await speakOpenAI(filePath, params, vault, signal);
+                }
+                else if (provider === "deepgram") {
+                    return await speakDeepgram(filePath, params, vault, signal);
+                }
+                else {
+                    return await speakElevenLabs(filePath, params, vault, signal);
+                }
+            }
+            catch (err) {
+                // Automatic fallback to edge-tts if available
+                if (edgeTtsAvailable()) {
+                    try {
+                        const result = await speakEdgeTts(filePath, params, signal);
+                        // Prepend fallback notice
+                        const notice = `[Fallback] ${provider} failed (${err.message}), used edge-tts instead.\n`;
+                        return {
+                            content: [{ type: "text", text: notice + result.content[0].text }],
+                            details: { ...result.details, fallbackFrom: provider, fallbackReason: err.message },
+                        };
+                    }
+                    catch (edgeErr) {
+                        return {
+                            content: [{ type: "text", text: `TTS error (${provider}): ${err.message}\nEdge-tts fallback also failed: ${edgeErr.message}` }],
+                            details: { provider, error: err.message, edgeError: edgeErr.message },
+                        };
+                    }
+                }
+                return {
+                    content: [{ type: "text", text: `TTS error (${provider}): ${err.message}` }],
+                    details: { provider, error: err.message },
+                };
+            }
+        },
+    };
+}
+async function speakOpenAI(filePath, params, vault, signal) {
+    const apiKey = vault?.getKey("openai", "key") ?? requireEnv("OPENAI_API_KEY");
+    const model = params.model ?? "tts-1";
+    const voice = params.voice ?? "alloy";
+    const ext = extname(filePath).toLowerCase().replace(".", "");
+    const formatMap = {
+        mp3: "mp3", wav: "wav", flac: "flac", opus: "opus", aac: "aac", pcm: "pcm",
+    };
+    const responseFormat = formatMap[ext] ?? "mp3";
+    const body = {
+        model,
+        input: params.text,
+        voice,
+        response_format: responseFormat,
+    };
+    if (params.speed !== undefined)
+        body.speed = params.speed;
+    if (params.instructions)
+        body.instructions = params.instructions;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
+    if (signal)
+        signal.addEventListener("abort", () => controller.abort(), { once: true });
+    const response = await fetch("https://api.openai.com/v1/audio/speech", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal,
+    });
+    clearTimeout(timer);
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`OpenAI TTS API ${response.status}: ${errText}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, buffer);
+    return {
+        content: [{ type: "text", text: `Speech audio saved: ${filePath} (${(buffer.byteLength / 1024).toFixed(1)} KB, ${responseFormat}, voice: ${voice}, model: ${model})` }],
+        details: {
+            provider: "openai",
+            model,
+            voice,
+            format: responseFormat,
+            path: filePath,
+            bytes: buffer.byteLength,
+            textLength: params.text.length,
+        },
+    };
+}
+async function speakDeepgram(filePath, params, vault, signal) {
+    const apiKey = vault?.getKey("deepgram", "key") ?? requireEnv("DEEPGRAM_API_KEY");
+    const model = params.model ?? "aura-2-en";
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
+    if (signal)
+        signal.addEventListener("abort", () => controller.abort(), { once: true });
+    const response = await fetch(`https://api.deepgram.com/v1/speak?model=${encodeURIComponent(model)}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Token ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ text: params.text }),
+        signal: controller.signal,
+    });
+    clearTimeout(timer);
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`Deepgram TTS API ${response.status}: ${errText}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, buffer);
+    return {
+        content: [{ type: "text", text: `Speech audio saved: ${filePath} (${(buffer.byteLength / 1024).toFixed(1)} KB, model: ${model})` }],
+        details: {
+            provider: "deepgram",
+            model,
+            format: "mp3",
+            path: filePath,
+            bytes: buffer.byteLength,
+            textLength: params.text.length,
+        },
+    };
+}
+async function speakElevenLabs(filePath, params, vault, signal) {
+    const apiKey = vault?.getKey("elevenlabs", "key") ?? requireEnv("ELEVENLABS_API_KEY");
+    const model = params.model ?? "eleven_multilingual_v2";
+    // ElevenLabs default voice: "Rachel" (21m00Tcm4TlvDq8ikWAM)
+    const voiceId = params.voice ?? "21m00Tcm4TlvDq8ikWAM";
+    const ext = extname(filePath).toLowerCase().replace(".", "");
+    const formatMap = {
+        mp3: "mp3_44100_128", wav: "pcm_44100", flac: "flac",
+    };
+    const outputFormat = formatMap[ext] ?? "mp3_44100_128";
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
+    if (signal)
+        signal.addEventListener("abort", () => controller.abort(), { once: true });
+    const response = await fetch(`https://api.elevenlabs.io/v1/text-to-speech/${voiceId}?output_format=${outputFormat}`, {
+        method: "POST",
+        headers: {
+            "xi-api-key": apiKey,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            text: params.text,
+            model_id: model,
+        }),
+        signal: controller.signal,
+    });
+    clearTimeout(timer);
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`ElevenLabs API ${response.status}: ${errText}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, buffer);
+    return {
+        content: [{ type: "text", text: `Speech audio saved: ${filePath} (${(buffer.byteLength / 1024).toFixed(1)} KB, voice: ${voiceId}, model: ${model})` }],
+        details: {
+            provider: "elevenlabs",
+            model,
+            voiceId,
+            format: outputFormat,
+            path: filePath,
+            bytes: buffer.byteLength,
+            textLength: params.text.length,
+        },
+    };
+}
+// ─── Edge TTS (free, local CLI, automatic fallback) ───
+/**
+ * Default Edge TTS voices per language+gender.
+ * Format: `${lang}-${region}-${name}Neural`
+ * Each entry: [female, male]. First match wins.
+ */
+const EDGE_VOICES = {
+    "it": ["it-IT-ElsaNeural", "it-IT-DiegoNeural"],
+    "en": ["en-US-EmmaMultilingualNeural", "en-US-AndrewMultilingualNeural"],
+    "es": ["es-ES-ElviraNeural", "es-ES-AlvaroNeural"],
+    "fr": ["fr-FR-DeniseNeural", "fr-FR-HenriNeural"],
+    "de": ["de-DE-KatjaNeural", "de-DE-ConradNeural"],
+    "pt": ["pt-BR-FranciscaNeural", "pt-BR-AntonioNeural"],
+    "ja": ["ja-JP-NanamiNeural", "ja-JP-KeitaNeural"],
+    "zh": ["zh-CN-XiaoxiaoNeural", "zh-CN-YunxiNeural"],
+    "ko": ["ko-KR-SunHiNeural", "ko-KR-InJoonNeural"],
+    "ar": ["ar-SA-ZariyahNeural", "ar-SA-HamedNeural"],
+    "hi": ["hi-IN-SwaraNeural", "hi-IN-MadhurNeural"],
+    "ru": ["ru-RU-SvetlanaNeural", "ru-RU-DmitryNeural"],
+    "nl": ["nl-NL-ColetteNeural", "nl-NL-MaartenNeural"],
+    "pl": ["pl-PL-AgnieszkaNeural", "pl-PL-MarekNeural"],
+    "tr": ["tr-TR-EmelNeural", "tr-TR-AhmetNeural"],
+    "sv": ["sv-SE-SofieNeural", "sv-SE-MattiasNeural"],
+};
+/**
+ * Resolve the best Edge TTS voice for a given language and gender hint.
+ * Falls back to en-US if the language is unknown.
+ */
+function resolveEdgeVoice(voice, language, gender) {
+    // If the agent passed an explicit voice name like "it-IT-DiegoNeural", use it directly
+    if (voice && voice.includes("-") && voice.endsWith("Neural"))
+        return voice;
+    const lang = (language ?? "en").toLowerCase().split("-")[0]; // "it-IT" → "it"
+    const pair = EDGE_VOICES[lang] ?? EDGE_VOICES["en"];
+    return gender === "male" ? pair[1] : pair[0]; // default female if no gender hint
+}
+/** Check if edge-tts CLI is available on the system. */
+function isEdgeTtsAvailable() {
+    try {
+        const { execFileSync } = require("node:child_process");
+        execFileSync("edge-tts", ["--version"], { stdio: "pipe", timeout: 5000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Cache the availability check
+let _edgeTtsAvailable;
+function edgeTtsAvailable() {
+    if (_edgeTtsAvailable === undefined)
+        _edgeTtsAvailable = isEdgeTtsAvailable();
+    return _edgeTtsAvailable;
+}
+async function speakEdgeTts(filePath, params, signal) {
+    if (!edgeTtsAvailable()) {
+        throw new Error("edge-tts CLI is not installed. Install it with: pip install edge-tts");
+    }
+    const voice = resolveEdgeVoice(params.voice, params.language, params.gender);
+    mkdirSync(dirname(filePath), { recursive: true });
+    // Determine rate from speed if present
+    const args = [
+        "--text", params.text,
+        "--voice", voice,
+        "--write-media", filePath,
+    ];
+    return new Promise((resolvePromise, reject) => {
+        const child = execFile("edge-tts", args, { timeout: DEFAULT_TIMEOUT }, (err, _stdout, stderr) => {
+            if (err) {
+                reject(new Error(`edge-tts failed: ${err.message}${stderr ? ` — ${stderr}` : ""}`));
+                return;
+            }
+            let bytes = 0;
+            try {
+                bytes = statSync(filePath).size;
+            }
+            catch { /* ignore */ }
+            resolvePromise({
+                content: [{ type: "text", text: `Speech audio saved: ${filePath} (${(bytes / 1024).toFixed(1)} KB, voice: ${voice}, provider: edge-tts)` }],
+                details: {
+                    provider: "edge",
+                    voice,
+                    path: filePath,
+                    bytes,
+                    textLength: params.text.length,
+                },
+            });
+        });
+        if (signal) {
+            signal.addEventListener("abort", () => child.kill(), { once: true });
+        }
+    });
+}
+export const ALL_AUDIO_TOOL_NAMES = ["audio_transcribe", "audio_speak"];
+/**
+ * Create audio tools for speech-to-text and text-to-speech.
+ *
+ * @param cwd - Working directory for resolving file paths
+ * @param allowedPaths - Sandbox paths for file validation
+ * @param allowedTools - Optional filter
+ * @param vault - Resolved vault credentials for credential resolution
+ */
+export function createAudioTools(cwd, allowedPaths, allowedTools, vault) {
+    const sandbox = resolveAllowedPaths(cwd, allowedPaths);
+    const factories = {
+        audio_transcribe: () => createTranscribeTool(cwd, sandbox, vault),
+        audio_speak: () => createSpeakTool(cwd, sandbox, vault),
+    };
+    const names = allowedTools
+        ? ALL_AUDIO_TOOL_NAMES.filter(n => allowedTools.some(a => a.toLowerCase() === n))
+        : ALL_AUDIO_TOOL_NAMES;
+    return names.map(n => factories[n]());
+}
+//# sourceMappingURL=audio-tools.js.map

package/dist/audio-tools.js.map

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

package/dist/browser-tools.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Browser automation tools powered by agent-browser.
+ *
+ * Uses the agent-browser CLI (https://github.com/vercel-labs/agent-browser)
+ * via child_process with --json output for structured results.
+ *
+ * The agent-browser CLI manages a daemon process that keeps the browser alive
+ * between commands, making sequential tool calls fast (no cold-start per command).
+ *
+ * Requires `agent-browser` to be installed globally or in PATH.
+ * Install: `npm install -g agent-browser && agent-browser install`
+ *
+ * Session isolation: Each agent gets its own browser session via --session flag,
+ * preventing cross-agent interference when multiple agents use browser tools.
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+/**
+ * Cleanup an agent-browser session: close the session.
+ * Profile data is automatically persisted by agent-browser when --profile is used.
+ * Called by the engine on agent exit.
+ */
+export declare function cleanupAgentBrowserSession(session: string): Promise<void>;
+export type BrowserToolName = "browser_navigate" | "browser_snapshot" | "browser_click" | "browser_fill" | "browser_type" | "browser_press" | "browser_screenshot" | "browser_get" | "browser_select" | "browser_hover" | "browser_scroll" | "browser_wait" | "browser_eval" | "browser_close" | "browser_back" | "browser_forward" | "browser_reload" | "browser_tabs";
+export declare const ALL_BROWSER_TOOL_NAMES: BrowserToolName[];
+/**
+ * Create browser automation tools powered by agent-browser CLI.
+ *
+ * @param cwd - Working directory for resolving relative file paths (screenshots)
+ * @param session - Browser session name for isolation (default: agent name or "default")
+ * @param allowedTools - Optional filter: only include tools with these names
+ * @param profileDir - Persistent browser profile directory. Passed as --profile to agent-browser.
+ *                     Stores cookies, localStorage, auth state across sessions.
+ *                     Typically `.polpo/browser-profiles/<agent>/`.
+ */
+export declare function createBrowserTools(cwd: string, session?: string, allowedTools?: string[], profileDir?: string): AgentTool<any>[];
+//# sourceMappingURL=browser-tools.d.ts.map

package/dist/browser-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tools.d.ts","sourceRoot":"","sources":["../src/browser-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAK9E;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/E;AAgfD,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAAG,kBAAkB,GAAG,eAAe,GAAG,cAAc,GAC1E,cAAc,GAAG,eAAe,GAAG,oBAAoB,GAAG,aAAa,GACvE,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,GAAG,cAAc,GACtE,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,iBAAiB,GACrE,gBAAgB,GAAG,cAAc,CAAC;AAEtC,eAAO,MAAM,sBAAsB,EAAE,eAAe,EAMnD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAkB,EAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,SAAS,CAAC,GAAG,CAAC,EAAE,CA2BlB"}