bhived-mcp 1.1.5

package/dist/formatters/queryFormatter.js

@@ -0,0 +1,250 @@
+/**
+ * Query Result Formatter
+ *
+ * Formats /v1/query results as clean Markdown optimized for LLM parsing.
+ *
+ * Design principles:
+ * - Markdown for universal LLM readability
+ * - Minimal decoration, maximum information density
+ * - Clear key:value pairs for reliable extraction
+ * - Token-efficient: no box-drawing chars, no emoji spam
+ *
+ * Skills and MCPs are separated from regular recommendations into
+ * dedicated "Recommended Skills" / "Recommended MCPs" sections that
+ * display only the description, resources, and activation ID.
+ */
+// ── Max items for capability sections ────────────────────────────
+const MAX_SKILLS_SHOWN = 10;
+const MAX_MCPS_SHOWN = 10;
+const MAX_WORDS_SHOWN = 200;
+function trimTextForReadability(text, maxWords, memId = null) {
+    if (!text)
+        return text;
+    const words = text.trim().split(/\s+/);
+    if (words.length <= maxWords)
+        return text;
+    const truncated = words.slice(0, maxWords).join(" ");
+    let notice = `\n\n> ✂️ **Note:** Text truncated (${words.length} words).`;
+    if (memId) {
+        notice += ` Use \`hivemind_inspect(memory_id="${memId}")\` to read the full text.`;
+    }
+    return `${truncated}...${notice}`;
+}
+export function formatQueryResult(result) {
+    const sections = [];
+    const recs = result.recommendations ?? [];
+    // ── Partition: separate skill/mcp memories from regular memories ──
+    const regularMemories = [];
+    const skillMemories = [];
+    const mcpMemories = [];
+    for (const mem of recs) {
+        if (mem.has_skill && mem.skill_meta) {
+            skillMemories.push(mem);
+        }
+        else if (mem.has_mcp && mem.mcp_meta) {
+            mcpMemories.push(mem);
+        }
+        else {
+            regularMemories.push(mem);
+        }
+    }
+    // ── Header ──
+    sections.push(`# HiveMind Results (${recs.length} found)\n`);
+    // ── Regular Recommendations (non-skill, non-mcp) ──
+    if (regularMemories.length === 0 && skillMemories.length === 0 && mcpMemories.length === 0) {
+        sections.push("No matching memories found. Try broadening your query.\n");
+    }
+    else if (regularMemories.length > 0) {
+        sections.push("## Recommendations\n");
+        regularMemories.forEach((mem, i) => {
+            sections.push(formatMemory(mem, i + 1));
+        });
+    }
+    // ── Recommended Skills section ──
+    if (skillMemories.length > 0) {
+        sections.push(formatRecommendedSkills(skillMemories));
+    }
+    // ── Recommended MCPs section ──
+    if (mcpMemories.length > 0) {
+        sections.push(formatRecommendedMcps(mcpMemories));
+    }
+    // ── Warnings ──
+    const warnings = result.warnings ?? [];
+    if (warnings.length > 0) {
+        sections.push("## ⚠️ Warnings\n");
+        warnings.forEach((w) => {
+            sections.push(formatWarning(w));
+        });
+    }
+    // ── Disputed Pairs ──
+    const disputed = result.disputed_pairs ?? [];
+    if (disputed.length > 0) {
+        sections.push("## Disputed Pairs\n");
+        disputed.forEach((pair) => {
+            sections.push(formatDisputed(pair));
+        });
+    }
+    // ── Episodes ──
+    const episodes = result.episodes ?? [];
+    if (episodes.length > 0) {
+        sections.push("## Episodes\n");
+        episodes.forEach((ep) => {
+            const memIds = ep.memories.map(m => getMemoryId(m)).join(" → ");
+            sections.push(`- **${ep.topic}**: ${memIds}`);
+        });
+        sections.push("");
+    }
+    // ── Query ID (critical for feedback loop) ──
+    sections.push("---");
+    sections.push(`**query_id**: \`${result.query_id}\``);
+    sections.push("Save this and pass it to your write call to close the feedback loop.");
+    return sections.join("\n");
+}
+/** Extract memory ID, handling both `id` and `memory_id` field names */
+function getMemoryId(mem) {
+    return mem.id ?? mem["memory_id"] ?? "unknown";
+}
+/**
+ * Format a regular (non-skill, non-mcp) memory recommendation.
+ * No capability badges — skills/MCPs have their own section.
+ */
+function formatMemory(mem, rank) {
+    const lines = [];
+    const memId = getMemoryId(mem);
+    // Header: rank, type badge, and title
+    const title = mem.title ? `**${mem.title}**` : "_(untitled)_";
+    lines.push(`### ${rank}. [${mem.type ?? "memory"}] ${title}\n`);
+    // Metadata line — compact key:value pairs
+    const meta = [];
+    meta.push(`score: ${mem.score?.toFixed(2) ?? "N/A"}`);
+    if (mem.corroboration_count && mem.corroboration_count > 0) {
+        meta.push(`+${mem.corroboration_count} corroborated`);
+    }
+    if (mem.contradiction_count && mem.contradiction_count > 0) {
+        meta.push(`-${mem.contradiction_count} contradicted`);
+    }
+    if (mem.times_retrieved && mem.times_retrieved > 0) {
+        meta.push(`${mem.times_retrieved}× retrieved`);
+    }
+    if (memId !== "unknown") {
+        meta.push(`id: \`${memId}\``);
+    }
+    lines.push(`> ${meta.join(" · ")}\n`);
+    // Content
+    const content = mem.text ? trimTextForReadability(mem.text, MAX_WORDS_SHOWN, memId) : "";
+    lines.push(`${content}\n`);
+    return lines.join("\n");
+}
+// ── Recommended Skills section ──────────────────────────────────
+/**
+ * Format a dedicated "Recommended Skills" section.
+ * Shows description, resources, and the memory_id to activate.
+ */
+function formatRecommendedSkills(skills) {
+    const lines = [];
+    lines.push("## 🔧 Recommended Skills\n");
+    lines.push("> Activate a skill with `hivemind_initiate_skill(memory_id, agent_id)` to load its instructions, scripts, and resources.\n");
+    const shown = skills.slice(0, MAX_SKILLS_SHOWN);
+    shown.forEach((mem, i) => {
+        const sm = mem.skill_meta;
+        const memId = getMemoryId(mem);
+        // Skill name (bold)
+        lines.push(`### ${i + 1}. ${sm.name}\n`);
+        // Description
+        if (sm.description) {
+            const desc = trimTextForReadability(sm.description, MAX_WORDS_SHOWN, memId);
+            lines.push(`${desc}\n`);
+        }
+        // Resources table
+        const resources = [];
+        if (sm.script_count)
+            resources.push(`${sm.script_count} scripts`);
+        if (sm.reference_count)
+            resources.push(`${sm.reference_count} references`);
+        if (sm.asset_count)
+            resources.push(`${sm.asset_count} assets`);
+        if (sm.mcp_count) {
+            const names = sm.mcp_names ? ` (${sm.mcp_names.join(", ")})` : "";
+            resources.push(`${sm.mcp_count} bundled MCP(s)${names}`);
+        }
+        if (resources.length > 0) {
+            lines.push(`📦 **Resources:** ${resources.join(" · ")}\n`);
+        }
+        // Usage stats (if available)
+        const stats = [];
+        if (sm.usage_count !== undefined)
+            stats.push(`used by ${sm.usage_count} agents`);
+        if (sm.success_rate !== undefined)
+            stats.push(`success: ${Math.round(sm.success_rate * 100)}%`);
+        if (stats.length > 0) {
+            lines.push(`📊 ${stats.join(" · ")}\n`);
+        }
+        // Activation ID — the key piece
+        lines.push(`🆔 **Activate:** \`memory_id="${memId}"\`\n`);
+    });
+    if (skills.length > MAX_SKILLS_SHOWN) {
+        lines.push(`> ${skills.length - MAX_SKILLS_SHOWN} more skill(s) found but not shown.\n`);
+    }
+    return lines.join("\n");
+}
+// ── Recommended MCPs section ────────────────────────────────────
+/**
+ * Format a dedicated "Recommended MCPs" section.
+ * Shows description, tools hint, and the memory_id to activate.
+ */
+function formatRecommendedMcps(mcps) {
+    const lines = [];
+    lines.push("## 🔌 Recommended MCPs\n");
+    lines.push("> Activate an MCP with `hivemind_initiate_mcp(memory_id, agent_id)` to spawn it and use its tools.\n");
+    const shown = mcps.slice(0, MAX_MCPS_SHOWN);
+    shown.forEach((mem, i) => {
+        const mm = mem.mcp_meta;
+        const memId = getMemoryId(mem);
+        // MCP name (bold)
+        lines.push(`### ${i + 1}. ${mm.name}\n`);
+        // Description
+        if (mm.description) {
+            const desc = trimTextForReadability(mm.description, MAX_WORDS_SHOWN, memId);
+            lines.push(`${desc}\n`);
+        }
+        // Tools
+        if (mm.tools_hint && mm.tools_hint.length > 0) {
+            lines.push(`🔧 **Tools:** ${mm.tools_hint.join(", ")}\n`);
+        }
+        // Usage stats (if available)
+        const stats = [];
+        if (mm.usage_count !== undefined)
+            stats.push(`used by ${mm.usage_count} agents`);
+        if (mm.success_rate !== undefined)
+            stats.push(`success: ${Math.round(mm.success_rate * 100)}%`);
+        if (stats.length > 0) {
+            lines.push(`📊 ${stats.join(" · ")}\n`);
+        }
+        // Activation ID — the key piece
+        lines.push(`🆔 **Activate:** \`memory_id="${memId}"\`\n`);
+    });
+    if (mcps.length > MAX_MCPS_SHOWN) {
+        lines.push(`> ${mcps.length - MAX_MCPS_SHOWN} more MCP(s) found but not shown.\n`);
+    }
+    return lines.join("\n");
+}
+// ── Standard formatting helpers ─────────────────────────────────
+function formatWarning(w) {
+    const lines = [];
+    const title = w.title ? `**${w.title}**` : "";
+    lines.push(`- **[${w.type}]** ${title} (confidence: ${w.confidence?.toFixed(2) ?? "N/A"})`);
+    if (w.contradicts_memory_id) {
+        lines.push(`  contradicts: \`${w.contradicts_memory_id}\``);
+    }
+    const content = w.text ? trimTextForReadability(w.text, MAX_WORDS_SHOWN) : "";
+    lines.push(`  ${content}\n`);
+    return lines.join("\n");
+}
+function formatDisputed(pair) {
+    const lines = [];
+    lines.push(`- **${pair.dispute_type}**`);
+    lines.push(`  - A: [${pair.memory_a.type}] "${pair.memory_a.title}" (\`${getMemoryId(pair.memory_a)}\`)`);
+    lines.push(`  - B: [${pair.memory_b.type}] "${pair.memory_b.title}" (\`${getMemoryId(pair.memory_b)}\`)\n`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=queryFormatter.js.map

package/dist/formatters/queryFormatter.js.map

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

package/dist/formatters/writeFormatter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Write Result Formatter
+ *
+ * Formats POST /v1/memories response as clean Markdown
+ * optimized for LLM parsing.
+ *
+ * Design: concise confirmation with actionable metadata.
+ * The agent needs the memory_id and confirmation — not decoration.
+ */
+import type { WriteResult } from "../client/types.js";
+export declare function formatWriteResult(result: WriteResult, memoryType: string): string;
+/**
+ * Format a duplicate memory error into an actionable message.
+ */
+export declare function formatDuplicateError(duplicateOf: string, similarity: number): string;
+//# sourceMappingURL=writeFormatter.d.ts.map

package/dist/formatters/writeFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFormatter.d.ts","sourceRoot":"","sources":["../../src/formatters/writeFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA8BjF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACnB,MAAM,CAUR"}

package/dist/formatters/writeFormatter.js

@@ -0,0 +1,56 @@
+/**
+ * Write Result Formatter
+ *
+ * Formats POST /v1/memories response as clean Markdown
+ * optimized for LLM parsing.
+ *
+ * Design: concise confirmation with actionable metadata.
+ * The agent needs the memory_id and confirmation — not decoration.
+ */
+export function formatWriteResult(result, memoryType) {
+    const lines = [];
+    lines.push(`# ✅ Memory ${result.action_performed}\n`);
+    lines.push(`- **type**: ${memoryType}`);
+    lines.push(`- **memory_id**: \`${result.memory_id}\``);
+    lines.push(`- **action**: ${result.action_performed}`);
+    // Graph impact — only show non-zero values
+    const impact = [];
+    if (result.entities_created > 0)
+        impact.push(`${result.entities_created} entities created`);
+    if (result.entities_merged > 0)
+        impact.push(`${result.entities_merged} entities merged`);
+    if (result.relations_created > 0)
+        impact.push(`${result.relations_created} relations`);
+    if (result.causal_relations > 0)
+        impact.push(`${result.causal_relations} causal links`);
+    if (result.corroborations_created > 0)
+        impact.push(`${result.corroborations_created} corroborations`);
+    if (result.contradictions_created > 0)
+        impact.push(`${result.contradictions_created} contradictions`);
+    if (impact.length > 0) {
+        lines.push(`- **graph_impact**: ${impact.join(", ")}`);
+    }
+    // Linkage — critical for the feedback loop
+    if (result.query_id_linked) {
+        lines.push(`- **linked_query**: \`${result.query_id_linked}\``);
+    }
+    if (result.supersedes_id_linked) {
+        lines.push(`- **supersedes**: \`${result.supersedes_id_linked}\``);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a duplicate memory error into an actionable message.
+ */
+export function formatDuplicateError(duplicateOf, similarity) {
+    return [
+        "# ⚠️ Near-duplicate detected — memory NOT created\n",
+        `- **existing_memory**: \`${duplicateOf}\``,
+        `- **similarity**: ${(similarity * 100).toFixed(0)}%\n`,
+        "**Next steps:**",
+        `1. Inspect the existing memory: use \`hivemind_inspect\` with id \`${duplicateOf}\``,
+        "2. If your version is better, resubmit with `supersedes_id` to replace it",
+        "3. If identical, no action needed — the hive already knows this",
+    ].join("\n");
+}
+//# sourceMappingURL=writeFormatter.js.map

package/dist/formatters/writeFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFormatter.js","sourceRoot":"","sources":["../../src/formatters/writeFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAE,UAAkB;IACrE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvD,2CAA2C;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,CAAC,gBAAgB,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,gBAAgB,mBAAmB,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,eAAe,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,eAAe,kBAAkB,CAAC,CAAC;IACzF,IAAI,MAAM,CAAC,iBAAiB,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,iBAAiB,YAAY,CAAC,CAAC;IACvF,IAAI,MAAM,CAAC,gBAAgB,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,gBAAgB,eAAe,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,sBAAsB,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,sBAAsB,iBAAiB,CAAC,CAAC;IACtG,IAAI,MAAM,CAAC,sBAAsB,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,sBAAsB,iBAAiB,CAAC,CAAC;IAEtG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,2CAA2C;IAC3C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,yBAAyB,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,oBAAoB,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAChC,WAAmB,EACnB,UAAkB;IAElB,OAAO;QACH,qDAAqD;QACrD,4BAA4B,WAAW,IAAI;QAC3C,qBAAqB,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;QACvD,iBAAiB;QACjB,sEAAsE,WAAW,IAAI;QACrF,2EAA2E;QAC3E,iEAAiE;KACpE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * HiveMind MCP Server — Entry Point
+ *
+ * Creates the MCP server, registers all tools/resources/prompts,
+ * and starts the appropriate transport (stdio or streamable-http).
+ */
+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;;;;;GAKG"}