@hebbianvault/mcp 0.2.0

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAgC1C"}

package/dist/config.js

@@ -0,0 +1,86 @@
+/**
+ * src/config.ts
+ *
+ * Configuration loading for @hebbianvault/mcp.
+ *
+ * Auth: bearer token from HEBBIAN_API_TOKEN env var (preferred) or
+ *       HEBBIAN_TOKEN (alternative) or config-file JSON path.
+ * URL:  HEBBIAN_API_URL env var (default: the Hebbian SaaS API). Enterprise
+ *       self-host customers override this to point at their own VM.
+ * Tenant: HEBBIAN_TENANT (optional) — only needed when your account belongs to
+ *       more than one Hebbian workspace, to disambiguate which one to act in.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+// Hebbian SaaS API. Enterprise/self-host customers override with HEBBIAN_API_URL.
+const DEFAULT_API_URL = "https://api.hebbianvault.com";
+/**
+ * Load configuration from environment variables and optional config file.
+ *
+ * Priority (highest first):
+ *   1. HEBBIAN_API_TOKEN / HEBBIAN_TOKEN env vars
+ *   2. HEBBIAN_CONFIG_PATH — path to a JSON config file
+ *   3. ~/.config/hebbian/mcp-tenant.json
+ *
+ * Throws if no token can be resolved — the MCP server cannot start without auth.
+ */
+export function loadConfig() {
+    // ── API URL ────────────────────────────────────────────────────────────────
+    const apiUrl = process.env.HEBBIAN_API_URL ?? DEFAULT_API_URL;
+    // ── Tenant (optional) ────────────────────────────────────────────────────────
+    const envTenant = process.env.HEBBIAN_TENANT?.trim() || undefined;
+    // ── Token (env first) ──────────────────────────────────────────────────────
+    const envToken = process.env.HEBBIAN_API_TOKEN ?? process.env.HEBBIAN_TOKEN;
+    if (envToken && envToken.length > 0) {
+        return { apiUrl, token: envToken, tenant: envTenant };
+    }
+    // ── Token (config file) ────────────────────────────────────────────────────
+    const configPath = resolveConfigPath();
+    if (configPath) {
+        const file = readConfigFile(configPath);
+        if (file.token && file.token.length > 0) {
+            return {
+                apiUrl: file.api_url ?? apiUrl,
+                token: file.token,
+                tenant: envTenant ?? file.tenant,
+            };
+        }
+    }
+    throw new Error("Hebbian MCP: No API token found. " +
+        "Set HEBBIAN_API_TOKEN env var or HEBBIAN_TOKEN env var, " +
+        "or write your token to ~/.config/hebbian/mcp-tenant.json as { \"token\": \"...\" }. " +
+        "Generate a token from the AI Tools tab in your Hebbian integrations page.");
+}
+/** Resolve config file path — explicit env var or default location. */
+function resolveConfigPath() {
+    const explicit = process.env.HEBBIAN_CONFIG_PATH;
+    if (explicit) {
+        const abs = resolve(explicit);
+        if (existsSync(abs))
+            return abs;
+        // Warn but don't throw — fall back to env token check result above
+        process.stderr.write(`[hebbian-mcp] Warning: HEBBIAN_CONFIG_PATH set to "${explicit}" but file not found.\n`);
+        return null;
+    }
+    const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? "";
+    if (!homeDir)
+        return null;
+    const defaultPath = resolve(homeDir, ".config", "hebbian", "mcp-tenant.json");
+    return existsSync(defaultPath) ? defaultPath : null;
+}
+/** Read and parse a JSON config file; tolerates missing fields. */
+function readConfigFile(path) {
+    try {
+        const raw = readFileSync(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null) {
+            throw new Error("Config file must be a JSON object");
+        }
+        return parsed;
+    }
+    catch (err) {
+        process.stderr.write(`[hebbian-mcp] Warning: Could not read config file at "${path}": ${String(err)}\n`);
+        return {};
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * @hebbianvault/mcp — Customer-installable MCP server for the Hebbian tenant brain.
+ *
+ * One package, scope-by-token (Employee or Company). Install in Claude Code,
+ * Claude Desktop, Cursor, Cowork, or any MCP-compatible agent. Configure with a
+ * token issued from your Hebbian integrations page (AI Tools tab).
+ *
+ * Auth: set HEBBIAN_API_TOKEN (or HEBBIAN_TOKEN) env var, or write a config
+ * file at ~/.config/hebbian/mcp-tenant.json with { "token": "hbn_..." }.
+ *
+ * 8 tools:
+ *   hebbian_read_node       — fetch a node by UUID
+ *   hebbian_search          — search the workspace for matching nodes
+ *   hebbian_ask             — synthesis Q&A returned with source quotes
+ *   hebbian_capture         — write a note into the workspace
+ *   hebbian_traverse        — walk the graph from a starting node
+ *   hebbian_provenance      — source trail for a node
+ *   hebbian_salience        — salience/activity history for a node
+ *   hebbian_recent_activity — recent workspace activity timeline
+ *
+ * All access control is enforced server-side by the API. What a token can
+ * read and write is determined by its scope; this package is a thin client.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/index.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+/**
+ * @hebbianvault/mcp — Customer-installable MCP server for the Hebbian tenant brain.
+ *
+ * One package, scope-by-token (Employee or Company). Install in Claude Code,
+ * Claude Desktop, Cursor, Cowork, or any MCP-compatible agent. Configure with a
+ * token issued from your Hebbian integrations page (AI Tools tab).
+ *
+ * Auth: set HEBBIAN_API_TOKEN (or HEBBIAN_TOKEN) env var, or write a config
+ * file at ~/.config/hebbian/mcp-tenant.json with { "token": "hbn_..." }.
+ *
+ * 8 tools:
+ *   hebbian_read_node       — fetch a node by UUID
+ *   hebbian_search          — search the workspace for matching nodes
+ *   hebbian_ask             — synthesis Q&A returned with source quotes
+ *   hebbian_capture         — write a note into the workspace
+ *   hebbian_traverse        — walk the graph from a starting node
+ *   hebbian_provenance      — source trail for a node
+ *   hebbian_salience        — salience/activity history for a node
+ *   hebbian_recent_activity — recent workspace activity timeline
+ *
+ * All access control is enforced server-side by the API. What a token can
+ * read and write is determined by its scope; this package is a thin client.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig } from "./config.js";
+import { HebbianClient } from "./client.js";
+import { printBanner } from "./banner.js";
+import { HEBBIAN_READ_NODE, handleReadNode, HEBBIAN_SEARCH, handleSearch, HEBBIAN_ASK, handleAsk, HEBBIAN_CAPTURE, handleCapture, HEBBIAN_TRAVERSE, handleTraverse, HEBBIAN_PROVENANCE, handleProvenance, HEBBIAN_SALIENCE, handleSalience, HEBBIAN_RECENT_ACTIVITY, handleRecentActivity, } from "./tools/index.js";
+// ── Constants ──────────────────────────────────────────────────────────────────
+const SERVER_NAME = "@hebbianvault/mcp";
+const SERVER_VERSION = "0.2.0";
+// ── All registered tools ───────────────────────────────────────────────────────
+const TOOLS = [
+    HEBBIAN_READ_NODE,
+    HEBBIAN_SEARCH,
+    HEBBIAN_ASK,
+    HEBBIAN_CAPTURE,
+    HEBBIAN_TRAVERSE,
+    HEBBIAN_PROVENANCE,
+    HEBBIAN_SALIENCE,
+    HEBBIAN_RECENT_ACTIVITY,
+];
+// ── Boot ───────────────────────────────────────────────────────────────────────
+async function main() {
+    // Print brand banner to STDERR before transport connects.
+    // STDERR only — stdout is the JSON-RPC wire; any write there corrupts the protocol.
+    printBanner();
+    // Load config early — throw clearly if no token
+    const config = loadConfig();
+    const client = new HebbianClient(config.apiUrl, config.token, config.tenant);
+    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    // ── list_tools ─────────────────────────────────────────────────────────────
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: [...TOOLS],
+    }));
+    // ── call_tool ──────────────────────────────────────────────────────────────
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: rawArgs } = req.params;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const args = (rawArgs ?? {});
+        try {
+            let result;
+            switch (name) {
+                case "hebbian_read_node":
+                    result = await handleReadNode(client, args);
+                    break;
+                case "hebbian_search":
+                    result = await handleSearch(client, args);
+                    break;
+                case "hebbian_ask":
+                    result = await handleAsk(client, args);
+                    break;
+                case "hebbian_capture":
+                    result = await handleCapture(client, args);
+                    break;
+                case "hebbian_traverse":
+                    result = await handleTraverse(client, args);
+                    break;
+                case "hebbian_provenance":
+                    result = await handleProvenance(client, args);
+                    break;
+                case "hebbian_salience":
+                    result = await handleSalience(client, args);
+                    break;
+                case "hebbian_recent_activity":
+                    result = await handleRecentActivity(client, args);
+                    break;
+                default:
+                    return {
+                        content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                        isError: true,
+                    };
+            }
+            return {
+                content: [{ type: "text", text: result }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── Transport ──────────────────────────────────────────────────────────────
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr only (stdout is the MCP wire)
+    process.stderr.write(`[hebbian-mcp] ${SERVER_NAME}@${SERVER_VERSION} started. ` +
+        `API: ${config.apiUrl}\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`[hebbian-mcp] Fatal startup error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/ask.d.ts

@@ -0,0 +1,21 @@
+/**
+ * src/tools/ask.ts
+ *
+ * Tool: hebbian_ask
+ * Synthesis Q&A grounded in the workspace, returned with source quotes.
+ * Maps to: POST /ask  (request body: { query })
+ *
+ * The API response includes `answer`, `sources[]` (each with a `quote`,
+ * `title`, `domain`, `node_uuid`), and a `scope_receipt` describing which
+ * part of the workspace was searched — what you can see is enforced
+ * server-side by your token's scope.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { HebbianClient } from "../client.js";
+export declare const HEBBIAN_ASK: Tool;
+interface AskArgs {
+    question: string;
+}
+export declare function handleAsk(client: HebbianClient, args: AskArgs): Promise<string>;
+export {};
+//# sourceMappingURL=ask.d.ts.map

package/dist/tools/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/tools/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,WAAW,EAAE,IAuBzB,CAAC;AAEF,UAAU,OAAO;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/tools/ask.js

@@ -0,0 +1,53 @@
+/**
+ * src/tools/ask.ts
+ *
+ * Tool: hebbian_ask
+ * Synthesis Q&A grounded in the workspace, returned with source quotes.
+ * Maps to: POST /ask  (request body: { query })
+ *
+ * The API response includes `answer`, `sources[]` (each with a `quote`,
+ * `title`, `domain`, `node_uuid`), and a `scope_receipt` describing which
+ * part of the workspace was searched — what you can see is enforced
+ * server-side by your token's scope.
+ */
+import { HebbianApiError } from "../client.js";
+export const HEBBIAN_ASK = {
+    name: "hebbian_ask",
+    description: "Ask a synthesis question grounded in your Hebbian workspace. Returns an " +
+        "answer backed by source quotes (each citing the node it came from) plus a " +
+        "scope receipt showing what the answer was drawn from. Use this when you " +
+        "need synthesised insight — not just a list of nodes. What the answer can " +
+        "draw on is determined by your token's scope and enforced server-side. " +
+        "Note: each call consumes your workspace's AI-action budget (metered in billing).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            question: {
+                type: "string",
+                description: "Natural language question to ask your Hebbian workspace. " +
+                    "Be specific — the answer is grounded in source quotes, " +
+                    "so precise questions yield more accurate citations.",
+            },
+        },
+        required: ["question"],
+        additionalProperties: false,
+    },
+};
+export async function handleAsk(client, args) {
+    const { question } = args;
+    if (!question || typeof question !== "string" || question.trim().length === 0) {
+        throw new Error("question is required and must be a non-empty string");
+    }
+    try {
+        // API contract: the request field is `query`.
+        const result = await client.post("/ask", { query: question.trim() });
+        return JSON.stringify(result, null, 2);
+    }
+    catch (err) {
+        if (err instanceof HebbianApiError) {
+            throw new Error(err.toToolError());
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=ask.js.map

package/dist/tools/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/tools/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,0EAA0E;QAC1E,4EAA4E;QAC5E,0EAA0E;QAC1E,2EAA2E;QAC3E,wEAAwE;QACxE,kFAAkF;IACpF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,2DAA2D;oBAC3D,yDAAyD;oBACzD,qDAAqD;aACxD;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAqB,EACrB,IAAa;IAEb,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC;QACH,8CAA8C;QAC9C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/capture.d.ts

@@ -0,0 +1,22 @@
+/**
+ * src/tools/capture.ts
+ *
+ * Tool: hebbian_capture
+ * Writes a note into the workspace. Confidential-by-default: captures are
+ * private to you unless you explicitly contribute them to the company pool.
+ * Maps to: POST /capture
+ *   body: { title, body, domain?, tags?, owner_kind? }
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { HebbianClient } from "../client.js";
+export declare const HEBBIAN_CAPTURE: Tool;
+interface CaptureArgs {
+    title: string;
+    text: string;
+    domain?: string;
+    tags?: string[];
+    scope?: "private" | "company";
+}
+export declare function handleCapture(client: HebbianClient, args: CaptureArgs): Promise<string>;
+export {};
+//# sourceMappingURL=capture.d.ts.map

package/dist/tools/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/tools/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,eAAe,EAAE,IA6C7B,CAAC;AAEF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/tools/capture.js

@@ -0,0 +1,85 @@
+/**
+ * src/tools/capture.ts
+ *
+ * Tool: hebbian_capture
+ * Writes a note into the workspace. Confidential-by-default: captures are
+ * private to you unless you explicitly contribute them to the company pool.
+ * Maps to: POST /capture
+ *   body: { title, body, domain?, tags?, owner_kind? }
+ */
+import { HebbianApiError } from "../client.js";
+export const HEBBIAN_CAPTURE = {
+    name: "hebbian_capture",
+    description: "Capture a note into your Hebbian workspace directly from your AI session. " +
+        "Captures are confidential-by-default — private to you unless you set " +
+        "scope='company' to contribute the note to the shared company workspace. " +
+        "Returns the created node UUID. Captured notes appear in the activity " +
+        "timeline. Note: writes are subject to your token's permissions, enforced " +
+        "server-side.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            title: {
+                type: "string",
+                description: "Short title for the note. Required.",
+            },
+            text: {
+                type: "string",
+                description: "Body of the note (Markdown). A raw thought, meeting note, decision, " +
+                    "code snippet with context, or any knowledge worth preserving.",
+            },
+            domain: {
+                type: "string",
+                description: "Optional knowledge domain hint (e.g. 'Company', 'CRM', 'Compass', " +
+                    "'Axis', 'Mirror'). Omit to let the workspace classify it.",
+            },
+            tags: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional free-form tags.",
+            },
+            scope: {
+                type: "string",
+                enum: ["private", "company"],
+                description: "Where this note lives. 'private' (default) keeps it visible only to " +
+                    "you; 'company' contributes it to the shared company workspace. " +
+                    "Company-scope writes require the appropriate permission on your token.",
+            },
+        },
+        required: ["title", "text"],
+        additionalProperties: false,
+    },
+};
+export async function handleCapture(client, args) {
+    const { title, text, domain, tags, scope } = args;
+    if (!title || typeof title !== "string" || title.trim().length === 0) {
+        throw new Error("title is required and must be a non-empty string");
+    }
+    if (!text || typeof text !== "string" || text.trim().length === 0) {
+        throw new Error("text is required and must be a non-empty string");
+    }
+    // API contract: { title, body, domain?, tags?, owner_kind? }.
+    // owner_kind defaults to employee-private at the API; we only send 'company'
+    // when the caller explicitly opts in.
+    const body = {
+        title: title.trim(),
+        body: text.trim(),
+    };
+    if (domain)
+        body["domain"] = domain;
+    if (tags && tags.length > 0)
+        body["tags"] = tags;
+    if (scope === "company")
+        body["owner_kind"] = "company";
+    try {
+        const result = await client.post("/capture", body);
+        return JSON.stringify(result, null, 2);
+    }
+    catch (err) {
+        if (err instanceof HebbianApiError) {
+            throw new Error(err.toToolError());
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/tools/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/tools/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,4EAA4E;QAC5E,uEAAuE;QACvE,0EAA0E;QAC1E,uEAAuE;QACvE,2EAA2E;QAC3E,cAAc;IAChB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sEAAsE;oBACtE,+DAA+D;aAClE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oEAAoE;oBACpE,2DAA2D;aAC9D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,0BAA0B;aACxC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;gBAC5B,WAAW,EACT,sEAAsE;oBACtE,iEAAiE;oBACjE,wEAAwE;aAC3E;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;QAC3B,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAUF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,IAAiB;IAEjB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAElD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,8DAA8D;IAC9D,6EAA6E;IAC7E,sCAAsC;IACtC,MAAM,IAAI,GAA4B;QACpC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KAClB,CAAC;IACF,IAAI,MAAM;QAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;IACpC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACjD,IAAI,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/graph_helpers.d.ts

@@ -0,0 +1,56 @@
+/**
+ * src/tools/graph_helpers.ts
+ *
+ * Shared helpers for tools that operate over the workspace graph.
+ *
+ * The Hebbian API exposes the workspace as a single scoped graph
+ * (GET /vault/graph) where every node carries its title, summary, domain,
+ * archetype, tags, inline edges, and provenance. Several MCP tools
+ * (search, traverse, provenance) are presentation-layer views over that
+ * graph: the API returns the data, this module shapes it for the agent.
+ * Access control is enforced server-side — the graph only ever contains
+ * what the caller's token is allowed to see.
+ */
+import type { HebbianClient } from "../client.js";
+export interface GraphEdge {
+    to?: string;
+    source_uuid?: string;
+    target_uuid?: string;
+    direction?: "in" | "out";
+    relation_type?: string;
+    weight?: number;
+    [k: string]: unknown;
+}
+/**
+ * Normalise an edge owned by `ownerUuid` into (source, target, relation, weight).
+ * Handles both the /vault/graph `{ to }` shape and the /nodes/:uuid
+ * `{ source_uuid, target_uuid }` shape.
+ */
+export declare function normaliseEdge(e: GraphEdge, ownerUuid: string): {
+    source: string;
+    target: string;
+    relation?: string;
+    weight?: number;
+};
+export interface GraphNode {
+    uuid: string;
+    title?: string;
+    summary?: string;
+    detail?: string;
+    domain?: string;
+    archetype?: string;
+    actor?: string;
+    tags?: string[];
+    edges?: GraphEdge[];
+    provenance?: unknown;
+    [k: string]: unknown;
+}
+/** Fetch the full scoped workspace graph for the current token. */
+export declare function fetchGraph(client: HebbianClient): Promise<GraphNode[]>;
+/** Score a node against query terms. Returns 0 when no term matches. */
+export declare function scoreNode(n: GraphNode, terms: string[]): number;
+/** Split a query string into lower-cased terms. */
+export declare function queryTerms(q: string): string[];
+/** A compact node summary for search/traverse result lists. */
+export declare function summarise(n: GraphNode): Record<string, unknown>;
+//# sourceMappingURL=graph_helpers.d.ts.map

package/dist/tools/graph_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph_helpers.d.ts","sourceRoot":"","sources":["../../src/tools/graph_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,SAAS;IAIxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,SAAS,EACZ,SAAS,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAQxE;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAOD,mEAAmE;AACnE,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAG5E;AAeD,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAW/D;AAED,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9C;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU/D"}

package/dist/tools/graph_helpers.js

@@ -0,0 +1,82 @@
+/**
+ * src/tools/graph_helpers.ts
+ *
+ * Shared helpers for tools that operate over the workspace graph.
+ *
+ * The Hebbian API exposes the workspace as a single scoped graph
+ * (GET /vault/graph) where every node carries its title, summary, domain,
+ * archetype, tags, inline edges, and provenance. Several MCP tools
+ * (search, traverse, provenance) are presentation-layer views over that
+ * graph: the API returns the data, this module shapes it for the agent.
+ * Access control is enforced server-side — the graph only ever contains
+ * what the caller's token is allowed to see.
+ */
+/**
+ * Normalise an edge owned by `ownerUuid` into (source, target, relation, weight).
+ * Handles both the /vault/graph `{ to }` shape and the /nodes/:uuid
+ * `{ source_uuid, target_uuid }` shape.
+ */
+export function normaliseEdge(e, ownerUuid) {
+    if (typeof e.to === "string") {
+        // Adjacency form: owner -> to (direction not exposed; treat owner as source).
+        return { source: ownerUuid, target: e.to, relation: e.relation_type, weight: e.weight };
+    }
+    const src = e.source_uuid ?? ownerUuid;
+    const tgt = e.target_uuid ?? ownerUuid;
+    return { source: src, target: tgt, relation: e.relation_type, weight: e.weight };
+}
+/** Fetch the full scoped workspace graph for the current token. */
+export async function fetchGraph(client) {
+    const resp = (await client.get("/vault/graph"));
+    return Array.isArray(resp.nodes) ? resp.nodes : [];
+}
+/** Lower-cased haystack of a node's searchable text fields. */
+function nodeHaystack(n) {
+    const parts = [
+        n.title,
+        n.summary,
+        n.detail,
+        n.domain,
+        n.archetype,
+        ...(Array.isArray(n.tags) ? n.tags : []),
+    ];
+    return parts.filter(Boolean).join(" \n ").toLowerCase();
+}
+/** Score a node against query terms. Returns 0 when no term matches. */
+export function scoreNode(n, terms) {
+    if (terms.length === 0)
+        return 0;
+    const hay = nodeHaystack(n);
+    const title = (n.title ?? "").toLowerCase();
+    let score = 0;
+    for (const t of terms) {
+        if (!t)
+            continue;
+        if (title.includes(t))
+            score += 3; // title hits weigh more
+        else if (hay.includes(t))
+            score += 1;
+    }
+    return score;
+}
+/** Split a query string into lower-cased terms. */
+export function queryTerms(q) {
+    return q
+        .toLowerCase()
+        .split(/\s+/)
+        .map((t) => t.trim())
+        .filter((t) => t.length > 0);
+}
+/** A compact node summary for search/traverse result lists. */
+export function summarise(n) {
+    const snippet = (n.summary ?? n.detail ?? "").toString().slice(0, 280);
+    return {
+        uuid: n.uuid,
+        title: n.title ?? null,
+        domain: n.domain ?? null,
+        archetype: n.archetype ?? null,
+        tags: n.tags ?? [],
+        snippet,
+    };
+}
+//# sourceMappingURL=graph_helpers.js.map

package/dist/tools/graph_helpers.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * src/tools/index.ts
+ *
+ * Re-exports all 8 tool definitions for @hebbianvault/mcp.
+ */
+export { HEBBIAN_READ_NODE, handleReadNode } from "./read_node.js";
+export { HEBBIAN_SEARCH, handleSearch } from "./search.js";
+export { HEBBIAN_ASK, handleAsk } from "./ask.js";
+export { HEBBIAN_CAPTURE, handleCapture } from "./capture.js";
+export { HEBBIAN_TRAVERSE, handleTraverse } from "./traverse.js";
+export { HEBBIAN_PROVENANCE, handleProvenance } from "./provenance.js";
+export { HEBBIAN_SALIENCE, handleSalience } from "./salience.js";
+export { HEBBIAN_RECENT_ACTIVITY, handleRecentActivity } from "./recent_activity.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,14 @@
+/**
+ * src/tools/index.ts
+ *
+ * Re-exports all 8 tool definitions for @hebbianvault/mcp.
+ */
+export { HEBBIAN_READ_NODE, handleReadNode } from "./read_node.js";
+export { HEBBIAN_SEARCH, handleSearch } from "./search.js";
+export { HEBBIAN_ASK, handleAsk } from "./ask.js";
+export { HEBBIAN_CAPTURE, handleCapture } from "./capture.js";
+export { HEBBIAN_TRAVERSE, handleTraverse } from "./traverse.js";
+export { HEBBIAN_PROVENANCE, handleProvenance } from "./provenance.js";
+export { HEBBIAN_SALIENCE, handleSalience } from "./salience.js";
+export { HEBBIAN_RECENT_ACTIVITY, handleRecentActivity } from "./recent_activity.js";
+//# sourceMappingURL=index.js.map