@bli-cockpit/mcp 0.1.18 → 0.1.20

package/README.md

@@ -34,7 +34,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**73 of 76 Tower verbs have an MCP twin.**
+**74 of 77 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
@@ -78,6 +78,7 @@ 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 log` | `memory_experience` | `POST /api/memory/experience` |
 | `cockpit model set` | `model_set` | `POST /api/settings/jarvis-model` |
 | `cockpit model show` | `model_show` | `GET /api/settings/jarvis-model` |
 | `cockpit msg channels` | `msg_channels` | `GET /api/msg/channels` |

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

@@ -0,0 +1,6 @@
+import { type ToolDeps } from "./tool-result.js";
+export declare function registerMemoryExperienceTools(server: {
+    registerTool: (...args: never[]) => unknown;
+}, deps: ToolDeps & {
+    homeDir?: string;
+}): void;

package/dist/memory-experience-tools.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { appendExperience, shipExperience } from "@bli-cockpit/telemetry-core/memory-experience";
+import { callAgentDoor } from "./agent-door.js";
+import { loadAgentDoorSession } from "./agent-door-session.js";
+import { registrarFor, textResult } from "./tool-result.js";
+export function registerMemoryExperienceTools(server, deps) {
+    registrarFor(server)("memory_experience", {
+        title: "Log a memory-store experience",
+        description: "Append an experience receipt locally and post to Tower. Offline receipts ship on the next collector sync. Copy the recall marker: [bli] = BLI Memory, ◪ = Supermemory. Opinions only; never prompts, memory bodies or secrets.",
+        inputSchema: { store: z.enum(["bli", "supermemory", "both"]), verdict: z.enum(["win", "loss", "noise"]), reason: z.string().min(1).max(500) },
+    }, async (args) => {
+        const entry = await appendExperience({ store: args.store, verdict: args.verdict, reason: String(args.reason) }, { homeDir: deps.homeDir, agent: "MCP", project: "workspace" });
+        const delivery = await shipExperience(entry, async (body) => {
+            const session = (deps.loadSession ?? loadAgentDoorSession)();
+            if (!session.ok)
+                return { ok: false, reason: session.reason };
+            const result = await callAgentDoor(session.session, deps.fetchImpl, "POST", "/api/memory/experience", body, 5000);
+            return { ok: result.ok && result.body.ok === true, reason: result.transportError ?? String(result.body.error ?? "experience_refused") };
+        }, deps.homeDir);
+        const receipt = { ok: true, id: entry.id, local: true, ...delivery };
+        console.error("[memory experience] recorded", JSON.stringify(receipt));
+        return textResult(`Experience appended; shipped: ${delivery.shipped} (${delivery.reason}).`, receipt);
+    });
+}

package/dist/ops-tools.js

@@ -77,6 +77,8 @@ 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 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;
         const memoryLines = hooks && Array.isArray(hooks.devices)
             ? hooks.devices.map((device) => {
@@ -88,7 +90,8 @@ export function registerOpsTools(server, deps) {
         return textResult(`${rows.length} pipeline(s), ${unhealthy.length} unhealthy`
             + `${unhealthy.length > 0 ? `: ${unhealthy.map((row) => row.id ?? "?").join(", ")}` : "."}`
             + `${lines ? `\n${lines}` : ""}`
-            + `${memoryLines ? `\n${memoryLines}` : ""}`, 
+            + `${memoryLines ? `\n${memoryLines}` : ""}`
+            + `${experienceLines ? `\n${experienceLines}` : ""}`, 
         // The API owns the wording and the timing boundary on every surface.
         {
             pipelines: rows,
@@ -96,7 +99,7 @@ export function registerOpsTools(server, deps) {
             ...(body.fleet ? { fleet: body.fleet } : {}),
             ...(body.coverage ? { coverage: body.coverage } : {}),
             ...(body.skips ? { skips: body.skips } : {}),
-            ...(memory?.ok ? { memory: memory.body.memory, hooks: memory.body.hooks } : {}),
+            ...(memory?.ok ? { memory: memory.body.memory, hooks: memory.body.hooks, experience: memory.body.experience } : {}),
         });
     }));
     register("slack_coverage", {

package/dist/server.js

@@ -14,6 +14,7 @@ import { registerCalTools } from "./cal-tools.js";
 import { registerMailTools } from "./mail-tools.js";
 import { registerNotesTools } from "./notes-tools.js";
 import { registerNotesWriteTools } from "./notes-write-tools.js";
+import { registerMemoryExperienceTools } from "./memory-experience-tools.js";
 import { registerOpsTools } from "./ops-tools.js";
 import { registerPagesTools } from "./pages-tools.js";
 import { registerSearchTool } from "./search-tool.js";
@@ -411,6 +412,7 @@ export function createServer(deps) {
     registerBriefTools(server, { fetchImpl: deps.fetchImpl });
     registerNotesTools(server, { fetchImpl: deps.fetchImpl });
     registerOpsTools(server, { fetchImpl: deps.fetchImpl });
+    registerMemoryExperienceTools(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/verb-census.js

@@ -88,15 +88,57 @@ function commandVariants() {
         if (start < 0)
             continue;
         const end = source.indexOf("\nexport ", start + 10);
-        return source.slice(start, end < 0 ? undefined : end).split(/\n\s{2}\|\s/);
+        return source
+            .slice(start, end < 0 ? undefined : end)
+            .split(/\n\s{2}\|\s/)
+            .map((variant) => resolveShapeAlias(variant, source));
     }
     throw new Error("LocalCommand union not found in local-command-shapes.ts or local-args.ts");
 }
+/**
+ * A union member that is a bare NAME rather than an inline object.
+ *
+ * BLI-3880 wrote `cockpit search`'s shape as its own exported interface in a
+ * sibling file (`local-command-shapes-search.ts`) and put `| SearchCommandShape`
+ * in the union — perfectly ordinary TypeScript, and invisible to a census that
+ * only looks for an inline `kind: "…"`. That silence was not silent for long:
+ * `towerVerbs` throws when a noun has no variant, which is exactly what it did.
+ * Rather than teach the union one spelling, this follows the alias: find the
+ * import that names it, read that file, and hand back the interface body so
+ * every regex below sees the same thing it would have seen inline.
+ *
+ * A name that cannot be followed is returned unchanged, so it still reaches
+ * the "no LocalCommand variant" error rather than disappearing quietly.
+ */
+function resolveShapeAlias(variant, unionSource) {
+    // The chunk is the alias NAME plus whatever comment introduces the next
+    // union member, because the split is on `\n  | `. Only the first line is the
+    // member itself.
+    const firstLine = variant.split("\n").find((line) => line.trim().length > 0) ?? "";
+    const name = /^\s*([A-Z][A-Za-z0-9_]*)\s*;?\s*$/.exec(firstLine)?.[1];
+    if (!name)
+        return variant;
+    const from = new RegExp(`import type \\{[^}]*\\b${name}\\b[^}]*\\} from "\\.\\/([\\w.-]+)\\.js"`).exec(unionSource)?.[1];
+    if (!from)
+        return variant;
+    let source;
+    try {
+        source = readFileSync(join(COLLECTOR_COMMANDS_DIR, `${from}.ts`), "utf8");
+    }
+    catch {
+        return variant;
+    }
+    const start = source.indexOf(`export interface ${name} {`);
+    if (start < 0)
+        return variant;
+    const end = source.indexOf("\n}", start);
+    return source.slice(start, end < 0 ? undefined : end);
+}
 /** Every Tower verb a person may type today. */
 export function towerVerbs() {
     const nouns = new Set(towerNouns());
     const aliases = actionAliases();
-    const verbs = [];
+    const verbs = [{ noun: "memory", action: "log", spelling: "memory log" }];
     const seenNouns = new Set();
     for (const variant of commandVariants()) {
         const kind = /kind:\s*"([a-z-]+)"/.exec(variant)?.[1];
@@ -179,6 +221,7 @@ export const MCP_TWINS = {
     "notes share": { tool: "notes_share", door: "POST /api/notes/share" },
     "notes unshare": { tool: "notes_unshare", door: "POST /api/notes/share (share=false)" },
     "notes move": { tool: "notes_move", door: "POST /api/notes/move" },
+    "memory log": { tool: "memory_experience", door: "POST /api/memory/experience" },
     "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.18",
+  "version": "0.1.20",
   "private": false,
   "description": "bli-tower \u2014 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.34",
+    "@bli-cockpit/telemetry-core": "0.1.36",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6"
   },