@bli-cockpit/mcp 0.1.109 → 0.1.111

package/README.md

@@ -109,7 +109,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**138 of 143 Tower verbs have an MCP twin.**
+**147 of 152 Tower verbs have an MCP twin.**
 Each tool goes through the SAME door its CLI verb calls, with the same
 collector device token — never a second route and never a service-role
 reader. `src/verb-census.test.ts` fails when a verb is in none of the
@@ -117,6 +117,7 @@ three tables below.
 
 | CLI verb | MCP tool | Door |
 | --- | --- | --- |
+| `cockpit brain retry` | `brain_retry` | `POST /api/brain/incidents/retry` |
 | `cockpit brain status` | `brain_status` | `GET /api/brain/incidents` |
 | `cockpit brief done` | `brief_done` | `POST /api/jarvis/ticks` |
 | `cockpit brief history` | `brief_history` | `GET /api/jarvis/brief?history=1` |
@@ -125,6 +126,8 @@ three tables below.
 | `cockpit brief status` | `brief_status` | `GET /api/ops/brief-status` |
 | `cockpit brief undone` | `brief_undone` | `POST /api/jarvis/ticks` |
 | `cockpit cal calendars` | `cal_calendars` | `GET /api/cal/calendars` |
+| `cockpit cal cancel` | `cal_delete` | `DELETE /api/cal/events/[eventId]` |
+| `cockpit cal change` | `cal_change` | `PATCH /api/cal/events/[eventId]` |
 | `cockpit cal create` | `cal_create` | `POST /api/cal/events` |
 | `cockpit cal delete` | `cal_delete` | `DELETE /api/cal/events/[eventId]` |
 | `cockpit cal detach` | `cal_detach` | `DELETE /api/cal/calendars` |
@@ -176,10 +179,15 @@ three tables below.
 | `cockpit logs` | `logs_digest` | `LOCAL @bli-cockpit/telemetry-core/log-digest (this machine's logs); `project` reads GET /api/logs (the stored digests)` |
 | `cockpit mail accounts` | `mail_accounts` | `GET /api/mail/accounts` |
 | `cockpit mail attachment` | `mail_attachment` | `GET /api/mail/attachments/[id]?meta=1` |
+| `cockpit mail default` | `mail_default` | `PATCH /api/mail/accounts` |
 | `cockpit mail detach` | `mail_detach` | `DELETE /api/mail/accounts` |
+| `cockpit mail disable` | `mail_disable` | `PATCH /api/mail/accounts` |
 | `cockpit mail draft` | `mail_draft` | `POST /api/mail/drafts` |
+| `cockpit mail enable` | `mail_enable` | `PATCH /api/mail/accounts` |
 | `cockpit mail inbox` | `mail_inbox` | `GET /api/mail/inbox` |
 | `cockpit mail read` | `mail_read` | `GET /api/mail/threads/[id]` |
+| `cockpit mail remove` | `mail_remove` | `DELETE /api/mail/accounts` |
+| `cockpit mail rename` | `mail_rename` | `PATCH /api/mail/accounts` |
 | `cockpit mail search` | `mail_search` | `GET /api/mail/search` |
 | `cockpit mail send` | `mail_send` | `POST /api/mail/send` |
 | `cockpit mail sync` | `mail_sync` | `POST /api/mail/accounts/[id]/sync` |
@@ -207,6 +215,7 @@ three tables below.
 | `cockpit msg send` | `msg_send` | `POST /api/msg/channels/[id]/messages` |
 | `cockpit msg thread` | `msg_thread` | `GET /api/msg/channels/[id]/messages?thread_parent_id=` |
 | `cockpit notes accounts` | `notes_accounts` | `GET /api/notes/accounts` |
+| `cockpit notes bot-upcoming` | `notes_bot_upcoming` | `GET /api/notetaker/upcoming` |
 | `cockpit notes detach` | `notes_detach` | `DELETE /api/notes/accounts` |
 | `cockpit notes folders` | `notes_folders` | `GET /api/notes/folders` |
 | `cockpit notes granola-status` | `notes_granola_status` | `GET /api/notes/granola-status` |

package/dist/account-tools.d.ts

@@ -0,0 +1,2 @@
+import { type RegisterTool, type ToolDeps } from "./tool-result.js";
+export declare function registerAccountTools(register: RegisterTool, deps: ToolDeps): void;

package/dist/account-tools.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { callAgentDoor } from "./agent-door.js";
+import { withSession, textResult, errorResult, doorFailureText } from "./tool-result.js";
+export function registerAccountTools(register, deps) {
+    for (const action of ["rename", "enable", "disable", "default", "remove"]) {
+        register(`mail_${action}`, { title: `${action} a connected account`, description: "Manage the caller's shared mail/calendar account. Exact case-folded label, address or id. Removing disconnects the account and deletes Tower's stored copies; provider data is untouched.",
+            inputSchema: {
+                account: z.string().min(1).max(320).describe("The connected account: its exact label, address or id (mail_accounts lists them)."),
+                ...(action === "rename" ? { name: z.string().trim().min(1).max(100).describe("The new label, e.g. personal 1.") } : {}),
+                ...(["enable", "disable"].includes(action) ? { source: z.enum(["mail", "calendar"]).describe("Which source to switch: mail or calendar.") } : {}),
+            },
+        }, async (args) => withSession(deps, async (session) => {
+            const response = await callAgentDoor(session, deps.fetchImpl, action === "remove" ? "DELETE" : "PATCH", action === "remove" ? `/api/mail/accounts?account=${encodeURIComponent(String(args.account))}` : "/api/mail/accounts", action === "remove" ? undefined : { account: args.account, ...(action === "rename" ? { account_label: args.name } : action === "default" ? { is_default: true } : { [`${args.source}_enabled`]: action === "enable" }) });
+            if (!response.ok)
+                return errorResult(doorFailureText(`mail_${action}`, response));
+            return textResult(`Account ${args.account}: ${action} completed.`, response.body);
+        }));
+    }
+}

