@bli-cockpit/mcp 0.1.106 → 0.1.108

package/README.md

@@ -109,7 +109,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**137 of 142 Tower verbs have an MCP twin.**
+**138 of 143 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
@@ -245,6 +245,7 @@ three tables below.
 | `cockpit slack coverage` | `slack_coverage` | `GET /api/ops/slack/coverage` |
 | `cockpit slack read` | `slack_read` | `POST /api/ops/slack/read` |
 | `cockpit speed` | `speed_read` | `GET /api/* (every rail page's data door, see speed-tools.ts)` |
+| `cockpit speed --seen` | `speed_seen` | `GET /api/speed/seen` |
 | `cockpit team device doctor` | `team_device_doctor` | `POST /api/ambient/devices/[deviceId]/doctor` |
 | `cockpit team device list` | `team_device_list` | `GET /api/team/devices` |
 | `cockpit team device revoke` | `team_device_revoke` | `POST /api/ambient/devices/[deviceId]/revoke` |

package/dist/setup-tools.js

@@ -5,7 +5,7 @@ export function registerSetupTools(server, deps) {
     registrarFor(server)("setup_read", {
         title: "Compare agent setups and outcomes",
         description: "Read machine setup names and windowed (default 30-day) merged PR volume, tokens per merged PR and session yield. Compare exact emails. Differences are observations, not evidence that a setting causes better results. Missing or stale setup and incomplete token coverage are labeled. Members see their own outcomes; team comparisons require super_admin.",
-        inputSchema: { since: z.string().max(40).optional().describe("7d, 30d, or an ISO date before now."), person: z.string().max(200).optional().describe("Only this person, by exact email address."), compare: z.string().max(401).optional().describe("Two exact email addresses separated by a comma.") },
+        inputSchema: { since: z.string().max(40).optional().describe("7d, 30d, or an ISO date before now."), person: z.string().max(200).optional().describe("Only this person, by exact first name, display name or email address."), compare: z.string().max(401).optional().describe("Two people, by exact first name, display name or email address, separated by a comma (for example edward,ian). An ambiguous name is refused with its candidates.") },
     }, async (args) => withSession(deps, async (session) => {
         const query = new URLSearchParams();
         if (args.since)

package/dist/speed-tools.js

@@ -12,7 +12,8 @@
  * nothing is cached on this side, so the number is Tower's, not ours.
  */
 import { z } from "zod";
-import { dataResult, errorResult, registrarFor, withSession } from "./tool-result.js";
+import { callAgentDoor } from "./agent-door.js";
+import { dataResult, doorFailureText, errorResult, registrarFor, withSession } from "./tool-result.js";
 export function speedPages(memoryContainer) {
     return [
         { name: "today", label: "Today (JARVIS home)", path: "/api/jarvis/brief" },
@@ -156,7 +157,50 @@ async function timeOneRead(fetchImpl, session, page) {
         clearTimeout(timer);
     }
 }
+/**
+ * `speed_seen` (BLI-13054) — the MCP twin of `cockpit speed --seen`: what real
+ * visits experienced, per page, from the page-view beacons the browser sends.
+ * One GET on `/api/speed/seen`; the door counts in the database on the caller's
+ * own row policies, so this side only relays and words the answer.
+ */
+const SEEN_WINDOW = /^\d{1,4}[mhd]$/;
 export function registerSpeedTools(server, deps) {
+    registrarFor(server)("speed_seen", {
+        title: "What real visits saw on each Tower page",
+        description: "Per Tower page, from real page views: visit count, p50 and p95 milliseconds until real content first showed "
+            + "(the last-known screen or the fresh one), the share painted from the last-known screen (snapshot), and median "
+            + "HTML and script transfer where the browser reported them. Slowest first. A person sees their own visits; "
+            + "`everyone` needs super_admin and is refused for anyone else. Window `since` is <n>m, <n>h or <n>d (default 24h, "
+            + "at most 30d). Read only. Twin of `cockpit speed --seen`.",
+        inputSchema: {
+            since: z.string().max(10).optional().describe("Window such as 90m, 24h or 7d (default 24h, at most 30d)."),
+            everyone: z.boolean().optional().describe("Every person's visits (super_admin only)."),
+            pages: z.array(z.enum(SPEED_PAGE_NAMES)).max(14).optional()
+                .describe("Only these pages. Omit for every page."),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const since = typeof args.since === "string" ? args.since.trim().toLowerCase() : "24h";
+        if (!SEEN_WINDOW.test(since))
+            return errorResult("speed_seen: `since` takes <n>m, <n>h or <n>d, for example 24h.");
+        const everyone = args.everyone === true;
+        const query = new URLSearchParams({ since });
+        if (everyone)
+            query.set("everyone", "1");
+        const response = await callAgentDoor(session, deps.fetchImpl, "GET", `/api/speed/seen?${query}`);
+        if (!response.ok)
+            return errorResult(doorFailureText("speed_seen", response));
+        const asked = Array.isArray(args.pages) ? args.pages : [];
+        const body = response.body;
+        const pages = (body.pages ?? [])
+            .filter((page) => asked.length === 0 || asked.includes(page.page))
+            .sort((a, b) => b.p50_ms - a.p50_ms || a.page.localeCompare(b.page));
+        const lines = pages.map((page, index) => `${index + 1}. ${page.page}  ${page.visits} visit${page.visits === 1 ? "" : "s"}  p50 ${Math.round(page.p50_ms)} ms  `
+            + `p95 ${Math.round(page.p95_ms)} ms  snapshot ${Math.round(page.snapshot_share * 100)}%`);
+        const who = everyone ? "everyone's visits" : "your visits";
+        return dataResult(pages.length === 0
+            ? `No page views recorded in the last ${since} (${who}).`
+            : `Real page views over the last ${since} (${who}), slowest first:\n${lines.join("\n")}`, { ok: true, since, everyone, pages });
+    }));
     registrarFor(server)("speed_read", {
         title: "Time every Tower page's data door",
         description: "How long each Tower rail page's data door takes, measured from where this server runs with this machine's "

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", "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", "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).

package/dist/tool-catalog.js

@@ -33,6 +33,7 @@ export const READ_TOOLS = [
     "github_pr",
     "setup_read",
     "speed_read",
+    "speed_seen",
     "usage_people",
     "usage_sessions",
     "mail_accounts",

package/dist/verb-census.js

@@ -244,6 +244,8 @@ export const MCP_TWINS = {
     "setup": { tool: "setup_read", door: "GET /api/setup" },
     // BLI-13033: times the data door of every rail page; the twin runs the same GETs.
     "speed": { tool: "speed_read", door: "GET /api/* (every rail page's data door, see speed-tools.ts)" },
+    // BLI-13054: a mode flag, entered by hand like `jarvis --trace`.
+    "speed --seen": { tool: "speed_seen", door: "GET /api/speed/seen" },
     "usage people": { tool: "usage_people", door: "GET /api/usage/people" },
     "glossary list": { tool: "glossary_list", door: "GET /api/glossary" },
     "glossary add": { tool: "glossary_add", door: "POST /api/glossary" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/mcp",
-  "version": "0.1.106",
+  "version": "0.1.108",
   "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",
@@ -37,7 +37,7 @@
     "readme": "npm run build && node scripts/write-readme-census.mjs"
   },
   "dependencies": {
-    "@bli-cockpit/telemetry-core": "0.1.66",
+    "@bli-cockpit/telemetry-core": "0.1.68",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6"
   },