@bli-cockpit/mcp 0.1.67 → 0.1.69

package/README.md

@@ -103,7 +103,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**110 of 115 Tower verbs have an MCP twin.**
+**111 of 116 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
@@ -119,6 +119,7 @@ three tables below.
 | `cockpit brief undone` | `brief_undone` | `POST /api/jarvis/ticks` |
 | `cockpit cal calendars` | `cal_calendars` | `GET /api/cal/calendars` |
 | `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` |
 | `cockpit cal find` | `cal_find` | `GET /api/cal/find` |
 | `cockpit cal next` | `cal_next` | `GET /api/cal/next` |

package/dist/cal-tools-delete.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `cal_delete` (BLI-10564) — split out of `cal-tools.ts` when adding it there
+ * would have pushed that file over the 500-line readability band. Same door
+ * as `cockpit cal delete`, same confirm gate as `cal_create`/`cal_share`/
+ * `cal_detach`: a delete can email everybody on the event, so it is never
+ * something to do because a sentence sounded like it.
+ */
+import { type RegisterTool, type ToolDeps } from "./tool-result.js";
+export declare function registerCalDeleteTool(register: RegisterTool, deps: ToolDeps): void;

package/dist/cal-tools-delete.js

@@ -0,0 +1,40 @@
+/**
+ * `cal_delete` (BLI-10564) — split out of `cal-tools.ts` when adding it there
+ * would have pushed that file over the 500-line readability band. Same door
+ * as `cockpit cal delete`, same confirm gate as `cal_create`/`cal_share`/
+ * `cal_detach`: a delete can email everybody on the event, so it is never
+ * something to do because a sentence sounded like it.
+ */
+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_delete", {
+        title: "Delete an event",
+        description: "Removes ONE event, AT GOOGLE first and then here — the same order every calendar write in this server "
+            + "uses. Only a google_oauth calendar can be written to; an iCal calendar is read-only and says so by name. "
+            + "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: {
+            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,
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        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))}`);
+        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 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 });
+    }));
+}

package/dist/cal-tools.d.ts

@@ -18,7 +18,9 @@
  *   Attaching a calendar stays a thing a person does at a terminal.
  * - **`cal_share` requires `confirm: true`.** Making a calendar readable by
  *   everyone at BLI is not a read, and it is not something to do because a
- *   sentence sounded like it.
+ *   sentence sounded like it. `cal_create`, `cal_detach` and `cal_delete`
+ *   (`cal-tools-delete.ts`, BLI-10564) require it too, for the same reason —
+ *   a delete can email everybody on the event.
  *
  * EVERY READ SENDS A ZONE. `time_zone` is a required-in-practice argument on
  * the window tools, because a window computed without one is computed in UTC —

package/dist/cal-tools.js

@@ -18,7 +18,9 @@
  *   Attaching a calendar stays a thing a person does at a terminal.
  * - **`cal_share` requires `confirm: true`.** Making a calendar readable by
  *   everyone at BLI is not a read, and it is not something to do because a
- *   sentence sounded like it.
+ *   sentence sounded like it. `cal_create`, `cal_detach` and `cal_delete`
+ *   (`cal-tools-delete.ts`, BLI-10564) require it too, for the same reason —
+ *   a delete can email everybody on the event.
  *
  * EVERY READ SENDS A ZONE. `time_zone` is a required-in-practice argument on
  * the window tools, because a window computed without one is computed in UTC —
@@ -31,6 +33,7 @@
  */
 import { z } from "zod";
 import { callAgentDoor } from "./agent-door.js";
+import { registerCalDeleteTool } from "./cal-tools-delete.js";
 import { CONFIRM_INPUT, EMAIL_INPUT, doorFailureText, errorResult, queryString, registrarFor, textResult, unconfirmed, withSession, } from "./tool-result.js";
 /** This machine's zone: what a person means by "today" unless they say otherwise. */
 function localZone() {
@@ -204,6 +207,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)}.`
+            + towerIdLine(event)
             + (event?.html_link ? `\n${event.html_link}` : "")
             + (args.meet === true
                 ? event?.meet_link
@@ -273,4 +277,14 @@ export function registerCalTools(server, deps) {
             return errorResult(doorFailureText("cal_detach", response));
         return textResult(`Detached ${String(args.calendar_id)}. Its stored events went with it; the calendar itself is untouched at Google.`, response.body);
     }));
+    registerCalDeleteTool(register, deps);
+}
+/** BLI-10560: the new event's Tower id, or why there is none yet. */
+function towerIdLine(event) {
+    if (event?.event_id)
+        return `\nTower event: ${event.event_id}`;
+    if (event?.local_store === "failed" || event?.local_store === "unreadable") {
+        return "\nGoogle has the event; Tower has not stored it yet (the next calendar sync will), so there is no Tower id to open yet.";
+    }
+    return "";
 }

package/dist/tool-catalog.d.ts

@@ -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_takehome_set", "careers_settings_set", "mail_send", "mail_sync", "mail_detach", "cal_create", "cal_share", "cal_sync", "cal_detach", "jarvis_dispatch", "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"];
+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_takehome_set", "careers_settings_set", "mail_send", "mail_sync", "mail_detach", "cal_create", "cal_share", "cal_sync", "cal_detach", "cal_delete", "jarvis_dispatch", "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"];
 /** 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

@@ -108,6 +108,7 @@ export const WRITE_TOOLS = [
     "cal_share",
     "cal_sync",
     "cal_detach",
+    "cal_delete",
     "jarvis_dispatch",
     "notes_mkdir",
     "notes_rmdir",

package/dist/verb-census.js

@@ -268,6 +268,7 @@ export const MCP_TWINS = {
     "cal share": { tool: "cal_share", door: "PATCH /api/cal/calendars" },
     "cal sync": { tool: "cal_sync", door: "POST /api/cal/calendars/[id]/sync" },
     "cal detach": { tool: "cal_detach", door: "DELETE /api/cal/calendars" },
+    "cal delete": { tool: "cal_delete", door: "DELETE /api/cal/events/[eventId]" },
     "brief read": { tool: "brief_read", door: "GET /api/jarvis/brief" },
     "brief history": { tool: "brief_history", door: "GET /api/jarvis/brief?history=1" },
     "brief status": { tool: "brief_status", door: "GET /api/ops/brief-status" },

package/package.json

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