@bli-cockpit/mcp 0.1.47 → 0.1.49

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.**
+**100 of 105 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,15 @@ 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 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,65 @@ 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_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(),
+        },
+    }, 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/ops-tools.js

@@ -57,6 +57,8 @@ export function registerOpsTools(server, deps) {
             job: z.string().min(1).max(100).optional().describe("One pipeline id instead of the whole board."),
             skips: z.boolean().optional().describe("Also return the open ingest-skip ledgers."),
             memory: z.boolean().optional().describe("Also return memory adoption and observed prompt-hook outcomes, delay bounds and cache reuse. No memory text."),
+            turns: z.boolean().optional().describe("Also return 30-day JARVIS turn aggregates: latency, hops, tools, tokens and error classes."),
+            tool_router: z.boolean().optional().describe("Also return the seven-day shadow tool-router agreement board."),
         },
     }, async (args) => withSession(deps, async (session) => {
         const params = new URLSearchParams();
@@ -64,6 +66,8 @@ export function registerOpsTools(server, deps) {
             params.set("job", String(args.job));
         if (args.skips)
             params.set("skips", "1");
+        if (args.turns)
+            params.set("turns", "1");
         const response = await callAgentDoor(session, deps.fetchImpl, "GET", `/api/ops/status${queryString(params)}`);
         if (!response.ok)
             return errorResult(doorFailureText("ops_status", response));
@@ -100,6 +104,11 @@ export function registerOpsTools(server, deps) {
             ? await callAgentDoor(session, deps.fetchImpl, "GET", "/api/ops/memory-usage") : null;
         if (memory && !memory.ok)
             return errorResult(doorFailureText("ops_status memory", memory));
+        const toolRouter = args.tool_router
+            ? await callAgentDoor(session, deps.fetchImpl, "GET", "/api/ops/tool-router")
+            : null;
+        if (toolRouter && !toolRouter.ok)
+            return errorResult(doorFailureText("ops_status tool router", toolRouter));
         const experience = memory?.ok ? asRecord(memory.body.experience) : null;
         const experienceLines = experience ? ["EXPERIENCE", experience.summary, ...(Array.isArray(experience.lines) ? experience.lines : [])].join("\n") : "";
         const hooks = memory?.ok ? asRecord(memory.body.hooks) : null;
@@ -108,6 +117,18 @@ export function registerOpsTools(server, deps) {
                 const row = asRecord(device);
                 return [row.line, row.performanceLine].filter((line) => typeof line === "string").join("\n");
             }).join("\n") : "";
+        const turns = asRecord(body.turns);
+        const turnLine = args.turns
+            ? typeof turns.turns === "number"
+                ? `TURNS  ${turns.turns} turns / ${typeof turns.windowDays === "number" ? turns.windowDays : 30}d`
+                : "TURNS  not read (turns_section_absent)"
+            : "";
+        const toolRouterBoard = toolRouter?.ok ? asRecord(toolRouter.body.board) : null;
+        const toolRouterLine = args.tool_router
+            ? toolRouterBoard && typeof toolRouterBoard.turnsRouted === "number"
+                ? `TOOL ROUTER  ${toolRouterBoard.turnsRouted} routed`
+                : "TOOL ROUTER  not read (tool_router_section_absent)"
+            : "";
         // Both branches say something. A board that is entirely green and
         // reports nothing cannot answer "did anybody look today?".
         return textResult(`${rows.length} pipeline(s), ${unhealthy.length} unhealthy`
@@ -115,7 +136,9 @@ export function registerOpsTools(server, deps) {
             + `${lines ? `\n${lines}` : ""}`
             + `${ladderLine ? `\n${ladderLine}` : ""}`
             + `${memoryLines ? `\n${memoryLines}` : ""}`
-            + `${experienceLines ? `\n${experienceLines}` : ""}`, 
+            + `${experienceLines ? `\n${experienceLines}` : ""}`
+            + `${turnLine ? `\n${turnLine}` : ""}`
+            + `${toolRouterLine ? `\n${toolRouterLine}` : ""}`, 
         // The API owns the wording and the timing boundary on every surface.
         {
             pipelines: rows,
@@ -125,6 +148,8 @@ export function registerOpsTools(server, deps) {
             ...(body.skips ? { skips: body.skips } : {}),
             ...(body.ladder ? { ladder: body.ladder } : {}),
             ...(memory?.ok ? { memory: memory.body.memory, hooks: memory.body.hooks, experience: memory.body.experience } : {}),
+            ...(args.turns ? { turns: body.turns ?? null } : {}),
+            ...(toolRouter?.ok ? { toolRouter: toolRouter.body.board ?? null } : {}),
         });
     }));
     register("slack_coverage", {

package/dist/verb-census.js

@@ -212,6 +212,12 @@ 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 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 +345,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.47",
+  "version": "0.1.49",
   "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",