/**
 * Send MIDI events to the CrossPad simulator via TCP remote control.
 *
 * Supports: note_on, note_off, cc (control change), program_change.
 * Uses the same remote control protocol as other sim commands.
 */
import { z } from "zod";
import type { McpServer, RegisteredTool } from "@modelcontextprotocol/sdk/server/mcp.js";
import type { ToolContext } from "../tool-context.js";
export type MidiEventType = "note_on" | "note_off" | "cc" | "program_change";
export interface MidiSendParams {
    type: MidiEventType;
    channel: number;
    note?: number;
    velocity?: number;
    cc_num?: number;
    value?: number;
    program?: number;
}
export interface MidiSendResult {
    success: boolean;
    type: MidiEventType;
    channel: number;
    details: Record<string, number>;
    error?: string;
}
/**
 * Send a MIDI event to the running simulator.
 */
export declare function crosspadMidiSend(params: MidiSendParams): Promise<MidiSendResult>;
export declare const TOOL_NAME = "crosspad_midi";
/** midi.py MidiRole — which USB MIDI endpoint the frame leaves by. */
export type MidiRole = "esp" | "stm";
export declare const MidiInputShape: {
    target: z.ZodEnum<{
        device: "device";
        sim: "sim";
    }>;
    device: z.ZodOptional<z.ZodString>;
    action: z.ZodOptional<z.ZodEnum<{
        sysex: "sysex";
        note: "note";
        echo_rtt: "echo_rtt";
        query_route: "query_route";
    }>>;
    role: z.ZodOptional<z.ZodEnum<{
        esp: "esp";
        stm: "stm";
    }>>;
    on: z.ZodOptional<z.ZodBoolean>;
    note: z.ZodOptional<z.ZodNumber>;
    vel: z.ZodOptional<z.ZodNumber>;
    channel: z.ZodOptional<z.ZodNumber>;
    frame: z.ZodOptional<z.ZodString>;
    n: z.ZodOptional<z.ZodNumber>;
    type: z.ZodOptional<z.ZodEnum<{
        note_on: "note_on";
        note_off: "note_off";
        cc: "cc";
        program_change: "program_change";
    }>>;
    velocity: z.ZodOptional<z.ZodNumber>;
    cc_num: z.ZodOptional<z.ZodNumber>;
    value: z.ZodOptional<z.ZodNumber>;
    program: z.ZodOptional<z.ZodNumber>;
};
export declare const MidiInput: z.ZodDiscriminatedUnion<[z.ZodObject<{
    target: z.ZodLiteral<"device">;
    device: z.ZodOptional<z.ZodString>;
    action: z.ZodEnum<{
        sysex: "sysex";
        note: "note";
        echo_rtt: "echo_rtt";
        query_route: "query_route";
    }>;
    role: z.ZodOptional<z.ZodEnum<{
        esp: "esp";
        stm: "stm";
    }>>;
    on: z.ZodOptional<z.ZodBoolean>;
    note: z.ZodOptional<z.ZodNumber>;
    vel: z.ZodOptional<z.ZodNumber>;
    channel: z.ZodOptional<z.ZodNumber>;
    frame: z.ZodOptional<z.ZodString>;
    n: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>, z.ZodObject<{
    target: z.ZodLiteral<"sim">;
    type: z.ZodEnum<{
        note_on: "note_on";
        note_off: "note_off";
        cc: "cc";
        program_change: "program_change";
    }>;
    channel: z.ZodDefault<z.ZodNumber>;
    note: z.ZodOptional<z.ZodNumber>;
    velocity: z.ZodOptional<z.ZodNumber>;
    cc_num: z.ZodOptional<z.ZodNumber>;
    value: z.ZodOptional<z.ZodNumber>;
    program: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>], "target">;
export type MidiArgs = z.infer<typeof MidiInput>;
export declare const O_Midi: {
    success: z.ZodBoolean;
    target: z.ZodOptional<z.ZodEnum<{
        device: "device";
        sim: "sim";
    }>>;
    action: z.ZodOptional<z.ZodString>;
    device: z.ZodOptional<z.ZodString>;
    role: z.ZodOptional<z.ZodString>;
    result: z.ZodOptional<z.ZodUnknown>;
    type: z.ZodOptional<z.ZodEnum<{
        note_on: "note_on";
        note_off: "note_off";
        cc: "cc";
        program_change: "program_change";
    }>>;
    channel: z.ZodOptional<z.ZodNumber>;
    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
    ts: z.ZodOptional<z.ZodNumber>;
    resultType: z.ZodOptional<z.ZodString>;
    confirmation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    error: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
        code: z.ZodString;
        message: z.ZodString;
        hint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, z.core.$loose>]>>;
    tool: z.ZodOptional<z.ZodString>;
    hint: z.ZodOptional<z.ZodString>;
};
/** Pure: device-branch args → the daemon op and its args (`device` added by the caller). */
export declare function toMidiOp(args: MidiArgs): {
    op: string;
    args: Record<string, unknown>;
};
export declare function registerMidiTool(server: McpServer, ctx: ToolContext): RegisteredTool;