@novaeo/brain-connector 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026 Novaeo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -0,0 +1,126 @@
+# @novaeo/brain-connector
+
+A standalone [Model Context Protocol](https://modelcontextprotocol.io) (MCP)
+connector for the **Novaeo Brain** — your company's permission-aware memory.
+It runs as a local **stdio** MCP server and exposes nine Brain tools to any MCP
+client (Claude Desktop, Cursor, Codex, or a generic stdio host). Every call is
+made over HTTPS to the Brain API, authenticated with your personal token. The
+token **is** your identity: the server resolves who you are and only ever
+returns what you are allowed to see.
+
+This package is fully self-contained: no database, no workspace dependencies,
+and no secrets. Its only runtime dependencies are
+`@modelcontextprotocol/sdk` and `zod`.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `search_brain` | Permission-filtered semantic search; returns ranked snippets with citations. |
+| `answer_from_brain` | Grounded answer to a question, with source citations. |
+| `write_brain_memory` | Write a draft note into the brain under a visibility policy. |
+| `list_action_items` | List action items (defaults to your own). |
+| `create_action_item` | Create an action item with owner, project, and due date. |
+| `update_action_item` | Update an action item's status or fields. |
+| `create_reminder` | Create a reminder that inherits its trigger message's visibility. |
+| `summarize_thread` | Summarize a chat thread into a short, cited summary. |
+| `promote_to_curated_note` | Promote a reviewed note into the curated `novaeo-brain` vault. |
+
+## Configuration
+
+Two environment variables are **required**. The connector exits with a clear
+message if either is missing.
+
+| Variable | Required | Description |
+|---|---|---|
+| `BRAIN_API_URL` | yes | Base URL of your Brain API, e.g. `https://brain.novaeo.com`. |
+| `NOVAEO_BRAIN_TOKEN` | yes | Your personal Brain token (starts with `nbk_`). Sent as `Authorization: Bearer <token>`. |
+
+### Getting your token
+
+Your Brain token is issued from the **Connect-your-agent** page in the Novaeo
+app (coming soon). It looks like `nbk_...`. Treat it like a password — it
+grants exactly your access. Do not commit it; pass it via your MCP client's
+environment block.
+
+## Usage
+
+Run directly with `npx` (no install needed):
+
+```bash
+BRAIN_API_URL=https://brain.novaeo.com \
+NOVAEO_BRAIN_TOKEN=nbk_your_token \
+npx @novaeo/brain-connector
+```
+
+The process speaks the MCP protocol over stdio; diagnostics go to stderr.
+
+## MCP client configuration
+
+### Claude Desktop
+
+Edit `claude_desktop_config.json` (Settings → Developer → Edit Config):
+
+```json
+{
+  "mcpServers": {
+    "novaeo-brain": {
+      "command": "npx",
+      "args": ["-y", "@novaeo/brain-connector"],
+      "env": {
+        "BRAIN_API_URL": "https://brain.novaeo.com",
+        "NOVAEO_BRAIN_TOKEN": "nbk_your_token"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Edit `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):
+
+```json
+{
+  "mcpServers": {
+    "novaeo-brain": {
+      "command": "npx",
+      "args": ["-y", "@novaeo/brain-connector"],
+      "env": {
+        "BRAIN_API_URL": "https://brain.novaeo.com",
+        "NOVAEO_BRAIN_TOKEN": "nbk_your_token"
+      }
+    }
+  }
+}
+```
+
+### Codex
+
+Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.novaeo-brain]
+command = "npx"
+args = ["-y", "@novaeo/brain-connector"]
+env = { BRAIN_API_URL = "https://brain.novaeo.com", NOVAEO_BRAIN_TOKEN = "nbk_your_token" }
+```
+
+### Generic stdio MCP client
+
+Any MCP host that launches a command can use:
+
+```json
+{
+  "command": "npx",
+  "args": ["-y", "@novaeo/brain-connector"],
+  "env": {
+    "BRAIN_API_URL": "https://brain.novaeo.com",
+    "NOVAEO_BRAIN_TOKEN": "nbk_your_token"
+  }
+}
+```
+
+## License
+
+MIT

package/dist/brain-http-client.d.ts

@@ -0,0 +1,99 @@
+import { type ConnectorConfig } from "./config.js";
+/** Minimal fetch signature this client depends on (Node 18+ global `fetch`). */
+export type FetchLike = (input: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json: () => Promise<unknown>;
+    text: () => Promise<string>;
+}>;
+/** Raised when the Brain API call fails (network or non-2xx response). */
+export declare class BrainApiError extends Error {
+    readonly details: {
+        path: string;
+        status?: number;
+        correlationId: string;
+        cause?: string;
+    };
+    constructor(message: string, details: {
+        path: string;
+        status?: number;
+        correlationId: string;
+        cause?: string;
+    });
+}
+export interface SearchPayload {
+    query: string;
+    limit?: number;
+    answerMode?: "private" | "shared";
+}
+export interface AnswerPayload {
+    query: string;
+    limit?: number;
+    answerMode?: "private" | "shared";
+}
+export interface WriteMemoryPayload {
+    title: string;
+    body: string;
+    visibilityPolicyId: string;
+    noteType?: "decision" | "sop" | "summary" | "fact";
+}
+export interface ListActionItemsPayload {
+    ownerIdentityId?: string;
+    status?: "open" | "in_progress" | "blocked" | "done" | "cancelled";
+    limit?: number;
+}
+export interface CreateActionItemPayload {
+    title: string;
+    details?: string;
+    ownerIdentityId?: string;
+    projectId?: string;
+    sourceMessageId?: string;
+    visibilityPolicyId?: string;
+    dueDate?: string;
+}
+export interface UpdateActionItemPayload {
+    id: string;
+    status?: "open" | "in_progress" | "blocked" | "done" | "cancelled";
+    title?: string;
+    dueDate?: string;
+    ownerIdentityId?: string;
+}
+export interface CreateReminderPayload {
+    remindAfter: string;
+    triggerMessageId: string;
+    spaceId?: string;
+    threadId?: string;
+    mentionedIdentityId?: string;
+}
+export interface SummarizeThreadPayload {
+    threadId: string;
+}
+export interface PromoteNotePayload {
+    noteId: string;
+    dryRun?: boolean;
+}
+export interface BrainHttpClientOptions {
+    /** Injected for tests; defaults to the global `fetch`. */
+    fetchImpl?: FetchLike;
+}
+export declare class BrainHttpClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly fetchImpl;
+    constructor(config: ConnectorConfig, options?: BrainHttpClientOptions);
+    /** Issue an authenticated JSON request. The token resolves the identity. */
+    private call;
+    search(payload: SearchPayload): Promise<unknown>;
+    answer(payload: AnswerPayload): Promise<unknown>;
+    writeMemory(payload: WriteMemoryPayload): Promise<unknown>;
+    listActionItems(payload: ListActionItemsPayload): Promise<unknown>;
+    createActionItem(payload: CreateActionItemPayload): Promise<unknown>;
+    updateActionItem(payload: UpdateActionItemPayload): Promise<unknown>;
+    createReminder(payload: CreateReminderPayload): Promise<unknown>;
+    summarizeThread(payload: SummarizeThreadPayload): Promise<unknown>;
+    promoteNote(payload: PromoteNotePayload): Promise<unknown>;
+}

package/dist/brain-http-client.js

@@ -0,0 +1,89 @@
+import { newCorrelationId } from "./config.js";
+/** Raised when the Brain API call fails (network or non-2xx response). */
+export class BrainApiError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "BrainApiError";
+    }
+}
+export class BrainHttpClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    constructor(config, options = {}) {
+        this.baseUrl = config.brainApiUrl.replace(/\/$/, "");
+        this.token = config.token;
+        const impl = options.fetchImpl ?? globalThis.fetch;
+        if (!impl) {
+            throw new Error("No fetch implementation available. Use Node 18+ or pass options.fetchImpl.");
+        }
+        this.fetchImpl = impl;
+    }
+    /** Issue an authenticated JSON request. The token resolves the identity. */
+    async call(method, path, body) {
+        const correlationId = newCorrelationId();
+        const url = `${this.baseUrl}${path}`;
+        let res;
+        try {
+            res = await this.fetchImpl(url, {
+                method,
+                headers: {
+                    "content-type": "application/json",
+                    authorization: `Bearer ${this.token}`,
+                    "x-correlation-id": correlationId,
+                },
+                ...(body ? { body: JSON.stringify(body) } : {}),
+            });
+        }
+        catch (err) {
+            throw new BrainApiError("Brain API request failed", { path, correlationId, cause: String(err) });
+        }
+        if (!res.ok) {
+            let detail = "";
+            try {
+                detail = await res.text();
+            }
+            catch {
+                /* ignore */
+            }
+            throw new BrainApiError(`Brain API returned ${res.status}${detail ? `: ${detail}` : ""}`, {
+                path,
+                status: res.status,
+                correlationId,
+            });
+        }
+        return (await res.json());
+    }
+    /* The 9 Brain tools → HTTP paths. requesterId is NEVER sent. */
+    search(payload) {
+        return this.call("POST", "/v1/search", { ...payload });
+    }
+    answer(payload) {
+        return this.call("POST", "/v1/answer", { ...payload });
+    }
+    writeMemory(payload) {
+        return this.call("POST", "/v1/notes", { ...payload });
+    }
+    listActionItems(payload) {
+        return this.call("POST", "/v1/action-items/query", { ...payload });
+    }
+    createActionItem(payload) {
+        return this.call("POST", "/v1/action-items", { ...payload });
+    }
+    updateActionItem(payload) {
+        const { id, ...rest } = payload;
+        return this.call("PATCH", `/v1/action-items/${id}`, { ...rest });
+    }
+    createReminder(payload) {
+        return this.call("POST", "/v1/reminders", { ...payload });
+    }
+    summarizeThread(payload) {
+        return this.call("POST", "/v1/summarize-thread", { ...payload });
+    }
+    promoteNote(payload) {
+        return this.call("POST", "/v1/notes/promote", { ...payload });
+    }
+}
+//# sourceMappingURL=brain-http-client.js.map

package/dist/brain-http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-http-client.js","sourceRoot":"","sources":["../src/brain-http-client.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createBrainConnectorServer } from "./server.js";
+import { BrainHttpClient } from "./brain-http-client.js";
+import { loadConfig, ConfigError } from "./config.js";
+/* ---------------------------------------------------------------------------
+ * DER-274 — stdio entrypoint.
+ *
+ * `npx @novaeo/brain-connector` (bin: novaeo-brain-connector) starts a stdio
+ * MCP server. Config comes from BRAIN_API_URL + NOVAEO_BRAIN_TOKEN; a missing
+ * one prints a clear message to stderr and exits non-zero. All diagnostics go
+ * to stderr so stdout stays a clean MCP transport.
+ * ------------------------------------------------------------------------- */
+async function main() {
+    let config;
+    try {
+        config = loadConfig();
+    }
+    catch (e) {
+        if (e instanceof ConfigError) {
+            process.stderr.write(`[novaeo-brain-connector] ${e.message}\n`);
+            process.exit(1);
+        }
+        throw e;
+    }
+    const client = new BrainHttpClient(config);
+    const server = createBrainConnectorServer({ client });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write("[novaeo-brain-connector] connected over stdio.\n");
+}
+main().catch((e) => {
+    const message = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`[novaeo-brain-connector] fatal: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;+EAO+E;AAE/E,KAAK,UAAU,IAAI;IACjB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;AAC3E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;IAC1B,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+/** Resolved, validated connector configuration. */
+export interface ConnectorConfig {
+    /** Base URL of the Brain API (e.g. https://brain.novaeo.com). */
+    brainApiUrl: string;
+    /** Per-user Brain token (an `nbk_` token). IS the caller identity. */
+    token: string;
+}
+/**
+ * Thrown when required configuration is missing. Carries a clear, actionable
+ * message that the CLI surfaces to the user before exiting.
+ */
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Read connector config from the environment. Both variables are required;
+ * a missing one fails fast with an explicit, copy-pasteable hint.
+ *
+ * - `BRAIN_API_URL`     — base URL of the Brain API.
+ * - `NOVAEO_BRAIN_TOKEN`— per-user token sent as `Authorization: Bearer <token>`.
+ */
+export declare function loadConfig(env?: NodeJS.ProcessEnv): ConnectorConfig;
+/** Correlation id stamped on every tool call for end-to-end audit tracing. */
+export declare function newCorrelationId(): string;

