@bli-cockpit/mcp 0.1.108 → 0.1.110

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.**
+**139 of 144 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` |

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/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/setup-tools.js

@@ -4,7 +4,7 @@ import { dataResult, doorFailureText, errorResult, registrarFor, withSession } f
 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.",
+        description: "Read machine setup names and windowed (default 30-day) merged PR volume, tokens per merged PR and session yield, plus per person the tokens by tool and model that really ran (model_use) and the skills they typed or the agent called (skill_use, use not installs). 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 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();
@@ -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

@@ -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_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

@@ -102,6 +102,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",

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" },

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.108",
+  "version": "0.1.110",
   "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.68",
+    "@bli-cockpit/telemetry-core": "0.1.69",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6"
   },