@mcptoolshop/ai_jam_session 0.1.0

package/dist/playback/timing.d.ts

@@ -0,0 +1,31 @@
+import type { MidiNoteEvent } from "../midi/types.js";
+/** A scheduled event with wall-clock time in milliseconds. */
+export interface ScheduledEvent extends MidiNoteEvent {
+    /** When to fire noteOn, in ms from playback start. */
+    scheduledOnMs: number;
+    /** When to fire noteOff, in ms from playback start. */
+    scheduledOffMs: number;
+}
+/**
+ * Calculate scheduled wall-clock times for all events.
+ *
+ * @param events Sorted note events with absolute time in seconds.
+ * @param speed Speed multiplier (1.0 = normal).
+ * @returns Events with scheduledOnMs and scheduledOffMs.
+ */
+export declare function calculateSchedule(events: readonly MidiNoteEvent[], speed?: number): ScheduledEvent[];
+/**
+ * Get the total playback duration in milliseconds at a given speed.
+ */
+export declare function totalDurationMs(events: readonly MidiNoteEvent[], speed?: number): number;
+/**
+ * Group events into time clusters (events within `thresholdMs` of each other).
+ * Useful for chord detection or batch scheduling.
+ */
+export declare function clusterEvents(events: readonly MidiNoteEvent[], thresholdMs?: number): MidiNoteEvent[][];
+/**
+ * Slice events to a time range (in seconds, at speed 1.0).
+ * Returns events where time >= startSec and time < endSec.
+ */
+export declare function sliceEventsByTime(events: readonly MidiNoteEvent[], startSec: number, endSec: number): MidiNoteEvent[];
+//# sourceMappingURL=timing.d.ts.map

package/dist/playback/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/playback/timing.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,8DAA8D;AAC9D,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,GAAE,MAAY,GAClB,cAAc,EAAE,CAMlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,GAAE,MAAY,GAClB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,WAAW,GAAE,MAAU,GACtB,aAAa,EAAE,EAAE,CAkBnB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,aAAa,EAAE,CAEjB"}

package/dist/playback/timing.js

@@ -0,0 +1,57 @@
+// ─── Timing & Scheduling Utilities ──────────────────────────────────────────
+//
+// Helpers for MIDI playback timing calculations.
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Calculate scheduled wall-clock times for all events.
+ *
+ * @param events Sorted note events with absolute time in seconds.
+ * @param speed Speed multiplier (1.0 = normal).
+ * @returns Events with scheduledOnMs and scheduledOffMs.
+ */
+export function calculateSchedule(events, speed = 1.0) {
+    return events.map((e) => ({
+        ...e,
+        scheduledOnMs: (e.time / speed) * 1000,
+        scheduledOffMs: ((e.time + e.duration) / speed) * 1000,
+    }));
+}
+/**
+ * Get the total playback duration in milliseconds at a given speed.
+ */
+export function totalDurationMs(events, speed = 1.0) {
+    if (events.length === 0)
+        return 0;
+    const last = events[events.length - 1];
+    return ((last.time + last.duration) / speed) * 1000;
+}
+/**
+ * Group events into time clusters (events within `thresholdMs` of each other).
+ * Useful for chord detection or batch scheduling.
+ */
+export function clusterEvents(events, thresholdMs = 5) {
+    if (events.length === 0)
+        return [];
+    const thresholdSec = thresholdMs / 1000;
+    const clusters = [];
+    let current = [events[0]];
+    for (let i = 1; i < events.length; i++) {
+        if (events[i].time - events[i - 1].time <= thresholdSec) {
+            current.push(events[i]);
+        }
+        else {
+            clusters.push(current);
+            current = [events[i]];
+        }
+    }
+    clusters.push(current);
+    return clusters;
+}
+/**
+ * Slice events to a time range (in seconds, at speed 1.0).
+ * Returns events where time >= startSec and time < endSec.
+ */
+export function sliceEventsByTime(events, startSec, endSec) {
+    return events.filter((e) => e.time >= startSec && e.time < endSec);
+}
+//# sourceMappingURL=timing.js.map

