@hebbianvault/mcp 0.2.0

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/provenance.d.ts

@@ -0,0 +1,20 @@
+/**
+ * src/tools/provenance.ts
+ *
+ * Tool: hebbian_provenance
+ * Retrieve the provenance trail for a node — where its knowledge came from.
+ *
+ * The node's provenance travels with it in the workspace graph
+ * (GET /vault/graph). This tool reads the node and returns its provenance
+ * plus identifying metadata. Access is enforced server-side, so a node is
+ * only returned when the caller's token may see it.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { HebbianClient } from "../client.js";
+export declare const HEBBIAN_PROVENANCE: Tool;
+interface ProvenanceArgs {
+    uuid: string;
+}
+export declare function handleProvenance(client: HebbianClient, args: ProvenanceArgs): Promise<string>;
+export {};
+//# sourceMappingURL=provenance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/tools/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,eAAO,MAAM,kBAAkB,EAAE,IAoBhC,CAAC;AAEF,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CA2CjB"}

package/dist/tools/provenance.js

@@ -0,0 +1,64 @@
+/**
+ * src/tools/provenance.ts
+ *
+ * Tool: hebbian_provenance
+ * Retrieve the provenance trail for a node — where its knowledge came from.
+ *
+ * The node's provenance travels with it in the workspace graph
+ * (GET /vault/graph). This tool reads the node and returns its provenance
+ * plus identifying metadata. Access is enforced server-side, so a node is
+ * only returned when the caller's token may see it.
+ */
+import { HebbianApiError } from "../client.js";
+import { fetchGraph } from "./graph_helpers.js";
+export const HEBBIAN_PROVENANCE = {
+    name: "hebbian_provenance",
+    description: "Retrieve the provenance trail for a workspace node — where the knowledge came " +
+        "from. Use this to verify a source, trace an insight back to where it " +
+        "originated, or understand how a node was formed. Returns nothing if the node " +
+        "is outside your token's scope.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            uuid: {
+                type: "string",
+                description: "UUID of the node whose provenance to retrieve. " +
+                    "Obtain from hebbian_search or hebbian_traverse.",
+            },
+        },
+        required: ["uuid"],
+        additionalProperties: false,
+    },
+};
+export async function handleProvenance(client, args) {
+    const { uuid } = args;
+    if (!uuid || typeof uuid !== "string" || uuid.trim().length === 0) {
+        throw new Error("uuid is required and must be a non-empty string");
+    }
+    const target = uuid.trim();
+    try {
+        const nodes = await fetchGraph(client);
+        const node = nodes.find((n) => n.uuid === target);
+        if (!node) {
+            return JSON.stringify({
+                uuid: target,
+                message: "Node not found in the visible workspace graph. It may not exist or " +
+                    "may be outside your token's scope.",
+                provenance: null,
+            }, null, 2);
+        }
+        return JSON.stringify({
+            uuid: node.uuid,
+            title: node.title ?? null,
+            domain: node.domain ?? null,
+            provenance: node.provenance ?? null,
+        }, null, 2);
+    }
+    catch (err) {
+        if (err instanceof HebbianApiError) {
+            throw new Error(err.toToolError());
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=provenance.js.map

package/dist/tools/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../../src/tools/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,gFAAgF;QAChF,uEAAuE;QACvE,+EAA+E;QAC/E,gCAAgC;IAClC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iDAAiD;oBACjD,iDAAiD;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAqB,EACrB,IAAoB;IAEpB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,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,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAElD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,SAAS,CACnB;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EACL,qEAAqE;oBACrE,oCAAoC;gBACtC,UAAU,EAAE,IAAI;aACjB,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CACnB;YACE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;SACpC,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IACJ,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/read_node.d.ts

@@ -0,0 +1,16 @@
+/**
+ * src/tools/read_node.ts
+ *
+ * Tool: hebbian_read_node
+ * Fetches a single node by UUID — body, frontmatter, and connected edges.
+ * Maps to: GET /nodes/:uuid
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { HebbianClient } from "../client.js";
+export declare const HEBBIAN_READ_NODE: Tool;
+interface ReadNodeArgs {
+    uuid: string;
+}
+export declare function handleReadNode(client: HebbianClient, args: ReadNodeArgs): Promise<string>;
+export {};
+//# sourceMappingURL=read_node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read_node.d.ts","sourceRoot":"","sources":["../../src/tools/read_node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,iBAAiB,EAAE,IAoB/B,CAAC;AAEF,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/tools/read_node.js

@@ -0,0 +1,44 @@
+/**
+ * src/tools/read_node.ts
+ *
+ * Tool: hebbian_read_node
+ * Fetches a single node by UUID — body, frontmatter, and connected edges.
+ * Maps to: GET /nodes/:uuid
+ */
+import { HebbianApiError } from "../client.js";
+export const HEBBIAN_READ_NODE = {
+    name: "hebbian_read_node",
+    description: "Retrieve a single Hebbian workspace node by its UUID. Returns the node body, " +
+        "frontmatter (domain, archetype, actor, title, summary), and the edges that " +
+        "connect it to other nodes. Use this when you have a specific node ID from a " +
+        "previous search or traversal and want to read its full content.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            uuid: {
+                type: "string",
+                description: "The UUID of the node to retrieve (e.g. '550e8400-e29b-41d4-a716-446655440000'). " +
+                    "Obtain from hebbian_search, hebbian_traverse, or hebbian_recent_activity.",
+            },
+        },
+        required: ["uuid"],
+        additionalProperties: false,
+    },
+};
+export async function handleReadNode(client, args) {
+    const { uuid } = args;
+    if (!uuid || typeof uuid !== "string" || uuid.trim().length === 0) {
+        throw new Error("uuid is required and must be a non-empty string");
+    }
+    try {
+        const node = await client.get(`/nodes/${encodeURIComponent(uuid.trim())}`);
+        return JSON.stringify(node, null, 2);
+    }
+    catch (err) {
+        if (err instanceof HebbianApiError) {
+            throw new Error(err.toToolError());
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=read_node.js.map

package/dist/tools/read_node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_node.js","sourceRoot":"","sources":["../../src/tools/read_node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,+EAA+E;QAC/E,6EAA6E;QAC7E,8EAA8E;QAC9E,iEAAiE;IACnE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kFAAkF;oBAClF,2EAA2E;aAC9E;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAqB,EACrB,IAAkB;IAElB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,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,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,UAAU,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAC5C,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,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/recent_activity.d.ts

@@ -0,0 +1,18 @@
+/**
+ * src/tools/recent_activity.ts
+ *
+ * Tool: hebbian_recent_activity
+ * Retrieve the recent activity timeline for the workspace — new notes,
+ * intakes, and other audited events.
+ * Maps to: GET /vault/activity
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { HebbianClient } from "../client.js";
+export declare const HEBBIAN_RECENT_ACTIVITY: Tool;
+interface RecentActivityArgs {
+    since?: string;
+    limit?: number;
+}
+export declare function handleRecentActivity(client: HebbianClient, args: RecentActivityArgs): Promise<string>;
+export {};
+//# sourceMappingURL=recent_activity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recent_activity.d.ts","sourceRoot":"","sources":["../../src/tools/recent_activity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,uBAAuB,EAAE,IA4BrC,CAAC;AAEF,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/tools/recent_activity.js

@@ -0,0 +1,60 @@
+/**
+ * src/tools/recent_activity.ts
+ *
+ * Tool: hebbian_recent_activity
+ * Retrieve the recent activity timeline for the workspace — new notes,
+ * intakes, and other audited events.
+ * Maps to: GET /vault/activity
+ */
+import { HebbianApiError } from "../client.js";
+export const HEBBIAN_RECENT_ACTIVITY = {
+    name: "hebbian_recent_activity",
+    description: "Retrieve recent activity in your Hebbian workspace — which notes were " +
+        "created or updated and other audited events. Use this to catch up on what " +
+        "the workspace has learned since your last session, or to find recently-" +
+        "created nodes. Returns a reverse-chronological activity timeline. " +
+        "The 'since' param accepts an ISO 8601 datetime.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            since: {
+                type: "string",
+                description: "ISO 8601 datetime to retrieve activity from (e.g. '2026-05-14T09:00:00Z'). " +
+                    "Omit to get the most recent activity.",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of activity items to return. Default: 20. Max: 100.",
+                minimum: 1,
+                maximum: 100,
+            },
+        },
+        required: [],
+        additionalProperties: false,
+    },
+};
+export async function handleRecentActivity(client, args) {
+    const { since, limit = 20 } = args;
+    const query = {
+        limit: Math.min(Math.max(1, limit), 100),
+    };
+    if (since) {
+        // Validate ISO 8601 format — basic check
+        const parsed = Date.parse(since);
+        if (isNaN(parsed)) {
+            throw new Error(`'since' must be a valid ISO 8601 datetime, got: "${since}"`);
+        }
+        query["since"] = since;
+    }
+    try {
+        const result = await client.get("/vault/activity", query);
+        return JSON.stringify(result, null, 2);
+    }
+    catch (err) {
+        if (err instanceof HebbianApiError) {
+            throw new Error(err.toToolError());
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=recent_activity.js.map

package/dist/tools/recent_activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent_activity.js","sourceRoot":"","sources":["../../src/tools/recent_activity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,uBAAuB,GAAS;IAC3C,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,wEAAwE;QACxE,4EAA4E;QAC5E,yEAAyE;QACzE,oEAAoE;QACpE,iDAAiD;IACnD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6EAA6E;oBAC7E,uCAAuC;aAC1C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oEAAoE;gBACtE,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;aACb;SACF;QACD,QAAQ,EAAE,EAAE;QACZ,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAqB,EACrB,IAAwB;IAExB,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAEnC,MAAM,KAAK,GAA0D;QACnE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC;KACzC,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACV,yCAAyC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oDAAoD,KAAK,GAAG,CAAC,CAAC;QAChF,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAC1D,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/salience.d.ts

@@ -0,0 +1,17 @@
+/**
+ * src/tools/salience.ts
+ *
+ * Tool: hebbian_salience
+ * Return the recent activity/salience history for a node — how often and how
+ * recently it has been surfacing in the workspace.
+ * Maps to: GET /metrics/nodes/:uuid/activation-history
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { HebbianClient } from "../client.js";
+export declare const HEBBIAN_SALIENCE: Tool;
+interface SalienceArgs {
+    uuid: string;
+}
+export declare function handleSalience(client: HebbianClient, args: SalienceArgs): Promise<string>;
+export {};
+//# sourceMappingURL=salience.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"salience.d.ts","sourceRoot":"","sources":["../../src/tools/salience.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,gBAAgB,EAAE,IAoB9B,CAAC;AAEF,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/tools/salience.js

@@ -0,0 +1,45 @@
+/**
+ * src/tools/salience.ts
+ *
+ * Tool: hebbian_salience
+ * Return the recent activity/salience history for a node — how often and how
+ * recently it has been surfacing in the workspace.
+ * Maps to: GET /metrics/nodes/:uuid/activation-history
+ */
+import { HebbianApiError } from "../client.js";
+export const HEBBIAN_SALIENCE = {
+    name: "hebbian_salience",
+    description: "Retrieve the salience history for a workspace node — a timeline of how often " +
+        "and how recently it has been surfacing. Use this to gauge whether a node is " +
+        "currently active and relevant, or fading from daily use. Returns an empty " +
+        "history when a node has no recorded activity yet.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            uuid: {
+                type: "string",
+                description: "UUID of the node whose salience history to retrieve. " +
+                    "Obtain from hebbian_search or hebbian_traverse.",
+            },
+        },
+        required: ["uuid"],
+        additionalProperties: false,
+    },
+};
+export async function handleSalience(client, args) {
+    const { uuid } = args;
+    if (!uuid || typeof uuid !== "string" || uuid.trim().length === 0) {
+        throw new Error("uuid is required and must be a non-empty string");
+    }
+    try {
+        const result = await client.get(`/metrics/nodes/${encodeURIComponent(uuid.trim())}/activation-history`);
+        return JSON.stringify(result, null, 2);
+    }
+    catch (err) {
+        if (err instanceof HebbianApiError) {
+            throw new Error(err.toToolError());
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=salience.js.map

package/dist/tools/salience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"salience.js","sourceRoot":"","sources":["../../src/tools/salience.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,+EAA+E;QAC/E,8EAA8E;QAC9E,4EAA4E;QAC5E,mDAAmD;IACrD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uDAAuD;oBACvD,iDAAiD;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAqB,EACrB,IAAkB;IAElB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,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,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC7B,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,qBAAqB,CACvE,CAAC;QACF,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/search.d.ts

@@ -0,0 +1,22 @@
+/**
+ * src/tools/search.ts
+ *
+ * Tool: hebbian_search
+ * Search the workspace for nodes matching a query.
+ *
+ * The Hebbian API exposes the workspace as a scoped graph (GET /vault/graph),
+ * already filtered to what the caller's token may see. This tool ranks that
+ * graph against the query and returns the best matches. The graph is the
+ * authoritative source; ranking is a thin presentation layer.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { HebbianClient } from "../client.js";
+export declare const HEBBIAN_SEARCH: Tool;
+interface SearchArgs {
+    q: string;
+    domain?: string;
+    limit?: number;
+}
+export declare function handleSearch(client: HebbianClient, args: SearchArgs): Promise<string>;
+export {};
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAUlD,eAAO,MAAM,cAAc,EAAE,IAgC5B,CAAC;AAEF,UAAU,UAAU;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,CAoCjB"}

package/dist/tools/search.js

@@ -0,0 +1,73 @@
+/**
+ * src/tools/search.ts
+ *
+ * Tool: hebbian_search
+ * Search the workspace for nodes matching a query.
+ *
+ * The Hebbian API exposes the workspace as a scoped graph (GET /vault/graph),
+ * already filtered to what the caller's token may see. This tool ranks that
+ * graph against the query and returns the best matches. The graph is the
+ * authoritative source; ranking is a thin presentation layer.
+ */
+import { HebbianApiError } from "../client.js";
+import { fetchGraph, queryTerms, scoreNode, summarise, } from "./graph_helpers.js";
+export const HEBBIAN_SEARCH = {
+    name: "hebbian_search",
+    description: "Search your Hebbian workspace for nodes matching a query. Returns a ranked " +
+        "list of matching nodes with their UUID, title, domain, archetype, tags, and " +
+        "a snippet. Use this as the starting point for exploring the workspace when " +
+        "you have a topic or question. The 'domain' param filters by knowledge area " +
+        "(e.g. 'Company', 'Compass'). Results only ever include what your token is " +
+        "allowed to see — access is enforced server-side.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            q: {
+                type: "string",
+                description: "Search query — natural language or keywords. Required.",
+            },
+            domain: {
+                type: "string",
+                description: "Optional filter by knowledge domain (e.g. 'Company', 'CRM', 'Compass', " +
+                    "'Axis', 'Mirror', 'Finance', 'Oracle'). Omit to search all domains.",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of results to return. Default: 10. Max: 50.",
+                minimum: 1,
+                maximum: 50,
+            },
+        },
+        required: ["q"],
+        additionalProperties: false,
+    },
+};
+export async function handleSearch(client, args) {
+    const { q, domain, limit = 10 } = args;
+    if (!q || typeof q !== "string" || q.trim().length === 0) {
+        throw new Error("q is required and must be a non-empty string");
+    }
+    const cap = Math.min(Math.max(1, limit), 50);
+    const terms = queryTerms(q);
+    try {
+        let nodes = await fetchGraph(client);
+        if (domain) {
+            const d = domain.toLowerCase();
+            nodes = nodes.filter((n) => (n.domain ?? "").toLowerCase() === d);
+        }
+        const ranked = nodes
+            .map((n) => ({ n, score: scoreNode(n, terms) }))
+            .filter((x) => x.score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, cap)
+            .map((x) => summarise(x.n));
+        return JSON.stringify({ query: q.trim(), domain: domain ?? null, count: ranked.length, results: ranked }, null, 2);
+    }
+    catch (err) {
+        if (err instanceof HebbianApiError) {
+            throw new Error(err.toToolError());
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/traverse.d.ts

@@ -0,0 +1,21 @@
+/**
+ * src/tools/traverse.ts
+ *
+ * Tool: hebbian_traverse
+ * Walk the workspace graph outward from a starting node up to N hops.
+ *
+ * Built over the scoped workspace graph (GET /vault/graph), where each node
+ * carries its inline edges. We do a breadth-first walk from the start node;
+ * only nodes the caller's token may see are present in the graph, so traversal
+ * never crosses an access boundary.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { HebbianClient } from "../client.js";
+export declare const HEBBIAN_TRAVERSE: Tool;
+interface TraverseArgs {
+    start_uuid: string;
+    max_hops?: number;
+}
+export declare function handleTraverse(client: HebbianClient, args: TraverseArgs): Promise<string>;
+export {};
+//# sourceMappingURL=traverse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../src/tools/traverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAOlD,eAAO,MAAM,gBAAgB,EAAE,IA4B9B,CAAC;AAEF,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,MAAM,CAAC,CAuFjB"}

package/dist/tools/traverse.js

@@ -0,0 +1,117 @@
+/**
+ * src/tools/traverse.ts
+ *
+ * Tool: hebbian_traverse
+ * Walk the workspace graph outward from a starting node up to N hops.
+ *
+ * Built over the scoped workspace graph (GET /vault/graph), where each node
+ * carries its inline edges. We do a breadth-first walk from the start node;
+ * only nodes the caller's token may see are present in the graph, so traversal
+ * never crosses an access boundary.
+ */
+import { HebbianApiError } from "../client.js";
+import { fetchGraph, normaliseEdge, summarise } from "./graph_helpers.js";
+const MAX_HOPS = 5;
+const DEFAULT_HOPS = 2;
+export const HEBBIAN_TRAVERSE = {
+    name: "hebbian_traverse",
+    description: "Walk your Hebbian workspace graph from a starting node, returning connected " +
+        "nodes up to N hops away plus the edges between them. Use this to explore the " +
+        "context around a node — e.g. notes related to a project, or signals connected " +
+        "to a person. Only nodes your token may see are returned.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            start_uuid: {
+                type: "string",
+                description: "UUID of the starting node. Obtain from hebbian_search or " +
+                    "hebbian_recent_activity.",
+            },
+            max_hops: {
+                type: "number",
+                description: `Maximum number of hops to traverse. Default: ${DEFAULT_HOPS}. Max: ${MAX_HOPS}. ` +
+                    "Higher values return more context but may include loosely-related nodes.",
+                minimum: 1,
+                maximum: MAX_HOPS,
+            },
+        },
+        required: ["start_uuid"],
+        additionalProperties: false,
+    },
+};
+export async function handleTraverse(client, args) {
+    const { start_uuid, max_hops = DEFAULT_HOPS } = args;
+    if (!start_uuid || typeof start_uuid !== "string" || start_uuid.trim().length === 0) {
+        throw new Error("start_uuid is required and must be a non-empty string");
+    }
+    const hops = Math.min(Math.max(1, max_hops), MAX_HOPS);
+    const start = start_uuid.trim();
+    try {
+        const nodes = await fetchGraph(client);
+        const byUuid = new Map();
+        for (const n of nodes)
+            byUuid.set(n.uuid, n);
+        if (!byUuid.has(start)) {
+            return JSON.stringify({
+                start_uuid: start,
+                message: "Start node not found in the visible workspace graph. It may not exist " +
+                    "or may be outside your token's scope.",
+                nodes: [],
+                edges: [],
+            }, null, 2);
+        }
+        // BFS over inline edges.
+        const visited = new Set([start]);
+        const collectedEdges = [];
+        const edgeSeen = new Set();
+        let frontier = [start];
+        for (let hop = 0; hop < hops; hop++) {
+            const next = [];
+            for (const uuid of frontier) {
+                const node = byUuid.get(uuid);
+                if (!node || !Array.isArray(node.edges))
+                    continue;
+                for (const e of node.edges) {
+                    const { source: src, target: tgt, relation, weight } = normaliseEdge(e, uuid);
+                    const neighbour = src === uuid ? tgt : src;
+                    const key = `${src}->${tgt}:${relation ?? ""}`;
+                    if (!edgeSeen.has(key)) {
+                        edgeSeen.add(key);
+                        collectedEdges.push({
+                            source_uuid: src,
+                            target_uuid: tgt,
+                            relation_type: relation,
+                            weight,
+                        });
+                    }
+                    if (neighbour && !visited.has(neighbour) && byUuid.has(neighbour)) {
+                        visited.add(neighbour);
+                        next.push(neighbour);
+                    }
+                }
+            }
+            frontier = next;
+            if (frontier.length === 0)
+                break;
+        }
+        const resultNodes = [...visited]
+            .map((u) => byUuid.get(u))
+            .filter((n) => Boolean(n))
+            .map(summarise);
+        return JSON.stringify({
+            start_uuid: start,
+            max_hops: hops,
+            node_count: resultNodes.length,
+            edge_count: collectedEdges.length,
+            nodes: resultNodes,
+            edges: collectedEdges,
+        }, null, 2);
+    }
+    catch (err) {
+        if (err instanceof HebbianApiError) {
+            throw new Error(err.toToolError());
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=traverse.js.map

package/dist/tools/traverse.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@hebbianvault/mcp",
+  "version": "0.2.0",
+  "description": "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.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "hebbian-mcp": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && node -e \"const{mkdirSync,cpSync}=require('fs');mkdirSync('dist/assets',{recursive:true});cpSync('src/assets/lockup.txt','dist/assets/lockup.txt')\"",
+    "dev": "tsc --watch",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest --config=jest.config.cjs tests/",
+    "prepublishOnly": "npm run build && npm test",
+    "start": "node dist/index.js",
+    "postinstall": "node scripts/postinstall.mjs || true"
+  },
+  "keywords": [
+    "mcp",
+    "hebbian",
+    "knowledge-graph",
+    "ai-tools",
+    "model-context-protocol"
+  ],
+  "author": "Hebbian",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.6.3"
+  }
+}