audio-mcp 0.1.0

package/dist/audio/helper-capture.js

@@ -0,0 +1,135 @@
+import { spawn } from "node:child_process";
+import { HELPER_BIN, verifyHelper } from "./helper-path.js";
+import { AudioMcpError } from "../errors.js";
+const GATEKEEPER_EXIT = 9; // process killed by Gatekeeper (SIGKILL)
+export class HelperProcessCapture {
+    child = null;
+    dataCb = null;
+    stderrBuf = "";
+    exitPromise = null;
+    command;
+    constructor(opts = {}) {
+        this.command = opts.command ?? [HELPER_BIN];
+    }
+    onData(cb) {
+        this.dataCb = cb;
+    }
+    async start(opts) {
+        // Only verify the packaged binary when using the default helper path.
+        if (this.command.length === 1 && this.command[0] === HELPER_BIN) {
+            const badBinary = verifyHelper();
+            if (badBinary)
+                throw this.binaryErrorToAudioMcpError(badBinary);
+        }
+        const args = [
+            ...this.command.slice(1),
+            "capture",
+            `--mode=${opts.captureMode}`,
+            `--sample-rate=${opts.sampleRate}`,
+        ];
+        if (opts.micDeviceId)
+            args.push(`--mic-device-id=${opts.micDeviceId}`);
+        if (opts.excludePid)
+            args.push(`--exclude-pid=${opts.excludePid}`);
+        const executable = this.command[0];
+        const child = spawn(executable, args, { stdio: ["ignore", "pipe", "pipe"] });
+        this.child = child;
+        this.stderrBuf = "";
+        child.stdout.on("data", (chunk) => {
+            if (this.dataCb)
+                this.dataCb(chunk);
+        });
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => {
+            this.stderrBuf += chunk;
+        });
+        this.exitPromise = new Promise((resolve) => {
+            child.once("exit", (code, signal) => {
+                // Translate signal into exit code convention (128 + signo).
+                if (code !== null)
+                    resolve(code);
+                else if (signal === "SIGKILL")
+                    resolve(GATEKEEPER_EXIT);
+                else
+                    resolve(-1);
+            });
+        });
+        // Race start() against an early-exit to catch permission failures.
+        const earlyFail = await this.waitForEarlyFail(300);
+        if (earlyFail) {
+            throw this.translateExit(earlyFail);
+        }
+    }
+    waitForEarlyFail(ms) {
+        return new Promise((resolve) => {
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    resolve(null);
+                }
+            }, ms);
+            this.exitPromise.then((code) => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timer);
+                    resolve(code);
+                }
+            });
+        });
+    }
+    async stop() {
+        const child = this.child;
+        if (!child)
+            return;
+        if (!child.killed && child.exitCode === null) {
+            child.kill("SIGTERM");
+        }
+        if (this.exitPromise) {
+            await this.exitPromise;
+        }
+        this.child = null;
+    }
+    binaryErrorToAudioMcpError(err) {
+        if (err.reason === "missing") {
+            return new AudioMcpError("AUDIO_DEVICE_ERROR", err.message);
+        }
+        if (err.reason === "not_executable") {
+            return new AudioMcpError("AUDIO_DEVICE_ERROR", `${err.message}\n\nIf macOS Gatekeeper blocked the binary, run:\n  xattr -d com.apple.quarantine "${HELPER_BIN}"\nOr approve it in System Settings → Privacy & Security.`);
+        }
+        return new AudioMcpError("AUDIO_DEVICE_ERROR", err.message);
+    }
+    translateExit(code) {
+        const stderrMsg = this.extractStderrMessage();
+        switch (code) {
+            case 2:
+                return new AudioMcpError("AUDIO_DEVICE_ERROR", `Microphone permission denied. ${stderrMsg}\n\n` +
+                    "Grant mic access in System Settings → Privacy & Security → Microphone for your MCP client, then restart the client.");
+            case 3:
+                return new AudioMcpError("AUDIO_DEVICE_ERROR", `Screen Recording permission denied (required for system audio capture). ${stderrMsg}\n\n` +
+                    "Grant access in System Settings → Privacy & Security → Screen Recording for your MCP client, then restart the client.");
+            case GATEKEEPER_EXIT:
+                return new AudioMcpError("AUDIO_DEVICE_ERROR", `macOS Gatekeeper blocked the audio helper binary. Run:\n` +
+                    `  xattr -d com.apple.quarantine "${HELPER_BIN}"\n` +
+                    `Or: System Settings → Privacy & Security → scroll to the blocked binary message → "Allow Anyway".`);
+            default:
+                return new AudioMcpError("AUDIO_DEVICE_ERROR", `audio-capture-helper exited with code ${code}. ${stderrMsg}`);
+        }
+    }
+    extractStderrMessage() {
+        const lines = this.stderrBuf.trim().split("\n").filter(Boolean);
+        for (let i = lines.length - 1; i >= 0; i--) {
+            try {
+                const parsed = JSON.parse(lines[i]);
+                if (parsed.level === "error" && parsed.msg) {
+                    return parsed.msg;
+                }
+            }
+            catch {
+                /* not JSON */
+            }
+        }
+        return lines.length ? lines[lines.length - 1] : "";
+    }
+}
+//# sourceMappingURL=helper-capture.js.map

