@naumu/mcp 0.6.1 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@naumu/mcp",
-	"version": "0.6.1",
+	"version": "0.6.2",
 	"description": "MCP server for Naumu – access your knowledge graph from Claude Code, Cursor, and other AI coding agents",
 	"license": "MIT",
 	"author": "Naumu <hello@naumu.ai>",
@@ -34,14 +34,15 @@
 		"node": ">=18"
 	},
 	"scripts": {
-		"build": "tsc",
-		"dev": "tsc --watch",
+		"build": "tsup",
+		"dev": "tsup --watch",
 		"start": "node dist/index.js",
 		"test": "NODE_OPTIONS=--experimental-vm-modules jest",
-		"prepublishOnly": "tsc"
+		"prepublishOnly": "tsup"
 	},
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "^1.12.1",
+		"@naumu/mcp-core": "workspace:*",
 		"zod": "^3.25.23"
 	},
 	"devDependencies": {
@@ -49,6 +50,7 @@
 		"@types/node": "*",
 		"jest": "^30.3.0",
 		"ts-jest": "^29.4.6",
+		"tsup": "^8.5.1",
 		"typescript": "^5.9.3"
 	}
 }

package/dist/client.d.ts

@@ -1,15 +0,0 @@
-export declare class NaumuClient {
-    private baseUrl;
-    private apiKey;
-    constructor(baseUrl: string, apiKey: string);
-    private headers;
-    private handleResponse;
-    get(path: string): Promise<unknown>;
-    getBinary(path: string): Promise<{
-        buffer: Uint8Array;
-        contentType: string;
-    }>;
-    post(path: string, body?: unknown): Promise<unknown>;
-    patch(path: string, body: unknown): Promise<unknown>;
-    del(path: string, body?: unknown): Promise<unknown>;
-}

package/dist/client.js

