@bli-cockpit/mcp 0.1.78 → 0.1.80

package/README.md

@@ -103,7 +103,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**116 of 121 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
@@ -131,6 +131,7 @@ three tables below.
 | `cockpit careers decide` | `careers_decide` | `POST /api/careers/applications/[id]/decide` |
 | `cockpit careers followup` | `careers_followup` | `POST /api/careers/applications/[id]/followup` |
 | `cockpit careers grade` | `careers_grade` | `POST /api/careers/applications/[id]/grade` |
+| `cockpit careers interview` | `careers_interview` | `POST /api/careers/applications/[id]/interview` |
 | `cockpit careers send-takehome` | `careers_send_takehome` | `POST /api/careers/applications/[id]/invite` |
 | `cockpit careers list` | `careers_list` | `GET /api/careers/applications` |
 | `cockpit careers rescreen` | `careers_rescreen` | `POST /api/careers/applications/[id]/rescreen` |
@@ -208,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/careers-tools.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { callAgentDoor } from './agent-door.js';
 import { dataResult, doorFailureText, errorResult, registrarFor, withSession } from './tool-result.js';
 /** Verbatim from `lib/careers/applications.ts` `PIPELINE_STAGES`. */
-const PIPELINE_STAGES = ['screened', 'invited', 'submitted', 'graded', 'booking_sent', 'passed_on', 'archived'];
+const PIPELINE_STAGES = ['screened', 'invited', 'submitted', 'graded', 'booking_sent', 'interview', 'passed_on', 'archived'];
 const APPLICATION_ID = z.string().uuid().describe('An application id, as careers_list returns it.');
 /**
  * One list row without the screening's prose (BLI-10432). The door returns the
@@ -137,6 +137,23 @@ export function registerCareersTools(server, deps) {
         const answer = await callAgentDoor(session, deps.fetchImpl, 'POST', `/api/careers/applications/${encodeURIComponent(String(args.id))}/followup`, body, 60_000);
         return answer.ok ? dataResult(args.record_sent_at === undefined ? 'Follow-up sent' : 'Follow-up recorded', answer.body) : errorResult(doorFailureText('careers_followup', answer));
     }));
+    // BLI-12198: an interview Edward booked himself. Same door as the drawer's
+    // Interview booked control: `at` books or reschedules, `clear` undoes it.
+    register('careers_interview', {
+        title: 'Book, reschedule or clear an interview',
+        description: 'Super-admin only. With `at`, records an interview Edward booked himself: the row moves to the interview stage (any stage but archived), its chip reads Interview plus the time, and booking again reschedules. With `clear: true`, returns the row to the stage it stood at before. Exactly one of at or clear.',
+        inputSchema: {
+            id: APPLICATION_ID,
+            at: z.string().min(1).max(40).optional().describe('ISO-8601 instant with an offset, e.g. 2026-10-05T10:00:00-07:00. Books or reschedules the interview.'),
+            clear: z.boolean().optional().describe('true: remove the interview and return the row to its earlier stage. Not with at.'),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        if ((args.at === undefined) === (args.clear !== true))
+            return errorResult('careers_interview needs exactly one of at or clear: true.');
+        const body = args.clear === true ? { clear: true } : { at: args.at };
+        const answer = await callAgentDoor(session, deps.fetchImpl, 'POST', `/api/careers/applications/${encodeURIComponent(String(args.id))}/interview`, body, 60_000);
+        return answer.ok ? dataResult(args.clear === true ? 'Interview cleared' : 'Interview saved', answer.body) : errorResult(doorFailureText('careers_interview', answer));
+    }));
     register('careers_decide', {
         title: 'Decide on an application',
         description: 'Super-admin only. Records the call on one application: `passed_on`, `archived`, or `reopen` to put it back at `screened`.',

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_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",
@@ -106,8 +107,10 @@ export const WRITE_TOOLS = [
     "careers_grade",
     "careers_decide",
     "careers_followup",
+    "careers_interview",
     "careers_takehome_set",
     "careers_settings_set",
+    "rename_resolve",
     "mail_send",
     "mail_sync",
     "mail_detach",

package/dist/verb-census.js

@@ -220,6 +220,8 @@ export const MCP_TWINS = {
     "careers invite": { tool: "careers_send_takehome", door: "POST /api/careers/applications/[id]/invite" },
     // BLI-12183: the second-chance follow-up, sent now or recorded as sent elsewhere.
     "careers followup": { tool: "careers_followup", door: "POST /api/careers/applications/[id]/followup" },
+    // BLI-12198: an interview Edward booked himself, booked, rescheduled or cleared.
+    "careers interview": { tool: "careers_interview", door: "POST /api/careers/applications/[id]/interview" },
     "careers decide": { tool: "careers_decide", door: "POST /api/careers/applications/[id]/decide" },
     "careers grade": { tool: "careers_grade", door: "POST /api/careers/applications/[id]/grade" },
     // BLI-4462: the drawer's Open resume button, typed. Both twins call the door
@@ -229,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.78",
+  "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",
@@ -30,7 +30,7 @@
     "readme": "npm run build && node scripts/write-readme-census.mjs"
   },
   "dependencies": {
-    "@bli-cockpit/telemetry-core": "0.1.56",
+    "@bli-cockpit/telemetry-core": "0.1.57",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6"
   },
@@ -38,5 +38,10 @@
     "@types/node": "^20",
     "typescript": "^5",
     "vitest": "^3.2.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BLI-INC/bli-cockpit.git",
+    "directory": "packages/bli-cockpit-mcp"
   }
 }