@open-recording/mcp 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import { toNodeHandler } from "@modelcontextprotocol/node";
 import { McpServer, createMcpHandler, hostHeaderValidationResponse, localhostAllowedHostnames, localhostAllowedOrigins, originValidationResponse } from "@modelcontextprotocol/server";
-import { OpsError, cancelRecording, deleteRecording, listRecordings, makeContext, pauseRecording, readNotes, readRecording, readSubtitles, readTranscript, recorderStatus, renameRecording, resumeRecording, searchTranscripts, startRecording, stopRecording, tagRecording, transcribeEnvironment, transcribeRecording, writeNotes } from "@open-recording/core/ops";
+import { OpsError, addBookmark, cancelRecording, deleteBookmark, deleteRecording, editTranscriptSegment, importRecording, listRecordings, makeContext, markRecordingMoment, pauseRecording, readCurrent, readNotes, readRecording, readSubtitles, readTranscript, recorderStatus, renameRecording, resumeRecording, searchTranscripts, startRecording, stopRecording, tagRecording, transcribeEnvironment, transcribeRecording, writeNotes } from "@open-recording/core/ops";
 import { z } from "zod";
 //#region src/tools.ts
 /**
@@ -40,6 +40,11 @@ function registerTools(server, ctx) {
 		description: "Whether anything is recording or paused, and whether a studio page is connected to record through. Check this before starting.",
 		inputSchema: z.object({})
 	}, () => run(() => recorderStatus(ctx)));
+	server.registerTool("current_recording", {
+		title: "Current recording in browser",
+		description: "The recording currently open in the studio browser and its playhead position in milliseconds.",
+		inputSchema: z.object({})
+	}, () => run(() => readCurrent(ctx)));
 	server.registerTool("start_recording", {
 		title: "Start recording",
 		description: "Press record on whatever the studio is holding — a microphone, or a browser tab with its picture and audio. Returns once the studio confirms it is capturing; fails if no studio is connected or nothing is armed. One recording at a time.",
@@ -84,6 +89,31 @@ function registerTools(server, ctx) {
 		description: "Stop the open recording and delete its audio. Use when the recording was a mistake.",
 		inputSchema: z.object({})
 	}, () => run(() => cancelRecording(ctx)));
+	server.registerTool("mark_moment", {
+		title: "Mark a moment in the open recording",
+		description: "Drop a timestamped bookmark on the currently active recording at the current elapsed time.",
+		inputSchema: z.object({ label: z.string().optional().describe("what just happened, e.g. \"Pricing decision\"") })
+	}, ({ label }) => run(() => markRecordingMoment(ctx, label)));
+	server.registerTool("import_recording", {
+		title: "Import external audio or video file",
+		description: "Import an existing media file (.mp3, .m4a, .wav, .mp4, .mov, .webm) from disk into recordings/.",
+		inputSchema: z.object({
+			filePath: z.string().describe("path to the media file on disk"),
+			title: z.string().optional(),
+			tags: z.array(z.string()).optional(),
+			note: z.string().optional(),
+			transcribe: z.boolean().optional(),
+			language: z.string().optional()
+		})
+	}, ({ filePath, title, tags, note, transcribe, language }) => run(() => importRecording(ctx, {
+		filePath,
+		...title ? { title } : {},
+		...tags ? { tags } : {},
+		...note ? { note } : {},
+		...transcribe ? { transcribe } : {},
+		...language ? { language } : {},
+		source: "agent"
+	})));
 	server.registerTool("list_recordings", {
 		title: "List recordings",
 		description: "Every recording with its id, title, length, and whether it has been transcribed.",
@@ -101,11 +131,13 @@ function registerTools(server, ctx) {
 			id: z.string(),
 			language: z.string().optional().describe("language code, or `auto` (the default)"),
 			model: z.string().optional().describe("path to a ggml model, overriding the configured one"),
+			vocabulary: z.array(z.string()).optional().describe("proper nouns and acronyms to normalize across segments"),
 			force: z.boolean().optional()
 		})
-	}, ({ id, language, model, force }) => run(() => transcribeRecording(ctx, id, {
+	}, ({ id, language, model, vocabulary, force }) => run(() => transcribeRecording(ctx, id, {
 		...language ? { language } : {},
 		...model ? { model } : {},
+		...vocabulary ? { vocabulary } : {},
 		...force ? { force } : {}
 	})));
 	server.registerTool("read_transcript", {
@@ -120,6 +152,41 @@ function registerTools(server, ctx) {
 			]).optional()
 		})
 	}, ({ id, view }) => run(() => readTranscript(ctx, id, view ?? "markdown")));
+	server.registerTool("edit_transcript_segment", {
+		title: "Edit transcript segment",
+		description: "Correct a segment’s text, set its speaker label, or star/unstar it. Rewrites Markdown, SRT, and VTT subtitles in sync.",
+		inputSchema: z.object({
+			id: z.string(),
+			index: z.number().int().nonnegative(),
+			text: z.string().optional(),
+			speaker: z.string().nullable().optional(),
+			starred: z.boolean().optional()
+		})
+	}, ({ id, index, text, speaker, starred }) => run(() => editTranscriptSegment(ctx, id, index, {
+		...text !== void 0 ? { text } : {},
+		...speaker !== void 0 ? { speaker } : {},
+		...starred !== void 0 ? { starred } : {}
+	})));
+	server.registerTool("add_bookmark", {
+		title: "Add bookmark",
+		description: "Add a timestamped bookmark to a recording at `atMs` milliseconds.",
+		inputSchema: z.object({
+			id: z.string(),
+			atMs: z.number().nonnegative(),
+			label: z.string()
+		})
+	}, ({ id, atMs, label }) => run(() => addBookmark(ctx, id, {
+		atMs,
+		label
+	})));
+	server.registerTool("delete_bookmark", {
+		title: "Delete bookmark",
+		description: "Remove a bookmark from a recording by its bookmark id.",
+		inputSchema: z.object({
+			id: z.string(),
+			bookmarkId: z.string()
+		})
+	}, ({ id, bookmarkId }) => run(() => deleteBookmark(ctx, id, bookmarkId)));
 	server.registerTool("read_subtitles", {
 		title: "Read subtitles",
 		description: "The transcript as subtitle cues — `srt` for an editor, `vtt` for a player. Written when a recording is transcribed.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-recording/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for open-recording — lets any agent framework press record, stop, transcribe, and read back the transcript.",
   "type": "module",
   "exports": {
@@ -46,13 +46,13 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-recording/core": "^0.2.0"
+    "@open-recording/core": "^0.3.0"
   },
   "devDependencies": {
-    "@types/node": "^22.19.17",
+    "@types/node": "^26.2.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.3",
-    "@open-recording/core": "0.2.0"
+    "@open-recording/core": "0.3.0"
   },
   "scripts": {
     "build": "tsdown",