@mcptoolshop/ai_jam_session 0.1.0

package/dist/teaching.js

@@ -0,0 +1,453 @@
+// ─── pianoai: Teaching Engine ────────────────────────────────────────────────
+//
+// Provides TeachingHook implementations that deliver teaching interjections
+// during playback. The session engine calls these hooks at key moments.
+//
+// Implementations:
+//   - ConsoleTeachingHook: logs to console (development/CLI)
+//   - SilentTeachingHook: no-op (testing/benchmarks)
+//   - CallbackTeachingHook: routes to custom callbacks (MCP/voice/aside)
+//   - SingAlongHook: narrates note names/solfege/contour during playback
+// ─────────────────────────────────────────────────────────────────────────────
+// ─── Console Hook (CLI / development) ───────────────────────────────────────
+/**
+ * Logs teaching interjections to the console.
+ * Good for CLI mode and development.
+ */
+export function createConsoleTeachingHook() {
+    return {
+        async onMeasureStart(measureNumber, teachingNote, dynamics) {
+            const parts = [`  [Measure ${measureNumber}]`];
+            if (dynamics)
+                parts.push(`(${dynamics})`);
+            if (teachingNote)
+                parts.push(`— ${teachingNote}`);
+            console.log(parts.join(" "));
+        },
+        async onKeyMoment(moment) {
+            console.log(`  ★ ${moment}`);
+        },
+        async onSongComplete(measuresPlayed, songTitle) {
+            console.log(`\n  ✓ Finished "${songTitle}" — ${measuresPlayed} measures played.`);
+        },
+        async push(interjection) {
+            const prefix = interjection.priority === "high" ? "❗" :
+                interjection.priority === "med" ? "💡" : "ℹ️";
+            console.log(`  ${prefix} ${interjection.text}`);
+        },
+    };
+}
+// ─── Silent Hook (testing) ──────────────────────────────────────────────────
+/**
+ * No-op hook — swallows all interjections.
+ * Use in tests where you don't want console noise.
+ */
+export function createSilentTeachingHook() {
+    return {
+        async onMeasureStart() { },
+        async onKeyMoment() { },
+        async onSongComplete() { },
+        async push() { },
+    };
+}
+/**
+ * Records all teaching events for test assertions.
+ * Use: `const hook = createRecordingTeachingHook(); ... hook.events`
+ */
+export function createRecordingTeachingHook() {
+    const events = [];
+    return {
+        events,
+        async onMeasureStart(measureNumber, teachingNote, dynamics) {
+            events.push({ type: "measure-start", measureNumber, teachingNote, dynamics });
+        },
+        async onKeyMoment(moment) {
+            events.push({ type: "key-moment", moment });
+        },
+        async onSongComplete(measuresPlayed, songTitle) {
+            events.push({ type: "song-complete", measuresPlayed, songTitle });
+        },
+        async push(interjection) {
+            events.push({ type: "push", interjection });
+        },
+    };
+}
+/**
+ * Routes teaching events to custom callbacks.
+ * Use this to wire to mcp-voice-soundboard, mcp-aside, or any other sink.
+ */
+export function createCallbackTeachingHook(callbacks) {
+    return {
+        async onMeasureStart(measureNumber, teachingNote, dynamics) {
+            await callbacks.onMeasureStart?.(measureNumber, teachingNote, dynamics);
+        },
+        async onKeyMoment(moment) {
+            await callbacks.onKeyMoment?.(moment);
+        },
+        async onSongComplete(measuresPlayed, songTitle) {
+            await callbacks.onSongComplete?.(measuresPlayed, songTitle);
+        },
+        async push(interjection) {
+            await callbacks.onPush?.(interjection);
+        },
+    };
+}
+/**
+ * Voice teaching hook — produces VoiceDirective objects routed to a VoiceSink.
+ *
+ * The sink can be:
+ * - A real mcp-voice-soundboard call (via LLM tool routing)
+ * - A console.log wrapper (for CLI testing)
+ * - A recording array (for unit tests)
+ *
+ * Also records all directives for inspection.
+ */
+export function createVoiceTeachingHook(sink, options = {}) {
+    const { voice, speechSpeed = 1.0, speakTeachingNotes = true, speakKeyMoments = true, speakCompletion = true, blockOnKeyMoments = true, } = options;
+    const directives = [];
+    async function emit(directive) {
+        directives.push(directive);
+        await sink(directive);
+    }
+    return {
+        directives,
+        async onMeasureStart(measureNumber, teachingNote, dynamics) {
+            if (!speakTeachingNotes || !teachingNote)
+                return;
+            const dynamicsPart = dynamics ? ` Play ${dynamics}.` : "";
+            await emit({
+                text: `Measure ${measureNumber}.${dynamicsPart} ${teachingNote}`,
+                voice,
+                speed: speechSpeed,
+                blocking: false, // don't block on routine notes
+            });
+        },
+        async onKeyMoment(moment) {
+            if (!speakKeyMoments)
+                return;
+            await emit({
+                text: moment,
+                voice,
+                speed: speechSpeed,
+                blocking: blockOnKeyMoments,
+            });
+        },
+        async onSongComplete(measuresPlayed, songTitle) {
+            if (!speakCompletion)
+                return;
+            await emit({
+                text: `Great work! You finished ${songTitle}. ${measuresPlayed} measures played.`,
+                voice,
+                speed: speechSpeed,
+                blocking: false,
+            });
+        },
+        async push(interjection) {
+            const urgency = interjection.priority === "high" ? "Important: " : "";
+            await emit({
+                text: `${urgency}${interjection.text}`,
+                voice,
+                speed: speechSpeed,
+                blocking: interjection.priority === "high",
+            });
+        },
+    };
+}
+/**
+ * Aside teaching hook — produces AsideDirective objects routed to an AsideSink.
+ *
+ * The sink can be:
+ * - A real mcp-aside push (via aside_push tool)
+ * - A recording array (for tests)
+ *
+ * Records all directives for inspection.
+ */
+export function createAsideTeachingHook(sink, options = {}) {
+    const { pushTeachingNotes = true, pushKeyMoments = true, pushCompletion = true, baseTags = ["piano-teacher"], } = options;
+    const directives = [];
+    async function emit(directive) {
+        directives.push(directive);
+        await sink(directive);
+    }
+    return {
+        directives,
+        async onMeasureStart(measureNumber, teachingNote, dynamics) {
+            if (!pushTeachingNotes || !teachingNote)
+                return;
+            const dynamicsPart = dynamics ? ` (${dynamics})` : "";
+            await emit({
+                text: `Measure ${measureNumber}${dynamicsPart}: ${teachingNote}`,
+                priority: "low",
+                reason: "measure-start",
+                source: `measure-${measureNumber}`,
+                tags: [...baseTags, "teaching-note"],
+            });
+        },
+        async onKeyMoment(moment) {
+            if (!pushKeyMoments)
+                return;
+            await emit({
+                text: moment,
+                priority: "med",
+                reason: "key-moment",
+                tags: [...baseTags, "key-moment"],
+            });
+        },
+        async onSongComplete(measuresPlayed, songTitle) {
+            if (!pushCompletion)
+                return;
+            await emit({
+                text: `Finished "${songTitle}" — ${measuresPlayed} measures played.`,
+                priority: "low",
+                reason: "song-complete",
+                tags: [...baseTags, "completion"],
+            });
+        },
+        async push(interjection) {
+            await emit({
+                text: interjection.text,
+                priority: interjection.priority,
+                reason: interjection.reason,
+                source: interjection.source,
+                tags: [...baseTags, interjection.reason],
+            });
+        },
+    };
+}
+// ─── Sing-Along Hook (note narration) ────────────────────────────────────────
+import { measureToSingableText, } from "./note-parser.js";
+/**
+ * Sing-along teaching hook — narrates note names/solfege/contour/syllables
+ * from the actual measure data, synchronized with playback.
+ *
+ * Requires the full SongEntry to look up measure note data by measure number.
+ * Emits blocking VoiceDirectives on onMeasureStart so the voice speaks BEFORE
+ * the piano plays each measure.
+ *
+ * Composable with other hooks via composeTeachingHooks.
+ */
+export function createSingAlongHook(sink, song, options = {}) {
+    const { mode = "note-names", hand = "right", voice, speechSpeed = 1.0, announceMeasureNumber = true, speakCompletion = true, } = options;
+    const directives = [];
+    // Pre-index measures by number for O(1) lookup
+    const measureMap = new Map();
+    for (const m of song.measures) {
+        measureMap.set(m.number, { rightHand: m.rightHand, leftHand: m.leftHand });
+    }
+    async function emit(directive) {
+        directives.push(directive);
+        await sink(directive);
+    }
+    return {
+        directives,
+        async onMeasureStart(measureNumber, _teachingNote, _dynamics) {
+            const measure = measureMap.get(measureNumber);
+            if (!measure)
+                return;
+            const singableText = measureToSingableText(measure, { mode, hand });
+            if (!singableText)
+                return;
+            const prefix = announceMeasureNumber ? `Measure ${measureNumber}: ` : "";
+            await emit({
+                text: `${prefix}${singableText}`,
+                voice,
+                speed: speechSpeed,
+                blocking: true, // speak BEFORE piano plays
+            });
+        },
+        async onKeyMoment(_moment) {
+            // Sing-along hook does not speak key moments
+            // (compose with a voice hook if you want both)
+        },
+        async onSongComplete(measuresPlayed, songTitle) {
+            if (!speakCompletion)
+                return;
+            await emit({
+                text: `Finished singing along to ${songTitle}! ${measuresPlayed} measures.`,
+                voice,
+                speed: speechSpeed,
+                blocking: false,
+            });
+        },
+        async push(_interjection) {
+            // Sing-along hook does not speak push interjections
+        },
+    };
+}
+// ─── Live Feedback Hook (voice + aside during singing) ───────────────────────
+/** Encouragement phrases keyed by context. */
+const ENCOURAGEMENTS = [
+    "Keep it up!",
+    "Sounding great!",
+    "Nice rhythm!",
+    "Beautiful phrasing!",
+    "You've got this!",
+    "Smooth playing!",
+];
+/** Dynamics-aware aside tips. */
+const DYNAMICS_TIPS = {
+    pp: "Pianissimo — very soft, barely touching the keys.",
+    p: "Piano — play gently, light touch.",
+    mp: "Mezzo-piano — moderately soft, warm tone.",
+    mf: "Mezzo-forte — moderately loud, confident touch.",
+    f: "Forte — play strong, full sound.",
+    ff: "Fortissimo — very loud, powerful!",
+    crescendo: "Building intensity — lean into the crescendo.",
+    decrescendo: "Pulling back — ease off gradually.",
+    dim: "Diminuendo — getting softer, let the sound fade.",
+};
+/**
+ * Live feedback teaching hook — pushes context-aware encouragement and tips
+ * during singing/playback sessions via both voice and aside sinks.
+ *
+ * - Voice: periodic encouragement every N measures + key moment reactions
+ * - Aside: dynamics tips, fingering warnings, deeper contextual notes
+ *
+ * Composable with other hooks via composeTeachingHooks.
+ */
+export function createLiveFeedbackHook(voiceSink, asideSink, song, options = {}) {
+    const { voiceInterval = 4, encourageOnDynamics = true, warnOnDifficult = true, voice, speechSpeed = 1.0, } = options;
+    const voiceDirectives = [];
+    const asideDirectives = [];
+    let measureCount = 0;
+    let lastDynamics;
+    async function emitVoice(directive) {
+        voiceDirectives.push(directive);
+        await voiceSink(directive);
+    }
+    async function emitAside(directive) {
+        asideDirectives.push(directive);
+        await asideSink(directive);
+    }
+    return {
+        voiceDirectives,
+        asideDirectives,
+        async onMeasureStart(measureNumber, teachingNote, dynamics) {
+            measureCount++;
+            // ── Dynamics change → aside tip ──
+            if (encourageOnDynamics && dynamics && dynamics !== lastDynamics) {
+                const tip = DYNAMICS_TIPS[dynamics.toLowerCase()] ??
+                    `${dynamics} — adjust your touch accordingly.`;
+                await emitAside({
+                    text: `Measure ${measureNumber}: ${tip}`,
+                    priority: "low",
+                    reason: "dynamics-change",
+                    source: `measure-${measureNumber}`,
+                    tags: ["piano-teacher", "live-feedback", "dynamics"],
+                });
+            }
+            lastDynamics = dynamics;
+            // ── Difficult passage warning → aside ──
+            if (warnOnDifficult && teachingNote) {
+                const lower = teachingNote.toLowerCase();
+                if (lower.includes("watch") || lower.includes("tricky") ||
+                    lower.includes("careful") || lower.includes("difficult") ||
+                    lower.includes("finger")) {
+                    await emitAside({
+                        text: `Heads up at measure ${measureNumber}: ${teachingNote}`,
+                        priority: "med",
+                        reason: "difficulty-warning",
+                        source: `measure-${measureNumber}`,
+                        tags: ["piano-teacher", "live-feedback", "warning"],
+                    });
+                }
+            }
+            // ── Periodic voice encouragement ──
+            if (voiceInterval > 0 && measureCount % voiceInterval === 0) {
+                const phrase = ENCOURAGEMENTS[measureCount % ENCOURAGEMENTS.length];
+                await emitVoice({
+                    text: phrase,
+                    voice,
+                    speed: speechSpeed,
+                    blocking: false,
+                });
+            }
+        },
+        async onKeyMoment(moment) {
+            await emitVoice({
+                text: `Watch for this: ${moment}`,
+                voice,
+                speed: speechSpeed,
+                blocking: false,
+            });
+        },
+        async onSongComplete(measuresPlayed, songTitle) {
+            await emitVoice({
+                text: `Fantastic work on ${songTitle}! You played through all ${measuresPlayed} measures.`,
+                voice,
+                speed: speechSpeed,
+                blocking: false,
+            });
+            await emitAside({
+                text: `Session complete: ${songTitle} — ${measuresPlayed} measures played. Great practice session!`,
+                priority: "low",
+                reason: "session-complete",
+                tags: ["piano-teacher", "live-feedback", "completion"],
+            });
+        },
+        async push(interjection) {
+            // Route pushes to aside
+            await emitAside({
+                text: interjection.text,
+                priority: interjection.priority,
+                reason: interjection.reason,
+                source: interjection.source,
+                tags: ["piano-teacher", "live-feedback", interjection.reason],
+            });
+        },
+    };
+}
+/**
+ * Compose multiple teaching hooks into one.
+ * Events are dispatched to all hooks in order (serially, not parallel).
+ *
+ * Example: combine a voice hook + aside hook + recording hook for full coverage.
+ */
+export function composeTeachingHooks(...hooks) {
+    return {
+        async onMeasureStart(measureNumber, teachingNote, dynamics) {
+            for (const h of hooks)
+                await h.onMeasureStart(measureNumber, teachingNote, dynamics);
+        },
+        async onKeyMoment(moment) {
+            for (const h of hooks)
+                await h.onKeyMoment(moment);
+        },
+        async onSongComplete(measuresPlayed, songTitle) {
+            for (const h of hooks)
+                await h.onSongComplete(measuresPlayed, songTitle);
+        },
+        async push(interjection) {
+            for (const h of hooks)
+                await h.push(interjection);
+        },
+    };
+}
+// ─── Key Moment Detector ────────────────────────────────────────────────────
+/**
+ * Check if the current measure matches any key moments in the song.
+ * Key moments in ai-music-sheets reference bars like "Bar 1:", "Bars 3-4:", etc.
+ */
+export function detectKeyMoments(song, measureNumber) {
+    const matches = [];
+    for (const km of song.musicalLanguage.keyMoments) {
+        // Match patterns like "Bar 1:", "Bars 1-2:", "Bar 9:"
+        const singleMatch = km.match(/^Bars?\s+(\d+)\s*:/i);
+        const rangeMatch = km.match(/^Bars?\s+(\d+)\s*-\s*(\d+)\s*:/i);
+        if (rangeMatch) {
+            const start = parseInt(rangeMatch[1], 10);
+            const end = parseInt(rangeMatch[2], 10);
+            if (measureNumber >= start && measureNumber <= end) {
+                matches.push(km);
+            }
+        }
+        else if (singleMatch) {
+            const bar = parseInt(singleMatch[1], 10);
+            if (bar === measureNumber) {
+                matches.push(km);
+            }
+        }
+    }
+    return matches;
+}
+//# sourceMappingURL=teaching.js.map

