@bli-cockpit/mcp 0.1.79 → 0.1.80

package/README.md

@@ -103,7 +103,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**117 of 122 Tower verbs have an MCP twin.**
+**119 of 124 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
@@ -209,6 +209,8 @@ three tables below.
 | `cockpit ops recompile` | `ops_recompile` | `POST /api/ops/recompile` |
 | `cockpit ops status` | `ops_status` | `GET /api/ops/status` |
 | `cockpit project list` | `work_list_projects` | `GET /api/work/projects` |
+| `cockpit rename list` | `rename_pending` | `GET /api/jarvis/rename-scope` |
+| `cockpit rename resolve` | `rename_resolve` | `POST /api/jarvis/rename-scope` |
 | `cockpit scout board` | `scout_board` | `GET /api/cockpit/scout` |
 | `cockpit scout dismiss` | `scout_dismiss` | `POST /api/cockpit/scout (dismiss)` |
 | `cockpit scout start` | `scout_start` | `POST /api/cockpit/scout (start)` |

package/dist/rename-tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `rename_pending` / `rename_resolve` (BLI-12378): the MCP twins of
+ * `cockpit rename list|resolve`, over the same door the panel's two buttons
+ * call (`/api/jarvis/rename-scope`) with the same device token.
+ *
+ * A correction JARVIS cannot classify is fixed on one page and waits for a
+ * human's call. Whether it becomes a permanent rule is that call, never an
+ * agent's guess: an agent should pass `everywhere` only on a person's say-so,
+ * and the door still refuses to make a fact (a status, a date, a number) a
+ * rule whatever is asked.
+ */
+import { type ToolDeps } from "./tool-result.js";
+export declare function registerRenameTools(server: {
+    registerTool: (...args: never[]) => unknown;
+}, deps: ToolDeps): void;

package/dist/rename-tools.js

@@ -0,0 +1,52 @@
+/**
+ * `rename_pending` / `rename_resolve` (BLI-12378): the MCP twins of
+ * `cockpit rename list|resolve`, over the same door the panel's two buttons
+ * call (`/api/jarvis/rename-scope`) with the same device token.
+ *
+ * A correction JARVIS cannot classify is fixed on one page and waits for a
+ * human's call. Whether it becomes a permanent rule is that call, never an
+ * agent's guess: an agent should pass `everywhere` only on a person's say-so,
+ * and the door still refuses to make a fact (a status, a date, a number) a
+ * rule whatever is asked.
+ */
+import { z } from "zod";
+import { callAgentDoor } from "./agent-door.js";
+import { dataResult, doorFailureText, errorResult, registrarFor, withSession, } from "./tool-result.js";
+export function registerRenameTools(server, deps) {
+    const register = registrarFor(server);
+    register("rename_pending", {
+        title: "List corrections waiting on a human",
+        description: "The caller's open rename choices: a misspelling JARVIS fixed on ONE page and is asking about (\"just this page, or everywhere from now on?\"), " +
+            "and spellings it applied everywhere on its own that can still be undone. Each row has an id, the wrong and right form, and kind `choose` or `undo`. " +
+            "Answer one with rename_resolve.",
+        inputSchema: {},
+    }, async () => withSession(deps, async (session) => {
+        const answer = await callAgentDoor(session, deps.fetchImpl, "GET", "/api/jarvis/rename-scope");
+        return answer.ok
+            ? dataResult("Corrections waiting", answer.body)
+            : errorResult(doorFailureText("rename_pending", answer));
+    }));
+    register("rename_resolve", {
+        title: "Answer a correction: this page, everywhere, or undo",
+        description: "Answer one open rename choice from rename_pending. `page` keeps it a one-page fix; `everywhere` writes the permanent rule and fixes every other page " +
+            "(only on a person's explicit say-so: whether a correction becomes a rule is a human's call); `undo` takes back a rule JARVIS applied on its own " +
+            "(your own rules only, unless you are a super admin). A fact is never made a rule, whatever is asked.",
+        inputSchema: {
+            id: z.string().uuid().optional().describe("The id rename_pending returned."),
+            scope: z.enum(["page", "everywhere", "undo"]).describe("The human's choice."),
+            wrong_form: z.string().min(1).max(80).optional().describe("With right_form and scope undo only: remove an OLD rule of yours by its pair, instead of an id."),
+            right_form: z.string().min(1).max(80).optional().describe("See wrong_form."),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const byPair = args.id === undefined && args.wrong_form !== undefined && args.right_form !== undefined;
+        if (args.id === undefined && !(byPair && args.scope === "undo")) {
+            return errorResult("rename_resolve needs an id from rename_pending, or wrong_form and right_form with scope undo.");
+        }
+        const answer = await callAgentDoor(session, deps.fetchImpl, "POST", "/api/jarvis/rename-scope", args.id !== undefined
+            ? { pendingId: String(args.id), choice: String(args.scope) }
+            : { wrongForm: String(args.wrong_form), canonicalForm: String(args.right_form), choice: "undo" });
+        return answer.ok
+            ? dataResult("Correction answered", answer.body)
+            : errorResult(doorFailureText("rename_resolve", answer));
+    }));
+}