package/dist/audio/helper-capture.js.map

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

package/dist/audio/helper-path.d.ts

@@ -0,0 +1,10 @@
+export declare const HELPER_BIN: string;
+export declare class HelperBinaryError extends Error {
+    readonly reason: "missing" | "not_executable" | "gatekeeper" | "other";
+    constructor(message: string, reason: "missing" | "not_executable" | "gatekeeper" | "other");
+}
+/**
+ * Verify the helper binary is present and executable. Returns a structured
+ * error identifying which remediation the user should take.
+ */
+export declare function verifyHelper(): HelperBinaryError | null;

package/dist/audio/helper-path.js

@@ -0,0 +1,47 @@
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { existsSync, accessSync, constants as fsConstants } from "node:fs";
+/**
+ * Absolute path to the bundled audio-capture-helper binary. Resolves based
+ * on this module's compiled location: `dist/audio/helper-path.js` → `dist/bin/audio-capture-helper`.
+ * During development (when running TypeScript source directly), it falls
+ * back to `dist/bin/...` relative to the repo root.
+ */
+function resolveHelperPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    // Compiled: dist/audio/helper-path.js → ../bin/audio-capture-helper
+    const compiled = join(here, "..", "bin", "audio-capture-helper");
+    if (existsSync(compiled))
+        return compiled;
+    // Dev fallback: <repo>/src/audio/helper-path.ts → <repo>/dist/bin/audio-capture-helper
+    const dev = join(here, "..", "..", "dist", "bin", "audio-capture-helper");
+    return dev;
+}
+export const HELPER_BIN = resolveHelperPath();
+export class HelperBinaryError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = "HelperBinaryError";
+    }
+}
+/**
+ * Verify the helper binary is present and executable. Returns a structured
+ * error identifying which remediation the user should take.
+ */
+export function verifyHelper() {
+    if (!existsSync(HELPER_BIN)) {
+        return new HelperBinaryError(`audio-capture-helper not found at ${HELPER_BIN}. ` +
+            `Reinstall audio-mcp or run 'npm run build:helper' from source.`, "missing");
+    }
+    try {
+        accessSync(HELPER_BIN, fsConstants.X_OK);
+    }
+    catch {
+        return new HelperBinaryError(`audio-capture-helper is not executable at ${HELPER_BIN}. ` +
+            `Run 'chmod +x ${HELPER_BIN}' and try again.`, "not_executable");
+    }
+    return null;
+}
+//# sourceMappingURL=helper-path.js.map