package/dist/playback/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/playback/timing.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,iDAAiD;AACjD,gFAAgF;AAYhF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAgC,EAChC,QAAgB,GAAG;IAEnB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,GAAG,CAAC;QACJ,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI;QACtC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI;KACvD,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAgC,EAChC,QAAgB,GAAG;IAEnB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAgC,EAChC,cAAsB,CAAC;IAEvB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,YAAY,GAAG,WAAW,GAAG,IAAI,CAAC;IACxC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,OAAO,GAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,YAAY,EAAE,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAgC,EAChC,QAAgB,EAChB,MAAc;IAEd,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,QAAQ,IAAI,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;AACrE,CAAC"}

package/dist/sample-engine.d.ts

@@ -0,0 +1,17 @@
+import type { VmpkConnector } from "./types.js";
+export interface SampleEngineOptions {
+    /** Path to the AccurateSalamander directory (contains sfz_minimum/, 48khz24bit/). */
+    samplesDir: string;
+    /** SFZ profile to use. Default: "sfz_minimum". */
+    sfzProfile?: "sfz_minimum" | "sfz_daw" | "sfz_live";
+    /** Maximum simultaneous voices. Default: 48. */
+    maxPolyphony?: number;
+}
+/**
+ * Create a sample-based piano engine using Accurate-Salamander samples.
+ *
+ * Implements VmpkConnector so it's a drop-in replacement for the old
+ * oscillator engine.
+ */
+export declare function createSampleEngine(options: SampleEngineOptions): VmpkConnector;
+//# sourceMappingURL=sample-engine.d.ts.map

package/dist/sample-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-engine.d.ts","sourceRoot":"","sources":["../src/sample-engine.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAC;AAKtE,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;IACpD,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAwFD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAmY9E"}

package/dist/sample-engine.js