package/dist/brain-tools.js

@@ -36,4 +36,21 @@ export function registerBrainTools(server, deps) {
         const text = typeof response.body.text === "string" ? response.body.text : "";
         return dataResult(text, response.body);
     }));
+    registrarFor(server)("brain_retry", {
+        title: "Send incidents back to Tower's brain",
+        description: "Retry needs_human or not_actionable incidents through the same door as cockpit brain retry. Only members and super admins. Resets attempts and claims, records who/why/when, and comments once on each incident issue. Other states are skipped.",
+        inputSchema: {
+            ids: z.array(z.string()).max(100).optional().describe("Incident UUIDs or BLI issue identifiers."),
+            all_needs_human: z.boolean().optional().describe("Retry all needs_human incidents, optionally in one project."),
+            project: z.string().optional().describe("Narrow every selection to this registry project id."),
+            reason: z.string().trim().min(1).max(4000).describe("Why these incidents should be tried again."),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const response = await callAgentDoor(session, deps.fetchImpl, "POST", "/api/brain/incidents/retry", args);
+        if (!response.ok)
+            return errorResult(doorFailureText("brain_retry", response));
+        if (response.body.ok === false)
+            return { ...dataResult(String(response.body.text ?? "Retry partially failed."), response.body), isError: true };
+        return dataResult(String(response.body.text ?? ""), response.body);
+    }));
 }

package/dist/cal-tools-delete.js

@@ -9,6 +9,22 @@ import { z } from "zod";
 import { callAgentDoor } from "./agent-door.js";
 import { CONFIRM_INPUT, doorFailureText, errorResult, textResult, unconfirmed, withSession, } from "./tool-result.js";
 export function registerCalDeleteTool(register, deps) {
+    register("cal_change", { title: "Change an event", description: "Change a caller-owned event, checking the named account before writing to Google.", inputSchema: {
+            event_id: z.string().uuid().describe("Tower's event id (cal_today/cal_week/cal_next/cal_find return it as event_id)."),
+            account: z.string().min(1).max(100).optional().describe("Exact connected account label, address or id (mail_accounts lists them). Omit to use the account the event is on."),
+            title: z.string().min(1).max(500).optional().describe("The new title."),
+            starts_at: z.string().optional().describe("The new start, ISO 8601 with offset. Send with ends_at."),
+            ends_at: z.string().optional().describe("The new end, ISO 8601 with offset. Send with starts_at."),
+            location: z.string().max(1000).optional().describe("The new location."),
+            confirm: CONFIRM_INPUT,
+        } }, async (args) => withSession(deps, async (session) => {
+        const refusal = unconfirmed(args, "This changes the event at Google and may notify guests.");
+        if (refusal)
+            return refusal;
+        const { event_id, confirm: _confirm, ...changes } = args;
+        const response = await callAgentDoor(session, deps.fetchImpl, "PATCH", `/api/cal/events/${encodeURIComponent(String(event_id))}`, changes);
+        return response.ok ? textResult(`Event changed. Account: ${response.body.event?.account_name ?? "the event’s account"}.`, response.body) : errorResult(doorFailureText("cal_change", response));
+    }));
     register("cal_delete", {
         title: "Delete an event",
         description: "Removes ONE event, AT GOOGLE first and then here — the same order every calendar write in this server "
@@ -16,6 +32,7 @@ export function registerCalDeleteTool(register, deps) {
             + "Attendees are notified (sendUpdates=all) only when the event has any. Google already having it gone "
             + "(404/410) is answered as success, not a refusal. Requires confirm: true.",
         inputSchema: {
+            account: z.string().min(1).max(100).optional().describe("Exact connected account label, address or id (mail_accounts lists them). Omit to use the account the event is on."),
             event_id: z.string().uuid().describe("Tower's event id (cal_today/cal_week/cal_next/cal_find return it as event_id)."),
             confirm: CONFIRM_INPUT,
         },
@@ -23,18 +40,19 @@ export function registerCalDeleteTool(register, deps) {
         const refusal = unconfirmed(args, "This would remove that event at Google (emailing any attendees) and then here.");
         if (refusal)
             return refusal;
-        const response = await callAgentDoor(session, deps.fetchImpl, "DELETE", `/api/cal/events/${encodeURIComponent(String(args.event_id))}`);
+        const response = await callAgentDoor(session, deps.fetchImpl, "DELETE", `/api/cal/events/${encodeURIComponent(String(args.event_id))}${args.account ? `?account=${encodeURIComponent(String(args.account))}` : ""}`);
         if (!response.ok)
             return errorResult(doorFailureText("cal_delete", response));
         const deleted = response.body.deleted;
         if (!deleted)
             return textResult("Tower answered without a result. Nothing to report.", response.body);
         const alreadyGone = deleted.google === "already_gone_at_google";
+        const accountReceipt = deleted.account_name ? ` Account: ${deleted.account_name}.` : "";
         const stored = deleted.local_store === "removed"
             ? "Tower's copy is removed."
             : "Tower's copy is still there for now — the next sync will pick up that it is gone.";
         return textResult(alreadyGone
-            ? `Google already had that event gone. ${stored}`
-            : `Deleted at Google${deleted.notified === "all" ? " — attendees were notified." : "."} ${stored}`, { deleted });
+            ? `Google already had that event gone. ${stored}${accountReceipt}`
+            : `Deleted at Google${deleted.notified === "all" ? " — attendees were notified." : "."} ${stored}${accountReceipt}`, { deleted });
     }));
 }

