bhived-mcp 1.1.5

package/dist/client/restClient.js

@@ -0,0 +1,154 @@
+/**
+ * HiveMind REST Client
+ *
+ * Thin fetch-based client for the HiveMind FastAPI core.
+ * Uses native fetch (Node 18+) with AbortController timeouts
+ * and single-retry for transient failures.
+ */
+import { config } from "../config.js";
+export class HiveMindRestClient {
+    baseUrl;
+    timeout;
+    apiKey;
+    constructor(baseUrl, timeout, apiKey) {
+        this.baseUrl = (baseUrl ?? config.apiUrl).replace(/\/+$/, "");
+        this.timeout = timeout ?? config.timeout;
+        this.apiKey = apiKey ?? config.apiKey;
+    }
+    // ── Public API ──────────────────────────────────────────────────
+    async query(params) {
+        return this.post("/v1/query", params);
+    }
+    async writeMemory(params) {
+        return this.post("/v1/memories", params);
+    }
+    async getMemory(memoryId) {
+        return this.get(`/v1/memories/${encodeURIComponent(memoryId)}`);
+    }
+    async getHealth() {
+        return this.get("/health");
+    }
+    async listMemories(params) {
+        const query = new URLSearchParams();
+        if (params?.status_filter)
+            query.set("status_filter", params.status_filter);
+        if (params?.type_filter)
+            query.set("type_filter", params.type_filter);
+        if (params?.agent_id)
+            query.set("agent_id", params.agent_id);
+        if (params?.limit !== undefined)
+            query.set("limit", String(params.limit));
+        const qs = query.toString();
+        return this.get(`/v1/memories${qs ? `?${qs}` : ""}`);
+    }
+    // ── Capability API (Skills & MCPs) ──────────────────────────────
+    async activateCapability(memoryId, agentId) {
+        return this.post(`/v1/capabilities/${this.encodePathSegments(memoryId)}/activate`, { agent_id: agentId });
+    }
+    async reportCapability(memoryId, params) {
+        return this.post(`/v1/capabilities/${this.encodePathSegments(memoryId)}/report`, params);
+    }
+    async getSkill(memoryId) {
+        return this.get(`/v1/admin/skills/${this.encodePathSegments(memoryId)}`);
+    }
+    async getMcp(memoryId) {
+        return this.get(`/v1/admin/mcps/${this.encodePathSegments(memoryId)}`);
+    }
+    // ── Path encoding for capability IDs ───────────────────────────
+    // Capability IDs may contain slashes (e.g. "org/repo/skill-name").
+    // We encode each segment individually while preserving slashes so
+    // FastAPI's {memory_id:path} or multi-segment routing works correctly.
+    encodePathSegments(id) {
+        return id.split("/").map(encodeURIComponent).join("/");
+    }
+    // ── Shared headers ──────────────────────────────────────────────
+    buildHeaders(contentType) {
+        const headers = {};
+        if (contentType) {
+            headers["Content-Type"] = contentType;
+        }
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        return headers;
+    }
+    // ── HTTP helpers with retry ─────────────────────────────────────
+    async post(path, body) {
+        return this.requestWithRetry(async (signal) => {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method: "POST",
+                headers: this.buildHeaders("application/json"),
+                body: JSON.stringify(body),
+                signal,
+            });
+            return this.handleResponse(response);
+        });
+    }
+    async get(path) {
+        return this.requestWithRetry(async (signal) => {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                headers: this.buildHeaders(),
+                signal,
+            });
+            return this.handleResponse(response);
+        });
+    }
+    async handleResponse(response) {
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => "");
+            const message = errorBody || response.statusText;
+            const err = new Error(`REST API error (${response.status}): ${message}`);
+            err.statusCode = response.status;
+            err.body = errorBody;
+            throw err;
+        }
+        return (await response.json());
+    }
+    async requestWithRetry(fn, retries = 1) {
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            try {
+                const result = await fn(controller.signal);
+                return result;
+            }
+            catch (error) {
+                const isLastAttempt = attempt === retries;
+                const isRetryable = this.isRetryableError(error);
+                if (isLastAttempt || !isRetryable) {
+                    throw this.normalizeError(error);
+                }
+                // Exponential backoff: 500ms, 1000ms, ...
+                const delay = 500 * Math.pow(2, attempt);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+        // Unreachable but TypeScript needs it
+        throw new Error("Request failed after retries");
+    }
+    isRetryableError(error) {
+        if (error instanceof DOMException && error.name === "AbortError")
+            return true;
+        if (error instanceof TypeError && error.message.includes("fetch"))
+            return true;
+        const statusCode = error.statusCode;
+        return statusCode !== undefined && statusCode >= 500;
+    }
+    normalizeError(error) {
+        if (error instanceof DOMException && error.name === "AbortError") {
+            return new Error(`Request timed out after ${this.timeout}ms. Is HiveMind API running at ${this.baseUrl}?`);
+        }
+        if (error instanceof TypeError && error.message.includes("fetch")) {
+            return new Error(`Cannot connect to HiveMind API at ${this.baseUrl}. Is the server running?`);
+        }
+        if (error instanceof Error)
+            return error;
+        return new Error(String(error));
+    }
+}
+/** Singleton REST client instance */
+export const restClient = new HiveMindRestClient();
+//# sourceMappingURL=restClient.js.map