package/dist/server.js

@@ -31,6 +31,7 @@ import { registerSettingsWriteTools } from "./settings-write-tools.js";
 import { registerTeamWriteTools } from "./team-write-tools.js";
 import { registerWorkTools } from "./work-tools.js";
 import { registerCareersTools } from "./careers-tools.js";
+import { registerRenameTools } from "./rename-tools.js";
 import { registerUsageTools } from "./usage-tools.js";
 import { registerSourcesTools } from "./sources-tools.js";
 export const PACKAGE_NAME = "@bli-cockpit/mcp";
@@ -425,6 +426,9 @@ export function createServer(deps) {
     // file and move a Tower issue the way it files and moves a Linear one.
     registerWorkTools(server, { fetchImpl: deps.fetchImpl });
     registerCareersTools(server, deps);
+    // BLI-12378: the twins of `cockpit rename list|resolve`, the human's call on
+    // whether a correction becomes a rule.
+    registerRenameTools(server, deps);
     registerUsageTools(server, { fetchImpl: deps.fetchImpl });
     // BLI-3708: the mailboxes a person attached. Reads, a send and a sync over
     // the same /api/mail/** doors `cockpit mail` calls; `add-imap` deliberately

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", "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", "notes_show", "notes_shelf", "notes_shelves", "notes_place", "notes_accounts", "notes_sync_status", "notes_granola_status", "ops_status", "slack_coverage", "slack_read", "memory_profile", "memory_consolidation", "settings_show", "settings_list", "model_show", "team_members", "team_device_list", "scout_board", "workbook_read", "tower_search", "sources_check"];
+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", "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", "notes_show", "notes_shelf", "notes_shelves", "notes_place", "notes_accounts", "notes_sync_status", "notes_granola_status", "ops_status", "slack_coverage", "slack_read", "memory_profile", "memory_consolidation", "settings_show", "settings_list", "model_show", "team_members", "team_device_list", "scout_board", "workbook_read", "tower_search", "sources_check"];
 /**
  * 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", "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"];
+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", "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

@@ -29,6 +29,7 @@ export const READ_TOOLS = [
     "careers_resume_url",
     "careers_takehome_show",
     "careers_settings_show",
+    "rename_pending",
     "usage_people",
     "usage_sessions",
     "mail_accounts",
@@ -109,6 +110,7 @@ export const WRITE_TOOLS = [
     "careers_interview",
     "careers_takehome_set",
     "careers_settings_set",
+    "rename_resolve",
     "mail_send",
     "mail_sync",
     "mail_detach",

package/dist/verb-census.js

@@ -231,6 +231,9 @@ export const MCP_TWINS = {
     "careers takehome-set": { tool: "careers_takehome_set", door: "PUT /api/careers/takehomes/[role]" },
     "careers settings-show": { tool: "careers_settings_show", door: "GET /api/careers/settings" },
     "careers settings-set": { tool: "careers_settings_set", door: "PUT /api/careers/settings" },
+    // BLI-12378: the human's call on whether a correction becomes a rule.
+    "rename list": { tool: "rename_pending", door: "GET /api/jarvis/rename-scope" },
+    "rename resolve": { tool: "rename_resolve", door: "POST /api/jarvis/rename-scope" },
     "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" },

package/package.json

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