talkback-mcp 0.1.0

package/dist/mcp-server.js

@@ -0,0 +1,437 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { assembleContext } from "./context-assembler.js";
+import { getPluginLibrary } from "./plugin-library.js";
+import { runHeuristics } from "./heuristics/index.js";
+import { formatSpectralSummary } from "./spectral.js";
+import { humanToRaw } from "./param-maps/index.js";
+// ============================================================
+// System prompt — prepended to session context responses
+// ============================================================
+const SYSTEM_PROMPT = `You are an experienced mixing and mastering engineer working alongside a music producer in their Ableton Live session. You have real-time access to their session via Talkback MCP tools.
+
+The Talkback Bridge is a Max for Live Audio Effect device already installed in the producer's session. It connects to this MCP server via WebSocket. You do NOT need to guide setup — if you can read session data, the bridge is working.
+
+Guidelines:
+
+SESSION AWARENESS
+1. Call get_session_context once to orient yourself. Only call again if the user says the session has changed.
+2. Do NOT call analyze_mix on every message. Only when the user explicitly asks for mix feedback or describes a problem.
+
+EMPTY TRACKS & NORMAL VARIANCE
+3. Empty tracks, unused sends, tracks at 0dB, hard-panned pairs — all normal production choices, never flag as issues. The only time an empty track matters is if it has active devices AND non-zero output meters (e.g., a vinyl emulation plugin generating noise on a track the producer thinks is silent). Never suggest cleaning up or deleting empty tracks.
+4. Sessions vary wildly between producers. Do not assume any track layout, gain structure, or routing pattern is wrong.
+
+NO OBJECTIVE "GOOD MIX"
+5. A mix is not objectively good or bad. There is no benchmark to optimize toward. When a user says "make it better" or "improve the mix," ask what they mean — louder? cleaner? drums hit harder while vocals stay present? more space? more aggression? The goal is to help the producer overcome technical limitations to achieve THEIR artistic vision, not a textbook standard.
+6. A "technically rough" mix may be exactly right for the song's emotional intent. Respect that. Never assume a non-standard setting is a mistake.
+
+PARAMETER CHANGES REQUIRE CONSENT
+7. NEVER change a parameter without explicit user approval. Before any write operation, present the full plan: track name, device name, parameter name, current value → proposed value, and why. Wait for a clear "yes." If the user modifies the plan, re-present the updated changes and confirm again before executing. Never batch-execute changes without per-change approval.
+
+FREQUENCY ANALYSIS
+8. Your primary frequency insight comes from reading device parameters — EQ curves, filter cutoffs, compressor settings, device chains. Use get_track_details to read these. This works without playback and covers most mixing advice.
+9. Spectral analysis (get_spectral_snapshot) is a secondary verification tool. It captures ~2 seconds of live audio from the master bus at the moment of capture. Transport must be playing. Use it only to confirm suspicions or detect issues invisible in device parameters (masking between tracks, phase cancellation, unexpected resonances). It is a microscope on a moment, not a full-song analyzer.
+
+COMMUNICATION
+10. Be specific — reference exact track names, device names, parameter values, and suggested values.
+11. When suggesting devices, prefer plugins already in the session, then plugins the producer owns (use get_plugin_library). Don't suggest plugins without checking availability.
+12. Speak like a knowledgeable colleague, not a textbook. Be direct and conversational. Prioritize by impact — lead with the highest-leverage suggestion.
+13. When the producer describes a subjective problem ("muddy", "harsh", "thin"), use get_track_details to read device parameters on the relevant tracks BEFORE reaching for analyze_mix or spectral.
+14. If session data is unavailable, simply say the bridge isn't connected. Do NOT fabricate setup instructions, GitHub URLs, or troubleshooting steps.`;
+// ============================================================
+// MCP server setup
+// ============================================================
+export function createMcpServer(bridge) {
+    const server = new McpServer({
+        name: "talkback-mcp",
+        version: "0.1.0",
+    });
+    // ----------------------------------------------------------
+    // Tool: get_session_context
+    // ----------------------------------------------------------
+    server.tool("get_session_context", "Returns a snapshot of the current Ableton session: all tracks (names, volumes, panning, mutes, sends, device chains), return tracks, master track, and routing. Call once at the start of a conversation to orient yourself. No need to call again unless the user says the session has changed.", {}, async () => {
+        const context = assembleContext(bridge.cache);
+        if (!context) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No session data available. Is the Talkback Bridge device loaded in Ableton and is the WebSocket connection active?",
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                { type: "text", text: SYSTEM_PROMPT },
+                { type: "text", text: JSON.stringify(context, null, 2) },
+            ],
+        };
+    });
+    // ----------------------------------------------------------
+    // Tool: get_track_details
+    // ----------------------------------------------------------
+    server.tool("get_track_details", "Returns full detail for a specific track including all devices, every parameter in human-readable units, and per-device observations.", { track_name: z.string().describe("Track name (case-insensitive match)") }, async ({ track_name }) => {
+        const context = assembleContext(bridge.cache);
+        if (!context) {
+            return {
+                content: [{ type: "text", text: "No session data available." }],
+            };
+        }
+        const lower = track_name.toLowerCase();
+        const allTracks = [
+            ...context.tracks,
+            ...context.returnTracks,
+            context.masterTrack,
+        ];
+        const track = allTracks.find((t) => t.name.toLowerCase() === lower);
+        if (!track) {
+            const names = allTracks.map((t) => t.name).join(", ");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Track "${track_name}" not found. Available tracks: ${names}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(track, null, 2) },
+            ],
+        };
+    });
+    // ----------------------------------------------------------
+    // Tool: get_spectral_snapshot
+    // ----------------------------------------------------------
+    server.tool("get_spectral_snapshot", "Captures ~2 seconds of live audio from the master bus and returns peak/RMS levels across frequency bands. Transport MUST be playing — coordinate with the user on which section to analyze (e.g., 'play the chorus'). This is a point-in-time microscope, not a full-song analyzer. Use as a secondary check to verify what device parameter analysis suggests, or to detect issues invisible in the device chain (masking, phase, resonances). For most frequency questions, reading EQ and filter parameters via get_track_details is more informative.", {
+        source: z
+            .string()
+            .default("master")
+            .describe("'master' for master bus, or a track name"),
+    }, async ({ source }) => {
+        try {
+            const snapshot = await bridge.requestSpectral(source);
+            const summary = formatSpectralSummary(snapshot);
+            return {
+                content: [
+                    { type: "text", text: summary },
+                    { type: "text", text: JSON.stringify(snapshot, null, 2) },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Spectral analysis unavailable: ${message}`,
+                    },
+                ],
+            };
+        }
+    });
+    // ----------------------------------------------------------
+    // Tool: get_plugin_library
+    // ----------------------------------------------------------
+    server.tool("get_plugin_library", "Returns all audio plugins (AU, VST3) installed on this system. Use to know what tools the producer has available.", {
+        filter: z
+            .string()
+            .optional()
+            .describe("Optional search string to filter by plugin name"),
+    }, async ({ filter }) => {
+        const plugins = await getPluginLibrary(filter);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${plugins.length} plugins found${filter ? ` matching "${filter}"` : ""}:\n${JSON.stringify(plugins, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // ----------------------------------------------------------
+    // Tool: analyze_mix
+    // ----------------------------------------------------------
+    server.tool("analyze_mix", "Runs rule-based heuristic analysis for potential mix issues: frequency buildup, dynamics problems, routing inefficiencies, headroom. Only call when the user explicitly asks for mix feedback or describes a specific problem — do NOT call proactively. Findings are suggestions to consider, not problems to fix. Mix quality is subjective — frame results in context of what the user is trying to achieve. A technically 'imperfect' setting may be an intentional artistic choice.", {}, async () => {
+        const context = assembleContext(bridge.cache);
+        if (!context) {
+            return {
+                content: [{ type: "text", text: "No session data available." }],
+            };
+        }
+        const findings = runHeuristics(context);
+        if (findings.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No issues detected by automated analysis. This doesn't mean the mix is perfect — it means no common problems were flagged. Describe what you're hearing and I can dig deeper.",
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(findings, null, 2),
+                },
+            ],
+        };
+    });
+    // ----------------------------------------------------------
+    // Tool: set_device_parameter
+    // ----------------------------------------------------------
+    server.tool("set_device_parameter", "Sets a device parameter to a new value. Pass values in human-readable units (dB, ms, Hz, ratio, percent). NEVER call without explicit user approval. Present the planned change with current → proposed values first, wait for a clear 'yes', then execute. If the user modifies the plan, re-present and re-confirm before executing.", {
+        track_name: z.string(),
+        device_name: z.string(),
+        parameter_name: z.string(),
+        value: z.number(),
+        unit: z.enum(["dB", "ms", "Hz", "ratio", "percent"]),
+    }, async ({ track_name, device_name, parameter_name, value, unit }) => {
+        if (!bridge.cache.raw) {
+            return {
+                content: [{ type: "text", text: "No session data available." }],
+            };
+        }
+        // Find the track and device in raw cache to get device className
+        const allTracks = [
+            ...bridge.cache.raw.tracks,
+            ...bridge.cache.raw.returnTracks,
+            bridge.cache.raw.masterTrack,
+        ];
+        const lower = track_name.toLowerCase();
+        const track = allTracks.find((t) => t.name.toLowerCase() === lower);
+        if (!track) {
+            return {
+                content: [
+                    { type: "text", text: `Track "${track_name}" not found.` },
+                ],
+            };
+        }
+        const device = track.devices.find((d) => d.name.toLowerCase() === device_name.toLowerCase());
+        if (!device) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Device "${device_name}" not found on track "${track_name}".`,
+                    },
+                ],
+            };
+        }
+        // Convert human value to raw
+        let rawValue = humanToRaw(device.className, parameter_name, value, unit);
+        if (rawValue === null) {
+            // Fallback: assume 0-100 percent mapping
+            rawValue = unit === "percent" ? value / 100 : value;
+        }
+        // Clamp to 0-1
+        rawValue = Math.max(0, Math.min(1, rawValue));
+        const sent = bridge.sendCommand({
+            type: "set_parameter",
+            trackId: track.id,
+            deviceId: device.id,
+            parameterName: parameter_name,
+            value: rawValue,
+        });
+        if (!sent) {
+            return {
+                content: [
+                    { type: "text", text: "Failed to send command — M4L bridge not connected." },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Set ${track_name} → ${device_name} → ${parameter_name} to ${value}${unit} (raw: ${rawValue.toFixed(4)})`,
+                },
+            ],
+        };
+    });
+    // ----------------------------------------------------------
+    // Tool: toggle_device_bypass
+    // ----------------------------------------------------------
+    server.tool("toggle_device_bypass", "Enables or bypasses a device on a track. Useful for A/B comparison. Always confirm with the user before toggling.", {
+        track_name: z.string(),
+        device_name: z.string(),
+        active: z.boolean().describe("true = device on, false = bypassed"),
+    }, async ({ track_name, device_name, active }) => {
+        if (!bridge.cache.raw) {
+            return {
+                content: [{ type: "text", text: "No session data available." }],
+            };
+        }
+        const allTracks = [
+            ...bridge.cache.raw.tracks,
+            ...bridge.cache.raw.returnTracks,
+            bridge.cache.raw.masterTrack,
+        ];
+        const track = allTracks.find((t) => t.name.toLowerCase() === track_name.toLowerCase());
+        if (!track) {
+            return {
+                content: [{ type: "text", text: `Track "${track_name}" not found.` }],
+            };
+        }
+        const device = track.devices.find((d) => d.name.toLowerCase() === device_name.toLowerCase());
+        if (!device) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Device "${device_name}" not found on track "${track_name}".`,
+                    },
+                ],
+            };
+        }
+        const sent = bridge.sendCommand({
+            type: "set_device_active",
+            trackId: track.id,
+            deviceId: device.id,
+            isActive: active,
+        });
+        if (!sent) {
+            return {
+                content: [
+                    { type: "text", text: "Failed — M4L bridge not connected." },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${device_name} on ${track_name} is now ${active ? "enabled" : "bypassed"}.`,
+                },
+            ],
+        };
+    });
+    // ----------------------------------------------------------
+    // Tool: create_group_track
+    // ----------------------------------------------------------
+    server.tool("create_group_track", "Creates a new group track containing the specified tracks. Always confirm with the producer first.", {
+        track_names: z.array(z.string()).describe("Names of tracks to group"),
+        group_name: z.string().describe("Name for the new group track"),
+    }, async ({ track_names, group_name }) => {
+        if (!bridge.cache.raw) {
+            return {
+                content: [{ type: "text", text: "No session data available." }],
+            };
+        }
+        const trackIds = [];
+        const notFound = [];
+        for (const name of track_names) {
+            const track = bridge.cache.raw.tracks.find((t) => t.name.toLowerCase() === name.toLowerCase());
+            if (track) {
+                trackIds.push(track.id);
+            }
+            else {
+                notFound.push(name);
+            }
+        }
+        if (notFound.length > 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Could not find tracks: ${notFound.join(", ")}`,
+                    },
+                ],
+            };
+        }
+        const sent = bridge.sendCommand({
+            type: "create_group",
+            trackIds,
+            groupName: group_name,
+        });
+        if (!sent) {
+            return {
+                content: [
+                    { type: "text", text: "Failed — M4L bridge not connected." },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Creating group "${group_name}" with tracks: ${track_names.join(", ")}`,
+                },
+            ],
+        };
+    });
+    // ----------------------------------------------------------
+    // Tool: set_track_routing
+    // ----------------------------------------------------------
+    server.tool("set_track_routing", "Changes a track's output routing. Always confirm with the producer first.", {
+        track_name: z.string(),
+        output_target: z.string().describe("Name of the target track/group/bus"),
+    }, async ({ track_name, output_target }) => {
+        if (!bridge.cache.raw) {
+            return {
+                content: [{ type: "text", text: "No session data available." }],
+            };
+        }
+        const track = bridge.cache.raw.tracks.find((t) => t.name.toLowerCase() === track_name.toLowerCase());
+        if (!track) {
+            return {
+                content: [{ type: "text", text: `Track "${track_name}" not found.` }],
+            };
+        }
+        const sent = bridge.sendCommand({
+            type: "set_routing",
+            trackId: track.id,
+            outputTarget: output_target,
+        });
+        if (!sent) {
+            return {
+                content: [
+                    { type: "text", text: "Failed — M4L bridge not connected." },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Routing ${track_name} output to ${output_target}.`,
+                },
+            ],
+        };
+    });
+    // ----------------------------------------------------------
+    // Tool: get_bridge_health
+    // ----------------------------------------------------------
+    server.tool("get_bridge_health", "Returns performance metrics from the M4L bridge device: poll execution time (avg/max), WebSocket message size, LiveAPI cache size, and track count. Use to diagnose performance issues or confirm the device is running efficiently.", {}, async () => {
+        if (!bridge.cache.isConnected) {
+            return {
+                content: [{ type: "text", text: "M4L bridge not connected." }],
+            };
+        }
+        const p = bridge.perf;
+        const snapshotKb = (p.snapshotBytes / 1024).toFixed(1);
+        const lines = [
+            `Poll time: ${p.lastPollMs}ms (avg ${p.avgPollMs}ms, max ${p.maxPollMs}ms over ${p.pollCount} polls)`,
+            `Snapshot size: ${snapshotKb}KB (${p.snapshotBytes} bytes)`,
+            `Tracks in snapshot: ${p.trackCount}`,
+            `LiveAPI cache: ${p.apiCacheSize} objects`,
+            `Last poll was structure refresh: ${p.lastStructureRefresh}`,
+            ``,
+            `Benchmarks:`,
+            `  Poll time < 50ms = excellent, 50-200ms = acceptable, >200ms = needs work`,
+            `  Snapshot < 30KB = good, 30-100KB = fine at 10s intervals, >100KB = large`,
+            `  Cache should stabilize after first few polls — growth = potential leak`,
+        ];
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/param-maps/compressor.d.ts

@@ -0,0 +1,3 @@
+import type { ParamMap } from "./index.js";
+export declare const compressorMap: ParamMap;
+//# sourceMappingURL=compressor.d.ts.map

package/dist/param-maps/compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor.d.ts","sourceRoot":"","sources":["../../src/param-maps/compressor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,aAAa,EAAE,QA+C3B,CAAC"}

package/dist/param-maps/compressor.js

@@ -0,0 +1,51 @@
+export const compressorMap = {
+    deviceClassName: "Compressor",
+    parameters: {
+        Threshold: {
+            unit: "dB",
+            toHuman: (raw) => `${Math.round(-36 + raw * 36)}dB`,
+            fromHuman: (value) => (value + 36) / 36,
+            observe: (raw, human) => {
+                if (raw > 0.83)
+                    return `High threshold (${human}) — compressor rarely triggering`;
+                return null;
+            },
+        },
+        Ratio: {
+            unit: ":1",
+            toHuman: (raw) => raw >= 0.99 ? "inf:1 (limiting)" : `${(1 + raw * 63).toFixed(1)}:1`,
+            fromHuman: (value) => (value - 1) / 63,
+            observe: (raw, human) => {
+                if (raw > 0.14)
+                    return `High ratio (${human}) — behaving more like a limiter`;
+                return null;
+            },
+        },
+        Attack: {
+            unit: "ms",
+            toHuman: (raw) => `${(raw * 200).toFixed(1)}ms`,
+            fromHuman: (value) => value / 200,
+            observe: (raw, human) => {
+                if (raw > 0.25)
+                    return `Slow attack (${human}) — transients passing through uncompressed`;
+                return null;
+            },
+        },
+        Release: {
+            unit: "ms",
+            toHuman: (raw) => `${(raw * 1190 + 10).toFixed(0)}ms`,
+            fromHuman: (value) => (value - 10) / 1190,
+        },
+        Makeup: {
+            unit: "dB",
+            toHuman: (raw) => `+${(raw * 24).toFixed(1)}dB`,
+            fromHuman: (value) => value / 24,
+        },
+        "Dry/Wet": {
+            unit: "%",
+            toHuman: (raw) => `${Math.round(raw * 100)}%`,
+            fromHuman: (value) => value / 100,
+        },
+    },
+};
+//# sourceMappingURL=compressor.js.map

package/dist/param-maps/compressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor.js","sourceRoot":"","sources":["../../src/param-maps/compressor.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAa;IACrC,eAAe,EAAE,YAAY;IAC7B,UAAU,EAAE;QACV,SAAS,EAAE;YACT,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI;YACnD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE;YACvC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBACtB,IAAI,GAAG,GAAG,IAAI;oBAAE,OAAO,mBAAmB,KAAK,kCAAkC,CAAC;gBAClF,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD,KAAK,EAAE;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CACf,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YACrE,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE;YACtC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBACtB,IAAI,GAAG,GAAG,IAAI;oBAAE,OAAO,eAAe,KAAK,kCAAkC,CAAC;gBAC9E,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,GAAG;YACjC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBACtB,IAAI,GAAG,GAAG,IAAI;oBAAE,OAAO,gBAAgB,KAAK,6CAA6C,CAAC;gBAC1F,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD,OAAO,EAAE;YACP,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YACrD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,IAAI;SAC1C;QACD,MAAM,EAAE;YACN,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE;SACjC;QACD,SAAS,EAAE;YACT,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG;YAC7C,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,GAAG;SAClC;KACF;CACF,CAAC"}

package/dist/param-maps/eq-eight.d.ts

@@ -0,0 +1,3 @@
+import type { ParamMap } from "./index.js";
+export declare const eqEightMap: ParamMap;
+//# sourceMappingURL=eq-eight.d.ts.map

package/dist/param-maps/eq-eight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eq-eight.d.ts","sourceRoot":"","sources":["../../src/param-maps/eq-eight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAyD3C,eAAO,MAAM,UAAU,EAAE,QAGxB,CAAC"}

package/dist/param-maps/eq-eight.js

@@ -0,0 +1,55 @@
+// EQ Eight has 8 bands, each with: Frequency, Gain, Q, Filter Type, Band On/Off
+// Parameter names in LOM follow the pattern: "1 Frequency A", "1 Gain A", etc.
+// This map covers the common parameters.
+function freqToHuman(raw) {
+    // EQ Eight frequency range: ~20Hz to ~20kHz, logarithmic
+    const hz = 20 * Math.pow(1000, raw);
+    if (hz >= 1000)
+        return `${(hz / 1000).toFixed(1)}kHz`;
+    return `${Math.round(hz)}Hz`;
+}
+function freqFromHuman(hz) {
+    return Math.log(hz / 20) / Math.log(1000);
+}
+function gainToHuman(raw) {
+    // Gain range: -15dB to +15dB, centered at 0.5
+    const db = (raw - 0.5) * 30;
+    const sign = db > 0 ? "+" : "";
+    return `${sign}${db.toFixed(1)}dB`;
+}
+function gainFromHuman(db) {
+    return db / 30 + 0.5;
+}
+function observeGain(raw, human) {
+    const db = (raw - 0.5) * 30;
+    if (db > 4)
+        return `Notable boost (${human})`;
+    if (db < -6)
+        return `Significant cut (${human})`;
+    return null;
+}
+// Build parameters for all 8 bands
+const parameters = {};
+for (let band = 1; band <= 8; band++) {
+    parameters[`${band} Frequency A`] = {
+        unit: "Hz",
+        toHuman: freqToHuman,
+        fromHuman: freqFromHuman,
+    };
+    parameters[`${band} Gain A`] = {
+        unit: "dB",
+        toHuman: gainToHuman,
+        fromHuman: gainFromHuman,
+        observe: observeGain,
+    };
+    parameters[`${band} Resonance A`] = {
+        unit: "Q",
+        toHuman: (raw) => `Q ${(0.1 + raw * 17.9).toFixed(1)}`,
+        fromHuman: (value) => (value - 0.1) / 17.9,
+    };
+}
+export const eqEightMap = {
+    deviceClassName: "Eq8",
+    parameters,
+};
+//# sourceMappingURL=eq-eight.js.map

package/dist/param-maps/eq-eight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eq-eight.js","sourceRoot":"","sources":["../../src/param-maps/eq-eight.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,+EAA+E;AAC/E,yCAAyC;AAEzC,SAAS,WAAW,CAAC,GAAW;IAC9B,yDAAyD;IACzD,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,EAAU;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,8CAA8C;IAC9C,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CAAC,EAAU;IAC/B,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,KAAa;IAC7C,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IAC5B,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,kBAAkB,KAAK,GAAG,CAAC;IAC9C,IAAI,EAAE,GAAG,CAAC,CAAC;QAAE,OAAO,oBAAoB,KAAK,GAAG,CAAC;IACjD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,GAAuD,EAAE,CAAC;AAE1E,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;IACrC,UAAU,CAAC,GAAG,IAAI,cAAc,CAAC,GAAG;QAClC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,aAAa;KACzB,CAAC;IACF,UAAU,CAAC,GAAG,IAAI,SAAS,CAAC,GAAG;QAC7B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,WAAW;KACrB,CAAC;IACF,UAAU,CAAC,GAAG,IAAI,cAAc,CAAC,GAAG;QAClC,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACtD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAa;IAClC,eAAe,EAAE,KAAK;IACtB,UAAU;CACX,CAAC"}

package/dist/param-maps/generic.d.ts

@@ -0,0 +1,3 @@
+import type { ParamMap } from "./index.js";
+export declare const genericMap: ParamMap;
+//# sourceMappingURL=generic.d.ts.map

package/dist/param-maps/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/param-maps/generic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,UAAU,EAAE,QASxB,CAAC"}

package/dist/param-maps/generic.js

@@ -0,0 +1,11 @@
+export const genericMap = {
+    deviceClassName: "_generic",
+    parameters: {
+        _default: {
+            unit: "%",
+            toHuman: (raw) => `${Math.round(raw * 100)}%`,
+            fromHuman: (value) => value / 100,
+        },
+    },
+};
+//# sourceMappingURL=generic.js.map

package/dist/param-maps/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../src/param-maps/generic.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAa;IAClC,eAAe,EAAE,UAAU;IAC3B,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG;YAC7C,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,GAAG;SAClC;KACF;CACF,CAAC"}

package/dist/param-maps/index.d.ts

@@ -0,0 +1,14 @@
+export interface ParamMapEntry {
+    unit: string;
+    toHuman: (raw: number) => string;
+    fromHuman?: (value: number, unit: string) => number;
+    observe?: (raw: number, human: string) => string | null;
+}
+export interface ParamMap {
+    deviceClassName: string;
+    parameters: Record<string, ParamMapEntry>;
+}
+export declare function lookupParamMap(deviceClassName: string): ParamMap | null;
+export declare function translateParameter(deviceClassName: string, paramName: string, rawValue: number, paramMap: ParamMap | null): string;
+export declare function humanToRaw(deviceClassName: string, paramName: string, value: number, unit: string): number | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/param-maps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/param-maps/index.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC3C;AAwBD,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEvE;AAED,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GAAG,IAAI,GACxB,MAAM,CAOR;AAED,wBAAgB,UAAU,CACxB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAQf"}