@bli-cockpit/mcp 0.1.54 → 0.1.57

package/README.md

@@ -34,7 +34,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**104 of 109 Tower verbs have an MCP twin.**
+**106 of 111 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
@@ -91,8 +91,10 @@ three tables below.
 | `cockpit mail search` | `mail_search` | `GET /api/mail/search` |
 | `cockpit mail send` | `mail_send` | `POST /api/mail/send` |
 | `cockpit mail sync` | `mail_sync` | `POST /api/mail/accounts/[id]/sync` |
+| `cockpit memory consolidation` | `memory_consolidation` | `GET /api/memory/consolidation` |
 | `cockpit memory forget` | `forget_memory` (`bli-memory`) | `POST /api/memory/forget` |
 | `cockpit memory log` | `memory_experience` | `POST /api/memory/experience` |
+| `cockpit memory profile` | `memory_profile` | `GET /api/memory/profile` |
 | `cockpit memory save` | `save_memory` (`bli-memory`) | `POST /api/memory/save` |
 | `cockpit memory search` | `search_memory` (`bli-memory`) | `POST /api/memory/search` |
 | `cockpit memory update` | `update_memory` (`bli-memory`) | `POST /api/memory/update` |

package/dist/memory-consolidation-tools.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `memory_consolidation` — the MCP twin of `cockpit memory consolidation`
+ * (BLI-4534).
+ *
+ * Same door, same device token, same answer: `GET /api/memory/consolidation`.
+ * It reads what the nightly BLI Memory tidy-up pass did — clusters looked at,
+ * edits by verb, refusals by reason, cost — and it cannot start, stop or
+ * change a pass. The pass itself is a Railway cron.
+ *
+ * It lives on `bli-tower` rather than on the `bli-memory` server that carries
+ * `search_memory`/`save_memory`/`update_memory`/`forget_memory`, because this
+ * is a read of a JOB's counts rather than a read or a write of the store.
+ *
+ * No memory text crosses this tool. The door does not send any.
+ */
+import { type ToolDeps } from "./tool-result.js";
+export declare function registerMemoryConsolidationTools(server: {
+    registerTool: (...args: never[]) => unknown;
+}, deps: ToolDeps): void;

package/dist/memory-consolidation-tools.js

