@bli-cockpit/mcp 0.1.48 → 0.1.50

package/README.md

@@ -34,7 +34,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**94 of 99 Tower verbs have an MCP twin.**
+**101 of 106 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
@@ -55,9 +55,16 @@ three tables below.
 | `cockpit cal sync` | `cal_sync` | `POST /api/cal/calendars/[id]/sync` |
 | `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 grade` | `careers_grade` | `POST /api/careers/applications/[id]/grade` |
+| `cockpit careers invite` | `careers_invite` | `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` |
+| `cockpit careers settings set` | `careers_settings_set` | `PUT /api/careers/settings` |
+| `cockpit careers settings show` | `careers_settings_show` | `GET /api/careers/settings` |
 | `cockpit careers show` | `careers_show` | `GET /api/careers/applications/[id]` |
+| `cockpit careers takehome set` | `careers_takehome_set` | `PUT /api/careers/takehomes/[role]` |
+| `cockpit careers takehome show` | `careers_takehome_show` | `GET /api/careers/takehomes/[role]` |
 | `cockpit correct` | `brief_correct` | `POST /api/jarvis/corrections` |
 | `cockpit docs create` | `docs_create` | `POST /api/docs/documents` |
 | `cockpit docs list` | `docs_list` | `GET /api/docs/documents` |

package/dist/careers-tools.d.ts

@@ -1,4 +1,14 @@
 import { type ToolDeps } from './tool-result.js';
+/**
+ * `careers_*` — the MCP twins of `cockpit careers`, over the same doors.
+ *
+ * BLI-4460 added the pipeline half: inviting, deciding, the role's take-home
+ * and the four settings. Nothing here decides policy — super_admin, the stage
+ * check and every threshold live on the server, so this surface cannot permit
+ * something the browser refuses. `careers_takehome_show` returns the RUBRIC,
+ * which is reviewer material: it is readable by a super_admin's agent and is
+ * never part of what a candidate receives.
+ */
 export declare function registerCareersTools(server: {
     registerTool: (...args: never[]) => unknown;
 }, deps: ToolDeps): void;

package/dist/careers-tools.js

@@ -1,11 +1,21 @@
 import { z } from 'zod';
 import { callAgentDoor } from './agent-door.js';
 import { doorFailureText, errorResult, registrarFor, textResult, withSession } from './tool-result.js';
