@mcptoolshop/ai_jam_session 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,229 @@
+import type { SongEntry, Measure } from "./songs/types.js";
+/** MIDI connection status. */
+export type MidiStatus = "disconnected" | "connecting" | "connected" | "error";
+/** Parsed note ready for MIDI output. */
+export interface MidiNote {
+    /** MIDI note number (0-127). Middle C = 60. */
+    note: number;
+    /** Velocity (0-127). 0 = note off. */
+    velocity: number;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** MIDI channel (0-15). Default 0. */
+    channel: number;
+}
+/** A parsed beat within a measure — one or more simultaneous notes. */
+export interface Beat {
+    /** Notes to play simultaneously (chord or single note). */
+    notes: MidiNote[];
+    /** Which hand: "right" or "left". */
+    hand: "right" | "left";
+}
+/** A fully parsed measure ready for playback. */
+export interface PlayableMeasure {
+    /** Original measure data from the song. */
+    source: Measure;
+    /** Right-hand beats in chronological order. */
+    rightBeats: Beat[];
+    /** Left-hand beats in chronological order. */
+    leftBeats: Beat[];
+}
+/** Session state machine. */
+export type SessionState = "idle" | "loaded" | "playing" | "paused" | "finished";
+/** Playback mode. */
+export type PlaybackMode = "full" | "measure" | "hands" | "loop";
+/** Sync mode for voice + piano coordination. */
+export type SyncMode = "concurrent" | "before";
+/** A practice session. */
+export interface Session {
+    /** Unique session ID. */
+    id: string;
+    /** The song being practiced. */
+    song: SongEntry;
+    /** Current session state. */
+    state: SessionState;
+    /** Playback mode. */
+    mode: PlaybackMode;
+    /** Sync mode for voice + piano coordination. */
+    syncMode: SyncMode;
+    /** Current measure index (0-based). */
+    currentMeasure: number;
+    /** Tempo override (BPM). Null = use song's default tempo. */
+    tempoOverride: number | null;
+    /** Speed multiplier (0.5 = half, 1.0 = normal, 2.0 = double). */
+    speed: number;
+    /** Measure range for loop mode [start, end] (1-based, inclusive). */
+    loopRange: [number, number] | null;
+    /** Session start time. */
+    startedAt: Date;
+    /** Total measures played in this session. */
+    measuresPlayed: number;
+    /** Voice feedback enabled. */
+    voiceEnabled: boolean;
+}
+/** Progress update — emitted during playback. */
+export interface PlaybackProgress {
+    /** Current measure (1-based). */
+    currentMeasure: number;
+    /** Total measures in the song. */
+    totalMeasures: number;
+    /** Completion ratio (0.0 – 1.0). */
+    ratio: number;
+    /** Percentage string (e.g. "50%"). */
+    percent: string;
+    /** Elapsed time since playback started (ms). */
+    elapsedMs: number;
+}
+/** Progress callback — called at configurable intervals during playback. */
+export type ProgressCallback = (progress: PlaybackProgress) => void;
+/** Options for creating a new session. */
+export interface SessionOptions {
+    /** Playback mode (default: "full"). */
+    mode?: PlaybackMode;
+    /**
+     * Sync mode for voice + piano coordination (default: "concurrent").
+     * "concurrent" = voice and piano play simultaneously (duet feel).
+     * "before" = voice speaks notes before piano plays (lecture style).
+     */
+    syncMode?: SyncMode;
+    /** Tempo override in BPM (default: song's tempo). */
+    tempo?: number;
+    /**
+     * Speed multiplier (default: 1.0).
+     * 0.5 = half speed (practice slow), 1.0 = normal, 2.0 = double speed.
+     * Stacks with tempo override: effective tempo = (override ?? song.tempo) * speed.
+     */
+    speed?: number;
+    /** Loop range [start, end] for loop mode. */
+    loopRange?: [number, number];
+    /** Enable voice feedback (default: true). */
+    voice?: boolean;
+    /** Teaching hook for interjections during playback. */
+    teachingHook?: TeachingHook;
+    /** Progress callback — called after each measure completes. */
+    onProgress?: ProgressCallback;
+    /**
+     * Progress notification interval (0.0 – 1.0, default: 0.1 = every 10%).
+     * Set to 0 to fire after every measure. Set to 1 to only fire at completion.
+     */
+    progressInterval?: number;
+}
+/** MIDI connection configuration. */
+export interface VmpkConfig {
+    /** MIDI output port name, regex pattern, or "auto" to auto-detect. Default: "auto" */
+    portName: string | RegExp;
+    /** MIDI channel (0-15). Default: 0. */
+    channel: number;
+    /** Default velocity (0-127). Default: 80. */
+    velocity: number;
+}
+/** VMPK connector interface — for DI/testing. */
+export interface VmpkConnector {
+    /** Connect to the MIDI output port. */
+    connect(): Promise<void>;
+    /** Disconnect from the MIDI output port. */
+    disconnect(): Promise<void>;
+    /** Get current connection status. */
+    status(): MidiStatus;
+    /** List available MIDI output ports. */
+    listPorts(): string[];
+    /** Send a note-on message. */
+    noteOn(note: number, velocity: number, channel?: number): void;
+    /** Send a note-off message. */
+    noteOff(note: number, channel?: number): void;
+    /** Send all-notes-off (panic). */
+    allNotesOff(channel?: number): void;
+    /** Play a single MidiNote (note-on, wait, note-off). */
+    playNote(note: MidiNote): Promise<void>;
+}
+/** Warning emitted when a note/measure can't be parsed. */
+export interface ParseWarning {
+    /** Where the error occurred. */
+    location: string;
+    /** The offending token or string. */
+    token: string;
+    /** The error message. */
+    message: string;
+}
+/** Duration suffix → multiplier (relative to quarter note). */
+export declare const DURATION_MAP: Record<string, number>;
+/**
+ * Map from note name to semitone offset from C.
+ * Used for scientific pitch → MIDI number conversion.
+ */
+export declare const NOTE_OFFSETS: Record<string, number>;
+/** Priority level for teaching interjections. */
+export type TeachingPriority = "low" | "med" | "high";
+/** A teaching interjection — something the AI teacher says during practice. */
+export interface TeachingInterjection {
+    /** The text to speak/display. */
+    text: string;
+    /** Priority: low = ambient, med = useful, high = critical instruction. */
+    priority: TeachingPriority;
+    /** Why this interjection was triggered. */
+    reason: "measure-start" | "key-moment" | "style-tip" | "encouragement" | "correction" | "custom";
+    /** Source: which measure or song element triggered this. */
+    source?: string;
+}
+/**
+ * A voice directive — structured request to speak via mcp-voice-soundboard.
+ * The hook produces these; the caller (CLI, LLM, test) routes them to voice_speak.
+ */
+export interface VoiceDirective {
+    /** Text to speak. */
+    text: string;
+    /** Voice preset name (e.g. "narrator", "teacher"). */
+    voice?: string;
+    /** Speed multiplier for speech (0.5–2.0). */
+    speed?: number;
+    /** Whether to wait for speech to finish before continuing playback. */
+    blocking: boolean;
+}
+/** Callback that receives voice directives. */
+export type VoiceSink = (directive: VoiceDirective) => Promise<void>;
+/**
+ * An aside directive — structured request to push to mcp-aside inbox.
+ */
+export interface AsideDirective {
+    /** The text to display. */
+    text: string;
+    /** Priority level. */
+    priority: "low" | "med" | "high";
+    /** Why this was triggered. */
+    reason: string;
+    /** Source context (e.g. "measure-3", "key-moment"). */
+    source?: string;
+    /** Tags for filtering. */
+    tags?: string[];
+}
+/** Callback that receives aside directives. */
+export type AsideSink = (directive: AsideDirective) => Promise<void>;
+/** Options for the live feedback teaching hook. */
+export interface LiveFeedbackHookOptions {
+    /** Emit a voice encouragement every N measures (default: 4). */
+    voiceInterval?: number;
+    /** React to dynamics changes with aside tips (default: true). */
+    encourageOnDynamics?: boolean;
+    /** Warn about difficult passages with voice tips (default: true). */
+    warnOnDifficult?: boolean;
+    /** Voice preset name (default: undefined = server default). */
+    voice?: string;
+    /** Speech speed (default: 1.0). */
+    speechSpeed?: number;
+}
+/**
+ * Teaching hook interface — inject this into sessions to receive
+ * teaching interjections during playback. Implementations can route
+ * to mcp-voice-soundboard, mcp-aside, console, or anything else.
+ */
+export interface TeachingHook {
+    /** Called before a measure plays — opportunity to announce what's coming. */
+    onMeasureStart(measureNumber: number, teachingNote: string | undefined, dynamics: string | undefined): Promise<void>;
+    /** Called when a key moment in the song is reached. */
+    onKeyMoment(moment: string): Promise<void>;
+    /** Called when the song finishes. */
+    onSongComplete(measuresPlayed: number, songTitle: string): Promise<void>;
+    /** Push a custom interjection. */
+    push(interjection: TeachingInterjection): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,22 @@
+// ─── pianoai: Core Types ────────────────────────────────────────────────────
+//
+// Session management, MIDI playback, and teaching interaction types.
+// These bridge ai-music-sheets (the library) with the runtime (MIDI + voice).
+// ─────────────────────────────────────────────────────────────────────────────
+// ─── Note Parsing Types ─────────────────────────────────────────────────────
+/** Duration suffix → multiplier (relative to quarter note). */
+export const DURATION_MAP = {
+    w: 4.0, // whole
+    h: 2.0, // half
+    q: 1.0, // quarter
+    e: 0.5, // eighth
+    s: 0.25, // sixteenth
+};
+/**
+ * Map from note name to semitone offset from C.
+ * Used for scientific pitch → MIDI number conversion.
+ */
+export const NOTE_OFFSETS = {
+    C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,qEAAqE;AACrE,8EAA8E;AAC9E,gFAAgF;AA+NhF,+EAA+E;AAE/E,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,CAAC,EAAE,GAAG,EAAI,QAAQ;IAClB,CAAC,EAAE,GAAG,EAAI,OAAO;IACjB,CAAC,EAAE,GAAG,EAAI,UAAU;IACpB,CAAC,EAAE,GAAG,EAAI,SAAS;IACnB,CAAC,EAAE,IAAI,EAAG,YAAY;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;CAC1C,CAAC"}

package/dist/vmpk.d.ts

@@ -0,0 +1,23 @@
+import type { VmpkConnector, VmpkConfig } from "./types.js";
+/**
+ * Create a MIDI connector.
+ *
+ * With no config (or portName: "auto"), auto-detects the best available
+ * MIDI output — no external software required on Windows.
+ *
+ * For testing, inject a mock VmpkConnector via the Session constructor.
+ */
+export declare function createVmpkConnector(config?: Partial<VmpkConfig>): VmpkConnector;
+/**
+ * Create a mock VMPK connector for testing.
+ * Records all note events without sending any MIDI.
+ */
+export declare function createMockVmpkConnector(): VmpkConnector & {
+    events: Array<{
+        type: string;
+        note?: number;
+        velocity?: number;
+        channel?: number;
+    }>;
+};
+//# sourceMappingURL=vmpk.d.ts.map

package/dist/vmpk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vmpk.d.ts","sourceRoot":"","sources":["../src/vmpk.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAwB,MAAM,YAAY,CAAC;AAqBlF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,OAAO,CAAC,UAAU,CAAM,GAC/B,aAAa,CA4If;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,GAAG;IACzD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrF,CAoDA"}

package/dist/vmpk.js

@@ -0,0 +1,236 @@
+// ─── pianoai: MIDI Connector ─────────────────────────────────────────────────
+//
+// Connects to any available MIDI output using the JZZ library.
+// Auto-detects the best port: prefers loopMIDI/VMPK if present,
+// falls back to the system's built-in MIDI synth (e.g. Microsoft GS
+// Wavetable Synth on Windows). No external software required.
+//
+// Usage:
+//   const midi = createVmpkConnector();         // auto-detect best port
+//   const midi = createVmpkConnector({ portName: /loop/i }); // force specific port
+//   await midi.connect();
+//   midi.noteOn(60, 100);   // middle C
+//   midi.noteOff(60);
+//   await midi.disconnect();
+// ─────────────────────────────────────────────────────────────────────────────
+import JZZ from "jzz";
+/** Default configuration — auto-detect best available MIDI output. */
+const DEFAULT_CONFIG = {
+    portName: "auto",
+    channel: 0,
+    velocity: 80,
+};
+/**
+ * Preferred port patterns, tried in order.
+ * loopMIDI/VMPK first (for users with a full setup), then system synths.
+ */
+const PORT_PREFERENCES = [
+    /loop/i, // loopMIDI Port
+    /vmpk/i, // VMPK direct
+    /wavetable/i, // Microsoft GS Wavetable Synth
+    /synth/i, // Any other software synth
+    /midi/i, // Any port with "MIDI" in the name
+];
+/**
+ * Create a MIDI connector.
+ *
+ * With no config (or portName: "auto"), auto-detects the best available
+ * MIDI output — no external software required on Windows.
+ *
+ * For testing, inject a mock VmpkConnector via the Session constructor.
+ */
+export function createVmpkConnector(config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    let engine = null;
+    let port = null;
+    let currentStatus = "disconnected";
+    let connectedPortName = "";
+    return {
+        async connect() {
+            if (currentStatus === "connected")
+                return;
+            currentStatus = "connecting";
+            try {
+                engine = await JZZ();
+                const ports = listPortsInternal(engine);
+                if (cfg.portName === "auto") {
+                    // Auto-detect: try preferred patterns in order
+                    port = null;
+                    for (const pattern of PORT_PREFERENCES) {
+                        const match = ports.find((p) => pattern.test(p));
+                        if (match) {
+                            try {
+                                port = engine.openMidiOut(match);
+                                connectedPortName = match;
+                                break;
+                            }
+                            catch {
+                                // This port didn't work, try next pattern
+                                continue;
+                            }
+                        }
+                    }
+                    // Last resort: try the first available port
+                    if (!port && ports.length > 0) {
+                        port = engine.openMidiOut(ports[0]);
+                        connectedPortName = ports[0];
+                    }
+                    if (!port) {
+                        throw new Error("No MIDI output ports available");
+                    }
+                }
+                else {
+                    // Specific port requested
+                    port = engine.openMidiOut(cfg.portName);
+                    connectedPortName =
+                        cfg.portName instanceof RegExp
+                            ? (ports.find((p) => cfg.portName.test(p)) ?? cfg.portName.toString())
+                            : String(cfg.portName);
+                }
+                currentStatus = "connected";
+                console.error(`MIDI connected: ${connectedPortName}`);
+            }
+            catch (err) {
+                currentStatus = "error";
+                const portDesc = cfg.portName === "auto"
+                    ? "(auto-detect)"
+                    : cfg.portName instanceof RegExp
+                        ? cfg.portName.toString()
+                        : `"${cfg.portName}"`;
+                throw new Error(`Failed to connect to MIDI output ${portDesc}. ` +
+                    `Available ports: ${listPortsInternal(engine).join(", ") || "(none)"}. ` +
+                    `Error: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+        async disconnect() {
+            if (port) {
+                // Send all-notes-off on all channels before disconnecting
+                for (let ch = 0; ch < 16; ch++) {
+                    try {
+                        port.send([0xB0 + ch, 123, 0]); // CC 123 = All Notes Off
+                    }
+                    catch {
+                        // ignore — port might already be closed
+                    }
+                }
+                try {
+                    port.close();
+                }
+                catch {
+                    // ignore
+                }
+                port = null;
+            }
+            if (engine) {
+                try {
+                    engine.close();
+                }
+                catch {
+                    // ignore
+                }
+                engine = null;
+            }
+            currentStatus = "disconnected";
+        },
+        status() {
+            return currentStatus;
+        },
+        listPorts() {
+            return listPortsInternal(engine);
+        },
+        noteOn(note, velocity, channel) {
+            if (!port || currentStatus !== "connected") {
+                throw new Error("MIDI port not connected");
+            }
+            const ch = channel ?? cfg.channel;
+            port.send([0x90 + ch, note & 0x7F, velocity & 0x7F]);
+        },
+        noteOff(note, channel) {
+            if (!port || currentStatus !== "connected") {
+                throw new Error("MIDI port not connected");
+            }
+            const ch = channel ?? cfg.channel;
+            port.send([0x80 + ch, note & 0x7F, 0]);
+        },
+        allNotesOff(channel) {
+            if (!port || currentStatus !== "connected")
+                return;
+            const ch = channel ?? cfg.channel;
+            port.send([0xB0 + ch, 123, 0]); // CC 123 = All Notes Off
+        },
+        async playNote(midiNote) {
+            if (midiNote.note < 0) {
+                // Rest — just wait
+                await sleep(midiNote.durationMs);
+                return;
+            }
+            this.noteOn(midiNote.note, midiNote.velocity, midiNote.channel);
+            await sleep(midiNote.durationMs);
+            this.noteOff(midiNote.note, midiNote.channel);
+        },
+    };
+}
+/**
+ * Create a mock VMPK connector for testing.
+ * Records all note events without sending any MIDI.
+ */
+export function createMockVmpkConnector() {
+    let status = "disconnected";
+    const events = [];
+    const connector = {
+        events,
+        async connect() {
+            status = "connected";
+            events.push({ type: "connect" });
+        },
+        async disconnect() {
+            status = "disconnected";
+            events.push({ type: "disconnect" });
+        },
+        status() {
+            return status;
+        },
+        listPorts() {
+            return ["Mock Port 1"];
+        },
+        noteOn(note, velocity, channel = 0) {
+            events.push({ type: "noteOn", note, velocity, channel });
+        },
+        noteOff(note, channel = 0) {
+            events.push({ type: "noteOff", note, channel });
+        },
+        allNotesOff(channel = 0) {
+            events.push({ type: "allNotesOff", channel });
+        },
+        async playNote(midiNote) {
+            if (midiNote.note < 0) {
+                events.push({ type: "rest", note: -1 });
+                return; // don't actually sleep in mocks
+            }
+            events.push({
+                type: "playNote",
+                note: midiNote.note,
+                velocity: midiNote.velocity,
+                channel: midiNote.channel,
+            });
+        },
+    };
+    return connector;
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function listPortsInternal(engine) {
+    if (!engine)
+        return [];
+    try {
+        const info = engine.info();
+        const outputs = info.outputs || [];
+        return outputs.map((o) => o.name || o.id || "(unnamed)");
+    }
+    catch {
+        return [];
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=vmpk.js.map

package/dist/vmpk.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@mcptoolshop/ai_jam_session",
+  "version": "0.1.0",
+  "description": "Piano player with built-in audio engine — plays through speakers, no external software required. MCP server + CLI.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "ai-jam-session": "dist/cli.js",
+    "ai-jam-session-mcp": "dist/mcp-server.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "songs/builtin",
+    "README.md",
+    "LICENSE",
+    "logo.png"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/cli.js",
+    "mcp": "node dist/mcp-server.js",
+    "smoke": "node --import tsx src/smoke.ts"
+  },
+  "keywords": [
+    "piano",
+    "audio",
+    "midi",
+    "mcp",
+    "ai",
+    "music",
+    "voice",
+    "web-audio"
+  ],
+  "author": "mcp-tool-shop",
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mcp-tool-shop-org/ai_jam_session.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "jzz": "^1.8.0",
+    "midi-file": "^1.2.4",
+    "node-web-audio-api": "^1.0.8",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19",
+    "typescript": "^5.7",
+    "vitest": "^3.0"
+  }
+}