talkback-mcp 0.1.0

package/dist/context-assembler.d.ts

@@ -0,0 +1,7 @@
+import type { SemanticSession, SessionCache } from "./types.js";
+export declare function rawVolumeToDb(raw: number): string;
+export declare function rawPanToHuman(raw: number): string;
+export declare function rawSendToPercent(raw: number): string;
+export declare function rawMeterToDb(left: number, right: number): string;
+export declare function assembleContext(cache: SessionCache): SemanticSession | null;
+//# sourceMappingURL=context-assembler.d.ts.map

package/dist/context-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembler.d.ts","sourceRoot":"","sources":["../src/context-assembler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAGf,YAAY,EACb,MAAM,YAAY,CAAC;AAOpB,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhE;AAsJD,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,GAAG,IAAI,CA6C3E"}

package/dist/context-assembler.js

@@ -0,0 +1,181 @@
+import { lookupParamMap, translateParameter } from "./param-maps/index.js";
+// ============================================================
+// Volume / pan / meter conversions
+// ============================================================
+export function rawVolumeToDb(raw) {
+    if (raw <= 0)
+        return "-inf dB";
+    const db = 20 * Math.log10(raw / 0.85);
+    if (db <= -70)
+        return "-inf dB";
+    const rounded = Math.round(db * 10) / 10;
+    const sign = rounded > 0 ? "+" : "";
+    return `${sign}${rounded}dB`;
+}
+export function rawPanToHuman(raw) {
+    if (Math.abs(raw) < 0.01)
+        return "center";
+    const pct = Math.round(Math.abs(raw) * 100);
+    const side = raw < 0 ? "left" : "right";
+    if (pct >= 99)
+        return `hard ${side}`;
+    return `${pct}% ${side}`;
+}
+export function rawSendToPercent(raw) {
+    return `${Math.round(raw * 100)}%`;
+}
+export function rawMeterToDb(left, right) {
+    const peak = Math.max(left, right);
+    if (peak <= 0)
+        return "silent";
+    const db = 20 * Math.log10(peak);
+    if (db <= -60)
+        return "silent";
+    const rounded = Math.round(db * 10) / 10;
+    return `${rounded}dB`;
+}
+// ============================================================
+// Device assembly
+// ============================================================
+function assembleDevice(device) {
+    const paramMap = lookupParamMap(device.className);
+    const isThirdParty = device.type === "PluginDevice";
+    const parameters = {};
+    const observations = [];
+    for (const param of device.parameters) {
+        parameters[param.name] = translateParameter(device.className, param.name, param.value, paramMap);
+    }
+    // Generate observations from param map advisors
+    if (paramMap) {
+        for (const param of device.parameters) {
+            const mapEntry = paramMap.parameters[param.name];
+            if (mapEntry?.observe) {
+                const observation = mapEntry.observe(param.value, parameters[param.name]);
+                if (observation)
+                    observations.push(observation);
+            }
+        }
+    }
+    return {
+        id: device.id,
+        name: device.name,
+        active: device.isActive,
+        isThirdParty,
+        parameters,
+        observations,
+    };
+}
+// ============================================================
+// Track assembly
+// ============================================================
+function assembleTrack(track, returnTrackNames, trackNameMap) {
+    const sends = {};
+    if (Array.isArray(track.sends)) {
+        for (const send of track.sends) {
+            const returnName = returnTrackNames.get(send.returnTrackId) ?? send.returnTrackId;
+            sends[returnName] = rawSendToPercent(send.amount);
+        }
+    }
+    // Handle both full device objects and lightweight device name arrays
+    const devices = Array.isArray(track.devices)
+        ? track.devices.map(assembleDevice)
+        : [];
+    // If we only have deviceNames (lightweight snapshot), show them as simple entries
+    const deviceNameList = track.deviceNames ?? [];
+    if (devices.length === 0 && deviceNameList.length > 0) {
+        for (const dn of deviceNameList) {
+            devices.push({
+                id: dn,
+                name: dn,
+                active: true,
+                isThirdParty: false,
+                parameters: {},
+                observations: [],
+            });
+        }
+    }
+    // Resolve group name from ID
+    const groupName = track.groupId
+        ? trackNameMap.get(track.groupId) ?? track.groupId
+        : null;
+    // Output level from meters
+    const meterLeft = track.outputMeterLeft ?? 0;
+    const meterRight = track.outputMeterRight ?? 0;
+    return {
+        id: track.id,
+        name: track.name,
+        type: track.type,
+        volume: rawVolumeToDb(track.volume),
+        panning: rawPanToHuman(track.panning),
+        muted: track.mute,
+        soloed: track.solo,
+        armed: track.arm ?? false,
+        monitoring: track.monitoring ?? "off",
+        group: groupName,
+        outputRouting: track.outputRouting,
+        outputLevel: rawMeterToDb(meterLeft, meterRight),
+        sends,
+        devices,
+        clipNames: track.clipNames ?? [],
+    };
+}
+// ============================================================
+// Session assembly
+// ============================================================
+function generateSessionSummary(tracks, returnTracks, masterTrack) {
+    const parts = [];
+    const groupCount = tracks.filter((t) => t.type === "group").length;
+    parts.push(`${tracks.length} tracks${groupCount > 0 ? ` (${groupCount} groups)` : ""}, ${returnTracks.length} returns.`);
+    // Master output level
+    if (masterTrack.outputLevel !== "silent") {
+        parts.push(`Master output: ${masterTrack.outputLevel}.`);
+    }
+    // Note any devices on master
+    const masterDevices = masterTrack.devices.filter((d) => d.active);
+    if (masterDevices.length > 0) {
+        parts.push(`Master chain: ${masterDevices.map((d) => d.name).join(" → ")}.`);
+    }
+    // Collect observations across all tracks
+    for (const track of [...tracks, ...returnTracks, masterTrack]) {
+        for (const device of track.devices) {
+            for (const obs of device.observations) {
+                parts.push(`[${track.name}] ${obs}`);
+            }
+        }
+    }
+    return parts.join(" ");
+}
+export function assembleContext(cache) {
+    if (!cache.raw)
+        return null;
+    const { tempo, signature, tracks, returnTracks, masterTrack } = cache.raw;
+    const sampleRate = cache.raw.sampleRate ?? 44100;
+    // Build return track name map for send labels
+    const returnTrackNames = new Map();
+    for (const rt of returnTracks) {
+        returnTrackNames.set(rt.id, rt.name);
+    }
+    // Build track name map for group resolution
+    const trackNameMap = new Map();
+    for (const t of tracks) {
+        trackNameMap.set(t.id, t.name);
+    }
+    const semanticTracks = tracks.map((t) => assembleTrack(t, returnTrackNames, trackNameMap));
+    const semanticReturns = returnTracks.map((t) => assembleTrack(t, returnTrackNames, trackNameMap));
+    const semanticMaster = assembleTrack(masterTrack, returnTrackNames, trackNameMap);
+    const groupCount = tracks.filter((t) => t.isGroupTrack).length;
+    return {
+        tempo: `${tempo} BPM`,
+        signature: `${signature.numerator}/${signature.denominator}`,
+        sampleRate: `${sampleRate} Hz`,
+        trackCount: tracks.length,
+        groupCount,
+        returnTrackCount: returnTracks.length,
+        m4lConnected: cache.isConnected,
+        tracks: semanticTracks,
+        returnTracks: semanticReturns,
+        masterTrack: semanticMaster,
+        sessionSummary: generateSessionSummary(semanticTracks, semanticReturns, semanticMaster),
+    };
+}
+//# sourceMappingURL=context-assembler.js.map

