@bli-cockpit/mcp 0.1.37 → 0.1.38

package/README.md

@@ -34,7 +34,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**90 of 93 Tower verbs have an MCP twin.**
+**91 of 94 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
@@ -131,6 +131,7 @@ three tables below.
 | `cockpit team members` | `team_members` | `GET /api/team/members` |
 | `cockpit team role` | `team_role` | `PATCH /api/team/members/[userId]/role` |
 | `cockpit usage people` | `usage_people` | `GET /api/usage/people` |
+| `cockpit usage sessions` | `usage_sessions` | `GET /api/usage/sessions` |
 | `cockpit workbook` | `workbook_read` | `GET /api/cockpit/workbook` |
 
 ### Owed a twin

package/dist/usage-tools.js

@@ -5,7 +5,7 @@ export function registerUsageTools(server, deps) {
     registrarFor(server)("usage_people", {
         title: "Read usage by person",
         description: "Per-person Claude Code and Codex token usage, list-price equivalent, and extraction coverage.",
-        inputSchema: { minConfidence: z.enum(["high", "medium", "low"]).optional(), groupBy: z.enum(["repo", "task_type"]).optional(), since: z.string().optional().describe("<n>d (1 to 365), <n>h (1 to 8760), or an ISO timestamp. Default 30d; invalid values return invalid_usage_window."), until: z.string().optional(), include_automated: z.boolean().optional() },
+        inputSchema: { minConfidence: z.enum(["high", "medium", "low"]).optional(), groupBy: z.enum(["repo", "task_type", "topic"]).optional(), since: z.string().optional().describe("<n>d (1 to 365), <n>h (1 to 8760), or an ISO timestamp. Default 30d; invalid values return invalid_usage_window."), until: z.string().optional(), include_automated: z.boolean().optional() },
     }, async (args) => withSession(deps, async (session) => {
         const query = new URLSearchParams({ since: String(args.since ?? "30d") });
         if (args.until)
@@ -22,4 +22,20 @@ export function registerUsageTools(server, deps) {
         const coverage = response.body.coverage;
         return textResult(`${coverage?.sessions_extracted ?? 0} of ${coverage?.sessions_observed ?? 0} sessions extracted.${args.groupBy === "task_type" ? ` ${coverage?.sessions_labelled ?? 0} of ${coverage?.sessions_observed ?? 0} sessions labelled by topic.` : ""}`, response.body);
     }));
+    registrarFor(server)("usage_sessions", {
+        title: "Read subject sessions",
+        description: "List subject sessions with titles, tokens and work types; read digest windows on demand with session.",
+        inputSchema: { subject: z.string().optional(), repo: z.string().optional(), since: z.string().optional(), until: z.string().optional(), include_automated: z.boolean().optional(), session: z.string().optional(), fromWindow: z.number().int().positive().optional() },
+    }, async (args) => withSession(deps, async (session) => {
+        const query = new URLSearchParams();
+        for (const key of ["subject", "repo", "since", "until", "session", "fromWindow"])
+            if (args[key] !== undefined)
+                query.set(key, String(args[key]));
+        if (args.include_automated)
+            query.set("include_automated", "1");
+        const response = await callAgentDoor(session, deps.fetchImpl, "GET", `/api/usage/sessions?${query}`);
+        if (!response.ok)
+            return errorResult(doorFailureText("usage_sessions", response));
+        return textResult("Subject sessions and requested digest windows.", response.body);
+    }));
 }

package/dist/verb-census.js

@@ -212,6 +212,7 @@ export const MCP_TWINS = {
     "careers list": { tool: "careers_list", door: "GET /api/careers/applications" },
     "careers show": { tool: "careers_show", door: "GET /api/careers/applications/[id]" },
     "careers rescreen": { tool: "careers_rescreen", door: "POST /api/careers/applications/[id]/rescreen" },
+    "usage sessions": { tool: "usage_sessions", door: "GET /api/usage/sessions" },
     "usage people": { tool: "usage_people", door: "GET /api/usage/people" },
     "docs list": { tool: "docs_list", door: "GET /api/docs/documents" },
     "docs tree": { tool: "docs_tree", door: "GET /api/docs/tree" },

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@bli-cockpit/mcp",
-  "version": "0.1.37",
+  "version": "0.1.38",
   "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).",
+  "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",
   "bin": {
     "bli-cockpit-mcp": "./dist/index.js"