package/dist/config.js

@@ -0,0 +1,49 @@
+import { randomUUID } from "node:crypto";
+/**
+ * Thrown when required configuration is missing. Carries a clear, actionable
+ * message that the CLI surfaces to the user before exiting.
+ */
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+/**
+ * Read connector config from the environment. Both variables are required;
+ * a missing one fails fast with an explicit, copy-pasteable hint.
+ *
+ * - `BRAIN_API_URL`     — base URL of the Brain API.
+ * - `NOVAEO_BRAIN_TOKEN`— per-user token sent as `Authorization: Bearer <token>`.
+ */
+export function loadConfig(env = process.env) {
+    const brainApiUrl = env.BRAIN_API_URL?.trim();
+    const token = env.NOVAEO_BRAIN_TOKEN?.trim();
+    if (!brainApiUrl) {
+        throw new ConfigError("Missing required env var BRAIN_API_URL. Set it to your Brain API base URL, e.g. BRAIN_API_URL=https://brain.novaeo.com");
+    }
+    if (!token) {
+        throw new ConfigError("Missing required env var NOVAEO_BRAIN_TOKEN. Set it to your personal Brain token (starts with `nbk_`). Get one from the Connect-your-agent page.");
+    }
+    // Never send a bearer token over plaintext or to a credential-embedded URL.
+    let parsed;
+    try {
+        parsed = new URL(brainApiUrl);
+    }
+    catch {
+        throw new ConfigError(`BRAIN_API_URL is not a valid URL: ${brainApiUrl}`);
+    }
+    const isLocal = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
+    if (parsed.protocol !== "https:" && !isLocal) {
+        throw new ConfigError("BRAIN_API_URL must use https:// (your token is a bearer credential).");
+    }
+    if (parsed.username || parsed.password) {
+        throw new ConfigError("BRAIN_API_URL must not embed credentials.");
+    }
+    return { brainApiUrl, token };
+}
+/** Correlation id stamped on every tool call for end-to-end audit tracing. */
+export function newCorrelationId() {
+    return `corr_${randomUUID()}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkBzC;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IAE7C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,WAAW,CACnB,wHAAwH,CACzH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CACnB,kJAAkJ,CACnJ,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CAAC,qCAAqC,WAAW,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,CAAC;IACnF,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7C,MAAM,IAAI,WAAW,CAAC,sEAAsE,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,WAAW,CAAC,2CAA2C,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB;IAC9B,OAAO,QAAQ,UAAU,EAAE,EAAE,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createBrainConnectorServer, BRAIN_TOOL_NAMES, type CreateServerOptions } from "./server.js";
+export { BrainHttpClient, BrainApiError, type FetchLike, type BrainHttpClientOptions } from "./brain-http-client.js";
+export { loadConfig, ConfigError, newCorrelationId, type ConnectorConfig } from "./config.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createBrainConnectorServer, BRAIN_TOOL_NAMES } from "./server.js";
+export { BrainHttpClient, BrainApiError } from "./brain-http-client.js";
+export { loadConfig, ConfigError, newCorrelationId } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAA4B,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,aAAa,EAA+C,MAAM,wBAAwB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BrainHttpClient } from "./brain-http-client.js";
+export interface CreateServerOptions {
+    /** HTTP client to the Brain API. Tests inject one with a mock fetch. */
+    client: BrainHttpClient;
+}
+/** The stable, ordered list of tool names this connector exposes. */
+export declare const BRAIN_TOOL_NAMES: readonly ["search_brain", "answer_from_brain", "write_brain_memory", "list_action_items", "create_action_item", "update_action_item", "create_reminder", "summarize_thread", "promote_to_curated_note"];
+/**
+ * Build the public Brain MCP server with all nine tools registered. Connect the
+ * returned server to a stdio (or any) transport.
+ */
+export declare function createBrainConnectorServer(options: CreateServerOptions): McpServer;

package/dist/server.js

@@ -0,0 +1,186 @@
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BrainHttpClient } from "./brain-http-client.js";
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+function fail(e) {
+    const message = e instanceof Error ? e.message : String(e);
+    return { content: [{ type: "text", text: JSON.stringify({ error: message }) }], isError: true };
+}
+/** The stable, ordered list of tool names this connector exposes. */
+export const BRAIN_TOOL_NAMES = [
+    "search_brain",
+    "answer_from_brain",
+    "write_brain_memory",
+    "list_action_items",
+    "create_action_item",
+    "update_action_item",
+    "create_reminder",
+    "summarize_thread",
+    "promote_to_curated_note",
+];
+const answerMode = z
+    .enum(["private", "shared"])
+    .optional()
+    .describe("DM (private) vs group/channel (shared). Defaults server-side to private.");
+/**
+ * Build the public Brain MCP server with all nine tools registered. Connect the
+ * returned server to a stdio (or any) transport.
+ */
+export function createBrainConnectorServer(options) {
+    const { client } = options;
+    const server = new McpServer({ name: "novaeo-brain-connector", version: "0.1.0" });
+    // 1. search_brain → POST /v1/search
+    server.registerTool("search_brain", {
+        description: "Search company memory for relevant snippets (permission-filtered to your access). Returns ranked results with citations.",
+        inputSchema: {
+            query: z.string().min(1).describe("What to search for."),
+            limit: z.number().int().positive().max(50).optional(),
+            answerMode,
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.search(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // 2. answer_from_brain → POST /v1/answer
+    server.registerTool("answer_from_brain", {
+        description: "Answer a question grounded in company memory, permission-filtered to your access, with source citations.",
+        inputSchema: {
+            query: z.string().min(1).describe("The question to answer."),
+            limit: z.number().int().positive().max(50).optional(),
+            answerMode,
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.answer(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // 3. write_brain_memory → POST /v1/notes
+    server.registerTool("write_brain_memory", {
+        description: "Write a memory (draft note) into the brain under a given visibility policy.",
+        inputSchema: {
+            title: z.string().min(1),
+            body: z.string().min(1),
+            visibilityPolicyId: z.string().uuid().describe("Visibility policy the note inherits."),
+            noteType: z.enum(["decision", "sop", "summary", "fact"]).optional(),
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.writeMemory(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // 4. list_action_items → POST /v1/action-items/query
+    server.registerTool("list_action_items", {
+        description: "List action items (permission-filtered). Defaults to your own items; an owner filter for another user requires admin.",
+        inputSchema: {
+            ownerIdentityId: z.string().uuid().optional(),
+            status: z.enum(["open", "in_progress", "blocked", "done", "cancelled"]).optional(),
+            limit: z.number().int().positive().max(100).optional(),
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.listActionItems(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // 5. create_action_item → POST /v1/action-items
+    server.registerTool("create_action_item", {
+        description: "Create an action item with an owner, optional project, source message, and due date.",
+        inputSchema: {
+            title: z.string().min(1),
+            details: z.string().optional(),
+            ownerIdentityId: z.string().uuid().optional(),
+            projectId: z.string().uuid().optional(),
+            sourceMessageId: z.string().uuid().optional().describe("Message the item derives visibility from."),
+            visibilityPolicyId: z.string().uuid().optional().describe("Explicit visibility policy if no source message."),
+            dueDate: z.string().optional(),
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.createActionItem(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // 6. update_action_item → PATCH /v1/action-items/:id
+    server.registerTool("update_action_item", {
+        description: "Update an action item's status or fields. Only the owner or an admin may modify it.",
+        inputSchema: {
+            id: z.string().uuid(),
+            status: z.enum(["open", "in_progress", "blocked", "done", "cancelled"]).optional(),
+            title: z.string().min(1).optional(),
+            dueDate: z.string().optional(),
+            ownerIdentityId: z.string().uuid().optional(),
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.updateActionItem(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // 7. create_reminder → POST /v1/reminders
+    server.registerTool("create_reminder", {
+        description: "Create a reminder that fires after a given time, inheriting the trigger message's visibility.",
+        inputSchema: {
+            remindAfter: z.string().describe("ISO timestamp to remind after."),
+            triggerMessageId: z.string().uuid().describe("Message the reminder derives visibility from."),
+            spaceId: z.string().uuid().optional(),
+            threadId: z.string().optional(),
+            mentionedIdentityId: z.string().uuid().optional(),
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.createReminder(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // 8. summarize_thread → POST /v1/summarize-thread
+    server.registerTool("summarize_thread", {
+        description: "Summarize a chat thread (permission-filtered) into a short, cited summary.",
+        inputSchema: {
+            threadId: z.string().min(1),
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.summarizeThread(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // 9. promote_to_curated_note → POST /v1/notes/promote
+    server.registerTool("promote_to_curated_note", {
+        description: "Promote a reviewed brain note into the curated novaeo-brain vault. Defaults to a dry run; sensitive promotions require admin.",
+        inputSchema: {
+            noteId: z.string().uuid(),
+            dryRun: z.boolean().optional().describe("Preview without writing. Defaults to true server-side."),
+        },
+    }, async (args) => {
+        try {
+            return ok(await client.promoteNote(args));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@novaeo/brain-connector",
+  "version": "0.1.0",
+  "description": "Standalone stdio MCP connector for the Novaeo Brain. Exposes search, answer, memory, action-item, reminder, summarize, and promote tools over HTTPS using a per-user token.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "novaeo-brain-connector": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc",
+    "test": "vitest run",
+    "start": "node ./dist/cli.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "novaeo",
+    "brain",
+    "connector"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}