package/dist/client/restClient.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,220 @@
+/**
+ * HiveMind REST API — TypeScript interfaces
+ *
+ * These match the response schemas defined in endpoints.md.
+ * The MCP server consumes these types; it never defines business logic.
+ */
+export interface HealthStatus {
+    status: "ok" | "degraded";
+    version: string;
+    graph_connected: boolean;
+    redis_connected: boolean;
+}
+export interface QueryParams {
+    query: string;
+    top_k?: number;
+    include_episodes?: boolean;
+    include_warnings?: boolean;
+    include_disputed?: boolean;
+    context?: string;
+    agent_id?: string;
+}
+export interface QueryMemory {
+    id: string;
+    text: string;
+    title: string;
+    type: "instruction" | "mistake" | "update" | "note";
+    status: "active" | "archived" | "disputed" | "superseded";
+    score: number;
+    corroboration_count?: number;
+    contradiction_count?: number;
+    times_retrieved?: number;
+    has_skill?: boolean;
+    has_mcp?: boolean;
+    skill_meta?: SkillCapabilityMeta;
+    mcp_meta?: McpCapabilityMeta;
+}
+/** Metadata about a skill capability included in query results. */
+export interface SkillCapabilityMeta {
+    name: string;
+    description?: string;
+    script_count?: number;
+    reference_count?: number;
+    asset_count?: number;
+    mcp_count?: number;
+    mcp_names?: string[];
+    usage_count?: number;
+    success_rate?: number;
+}
+/** Metadata about an MCP capability included in query results. */
+export interface McpCapabilityMeta {
+    name: string;
+    description?: string;
+    tools_hint?: string[];
+    usage_count?: number;
+    success_rate?: number;
+}
+export interface QueryEpisode {
+    id: string;
+    memories: QueryMemory[];
+    topic: string;
+}
+export interface QueryWarning {
+    id: string;
+    text: string;
+    title: string;
+    type: string;
+    confidence: number;
+    contradicts_memory_id?: string;
+}
+export interface DisputedPair {
+    memory_a: QueryMemory;
+    memory_b: QueryMemory;
+    dispute_type: string;
+}
+export interface QueryResult {
+    query_id: string;
+    recommendations: QueryMemory[];
+    episodes?: QueryEpisode[];
+    warnings?: QueryWarning[];
+    disputed_pairs?: DisputedPair[];
+    total_results: number;
+}
+export interface WriteParams {
+    text: string;
+    title: string;
+    type: "instruction" | "mistake" | "update";
+    agent_id: string;
+    query_id?: string;
+    supersedes_id?: string;
+    action?: "new" | "update";
+    model?: string;
+}
+export interface WriteResult {
+    memory_id: string;
+    entities_created: number;
+    entities_merged: number;
+    relations_created: number;
+    causal_relations: number;
+    next_edge_created: boolean;
+    provenance_steps: number;
+    fingerprint_computed: boolean;
+    query_id_linked: string | null;
+    supersedes_id_linked: string | null;
+    action_performed: "created" | "updated" | "superseded";
+    corroborations_created: number;
+    contradictions_created: number;
+}
+export interface DuplicateError {
+    error: "duplicate_memory";
+    duplicate_of: string;
+    jaccard_similarity: number;
+}
+export interface MemoryDetail {
+    id: string;
+    text: string;
+    title: string;
+    type: "instruction" | "mistake" | "update" | "note";
+    status: "active" | "archived" | "disputed" | "superseded";
+    agent_id: string;
+    created_at: string;
+    updated_at: string;
+    corroboration_count: number;
+    contradiction_count: number;
+    superseded_count: number;
+    times_retrieved: number;
+    version_count: number;
+    version_history: unknown[];
+    version_hash: string;
+    responding_to_query: string | null;
+    source: string;
+    archived_at: string | null;
+    restore_count: number;
+}
+export interface MemoryListParams {
+    status_filter?: string;
+    type_filter?: string;
+    agent_id?: string;
+    limit?: number;
+}
+export interface MemoryListItem {
+    id: string;
+    text: string;
+    title: string;
+    type: string;
+    status: string;
+    agent_id: string;
+    created_at: string;
+    updated_at: string;
+    corroboration_count: number;
+    contradiction_count: number;
+    superseded_count: number;
+    times_retrieved: number;
+    version_count: number;
+    source: string;
+}
+export interface MemoryListResult {
+    memories: MemoryListItem[];
+    count: number;
+    total: number;
+}
+export interface SkillPayload {
+    name: string;
+    description: string;
+    skill_md: string;
+    scripts: Record<string, string>;
+    references: Record<string, string>;
+    assets: Record<string, string>;
+    mcp_configs: McpConfig[];
+    compatibility?: Record<string, unknown>;
+    license?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface McpConfig {
+    name: string;
+    description: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+}
+export interface McpPayload {
+    name: string;
+    description: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    tools_hint: string[];
+    prompts?: McpPromptHint[];
+    compatibility?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface McpPromptHint {
+    name: string;
+    description: string;
+    arguments?: {
+        name: string;
+        required: boolean;
+    }[];
+}
+export interface ActivationResponse {
+    ok: boolean;
+    capability_type: "skill" | "mcp";
+    name: string;
+    skill_payload: SkillPayload | null;
+    mcp_payload: McpPayload | null;
+}
+export interface CapabilityReportParams {
+    agent_id: string;
+    success: boolean;
+}
+export interface AdminCapabilityReadResponse {
+    id: string;
+    name: string;
+    description: string;
+    capability_type: "skill" | "mcp";
+    skill_payload: SkillPayload | null;
+    mcp_payload: McpPayload | null;
+    created_at: string;
+    updated_at: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

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

package/dist/client/types.js

@@ -0,0 +1,8 @@
+/**
+ * HiveMind REST API — TypeScript interfaces
+ *
+ * These match the response schemas defined in endpoints.md.
+ * The MCP server consumes these types; it never defines business logic.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * HiveMind MCP Server — Configuration
+ *
+ * Environment-based configuration for the REST API connection,
+ * authentication, timeouts, transport selection, and capability limits.
+ */
+export interface HiveMindConfig {
+    /** Base URL of the HiveMind REST API */
+    apiUrl: string;
+    /** Bearer token for REST API authentication (optional for local dev) */
+    apiKey: string | undefined;
+    /** Request timeout in milliseconds */
+    timeout: number;
+    /** Default agent ID (can be overridden per-call) */
+    defaultAgentId: string;
+    /** Transport mode: "stdio" or "http" */
+    transport: "stdio" | "http";
+    /** HTTP port (only used when transport is "http") */
+    httpPort: number;
+    /** Maximum number of active skills at any time */
+    maxActiveSkills: number;
+    /** Maximum number of standalone (non-skill-bundled) child MCPs */
+    maxStandaloneMcps: number;
+    /** Maximum total child MCP processes (standalone + skill-bundled) */
+    maxChildProcesses: number;
+    /** Maximum bundled MCPs per skill */
+    maxBundledMcps: number;
+    /** Script execution timeout in milliseconds */
+    scriptTimeout: number;
+    /** Health check interval for child MCPs in milliseconds */
+    childHealthInterval: number;
+}
+export declare function loadConfig(): HiveMindConfig;
+/** Singleton config instance */
+export declare const config: HiveMindConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC3B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IAIjB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,UAAU,IAAI,cAAc,CAoB3C;AAED,gCAAgC;AAChC,eAAO,MAAM,MAAM,gBAAe,CAAC"}

package/dist/config.js

@@ -0,0 +1,28 @@
+/**
+ * HiveMind MCP Server — Configuration
+ *
+ * Environment-based configuration for the REST API connection,
+ * authentication, timeouts, transport selection, and capability limits.
+ */
+export function loadConfig() {
+    const transportArg = process.argv.find((a) => a.startsWith("--transport="));
+    const portArg = process.argv.find((a) => a.startsWith("--port="));
+    return {
+        apiUrl: process.env.HIVEMIND_API_URL ?? "http://localhost:8000",
+        apiKey: process.env.HIVEMIND_API_KEY,
+        timeout: parseInt(process.env.HIVEMIND_TIMEOUT ?? "30000", 10),
+        defaultAgentId: process.env.HIVEMIND_AGENT_ID ?? "mcp-anonymous",
+        transport: transportArg?.split("=")[1] ?? "stdio",
+        httpPort: parseInt(portArg?.split("=")[1] ?? process.env.PORT ?? "3001", 10),
+        // Capability limits (configurable via env vars)
+        maxActiveSkills: parseInt(process.env.HIVEMIND_MAX_SKILLS ?? "5", 10),
+        maxStandaloneMcps: parseInt(process.env.HIVEMIND_MAX_STANDALONE_MCPS ?? "5", 10),
+        maxChildProcesses: parseInt(process.env.HIVEMIND_MAX_CHILD_PROCESSES ?? "10", 10),
+        maxBundledMcps: parseInt(process.env.HIVEMIND_MAX_BUNDLED_MCPS ?? "3", 10),
+        scriptTimeout: parseInt(process.env.HIVEMIND_SCRIPT_TIMEOUT ?? "30000", 10),
+        childHealthInterval: parseInt(process.env.HIVEMIND_HEALTH_INTERVAL ?? "30000", 10),
+    };
+}
+/** Singleton config instance */
+export const config = loadConfig();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,MAAM,UAAU,UAAU;IACtB,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAElE,OAAO;QACH,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB;QAC/D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QACpC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,EAAE,EAAE,CAAC;QAC9D,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,eAAe;QAChE,SAAS,EAAG,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAsB,IAAI,OAAO;QACvE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;QAE5E,gDAAgD;QAChD,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,GAAG,EAAE,EAAE,CAAC;QACrE,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,GAAG,EAAE,EAAE,CAAC;QAChF,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,IAAI,EAAE,EAAE,CAAC;QACjF,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,GAAG,EAAE,EAAE,CAAC;QAC1E,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,OAAO,EAAE,EAAE,CAAC;QAC3E,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,EAAE,EAAE,CAAC;KACrF,CAAC;AACN,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC"}

package/dist/formatters/inspectFormatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Inspect Formatter
+ *
+ * Formats GET /v1/memories/{id} response as clean Markdown
+ * optimized for LLM parsing.
+ *
+ * Design: structured sections with clear key:value pairs
+ * for reliable extraction. Uses markdown semantics that
+ * every LLM understands natively.
+ */
+import type { MemoryDetail } from "../client/types.js";
+export declare function formatInspectResult(mem: MemoryDetail): string;
+//# sourceMappingURL=inspectFormatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspectFormatter.d.ts","sourceRoot":"","sources":["../../src/formatters/inspectFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CA8C7D"}

package/dist/formatters/inspectFormatter.js

@@ -0,0 +1,68 @@
+/**
+ * Inspect Formatter
+ *
+ * Formats GET /v1/memories/{id} response as clean Markdown
+ * optimized for LLM parsing.
+ *
+ * Design: structured sections with clear key:value pairs
+ * for reliable extraction. Uses markdown semantics that
+ * every LLM understands natively.
+ */
+export function formatInspectResult(mem) {
+    const lines = [];
+    lines.push(`# Memory: ${mem.title}\n`);
+    // Identity
+    lines.push("## Overview\n");
+    lines.push(`- **id**: \`${mem.id}\``);
+    lines.push(`- **type**: ${mem.type}`);
+    lines.push(`- **status**: ${formatStatus(mem.status)}`);
+    lines.push(`- **agent**: \`${mem.agent_id}\``);
+    lines.push(`- **source**: ${mem.source}`);
+    // Full text
+    lines.push(`\n## Content\n`);
+    lines.push(`${mem.text}`);
+    // Evolution metrics — the core data agents need
+    lines.push(`\n## Evolution\n`);
+    lines.push(`| Metric | Value |`);
+    lines.push(`|--------|-------|`);
+    lines.push(`| Corroborations | ${mem.corroboration_count} |`);
+    lines.push(`| Contradictions | ${mem.contradiction_count} |`);
+    lines.push(`| Superseded by | ${mem.superseded_count} |`);
+    lines.push(`| Times retrieved | ${mem.times_retrieved} |`);
+    lines.push(`| Version | ${mem.version_count} |`);
+    lines.push(`| Version hash | \`${mem.version_hash}\` |`);
+    if (mem.restore_count > 0) {
+        lines.push(`| Restore count | ${mem.restore_count} |`);
+    }
+    // Timeline
+    lines.push(`\n## Timeline\n`);
+    lines.push(`- **created**: ${formatDate(mem.created_at)}`);
+    lines.push(`- **updated**: ${formatDate(mem.updated_at)}`);
+    if (mem.archived_at) {
+        lines.push(`- **archived**: ${formatDate(mem.archived_at)}`);
+    }
+    // Linkage
+    if (mem.responding_to_query) {
+        lines.push(`\n## Linkage\n`);
+        lines.push(`- **responding_to_query**: \`${mem.responding_to_query}\``);
+    }
+    return lines.join("\n");
+}
+function formatStatus(status) {
+    const labels = {
+        active: "🟢 active",
+        archived: "archived",
+        disputed: "⚠️ disputed",
+        superseded: "superseded",
+    };
+    return labels[status] ?? status;
+}
+function formatDate(iso) {
+    try {
+        return new Date(iso).toISOString();
+    }
+    catch {
+        return iso;
+    }
+}
+//# sourceMappingURL=inspectFormatter.js.map

package/dist/formatters/inspectFormatter.js.map

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

package/dist/formatters/queryFormatter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+import type { QueryResult } from "../client/types.js";
+export declare function formatQueryResult(result: QueryResult): string;
+//# sourceMappingURL=queryFormatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queryFormatter.d.ts","sourceRoot":"","sources":["../../src/formatters/queryFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA2C,MAAM,oBAAoB,CAAC;AAmB/F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA8E7D"}