package/dist/teaching.js.map

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

package/dist/test-sound.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node --import tsx
+export {};
+//# sourceMappingURL=test-sound.d.ts.map

package/dist/test-sound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-sound.d.ts","sourceRoot":"","sources":["../src/test-sound.ts"],"names":[],"mappings":""}

package/dist/test-sound.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node --import tsx
+// Quick test: play middle C through the sample engine.
+// Run: node --import tsx src/test-sound.ts
+import { createSampleEngine } from "./sample-engine.js";
+async function main() {
+    const piano = createSampleEngine({
+        samplesDir: "samples/AccurateSalamander",
+    });
+    console.error("Connecting (loading samples)...");
+    await piano.connect();
+    console.error("Playing C4 (middle C) at velocity 80...");
+    piano.noteOn(60, 80);
+    await sleep(2000);
+    piano.noteOff(60);
+    await sleep(1500); // let release ring
+    console.error("Playing C major chord (C4-E4-G4) at velocity 100...");
+    piano.noteOn(60, 100);
+    piano.noteOn(64, 95);
+    piano.noteOn(67, 90);
+    await sleep(3000);
+    piano.noteOff(60);
+    piano.noteOff(64);
+    piano.noteOff(67);
+    await sleep(1500);
+    console.error("Playing scale C4 to C5...");
+    const scale = [60, 62, 64, 65, 67, 69, 71, 72];
+    for (const note of scale) {
+        piano.noteOn(note, 70);
+        await sleep(350);
+        piano.noteOff(note);
+        await sleep(50);
+    }
+    await sleep(2000);
+    console.error("Done. Disconnecting...");
+    await piano.disconnect();
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+main().catch(console.error);
+//# sourceMappingURL=test-sound.js.map

package/dist/test-sound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-sound.js","sourceRoot":"","sources":["../src/test-sound.ts"],"names":[],"mappings":";AACA,uDAAuD;AACvD,2CAA2C;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,kBAAkB,CAAC;QAC/B,UAAU,EAAE,4BAA4B;KACzC,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjD,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IAEtB,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACrB,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAClB,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClB,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB;IAEtC,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACtB,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACrB,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACrB,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAClB,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClB,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClB,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClB,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAElB,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACjB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAElB,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACxC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}