@@ -0,0 +1,428 @@
+// ─── pianoai: Sample-Based Piano Engine ─────────────────────────────────────
+//
+// Plays real piano samples from the Accurate-Salamander Grand Piano library.
+// 480 WAV samples (48kHz/24-bit), 16 velocity layers, 88 keys.
+//
+// This replaces the oscillator-based engine with actual recorded sound.
+//
+// Usage:
+//   const piano = createSampleEngine({ samplesDir: "samples/AccurateSalamander" });
+//   await piano.connect();    // loads SFZ + WAV files (~1.6GB)
+//   piano.noteOn(60, 100);    // middle C, forte — real piano sound
+//   piano.noteOff(60);
+//   await piano.disconnect();
+// ─────────────────────────────────────────────────────────────────────────────
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseSfzFile } from "./sfz-parser.js";
+function buildRegionMap(regions) {
+    const map = new Map();
+    for (const r of regions) {
+        for (let key = r.lokey; key <= r.hikey; key++) {
+            let slots = map.get(key);
+            if (!slots) {
+                slots = [];
+                map.set(key, slots);
+            }
+            slots.push({ lovel: r.lovel, hivel: r.hivel, region: r });
+        }
+    }
+    // Sort by lovel for binary search
+    for (const [, slots] of map) {
+        slots.sort((a, b) => a.lovel - b.lovel);
+    }
+    return map;
+}
+/** Find the matching region for a given MIDI note + velocity. */
+function findRegion(regionMap, note, velocity) {
+    const slots = regionMap.get(note);
+    if (!slots || slots.length === 0)
+        return null;
+    for (const slot of slots) {
+        if (velocity >= slot.lovel && velocity <= slot.hivel)
+            return slot.region;
+    }
+    // Fallback: closest velocity
+    return slots[slots.length - 1].region;
+}
+// ─── Audio Helpers ──────────────────────────────────────────────────────────
+/** Stereo pan: bass left, treble right (player perspective). */
+function noteToPan(note) {
+    return Math.max(-0.7, Math.min(0.7, ((note - 21) / 87) * 1.4 - 0.7));
+}
+/** Convert dB to linear gain. */
+function dbToGain(db) {
+    return Math.pow(10, db / 20);
+}
+/** Compute playback rate for pitch shifting: cents from sample's pitch center. */
+function centsToRate(cents) {
+    return Math.pow(2, cents / 1200);
+}
+// ─── Lazy Import ────────────────────────────────────────────────────────────
+let _AudioContext = null;
+async function loadAudioContext() {
+    if (!_AudioContext) {
+        const mod = await import("node-web-audio-api");
+        _AudioContext = mod.AudioContext;
+    }
+    return _AudioContext;
+}
+// ─── Engine ─────────────────────────────────────────────────────────────────
+/**
+ * Create a sample-based piano engine using Accurate-Salamander samples.
+ *
+ * Implements VmpkConnector so it's a drop-in replacement for the old
+ * oscillator engine.
+ */
+export function createSampleEngine(options) {
+    const { samplesDir, sfzProfile = "sfz_minimum", maxPolyphony = 48, } = options;
+    let ctx = null;
+    let currentStatus = "disconnected";
+    let compressor = null;
+    let master = null;
+    // Sample data
+    let sfzData = null;
+    let regionMap = null;
+    const audioBuffers = new Map(); // sample path → AudioBuffer
+    // Voice management
+    const activeVoices = new Map();
+    const voiceOrder = [];
+    // ── WAV Parsing ──
+    /**
+     * Parse a WAV file into an AudioBuffer manually.
+     * Handles 16-bit and 24-bit PCM (the Accurate-Salamander set is 24-bit/48kHz).
+     * This avoids needing the async decodeAudioData call for 480+ files.
+     */
+    function parseWavToAudioBuffer(filePath) {
+        const fileData = readFileSync(filePath);
+        const view = new DataView(fileData.buffer, fileData.byteOffset, fileData.byteLength);
+        // ── Find 'fmt ' chunk ──
+        let offset = 12; // skip RIFF header (4 RIFF + 4 size + 4 WAVE)
+        let fmtOffset = -1;
+        let dataOffset = -1;
+        let dataSize = 0;
+        while (offset < view.byteLength - 8) {
+            const chunkId = String.fromCharCode(view.getUint8(offset)) +
+                String.fromCharCode(view.getUint8(offset + 1)) +
+                String.fromCharCode(view.getUint8(offset + 2)) +
+                String.fromCharCode(view.getUint8(offset + 3));
+            const chunkSize = view.getUint32(offset + 4, true);
+            if (chunkId === "fmt ") {
+                fmtOffset = offset + 8;
+            }
+            else if (chunkId === "data") {
+                dataOffset = offset + 8;
+                dataSize = chunkSize;
+            }
+            if (fmtOffset >= 0 && dataOffset >= 0)
+                break;
+            // Next chunk (aligned to 2 bytes)
+            offset += 8 + chunkSize + (chunkSize % 2);
+        }
+        if (fmtOffset < 0)
+            throw new Error(`No 'fmt ' chunk in ${filePath}`);
+        if (dataOffset < 0)
+            throw new Error(`No 'data' chunk in ${filePath}`);
+        // ── Parse format ──
+        let audioFormat = view.getUint16(fmtOffset, true);
+        const numChannels = view.getUint16(fmtOffset + 2, true);
+        const sampleRate = view.getUint32(fmtOffset + 4, true);
+        let bitsPerSample = view.getUint16(fmtOffset + 14, true);
+        // WAVE_FORMAT_EXTENSIBLE (0xFFFE / 65534): real format is in SubFormat GUID
+        if (audioFormat === 0xFFFE) {
+            // cbSize at offset 16 (should be 22), wValidBitsPerSample at offset 18
+            const validBits = view.getUint16(fmtOffset + 18, true);
+            if (validBits > 0)
+                bitsPerSample = validBits;
+            // SubFormat GUID starts at offset 24, first 2 bytes = actual format tag
+            audioFormat = view.getUint16(fmtOffset + 24, true);
+        }
+        if (audioFormat !== 1 && audioFormat !== 3) {
+            throw new Error(`Unsupported WAV format ${audioFormat} (need PCM=1 or IEEE_FLOAT=3) in ${filePath}`);
+        }
+        const isFloat = audioFormat === 3;
+        const bytesPerSample = bitsPerSample / 8;
+        const numFrames = Math.floor(dataSize / (numChannels * bytesPerSample));
+        // ── Create AudioBuffer ──
+        const audioBuffer = ctx.createBuffer(numChannels, numFrames, sampleRate);
+        // ── Decode PCM data into Float32 channel arrays ──
+        for (let ch = 0; ch < numChannels; ch++) {
+            const channelData = new Float32Array(numFrames);
+            for (let i = 0; i < numFrames; i++) {
+                const sampleOffset = dataOffset + (i * numChannels + ch) * bytesPerSample;
+                let sample;
+                if (isFloat && bitsPerSample === 32) {
+                    // 32-bit IEEE float — already -1..1
+                    sample = view.getFloat32(sampleOffset, true);
+                }
+                else if (isFloat && bitsPerSample === 64) {
+                    // 64-bit IEEE float
+                    sample = view.getFloat64(sampleOffset, true);
+                }
+                else if (bitsPerSample === 24) {
+                    // 24-bit signed little-endian → float
+                    const b0 = view.getUint8(sampleOffset);
+                    const b1 = view.getUint8(sampleOffset + 1);
+                    const b2 = view.getUint8(sampleOffset + 2);
+                    const raw = b0 | (b1 << 8) | (b2 << 16);
+                    // Sign extend from 24-bit
+                    sample = (raw > 0x7FFFFF ? raw - 0x1000000 : raw) / 8388608; // 2^23
+                }
+                else if (bitsPerSample === 16) {
+                    // 16-bit signed little-endian → float
+                    sample = view.getInt16(sampleOffset, true) / 32768; // 2^15
+                }
+                else {
+                    throw new Error(`Unsupported bit depth ${bitsPerSample} in ${filePath}`);
+                }
+                channelData[i] = sample;
+            }
+            audioBuffer.copyToChannel(channelData, ch);
+        }
+        return audioBuffer;
+    }
+    // ── Sample Loading ──
+    /** Load all unique sample files referenced by the SFZ regions. */
+    function loadSamples() {
+        if (!sfzData)
+            return;
+        const sfzDir = join(samplesDir, sfzProfile);
+        const uniqueSamples = new Set();
+        for (const r of sfzData.regions) {
+            uniqueSamples.add(r.sample);
+        }
+        console.error(`Loading ${uniqueSamples.size} piano samples...`);
+        const startTime = Date.now();
+        let loaded = 0;
+        for (const samplePath of uniqueSamples) {
+            // Resolve relative path from SFZ file location
+            const fullPath = join(sfzDir, samplePath);
+            try {
+                const audioBuffer = parseWavToAudioBuffer(fullPath);
+                audioBuffers.set(samplePath, audioBuffer);
+                loaded++;
+                if (loaded % 50 === 0) {
+                    console.error(`  ${loaded}/${uniqueSamples.size} samples loaded`);
+                }
+            }
+            catch (err) {
+                console.error(`  SKIP ${samplePath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+        console.error(`Loaded ${loaded}/${uniqueSamples.size} samples in ${elapsed}s`);
+    }
+    // ── Voice Management ──
+    function stealOldest() {
+        if (voiceOrder.length === 0)
+            return;
+        const oldestNote = voiceOrder.shift();
+        const voice = activeVoices.get(oldestNote);
+        if (voice) {
+            killVoice(voice);
+            activeVoices.delete(oldestNote);
+        }
+    }
+    function removeFromOrder(note) {
+        const idx = voiceOrder.indexOf(note);
+        if (idx >= 0)
+            voiceOrder.splice(idx, 1);
+    }
+    function killVoice(voice) {
+        if (voice.cleanupTimer) {
+            clearTimeout(voice.cleanupTimer);
+            voice.cleanupTimer = null;
+        }
+        try {
+            voice.source.stop();
+        }
+        catch { /* already stopped */ }
+        try {
+            voice.source.disconnect();
+        }
+        catch { /* ok */ }
+        try {
+            voice.gain.disconnect();
+        }
+        catch { /* ok */ }
+        try {
+            voice.panner.disconnect();
+        }
+        catch { /* ok */ }
+    }
+    function releaseVoice(voice) {
+        if (voice.released)
+            return;
+        voice.released = true;
+        const now = ctx.currentTime;
+        const releaseTime = sfzData?.ampegRelease ?? 1.0;
+        // Fade out over release time
+        voice.gain.gain.cancelScheduledValues(now);
+        voice.gain.gain.setValueAtTime(voice.gain.gain.value, now);
+        voice.gain.gain.exponentialRampToValueAtTime(0.001, now + releaseTime);
+        // Cleanup after release
+        voice.cleanupTimer = setTimeout(() => killVoice(voice), (releaseTime + 0.1) * 1000);
+    }
+    // ── VmpkConnector Implementation ──
+    return {
+        async connect() {
+            if (currentStatus === "connected")
+                return;
+            currentStatus = "connecting";
+            try {
+                // 1. Create audio context
+                const AC = await loadAudioContext();
+                ctx = new AC({ sampleRate: 48000, latencyHint: "playback" });
+                // 2. Master chain: compressor → gain → speakers
+                compressor = ctx.createDynamicsCompressor();
+                compressor.threshold.value = -12;
+                compressor.knee.value = 10;
+                compressor.ratio.value = 4;
+                compressor.attack.value = 0.003;
+                compressor.release.value = 0.25;
+                master = ctx.createGain();
+                master.gain.value = 0.85;
+                compressor.connect(master);
+                master.connect(ctx.destination);
+                // 3. Parse SFZ
+                const sfzFile = join(samplesDir, sfzProfile, sfzProfile === "sfz_minimum"
+                    ? "Accurate-SalamanderGrandPiano_flat.Recommended.sfz"
+                    : sfzProfile === "sfz_daw"
+                        ? "Accurate-SalamanderGrandPiano_flat.Recommended.sfz"
+                        : "Accurate-SalamanderGrandPiano_flat.Recommended.sfz");
+                sfzData = parseSfzFile(sfzFile);
+                regionMap = buildRegionMap(sfzData.regions);
+                // 4. Load all WAV samples
+                loadSamples();
+                currentStatus = "connected";
+                console.error(`Piano engine connected (sample-based, ${audioBuffers.size} samples)`);
+            }
+            catch (err) {
+                currentStatus = "error";
+                throw new Error(`Failed to start sample engine: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+        async disconnect() {
+            for (const [, voice] of activeVoices) {
+                try {
+                    killVoice(voice);
+                }
+                catch { /* ok */ }
+            }
+            activeVoices.clear();
+            voiceOrder.length = 0;
+            audioBuffers.clear();
+            sfzData = null;
+            regionMap = null;
+            if (ctx) {
+                try {
+                    await ctx.close();
+                }
+                catch { /* ok */ }
+                ctx = null;
+                compressor = null;
+                master = null;
+            }
+            currentStatus = "disconnected";
+        },
+        status() {
+            return currentStatus;
+        },
+        listPorts() {
+            return ["Accurate-Salamander Grand Piano"];
+        },
+        noteOn(note, velocity, channel) {
+            if (!ctx || currentStatus !== "connected" || !regionMap)
+                return;
+            // Clamp
+            velocity = Math.max(1, Math.min(127, velocity));
+            note = Math.max(21, Math.min(108, note));
+            // Kill existing voice on same note (retrigger)
+            const existing = activeVoices.get(note);
+            if (existing) {
+                killVoice(existing);
+                activeVoices.delete(note);
+                removeFromOrder(note);
+            }
+            // Voice stealing
+            while (activeVoices.size >= maxPolyphony) {
+                stealOldest();
+            }
+            // Find the right sample
+            const region = findRegion(regionMap, note, velocity);
+            if (!region)
+                return;
+            const audioBuffer = audioBuffers.get(region.sample);
+            if (!audioBuffer)
+                return;
+            const now = ctx.currentTime;
+            // Create buffer source
+            const source = ctx.createBufferSource();
+            source.buffer = audioBuffer;
+            // Pitch shift: difference between target note and sample's recorded pitch
+            const semitoneDiff = note - region.pitchKeycenter;
+            const tuneCents = region.tune; // additional fine tuning from SFZ
+            const totalCents = semitoneDiff * 100 + tuneCents;
+            source.playbackRate.value = centsToRate(totalCents);
+            // Volume: SFZ volume offset + velocity scaling
+            const velocity01 = velocity / 127;
+            const velTrack = (sfzData?.ampVeltrack ?? 97) / 100;
+            // SFZ velocity tracking: gain = (1 - velTrack) + velTrack * velocity01
+            const velGain = (1 - velTrack) + velTrack * velocity01;
+            const volumeGain = dbToGain(region.volume);
+            const gain = ctx.createGain();
+            gain.gain.value = velGain * volumeGain * 0.5; // 0.5 = headroom factor
+            // Stereo position
+            const panner = ctx.createStereoPanner();
+            panner.pan.value = noteToPan(note);
+            // Connect: source → gain → panner → compressor → master → speakers
+            source.connect(gain);
+            gain.connect(panner);
+            panner.connect(compressor);
+            source.start(now);
+            const voice = {
+                note,
+                source,
+                gain,
+                panner,
+                released: false,
+                cleanupTimer: null,
+            };
+            activeVoices.set(note, voice);
+            voiceOrder.push(note);
+        },
+        noteOff(note, channel) {
+            if (!ctx || currentStatus !== "connected")
+                return;
+            const voice = activeVoices.get(note);
+            if (voice) {
+                releaseVoice(voice);
+                activeVoices.delete(note);
+                removeFromOrder(note);
+            }
+        },
+        allNotesOff(channel) {
+            if (!ctx)
+                return;
+            for (const [, voice] of activeVoices) {
+                killVoice(voice);
+            }
+            activeVoices.clear();
+            voiceOrder.length = 0;
+        },
+        async playNote(midiNote) {
+            if (midiNote.note < 0) {
+                await sleep(midiNote.durationMs);
+                return;
+            }
+            this.noteOn(midiNote.note, midiNote.velocity, midiNote.channel);
+            await sleep(midiNote.durationMs);
+            this.noteOff(midiNote.note, midiNote.channel);
+        },
+    };
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sample-engine.js.map

package/dist/sample-engine.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+/** Play a song from the built-in library by ID. */
+export declare const LibraryPlaySchema: z.ZodObject<{
+    songId: z.ZodString;
+}, z.core.$strip>;
+/** Play a local MIDI file. */
+export declare const FilePlaySchema: z.ZodObject<{
+    midiPath: z.ZodString;
+}, z.core.$strip>;
+/** Play a remote MIDI file by URL. */
+export declare const UrlPlaySchema: z.ZodObject<{
+    midiUrl: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Unified play source — one of: library song, local file, or remote URL.
+ */
+export declare const PlaySourceSchema: z.ZodUnion<readonly [z.ZodObject<{
+    songId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    midiPath: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    midiUrl: z.ZodString;
+}, z.core.$strip>]>;
+/** Infer the TypeScript type. */
+export type PlaySource = z.infer<typeof PlaySourceSchema>;
+/** Shared playback options (apply to all sources). */
+export declare const PlaybackOptionsSchema: z.ZodObject<{
+    speed: z.ZodOptional<z.ZodNumber>;
+    tempo: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        measure: "measure";
+        hands: "hands";
+        loop: "loop";
+    }>>;
+    startMeasure: z.ZodOptional<z.ZodNumber>;
+    endMeasure: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PlaybackOptions = z.infer<typeof PlaybackOptionsSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mDAAmD;AACnD,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH,8BAA8B;AAC9B,eAAO,MAAM,cAAc;;iBAEzB,CAAC;AAEH,sCAAsC;AACtC,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;mBAI3B,CAAC;AAEH,iCAAiC;AACjC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,sDAAsD;AACtD,eAAO,MAAM,qBAAqB;;;;;;;;;;;iBAWhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,42 @@
+// ─── Playback Schemas ───────────────────────────────────────────────────────
+//
+// Zod schemas for play_song input. Supports three playback sources:
+//   1. songId  — play from the built-in song library
+//   2. midiPath — play a local .mid file
+//   3. midiUrl  — play a remote .mid file (downloaded on demand)
+// ─────────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+/** Play a song from the built-in library by ID. */
+export const LibraryPlaySchema = z.object({
+    songId: z.string().describe("Song ID from the built-in library (e.g. 'autumn-leaves')"),
+});
+/** Play a local MIDI file. */
+export const FilePlaySchema = z.object({
+    midiPath: z.string().describe("Absolute path to a local .mid file"),
+});
+/** Play a remote MIDI file by URL. */
+export const UrlPlaySchema = z.object({
+    midiUrl: z.string().url().describe("URL to a .mid file (downloaded on demand)"),
+});
+/**
+ * Unified play source — one of: library song, local file, or remote URL.
+ */
+export const PlaySourceSchema = z.union([
+    LibraryPlaySchema,
+    FilePlaySchema,
+    UrlPlaySchema,
+]);
+/** Shared playback options (apply to all sources). */
+export const PlaybackOptionsSchema = z.object({
+    speed: z.number().min(0.1).max(4).optional()
+        .describe("Speed multiplier (0.5 = half, 1.0 = normal, 2.0 = double)"),
+    tempo: z.number().int().min(10).max(400).optional()
+        .describe("Override tempo in BPM (10-400)"),
+    mode: z.enum(["full", "measure", "hands", "loop"]).optional()
+        .describe("Playback mode"),
+    startMeasure: z.number().int().min(1).optional()
+        .describe("Start measure for loop mode (1-based)"),
+    endMeasure: z.number().int().min(1).optional()
+        .describe("End measure for loop mode (1-based)"),
+});
+//# sourceMappingURL=schemas.js.map