@bli-cockpit/mcp 0.1.61 → 0.1.63

package/README.md

@@ -103,7 +103,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**107 of 112 Tower verbs have an MCP twin.**
+**109 of 114 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
@@ -139,8 +139,10 @@ three tables below.
 | `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 link` | `docs_link` | `PUT /api/docs/documents/[id]/notion-link` |
 | `cockpit docs list` | `docs_list` | `GET /api/docs/documents` |
 | `cockpit docs read` | `docs_read` | `GET /api/docs/documents/[id]` |
+| `cockpit docs sync-status` | `docs_sync_status` | `GET /api/docs/notion-sync` |
 | `cockpit docs tree` | `docs_tree` | `GET /api/docs/tree` |
 | `cockpit docs update` | `docs_update` | `PATCH /api/docs/documents/[id]` |
 | `cockpit issue comment` | `work_comment_issue` | `POST /api/work/issues/[id]/comments` |
@@ -382,6 +384,8 @@ narrowing who can read something.
 | `docs_read` | `GET /api/docs/documents/[id]` | One document's title and full body, by id or slug (resolved against `docs_list` first). |
 | `docs_create` | `POST /api/docs/documents` | Creates a document. Omitting `body_markdown` creates an empty one. |
 | `docs_update` | `PATCH /api/docs/documents/[id]` | Updates title/body/visibility/parent (a parent change IS a move). Emptying a document that holds text needs `allow_empty: true` (BLI-3757's guard). |
+| `docs_link` | `PUT`/`DELETE /api/docs/documents/[id]/notion-link` | Ties a document to a Notion page for the two-way sync (`notion_page`: a URL or page id), or unties it with `clear: true`. The page becomes the truth: the next sync pulls it over the copy and keeps the copy as a version. |
+| `docs_sync_status` | `GET /api/docs/notion-sync` | Every linked document's sync state (`synced` / `tower_changed` / `never_synced`), or one's by `id`. Tower's half only; metadata, never a body. |
 | `msg_channels` | `GET /api/msg/channels` | Every channel you are a member of. |
 | `msg_read` | `GET /api/msg/channels/[id]/messages` | Recent messages of one channel, newest first. `channel` is an id or a `#name`. |
 | `msg_thread` | `GET /api/msg/channels/[id]/messages?thread_parent_id=` | One thread's replies, oldest first, so it reads as a conversation. |

package/dist/docs-msg-helpers.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Helpers behind the `docs_*` and `msg_*` tools (split out of
+ * `docs-msg-tools.ts` to keep it under the file-size ratchet): id resolution,
+ * list shaping and one-line renderers. No tool is registered here.
+ */
+import { type ToolDeps } from "./tool-result.js";
+/** A canonical uuid: a ref that already IS an id needs no list read to resolve. */
+export declare const UUID_PATTERN: RegExp;
+/** The door's own ceiling on `?limit=` (`/api/docs/documents` `DOCUMENT_LIST_MAX_LIMIT`). */
+export declare const DOCS_LIST_MAX = 1000;
+export type DocsMsgDeps = ToolDeps;
+/** One node of `GET /api/docs/tree`. The door nests; nothing here re-nests. */
+export interface DocTreeNode {
+    id: string;
+    title: string;
+    slug: string | null;
+    children: DocTreeNode[];
+}
+/**
+ * The tree as the text half prints it: id, title, slug, children. The door
+ * also sends visibility, source and a timestamp per node, which nothing here
+ * promised and which made the structured half 48 KB for 226 documents
+ * (BLI-10432). `docs_list` carries those fields for a flat read.
+ */
+export declare function slimTree(nodes: DocTreeNode[]): DocTreeNode[];
+/** Indented lines, deepest last — the same shape `cockpit docs tree` prints. */
+export declare function renderDocTree(nodes: DocTreeNode[], depth: number): string;
+export declare function countTree(nodes: DocTreeNode[]): number;
+export interface DocRow {
+    id: string;
+    title: string;
+    slug: string | null;
+    visibility: string;
+    source?: string | null;
+    parent_id?: string | null;
+    updated_at: string;
+    /** BLI-3737: the body's length, the one fact about a body the LIST still carries. */
+    body_chars?: number;
+}
+/**
+ * The fields `docs_list` promises, and only those. The door's row also carries
+ * `created_by`, `updated_by`, `created_at`, `import_truncated` and
+ * `missing_block_count`: 105 KB for 226 documents before this (BLI-10432).
+ */
+export declare function docListRow(row: DocRow): Record<string, unknown>;
+export declare function docListLine(row: DocRow): string;
+/**
+ * `docs_list`'s narrowing, as the door's own query parameters (BLI-3737).
+ * The list itself is metadata only — asking for a whole library used to cost
+ * every document's prose, so an agent that wants one folder or one phrase
+ * says so here and the database does the filtering.
+ */
+export declare function docsListPath(args: {
+    parent_id?: unknown;
+    query?: unknown;
+    limit?: unknown;
+}): string;
+export declare function resolveDocumentId(deps: DocsMsgDeps, session: {
+    dashboardUrl: string;
+    deviceToken: string;
+}, ref: string): Promise<{
+    status: "ok";
+    id: string;
+} | {
+    status: "not_found";
+} | {
+    status: "list_failed";
+    text: string;
+}>;
+export interface ChannelRow {
+    id: string;
+    name: string | null;
+    is_private: boolean;
+    is_dm: boolean;
+}
+export declare function resolveChannelId(deps: DocsMsgDeps, session: {
+    dashboardUrl: string;
+    deviceToken: string;
+}, ref: string): Promise<{
+    status: "ok";
+    id: string;
+} | {
+    status: "not_found";
+} | {
+    status: "list_failed";
+    text: string;
+}>;
+/** One message as a line: id (msg_thread's `thread_parent_id`), time, author, text. */
+export declare function messageLine(message: Record<string, unknown>): string;

package/dist/docs-msg-helpers.js

@@ -0,0 +1,106 @@
+/**
+ * Helpers behind the `docs_*` and `msg_*` tools (split out of
+ * `docs-msg-tools.ts` to keep it under the file-size ratchet): id resolution,
+ * list shaping and one-line renderers. No tool is registered here.
+ */
+import { callAgentDoor } from "./agent-door.js";
+import { DEFAULT_LIST_LIMIT, doorFailureText } from "./tool-result.js";
+/** A canonical uuid: a ref that already IS an id needs no list read to resolve. */
+export const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
+/** The door's own ceiling on `?limit=` (`/api/docs/documents` `DOCUMENT_LIST_MAX_LIMIT`). */
+export const DOCS_LIST_MAX = 1000;
+/**
+ * The tree as the text half prints it: id, title, slug, children. The door
+ * also sends visibility, source and a timestamp per node, which nothing here
+ * promised and which made the structured half 48 KB for 226 documents
+ * (BLI-10432). `docs_list` carries those fields for a flat read.
+ */
+export function slimTree(nodes) {
+    return nodes.map((node) => ({
+        id: node.id,
+        title: node.title,
+        slug: node.slug ?? null,
+        children: slimTree(Array.isArray(node.children) ? node.children : []),
+    }));
+}
+/** Indented lines, deepest last — the same shape `cockpit docs tree` prints. */
+export function renderDocTree(nodes, depth) {
+    return nodes
+        .map((node) => {
+        const line = `${"  ".repeat(depth)}${node.title} (${node.slug ?? node.id})`;
+        const children = node.children?.length ? `\n${renderDocTree(node.children, depth + 1)}` : "";
+        return `${line}${children}`;
+    })
+        .join("\n");
+}
+export function countTree(nodes) {
+    return nodes.reduce((count, node) => count + 1 + countTree(node.children ?? []), 0);
+}
+/**
+ * The fields `docs_list` promises, and only those. The door's row also carries
+ * `created_by`, `updated_by`, `created_at`, `import_truncated` and
+ * `missing_block_count`: 105 KB for 226 documents before this (BLI-10432).
+ */
+export function docListRow(row) {
+    return {
+        id: row.id,
+        slug: row.slug ?? null,
+        title: row.title,
+        visibility: row.visibility,
+        source: row.source ?? null,
+        parent_id: row.parent_id ?? null,
+        updated_at: row.updated_at,
+        body_chars: row.body_chars ?? null,
+    };
+}
+export function docListLine(row) {
+    return `${row.id}  ${row.slug ?? "-"}  ${row.title}  [${row.visibility}${row.source ? `, ${row.source}` : ""}, `
+        + `${row.body_chars ?? "?"} chars, parent ${row.parent_id ?? "root"}, updated ${row.updated_at}]`;
+}
+/**
+ * `docs_list`'s narrowing, as the door's own query parameters (BLI-3737).
+ * The list itself is metadata only — asking for a whole library used to cost
+ * every document's prose, so an agent that wants one folder or one phrase
+ * says so here and the database does the filtering.
+ */
+export function docsListPath(args) {
+    const params = new URLSearchParams();
+    if (typeof args.parent_id === "string" && args.parent_id.length > 0)
+        params.set("parent_id", args.parent_id);
+    if (typeof args.query === "string" && args.query.trim().length > 0)
+        params.set("query", args.query);
+    if (typeof args.limit === "number" && Number.isInteger(args.limit))
+        params.set("limit", String(args.limit));
+    // No limit named: one page plus one row, so "more exist" is read off the
+    // door instead of guessed from a full page (BLI-10432).
+    else if (args.limit === undefined)
+        params.set("limit", String(DEFAULT_LIST_LIMIT + 1));
+    const search = params.toString();
+    return search.length > 0 ? `/api/docs/documents?${search}` : "/api/docs/documents";
+}
+export async function resolveDocumentId(deps, session, ref) {
+    // An id needs no lookup: the read itself answers 404 by name when it is
+    // wrong. Only a slug costs the whole-library list read (BLI-10432).
+    if (UUID_PATTERN.test(ref))
+        return { status: "ok", id: ref };
+    const response = await callAgentDoor(session, deps.fetchImpl, "GET", "/api/docs/documents");
+    if (!response.ok)
+        return { status: "list_failed", text: doorFailureText("docs_list", response) };
+    const documents = (Array.isArray(response.body.documents) ? response.body.documents : []);
+    const match = documents.find((doc) => doc.id === ref || doc.slug === ref);
+    return match ? { status: "ok", id: match.id } : { status: "not_found" };
+}
+export async function resolveChannelId(deps, session, ref) {
+    const response = await callAgentDoor(session, deps.fetchImpl, "GET", "/api/msg/channels");
+    if (!response.ok)
+        return { status: "list_failed", text: doorFailureText("msg_channels", response) };
+    const channels = (Array.isArray(response.body.channels) ? response.body.channels : []);
+    const bare = ref.startsWith("#") ? ref.slice(1) : ref;
+    const match = channels.find((channel) => channel.id === ref || channel.name === bare);
+    return match ? { status: "ok", id: match.id } : { status: "not_found" };
+}
+/** One message as a line: id (msg_thread's `thread_parent_id`), time, author, text. */
+export function messageLine(message) {
+    return `${String(message.id ?? "?")}  ${String(message.created_at ?? "?")}  `
+        + `${String(message.agent_label ?? message.user_id ?? "?")}  ${String(message.content ?? "")}`;
+}

package/dist/docs-msg-tools.d.ts

@@ -9,19 +9,9 @@
  * on a machine with no collector pairing at all, so a missing session must
  * fail the ONE call that needed it, never the whole process.
  */
-import { type ToolDeps } from "./tool-result.js";
-export type DocsMsgDeps = ToolDeps;
-/**
- * `docs_list`'s narrowing, as the door's own query parameters (BLI-3737).
- * The list itself is metadata only — asking for a whole library used to cost
- * every document's prose, so an agent that wants one folder or one phrase
- * says so here and the database does the filtering.
- */
-export declare function docsListPath(args: {
-    parent_id?: unknown;
-    query?: unknown;
-    limit?: unknown;
-}): string;
+import { type DocsMsgDeps } from "./docs-msg-helpers.js";
+export { docsListPath } from "./docs-msg-helpers.js";
+export type { DocsMsgDeps } from "./docs-msg-helpers.js";
 export declare function registerDocsMsgTools(server: {
     registerTool: (...args: never[]) => unknown;
 }, deps: DocsMsgDeps): void;

package/dist/docs-msg-tools.js

@@ -12,105 +12,8 @@
 import { z } from "zod";
 import { callAgentDoor } from "./agent-door.js";
 import { DEFAULT_LIST_LIMIT, doorFailureText, errorResult, moreNote, registrarFor, textResult, withSession, } from "./tool-result.js";
-/** A canonical uuid: a ref that already IS an id needs no list read to resolve. */
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
-/** The door's own ceiling on `?limit=` (`/api/docs/documents` `DOCUMENT_LIST_MAX_LIMIT`). */
-const DOCS_LIST_MAX = 1000;
-/**
- * The tree as the text half prints it: id, title, slug, children. The door
- * also sends visibility, source and a timestamp per node, which nothing here
- * promised and which made the structured half 48 KB for 226 documents
- * (BLI-10432). `docs_list` carries those fields for a flat read.
- */
-function slimTree(nodes) {
-    return nodes.map((node) => ({
-        id: node.id,
-        title: node.title,
-        slug: node.slug ?? null,
-        children: slimTree(Array.isArray(node.children) ? node.children : []),
-    }));
-}
-/** Indented lines, deepest last — the same shape `cockpit docs tree` prints. */
-function renderDocTree(nodes, depth) {
-    return nodes
-        .map((node) => {
-        const line = `${"  ".repeat(depth)}${node.title} (${node.slug ?? node.id})`;
-        const children = node.children?.length ? `\n${renderDocTree(node.children, depth + 1)}` : "";
-        return `${line}${children}`;
-    })
-        .join("\n");
-}
-function countTree(nodes) {
-    return nodes.reduce((count, node) => count + 1 + countTree(node.children ?? []), 0);
-}
-/**
- * The fields `docs_list` promises, and only those. The door's row also carries
- * `created_by`, `updated_by`, `created_at`, `import_truncated` and
- * `missing_block_count`: 105 KB for 226 documents before this (BLI-10432).
- */
-function docListRow(row) {
-    return {
-        id: row.id,
-        slug: row.slug ?? null,
-        title: row.title,
-        visibility: row.visibility,
-        source: row.source ?? null,
-        parent_id: row.parent_id ?? null,
-        updated_at: row.updated_at,
-        body_chars: row.body_chars ?? null,
-    };
-}
-function docListLine(row) {
-    return `${row.id}  ${row.slug ?? "-"}  ${row.title}  [${row.visibility}${row.source ? `, ${row.source}` : ""}, `
-        + `${row.body_chars ?? "?"} chars, parent ${row.parent_id ?? "root"}, updated ${row.updated_at}]`;
-}
-/**
- * `docs_list`'s narrowing, as the door's own query parameters (BLI-3737).
- * The list itself is metadata only — asking for a whole library used to cost
- * every document's prose, so an agent that wants one folder or one phrase
- * says so here and the database does the filtering.
- */
-export function docsListPath(args) {
-    const params = new URLSearchParams();
-    if (typeof args.parent_id === "string" && args.parent_id.length > 0)
-        params.set("parent_id", args.parent_id);
-    if (typeof args.query === "string" && args.query.trim().length > 0)
-        params.set("query", args.query);
-    if (typeof args.limit === "number" && Number.isInteger(args.limit))
-        params.set("limit", String(args.limit));
-    // No limit named: one page plus one row, so "more exist" is read off the
-    // door instead of guessed from a full page (BLI-10432).
-    else if (args.limit === undefined)
-        params.set("limit", String(DEFAULT_LIST_LIMIT + 1));
-    const search = params.toString();
-    return search.length > 0 ? `/api/docs/documents?${search}` : "/api/docs/documents";
-}
-async function resolveDocumentId(deps, session, ref) {
-    // An id needs no lookup: the read itself answers 404 by name when it is
-    // wrong. Only a slug costs the whole-library list read (BLI-10432).
-    if (UUID_PATTERN.test(ref))
-        return { status: "ok", id: ref };
-    const response = await callAgentDoor(session, deps.fetchImpl, "GET", "/api/docs/documents");
-    if (!response.ok)
-        return { status: "list_failed", text: doorFailureText("docs_list", response) };
-    const documents = (Array.isArray(response.body.documents) ? response.body.documents : []);
-    const match = documents.find((doc) => doc.id === ref || doc.slug === ref);
-    return match ? { status: "ok", id: match.id } : { status: "not_found" };
-}
-async function resolveChannelId(deps, session, ref) {
-    const response = await callAgentDoor(session, deps.fetchImpl, "GET", "/api/msg/channels");
-    if (!response.ok)
-        return { status: "list_failed", text: doorFailureText("msg_channels", response) };
-    const channels = (Array.isArray(response.body.channels) ? response.body.channels : []);
-    const bare = ref.startsWith("#") ? ref.slice(1) : ref;
-    const match = channels.find((channel) => channel.id === ref || channel.name === bare);
-    return match ? { status: "ok", id: match.id } : { status: "not_found" };
-}
-/** One message as a line: id (msg_thread's `thread_parent_id`), time, author, text. */
-function messageLine(message) {
-    return `${String(message.id ?? "?")}  ${String(message.created_at ?? "?")}  `
-        + `${String(message.agent_label ?? message.user_id ?? "?")}  ${String(message.content ?? "")}`;
-}
+import { DOCS_LIST_MAX, slimTree, renderDocTree, countTree, docListRow, docListLine, resolveDocumentId, resolveChannelId, messageLine, docsListPath } from "./docs-msg-helpers.js";
+export { docsListPath } from "./docs-msg-helpers.js";
 export function registerDocsMsgTools(server, deps) {
     const register = registrarFor(server);
     register("docs_list", {

package/dist/docs-notion-tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The Notion half of the `docs_*` tools (BLI-10430) — the same door
+ * `cockpit docs link` calls, over this machine's device token. A sibling of
+ * `docs-msg-tools.ts` rather than more of it, the same split the collector
+ * makes (`commands/docs-notion.ts`).
+ *
+ * `docs_link` → `PUT /api/docs/documents/[id]/notion-link` (or `DELETE` with
+ * `clear: true`). A link makes the Notion page the truth: the next sync pulls
+ * it over the Tower copy and keeps the copy as a version.
+ * `docs_sync_status` → `GET /api/docs/notion-sync[?document_id=]`: Tower's half
+ * of the sync state, metadata only.
+ */
+import { type DocsMsgDeps } from "./docs-msg-helpers.js";
+export declare function registerDocsNotionTools(server: {
+    registerTool: (...args: never[]) => unknown;
+}, deps: DocsMsgDeps): void;

package/dist/docs-notion-tools.js

@@ -0,0 +1,89 @@
+/**
+ * The Notion half of the `docs_*` tools (BLI-10430) — the same door
+ * `cockpit docs link` calls, over this machine's device token. A sibling of
+ * `docs-msg-tools.ts` rather than more of it, the same split the collector
+ * makes (`commands/docs-notion.ts`).
+ *
+ * `docs_link` → `PUT /api/docs/documents/[id]/notion-link` (or `DELETE` with
+ * `clear: true`). A link makes the Notion page the truth: the next sync pulls
+ * it over the Tower copy and keeps the copy as a version.
+ * `docs_sync_status` → `GET /api/docs/notion-sync[?document_id=]`: Tower's half
+ * of the sync state, metadata only.
+ */
+import { z } from "zod";
+import { callAgentDoor } from "./agent-door.js";
+import { resolveDocumentId } from "./docs-msg-helpers.js";
+import { doorFailureText, errorResult, registrarFor, textResult, withSession } from "./tool-result.js";
+export function registerDocsNotionTools(server, deps) {
+    const register = registrarFor(server);
+    register("docs_link", {
+        title: "Link a Tower document to a Notion page",
+        description: "Ties a document to a Notion page so the two-way sync moves it both ways, or unties it with clear: true. "
+            + "The page becomes the truth: the next sync pulls it over this copy and keeps the copy as a version. "
+            + "Refusals keep Tower's reason: invalid_notion_page, notion_page_already_linked, document_not_writable.",
+        inputSchema: {
+            id: z.string().min(1).max(200).describe("A document id, or its slug."),
+            notion_page: z
+                .string()
+                .min(1)
+                .max(500)
+                .optional()
+                .describe("The Notion page URL (app.notion.com/p/… or notion.so/…) or its page id."),
+            clear: z.boolean().optional().describe("true to untie the document from Notion instead."),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const clear = args.clear === true;
+        const notionPage = typeof args.notion_page === "string" ? args.notion_page : undefined;
+        if (clear === Boolean(notionPage)) {
+            return errorResult("docs_link needs exactly one of notion_page (to link) or clear: true (to unlink).");
+        }
+        const ref = String(args.id ?? "");
+        const resolved = await resolveDocumentId(deps, session, ref);
+        if (resolved.status === "list_failed")
+            return errorResult(resolved.text);
+        if (resolved.status === "not_found")
+            return errorResult(`No document matches "${ref}" — check docs_list for the id or slug.`);
+        const path = `/api/docs/documents/${encodeURIComponent(resolved.id)}/notion-link`;
+        const response = clear
+            ? await callAgentDoor(session, deps.fetchImpl, "DELETE", path)
+            : await callAgentDoor(session, deps.fetchImpl, "PUT", path, { notion_page: notionPage });
+        if (!response.ok)
+            return errorResult(doorFailureText("docs_link", response));
+        const outcome = String(response.body.outcome ?? "");
+        const document = response.body.document;
+        return textResult(`${outcome || "done"}: "${document?.title ?? ""}" (${document?.id ?? resolved.id}).`, {
+            outcome,
+            document,
+        });
+    }));
+    register("docs_sync_status", {
+        title: "Read the Tower-Notion sync status",
+        description: "Every document linked to a Notion page (or one, by id or slug) with its sync state: synced (the body is what "
+            + "both sides last agreed on), tower_changed (edited in Tower since; the next write-back pushes it), never_synced "
+            + "(linked, no baseline yet). Tower's half only: a Notion edit shows up at the next pull. Never a body.",
+        inputSchema: {
+            id: z.string().min(1).max(200).optional().describe("A document id or slug, for one document's status."),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        let path = "/api/docs/notion-sync";
+        if (typeof args.id === "string" && args.id.length > 0) {
+            const resolved = await resolveDocumentId(deps, session, args.id);
+            if (resolved.status === "list_failed")
+                return errorResult(resolved.text);
+            if (resolved.status === "not_found")
+                return errorResult(`No document matches "${args.id}" — check docs_list for the id or slug.`);
+            path = `${path}?document_id=${encodeURIComponent(resolved.id)}`;
+        }
+        const response = await callAgentDoor(session, deps.fetchImpl, "GET", path);
+        if (!response.ok)
+            return errorResult(doorFailureText("docs_sync_status", response));
+        const counts = response.body.counts;
+        const summary = Object.entries(counts?.by_state ?? {})
+            .map(([state, count]) => `${count} ${state}`)
+            .join(", ");
+        return textResult(`${counts?.linked ?? 0} linked: ${summary}.`, {
+            counts,
+            documents: response.body.documents ?? [],
+        });
+    }));
+}

package/dist/server.js

@@ -10,6 +10,7 @@ import { z } from "zod";
 import { registerBriefTools } from "./brief-tools.js";
 import { registerBriefWriteTools } from "./brief-write-tools.js";
 import { registerDocsMsgTools } from "./docs-msg-tools.js";
+import { registerDocsNotionTools } from "./docs-notion-tools.js";
 import { registerJarvisTools } from "./jarvis-tools.js";
 import { registerCalTools } from "./cal-tools.js";
 import { registerMailTools } from "./mail-tools.js";
@@ -415,6 +416,8 @@ export function createServer(deps) {
     // no `cockpit login` pairing yet still serves the three event tools; only a
     // docs/msg call on that machine fails, by name.
     registerDocsMsgTools(server, { fetchImpl: deps.fetchImpl });
+    // BLI-10430: docs_link, the Notion half of the docs tools, on the same path.
+    registerDocsNotionTools(server, { fetchImpl: deps.fetchImpl });
     // BLI-3716: `work_*` — the issue tracker, on the same device-token path as
     // the docs/msg tools above, for the same reason: a coding session should
     // file and move a Tower issue the way it files and moves a Linear one.

package/dist/tool-catalog.d.ts

@@ -10,7 +10,7 @@
  * from `src/` under Node's type stripping, so it may import nothing.
  */
 /** Tools that change nothing. The smoke calls every one. */
-export declare const READ_TOOLS: readonly ["get_ticket_timeline", "get_active_tickets", "docs_list", "docs_tree", "docs_read", "msg_channels", "msg_read", "msg_thread", "work_list_issues", "work_get_issue", "work_issue_history", "work_list_projects", "careers_list", "careers_show", "careers_resume_url", "careers_takehome_show", "careers_settings_show", "usage_people", "usage_sessions", "mail_accounts", "mail_inbox", "mail_read", "mail_search", "mail_attachment", "cal_today", "cal_week", "cal_next", "cal_find", "cal_calendars", "jarvis_ask", "jarvis_trace", "jarvis_check", "models_list", "models_card", "models_compare", "brief_read", "brief_history", "brief_status", "notes_folders", "notes_list", "notes_show", "notes_shelf", "notes_shelves", "notes_place", "notes_accounts", "ops_status", "slack_coverage", "slack_read", "memory_profile", "memory_consolidation", "settings_show", "settings_list", "model_show", "team_members", "team_device_list", "scout_board", "workbook_read", "tower_search"];
+export declare const READ_TOOLS: readonly ["get_ticket_timeline", "get_active_tickets", "docs_list", "docs_tree", "docs_read", "docs_sync_status", "msg_channels", "msg_read", "msg_thread", "work_list_issues", "work_get_issue", "work_issue_history", "work_list_projects", "careers_list", "careers_show", "careers_resume_url", "careers_takehome_show", "careers_settings_show", "usage_people", "usage_sessions", "mail_accounts", "mail_inbox", "mail_read", "mail_search", "mail_attachment", "cal_today", "cal_week", "cal_next", "cal_find", "cal_calendars", "jarvis_ask", "jarvis_trace", "jarvis_check", "models_list", "models_card", "models_compare", "brief_read", "brief_history", "brief_status", "notes_folders", "notes_list", "notes_show", "notes_shelf", "notes_shelves", "notes_place", "notes_accounts", "ops_status", "slack_coverage", "slack_read", "memory_profile", "memory_consolidation", "settings_show", "settings_list", "model_show", "team_members", "team_device_list", "scout_board", "workbook_read", "tower_search"];
 /**
  * Tools that write, but answer a dry run that writes nothing. The smoke calls
  * each one ONLY with its dry-run flag set (`scripts/smoke.ts` says which).
@@ -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", "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", "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_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", "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

@@ -16,6 +16,7 @@ export const READ_TOOLS = [
     "docs_list",
     "docs_tree",
     "docs_read",
+    "docs_sync_status",
     "msg_channels",
     "msg_read",
     "msg_thread",
@@ -84,6 +85,7 @@ export const WRITE_TOOLS = [
     "emit_event",
     "docs_create",
     "docs_update",
+    "docs_link",
     "msg_create_channel",
     "msg_dm",
     "msg_send",

package/dist/verb-census.js

@@ -234,6 +234,8 @@ export const MCP_TWINS = {
     "docs read": { tool: "docs_read", door: "GET /api/docs/documents/[id]" },
     "docs create": { tool: "docs_create", door: "POST /api/docs/documents" },
     "docs update": { tool: "docs_update", door: "PATCH /api/docs/documents/[id]" },
+    "docs link": { tool: "docs_link", door: "PUT /api/docs/documents/[id]/notion-link" },
+    "docs sync-status": { tool: "docs_sync_status", door: "GET /api/docs/notion-sync" },
     "msg channels": { tool: "msg_channels", door: "GET /api/msg/channels" },
     "msg create": { tool: "msg_create_channel", door: "POST /api/msg/channels" },
     "msg dm": { tool: "msg_dm", door: "POST /api/msg/channels (dm)" },

package/package.json

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