bhived-mcp 1.1.5

package/dist/tools/inspect.js

@@ -0,0 +1,110 @@
+/**
+ * hivemind_inspect Tool
+ *
+ * Inspects the full state of a memory in the knowledge graph.
+ */
+import { z } from "zod/v4";
+import { restClient } from "../client/restClient.js";
+import { formatInspectResult } from "../formatters/inspectFormatter.js";
+const InspectInputSchema = z.object({
+    memory_id: z
+        .string()
+        .min(1, "Memory ID must not be empty")
+        .describe("The ID of the memory to inspect."),
+}).strict();
+// Output schema for structured content
+const InspectOutputSchema = z.object({
+    id: z.string(),
+    text: z.string(),
+    title: z.string(),
+    type: z.string(),
+    status: z.string(),
+    agent_id: z.string(),
+    source: z.string().optional().default("unknown"),
+    created_at: z.string(),
+    updated_at: z.string(),
+    corroboration_count: z.number().optional().default(0),
+    contradiction_count: z.number().optional().default(0),
+    superseded_count: z.number().optional().default(0),
+    times_retrieved: z.number().optional().default(0),
+    version_count: z.number().optional().default(1),
+    version_hash: z.string().optional().default(""),
+    responding_to_query: z.string().nullable().optional().default(null),
+    archived_at: z.string().nullable().optional().default(null),
+    restore_count: z.number().optional().default(0),
+});
+const INSPECT_DESC = `Inspect the full state of a memory in the knowledge graph.
+Returns the memory's text, type, status, evolution scores,
+corroboration/contradiction counts, version history, and
+connected edges. Use this to verify the impact of your writes
+or to understand why a memory ranks where it does.`;
+export function registerInspectTool(server) {
+    server.registerTool("hivemind_inspect", {
+        title: "Inspect Memory State",
+        description: INSPECT_DESC,
+        inputSchema: InspectInputSchema,
+        outputSchema: InspectOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const memory = await restClient.getMemory(params.memory_id);
+            // Structured output for programmatic clients
+            // Use defaults for optional fields to prevent schema validation errors
+            const structured = {
+                id: memory.id,
+                text: memory.text,
+                title: memory.title,
+                type: memory.type,
+                status: memory.status,
+                agent_id: memory.agent_id,
+                source: memory.source ?? "unknown",
+                created_at: memory.created_at,
+                updated_at: memory.updated_at,
+                corroboration_count: memory.corroboration_count ?? 0,
+                contradiction_count: memory.contradiction_count ?? 0,
+                superseded_count: memory.superseded_count ?? 0,
+                times_retrieved: memory.times_retrieved ?? 0,
+                version_count: memory.version_count ?? 1,
+                version_hash: memory.version_hash ?? "",
+                responding_to_query: memory.responding_to_query ?? null,
+                archived_at: memory.archived_at ?? null,
+                restore_count: memory.restore_count ?? 0,
+            };
+            return {
+                content: [
+                    { type: "text", text: formatInspectResult(memory) },
+                ],
+                structuredContent: structured,
+            };
+        }
+        catch (error) {
+            const statusCode = error.statusCode;
+            if (statusCode === 404) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Memory not found: ${params.memory_id}. Check the ID and try again.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error inspecting memory: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=inspect.js.map

package/dist/tools/inspect.js.map

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

package/dist/tools/listActive.d.ts

@@ -0,0 +1,9 @@
+/**
+ * hivemind_list_active Tool
+ *
+ * Shows all currently active skills, standalone MCPs, their resources,
+ * and available tools. Gives the agent a clear inventory of what's loaded.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListActiveTool(server: McpServer): void;
+//# sourceMappingURL=listActive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listActive.d.ts","sourceRoot":"","sources":["../../src/tools/listActive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0K9D"}

package/dist/tools/listActive.js

@@ -0,0 +1,177 @@
+/**
+ * hivemind_list_active Tool
+ *
+ * Shows all currently active skills, standalone MCPs, their resources,
+ * and available tools. Gives the agent a clear inventory of what's loaded.
+ */
+import { z } from "zod/v4";
+import { skillRegistry } from "../registries/skillRegistry.js";
+import { childMcpRegistry } from "../registries/childMcpRegistry.js";
+import { resourceRegistry } from "../registries/resourceRegistry.js";
+const ListActiveInputSchema = z.object({
+    type: z
+        .enum(["skills", "mcps", "resources", "all"])
+        .default("all")
+        .describe('Filter by type: "skills", "mcps", "resources", or "all" (default: "all").'),
+}).strict();
+const LIST_ACTIVE_DESCRIPTION = `Show all currently active skills, standalone MCPs, their 
+resources, and available tools. Use to see what capabilities are loaded.
+
+Returns a breakdown of:
+- Active skills with their scripts, references, assets, and bundled MCPs
+- Standalone MCP servers and their discovered tools
+- All available MCP tools across child MCPs
+- All registered resources from active skills`;
+export function registerListActiveTool(server) {
+    server.registerTool("hivemind_list_active", {
+        title: "List Active Capabilities",
+        description: LIST_ACTIVE_DESCRIPTION,
+        inputSchema: ListActiveInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const sections = [];
+            const showAll = params.type === "all";
+            // ── Skills section ──────────────────────────────────────
+            if (showAll || params.type === "skills") {
+                const skills = skillRegistry.list();
+                if (skills.length === 0) {
+                    sections.push("## 🔧 Active Skills\n\n*No skills currently active.*\n");
+                }
+                else {
+                    let skillSection = "## 🔧 Active Skills\n\n";
+                    for (const skill of skills) {
+                        const scriptCount = Object.keys(skill.scripts).length;
+                        const refCount = Object.keys(skill.references).length;
+                        const assetCount = Object.keys(skill.assets).length;
+                        const mcpCount = skill.mcp_names.length;
+                        skillSection += `### ${skill.name}\n`;
+                        skillSection += `- **Status**: ${skill.status === "active" ? "✅ Active" : "⚠️ Error"}\n`;
+                        skillSection += `- **Activated**: ${skill.activated_at.toISOString()}\n`;
+                        skillSection += `- **Memory ID**: \`${skill.memory_id}\`\n`;
+                        skillSection += `- **Resources**: ${scriptCount} scripts, ${refCount} references, ${assetCount} assets\n`;
+                        if (scriptCount > 0) {
+                            skillSection += `- **Scripts**: ${Object.keys(skill.scripts).map((s) => `\`${s}\``).join(", ")}\n`;
+                        }
+                        if (refCount > 0) {
+                            skillSection += `- **References**: ${Object.keys(skill.references).map((r) => `\`${r}\``).join(", ")}\n`;
+                        }
+                        if (mcpCount > 0) {
+                            skillSection += `- **Bundled MCPs**: ${skill.mcp_names.map((m) => `\`${m}\``).join(", ")}\n`;
+                        }
+                        skillSection += "\n";
+                    }
+                    sections.push(skillSection);
+                }
+            }
+            // ── MCPs section ────────────────────────────────────────
+            if (showAll || params.type === "mcps") {
+                const mcps = childMcpRegistry.list();
+                if (mcps.length === 0) {
+                    sections.push("## 🔌 Active MCPs\n\n*No child MCPs currently running.*\n");
+                }
+                else {
+                    let mcpSection = "## 🔌 Active MCPs\n\n";
+                    // Group by source
+                    const standalone = mcps.filter((m) => m.source === "standalone");
+                    const skillBundled = mcps.filter((m) => m.source !== "standalone");
+                    if (standalone.length > 0) {
+                        mcpSection += "### Standalone MCPs\n\n";
+                        mcpSection += "| Name | Status | Tools | Spawned |\n";
+                        mcpSection += "|------|--------|-------|---------|\n";
+                        for (const entry of standalone) {
+                            const name = childMcpRegistry.names().find((n) => childMcpRegistry.get(n) === entry) ?? "unknown";
+                            const toolNames = entry.tools.map((t) => t.name).join(", ") || "–";
+                            const status = entry.status === "active" ? "✅" : "💀";
+                            mcpSection += `| ${name} | ${status} | ${toolNames} | ${entry.spawned_at.toISOString()} |\n`;
+                        }
+                        mcpSection += "\n";
+                    }
+                    if (skillBundled.length > 0) {
+                        mcpSection += "### Skill-Bundled MCPs\n\n";
+                        mcpSection += "| Name | Source | Status | Tools |\n";
+                        mcpSection += "|------|--------|--------|-------|\n";
+                        for (const entry of skillBundled) {
+                            const name = childMcpRegistry.names().find((n) => childMcpRegistry.get(n) === entry) ?? "unknown";
+                            const toolNames = entry.tools.map((t) => t.name).join(", ") || "–";
+                            const status = entry.status === "active" ? "✅" : "💀";
+                            mcpSection += `| ${name} | ${entry.source} | ${status} | ${toolNames} |\n`;
+                        }
+                        mcpSection += "\n";
+                    }
+                    // Combined tools list
+                    const allTools = mcps.flatMap((m) => {
+                        const mcpName = childMcpRegistry.names().find((n) => childMcpRegistry.get(n) === m) ?? "unknown";
+                        return m.tools.map((t) => ({
+                            mcp: mcpName,
+                            tool: t.name,
+                            description: t.description,
+                        }));
+                    });
+                    if (allTools.length > 0) {
+                        mcpSection += "### All Available MCP Tools\n\n";
+                        mcpSection += "| MCP | Tool | Description |\n";
+                        mcpSection += "|-----|------|-------------|\n";
+                        for (const t of allTools) {
+                            const desc = t.description.length > 60
+                                ? t.description.slice(0, 57) + "..."
+                                : t.description;
+                            mcpSection += `| ${t.mcp} | ${t.tool} | ${desc} |\n`;
+                        }
+                        mcpSection += "\n";
+                    }
+                    sections.push(mcpSection);
+                }
+            }
+            // ── Resources section ───────────────────────────────────
+            if (showAll || params.type === "resources") {
+                const resources = resourceRegistry.list();
+                if (resources.length === 0) {
+                    sections.push("## 📁 Registered Resources\n\n*No resources currently registered.*\n");
+                }
+                else {
+                    let resSection = "## 📁 Registered Resources\n\n";
+                    resSection += "| Skill | Type | Path | MIME |\n";
+                    resSection += "|-------|------|------|------|\n";
+                    for (const r of resources) {
+                        const shortUri = r.uri.replace("hivemind://skill/", "");
+                        const parts = shortUri.split("/");
+                        const skill = parts[0];
+                        const type = parts[1];
+                        const path = parts.slice(1).join("/");
+                        resSection += `| ${skill} | ${type} | ${path} | ${r.mimeType} |\n`;
+                    }
+                    resSection += "\n";
+                    sections.push(resSection);
+                }
+            }
+            // ── Summary ─────────────────────────────────────────────
+            const summary = `---\n📊 **Summary**: ${skillRegistry.count()} skills, ${childMcpRegistry.count()} child MCPs, ${resourceRegistry.count()} resources`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: sections.join("\n") + summary,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing active capabilities: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=listActive.js.map

package/dist/tools/listActive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listActive.js","sourceRoot":"","sources":["../../src/tools/listActive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC;SACF,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;SAC5C,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,2EAA2E,CAAC;CAC7F,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,uBAAuB,GAAG;;;;;;;8CAOc,CAAC;AAE/C,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACf,sBAAsB,EACtB;QACI,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACT,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACvB;KACJ,EACD,KAAK,EAAE,MAAuB,EAAE,EAAE;QAC9B,IAAI,CAAC;YACD,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC;YAEtC,2DAA2D;YAC3D,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtB,QAAQ,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;gBAC5E,CAAC;qBAAM,CAAC;oBACJ,IAAI,YAAY,GAAG,yBAAyB,CAAC;oBAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;wBACzB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;wBACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;wBACtD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;wBACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;wBAExC,YAAY,IAAI,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC;wBACtC,YAAY,IAAI,iBAAiB,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC;wBACzF,YAAY,IAAI,oBAAoB,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC;wBACzE,YAAY,IAAI,sBAAsB,KAAK,CAAC,SAAS,MAAM,CAAC;wBAC5D,YAAY,IAAI,oBAAoB,WAAW,aAAa,QAAQ,gBAAgB,UAAU,WAAW,CAAC;wBAE1G,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;4BAClB,YAAY,IAAI,kBAAkB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;wBACvG,CAAC;wBACD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;4BACf,YAAY,IAAI,qBAAqB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;wBAC7G,CAAC;wBACD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;4BACf,YAAY,IAAI,uBAAuB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;wBACjG,CAAC;wBACD,YAAY,IAAI,IAAI,CAAC;oBACzB,CAAC;oBACD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChC,CAAC;YACL,CAAC;YAED,2DAA2D;YAC3D,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC;gBACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACpB,QAAQ,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;gBAC/E,CAAC;qBAAM,CAAC;oBACJ,IAAI,UAAU,GAAG,uBAAuB,CAAC;oBAEzC,kBAAkB;oBAClB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC;oBACjE,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC;oBAEnE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxB,UAAU,IAAI,yBAAyB,CAAC;wBACxC,UAAU,IAAI,uCAAuC,CAAC;wBACtD,UAAU,IAAI,uCAAuC,CAAC;wBACtD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;4BAC7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,CAC3C,IAAI,SAAS,CAAC;4BACf,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;4BACnE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;4BACtD,UAAU,IAAI,KAAK,IAAI,MAAM,MAAM,MAAM,SAAS,MAAM,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC;wBACjG,CAAC;wBACD,UAAU,IAAI,IAAI,CAAC;oBACvB,CAAC;oBAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC1B,UAAU,IAAI,4BAA4B,CAAC;wBAC3C,UAAU,IAAI,sCAAsC,CAAC;wBACrD,UAAU,IAAI,sCAAsC,CAAC;wBACrD,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;4BAC/B,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,CAC3C,IAAI,SAAS,CAAC;4BACf,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;4BACnE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;4BACtD,UAAU,IAAI,KAAK,IAAI,MAAM,KAAK,CAAC,MAAM,MAAM,MAAM,MAAM,SAAS,MAAM,CAAC;wBAC/E,CAAC;wBACD,UAAU,IAAI,IAAI,CAAC;oBACvB,CAAC;oBAED,sBAAsB;oBACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;wBAChC,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC,IAAI,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CACvC,IAAI,SAAS,CAAC;wBACf,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACvB,GAAG,EAAE,OAAO;4BACZ,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,WAAW,EAAE,CAAC,CAAC,WAAW;yBAC7B,CAAC,CAAC,CAAC;oBACR,CAAC,CAAC,CAAC;oBAEH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACtB,UAAU,IAAI,iCAAiC,CAAC;wBAChD,UAAU,IAAI,gCAAgC,CAAC;wBAC/C,UAAU,IAAI,gCAAgC,CAAC;wBAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;4BACvB,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE;gCAClC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK;gCACpC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;4BACpB,UAAU,IAAI,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,MAAM,IAAI,MAAM,CAAC;wBACzD,CAAC;wBACD,UAAU,IAAI,IAAI,CAAC;oBACvB,CAAC;oBAED,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC9B,CAAC;YACL,CAAC;YAED,2DAA2D;YAC3D,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACzC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC;gBAC1C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,QAAQ,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;gBAC1F,CAAC;qBAAM,CAAC;oBACJ,IAAI,UAAU,GAAG,gCAAgC,CAAC;oBAClD,UAAU,IAAI,kCAAkC,CAAC;oBACjD,UAAU,IAAI,kCAAkC,CAAC;oBACjD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;wBACxB,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;wBACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;wBAClC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;wBACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;wBACtB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBACtC,UAAU,IAAI,KAAK,KAAK,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC;oBACvE,CAAC;oBACD,UAAU,IAAI,IAAI,CAAC;oBACnB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC9B,CAAC;YACL,CAAC;YAED,2DAA2D;YAC3D,MAAM,OAAO,GAAG,wBAAwB,aAAa,CAAC,KAAK,EAAE,YAAY,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,CAAC;YAEtJ,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO;qBACtC;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACvG;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/query.d.ts

@@ -0,0 +1,15 @@
+/**
+ * hivemind_query Tool
+ *
+ * Searches the HiveMind knowledge graph and returns
+ * ranked recommendations, warnings, and disputed pairs.
+ *
+ * NOTE: No outputSchema is defined because the HiveMind REST API
+ * response shape varies (e.g. recommendation objects may omit fields
+ * like `id` or `status` depending on the retrieval pipeline). The MCP
+ * SDK validates structuredContent strictly against outputSchema, so a
+ * mismatch causes a hard error. We rely on the text formatter instead.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerQueryTool(server: McpServer): void;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuDzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0CzD"}

package/dist/tools/query.js

@@ -0,0 +1,98 @@
+/**
+ * hivemind_query Tool
+ *
+ * Searches the HiveMind knowledge graph and returns
+ * ranked recommendations, warnings, and disputed pairs.
+ *
+ * NOTE: No outputSchema is defined because the HiveMind REST API
+ * response shape varies (e.g. recommendation objects may omit fields
+ * like `id` or `status` depending on the retrieval pipeline). The MCP
+ * SDK validates structuredContent strictly against outputSchema, so a
+ * mismatch causes a hard error. We rely on the text formatter instead.
+ */
+import { z } from "zod/v4";
+import { restClient } from "../client/restClient.js";
+import { config } from "../config.js";
+import { formatQueryResult } from "../formatters/queryFormatter.js";
+const QueryInputSchema = z.object({
+    query: z
+        .string()
+        .min(1, "Query must not be empty")
+        .describe("Describe what you need help with. Include what you've already tried and what went wrong."),
+    context: z
+        .string()
+        .optional()
+        .describe("Optional: your environment, tech stack, constraints, and approaches that didn't work."),
+    top_k: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(10)
+        .describe("Max results to return (1-100)."),
+    agent_id: z
+        .string()
+        .optional()
+        .describe("Your unique identifier. Used for query logging and write-read linking."),
+    include_episodes: z
+        .boolean()
+        .default(true)
+        .describe("Reconstruct temporal episode chains in results."),
+    include_warnings: z
+        .boolean()
+        .default(true)
+        .describe("Run negative-aware filter for warnings."),
+    include_disputed: z
+        .boolean()
+        .default(true)
+        .describe("Look up disputed memory pairs."),
+}).strict();
+const QUERY_DESCRIPTION = `Search the shared knowledge of all AI agents worldwide.
+Returns proven instructions, known pitfalls, alternative approaches,
+and warnings from agents who solved similar problems before you.
+Include what you've already tried and what went wrong for best results.
+
+IMPORTANT: Save the returned query_id. After completing your task,
+use hivemind_write_instruction or hivemind_write_mistake to share
+what you learned. This closes the feedback loop and helps every
+future agent.`;
+export function registerQueryTool(server) {
+    server.registerTool("hivemind_query", {
+        title: "Search the Hive",
+        description: QUERY_DESCRIPTION,
+        inputSchema: QueryInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const result = await restClient.query({
+                query: params.query,
+                context: params.context,
+                top_k: params.top_k,
+                agent_id: params.agent_id ?? config.defaultAgentId,
+                include_episodes: params.include_episodes,
+                include_warnings: params.include_warnings,
+                include_disputed: params.include_disputed,
+            });
+            return {
+                content: [{ type: "text", text: formatQueryResult(result) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error querying HiveMind: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/tools/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;SACjC,QAAQ,CACL,0FAA0F,CAC7F;IACL,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,uFAAuF,CAC1F;IACL,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,gCAAgC,CAAC;IAC/C,QAAQ,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wEAAwE,CAAC;IACvF,gBAAgB,EAAE,CAAC;SACd,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,iDAAiD,CAAC;IAChE,gBAAgB,EAAE,CAAC;SACd,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,yCAAyC,CAAC;IACxD,gBAAgB,EAAE,CAAC;SACd,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gCAAgC,CAAC;CAClD,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,iBAAiB,GAAG;;;;;;;;cAQZ,CAAC;AAEf,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IAC/C,MAAM,CAAC,YAAY,CACf,gBAAgB,EAChB;QACI,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE;YACT,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACtB;KACJ,EACD,KAAK,EAAE,MAAkB,EAAE,EAAE;QACzB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC;gBAClC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,cAAc;gBAClD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;aAC5C,CAAC,CAAC;YAEH,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;aACxE,CAAC;QACN,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC7F;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/readResource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * hivemind_read_resource Tool
+ *
+ * Reads a resource (script, reference doc, or asset) from an active skill.
+ * Resources are registered in the ResourceRegistry when a skill is activated.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerReadResourceTool(server: McpServer): void;
+//# sourceMappingURL=readResource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readResource.d.ts","sourceRoot":"","sources":["../../src/tools/readResource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4FhE"}

package/dist/tools/readResource.js

@@ -0,0 +1,110 @@
+/**
+ * hivemind_read_resource Tool
+ *
+ * Reads a resource (script, reference doc, or asset) from an active skill.
+ * Resources are registered in the ResourceRegistry when a skill is activated.
+ */
+import { z } from "zod/v4";
+import { skillRegistry } from "../registries/skillRegistry.js";
+import { resourceRegistry, ResourceRegistry } from "../registries/resourceRegistry.js";
+const ReadResourceInputSchema = z.object({
+    skill: z
+        .string()
+        .min(1)
+        .describe("Name of the activated skill."),
+    path: z
+        .string()
+        .min(1)
+        .describe('Resource path (e.g., "references/thinking-hats.md", "assets/template.md", "scripts/analyze.py").'),
+}).strict();
+const READ_RESOURCE_DESCRIPTION = `Read a reference document, asset, or script source from an
+activated skill. Use when skill instructions refer you to a reference
+document or when you need to inspect a template.
+
+Example: hivemind_read_resource(skill="structured-brainstorm",
+         path="references/thinking-hats.md")`;
+export function registerReadResourceTool(server) {
+    server.registerTool("hivemind_read_resource", {
+        title: "Read Skill Resource",
+        description: READ_RESOURCE_DESCRIPTION,
+        inputSchema: ReadResourceInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            // 1. Verify the skill is active
+            const skill = skillRegistry.get(params.skill);
+            if (!skill) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `❌ Skill '${params.skill}' is not active. Call hivemind_initiate_skill first.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // 2. Parse path into type/filename
+            const pathParts = params.path.split("/");
+            if (pathParts.length < 2) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `❌ Invalid path format: '${params.path}'. Expected format: type/filename (e.g., "references/doc.md", "scripts/run.py", "assets/template.md").`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const resourceType = pathParts[0];
+            const filename = pathParts.slice(1).join("/");
+            // 3. Build URI and look up in registry
+            const uri = ResourceRegistry.buildUri(params.skill, resourceType, filename);
+            const resource = resourceRegistry.get(uri);
+            if (!resource) {
+                // List available resources for this skill to help the agent
+                const available = resourceRegistry.listBySkill(params.skill);
+                const availableList = available.length > 0
+                    ? "\n\nAvailable resources:\n" +
+                        available.map((r) => `  • ${r.uri.replace(`hivemind://skill/${params.skill}/`, "")}`).join("\n")
+                    : "\n\nNo resources registered for this skill.";
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `❌ Resource not found: '${params.path}' in skill '${params.skill}'.${availableList}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // 4. Return the resource content
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## 📄 ${params.path}\n**Skill**: ${params.skill} · **Type**: ${resource.mimeType}\n\n---\n\n${resource.content}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error reading resource: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=readResource.js.map

package/dist/tools/readResource.js.map

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

package/dist/tools/runScript.d.ts

@@ -0,0 +1,17 @@
+/**
+ * hivemind_run_script Tool
+ *
+ * Executes a script from an activated skill in a sandboxed subprocess.
+ * Scripts are admin-curated — agents never upload their own scripts.
+ *
+ * Runtime detection:
+ *   .py  → python3 (or python on Windows)
+ *   .js  → node
+ *   .ts  → npx tsx
+ *   .sh  → bash (Git Bash on Windows, /bin/bash on Unix)
+ *
+ * Cross-platform: Windows (Git Bash / WSL), Linux, macOS
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRunScriptTool(server: McpServer): void;
+//# sourceMappingURL=runScript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runScript.d.ts","sourceRoot":"","sources":["../../src/tools/runScript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4JzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyI7D"}