package/dist/audio/helper-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-path.js","sourceRoot":"","sources":["../../src/audio/helper-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;GAKG;AACH,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,oEAAoE;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,sBAAsB,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,uFAAuF;IACvF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,CAAC,CAAC;IAC1E,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAE9C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAGxB;IAFlB,YACE,OAAe,EACC,MAA6D;QAE7E,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAuD;QAG7E,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,iBAAiB,CAC1B,qCAAqC,UAAU,IAAI;YACjD,gEAAgE,EAClE,SAAS,CACV,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,UAAU,CAAC,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,iBAAiB,CAC1B,6CAA6C,UAAU,IAAI;YACzD,iBAAiB,UAAU,kBAAkB,EAC/C,gBAAgB,CACjB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/audio/wav.d.ts

@@ -0,0 +1,52 @@
+export interface WavFormat {
+    sampleRate: number;
+    channels: number;
+}
+/** Build a 44-byte PCM WAV header. `dataSize` is the byte length of PCM data. */
+export declare function buildWavHeader({ sampleRate, channels }: WavFormat, dataSize: number): Buffer;
+/**
+ * Streaming WAV writer. Writes a zero-sized header up front, appends PCM
+ * chunks as they arrive, then patches the header sizes on `finalize()`.
+ * Audio data is never buffered entirely in memory.
+ */
+export declare class WavWriter {
+    private readonly path;
+    private readonly format;
+    private stream;
+    private bytesWritten;
+    private closed;
+    constructor(path: string, format: WavFormat);
+    /** Append a PCM chunk. Returns once the chunk is flushed to the OS. */
+    append(chunk: Buffer): Promise<void>;
+    /** Close the stream and rewrite the RIFF/data sizes in the header. */
+    finalize(): Promise<{
+        bytesWritten: number;
+        durationSeconds: number;
+    }>;
+    get byteCount(): number;
+}
+export interface WavSlice {
+    audio: Buffer;
+    startSecond: number;
+    endSecond: number;
+    durationSeconds: number;
+    sampleRate: number;
+    channels: number;
+    byteLength: number;
+}
+/**
+ * Read the PCM-format fields from a WAV file header. Throws if the file is
+ * not a PCM WAV (format 1) with a well-formed RIFF/data structure.
+ */
+export declare function readWavFormat(path: string): {
+    sampleRate: number;
+    channels: number;
+    bitsPerSample: number;
+    dataSize: number;
+};
+/**
+ * Read `[startSecond, endSecond)` from a PCM WAV and return a new
+ * self-contained WAV buffer wrapping just the requested slice. Clamps
+ * `endSecond` to the file's total duration.
+ */
+export declare function sliceWav(path: string, startSecond: number, endSecond: number): WavSlice;

package/dist/audio/wav.js

