@bli-cockpit/mcp 0.1.98 → 0.1.99

package/dist/notes-tools.js

@@ -110,7 +110,7 @@ export function registerNotesTools(server, deps) {
         }
         const invited = note.participants.length > 0 ? `\nInvited: ${note.participants.join(", ")}` : "";
         return textResult(`${note.title}\n${note.meetingDate}  ·  ${note.shelf}  ·  ${note.fileName}  ·  ${note.lineCount} lines`
-            + `${invited}\n${note.visibility}${body.audio ? "\nTranscription: " + body.audio.transcription_status : ""}\n\n${note.content}${narrowingNote(body)}`, { scope: body.scope ?? null, note, audio: body.audio ?? null });
+            + `${invited}\n${note.visibility}${body.audio ? "\nTranscription: " + body.audio.transcription_status + (body.audio.transcription_detail ? ` (${body.audio.transcription_detail})` : "") : ""}\n\n${note.content}${narrowingNote(body)}`, { scope: body.scope ?? null, note, audio: body.audio ?? null });
     }));
     register("notes_shelf", {
         title: "Your own Tower notes shelf",

package/dist/notes-write-tools.js

@@ -25,14 +25,26 @@
  * it manages to send one. An MCP client's own deadline may still be shorter —
  * the description says so rather than letting a cut call read as a refusal.
  */
+import { createReadStream } from "node:fs";
 import { readFile, stat } from "node:fs/promises";
 import path from "node:path";
+import { Readable } from "node:stream";
 import { isSecretLikePathSegment } from "@bli-cockpit/telemetry-core";
 import { z } from "zod";
 import { callAgentDoor } from "./agent-door.js";
 import { CONFIRM_INPUT, doorFailureText, errorResult, registrarFor, textResult, unconfirmed, withSession, } from "./tool-result.js";
 /** Mirrors `UPLOADED_NOTE_MAX_BYTES`; a courtesy check, not a second authority. */
 export const NOTE_FILE_MAX_BYTES = 20 * 1024 * 1024;
+/**
+ * Audio over this goes straight to storage and is transcribed in the
+ * background (BLI-12963); at or under it, the upload route takes it. Mirrors
+ * `AUDIO_MAX_BYTES` in the dashboard's `lib/notes/audio.ts`.
+ */
+const AUDIO_INLINE_MAX_BYTES = 4_000_000;
+/** Mirrors the bucket's `file_size_limit`. */
+const AUDIO_DIRECT_MAX_BYTES = 1_000_000_000;
+/** A signed upload URL lives two hours. */
+const STORAGE_PUT_DEADLINE_MS = 2 * 60 * 60 * 1000;
 /** The route's own ceiling is 300 s. Wait past it so its sentence wins. */
 const UPLOAD_DEADLINE_MS = 305_000;
 const WRITE_DEADLINE_MS = 60_000;
@@ -77,13 +89,18 @@ async function readNoteFile(filePath) {
     }
     if (size === 0)
         return refuse("file_empty");
-    if (/\.(mp3|m4a|wav|webm|ogg)$/i.test(fileName) && size > 4_000_000) {
-        return { ok: false, refusal: "file_too_big", sentence: "file_too_large: Audio is limited to 4 MB (4,000,000 bytes)." };
+    if (/\.(mp3|m4a|wav|webm|ogg)$/i.test(fileName)) {
+        if (size > AUDIO_DIRECT_MAX_BYTES) {
+            return { ok: false, refusal: "file_too_big", sentence: "file_too_large: Audio is limited to 1 GB (1,000,000,000 bytes)." };
+        }
+        // Big audio is never read into memory; the upload streams it from disk.
+        if (size > AUDIO_INLINE_MAX_BYTES)
+            return { ok: true, bytes: Buffer.alloc(0), fileName, size, direct: true };
     }
-    if (size > NOTE_FILE_MAX_BYTES)
+    else if (size > NOTE_FILE_MAX_BYTES)
         return refuse("file_too_big");
     try {
-        return { ok: true, bytes: await readFile(filePath), fileName };
+        return { ok: true, bytes: await readFile(filePath), fileName, size, direct: false };
     }
     catch {
         return refuse("file_unreadable");
@@ -108,11 +125,59 @@ async function postForm(deps, session, tool, form) {
         ? textResult(text, { ok: true, noteId: body.noteId ?? null, scope: body.scope ?? null, transcription: body.transcription ?? null })
         : errorResult(text);
 }
+/**
+ * A whole-meeting recording: signed URL from Tower, the file streamed from disk
+ * to storage, then Tower told it is there (BLI-12963). Tower transcribes it in
+ * the background; poll notes_show for `transcription_detail` and the final
+ * transcript. The storage PUT carries the signed URL only, never the device
+ * token.
+ */
+async function postAudioDirect(deps, session, read, filePath, mediaType, extras) {
+    const target = await callAgentDoor(session, deps.fetchImpl, "POST", "/api/notes/audio/target", { file_name: read.fileName, bytes: read.size, media_type: mediaType }, WRITE_DEADLINE_MS);
+    if (!target.ok)
+        return errorResult(doorFailureText("notes_upload", target));
+    const issued = target.body;
+    if (!issued.objectKey || !issued.upload?.url) {
+        return errorResult("Refused (target_unreadable): Tower answered without an upload link. Nothing was stored.");
+    }
+    let put;
+    try {
+        put = await deps.fetchImpl(issued.upload.url, {
+            method: issued.upload.method ?? "PUT",
+            headers: { ...(issued.upload.headers ?? {}), "content-length": String(read.size) },
+            body: Readable.toWeb(createReadStream(filePath)),
+            duplex: "half",
+            signal: AbortSignal.timeout(STORAGE_PUT_DEADLINE_MS),
+        });
+    }
+    catch (error) {
+        console.error("[notes_upload] storage put failed", JSON.stringify({ reason: "storage_unreachable", bytes: read.size, error_name: error?.name ?? "Error" }));
+        return errorResult("Refused (storage_unreachable): could not reach storage to upload the file. Nothing was saved; try again.");
+    }
+    if (!put.ok) {
+        console.error("[notes_upload] storage put refused", JSON.stringify({ reason: `storage_http_${put.status}`, bytes: read.size }));
+        return errorResult(put.status === 413
+            ? "Refused (storage_http_413): storage refused the file as too large. An admin may need to raise the project's storage file size limit."
+            : `Refused (storage_http_${put.status}): storage refused the upload. Nothing was saved; try again.`);
+    }
+    const saved = await callAgentDoor(session, deps.fetchImpl, "POST", "/api/notes/audio/saved", {
+        object_key: issued.objectKey, file_name: read.fileName,
+        ...(extras.exclude ? { exclusions: extras.exclude } : {}),
+        ...(extras.folder ? { folder_path: extras.folder } : {}),
+    }, WRITE_DEADLINE_MS);
+    if (!saved.ok)
+        return errorResult(doorFailureText("notes_upload", saved));
+    const body = saved.body;
+    const text = saidByTower(body);
+    return body.stored === true
+        ? textResult(text, { ok: true, noteId: body.noteId ?? null, scope: body.scope ?? null, transcription: body.transcription ?? null })
+        : errorResult(text);
+}
 export function registerNotesWriteTools(server, deps) {
     const register = registrarFor(server);
     register("notes_upload", {
         title: "Put a local file in as a Tower meeting note",
-        description: "Uploads a transcript, note, or MP3/M4A/WAV/WebM/OGG audio file from this machine. Audio is limited to 4 MB and returns a note id plus transcription status immediately. Poll notes_show for completion. "
+        description: "Uploads a transcript, note, or MP3/M4A/WAV/WebM/OGG audio file from this machine. Audio up to 4 MB goes through the upload door; a longer recording (up to 1 GB, a whole meeting) is sent straight to storage and transcribed in the background. Either way it returns a note id plus transcription status immediately. Poll notes_show for completion and progress (a long meeting takes several minutes). "
             + "A name that looks like a key or credential file is refused without being opened; so is a missing, empty or "
             + "over-20-MB file. Tower reads the whole note with one model call, so a large file can take a couple of "
             + "minutes and your client may give up first — the upload keeps going; notes_list will show it.",
@@ -131,9 +196,15 @@ export function registerNotesWriteTools(server, deps) {
         const read = await readNoteFile(filePath);
         if (!read.ok)
             return errorResult(`Refused (${read.refusal}): ${read.sentence} Nothing was sent.`);
-        const form = new FormData();
         const audioTypes = { mp3: "audio/mpeg", m4a: "audio/mp4", wav: "audio/wav", webm: "audio/webm", ogg: "audio/ogg" };
         const mediaType = audioTypes[path.extname(read.fileName).slice(1).toLowerCase()] ?? "";
+        if (read.direct) {
+            return postAudioDirect(deps, session, read, filePath, mediaType, {
+                ...(args.exclude ? { exclude: String(args.exclude) } : {}),
+                ...(args.folder ? { folder: String(args.folder) } : {}),
+            });
+        }
+        const form = new FormData();
         form.set("file", new File([new Uint8Array(read.bytes)], read.fileName, { type: mediaType }));
         if (args.exclude)
             form.set("exclusions", String(args.exclude));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/mcp",
-  "version": "0.1.98",
+  "version": "0.1.99",
   "private": false,
   "description": "bli-tower: an MCP server over BLI Cockpit's agent doors: JARVIS (jarvis_*), documents (docs_*), channels (msg_*), issues (work_*), the daily page (brief_*), meeting notes (notes_*), the ops board (ops_status/slack_*), settings/team/model, Scout and the workbook, plus the legacy event-stream tools (emit_event, get_ticket_timeline, get_active_tickets).",
   "type": "module",