+/**
+ * `careers_*` — the MCP twins of `cockpit careers`, over the same doors.
+ *
+ * BLI-4460 added the pipeline half: inviting, deciding, the role's take-home
+ * and the four settings. Nothing here decides policy — super_admin, the stage
+ * check and every threshold live on the server, so this surface cannot permit
+ * something the browser refuses. `careers_takehome_show` returns the RUBRIC,
+ * which is reviewer material: it is readable by a super_admin's agent and is
+ * never part of what a candidate receives.
+ */
 export function registerCareersTools(server, deps) {
     const register = registrarFor(server);
-    register('careers_list', { title: 'List applications', description: 'Super-admin only. Newest applications, bounded to 100 with total and has_more.', inputSchema: { role: z.string().optional(), min_score: z.number().min(0).max(100).optional(), since: z.string().optional() } }, async (args) => withSession(deps, async (session) => {
+    register('careers_list', { title: 'List applications', description: 'Super-admin only. Newest applications, bounded to 100 with total and has_more, plus the two thresholds in force.', inputSchema: { role: z.string().optional(), min_score: z.number().min(0).max(100).optional(), since: z.string().optional(), stage: z.string().optional() } }, async (args) => withSession(deps, async (session) => {
         const query = new URLSearchParams();
-        for (const key of ['role', 'min_score', 'since'])
+        for (const key of ['role', 'min_score', 'since', 'stage'])
             if (args[key] !== undefined)
                 query.set(key, String(args[key]));
         const answer = await callAgentDoor(session, deps.fetchImpl, 'GET', `/api/careers/applications?${query}`);
@@ -16,4 +26,75 @@ export function registerCareersTools(server, deps) {
             const answer = await callAgentDoor(session, deps.fetchImpl, action === 'show' ? 'GET' : 'POST', `/api/careers/applications/${encodeURIComponent(String(args.id))}${action === 'rescreen' ? '/rescreen' : ''}`, undefined, 60_000);
             return answer.ok ? textResult('Application', answer.body) : errorResult(doorFailureText(`careers_${action}`, answer));
         }));
+    register('careers_invite', {
+        title: 'Send the take-home',
+        description: 'Super-admin only. Sends that role\'s take-home invitation from the configured mailbox, whatever the screening scored. Only a row still at the `screened` stage; a row already invited is refused.',
+        inputSchema: { id: z.string().uuid() },
+    }, async (args) => withSession(deps, async (session) => {
+        const answer = await callAgentDoor(session, deps.fetchImpl, 'POST', `/api/careers/applications/${encodeURIComponent(String(args.id))}/invite`, undefined, 60_000);
+        return answer.ok ? textResult('Invitation sent', answer.body) : errorResult(doorFailureText('careers_invite', answer));
+    }));
+    register('careers_grade', {
+        title: 'Re-queue a take-home for grading',
+        description: 'Super-admin only. Puts one submitted or graded application back in the take-home grader\'s queue. The grader runs on Railway every 15 minutes because it clones a repository and reads a video; `now` is answered honestly rather than run here.',
+        inputSchema: { id: z.string().uuid(), now: z.boolean().optional() },
+    }, async (args) => withSession(deps, async (session) => {
+        const answer = await callAgentDoor(session, deps.fetchImpl, 'POST', `/api/careers/applications/${encodeURIComponent(String(args.id))}/grade`, { now: args.now === true }, 60_000);
+        return answer.ok ? textResult('Queued for grading', answer.body) : errorResult(doorFailureText('careers_grade', 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`.',
+        inputSchema: { id: z.string().uuid(), decision: z.enum(['passed_on', 'archived', 'reopen']) },
+    }, async (args) => withSession(deps, async (session) => {
+        const answer = await callAgentDoor(session, deps.fetchImpl, 'POST', `/api/careers/applications/${encodeURIComponent(String(args.id))}/decide`, { decision: args.decision });
+        return answer.ok ? textResult('Decision recorded', answer.body) : errorResult(doorFailureText('careers_decide', answer));
+    }));
+    register('careers_takehome_show', {
+        title: 'Show a role take-home',
+        description: 'Super-admin only. The subject, body, artifact link, reviewer rubric and pass score for one role. The rubric is reviewer material and never reaches a candidate.',
+        inputSchema: { role: z.string().min(1).max(200) },
+    }, async (args) => withSession(deps, async (session) => {
+        const answer = await callAgentDoor(session, deps.fetchImpl, 'GET', `/api/careers/takehomes/${encodeURIComponent(String(args.role))}`);
+        return answer.ok ? textResult('Take-home', answer.body) : errorResult(doorFailureText('careers_takehome_show', answer));
+    }));
+    register('careers_takehome_set', {
+        title: 'Edit a role take-home',
+        description: 'Super-admin only. Edits one role\'s take-home. A body must keep the {first_name} and {link} placeholders. A role nobody seeded is refused rather than created.',
+        inputSchema: {
+            role: z.string().min(1).max(200),
+            subject: z.string().min(1).max(998).optional(),
+            body_text: z.string().min(1).max(100_000).optional(),
+            artifact_link: z.string().url().max(2_000).optional(),
+            rubric_md: z.string().min(1).max(100_000).optional(),
+            pass_score: z.number().min(0).max(10).optional(),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const { role, ...patch } = args;
+        const answer = await callAgentDoor(session, deps.fetchImpl, 'PUT', `/api/careers/takehomes/${encodeURIComponent(String(role))}`, patch);
+        return answer.ok ? textResult('Take-home saved', answer.body) : errorResult(doorFailureText('careers_takehome_set', answer));
+    }));
+    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.',
+        inputSchema: {},
+    }, async () => withSession(deps, async (session) => {
+        const answer = await callAgentDoor(session, deps.fetchImpl, 'GET', '/api/careers/settings');
+        return answer.ok ? textResult('Careers settings', answer.body) : errorResult(doorFailureText('careers_settings_show', answer));
+    }));
+    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.',
+        inputSchema: {
+            auto_invite_enabled: z.boolean().optional(),
+            auto_invite_min_score: z.number().min(0).max(100).optional(),
+            attention_min_score: z.number().min(0).max(100).optional(),
+            invite_account_id: z.string().uuid().nullable().optional(),
+            booking_link: z.string().url().max(2000).nullable().optional(),
+            grader_model: z.string().min(3).max(200).optional(),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const answer = await callAgentDoor(session, deps.fetchImpl, 'PUT', '/api/careers/settings', args);
+        return answer.ok ? textResult('Careers settings saved', answer.body) : errorResult(doorFailureText('careers_settings_set', answer));
+    }));
 }

package/dist/verb-census.js

@@ -212,6 +212,13 @@ 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" },
+    "careers invite": { tool: "careers_invite", door: "POST /api/careers/applications/[id]/invite" },
+    "careers decide": { tool: "careers_decide", door: "POST /api/careers/applications/[id]/decide" },
+    "careers grade": { tool: "careers_grade", door: "POST /api/careers/applications/[id]/grade" },
+    "careers takehome-show": { tool: "careers_takehome_show", door: "GET /api/careers/takehomes/[role]" },
+    "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" },
     "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" },
@@ -339,6 +346,10 @@ export const MCP_TWINS = {
  * shorter this map is, the closer the census keys are to the product.
  */
 export const TYPED_SPELLING = {
+    "careers takehome-show": "careers takehome show",
+    "careers takehome-set": "careers takehome set",
+    "careers settings-show": "careers settings show",
+    "careers settings-set": "careers settings set",
     "settings show": "settings",
     "settings list": "settings env list",
     "settings set": "settings switches set",

package/package.json

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