package/dist/cal-tools.js

@@ -169,7 +169,7 @@ export function registerCalTools(server, deps) {
             ? "No calendars are attached. A person attaches one with `cockpit cal add-ical` (personal) or by connecting "
                 + "Google in the browser (work)."
             : `${calendars.length} calendar(s).\n${calendars
-                .map((calendar) => `${calendar.name}  ${calendar.provider}  ${calendar.org_visible ? "shared" : "private"}  ${calendar.status}${calendar.status_reason ? ` (${calendar.status_reason})` : ""}  ${calendar.id}`)
+                .map((calendar) => `${calendar.account_label ?? calendar.provider}  ${calendar.name}  ${calendar.provider}  ${calendar.org_visible ? "shared" : "private"}  ${calendar.status}${calendar.status_reason ? ` (${calendar.status_reason})` : ""}  ${calendar.id}`)
                 .join("\n")}`, { calendars });
     }));
     register("cal_create", {
@@ -179,7 +179,8 @@ export function registerCalTools(server, deps) {
             + "says so by name. Times are ISO instants, or plain dates with all_day. Requires confirm: true, because "
             + "attendees are emailed by Google the moment this succeeds.",
         inputSchema: {
-            calendar_id: z.string().uuid().describe("A google_oauth calendar id you own (cal_calendars)."),
+            calendar_id: z.string().uuid().optional().describe("A google_oauth calendar id you own (cal_calendars)."),
+            account: z.string().min(1).max(100).optional().describe("Exact connected account label; omitted uses default."),
             title: z.string().min(1).max(500).describe("The event title."),
             starts_at: z.string().min(4).max(40).describe("An ISO instant, or a YYYY-MM-DD date with all_day."),
             ends_at: z.string().min(4).max(40).describe("An ISO instant, or a YYYY-MM-DD date with all_day."),
@@ -196,6 +197,7 @@ export function registerCalTools(server, deps) {
             return refusal;
         const response = await callAgentDoor(session, deps.fetchImpl, "POST", "/api/cal/events", {
             calendar_id: args.calendar_id,
+            ...(args.account ? { account: args.account } : {}),
             title: args.title,
             starts_at: args.starts_at,
             ends_at: args.ends_at,
@@ -209,6 +211,7 @@ export function registerCalTools(server, deps) {
             return errorResult(doorFailureText("cal_create", response));
         const event = response.body.event;
         return textResult(`Created "${event?.title ?? String(args.title)}" at ${event?.starts_at ?? String(args.starts_at)}.`
+            + (event?.account_name ? `\nAccount: ${event.account_name}.` : "")
             + towerIdLine(event)
             + (event?.html_link ? `\n${event.html_link}` : "")
             + (args.meet === true

package/dist/docs-msg-tools.js

@@ -39,7 +39,8 @@ export function registerDocsMsgTools(server, deps) {
         const more = args.limit === undefined && all.length > DEFAULT_LIST_LIMIT;
         const rows = more ? all.slice(0, DEFAULT_LIST_LIMIT) : all;
         const lines = rows.map(docListLine).join("\n");
-        return textResult(`${rows.length} document(s).${moreNote(more, DOCS_LIST_MAX)}${lines ? `\n${lines}` : ""}`, { documents: rows.map(docListRow), more });
+        const counts = response.body.counts;
+        return textResult(`${rows.length} document(s).${counts ? ` ${counts.total} match in all. ${counts.coverage}` : ""}${moreNote(more, DOCS_LIST_MAX)}${lines ? `\n${lines}` : ""}`, { documents: rows.map(docListRow), more, counts });
     }));
     register("docs_tree", {
         title: "Read the Tower document tree",

package/dist/docs-notion-tools.js

@@ -85,8 +85,10 @@ export function registerDocsNotionTools(server, deps) {
         const runLine = ["push", "pull"]
             .map((direction) => `${direction} ${runSentence(lastRun?.[direction] ?? null)}`)
             .join(" · ");
-        return textResult(`${counts?.linked ?? 0} linked: ${summary}. Last run — ${runLine}.`, {
+        const coverage = response.body.coverage ? `${response.body.coverage} ` : "";
+        return textResult(`${counts?.linked ?? 0} linked: ${summary}. ${coverage}Last run — ${runLine}.`, {
             counts,
+            ...response.body,
             documents: response.body.documents ?? [],
             last_run: lastRun ?? { push: null, pull: null },
         });

package/dist/mail-compose.js

@@ -28,7 +28,8 @@ export const ATTACHMENTS_INPUT = z
 /** The JSON both tools post. `attachments` is present only when there are files. */
 export function composedBody(args, attachments = []) {
     return {
-        account_id: args.account_id,
+        ...(args.account_id ? { account_id: args.account_id } : {}),
+        ...(args.account ? { account: args.account } : {}),
         to: args.to.map((address) => ({ address })),
         ...(Array.isArray(args.cc) && args.cc.length > 0
             ? { cc: args.cc.map((address) => ({ address })) }

package/dist/mail-tools.js

@@ -34,6 +34,7 @@
  * call, so a machine with no `cockpit login` pairing still serves this
  * server's other tools and only a `mail_` call fails, by name.
  */
+import { registerAccountTools } from "./account-tools.js";
 import { z } from "zod";
 import { callAgentDoor } from "./agent-door.js";
 import { ATTACHMENTS_INPUT, attachmentResult, prepareMessage, unconfirmedAttachments } from "./mail-compose.js";
@@ -45,10 +46,11 @@ function messageLine(message) {
 const ADDRESS = EMAIL_INPUT.describe("An email address.");
 export function registerMailTools(server, deps) {
     const register = registrarFor(server);
+    registerAccountTools(register, deps);
     register("mail_accounts", {
         title: "List attached mailboxes",
         description: "Every mailbox attached to Tower that you may see — address, provider (gmail_oauth or imap), health and last sync. "
-            + "One person may have several; there is no default mailbox anywhere in this surface, so start here when you need an account id.",
+            + "One person may have several, each with a label (e.g. personal 1) and per-source switches; one may be marked default. Start here when you need an account name or id.",
         inputSchema: {},
     }, async () => withSession(deps, async (session) => {
         const response = await callAgentDoor(session, deps.fetchImpl, "GET", "/api/mail/accounts");
@@ -56,7 +58,7 @@ export function registerMailTools(server, deps) {
             return errorResult(doorFailureText("mail_accounts", response));
         const accounts = (Array.isArray(response.body.accounts) ? response.body.accounts : []);
         const lines = accounts
-            .map((account) => `${account.address}  ${account.provider}  ${account.status}${account.status_reason ? ` (${account.status_reason})` : ""}  ${account.id}`)
+            .map((account) => `${account.account_label ?? account.address} ${account.is_default ? "default" : ""} mail=${account.mail_enabled !== false} calendar=${account.calendar_enabled !== false} ${account.address}  ${account.provider}  ${account.status}${account.status_reason ? ` (${account.status_reason})` : ""}  ${account.id}`)
             .join("\n");
         return textResult(accounts.length === 0
             ? "No mailboxes are attached. A person attaches one with `cockpit mail add-imap` (personal) or the browser (work)."
@@ -187,7 +189,8 @@ export function registerMailTools(server, deps) {
             + "see that argument for what it refuses. "
             + "This actually sends mail to real people: confirm must be true.",
         inputSchema: {
-            account_id: z.string().uuid().describe("The mailbox it goes out from (mail_accounts). Never guessed."),
+            account_id: z.string().uuid().optional().describe("The mailbox id, or use account name/default."),
+            account: z.string().min(1).max(100).optional().describe("Exact connected account label."),
             to: z.array(ADDRESS).min(1).max(50).describe("Recipient email addresses."),
             cc: z.array(ADDRESS).max(50).optional().describe("Copied email addresses."),
             subject: z.string().max(998).describe("The subject line."),
@@ -213,14 +216,14 @@ export function registerMailTools(server, deps) {
         if (notConfirmed)
             return errorResult(notConfirmed);
         const files = attachmentResult(message.summary);
-        return textResult(`Sent from ${sent?.address ?? "that mailbox"} to ${args.to.join(", ")}${sent?.threaded ? " (as a reply)" : ""}.${files.sentence}`, { sent, ...files.structured });
+        return textResult(`Sent from ${sent?.account_name ?? sent?.address ?? "that mailbox"} to ${args.to.join(", ")}${sent?.threaded ? " (as a reply)" : ""}.${files.sentence}`, { sent, ...files.structured });
     }));
     register("mail_draft", {
         title: "Save a draft in one mailbox",
         description: "Saves a message as a DRAFT in one of YOUR mailboxes, for a person to read, edit and send themselves. Use it "
             + "when you are preparing mail on somebody's behalf and they should be the one to press send. NOTHING IS SENT and "
-            + "nobody is notified, so unlike mail_send there is no confirm flag. `account_id` is REQUIRED and is the mailbox the "
-            + "draft is saved in (mail_accounts) — with several attached, that is never something to guess. "
+            + "nobody is notified, so unlike mail_send there is no confirm flag. `account` is an exact label; `account_id` selects a mailbox id. Omit both for your default. The "
+            + "draft is saved in that mailbox (mail_accounts). With several accounts and no default, Tower asks which one. "
             + "`in_reply_to_message_id` (a message id from mail_read) threads the draft into that conversation the way mail_send "
             + "threads a reply; Gmail files it there only when the subject matches the original's, and the answer says whether it "
             + "did (`threaded`). `attachments` ([{ path }]) puts files from this machine in the draft, up to 10 and 3,000,000 bytes "
@@ -228,7 +231,8 @@ export function registerMailTools(server, deps) {
             + "mailboxes can take one: an IMAP mailbox is refused as imap_drafts_unsupported. Answers the provider draft id, "
             + "the thread id and the account id.",
         inputSchema: {
-            account_id: z.string().uuid().describe("The mailbox the draft is saved in (mail_accounts). Never guessed."),
+            account_id: z.string().uuid().optional().describe("The mailbox id, or use account name/default."),
+            account: z.string().min(1).max(100).optional().describe("Exact account label, e.g. work 1."),
             to: z.array(ADDRESS).min(1).max(50).describe("Recipient email addresses, so the draft is ready to send as it is."),
             cc: z.array(ADDRESS).max(50).optional().describe("Copied email addresses."),
             subject: z.string().max(998).describe("The subject line. For a reply, keep the original's subject or Gmail will not thread it."),
@@ -252,7 +256,7 @@ export function registerMailTools(server, deps) {
         const files = attachmentResult(message.summary);
         // Both halves carry the ids (BLI-10432): a client that hands the model only
         // `content`, or only `structuredContent`, must still learn where the draft is.
-        return textResult(`Saved a draft in ${draft?.address ?? "that mailbox"} for ${args.to.join(", ")}`
+        return textResult(`Saved a draft in ${draft?.account_name ?? draft?.address ?? "that mailbox"} for ${args.to.join(", ")}`
             + `${draft?.threaded ? " (in the reply's thread)" : args.in_reply_to_message_id ? " (Gmail did NOT file it in that thread: its subject has to match the original's)" : ""}. `
             + "Nothing was sent: it waits in Drafts for a person to read, edit and send."
             + `${files.sentence} `

package/dist/notes-bot-upcoming-tool.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDeps } from "./tool-result.js";
+export declare function registerNotesBotUpcomingTool(server: {
+    registerTool: (...args: never[]) => unknown;
+}, deps: ToolDeps): void;

package/dist/notes-bot-upcoming-tool.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { callAgentDoor } from "./agent-door.js";
+import { registrarFor, withSession, textResult, errorResult, doorFailureText } from "./tool-result.js";
+export function registerNotesBotUpcomingTool(server, deps) {
+    registrarFor(server)("notes_bot_upcoming", {
+        title: "Bot meetings today", description: "Your own Google Meet meetings today the Tower bot will join, with claim state. Decline the event or mark it private to opt out.",
+        inputSchema: { tz: z.string().optional().describe("Your IANA time zone; defaults to UTC.") },
+    }, async (args) => withSession(deps, async (session) => {
+        const response = await callAgentDoor(session, deps.fetchImpl, "GET", `/api/notetaker/upcoming?tz=${encodeURIComponent(String(args.tz ?? "UTC"))}`);
+        if (!response.ok)
+            return errorResult(doorFailureText("notes_bot_upcoming", response));
+        return textResult(JSON.stringify(response.body), response.body);
+    }));
+}

package/dist/server.js

@@ -17,6 +17,7 @@ import { registerCalTools } from "./cal-tools.js";
 import { registerMailTools } from "./mail-tools.js";
 import { registerNotesAccountTools } from "./notes-account-tools.js";
 import { registerNotesTools } from "./notes-tools.js";
+import { registerNotesBotUpcomingTool } from "./notes-bot-upcoming-tool.js";
 import { registerNotesGranolaStatusTool } from "./notes-granola-status-tool.js";
 import { registerNotesWriteTools } from "./notes-write-tools.js";
 import { registerMemoryConsolidationTools } from "./memory-consolidation-tools.js";
@@ -476,6 +477,7 @@ export function createServer(deps, options = {}) {
     registerNotesTools(server, { fetchImpl: deps.fetchImpl });
     // Ticket 10718: the Granola cron's own health, read-only, over the shared
     // server-side key rather than a `notes_accounts` row.
+    registerNotesBotUpcomingTool(server, { fetchImpl: deps.fetchImpl });
     registerNotesGranolaStatusTool(server, { fetchImpl: deps.fetchImpl });
     registerOpsTools(server, { fetchImpl: deps.fetchImpl });
     registerMemoryExperienceTools(server, { fetchImpl: deps.fetchImpl });

package/dist/setup-tools.js

@@ -15,6 +15,6 @@ export function registerSetupTools(server, deps) {
         if (args.compare)
             query.set("compare", String(args.compare));
         const response = await callAgentDoor(session, deps.fetchImpl, "GET", `/api/setup?${query}`);
-        return response.ok ? dataResult("Agent setups and outcomes over the requested window.", response.body) : errorResult(doorFailureText("setup_read", response));
+        return response.ok ? dataResult(`Agent setups and outcomes over the requested window. ${response.body.read_coverage?.join(" ") ?? ""}`, response.body) : errorResult(doorFailureText("setup_read", response));
     }));
 }

package/dist/tool-catalog.d.ts

@@ -10,7 +10,7 @@
  * from `src/` under Node's type stripping, so it may import nothing.
  */
 /** Tools that change nothing. The smoke calls every one. */
-export declare const READ_TOOLS: readonly ["get_ticket_timeline", "get_active_tickets", "docs_list", "docs_tree", "docs_read", "docs_sync_status", "msg_channels", "msg_read", "msg_thread", "work_list_issues", "work_get_issue", "work_issue_history", "work_list_projects", "careers_list", "careers_show", "careers_resume_url", "careers_takehome_show", "careers_settings_show", "rename_pending", "github_pr", "setup_read", "speed_read", "speed_seen", "usage_people", "usage_sessions", "mail_accounts", "mail_inbox", "mail_read", "mail_search", "mail_attachment", "mail_sync_status", "cal_today", "cal_week", "cal_next", "cal_find", "cal_calendars", "cal_sync_status", "jarvis_ask", "jarvis_trace", "jarvis_check", "models_list", "models_card", "models_compare", "brief_read", "brief_history", "brief_status", "brief_missed", "notes_folders", "notes_list", "glossary_list", "notes_show", "notes_shelf", "notes_shelves", "notes_place", "notes_accounts", "notes_recordings", "notes_recording", "notes_sync_status", "notes_granola_status", "ops_status", "slack_coverage", "slack_read", "memory_rules", "memory_profile", "memory_consolidation", "settings_show", "settings_list", "model_show", "team_members", "team_device_list", "scout_board", "workbook_read", "tower_search", "sources_check", "logs_digest", "brain_status"];
+export declare const READ_TOOLS: readonly ["get_ticket_timeline", "get_active_tickets", "docs_list", "docs_tree", "docs_read", "docs_sync_status", "msg_channels", "msg_read", "msg_thread", "work_list_issues", "work_get_issue", "work_issue_history", "work_list_projects", "careers_list", "careers_show", "careers_resume_url", "careers_takehome_show", "careers_settings_show", "rename_pending", "github_pr", "setup_read", "speed_read", "speed_seen", "usage_people", "usage_sessions", "mail_accounts", "mail_inbox", "mail_read", "mail_search", "mail_attachment", "mail_sync_status", "cal_today", "cal_week", "cal_next", "cal_find", "cal_calendars", "cal_sync_status", "jarvis_ask", "jarvis_trace", "jarvis_check", "models_list", "models_card", "models_compare", "brief_read", "brief_history", "brief_status", "brief_missed", "notes_folders", "notes_list", "glossary_list", "notes_show", "notes_shelf", "notes_shelves", "notes_place", "notes_accounts", "notes_recordings", "notes_recording", "notes_sync_status", "notes_granola_status", "notes_bot_upcoming", "ops_status", "slack_coverage", "slack_read", "memory_rules", "memory_profile", "memory_consolidation", "settings_show", "settings_list", "model_show", "team_members", "team_device_list", "scout_board", "workbook_read", "tower_search", "sources_check", "logs_digest", "brain_status"];
 /**
  * Tools that write, but answer a dry run that writes nothing. The smoke calls
  * each one ONLY with its dry-run flag set (`scripts/smoke.ts` says which).
@@ -21,7 +21,7 @@ export declare const DRY_RUN_TOOLS: readonly ["ops_recompile", "memory_requeue"]
  * candidates, share calendars. Never called by the smoke; covered by the unit
  * suites (`write-tools.test.ts` and each family's own).
  */
-export declare const WRITE_TOOLS: readonly ["emit_event", "docs_create", "docs_update", "docs_delete", "docs_link", "msg_create_channel", "msg_dm", "msg_send", "work_create_issue", "work_update_issue", "work_move_issue", "work_comment_issue", "careers_rescreen", "careers_send_takehome", "careers_invite", "careers_grade", "careers_decide", "careers_followup", "careers_interview", "careers_takehome_set", "careers_settings_set", "rename_resolve", "github_merge", "github_retitle", "github_rerun", "mail_send", "mail_draft", "mail_sync", "mail_detach", "cal_create", "cal_share", "cal_sync", "cal_detach", "cal_delete", "jarvis_dispatch", "glossary_add", "glossary_remove", "notes_mkdir", "notes_rmdir", "notes_rename", "notes_upload", "notes_paste", "notes_share", "notes_unshare", "notes_move", "notes_sync", "notes_detach", "memory_experience", "scout_start", "scout_dismiss", "scout_undo", "brief_rewrite", "brief_correct", "brief_done", "brief_undone", "settings_set", "settings_delete", "model_set", "team_invite", "team_role", "team_device_revoke", "team_device_doctor"];
+export declare const WRITE_TOOLS: readonly ["brain_retry", "emit_event", "docs_create", "docs_update", "docs_delete", "docs_link", "msg_create_channel", "msg_dm", "msg_send", "work_create_issue", "work_update_issue", "work_move_issue", "work_comment_issue", "careers_rescreen", "careers_send_takehome", "careers_invite", "careers_grade", "careers_decide", "careers_followup", "careers_interview", "careers_takehome_set", "careers_settings_set", "rename_resolve", "github_merge", "github_retitle", "github_rerun", "mail_send", "mail_draft", "mail_rename", "mail_enable", "mail_disable", "mail_default", "mail_remove", "cal_change", "mail_sync", "mail_detach", "cal_create", "cal_share", "cal_sync", "cal_detach", "cal_delete", "jarvis_dispatch", "glossary_add", "glossary_remove", "notes_mkdir", "notes_rmdir", "notes_rename", "notes_upload", "notes_paste", "notes_share", "notes_unshare", "notes_move", "notes_sync", "notes_detach", "memory_experience", "scout_start", "scout_dismiss", "scout_undo", "brief_rewrite", "brief_correct", "brief_done", "brief_undone", "settings_set", "settings_delete", "model_set", "team_invite", "team_role", "team_device_revoke", "team_device_doctor"];
 /** Reads that spend a model turn. The smoke's `--no-model` leaves these out. */
 export declare const MODEL_SPENDING_TOOLS: readonly ["jarvis_ask", "jarvis_check"];
 /**

package/dist/tool-catalog.js

@@ -71,6 +71,7 @@ export const READ_TOOLS = [
     "notes_recording",
     "notes_sync_status",
     "notes_granola_status",
+    "notes_bot_upcoming",
     "ops_status",
     "slack_coverage",
     "slack_read",
@@ -102,6 +103,7 @@ export const DRY_RUN_TOOLS = ["ops_recompile", "memory_requeue"];
  * suites (`write-tools.test.ts` and each family's own).
  */
 export const WRITE_TOOLS = [
+    "brain_retry",
     "emit_event",
     "docs_create",
     "docs_update",
@@ -130,6 +132,7 @@ export const WRITE_TOOLS = [
     "mail_send",
     // BLI-12530: writes into a mailbox (a draft), reaches nobody. Never smoked.
     "mail_draft",
+    "mail_rename", "mail_enable", "mail_disable", "mail_default", "mail_remove", "cal_change",
     "mail_sync",
     "mail_detach",
     "cal_create",

package/dist/usage-tools.d.ts

@@ -13,6 +13,7 @@ interface GithubCounts {
 }
 interface GithubBlock {
     status: "ok" | "unavailable";
+    read_coverage?: string[];
     reason?: string;
     detail?: string;
     counts_label?: string;

package/dist/usage-tools.js

@@ -21,6 +21,7 @@ export function githubWords(github, people) {
         `GitHub: ${noun(sum("pull_requests_opened"), "pull request")} opened, ${sum("pull_requests_merged")} merged, ${noun(sum("commits"), "commit")}, ` +
             `from ${noun((github.repositories ?? []).length, "mirrored repository", "mirrored repositories")}${range}.`,
     ];
+    lines.push(...(github.read_coverage ?? []));
     const unmatched = github.unattributed;
     if (unmatched && unmatched.pull_requests_opened + unmatched.pull_requests_merged + unmatched.commits > 0) {
         lines.push(`Not matched to a person: ${noun(unmatched.pull_requests_opened, "pull request")} opened, ${unmatched.pull_requests_merged} merged, ${noun(unmatched.commits, "commit")}.`);
@@ -80,7 +81,7 @@ export function registerUsageTools(server, deps) {
         // agent reading only the text half cannot quote a pull-request count without
         // what it covers and who it left out.
         const github = githubSentence(response.body);
-        return dataResult(`${coverage?.sessions_extracted ?? 0} of ${coverage?.sessions_observed ?? 0} sessions extracted.${why} ${coverage?.sessions_counted_at_upload ?? 0} of ${coverage?.sessions_observed ?? 0} sessions counted at upload, ${coverage?.sessions_counted_by_server ?? 0} by server backfill, ${coverage?.sessions_counted_by_ladder ?? 0} by the ladder.${args.groupBy === "task_type" ? ` ${coverage?.sessions_labelled ?? 0} of ${coverage?.sessions_observed ?? 0} sessions labelled by topic.` : ""}${priceLabel}${github}`, response.body);
+        return dataResult(`${response.body.read_coverage?.join(" ") ?? ""} ${coverage?.sessions_extracted ?? 0} of ${coverage?.sessions_observed ?? 0} sessions extracted.${why} ${coverage?.sessions_counted_at_upload ?? 0} of ${coverage?.sessions_observed ?? 0} sessions counted at upload, ${coverage?.sessions_counted_by_server ?? 0} by server backfill, ${coverage?.sessions_counted_by_ladder ?? 0} by the ladder.${args.groupBy === "task_type" ? ` ${coverage?.sessions_labelled ?? 0} of ${coverage?.sessions_observed ?? 0} sessions labelled by topic.` : ""}${priceLabel}${github}`, response.body);
     }));
     registrarFor(server)("usage_sessions", {
         title: "Read task or subject sessions",
@@ -117,6 +118,6 @@ export function registerUsageTools(server, deps) {
             return dataResult(`${windows} digest window(s) of session ${String(args.session)}.`, response.body);
         }
         const sessions = Array.isArray(response.body.sessions) ? response.body.sessions.length : 0;
-        return dataResult(`${sessions} session(s) for ${args.task ? `task ${String(args.task)}` : `topic "${String(args.subject)}"`}.`, response.body);
+        return dataResult(`${response.body.read_coverage?.join(" ") ?? ""} ${sessions} session(s) for ${args.task ? `task ${String(args.task)}` : `topic "${String(args.subject)}"`}.`, response.body);
     }));
 }

package/dist/verb-census.js

@@ -239,6 +239,7 @@ export const MCP_TWINS = {
     // this machine's collector logs and the `vercel` / `railway` CLIs.
     // BLI-12855: a project name (or --stored, or a local CLI that is missing) reads the digests Tower's cron stored, through GET /api/logs.
     "logs": { tool: "logs_digest", door: "LOCAL @bli-cockpit/telemetry-core/log-digest (this machine's logs); `project` reads GET /api/logs (the stored digests)" },
+    "brain retry": { tool: "brain_retry", door: "POST /api/brain/incidents/retry" },
     "brain status": { tool: "brain_status", door: "GET /api/brain/incidents" },
     "usage sessions": { tool: "usage_sessions", door: "GET /api/usage/sessions" },
     "setup": { tool: "setup_read", door: "GET /api/setup" },
@@ -272,6 +273,11 @@ export const MCP_TWINS = {
     "issue comment": { tool: "work_comment_issue", door: "POST /api/work/issues/[id]/comments" },
     "issue history": { tool: "work_issue_history", door: "GET /api/work/issues/[id]/history" },
     "project list": { tool: "work_list_projects", door: "GET /api/work/projects" },
+    "mail rename": { tool: "mail_rename", door: "PATCH /api/mail/accounts" },
+    "mail enable": { tool: "mail_enable", door: "PATCH /api/mail/accounts" },
+    "mail disable": { tool: "mail_disable", door: "PATCH /api/mail/accounts" },
+    "mail default": { tool: "mail_default", door: "PATCH /api/mail/accounts" },
+    "mail remove": { tool: "mail_remove", door: "DELETE /api/mail/accounts" },
     "mail accounts": { tool: "mail_accounts", door: "GET /api/mail/accounts" },
     "mail inbox": { tool: "mail_inbox", door: "GET /api/mail/inbox" },
     "mail read": { tool: "mail_read", door: "GET /api/mail/threads/[id]" },
@@ -288,6 +294,8 @@ export const MCP_TWINS = {
     "cal next": { tool: "cal_next", door: "GET /api/cal/next" },
     "cal find": { tool: "cal_find", door: "GET /api/cal/find" },
     "cal calendars": { tool: "cal_calendars", door: "GET /api/cal/calendars" },
+    "cal change": { tool: "cal_change", door: "PATCH /api/cal/events/[eventId]" },
+    "cal cancel": { tool: "cal_delete", door: "DELETE /api/cal/events/[eventId]" },
     "cal create": { tool: "cal_create", door: "POST /api/cal/events" },
     "cal share": { tool: "cal_share", door: "PATCH /api/cal/calendars" },
     "cal sync": { tool: "cal_sync", door: "POST /api/cal/calendars/[id]/sync" },
@@ -325,6 +333,7 @@ export const MCP_TWINS = {
     "notes sync": { tool: "notes_sync", door: "POST /api/notes/accounts/[id]/sync" },
     "notes sync-status": { tool: "notes_sync_status", door: "GET /api/notes/sync-status" },
     // Ticket 10718: Granola's own cron health, over its shared server-side key.
+    "notes bot-upcoming": { tool: "notes_bot_upcoming", door: "GET /api/notetaker/upcoming" },
     "notes granola-status": { tool: "notes_granola_status", door: "GET /api/notes/granola-status" },
     "memory log": { tool: "memory_experience", door: "POST /api/memory/experience" },
     // BLI-4047, BLI-12927: the memory STORE at a terminal. Its twins live on the

package/dist/work-tools.js

@@ -135,10 +135,11 @@ export function registerWorkTools(server, deps) {
                 + `  [p${issue.priority ?? 0}${size ? `, size ${size}` : ""}, assignee ${assigneeLabel(issue.assignee_id, directory)}, project ${issue.project_id ?? "none"}]`;
         })
             .join("\n");
-        const totalNote = completeness?.total != null && completeness.total > issues.length ? ` ${completeness.total} match in all.` : "";
+        const counts = response.body.counts;
+        const totalNote = counts ? ` ${counts.total} match in all. ${counts.coverage}` : completeness?.total != null && completeness.total > issues.length ? ` ${completeness.total} match in all.` : "";
         return textResult(`${issues.length} issue(s).${totalNote}${moreNote(more, ISSUE_LIST_MAX)}${outsideNote(outside)}${lines ? `\n${lines}` : ""}`, {
             issues: issues.map((issue) => withSizeLabel(withAssigneeIdentity(issueListRow(issue), directory))),
-            more,
+            more, counts,
             ...(completeness ? { total: completeness.total } : {}),
             ...(outside ? { outside_project: outside } : {}),
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/mcp",
-  "version": "0.1.109",
+  "version": "0.1.111",
   "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",