record_safer_pro_mcp 1.0.0

package/dist/tools/core.js

@@ -0,0 +1,360 @@
+import { z } from "zod";
+import { RecordSaferClient } from "../api-client.js";
+import { handleToolCall } from "../utils.js";
+import { buildToolAnnotations, buildToolMeta } from "./tool-metadata.js";
+export const CORE_TOOL_NAMES = [
+    "list_audio_devices",
+    "start_record_mcp",
+    "get_channels",
+    "get_mix",
+    "get_health",
+    "get_status",
+    "stop_recording",
+    "list_tracks",
+    "list_markers",
+    "add_marker",
+    "rename_channel",
+];
+const START_RECORD_INPUT = {
+    deviceId: z.string().min(1).describe("Input device ID"),
+    sampleRate: z.number().int().positive().optional().describe("Optional desired sample rate. If supplied, it must match the selected device's default/current rate because the current backend cannot switch hardware sample rate during MCP preparation."),
+    bitDepth: z.enum(["16-bit", "24-bit", "32-bit Float"]).optional().describe("Optional recording bit depth; defaults to 24-bit"),
+    audioFormat: z.enum(["wav", "caf"]).describe("Recording file format"),
+    channels: z.array(z.object({
+        id: z.number().int().positive().describe("1-based device channel ID"),
+        name: z.string().optional().describe("Optional post-console channel name to apply after initialization succeeds"),
+        armed: z.boolean().optional().describe("Defaults to true when omitted"),
+    })).min(1).describe("Channels to arm for the prepared session"),
+    outputPath: z.string().optional().describe("Optional output directory; defaults to ~/Desktop"),
+    sessionName: z.string().optional().describe("Optional session folder name"),
+    bufferSize: z.number().int().positive().optional().describe("Optional monitoring buffer size"),
+    userConfirmed: z.boolean().describe("Must be true only after the user explicitly confirms the resolved setup summary"),
+};
+const DEVICE_INFO_SCHEMA = z.object({
+    id: z.string(),
+    name: z.string(),
+    channels: z.number().int().nonnegative(),
+    sampleRates: z.array(z.number().int().positive()),
+    defaultSampleRate: z.number().int().positive(),
+    channelLabels: z.array(z.string()).optional(),
+});
+const START_RECORD_OUTPUT = {
+    success: z.boolean(),
+    page: z.literal("RECORDING"),
+    pageStep: z.number().int(),
+    consoleReady: z.boolean(),
+    usedDefaultOutputPath: z.boolean(),
+    usedDeviceDefaultSampleRate: z.boolean(),
+    usedDefaultBitDepth: z.boolean(),
+    appliedChannelRenames: z.number().int().nonnegative(),
+    outputPath: z.string(),
+    deviceId: z.string(),
+    requestedSampleRate: z.number().int().positive().nullable(),
+    requestedBitDepth: z.enum(["16-bit", "24-bit", "32-bit Float"]),
+    effectiveSampleRate: z.number().int().positive(),
+    effectiveBitDepth: z.string(),
+    audioFormat: z.enum(["wav", "caf"]),
+    sessionName: z.string().nullable().optional(),
+    channels: z.array(z.object({
+        id: z.number().int().positive(),
+        name: z.string(),
+        armed: z.boolean(),
+        deviceChannelLabel: z.string().optional(),
+        color: z.string().optional(),
+    })),
+};
+const MCP_CHANNELS_OUTPUT = {
+    ready: z.boolean(),
+    recording: z.boolean(),
+    deviceName: z.string().optional(),
+    channels: z.array(z.object({
+        id: z.number().int().positive(),
+        name: z.string(),
+        deviceChannelLabel: z.string().optional(),
+    })).optional(),
+};
+const MCP_MIX_OUTPUT = {
+    ready: z.boolean(),
+    recording: z.boolean(),
+    safeMode: z.boolean(),
+    channels: z.array(z.object({
+        id: z.number().int().positive(),
+        name: z.string(),
+        volume: z.number(),
+        pan: z.number(),
+        mute: z.boolean(),
+        solo: z.boolean(),
+        phaseInvert: z.boolean(),
+        msProcess: z.boolean().optional(),
+    })).optional(),
+};
+const MCP_HEALTH_OUTPUT = {
+    ready: z.boolean(),
+    recording: z.boolean(),
+    duration: z.number().nonnegative(),
+    cpuLoad: z.number(),
+    diskFreeGB: z.number(),
+    bufferHealth: z.string(),
+    deviceAlive: z.boolean(),
+    safeMode: z.boolean(),
+    alerts: z.array(z.string()),
+};
+const MCP_STATUS_OUTPUT = {
+    ready: z.boolean(),
+    recording: z.boolean(),
+    duration: z.number().nonnegative(),
+};
+const TRACK_INFO_SCHEMA = z.object({
+    id: z.string(),
+    name: z.string(),
+    status: z.string(),
+});
+const MARKER_INFO_SCHEMA = z.object({
+    id: z.number().int().nonnegative(),
+    label: z.string(),
+    timestamp: z.number().nonnegative(),
+});
+export function registerCoreTools(server) {
+    const client = new RecordSaferClient();
+    server.registerTool("start_record_mcp", {
+        title: "Prepare Recording Console",
+        description: `Use this when the user has approved a complete recording setup and you need to initialize a session and jump the app into the recording console.
+
+This prepares the recording console for manual record-start. It does NOT start recording.
+Always present the fully resolved setup summary first, then call this tool only after explicit user confirmation.
+
+Required before execution:
+- deviceId: input device ID
+- audioFormat: wav or caf
+- channels: non-empty array of armed channel objects
+- userConfirmed: must be true only after the user explicitly confirms the final setup summary
+
+Optional with user-approved defaults:
+- sampleRate: when omitted, the device's default/current rate is used
+- bitDepth: defaults to 24-bit when omitted
+- outputPath: defaults to ~/Desktop when omitted
+- sessionName: recording folder name prefix
+- bufferSize: studio-mode buffer hint
+
+Important sequencing note:
+- If channels[].name is provided, MCP must initialize the session first and only then apply channel renames after the recording console is ready.`,
+        inputSchema: START_RECORD_INPUT,
+        outputSchema: START_RECORD_OUTPUT,
+        annotations: buildToolAnnotations("write", {
+            title: "Prepare Recording Console",
+            destructive: false,
+            idempotent: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Preparing console",
+            invoked: "Console ready",
+        }),
+    }, async (params) => handleToolCall("start_record_mcp", "write", () => client.startRecordMcp(params), client));
+    server.registerTool("list_audio_devices", {
+        title: "List Audio Devices",
+        description: `Use this when you need to resolve a device name into a deviceId before console preparation.
+
+Lists currently available audio input devices only. This tool should not be used to start or initialize a recording session.`,
+        inputSchema: {},
+        outputSchema: {
+            devices: z.array(DEVICE_INFO_SCHEMA),
+        },
+        annotations: buildToolAnnotations("read", {
+            title: "List Audio Devices",
+            destructive: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Listing devices",
+            invoked: "Devices listed",
+        }),
+    }, async () => handleToolCall("list_audio_devices", "read", async () => ({ devices: await client.listDevices({ allowAutoLaunch: false }) }), client));
+    server.registerTool("get_channels", {
+        title: "Get Channels",
+        description: `Use this when the recording console is ready and you need channel IDs or existing names before rename operations.
+
+Returns the current session channel IDs, channel names, and device channel labels.`,
+        inputSchema: {},
+        outputSchema: MCP_CHANNELS_OUTPUT,
+        annotations: buildToolAnnotations("read", {
+            title: "Get Channels",
+            destructive: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Loading channels",
+            invoked: "Channels ready",
+        }),
+    }, async () => handleToolCall("get_channels", "read", () => client.getMcpChannels({ allowAutoLaunch: false }), client));
+    server.registerTool("get_mix", {
+        title: "Get Mix Snapshot",
+        description: `Use this when you need a safe-mode aware mix snapshot before monitoring or mix decisions.
+
+Returns whether the session is ready, whether recording is active, whether safe mode is enabled, and the current per-channel mix state.`,
+        inputSchema: {},
+        outputSchema: MCP_MIX_OUTPUT,
+        annotations: buildToolAnnotations("read", {
+            title: "Get Mix Snapshot",
+            destructive: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Loading mix",
+            invoked: "Mix ready",
+        }),
+    }, async () => handleToolCall("get_mix", "read", () => client.getMcpMix({ allowAutoLaunch: false }), client));
+    server.registerTool("get_health", {
+        title: "Get Health Snapshot",
+        description: `Use this when you need a high-level recording-system health snapshot for troubleshooting or risk checks.
+
+Returns duration, CPU load, disk space, buffer health, device health, safe-mode status, and alert codes.`,
+        inputSchema: {},
+        outputSchema: MCP_HEALTH_OUTPUT,
+        annotations: buildToolAnnotations("read", {
+            title: "Get Health Snapshot",
+            destructive: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Checking health",
+            invoked: "Health ready",
+        }),
+    }, async () => handleToolCall("get_health", "read", () => client.getMcpHealth({ allowAutoLaunch: false }), client));
+    server.registerTool("get_status", {
+        title: "Get Recording Status",
+        description: `Use this before lightweight actions such as add_marker or stop_recording.
+
+Returns the minimal recording-ready state without changing the session.`,
+        inputSchema: {},
+        outputSchema: MCP_STATUS_OUTPUT,
+        annotations: buildToolAnnotations("read", {
+            title: "Get Recording Status",
+            destructive: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Checking status",
+            invoked: "Status ready",
+        }),
+    }, async () => handleToolCall("get_status", "read", () => client.getMcpStatus({ allowAutoLaunch: false }), client));
+    server.registerTool("stop_recording", {
+        title: "Stop Recording",
+        description: `Use this only when the user explicitly wants to stop the active recording.
+
+This action stops the current recording and closes output files. It is irreversible and requires explicit user confirmation in the current turn.`,
+        inputSchema: {
+            userConfirmed: z.boolean().describe("Must be true only after the user explicitly confirms stopping the active recording"),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+        annotations: buildToolAnnotations("recording_control", {
+            title: "Stop Recording",
+            destructive: true,
+            idempotent: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Stopping recording",
+            invoked: "Recording stopped",
+        }),
+    }, async ({ userConfirmed }) => handleToolCall("stop_recording", "recording_control", () => client.stopRecording({ userConfirmed }), client));
+    server.registerTool("list_tracks", {
+        title: "List Tracks",
+        description: `Use this when recording is in progress or finished and you need the available track list.
+
+Prerequisite: the session is initialized and track metadata is available.`,
+        inputSchema: {},
+        outputSchema: {
+            tracks: z.array(TRACK_INFO_SCHEMA),
+        },
+        annotations: buildToolAnnotations("read", {
+            title: "List Tracks",
+            destructive: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Listing tracks",
+            invoked: "Tracks listed",
+        }),
+    }, async () => handleToolCall("list_tracks", "read", async () => ({ tracks: await client.listTracks({ allowAutoLaunch: false }) }), client));
+    server.registerTool("list_markers", {
+        title: "List Markers",
+        description: `Use this when you need all marker points from the current recording session.
+
+Prerequisite: recording is in progress or marker metadata already exists for the session.`,
+        inputSchema: {},
+        outputSchema: {
+            markers: z.array(MARKER_INFO_SCHEMA),
+        },
+        annotations: buildToolAnnotations("read", {
+            title: "List Markers",
+            destructive: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Listing markers",
+            invoked: "Markers listed",
+        }),
+    }, async () => handleToolCall("list_markers", "read", async () => ({ markers: await client.listMarkers({ allowAutoLaunch: false }) }), client));
+    server.registerTool("add_marker", {
+        title: "Add Marker",
+        description: `Use this when the user explicitly wants to add a marker at the current recording position.
+
+label is optional; when provided, MCP first creates the marker at the current position and then immediately applies the requested label.`,
+        inputSchema: {
+            label: z.string().optional().describe("Optional marker label"),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            id: z.number().int().nonnegative(),
+            timestamp: z.number().nonnegative(),
+            label: z.string(),
+            time: z.string().optional(),
+        },
+        annotations: buildToolAnnotations("write", {
+            title: "Add Marker",
+            destructive: false,
+            idempotent: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Adding marker",
+            invoked: "Marker added",
+        }),
+    }, async ({ label }) => handleToolCall("add_marker", "write", () => client.addMarker(label), client));
+    server.registerTool("rename_channel", {
+        title: "Rename Channel",
+        description: `Use this when the recording console is ready and the user explicitly wants to rename a channel.
+
+Call get_channels first, then use channels[].id as the required channel ID. Do not rename channels before the console is ready.`,
+        inputSchema: {
+            id: z.string().min(1).describe("Channel ID from get_channels"),
+            name: z.string().min(1).describe("New channel name"),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            channelId: z.string(),
+            name: z.string(),
+        },
+        annotations: buildToolAnnotations("write", {
+            title: "Rename Channel",
+            destructive: false,
+            idempotent: false,
+            openWorld: false,
+        }),
+        _meta: buildToolMeta({
+            invoking: "Renaming channel",
+            invoked: "Channel renamed",
+        }),
+    }, async ({ id, name }) => handleToolCall("rename_channel", "write", async () => {
+        await client.renameChannel(id, name);
+        return {
+            success: true,
+            channelId: id,
+            name,
+        };
+    }, client));
+}
+//# sourceMappingURL=core.js.map

package/dist/tools/core.js.map

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

package/dist/tools/devices.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 设备管理 Tools — 音频设备查询与电平监控
+ * Device Management Tools — Audio device queries and level monitoring
+ *
+ * 这些是只读查询工具，无前置依赖，随时可调用。
+ * These are read-only query tools with no prerequisites.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDeviceTools(server: McpServer): void;
+//# sourceMappingURL=devices.d.ts.map

package/dist/tools/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../src/tools/devices.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAqFpD"}

package/dist/tools/devices.js

@@ -0,0 +1,53 @@
+/**
+ * 设备管理 Tools — 音频设备查询与电平监控
+ * Device Management Tools — Audio device queries and level monitoring
+ *
+ * 这些是只读查询工具，无前置依赖，随时可调用。
+ * These are read-only query tools with no prerequisites.
+ */
+import { z } from "zod";
+import { RecordSaferClient } from "../api-client.js";
+import { handleToolCall } from "../utils.js";
+const deviceIdSchema = {
+    deviceId: z.string().min(1).describe("Device ID"),
+};
+export function registerDeviceTools(server) {
+    const client = new RecordSaferClient();
+    server.tool("list_audio_devices", `[Pre-Recording Phase] List all audio input devices [read].
+
+Response fields:
+- id: unique device identifier for subsequent device-specific calls
+- name: user-facing device name (prefer this in responses)
+- channels: available channel count
+- defaultSampleRate: device default sample rate
+- channelLabels: per-channel labels
+
+Use cases:
+- User asks which interfaces/devices are connected
+- Need device selection input for setup-related tasks
+- Troubleshooting device recognition issues`, {}, async () => handleToolCall("list_audio_devices", "read", () => client.listDevices(), client));
+    server.tool("list_output_devices", "List all audio output devices [read]. Returns monitor output devices with channelCount and isDefault flags.", {}, async () => handleToolCall("list_output_devices", "read", () => client.listOutputDevices(), client));
+    server.tool("get_buffer_sizes", `Get supported buffer sizes for a device [read].
+Prerequisite: provide deviceId from list_audio_devices.
+If sampleRate is supplied, latency is calculated against that rate.`, {
+        ...deviceIdSchema,
+        sampleRate: z.number().int().positive().optional().describe("Optional sample rate used to calculate latencyMs"),
+    }, async ({ deviceId, sampleRate }) => handleToolCall("get_buffer_sizes", "read", () => client.getBufferSizes(deviceId, sampleRate), client));
+    server.tool("get_device_signals", `Get device signal information [read].
+Prerequisite: provide deviceId from list_audio_devices.
+Use case: troubleshooting whether the device has input signal.
+If sampleRate is supplied, the backend uses it when probing the device.`, {
+        ...deviceIdSchema,
+        sampleRate: z.number().int().positive().optional().describe("Optional probe sample rate"),
+    }, async ({ deviceId, sampleRate }) => handleToolCall("get_device_signals", "read", () => client.getDeviceSignals(deviceId, sampleRate), client));
+    server.tool("get_device_levels", `Get real-time device level data [read].
+Prerequisite: provide deviceId from list_audio_devices.
+Returns normalized hardware-order levels (0.0-1.0), not dBFS values.
+Note: this starts level monitoring; call stop_level_monitoring afterward to release resources.`, {
+        ...deviceIdSchema,
+        sampleRate: z.number().int().positive().optional().describe("Optional sample rate for engine setup"),
+        bufferSize: z.number().int().positive().optional().describe("Optional buffer size hint for engine setup"),
+    }, async ({ deviceId, sampleRate, bufferSize }) => handleToolCall("get_device_levels", "read", () => client.getDeviceLevels(deviceId, { sampleRate, bufferSize }), client));
+    server.tool("stop_level_monitoring", "Stop level monitoring [write]. ⚠️ This changes monitoring state and requires explicit user confirmation.", {}, async () => handleToolCall("stop_level_monitoring", "write", () => client.stopLevelMonitoring(), client));
+}
+//# sourceMappingURL=devices.js.map

package/dist/tools/devices.js.map

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

package/dist/tools/levels.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 电平监控 Tools — 电平订阅与回调控制
+ * Level Monitoring Tools — Level subscription and callback control
+ *
+ * 【说明】这些工具控制 WebSocket 电平数据流和电平计算引擎。
+ * 通常由前端 GUI 自动管理，MCP 场景下较少直接使用。
+ * 主要用于故障诊断或特殊需求（如安全模式下禁用电平计算以提升录音稳定性）。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLevelTools(server: McpServer): void;
+//# sourceMappingURL=levels.d.ts.map

package/dist/tools/levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.d.ts","sourceRoot":"","sources":["../../src/tools/levels.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA4CnD"}

package/dist/tools/levels.js

@@ -0,0 +1,25 @@
+/**
+ * 电平监控 Tools — 电平订阅与回调控制
+ * Level Monitoring Tools — Level subscription and callback control
+ *
+ * 【说明】这些工具控制 WebSocket 电平数据流和电平计算引擎。
+ * 通常由前端 GUI 自动管理，MCP 场景下较少直接使用。
+ * 主要用于故障诊断或特殊需求（如安全模式下禁用电平计算以提升录音稳定性）。
+ */
+import { z } from "zod";
+import { RecordSaferClient } from "../api-client.js";
+import { handleToolCall } from "../utils.js";
+export function registerLevelTools(server) {
+    const client = new RecordSaferClient();
+    server.tool("subscribe_levels", "Subscribe to WebSocket level updates [write]. ⚠️ This starts the level data stream and requires explicit user confirmation. The backend can infer session context, but you may also provide device/sample-rate details for pre-recording diagnostics.", {
+        deviceId: z.string().min(1).optional().describe("Optional device ID for pre-recording diagnostics"),
+        channelCount: z.number().int().positive().optional().describe("Optional channel count override"),
+        sampleRate: z.number().int().positive().optional().describe("Optional sample rate for engine setup"),
+    }, async ({ deviceId, channelCount, sampleRate }) => handleToolCall("subscribe_levels", "write", () => client.subscribeLevels({ deviceId, channelCount, sampleRate }), client));
+    server.tool("unsubscribe_levels", "Unsubscribe from level updates [write]. ⚠️ This stops the level data stream and requires explicit user confirmation.", {}, async () => handleToolCall("unsubscribe_levels", "write", () => client.unsubscribeLevels(), client));
+    server.tool("disable_level_callback", `Disable level calculation (Safe Mode) [write].
+⚠️ This disables level calculation to improve recording stability and requires explicit user confirmation.
+Use case: if recording stutters or buffer issues occur, disable level callbacks to reduce CPU load.`, {}, async () => handleToolCall("disable_level_callback", "write", () => client.disableLevelCallback(), client));
+    server.tool("enable_level_callback", "Enable level calculation [write]. ⚠️ This enables level callbacks and requires explicit user confirmation.", {}, async () => handleToolCall("enable_level_callback", "write", () => client.enableLevelCallback(), client));
+}
+//# sourceMappingURL=levels.js.map

package/dist/tools/levels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.js","sourceRoot":"","sources":["../../src/tools/levels.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAEvC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,uPAAuP,EACvP;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QACnG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAChG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACrG,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE,CAC/C,cAAc,CAAC,kBAAkB,EAAE,OAAO,EAAE,GAAG,EAAE,CAC/C,MAAM,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,CAC5E,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,sHAAsH,EACtH,EAAE,EACF,KAAK,IAAI,EAAE,CACT,cAAc,CAAC,oBAAoB,EAAE,OAAO,EAAE,GAAG,EAAE,CACjD,MAAM,CAAC,iBAAiB,EAAE,EAAE,MAAM,CAAC,CACxC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB;;oGAEgG,EAChG,EAAE,EACF,KAAK,IAAI,EAAE,CACT,cAAc,CAAC,wBAAwB,EAAE,OAAO,EAAE,GAAG,EAAE,CACrD,MAAM,CAAC,oBAAoB,EAAE,EAAE,MAAM,CAAC,CAC3C,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,4GAA4G,EAC5G,EAAE,EACF,KAAK,IAAI,EAAE,CACT,cAAc,CAAC,uBAAuB,EAAE,OAAO,EAAE,GAAG,EAAE,CACpD,MAAM,CAAC,mBAAmB,EAAE,EAAE,MAAM,CAAC,CAC1C,CAAC;AACJ,CAAC"}

package/dist/tools/markers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 轨道与标记 Tools — 轨道管理与标记点操作
+ * Track & Marker Tools — Track management and marker operations
+ *
+ * 【MCP 高价值场景】
+ * 录音中添加标记是 MCP 最自然的使用场景之一：
+ * - 用户说"标记一下，这是副歌" → add_marker(label: "副歌")
+ * - 用户说"加个标记" → add_marker()（自动编号）
+ * 比在 GUI 上点击按钮再输入名称更快。
+ *
+ * 【前置依赖】标记操作需要录音正在进行中。
+ * 通道重命名和颜色设置需要会话已初始化。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function normalizeChannelColorInput(input: string): string;
+export declare function registerMarkerTools(server: McpServer): void;
+//# sourceMappingURL=markers.d.ts.map

package/dist/tools/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../src/tools/markers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBpE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAuChE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAuIpD"}