@withpica/mcp-server/dist/tools/measured-audio.d.ts

MCP Server for withPICA — enables AI assistants to interact with your withPICA music catalog

/**
 * The measured audio facts of one audio file, labelled with units, for the
 * user's own AI to reason over. Read by pica_audio_inspect (analysis section)
 * and pica_recordings_inspect (audio section).
 *
 * Field names match the directory MCP's `measured` block
 * (mcp-server-directory/src/utils/measured.ts): tempo_bpm, key, mode, energy,
 * duration_seconds — plus loudness_lufs here, where the analysis version is
 * known. Keep the two in step — no test enforces it.
 *
 * Analyses before railway-1.1 (2026-10-07) measured energy as RMS capped at
 * 1, which saturated for most masters, and stored a different loudness
 * quantity. `energy_method` says which one a row carries, and loudness_lufs
 * is reported only for rows that measured it.
 */
export declare const MEASURED_AUDIO_BASIS: string;
export type EnergyMethod = "integrated_loudness" | "legacy_rms_capped";
export interface MeasuredAudio {
    tempo_bpm: number | null;
    key: string | null;
    mode: "major" | "minor" | null;
    energy: number | null;
    energy_method: EnergyMethod | null;
    loudness_lufs: number | null;
    duration_seconds: number | null;
    analysis_version: string | null;
}
/** "railway-1.1" → true; "railway-1.0", "1", null → false. */
export declare function measuresLoudness(version: unknown): boolean;
/** From an audio file row with its analysis satellite flattened onto it. */
export declare function toMeasuredAudio(file: Record<string, unknown>): MeasuredAudio;
//# sourceMappingURL=measured-audio.d.ts.map