@@ -1,82 +0,0 @@
-import { NaumuApiError, safeErrorMessage } from './errors.js';
-export class NaumuClient {
-    baseUrl;
-    apiKey;
-    constructor(baseUrl, apiKey) {
-        this.baseUrl = baseUrl.replace(/\/+$/, '');
-        this.apiKey = apiKey;
-    }
-    headers() {
-        return {
-            'Authorization': `Bearer ${this.apiKey}`,
-            'Content-Type': 'application/json',
-        };
-    }
-    async handleResponse(res) {
-        if (!res.ok) {
-            const text = await res.text().catch(() => 'Unknown error');
-            let upstream;
-            try {
-                const json = JSON.parse(text);
-                upstream = json.message || text;
-            }
-            catch {
-                upstream = text;
-            }
-            // Log the raw upstream message server-side for debugging, but throw
-            // a safe-mapped one so 403/404 differentials don't leak through to
-            // the model.
-            console.error(`[mcp] upstream ${res.status}: ${upstream.slice(0, 500)}`);
-            throw new NaumuApiError(res.status, safeErrorMessage(res.status, upstream), upstream);
-        }
-        return res.json();
-    }
-    async get(path) {
-        const res = await fetch(`${this.baseUrl}${path}`, {
-            method: 'GET',
-            headers: this.headers(),
-        });
-        return this.handleResponse(res);
-    }
-    async getBinary(path) {
-        const res = await fetch(`${this.baseUrl}${path}`, {
-            method: 'GET',
-            headers: { Authorization: `Bearer ${this.apiKey}` },
-        });
-        if (!res.ok) {
-            const upstream = await res.text().catch(() => 'Unknown error');
-            console.error(`[mcp] upstream binary ${res.status}: ${upstream.slice(0, 500)}`);
-            throw new NaumuApiError(res.status, safeErrorMessage(res.status, upstream), upstream);
-        }
-        const arrayBuffer = await res.arrayBuffer();
-        return {
-            buffer: new Uint8Array(arrayBuffer),
-            contentType: res.headers.get('content-type') ?? 'application/octet-stream',
-        };
-    }
-    async post(path, body) {
-        const res = await fetch(`${this.baseUrl}${path}`, {
-            method: 'POST',
-            headers: this.headers(),
-            body: body !== undefined ? JSON.stringify(body) : undefined,
-        });
-        return this.handleResponse(res);
-    }
-    async patch(path, body) {
-        const res = await fetch(`${this.baseUrl}${path}`, {
-            method: 'PATCH',
-            headers: this.headers(),
-            body: JSON.stringify(body),
-        });
-        return this.handleResponse(res);
-    }
-    async del(path, body) {
-        const res = await fetch(`${this.baseUrl}${path}`, {
-            method: 'DELETE',
-            headers: this.headers(),
-            body: body !== undefined ? JSON.stringify(body) : undefined,
-        });
-        return this.handleResponse(res);
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -1,35 +0,0 @@
-export declare class NaumuApiError extends Error {
-    readonly status: number;
-    /**
-     * Raw upstream message — captured for server-side logging only. Never
-     * pipe this to model output: it can carry 403/404 differential signal
-     * (e.g. "Thread not found" vs "Role 'X' cannot perform 'thread:post'")
-     * which lets a malicious caller enumerate resources they don't have
-     * access to. Tools should surface `error.message` (the safe-mapped
-     * version) instead.
-     */
-    readonly upstreamMessage?: string | undefined;
-    constructor(status: number, message: string, 
-    /**
-     * Raw upstream message — captured for server-side logging only. Never
-     * pipe this to model output: it can carry 403/404 differential signal
-     * (e.g. "Thread not found" vs "Role 'X' cannot perform 'thread:post'")
-     * which lets a malicious caller enumerate resources they don't have
-     * access to. Tools should surface `error.message` (the safe-mapped
-     * version) instead.
-     */
-    upstreamMessage?: string | undefined);
-}
-/**
- * Map an HTTP status + raw upstream message to a model-safe error string.
- *
- * The 403/404 collapse is the security mitigation: bots can otherwise
- * enumerate threads / attachments / nodes they don't own by reading the
- * differential between "not found" and "forbidden" responses.
- *
- * 400/422 messages pass through verbatim because they describe what the
- * caller did wrong (malformed input, validation failure) — the bot needs
- * that detail to fix its own request, and the messages are derived from
- * its own input rather than server-side state.
- */
-export declare function safeErrorMessage(status: number, upstream: string): string;

package/dist/errors.js

@@ -1,52 +0,0 @@
-export class NaumuApiError extends Error {
-    status;
-    upstreamMessage;
-    constructor(status, message, 
-    /**
-     * Raw upstream message — captured for server-side logging only. Never
-     * pipe this to model output: it can carry 403/404 differential signal
-     * (e.g. "Thread not found" vs "Role 'X' cannot perform 'thread:post'")
-     * which lets a malicious caller enumerate resources they don't have
-     * access to. Tools should surface `error.message` (the safe-mapped
-     * version) instead.
-     */
-    upstreamMessage) {
-        super(message);
-        this.status = status;
-        this.upstreamMessage = upstreamMessage;
-        this.name = 'NaumuApiError';
-    }
-}
-/**
- * Map an HTTP status + raw upstream message to a model-safe error string.
- *
- * The 403/404 collapse is the security mitigation: bots can otherwise
- * enumerate threads / attachments / nodes they don't own by reading the
- * differential between "not found" and "forbidden" responses.
- *
- * 400/422 messages pass through verbatim because they describe what the
- * caller did wrong (malformed input, validation failure) — the bot needs
- * that detail to fix its own request, and the messages are derived from
- * its own input rather than server-side state.
- */
-export function safeErrorMessage(status, upstream) {
-    if (status === 400 || status === 422)
-        return upstream;
-    if (status === 401)
-        return 'Unauthorized — check your API key.';
-    if (status === 403 || status === 404) {
-        return 'Resource not found, or you do not have access to it.';
-    }
-    if (status === 409)
-        return 'Conflict with current state.';
-    if (status === 410)
-        return 'Resource is no longer available.';
-    if (status === 413)
-        return 'Payload too large.';
-    if (status === 429)
-        return 'Rate limit exceeded — slow down and retry.';
-    if (status >= 500)
-        return 'Server error — try again shortly.';
-    return `Request failed with status ${status}.`;
-}
-//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEtB;IAUA;IAXjB,YACiB,MAAc,EAC9B,OAAe;IACf;;;;;;;OAOG;IACa,eAAwB;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAZC,WAAM,GAAN,MAAM,CAAQ;QAUd,oBAAe,GAAf,eAAe,CAAS;QAGxC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,QAAgB;IAChE,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC;IACtD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,oCAAoC,CAAC;IAChE,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,sDAAsD,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,8BAA8B,CAAC;IAC1D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,kCAAkC,CAAC;IAC9D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,oBAAoB,CAAC;IAChD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,4CAA4C,CAAC;IACxE,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,mCAAmC,CAAC;IAC9D,OAAO,8BAA8B,MAAM,GAAG,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAC3C,MAAM,cAAc,GAAG,UAAU,CAAC;AAElC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,eAAe,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACvF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;wOAwB6M,CAAC;AAEzO,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC3B;IACC,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO;CAChB,EACD;IACC,YAAY,EAAE,kBAAkB;CAChC,CACD,CAAC;AAEF,4EAA4E;AAC5E,8EAA8E;AAC9E,6CAA6C;AAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AAEnD,IAAI,QAAQ,EAAE,CAAC;IACd,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAKzE,CAAC;QACF,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtD,OAAO,CAAC,KAAK,CACZ,sBAAsB,MAAM,oBAAoB,QAAQ,CAAC,UAAU,KAAK,QAAQ,CAAC,gBAAgB,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,qBAAqB,CACpJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACF,CAAC;KAAM,CAAC;IACP,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,KAAK,CACZ,sBAAsB,MAAM,iBAAiB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,oBAAoB,GAAG,CACrG,CAAC;AACH,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/add-attribute.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerAddAttribute(server: McpServer, client: NaumuClient): void;

package/dist/tools/add-attribute.js

@@ -1,58 +0,0 @@
-import { z } from 'zod';
-export function registerAddAttribute(server, client) {
-    server.registerTool('naumu_add_attribute', {
-        title: 'Add Attribute to Node Type',
-        description: 'Add or extend an attribute on an existing node type. If the attribute name doesn\'t exist, it is created. If it exists and is a select/multiselect, new values are merged in (existing values kept). Use type "select"/"multiselect" with values; "string"/"number"/"date" for free-form fields (pass values: [] — string/number/date have no enum values). Example date attribute: { name: "due_date", type: "date", values: [], description: "Target completion date (single day or range)" }. Date values on nodes are written via naumu_update_node as either an ISO date string "YYYY-MM-DD" (single day) or an object { start, end? } with ISO date strings (inclusive range). Strongly encouraged to provide `description` on the attribute and on each value — short, contrastive notes (e.g. attribute "stage — sales funnel position; distinct from status which captures health/blockers", value "closed-won — deal signed and revenue committed"). Descriptions are the single strongest signal future agents use when picking which attribute/value to set.',
-        inputSchema: z.object({
-            graphId: z.string(),
-            node_type: z.string().describe('Existing node type to add the attribute to.'),
-            name: z.string().describe('Attribute key (e.g. "stage", "status").'),
-            type: z.enum(['select', 'multiselect', 'string', 'number', 'date']).default('select'),
-            values: z
-                .array(z.object({
-                label: z.string(),
-                color: z.string().optional(),
-                description: z
-                    .string()
-                    .optional()
-                    .describe('Short note distinguishing this value from sibling values (e.g. "closed-won — deal signed and revenue committed"). Encouraged when the label alone is ambiguous.'),
-            }))
-                .default([]),
-            description: z
-                .string()
-                .optional()
-                .describe('Short note explaining what this attribute captures and how it differs from similarly-named attributes elsewhere in the schema (e.g. "Sales funnel position; differs from `status` which captures health/blockers"). Strongly encouraged.'),
-        }),
-    }, async ({ graphId, node_type, name, type, values, description }) => {
-        const current = (await client.get(`/api/graphs/${graphId}/schema`));
-        const schema = current.definition ? JSON.parse(current.definition) : { nodes: [] };
-        const node = schema.nodes.find((n) => n.type === node_type);
-        if (!node) {
-            return {
-                content: [{ type: 'text', text: JSON.stringify({ error: `Node type "${node_type}" not found. Add it first via naumu_add_node_type.` }, null, 2) }],
-            };
-        }
-        node.attributes = node.attributes ?? [];
-        const existing = node.attributes.find((a) => a.name === name);
-        let action;
-        if (!existing) {
-            node.attributes.push({ name, type, values, ...(description ? { description } : {}) });
-            action = `Created attribute "${name}" (${type}) with ${values.length} value(s).`;
-        }
-        else {
-            const existingLabels = new Set((existing.values ?? []).map((v) => v.label));
-            const added = values.filter((v) => !existingLabels.has(v.label));
-            existing.values = [...(existing.values ?? []), ...added];
-            if (description && !existing.description)
-                existing.description = description;
-            action = added.length > 0
-                ? `Extended attribute "${name}" with ${added.length} new value(s); kept ${existingLabels.size} existing.`
-                : `Attribute "${name}" already had all proposed values; no change.`;
-        }
-        await client.post(`/api/graphs/${graphId}/schema`, { definition: schema });
-        return {
-            content: [{ type: 'text', text: JSON.stringify({ message: action, node_type }, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=add-attribute.js.map

package/dist/tools/add-attribute.js.map

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

package/dist/tools/add-connection.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerAddConnection(server: McpServer, client: NaumuClient): void;

package/dist/tools/add-connection.js

@@ -1,46 +0,0 @@
-import { z } from 'zod';
-export function registerAddConnection(server, client) {
-    server.registerTool('naumu_add_connection', {
-        title: 'Add Connection to Node Type',
-        description: 'Add one connection from an existing node type to another. `kind`: "parent" (sets/replaces — every non-root type needs exactly one parent; only ONE type in the whole schema has no parent), "required" (must exist on instances), "suggested" (optional). Each connection is XOR: ONE concrete target_node OR polymorphic=true — never both. DEFAULT TO CONCRETE target_node. Polymorphic is the ESCAPE HATCH — reserve for genuinely cross-cutting relations (e.g. a Tag-style relation that validly applies to many distinct types). If you can\'t pick a concrete target, you may be missing a type — add it first instead of falling back to polymorphic. Same-type nesting (e.g. Topic under Topic) does NOT need a new connection — use the existing parent relation. Relation name UPPER_SNAKE_CASE.',
-        inputSchema: z.object({
-            graphId: z.string(),
-            source_type: z.string().describe('Existing node type to add the connection to.'),
-            relation: z.string().describe('UPPER_SNAKE_CASE relation name.'),
-            target_node: z.string().optional().describe('Target type. Omit when polymorphic=true.'),
-            polymorphic: z.boolean().optional(),
-            kind: z.enum(['required', 'suggested', 'parent']).default('suggested'),
-        }),
-    }, async ({ graphId, source_type, relation, target_node, polymorphic, kind }) => {
-        const current = (await client.get(`/api/graphs/${graphId}/schema`));
-        const schema = current.definition ? JSON.parse(current.definition) : { nodes: [] };
-        const node = schema.nodes.find((n) => n.type === source_type);
-        if (!node) {
-            return {
-                content: [{ type: 'text', text: JSON.stringify({ error: `Node type "${source_type}" not found. Add it first via naumu_add_node_type.` }, null, 2) }],
-            };
-        }
-        const conn = { relation, ...(polymorphic ? { polymorphic: true } : {}), ...(target_node ? { target_node } : {}) };
-        if (!node.connections)
-            node.connections = { required: [], suggested: [] };
-        if (kind === 'parent') {
-            node.connections.parent = conn;
-        }
-        else {
-            const list = node.connections[kind] ?? [];
-            const exists = list.some((c) => c.relation === relation && c.target_node === target_node && Boolean(c.polymorphic) === Boolean(polymorphic));
-            if (exists) {
-                return {
-                    content: [{ type: 'text', text: JSON.stringify({ message: `Connection already exists on "${source_type}", no change.` }, null, 2) }],
-                };
-            }
-            list.push(conn);
-            node.connections[kind] = list;
-        }
-        await client.post(`/api/graphs/${graphId}/schema`, { definition: schema });
-        return {
-            content: [{ type: 'text', text: JSON.stringify({ message: `Added ${kind} connection ${relation}${target_node ? ` → ${target_node}` : ' (polymorphic)'} on "${source_type}".` }, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=add-connection.js.map

package/dist/tools/add-connection.js.map

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

package/dist/tools/add-edge.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerAddEdge(server: McpServer, client: NaumuClient): void;

package/dist/tools/add-edge.js

@@ -1,33 +0,0 @@
-import { z } from 'zod';
-const EdgeInput = z.object({
-    source: z.string().describe('Source node ID'),
-    target: z.string().describe('Target node ID'),
-    label: z.string().describe('Relationship type (e.g. RELATES_TO, SOLVES, TRACKS)'),
-    isParent: z.boolean().optional().describe('Whether this is a parent relationship'),
-});
-export function registerAddEdge(server, client) {
-    server.registerTool('naumu_add_edge', {
-        title: 'Add Edges (bulk)',
-        description: 'Create 1–25 relationships (edges) between existing nodes in a single call. Keep batches small and atomic (5–25 edges) so failures stay contained. Typical workflow after a bulk import: create nodes with `naumu_add_node`, then wire them up with batched `naumu_add_edge` calls. **Direction matters and must match the schema.** Each edge\'s `(source.type, label, target.type)` tuple should appear in the schema\'s `connections` or `parent` for the source type. When the backend runs with `STRICT_EDGE_VALIDATION=true`, invalid tuples are rejected immediately with `error: invalid_edge` (the response includes `details.allowed_targets_for_relation` and a `hint` for routing the call); otherwise the edge persists and surfaces later as an `invalid_connection_target` / `parent_mismatch` violation. Either way, check `naumu_get_schema` and flip / drop offending edges before calling. **Prefer `naumu_ask`** when you want the agent to discover the right connections itself.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            edges: z
-                .array(EdgeInput)
-                .min(1)
-                .max(25)
-                .describe('Batch of 1–25 edges to create. Keep batches small for atomicity.'),
-        }),
-    }, async ({ graphId, edges }) => {
-        const payload = edges.map((e) => ({
-            source: e.source,
-            target: e.target,
-            label: e.label,
-            isParent: e.isParent || false,
-        }));
-        const data = await client.post(`/api/graphs/${graphId}/edges`, { edges: payload });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=add-edge.js.map

package/dist/tools/add-edge.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-edge.js","sourceRoot":"","sources":["../../src/tools/add-edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IACjF,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAClF,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,MAAmB;IACrE,MAAM,CAAC,YAAY,CAClB,gBAAgB,EAChB;QACC,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACV,u8BAAu8B;QACx8B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,KAAK,EAAE,CAAC;iBACN,KAAK,CAAC,SAAS,CAAC;iBAChB,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,CAAC,kEAAkE,CAAC;SAC9E,CAAC;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;SAC7B,CAAC,CAAC,CAAC;QAEJ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,OAAO,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACnF,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/add-node-type.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerAddNodeType(server: McpServer, client: NaumuClient): void;

package/dist/tools/add-node-type.js

@@ -1,72 +0,0 @@
-import { z } from 'zod';
-const ConnectionSchema = z.object({
-    relation: z.string().describe('UPPER_SNAKE_CASE relation name (WORKS_AT, BELONGS_TO).'),
-    target_node: z.string().optional().describe('Target type name. Omit when polymorphic=true.'),
-    polymorphic: z.boolean().optional().describe('True when this relation can target many types.'),
-});
-const AttributeValueSchema = z.object({
-    label: z.string(),
-    color: z.string().optional(),
-    description: z
-        .string()
-        .optional()
-        .describe('Short note distinguishing this value from sibling values (e.g. for status="closed-won", "Deal signed and revenue committed"). Encouraged when the label alone is ambiguous.'),
-});
-const AttributeSchema = z.object({
-    name: z.string(),
-    type: z.enum(['select', 'multiselect', 'string', 'number', 'date']).optional(),
-    values: z.array(AttributeValueSchema).default([]),
-    description: z
-        .string()
-        .optional()
-        .describe('Short note explaining what this attribute captures and how it differs from similarly-named attributes on other types (e.g. "stage on Feature" vs "stage on Deal"). Strongly encouraged.'),
-});
-export function registerAddNodeType(server, client) {
-    server.registerTool('naumu_add_node_type', {
-        title: 'Add Node Type to Schema',
-        description: 'Add one new node type to the schema. Cheaper than naumu_update_schema. STRUCTURAL RULES: (1) Schemas are hierarchical with a single root. If schema is empty, the first type IS the root — omit `parent`. Every subsequent type MUST set `parent`. (2) DEFAULT TO CONCRETE — pass {relation, target_node: <existing type>}. Polymorphic is the ESCAPE HATCH — use {relation, polymorphic: true} ONLY for genuinely cross-cutting concepts like Comment or Tag (types that validly attach to many distinct parents). If you can\'t pick a concrete parent, you may be missing a type — add the missing type first instead of falling back to polymorphic. (3) Required/suggested connections also each take ONE concrete target_node OR polymorphic — never a list. Default concrete there too. (4) Type name PascalCase (Company, Person, Feature). Relation names UPPER_SNAKE_CASE (BELONGS_TO, WORKS_AT). (5) ALWAYS provide `description` — one short sentence that says what this type is AND what it is NOT relative to semantically close types (e.g. "External entity that delivers services on contract; distinct from Organization which is any legal entity"). This is the single strongest signal future agents have when classifying a node into one of several similar-sounding types. Returns an error if the type already exists — use naumu_add_attribute / naumu_add_connection to extend it.',
-        inputSchema: z.object({
-            graphId: z.string(),
-            type: z.string().describe('PascalCase type name'),
-            description: z
-                .string()
-                .optional()
-                .describe('Short one-sentence description of what this type represents and how it differs from sibling types. Contrastive (say what it IS and what it is NOT) is most useful. Strongly encouraged on every new type — agents reading the schema later rely on this to classify nodes.'),
-            parent: ConnectionSchema.optional().describe('Optional parent connection — sets this type as a child of another type.'),
-            required: z.array(ConnectionSchema).optional(),
-            suggested: z.array(ConnectionSchema).optional(),
-            attributes: z.array(AttributeSchema).optional(),
-            color: z.string().optional(),
-            defaultVisibility: z
-                .enum(['restricted', 'internal', 'open'])
-                .optional()
-                .describe('Default visibility for NEW nodes of this type when no explicit visibility is passed on creation. Does NOT retroactively change existing nodes. "open" = visible to anyone with the space link, "internal" = visible to all space members, "restricted" = only members explicitly granted access. Omit to fall back to the space-level defaultVisibility.'),
-        }),
-    }, async ({ graphId, type, description, parent, required, suggested, attributes, color, defaultVisibility }) => {
-        const current = (await client.get(`/api/graphs/${graphId}/schema`));
-        const schema = current.definition ? JSON.parse(current.definition) : { nodes: [] };
-        if (schema.nodes.some((n) => n.type === type)) {
-            return {
-                content: [{ type: 'text', text: JSON.stringify({ error: `Node type "${type}" already exists. Use naumu_add_attribute / naumu_add_connection to extend it.` }, null, 2) }],
-            };
-        }
-        const newNode = {
-            type,
-            connections: {
-                required: required ?? [],
-                suggested: suggested ?? [],
-                ...(parent ? { parent } : {}),
-            },
-            ...(attributes && attributes.length > 0 ? { attributes } : {}),
-            ...(color ? { color } : {}),
-            ...(description ? { description } : {}),
-            ...(defaultVisibility ? { defaultVisibility } : {}),
-        };
-        schema.nodes.push(newNode);
-        await client.post(`/api/graphs/${graphId}/schema`, { definition: schema });
-        return {
-            content: [{ type: 'text', text: JSON.stringify({ message: `Added node type "${type}"`, total_types: schema.nodes.length }, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=add-node-type.js.map

package/dist/tools/add-node-type.js.map

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

package/dist/tools/add-node.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerAddNode(server: McpServer, client: NaumuClient): void;

package/dist/tools/add-node.js

@@ -1,36 +0,0 @@
-import { z } from 'zod';
-const NodeInput = z.object({
-    label: z.string().describe('Display name of the node'),
-    type: z.string().describe('Node type from the graph schema (e.g. Feature, Pain, Metric)'),
-    content: z
-        .string()
-        .min(1)
-        .describe('Rich text content / description. REQUIRED — every node must explain what it is.'),
-    attributes: z.record(z.string(), z.unknown()).optional().describe('Additional key-value attributes'),
-});
-export function registerAddNode(server, client) {
-    server.registerTool('naumu_add_node', {
-        title: 'Add Nodes (bulk)',
-        description: 'Create 1–25 nodes in the knowledge graph in a single call. Keep batches small and atomic (5–25 nodes) so failures stay contained. Each node MUST include a non-empty `content` describing what it is. Returns one entry per input node with `{id, label, type, status: "created"}` — there is NO server-side dedup, every input becomes a node. Dedup is the caller\'s responsibility: BEFORE calling this tool, run `naumu_semantic_search` on each candidate label and skip/route to update if a result has high similarity (≥0.78) and matching type. Warning: nodes are isolated until you connect them with `naumu_add_edge`. **Prefer `naumu_ask`** for general knowledge intake — it discovers and creates connections for you. Use this when you have a vetted, dedup-checked batch ready to insert.',
-        inputSchema: z.object({
-            graphId: z.string().describe('The graph ID'),
-            nodes: z
-                .array(NodeInput)
-                .min(1)
-                .max(25)
-                .describe('Batch of 1–25 nodes to create. Keep batches small for atomicity.'),
-        }),
-    }, async ({ graphId, nodes }) => {
-        const payload = nodes.map(({ label, type, content, attributes }) => {
-            const node = { label, type, content };
-            if (attributes)
-                Object.assign(node, attributes);
-            return node;
-        });
-        const data = await client.post(`/api/graphs/${graphId}/nodes`, { nodes: payload });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    });
-}
-//# sourceMappingURL=add-node.js.map

package/dist/tools/add-node.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-node.js","sourceRoot":"","sources":["../../src/tools/add-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACzF,OAAO,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iFAAiF,CAAC;IAC7F,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CACpG,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,MAAmB;IACrE,MAAM,CAAC,YAAY,CAClB,gBAAgB,EAChB;QACC,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACV,8wBAA8wB;QAC/wB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,KAAK,EAAE,CAAC;iBACN,KAAK,CAAC,SAAS,CAAC;iBAChB,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,CAAC,kEAAkE,CAAC;SAC9E,CAAC;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;YAClE,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC/D,IAAI,UAAU;gBAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,OAAO,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACnF,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/add-reaction.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerAddReaction(server: McpServer, client: NaumuClient): void;

package/dist/tools/add-reaction.js

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-export function registerAddReaction(server, client) {
-    server.registerTool('naumu_add_reaction', {
-        title: 'Add Reaction',
-        description: 'Add an emoji reaction to a message in a thread you are participating in. Idempotent — calling twice with the same emoji is a no-op (use `naumu_remove_reaction` to undo). Returns `{ ok, messageId, emoji, alreadyExisted, reactionCount, reactions }` so you can confirm the state without re-reading the thread; `alreadyExisted: true` means the reaction was already on the message and the call was a no-op.\n\nWhen to react vs. when to post a message:\n• React (no message) for lightweight acknowledgement (👀, ✅, 👍), appreciation (❤️, 🙌), laughter (😂), or "I saw this".\n• Post a message for direct questions, clarification, important corrections, or final results — situations where words are required.\n• For long tasks: react 👀 first to acknowledge, optionally post a short "On it — I\'ll report back" if the work will take >20s, do the work, then post the final result.\n• Ignore casual human banter, side-conversations someone else already answered, or anything where you would only say "ok"/"nice"/"lol".\n\nUse at most one reaction per message unless explicitly useful. Reactions are social backpressure relief, not a sparkle-confetti channel.',
-        inputSchema: z.object({
-            threadId: z
-                .string()
-                .describe('Thread containing the message. You must be a participant.'),
-            messageId: z
-                .string()
-                .describe('The message to react to.'),
-            emoji: z
-                .string()
-                .min(1)
-                .describe('Emoji character (e.g. "👀", "✅", "❤️"). Custom-emoji shortcodes are NOT supported here — pass a real Unicode emoji.'),
-        }),
-    }, async ({ threadId, messageId, emoji }) => {
-        try {
-            const data = await client.post(`/api/threads/${threadId}/messages/${messageId}/reactions`, { emoji, action: 'add' });
-            return {
-                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-            };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return {
-                content: [{ type: 'text', text: `Error: ${message}` }],
-                isError: true,
-            };
-        }
-    });
-}
-//# sourceMappingURL=add-reaction.js.map

package/dist/tools/add-reaction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-reaction.js","sourceRoot":"","sources":["../../src/tools/add-reaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAmB;IACzE,MAAM,CAAC,YAAY,CAClB,oBAAoB,EACpB;QACC,KAAK,EAAE,cAAc;QACrB,WAAW,EACV,goCAAgoC;QACjoC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,QAAQ,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,2DAA2D,CAAC;YACvE,SAAS,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,0BAA0B,CAAC;YACtC,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,qHAAqH,CAAC;SACjI,CAAC;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;QACxC,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC7B,gBAAgB,QAAQ,aAAa,SAAS,YAAY,EAC1D,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CACxB,CAAC;YACF,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACzE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/ask-naumu.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NaumuClient } from '../client.js';
-export declare function registerAskNaumu(server: McpServer, client: NaumuClient): void;