package/dist/context-assembler.js.map

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

package/dist/heuristics/dynamics.d.ts

@@ -0,0 +1,3 @@
+import type { SemanticTrack, HeuristicFinding } from "../types.js";
+export declare function checkDynamics(tracks: SemanticTrack[]): HeuristicFinding[];
+//# sourceMappingURL=dynamics.d.ts.map

package/dist/heuristics/dynamics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamics.d.ts","sourceRoot":"","sources":["../../src/heuristics/dynamics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASnE,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,gBAAgB,EAAE,CAmDzE"}

package/dist/heuristics/dynamics.js

@@ -0,0 +1,53 @@
+const TRANSIENT_KEYWORDS = ["kick", "snare", "808", "drum", "perc", "hat", "clap", "rim"];
+function isTransientTrack(track) {
+    const lower = track.name.toLowerCase();
+    return TRANSIENT_KEYWORDS.some((kw) => lower.includes(kw));
+}
+export function checkDynamics(tracks) {
+    const findings = [];
+    for (const track of tracks) {
+        for (const device of track.devices) {
+            if (!device.active)
+                continue;
+            // Slow attack on transient-heavy tracks
+            if (device.name === "Compressor" &&
+                isTransientTrack(track)) {
+                const attack = device.parameters["Attack"];
+                if (attack) {
+                    const ms = parseFloat(attack);
+                    if (ms > 50) {
+                        findings.push({
+                            id: "slow_attack_on_transient_track",
+                            severity: "warning",
+                            track: track.name,
+                            device: device.name,
+                            message: `Compressor attack is ${attack} — transients passing through uncompressed on a percussive track`,
+                            suggestion: `Try 10-20ms for tighter transient control`,
+                        });
+                    }
+                }
+            }
+            // High ratio without matching fast attack
+            if (device.name === "Compressor") {
+                const ratio = device.parameters["Ratio"];
+                const attack = device.parameters["Attack"];
+                if (ratio && attack) {
+                    const ratioVal = parseFloat(ratio);
+                    const attackMs = parseFloat(attack);
+                    if (ratioVal > 10 && attackMs > 30) {
+                        findings.push({
+                            id: "high_ratio_slow_attack",
+                            severity: "info",
+                            track: track.name,
+                            device: device.name,
+                            message: `High ratio (${ratio}) with slow attack (${attack}) — not catching transients despite aggressive ratio`,
+                            suggestion: `Either lower the ratio or speed up the attack`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=dynamics.js.map

package/dist/heuristics/dynamics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamics.js","sourceRoot":"","sources":["../../src/heuristics/dynamics.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1F,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAuB;IACnD,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,SAAS;YAE7B,wCAAwC;YACxC,IACE,MAAM,CAAC,IAAI,KAAK,YAAY;gBAC5B,gBAAgB,CAAC,KAAK,CAAC,EACvB,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC3C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;oBAC9B,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;wBACZ,QAAQ,CAAC,IAAI,CAAC;4BACZ,EAAE,EAAE,gCAAgC;4BACpC,QAAQ,EAAE,SAAS;4BACnB,KAAK,EAAE,KAAK,CAAC,IAAI;4BACjB,MAAM,EAAE,MAAM,CAAC,IAAI;4BACnB,OAAO,EAAE,wBAAwB,MAAM,kEAAkE;4BACzG,UAAU,EAAE,2CAA2C;yBACxD,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,0CAA0C;YAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC3C,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;oBACpB,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;oBACnC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;oBACpC,IAAI,QAAQ,GAAG,EAAE,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;wBACnC,QAAQ,CAAC,IAAI,CAAC;4BACZ,EAAE,EAAE,wBAAwB;4BAC5B,QAAQ,EAAE,MAAM;4BAChB,KAAK,EAAE,KAAK,CAAC,IAAI;4BACjB,MAAM,EAAE,MAAM,CAAC,IAAI;4BACnB,OAAO,EAAE,eAAe,KAAK,uBAAuB,MAAM,sDAAsD;4BAChH,UAAU,EAAE,+CAA+C;yBAC5D,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/heuristics/frequency-buildup.d.ts

@@ -0,0 +1,3 @@
+import type { SemanticTrack, HeuristicFinding } from "../types.js";
+export declare function checkFrequencyBuildup(tracks: SemanticTrack[]): HeuristicFinding[];
+//# sourceMappingURL=frequency-buildup.d.ts.map

package/dist/heuristics/frequency-buildup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequency-buildup.d.ts","sourceRoot":"","sources":["../../src/heuristics/frequency-buildup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASnE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EAAE,GACtB,gBAAgB,EAAE,CAiEpB"}

package/dist/heuristics/frequency-buildup.js

@@ -0,0 +1,69 @@
+const BASS_KEYWORDS = ["bass", "808", "sub", "kick", "low"];
+function isBassTrack(track) {
+    const lower = track.name.toLowerCase();
+    return BASS_KEYWORDS.some((kw) => lower.includes(kw));
+}
+export function checkFrequencyBuildup(tracks) {
+    const findings = [];
+    // Check for non-bass tracks missing a high-pass
+    for (const track of tracks) {
+        if (isBassTrack(track) || track.type === "group")
+            continue;
+        const hasHighPass = track.devices.some((d) => {
+            if (d.name !== "EQ Eight" && d.name !== "Eq8")
+                return false;
+            // Check if band 1 is configured as a high-pass (heuristic: low frequency + active)
+            // This is a simplification — full implementation checks filter type parameter
+            return d.active;
+        });
+        // Only flag if track has devices at all (empty tracks aren't a concern)
+        if (!hasHighPass && track.devices.length > 0) {
+            findings.push({
+                id: "no_high_pass",
+                severity: "info",
+                track: track.name,
+                device: null,
+                message: `No EQ with high-pass detected — sub-bass accumulation possible`,
+                suggestion: `Consider adding a high-pass filter around 30-80Hz to clean up low-end`,
+            });
+        }
+    }
+    // Check for multiple tracks boosting low-mids
+    // This requires EQ Eight gain analysis across tracks
+    let lowMidBoostCount = 0;
+    const lowMidBoostTracks = [];
+    for (const track of tracks) {
+        for (const device of track.devices) {
+            if (!device.active)
+                continue;
+            if (device.name !== "EQ Eight" && device.name !== "Eq8")
+                continue;
+            // Check bands in the 150-500Hz range for boosts
+            for (const [paramName, value] of Object.entries(device.parameters)) {
+                if (!paramName.includes("Gain"))
+                    continue;
+                const db = parseFloat(value);
+                if (db > 3) {
+                    // Check if the corresponding frequency is in the low-mid range
+                    // This is a simplified check — full implementation correlates gain with frequency
+                    lowMidBoostCount++;
+                    if (!lowMidBoostTracks.includes(track.name)) {
+                        lowMidBoostTracks.push(track.name);
+                    }
+                }
+            }
+        }
+    }
+    if (lowMidBoostTracks.length >= 3) {
+        findings.push({
+            id: "low_mid_buildup",
+            severity: "warning",
+            track: null,
+            device: null,
+            message: `${lowMidBoostTracks.length} tracks have EQ boosts in the low-mid range (${lowMidBoostTracks.join(", ")}) — likely causing muddiness`,
+            suggestion: `Review these tracks for competing boosts in the 150-500Hz range. Consider cutting on some tracks rather than boosting on others.`,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=frequency-buildup.js.map

package/dist/heuristics/frequency-buildup.js.map

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

package/dist/heuristics/headroom.d.ts

@@ -0,0 +1,3 @@
+import type { SemanticTrack, HeuristicFinding } from "../types.js";
+export declare function checkHeadroom(tracks: SemanticTrack[], masterTrack: SemanticTrack): HeuristicFinding[];
+//# sourceMappingURL=headroom.d.ts.map

package/dist/heuristics/headroom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headroom.d.ts","sourceRoot":"","sources":["../../src/heuristics/headroom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EAAE,EACvB,WAAW,EAAE,aAAa,GACzB,gBAAgB,EAAE,CA0DpB"}

package/dist/heuristics/headroom.js

@@ -0,0 +1,54 @@
+export function checkHeadroom(tracks, masterTrack) {
+    const findings = [];
+    // Master volume above 0dB
+    const masterDb = parseFloat(masterTrack.volume);
+    if (!isNaN(masterDb) && masterDb > 0) {
+        findings.push({
+            id: "master_above_unity",
+            severity: "issue",
+            track: "Master",
+            device: null,
+            message: `Master track volume is ${masterTrack.volume} — no headroom`,
+            suggestion: `Bring master fader to 0dB or below. Gain should come from individual tracks.`,
+        });
+    }
+    // Count tracks near or above 0dB
+    const hotTracks = tracks.filter((t) => {
+        const db = parseFloat(t.volume);
+        return !isNaN(db) && db >= -1;
+    });
+    if (hotTracks.length > 5) {
+        findings.push({
+            id: "many_hot_tracks",
+            severity: "warning",
+            track: null,
+            device: null,
+            message: `${hotTracks.length} tracks are near or above 0dB — gain staging may need attention`,
+            suggestion: `Consider pulling track volumes down collectively and using makeup gain or bus volume to compensate.`,
+        });
+    }
+    // Master limiter working hard (check for limiter on master with low threshold)
+    for (const device of masterTrack.devices) {
+        if (!device.active)
+            continue;
+        if (device.name.toLowerCase().includes("limiter") ||
+            device.name.toLowerCase().includes("glue compressor")) {
+            const threshold = device.parameters["Threshold"];
+            if (threshold) {
+                const threshDb = parseFloat(threshold);
+                if (!isNaN(threshDb) && threshDb < -6) {
+                    findings.push({
+                        id: "master_limiter_overloaded",
+                        severity: "warning",
+                        track: "Master",
+                        device: device.name,
+                        message: `Master ${device.name} threshold at ${threshold} — likely doing heavy gain reduction`,
+                        suggestion: `Mix may be hitting the master too hot. Pull back track/bus levels to reduce limiter workload.`,
+                    });
+                }
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=headroom.js.map

package/dist/heuristics/headroom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headroom.js","sourceRoot":"","sources":["../../src/heuristics/headroom.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAC3B,MAAuB,EACvB,WAA0B;IAE1B,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,oBAAoB;YACxB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,0BAA0B,WAAW,CAAC,MAAM,gBAAgB;YACrE,UAAU,EAAE,8EAA8E;SAC3F,CAAC,CAAC;IACL,CAAC;IAED,iCAAiC;IACjC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACpC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,iBAAiB;YACrB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,GAAG,SAAS,CAAC,MAAM,iEAAiE;YAC7F,UAAU,EAAE,qGAAqG;SAClH,CAAC,CAAC;IACL,CAAC;IAED,+EAA+E;IAC/E,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,SAAS;QAC7B,IACE,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EACrD,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YACjD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBACvC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;oBACtC,QAAQ,CAAC,IAAI,CAAC;wBACZ,EAAE,EAAE,2BAA2B;wBAC/B,QAAQ,EAAE,SAAS;wBACnB,KAAK,EAAE,QAAQ;wBACf,MAAM,EAAE,MAAM,CAAC,IAAI;wBACnB,OAAO,EAAE,UAAU,MAAM,CAAC,IAAI,iBAAiB,SAAS,sCAAsC;wBAC9F,UAAU,EAAE,+FAA+F;qBAC5G,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/heuristics/index.d.ts

@@ -0,0 +1,3 @@
+import type { SemanticSession, HeuristicFinding } from "../types.js";
+export declare function runHeuristics(session: SemanticSession): HeuristicFinding[];
+//# sourceMappingURL=index.d.ts.map

package/dist/heuristics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/heuristics/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAMrB,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,EAAE,CAmB1E"}

package/dist/heuristics/index.js

@@ -0,0 +1,22 @@
+import { checkDynamics } from "./dynamics.js";
+import { checkFrequencyBuildup } from "./frequency-buildup.js";
+import { checkHeadroom } from "./headroom.js";
+import { checkRouting } from "./routing.js";
+export function runHeuristics(session) {
+    const allTracks = [
+        ...session.tracks,
+        ...session.returnTracks,
+        session.masterTrack,
+    ];
+    const findings = [
+        ...checkDynamics(session.tracks),
+        ...checkFrequencyBuildup(session.tracks),
+        ...checkHeadroom(session.tracks, session.masterTrack),
+        ...checkRouting(session.tracks, session.returnTracks),
+    ];
+    // Sort by severity: issue > warning > info
+    const severityOrder = { issue: 0, warning: 1, info: 2 };
+    findings.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+    return findings;
+}
+//# sourceMappingURL=index.js.map

package/dist/heuristics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/heuristics/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,MAAM,SAAS,GAAoB;QACjC,GAAG,OAAO,CAAC,MAAM;QACjB,GAAG,OAAO,CAAC,YAAY;QACvB,OAAO,CAAC,WAAW;KACpB,CAAC;IAEF,MAAM,QAAQ,GAAuB;QACnC,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,GAAG,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;QACxC,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC;QACrD,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;KACtD,CAAC;IAEF,2CAA2C;IAC3C,MAAM,aAAa,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACxD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE/E,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/heuristics/routing.d.ts

@@ -0,0 +1,3 @@
+import type { SemanticTrack, HeuristicFinding } from "../types.js";
+export declare function checkRouting(tracks: SemanticTrack[], returnTracks: SemanticTrack[]): HeuristicFinding[];
+//# sourceMappingURL=routing.d.ts.map

package/dist/heuristics/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/heuristics/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EAAE,EACvB,YAAY,EAAE,aAAa,EAAE,GAC5B,gBAAgB,EAAE,CAoEpB"}

package/dist/heuristics/routing.js

@@ -0,0 +1,60 @@
+export function checkRouting(tracks, returnTracks) {
+    const findings = [];
+    // Check for many tracks routing directly to master with no bus structure
+    const directToMaster = tracks.filter((t) => t.type !== "group" &&
+        (t.outputRouting.toLowerCase() === "master" ||
+            t.outputRouting === ""));
+    if (directToMaster.length > 12 && tracks.some((t) => t.type !== "group")) {
+        const groupCount = tracks.filter((t) => t.type === "group").length;
+        if (groupCount === 0) {
+            findings.push({
+                id: "no_bus_structure",
+                severity: "info",
+                track: null,
+                device: null,
+                message: `${directToMaster.length} tracks routing directly to master with no group buses — session could benefit from bus structure`,
+                suggestion: `Consider creating group tracks (e.g., Drums Bus, Music Bus, Vocal Bus) for better mix management and processing.`,
+            });
+        }
+    }
+    // Check for duplicate reverb settings across tracks
+    const reverbDevices = [];
+    for (const track of tracks) {
+        for (const device of track.devices) {
+            if (!device.active)
+                continue;
+            if (device.name.toLowerCase().includes("reverb") ||
+                device.name === "Reverb") {
+                // Create a rough fingerprint of the reverb settings
+                const fingerprint = Object.entries(device.parameters)
+                    .sort(([a], [b]) => a.localeCompare(b))
+                    .map(([k, v]) => `${k}:${v}`)
+                    .join("|");
+                reverbDevices.push({ track: track.name, params: fingerprint });
+            }
+        }
+    }
+    if (reverbDevices.length >= 4) {
+        // Check if many have similar settings
+        const fingerprints = new Map();
+        for (const rd of reverbDevices) {
+            const existing = fingerprints.get(rd.params) ?? [];
+            existing.push(rd.track);
+            fingerprints.set(rd.params, existing);
+        }
+        for (const [, trackNames] of fingerprints) {
+            if (trackNames.length >= 3) {
+                findings.push({
+                    id: "duplicate_reverbs",
+                    severity: "info",
+                    track: null,
+                    device: null,
+                    message: `${trackNames.length} tracks have similar reverb settings (${trackNames.join(", ")}) — consider consolidating to a return track`,
+                    suggestion: `Move the reverb to a return track and use sends. This gives a more cohesive space and saves CPU.`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=routing.js.map

package/dist/heuristics/routing.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+import "dotenv/config";
+import express from "express";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { WsBridge } from "./ws-bridge.js";
+import { createMcpServer } from "./mcp-server.js";
+const WS_PORT = parseInt(process.env.WS_PORT ?? "8765", 10);
+const MCP_PORT = parseInt(process.env.MCP_PORT ?? "3000", 10);
+// ============================================================
+// Start WebSocket bridge
+// ============================================================
+const bridge = new WsBridge();
+await bridge.start(WS_PORT);
+bridge.on("connected", () => {
+    console.log("[main] M4L bridge connected — session data will flow");
+});
+bridge.on("disconnected", () => {
+    console.log("[main] M4L bridge disconnected");
+});
+bridge.on("session_updated", () => {
+    const trackCount = bridge.cache.raw?.tracks.length ?? 0;
+    console.log(`[main] Session updated — ${trackCount} tracks`);
+});
+// ============================================================
+// Start MCP server with streamable HTTP transport
+// ============================================================
+const mcpServer = createMcpServer(bridge);
+const app = express();
+app.post("/mcp", async (req, res) => {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined, // stateless for now
+    });
+    await mcpServer.connect(transport);
+    await transport.handleRequest(req, res);
+});
+// Health check
+app.get("/health", (_req, res) => {
+    res.json({
+        status: "ok",
+        m4lConnected: bridge.cache.isConnected,
+        lastUpdated: bridge.cache.lastUpdated,
+        trackCount: bridge.cache.raw?.tracks.length ?? 0,
+    });
+});
+app.listen(MCP_PORT, () => {
+    console.log(`[main] AbletonMCP server running`);
+    console.log(`[main]   MCP endpoint: http://localhost:${MCP_PORT}/mcp`);
+    console.log(`[main]   WebSocket bridge: ws://localhost:${WS_PORT}`);
+    console.log(`[main]   Health check: http://localhost:${MCP_PORT}/health`);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAE9D,+DAA+D;AAC/D,yBAAyB;AACzB,+DAA+D;AAE/D,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;AAC9B,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAE5B,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;IAC1B,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;IAC7B,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAChC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,4BAA4B,UAAU,SAAS,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEH,+DAA+D;AAC/D,kDAAkD;AAClD,+DAA+D;AAE/D,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;AAEtB,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAClC,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB,EAAE,SAAS,EAAE,oBAAoB;KACpD,CAAC,CAAC;IACH,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,eAAe;AACf,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IAC/B,GAAG,CAAC,IAAI,CAAC;QACP,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;QACtC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;QACrC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;KACjD,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,2CAA2C,QAAQ,MAAM,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,6CAA6C,OAAO,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,2CAA2C,QAAQ,SAAS,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { WsBridge } from "./ws-bridge.js";
+export declare function createMcpServer(bridge: WsBridge): McpServer;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA+C/C,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CA2e3D"}