@@ -0,0 +1,53 @@
+/**
+ * `memory_consolidation` — the MCP twin of `cockpit memory consolidation`
+ * (BLI-4534).
+ *
+ * Same door, same device token, same answer: `GET /api/memory/consolidation`.
+ * It reads what the nightly BLI Memory tidy-up pass did — clusters looked at,
+ * edits by verb, refusals by reason, cost — and it cannot start, stop or
+ * change a pass. The pass itself is a Railway cron.
+ *
+ * It lives on `bli-tower` rather than on the `bli-memory` server that carries
+ * `search_memory`/`save_memory`/`update_memory`/`forget_memory`, because this
+ * is a read of a JOB's counts rather than a read or a write of the store.
+ *
+ * No memory text crosses this tool. The door does not send any.
+ */
+import { z } from "zod";
+import { callAgentDoor } from "./agent-door.js";
+import { doorFailureText, errorResult, queryString, registrarFor, textResult, withSession, } from "./tool-result.js";
+export function registerMemoryConsolidationTools(server, deps) {
+    registrarFor(server)("memory_consolidation", {
+        title: "Read the nightly memory consolidation runs",
+        description: "What the nightly BLI Memory consolidation pass did: clusters, merges/rewrites/dated corrections by verb, refusals by reason, model and cost. With a container tag it answers that space's recent runs; without one, the newest run per container. Read-only — the pass never deletes a memory and this tool never starts one. An empty list means no run is visible to this account (the receipts are super_admin-readable), not an outage.",
+        inputSchema: {
+            container: z
+                .string()
+                .min(1)
+                .max(128)
+                .optional()
+                .describe("One container tag. Omit for the newest run per container."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(200)
+                .optional()
+                .describe("How many run rows to read. Default 50."),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const params = new URLSearchParams();
+        if (args.container)
+            params.set("container", String(args.container));
+        if (args.limit !== undefined)
+            params.set("limit", String(args.limit));
+        const response = await callAgentDoor(session, deps.fetchImpl, "GET", `/api/memory/consolidation${queryString(params)}`);
+        if (!response.ok)
+            return errorResult(doorFailureText("memory_consolidation", response));
+        const runs = Array.isArray(response.body.runs) ? response.body.runs : [];
+        const reason = typeof response.body.reason === "string" ? response.body.reason : "runs_read";
+        return textResult(runs.length === 0
+            ? `No consolidation runs are visible (${reason}). The pass is a nightly cron and its receipts are readable by a super_admin; this is the access rule answering, not an outage.`
+            : `${runs.length} consolidation run${runs.length === 1 ? "" : "s"}. report = proposals only, nothing on the shelf changed; apply = accepted edits written as supersessions, which never delete anything.`, response.body);
+    }));
+}

package/dist/memory-profile-tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `memory_profile` (BLI-4533) — the compiled one-page briefing for a memory
+ * space, over the same `GET /api/memory/profile` door `cockpit memory profile`
+ * calls.
+ *
+ * Every session already opens with this page injected by the session-start
+ * hook. This tool exists for the turn AFTER that: an agent that wants to know
+ * what a DIFFERENT project's memory says about itself, or one that wants to
+ * re-read its own briefing without trusting a context window that has since
+ * been compacted.
+ *
+ * It lives on `bli-tower` rather than on `bli-memory` for one reason: the four
+ * store tools on that server are the vendor-compatible set the Claude Code
+ * plugin expects, and this is ours. The DOOR is the same either way.
+ *
+ * Read-only, and there is no compile argument on purpose. The page is written
+ * once a day by the `memory-profile` Railway service; a tool that could trigger
+ * a compile would put a paid model call behind a sentence an agent types.
+ */
+import { type ToolDeps } from "./tool-result.js";
+export declare function registerMemoryProfileTools(server: {
+    registerTool: (...args: never[]) => unknown;
+}, deps: ToolDeps): void;

package/dist/memory-profile-tools.js

@@ -0,0 +1,65 @@
+/**
+ * `memory_profile` (BLI-4533) — the compiled one-page briefing for a memory
+ * space, over the same `GET /api/memory/profile` door `cockpit memory profile`
+ * calls.
+ *
+ * Every session already opens with this page injected by the session-start
+ * hook. This tool exists for the turn AFTER that: an agent that wants to know
+ * what a DIFFERENT project's memory says about itself, or one that wants to
+ * re-read its own briefing without trusting a context window that has since
+ * been compacted.
+ *
+ * It lives on `bli-tower` rather than on `bli-memory` for one reason: the four
+ * store tools on that server are the vendor-compatible set the Claude Code
+ * plugin expects, and this is ours. The DOOR is the same either way.
+ *
+ * Read-only, and there is no compile argument on purpose. The page is written
+ * once a day by the `memory-profile` Railway service; a tool that could trigger
+ * a compile would put a paid model call behind a sentence an agent types.
+ */
+import { z } from "zod";
+import { callAgentDoor } from "./agent-door.js";
+import { doorFailureText, errorResult, queryString, registrarFor, textResult, withSession, } from "./tool-result.js";
+export function registerMemoryProfileTools(server, deps) {
+    registrarFor(server)("memory_profile", {
+        title: "Read a memory space's compiled profile",
+        description: "The one-page briefing BLI Memory compiles daily for a container: who works here, what is going on now, "
+            + "standing rules and preferences, how to communicate. The same page a session start injects. Read-only — "
+            + "the compile runs on a cron, never on demand. A container with no page yet answers `not_compiled_yet`, "
+            + "which means nothing has been compiled, NOT that the store is down.",
+        inputSchema: {
+            container: z
+                .string()
+                .min(1)
+                .max(128)
+                .describe("The container tag, e.g. repo_bli_cockpit__12e241cdbc00adfd."),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const container = String(args.container);
+        const response = await callAgentDoor(session, deps.fetchImpl, "GET", `/api/memory/profile${queryString(new URLSearchParams({ container }))}`);
+        if (!response.ok)
+            return errorResult(doorFailureText("memory_profile", response));
+        const body = response.body;
+        const profile = body.profile ?? null;
+        const lines = profile?.lines ?? [];
+        if (lines.length === 0) {
+            // Named, not blank: the difference between "not compiled yet" and an
+            // empty page is the whole reason the door returns a reason at all.
+            return textResult(`No profile is compiled for ${container} yet (${String(body.reason ?? "unknown")}). `
+                + "The daily compile writes one once this space has memories.", { ok: true, containerTag: container, reason: body.reason ?? "unknown", lines: 0 });
+        }
+        return textResult([
+            ...lines,
+            "",
+            `Compiled ${String(profile?.compiledAt ?? "—")} from ${String(profile?.sourceRows ?? 0)} memories by ${String(profile?.model ?? "—")}.`,
+        ].join("\n"), {
+            ok: true,
+            containerTag: container,
+            reason: body.reason ?? "profile_read",
+            lines: lines.length,
+            compiledAt: profile?.compiledAt ?? null,
+            sourceRows: profile?.sourceRows ?? 0,
+            model: profile?.model ?? null,
+        });
+    }));
+}

package/dist/server.js

@@ -15,7 +15,9 @@ import { registerMailTools } from "./mail-tools.js";
 import { registerNotesAccountTools } from "./notes-account-tools.js";
 import { registerNotesTools } from "./notes-tools.js";
 import { registerNotesWriteTools } from "./notes-write-tools.js";
+import { registerMemoryConsolidationTools } from "./memory-consolidation-tools.js";
 import { registerMemoryExperienceTools } from "./memory-experience-tools.js";
+import { registerMemoryProfileTools } from "./memory-profile-tools.js";
 import { registerModelsTools } from "./models-tools.js";
 import { registerOpsTools } from "./ops-tools.js";
 import { registerPagesTools } from "./pages-tools.js";
@@ -423,6 +425,11 @@ export function createServer(deps) {
     registerNotesTools(server, { fetchImpl: deps.fetchImpl });
     registerOpsTools(server, { fetchImpl: deps.fetchImpl });
     registerMemoryExperienceTools(server, { fetchImpl: deps.fetchImpl });
+    // BLI-4533: the compiled one-page profile, the twin of `cockpit memory profile`.
+    registerMemoryProfileTools(server, { fetchImpl: deps.fetchImpl });
+    // BLI-4534: the nightly consolidation receipts, twin of `cockpit memory
+    // consolidation`. Read-only, and the pass it reports on never deletes.
+    registerMemoryConsolidationTools(server, { fetchImpl: deps.fetchImpl });
     registerSettingsTools(server, { fetchImpl: deps.fetchImpl });
     registerPagesTools(server, { fetchImpl: deps.fetchImpl });
     // BLI-3756 batch 2: the WRITES. Same doors, same device token, same refusal

package/dist/settings-write-tools.js

@@ -65,6 +65,7 @@ export function registerSettingsWriteTools(server, deps) {
             chat_model: z.string().min(3).max(200).optional().describe("personal/models: provider:model."),
             brief_model: z.string().min(3).max(200).optional().describe("personal: provider:model."),
             memory_model: z.string().min(1).max(200).optional().describe("models: the memory compiler's model id."),
+            note_reader_model: z.string().min(3).max(200).optional().describe("models: the meeting-note reader, provider:model from its allowlist."),
             key: z.string().min(1).max(200).optional().describe("switches: which switch."),
             value: z.string().min(1).max(200).optional().describe("switches: its new value."),
             version: z.string().min(1).max(50).optional().describe("cli-floor: the version every collector is pulled to."),
@@ -113,8 +114,10 @@ export function registerSettingsWriteTools(server, deps) {
                 }
                 if (args.memory_model)
                     body.memoryModel = String(args.memory_model);
+                if (args.note_reader_model)
+                    body.noteReaderModel = String(args.note_reader_model);
                 if (Object.keys(body).length === 0) {
-                    return errorResult("Refused (nothing_to_set): name chat_model or memory_model. Nothing was changed.");
+                    return errorResult("Refused (nothing_to_set): name chat_model, memory_model or note_reader_model. Nothing was changed.");
                 }
                 return write(deps, session, "settings_set", "POST", "/api/settings/model-routing", body, (answer) => {
                     const saved = Array.isArray(answer.saved) ? answer.saved.join(", ") : "";

package/dist/verb-census.js

@@ -300,6 +300,14 @@ export const MCP_TWINS = {
     "memory save": { tool: "save_memory", door: "POST /api/memory/save", server: "bli-memory" },
     "memory update": { tool: "update_memory", door: "POST /api/memory/update", server: "bli-memory" },
     "memory forget": { tool: "forget_memory", door: "POST /api/memory/forget", server: "bli-memory" },
+    // BLI-4533: the compiled one-page profile. Its twin is on `bli-tower`, not
+    // `bli-memory`: that server's four tools are the vendor-compatible set the
+    // Claude Code plugin expects, and this page is ours.
+    "memory profile": { tool: "memory_profile", door: "GET /api/memory/profile" },
+    // BLI-4534: the nightly consolidation receipts. This twin lives on
+    // `bli-tower` rather than `bli-memory`, because it is a read of a JOB s
+    // counts and not a read or write of the store itself.
+    "memory consolidation": { tool: "memory_consolidation", door: "GET /api/memory/consolidation" },
     "ops status": { tool: "ops_status", door: "GET /api/ops/status" },
     "ops recompile": { tool: "ops_recompile", door: "POST /api/ops/recompile" },
     "slack coverage": { tool: "slack_coverage", door: "GET /api/ops/slack/coverage" },

package/package.json

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