@bli-cockpit/mcp 0.1.77 → 0.1.79

package/README.md

@@ -103,7 +103,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**115 of 120 Tower verbs have an MCP twin.**
+**117 of 122 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
@@ -129,7 +129,9 @@ three tables below.
 | `cockpit cal today` | `cal_today` | `GET /api/cal/today` |
 | `cockpit cal week` | `cal_week` | `GET /api/cal/week` |
 | `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` |

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
@@ -123,6 +123,37 @@ export function registerCareersTools(server, deps) {
         const expires = typeof body.expires_in === 'number' && body.expires_in > 0 ? body.expires_in : 60;
         return dataResult(`Resume link, valid for ${expires} seconds:`, { url: body.url, expires_in_seconds: expires });
     }));
+    // BLI-12183: the second-chance email, or a record that one went out by hand.
+    // Same door the drawer's Send follow-up and Already followed up controls call.
+    register('careers_followup', {
+        title: 'Send or record the follow-up',
+        description: 'Super-admin only. With no record_sent_at, sends the one second-chance email now, in the take-home thread, from the configured mailbox: only a row at `invited` with no follow-up yet. With record_sent_at, records a follow-up sent outside Tower at that instant and sends nothing. Either way a second follow-up is refused.',
+        inputSchema: {
+            id: APPLICATION_ID,
+            record_sent_at: z.string().min(1).max(40).optional().describe('ISO-8601 instant with an offset, e.g. 2026-10-03T08:00:00Z. Records a follow-up already sent outside Tower; sends nothing.'),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const body = args.record_sent_at === undefined ? {} : { record_sent_at: args.record_sent_at };
+        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`.',
@@ -157,7 +188,7 @@ export function registerCareersTools(server, deps) {
     }));
     register('careers_settings_show', {
         title: 'Show the careers settings',
-        description: 'Super-admin only. The automatic-invite bar, the attention threshold, whether automatic sending is on, and which mailbox it goes out from.',
+        description: 'Super-admin only. The automatic-invite bar, the attention threshold, whether automatic sending is on, which mailbox it goes out from, the booking link and grader model, and the three follow-up settings (followupEnabled, followupAfterDays, takehomeWindowHours).',
         inputSchema: {},
     }, async () => withSession(deps, async (session) => {
         const answer = await callAgentDoor(session, deps.fetchImpl, 'GET', '/api/careers/settings');
@@ -165,7 +196,7 @@ export function registerCareersTools(server, deps) {
     }));
     register('careers_settings_set', {
         title: 'Change the careers settings',
-        description: 'Super-admin only. Writes any of the four careers settings. Each takes effect on the next screening, with no deploy.',
+        description: 'Super-admin only. Writes any of the careers settings. Each takes effect on the next use, with no deploy.',
         inputSchema: {
             auto_invite_enabled: z.boolean().optional().describe('Send the take-home automatically to applicants over the auto-invite bar.'),
             auto_invite_min_score: z.number().min(0).max(100).optional().describe('The screening score (0-100) at or over which the take-home goes out automatically.'),
@@ -173,6 +204,9 @@ export function registerCareersTools(server, deps) {
             invite_account_id: z.string().uuid().nullable().optional().describe('The mailbox id (mail_accounts) invitations are sent from; null clears it.'),
             booking_link: z.string().url().max(2000).nullable().optional().describe('The interview booking link sent after a passing grade; null clears it.'),
             grader_model: z.string().min(3).max(200).optional().describe('The take-home grader model, provider:model (models_list ids).'),
+            followup_enabled: z.boolean().optional().describe('Send the one second-chance follow-up automatically to overdue invited candidates. Off by default.'),
+            followup_after_days: z.number().int().min(1).max(60).optional().describe('Whole days after the invitation before the follow-up is due (1-60).'),
+            takehome_window_hours: z.number().int().min(1).max(720).optional().describe('Hours a candidate has: the first deadline and the second-chance deadline (1-720).'),
         },
     }, async (args) => withSession(deps, async (session) => {
         const answer = await callAgentDoor(session, deps.fetchImpl, 'PUT', '/api/careers/settings', args);

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

@@ -105,6 +105,8 @@ export const WRITE_TOOLS = [
     "careers_invite",
     "careers_grade",
     "careers_decide",
+    "careers_followup",
+    "careers_interview",
     "careers_takehome_set",
     "careers_settings_set",
     "mail_send",

package/dist/verb-census.js

@@ -218,6 +218,10 @@ export const MCP_TWINS = {
     // README). `cockpit careers invite` and `careers_invite` are the older words
     // for the identical door, and both still work.
     "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

package/package.json

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