@@ -0,0 +1,174 @@
+import { createWriteStream, promises as fsp, openSync, readSync, closeSync, statSync, } from "node:fs";
+const HEADER_SIZE = 44;
+const BITS_PER_SAMPLE = 16;
+const BYTES_PER_SAMPLE = BITS_PER_SAMPLE / 8;
+const PCM_FORMAT = 1;
+/** Build a 44-byte PCM WAV header. `dataSize` is the byte length of PCM data. */
+export function buildWavHeader({ sampleRate, channels }, dataSize) {
+    const buf = Buffer.alloc(HEADER_SIZE);
+    const byteRate = sampleRate * channels * BYTES_PER_SAMPLE;
+    const blockAlign = channels * BYTES_PER_SAMPLE;
+    buf.write("RIFF", 0, "ascii");
+    buf.writeUInt32LE(36 + dataSize, 4); // RIFF chunk size
+    buf.write("WAVE", 8, "ascii");
+    buf.write("fmt ", 12, "ascii");
+    buf.writeUInt32LE(16, 16); // fmt chunk size
+    buf.writeUInt16LE(PCM_FORMAT, 20);
+    buf.writeUInt16LE(channels, 22);
+    buf.writeUInt32LE(sampleRate, 24);
+    buf.writeUInt32LE(byteRate, 28);
+    buf.writeUInt16LE(blockAlign, 32);
+    buf.writeUInt16LE(BITS_PER_SAMPLE, 34);
+    buf.write("data", 36, "ascii");
+    buf.writeUInt32LE(dataSize, 40);
+    return buf;
+}
+/**
+ * Streaming WAV writer. Writes a zero-sized header up front, appends PCM
+ * chunks as they arrive, then patches the header sizes on `finalize()`.
+ * Audio data is never buffered entirely in memory.
+ */
+export class WavWriter {
+    path;
+    format;
+    stream;
+    bytesWritten = 0;
+    closed = false;
+    constructor(path, format) {
+        this.path = path;
+        this.format = format;
+        this.stream = createWriteStream(path);
+        this.stream.write(buildWavHeader(format, 0));
+    }
+    /** Append a PCM chunk. Returns once the chunk is flushed to the OS. */
+    append(chunk) {
+        if (this.closed)
+            return Promise.reject(new Error("WavWriter already finalized"));
+        return new Promise((resolve, reject) => {
+            this.stream.write(chunk, (err) => {
+                if (err)
+                    reject(err);
+                else {
+                    this.bytesWritten += chunk.length;
+                    resolve();
+                }
+            });
+        });
+    }
+    /** Close the stream and rewrite the RIFF/data sizes in the header. */
+    async finalize() {
+        if (this.closed) {
+            throw new Error("WavWriter already finalized");
+        }
+        this.closed = true;
+        await new Promise((resolve, reject) => {
+            this.stream.end((err) => (err ? reject(err) : resolve()));
+        });
+        const fh = await fsp.open(this.path, "r+");
+        try {
+            const riffSize = Buffer.alloc(4);
+            riffSize.writeUInt32LE(36 + this.bytesWritten, 0);
+            await fh.write(riffSize, 0, 4, 4);
+            const dataSize = Buffer.alloc(4);
+            dataSize.writeUInt32LE(this.bytesWritten, 0);
+            await fh.write(dataSize, 0, 4, 40);
+        }
+        finally {
+            await fh.close();
+        }
+        const durationSeconds = this.bytesWritten / (this.format.sampleRate * this.format.channels * BYTES_PER_SAMPLE);
+        return { bytesWritten: this.bytesWritten, durationSeconds };
+    }
+    get byteCount() {
+        return this.bytesWritten;
+    }
+}
+/**
+ * Read the PCM-format fields from a WAV file header. Throws if the file is
+ * not a PCM WAV (format 1) with a well-formed RIFF/data structure.
+ */
+export function readWavFormat(path) {
+    const fd = openSync(path, "r");
+    try {
+        const buf = Buffer.alloc(HEADER_SIZE);
+        readSync(fd, buf, 0, HEADER_SIZE, 0);
+        if (buf.toString("ascii", 0, 4) !== "RIFF" || buf.toString("ascii", 8, 12) !== "WAVE") {
+            throw new Error("Not a RIFF/WAVE file");
+        }
+        const audioFormat = buf.readUInt16LE(20);
+        if (audioFormat !== PCM_FORMAT) {
+            throw new Error(`Unsupported WAV format: ${audioFormat} (only PCM is supported)`);
+        }
+        return {
+            channels: buf.readUInt16LE(22),
+            sampleRate: buf.readUInt32LE(24),
+            bitsPerSample: buf.readUInt16LE(34),
+            dataSize: buf.readUInt32LE(40),
+        };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/**
+ * Read `[startSecond, endSecond)` from a PCM WAV and return a new
+ * self-contained WAV buffer wrapping just the requested slice. Clamps
+ * `endSecond` to the file's total duration.
+ */
+export function sliceWav(path, startSecond, endSecond) {
+    if (startSecond < 0) {
+        throw new Error("startSecond must be >= 0");
+    }
+    if (endSecond <= startSecond) {
+        throw new Error("endSecond must be > startSecond");
+    }
+    const fmt = readWavFormat(path);
+    const bytesPerSec = fmt.sampleRate * fmt.channels * (fmt.bitsPerSample / 8);
+    const fileSize = statSync(path).size;
+    // During an active recording the header's dataSize is still 0 — the
+    // WavWriter patches it only on finalize(). Fall back to the live file
+    // size so callers can read partial audio mid-session.
+    const availableDataBytes = fmt.dataSize > 0
+        ? Math.min(fmt.dataSize, fileSize - HEADER_SIZE)
+        : Math.max(0, fileSize - HEADER_SIZE);
+    const totalSeconds = availableDataBytes / bytesPerSec;
+    const clampedEnd = Math.min(endSecond, totalSeconds);
+    if (clampedEnd <= startSecond) {
+        // Range is entirely past end of file — return empty slice.
+        return {
+            audio: buildWavHeader({ sampleRate: fmt.sampleRate, channels: fmt.channels }, 0),
+            startSecond,
+            endSecond: startSecond,
+            durationSeconds: 0,
+            sampleRate: fmt.sampleRate,
+            channels: fmt.channels,
+            byteLength: HEADER_SIZE,
+        };
+    }
+    // Align offsets to sample frame boundary.
+    const frameSize = fmt.channels * (fmt.bitsPerSample / 8);
+    const alignToFrame = (bytes) => Math.floor(bytes / frameSize) * frameSize;
+    const startByte = alignToFrame(Math.floor(startSecond * bytesPerSec));
+    const endByte = alignToFrame(Math.floor(clampedEnd * bytesPerSec));
+    const sliceBytes = endByte - startByte;
+    const fd = openSync(path, "r");
+    try {
+        const pcm = Buffer.alloc(sliceBytes);
+        readSync(fd, pcm, 0, sliceBytes, HEADER_SIZE + startByte);
+        const header = buildWavHeader({ sampleRate: fmt.sampleRate, channels: fmt.channels }, sliceBytes);
+        const audio = Buffer.concat([header, pcm]);
+        return {
+            audio,
+            startSecond,
+            endSecond: clampedEnd,
+            durationSeconds: sliceBytes / bytesPerSec,
+            sampleRate: fmt.sampleRate,
+            channels: fmt.channels,
+            byteLength: audio.length,
+        };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+//# sourceMappingURL=wav.js.map

package/dist/audio/wav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wav.js","sourceRoot":"","sources":["../../src/audio/wav.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAEjB,QAAQ,IAAI,GAAG,EACf,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,gBAAgB,GAAG,eAAe,GAAG,CAAC,CAAC;AAC7C,MAAM,UAAU,GAAG,CAAC,CAAC;AAOrB,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAC5B,EAAE,UAAU,EAAE,QAAQ,EAAa,EACnC,QAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC1D,MAAM,UAAU,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAE/C,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,CAAC,aAAa,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB;IACvD,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB;IAC5C,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChC,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChC,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,aAAa,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACvC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,SAAS;IAMD;IACA;IANX,MAAM,CAAc;IACpB,YAAY,GAAG,CAAC,CAAC;IACjB,MAAM,GAAG,KAAK,CAAC;IAEvB,YACmB,IAAY,EACZ,MAAiB;QADjB,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAW;QAElC,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,KAAa;QAClB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACjF,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC/B,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;qBAChB,CAAC;oBACJ,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;oBAClC,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAkB,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;YAClD,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;YAC7C,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QAED,MAAM,eAAe,GACnB,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,gBAAgB,CAAC,CAAC;QACzF,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF;AAYD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IAMxC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,0BAA0B,CAAC,CAAC;QACpF,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,aAAa,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;SAC/B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,WAAmB,EAAE,SAAiB;IAC3E,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,WAAW,GAAG,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IACrC,oEAAoE;IACpE,sEAAsE;IACtE,sDAAsD;IACtD,MAAM,kBAAkB,GACtB,GAAG,CAAC,QAAQ,GAAG,CAAC;QACd,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,kBAAkB,GAAG,WAAW,CAAC;IAEtD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,UAAU,IAAI,WAAW,EAAE,CAAC;QAC9B,2DAA2D;QAC3D,OAAO;YACL,KAAK,EAAE,cAAc,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChF,WAAW;YACX,SAAS,EAAE,WAAW;YACtB,eAAe,EAAE,CAAC;YAClB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,WAAW;SACxB,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC1F,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;IAEvC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,cAAc,CAC3B,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EACtD,UAAU,CACX,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,OAAO;YACL,KAAK;YACL,WAAW;YACX,SAAS,EAAE,UAAU;YACrB,eAAe,EAAE,UAAU,GAAG,WAAW;YACzC,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,KAAK,CAAC,MAAM;SACzB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+import type { Paths } from "./paths.js";
+import type { CaptureMode } from "./audio/capture.js";
+export interface AudioMcpConfig {
+    default_source: string | null;
+    default_capture_mode: CaptureMode;
+    sample_rate: number;
+    sessions_dir: string | null;
+}
+export declare const DEFAULT_CONFIG: AudioMcpConfig;
+/**
+ * Load config from disk, creating the file with defaults if missing.
+ * Unknown keys are preserved on rewrite. Missing keys fall back to defaults.
+ */
+export declare function loadOrCreateConfig(paths: Paths): AudioMcpConfig;

package/dist/config.js

@@ -0,0 +1,27 @@
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+export const DEFAULT_CONFIG = {
+    default_source: null,
+    default_capture_mode: "both",
+    sample_rate: 16000,
+    sessions_dir: null,
+};
+/**
+ * Load config from disk, creating the file with defaults if missing.
+ * Unknown keys are preserved on rewrite. Missing keys fall back to defaults.
+ */
+export function loadOrCreateConfig(paths) {
+    if (!existsSync(paths.configFile)) {
+        writeFileSync(paths.configFile, JSON.stringify(DEFAULT_CONFIG, null, 2) + "\n", "utf8");
+        return { ...DEFAULT_CONFIG };
+    }
+    try {
+        const raw = readFileSync(paths.configFile, "utf8");
+        const parsed = JSON.parse(raw);
+        return { ...DEFAULT_CONFIG, ...parsed };
+    }
+    catch {
+        // Malformed config — fall back to defaults without overwriting user's file.
+        return { ...DEFAULT_CONFIG };
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAYlE,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,MAAM;IAC5B,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACxF,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+export declare const ErrorCode: {
+    readonly SESSION_ALREADY_ACTIVE: "SESSION_ALREADY_ACTIVE";
+    readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+    readonly SESSION_STILL_ACTIVE: "SESSION_STILL_ACTIVE";
+    readonly AUDIO_DEVICE_ERROR: "AUDIO_DEVICE_ERROR";
+    readonly CHUNK_TOO_LARGE: "CHUNK_TOO_LARGE";
+    readonly NOT_IMPLEMENTED: "NOT_IMPLEMENTED";
+    readonly INVALID_INPUT: "INVALID_INPUT";
+};
+export type ErrorCodeName = keyof typeof ErrorCode;
+export declare class AudioMcpError extends Error {
+    readonly code: ErrorCodeName;
+    constructor(code: ErrorCodeName, message: string);
+    toJSON(): {
+        code: ErrorCodeName;
+        message: string;
+    };
+}

package/dist/errors.js

@@ -0,0 +1,21 @@
+export const ErrorCode = {
+    SESSION_ALREADY_ACTIVE: "SESSION_ALREADY_ACTIVE",
+    SESSION_NOT_FOUND: "SESSION_NOT_FOUND",
+    SESSION_STILL_ACTIVE: "SESSION_STILL_ACTIVE",
+    AUDIO_DEVICE_ERROR: "AUDIO_DEVICE_ERROR",
+    CHUNK_TOO_LARGE: "CHUNK_TOO_LARGE",
+    NOT_IMPLEMENTED: "NOT_IMPLEMENTED",
+    INVALID_INPUT: "INVALID_INPUT",
+};
+export class AudioMcpError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "AudioMcpError";
+        this.code = code;
+    }
+    toJSON() {
+        return { code: this.code, message: this.message };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,sBAAsB,EAAE,wBAAwB;IAChD,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;CACtB,CAAC;AAIX,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtB,IAAI,CAAgB;IAEpC,YAAY,IAAmB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACpD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { startServer } from "./server.js";
+startServer().catch((err) => {
+    // Log to stderr so it is visible in the MCP client's server log pane.
+    // stdout is reserved for the JSON-RPC transport.
+    // eslint-disable-next-line no-console
+    console.error("audio-mcp fatal:", err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC1B,sEAAsE;IACtE,iDAAiD;IACjD,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,14 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface Logger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * File-backed logger. Writes JSON-per-line to `filePath`, rolling when the
+ * file grows past 10 MB (rotates to `<filePath>.1`, overwriting any prior).
+ * Writes are synchronous to guarantee ordering under SIGINT without leaking
+ * into MCP's stdio stream.
+ */
+export declare function createFileLogger(filePath: string): Logger;

package/dist/logger.js

@@ -0,0 +1,34 @@
+import { appendFileSync, existsSync, renameSync, statSync } from "node:fs";
+const MAX_LOG_BYTES = 10 * 1024 * 1024; // 10 MB
+/**
+ * File-backed logger. Writes JSON-per-line to `filePath`, rolling when the
+ * file grows past 10 MB (rotates to `<filePath>.1`, overwriting any prior).
+ * Writes are synchronous to guarantee ordering under SIGINT without leaking
+ * into MCP's stdio stream.
+ */
+export function createFileLogger(filePath) {
+    const write = (level, msg, meta) => {
+        try {
+            if (existsSync(filePath) && statSync(filePath).size > MAX_LOG_BYTES) {
+                renameSync(filePath, `${filePath}.1`);
+            }
+            const entry = JSON.stringify({
+                ts: new Date().toISOString(),
+                level,
+                msg,
+                ...(meta ?? {}),
+            });
+            appendFileSync(filePath, entry + "\n", "utf8");
+        }
+        catch {
+            // Never let logging failures propagate.
+        }
+    };
+    return {
+        debug: (msg, meta) => write("debug", msg, meta),
+        info: (msg, meta) => write("info", msg, meta),
+        warn: (msg, meta) => write("warn", msg, meta),
+        error: (msg, meta) => write("error", msg, meta),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE3E,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAWhD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,CAAC,KAAe,EAAE,GAAW,EAAE,IAA8B,EAAQ,EAAE;QACnF,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;gBACpE,UAAU,CAAC,QAAQ,EAAE,GAAG,QAAQ,IAAI,CAAC,CAAC;YACxC,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC3B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,KAAK;gBACL,GAAG;gBACH,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;aAChB,CAAC,CAAC;YACH,cAAc,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC/C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;KAChD,CAAC;AACJ,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,15 @@
+export interface Paths {
+    root: string;
+    sessionsDir: string;
+    configFile: string;
+    logFile: string;
+}
+/** Expand a leading `~` in a path to the user's home directory. */
+export declare function expandHome(p: string): string;
+/**
+ * Resolve audio-mcp storage paths. By default rooted at `~/.audio-mcp`.
+ * A custom root can be supplied (used by tests to isolate storage in a tmp dir).
+ */
+export declare function resolvePaths(root?: string, sessionsDirOverride?: string): Paths;
+/** Ensure the root and sessions directories exist. Idempotent. */
+export declare function ensureDirs(paths: Paths): void;