@hormonaly/mcp-server 1.0.1

package/dist/tools.js

@@ -0,0 +1,766 @@
+/**
+ * All MCP tool definitions and handlers for the Hormonaly platform.
+ */
+import { HoromnalyClient, loadConfig } from "./client.js";
+// ─── Tool result helpers ──────────────────────────────────────────────────────
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function err(message) {
+    return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+}
+// ─── Tool schema definitions ──────────────────────────────────────────────────
+export const TOOL_DEFINITIONS = [
+    // ── Helix Tools ──────────────────────────────────────────────────────────
+    {
+        name: "helix_query",
+        description: "Query the Helix AI engine with a clinical question about peptides, hormones, longevity, or aesthetics. Returns an evidence-based answer with GRADE rating, confidence score, citations, and related protocols. Requires a Helix API key.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                question: {
+                    type: "string",
+                    description: "The clinical question to answer (e.g. 'What is the optimal BPC-157 dose for gut repair?')",
+                    maxLength: 10000,
+                },
+                language: {
+                    type: "string",
+                    enum: ["en", "ar"],
+                    default: "en",
+                    description: "Response language",
+                },
+                detail_level: {
+                    type: "string",
+                    enum: ["clinical", "summary"],
+                    default: "clinical",
+                    description: "Level of detail: 'clinical' for full analysis, 'summary' for a concise overview",
+                },
+                include_citations: {
+                    type: "boolean",
+                    default: true,
+                    description: "Include PubMed citation list in the response",
+                },
+                include_three_lens: {
+                    type: "boolean",
+                    default: false,
+                    description: "Include Three-Lens analysis (longevity / health-disease / performance scoring)",
+                },
+                api_key: {
+                    type: "string",
+                    description: "Helix API key (overrides HORMONALY_API_KEY env var)",
+                },
+            },
+            required: ["question"],
+        },
+    },
+    {
+        name: "helix_compare",
+        description: "Compare 2–3 compounds head-to-head using the Helix AI engine. Returns a structured comparison with key differences, best-for use cases, and a recommendation. Requires Professional or Enterprise tier Helix API key — Starter keys are blocked with 403 tier_insufficient.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compounds: {
+                    type: "array",
+                    items: { type: "string" },
+                    minItems: 2,
+                    maxItems: 3,
+                    description: "List of 2 or 3 compound names to compare (e.g. ['semaglutide', 'tirzepatide'])",
+                },
+                indication: {
+                    type: "string",
+                    default: "General comparison",
+                    description: "Clinical indication or context for the comparison",
+                },
+                language: {
+                    type: "string",
+                    enum: ["en", "ar"],
+                    default: "en",
+                },
+                api_key: {
+                    type: "string",
+                    description: "Helix API key (overrides HORMONALY_API_KEY env var)",
+                },
+            },
+            required: ["compounds"],
+        },
+    },
+    {
+        name: "helix_protocol",
+        description: "Retrieve all protocols for a specific compound from the Helix API. Returns titles, evidence grades, FDA status, and summaries. Requires a Helix API key.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compound: {
+                    type: "string",
+                    description: "Compound name (e.g. 'semaglutide', 'BPC-157', 'testosterone')",
+                    maxLength: 200,
+                },
+                language: {
+                    type: "string",
+                    enum: ["en", "ar"],
+                    default: "en",
+                },
+                api_key: {
+                    type: "string",
+                    description: "Helix API key (overrides HORMONALY_API_KEY env var)",
+                },
+            },
+            required: ["compound"],
+        },
+    },
+    {
+        name: "helix_dossier_start",
+        description: "Start generating a full evidence dossier for a compound (async job). Returns a job_id to poll with helix_dossier_status. Requires Professional or Enterprise tier — Starter keys are blocked with 403 tier_insufficient.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compound: {
+                    type: "string",
+                    description: "Compound name",
+                    maxLength: 500,
+                },
+                language: {
+                    type: "string",
+                    enum: ["en", "ar"],
+                    default: "en",
+                },
+                api_key: {
+                    type: "string",
+                    description: "Helix API key (overrides HORMONALY_API_KEY env var)",
+                },
+            },
+            required: ["compound"],
+        },
+    },
+    {
+        name: "helix_dossier_status",
+        description: "Check the status of a dossier generation job started with helix_dossier_start. Returns status (processing/completed/failed) and the dossier data when complete.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                job_id: {
+                    type: "string",
+                    description: "Job ID returned by helix_dossier_start",
+                },
+                api_key: {
+                    type: "string",
+                    description: "Helix API key (overrides HORMONALY_API_KEY env var)",
+                },
+            },
+            required: ["job_id"],
+        },
+    },
+    // ── Agentic Workflow Tools ────────────────────────────────────────────────
+    {
+        name: "run_clinical_workflow",
+        description: "Run a full multi-agent clinical reasoning workflow on a complex question. This triggers the supervisor/worker pattern: the supervisor decomposes the question, spawns specialized sub-agents (evidence, safety, dosing, regulatory), then synthesizes all findings. Best for complex queries involving multiple compounds, stacking protocols, or high-stakes clinical decisions. Returns the synthesized answer plus sub-agent contributions and orchestration steps.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                question: {
+                    type: "string",
+                    description: "The complex clinical question (e.g. 'What is the optimal BPC-157 + TB-500 stack for accelerated tendon repair in athletes, accounting for safety and interactions?')",
+                    maxLength: 10000,
+                },
+                patient_context: {
+                    type: "string",
+                    description: "Optional patient context (age, sex, conditions, medications) to personalize the workflow",
+                },
+                language: {
+                    type: "string",
+                    enum: ["en", "ar"],
+                    default: "en",
+                },
+                api_key: {
+                    type: "string",
+                    description: "Helix API key (overrides HORMONALY_API_KEY env var)",
+                },
+            },
+            required: ["question"],
+        },
+    },
+    {
+        name: "helix_deep_analysis",
+        description: "Run an extended deep analysis on a clinical topic using the highest-capability model with full RAG pipeline, three-lens scoring, and citation verification. Returns a comprehensive clinical synthesis with evidence grade, confidence score, PMID citations, and three-lens analysis (longevity / health-disease / performance). Use this for research synthesis, systematic review preparation, or comprehensive protocol evaluation. Requires Enterprise Helix API key.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                topic: {
+                    type: "string",
+                    description: "Clinical topic or question for deep analysis (e.g. 'Comprehensive analysis of semaglutide for longevity and metabolic optimization')",
+                    maxLength: 10000,
+                },
+                language: {
+                    type: "string",
+                    enum: ["en", "ar"],
+                    default: "en",
+                },
+                api_key: {
+                    type: "string",
+                    description: "Helix API key (overrides HORMONALY_API_KEY env var)",
+                },
+            },
+            required: ["topic"],
+        },
+    },
+    {
+        name: "monitor_protocol_updates",
+        description: "Check if any of the user's saved protocols have new evidence updates or recommendations available. Returns a list of protocols with their last-updated date, current evidence grade, and whether a review is recommended. Requires user session token.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_token: {
+                    type: "string",
+                    description: "User session token (from /api/auth/session or Settings → API Keys)",
+                },
+                compound_filter: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional: filter to specific compounds (e.g. ['BPC-157', 'semaglutide'])",
+                },
+            },
+            required: [],
+        },
+    },
+    // ── Protocol Tools ────────────────────────────────────────────────────────
+    {
+        name: "protocol_search",
+        description: "Search the Hormonaly protocol library by compound name, category, or condition. Returns a list of matching protocols with titles, evidence grades, and categories. No authentication required.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query (compound name, condition, or category)",
+                },
+                category: {
+                    type: "string",
+                    description: "Filter by category slug (e.g. 'weight-loss', 'longevity', 'hormones')",
+                },
+                limit: {
+                    type: "number",
+                    default: 10,
+                    description: "Maximum number of results (max 20)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "protocol_get",
+        description: "Get the full details of a protocol by its ID or slug. Returns dosing tables, mechanism steps, safety considerations, citations, and all enriched data.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "Protocol ID or slug (e.g. 'semaglutide-glp1', 'bpc-157-gut')",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "protocol_list_categories",
+        description: "List all protocol categories available in the Hormonaly library with their slugs and protocol counts.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "protocol_get_interactions",
+        description: "Check for known drug/compound interactions between a set of compounds. Returns severity, mechanism, clinical effect, and recommendations.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compounds: {
+                    type: "array",
+                    items: { type: "string" },
+                    minItems: 2,
+                    description: "List of compound slugs to check interactions for (e.g. ['semaglutide', 'metformin'])",
+                },
+            },
+            required: ["compounds"],
+        },
+    },
+    // ── Evidence Tools ────────────────────────────────────────────────────────
+    {
+        name: "evidence_search",
+        description: "Search PubMed for research papers on a compound or condition. Returns paper titles, PMIDs, abstracts, and publication dates.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compound: {
+                    type: "string",
+                    description: "Compound or peptide name to search for",
+                },
+                max_results: {
+                    type: "number",
+                    default: 10,
+                    description: "Maximum number of papers to return",
+                },
+            },
+            required: ["compound"],
+        },
+    },
+    {
+        name: "evidence_get",
+        description: "Get full evidence details for a specific evidence record by ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "Evidence record ID",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "evidence_grade",
+        description: "Fetch GRADE-methodology evidence ratings for a set of evidence record IDs. Returns each record's study type, evidence grade (A/B/C/D), confidence level, PMID, and clinical relevance summary. Use this to programmatically evaluate the strength of evidence behind a set of references.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ids: {
+                    type: "array",
+                    items: { type: "string" },
+                    minItems: 1,
+                    maxItems: 20,
+                    description: "Evidence record IDs to grade (returned by evidence_search or evidence_get)",
+                },
+            },
+            required: ["ids"],
+        },
+    },
+    // ── Compound Tools ────────────────────────────────────────────────────────
+    {
+        name: "compound_search",
+        description: "Search the Hormonaly compound database by name or category. Returns compound names, categories, and slugs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Compound name or partial name to search for",
+                },
+                category: {
+                    type: "string",
+                    description: "Filter by compound category",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "compound_get_interactions",
+        description: "Get all known interactions for a specific compound.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: {
+                    type: "string",
+                    description: "Compound slug (e.g. 'semaglutide', 'bpc-157')",
+                },
+            },
+            required: ["slug"],
+        },
+    },
+    {
+        name: "compound_get_dosing",
+        description: "Get evidence-based dosing ranges, administration routes, frequency, and cycle guidance for a compound. Returns the full dosing table from the protocol library including dose ranges, units, frequency, and clinical notes. No authentication required.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: {
+                    type: "string",
+                    description: "Compound slug or protocol ID (e.g. 'semaglutide', 'bpc-157', 'testosterone-cypionate')",
+                },
+            },
+            required: ["slug"],
+        },
+    },
+    // ── User Tools ────────────────────────────────────────────────────────────
+    {
+        name: "user_get_profile",
+        description: "Get the current authenticated user's profile including name, role, subscription status, and onboarding state. Requires session authentication.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_token: {
+                    type: "string",
+                    description: "Session token (overrides HORMONALY_SESSION_TOKEN env var)",
+                },
+            },
+        },
+    },
+    {
+        name: "user_get_usage",
+        description: "Get AI usage statistics for the current user (tokens consumed, cost breakdown, request counts). Requires session authentication.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_token: {
+                    type: "string",
+                    description: "Session token (overrides HORMONALY_SESSION_TOKEN env var)",
+                },
+            },
+        },
+    },
+    {
+        name: "user_get_saved_protocols",
+        description: "Get the list of protocols saved by the current user. Requires session authentication.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_token: {
+                    type: "string",
+                    description: "Session token (overrides HORMONALY_SESSION_TOKEN env var)",
+                },
+            },
+        },
+    },
+    // ── Admin Tools ───────────────────────────────────────────────────────────
+    {
+        name: "admin_get_stats",
+        description: "Get platform-wide statistics: user counts, protocol counts, AI usage totals, revenue metrics. Requires admin session.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                admin_session_token: {
+                    type: "string",
+                    description: "Admin session token (overrides HORMONALY_ADMIN_SESSION_TOKEN env var)",
+                },
+            },
+        },
+    },
+    {
+        name: "admin_list_users",
+        description: "List platform users with optional filters. Returns user emails, signup dates, subscription status, and usage stats. Requires admin session.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    default: 20,
+                    description: "Number of users to return",
+                },
+                offset: {
+                    type: "number",
+                    default: 0,
+                    description: "Pagination offset",
+                },
+                search: {
+                    type: "string",
+                    description: "Search by email or name",
+                },
+                admin_session_token: {
+                    type: "string",
+                    description: "Admin session token (overrides HORMONALY_ADMIN_SESSION_TOKEN env var)",
+                },
+            },
+        },
+    },
+    {
+        name: "admin_get_ai_costs",
+        description: "Get AI cost breakdown by model, endpoint, and time period. Requires admin session.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                days: {
+                    type: "number",
+                    default: 30,
+                    description: "Number of days to include in the report",
+                },
+                admin_session_token: {
+                    type: "string",
+                    description: "Admin session token (overrides HORMONALY_ADMIN_SESSION_TOKEN env var)",
+                },
+            },
+        },
+    },
+];
+// ─── Tool handlers ────────────────────────────────────────────────────────────
+export async function handleTool(name, args, client) {
+    try {
+        switch (name) {
+            // ── Helix ──────────────────────────────────────────────────────────────
+            case "helix_query": {
+                const effectiveClient = withApiKey(client, args["api_key"]);
+                const result = await effectiveClient.post("/api/v1/helix/query", {
+                    question: args["question"],
+                    language: args["language"] ?? "en",
+                    detail_level: args["detail_level"] ?? "clinical",
+                    include_citations: args["include_citations"] ?? true,
+                    include_three_lens: args["include_three_lens"] ?? false,
+                }, "helix");
+                return ok(result);
+            }
+            case "helix_compare": {
+                const effectiveClient = withApiKey(client, args["api_key"]);
+                const result = await effectiveClient.post("/api/v1/helix/compare", {
+                    compounds: args["compounds"],
+                    indication: args["indication"] ?? "General comparison",
+                    language: args["language"] ?? "en",
+                }, "helix");
+                return ok(result);
+            }
+            case "helix_protocol": {
+                const effectiveClient = withApiKey(client, args["api_key"]);
+                const compound = encodeURIComponent(String(args["compound"]));
+                const lang = args["language"] ?? "en";
+                const result = await effectiveClient.get(`/api/v1/helix/protocols/${compound}?language=${lang}`, "helix");
+                return ok(result);
+            }
+            case "helix_dossier_start": {
+                const effectiveClient = withApiKey(client, args["api_key"]);
+                const result = await effectiveClient.post("/api/v1/helix/dossier", {
+                    compound: args["compound"],
+                    language: args["language"] ?? "en",
+                }, "helix");
+                return ok(result);
+            }
+            case "helix_dossier_status": {
+                const effectiveClient = withApiKey(client, args["api_key"]);
+                const jobId = encodeURIComponent(String(args["job_id"]));
+                const result = await effectiveClient.get(`/api/v1/helix/dossier/${jobId}`, "helix");
+                return ok(result);
+            }
+            // ── Protocols ─────────────────────────────────────────────────────────
+            case "protocol_search": {
+                const q = encodeURIComponent(String(args["query"]));
+                const limit = Math.min(Number(args["limit"] ?? 10), 20);
+                const cat = args["category"] ? `&category=${encodeURIComponent(String(args["category"]))}` : "";
+                const result = await client.get(`/api/protocols/search?q=${q}&limit=${limit}${cat}`, "public");
+                return ok(result);
+            }
+            case "protocol_get": {
+                const id = encodeURIComponent(String(args["id"]));
+                const result = await client.get(`/api/protocols/${id}`, "public");
+                return ok(result);
+            }
+            case "protocol_list_categories": {
+                // The protocols endpoint supports category listing via list-all
+                const protocols = await client.get("/api/protocols/list-all", "public");
+                // Aggregate unique categories from the full list
+                const categories = new Map();
+                if (Array.isArray(protocols)) {
+                    for (const p of protocols) {
+                        const slug = p.categoryId ?? p.category;
+                        if (slug) {
+                            const existing = categories.get(slug);
+                            if (existing) {
+                                existing.count++;
+                            }
+                            else {
+                                categories.set(slug, { name: p.category, slug, count: 1 });
+                            }
+                        }
+                    }
+                }
+                return ok(Array.from(categories.values()).sort((a, b) => b.count - a.count));
+            }
+            case "protocol_get_interactions": {
+                const compounds = args["compounds"] ?? [];
+                const allInteractions = await Promise.all(compounds.map((slug) => client.get(`/api/interactions/for/${slug}`, "public")));
+                const result = { compounds, interactions: allInteractions.flatMap((r) => r?.interactions ?? []) };
+                return ok(result);
+            }
+            // ── Evidence ──────────────────────────────────────────────────────────
+            case "evidence_search": {
+                const compound = encodeURIComponent(String(args["compound"]));
+                const maxResults = args["max_results"] ?? 10;
+                const result = await client.get(`/api/pubmed/search?peptide=${compound}&maxResults=${maxResults}`, "public");
+                return ok(result);
+            }
+            case "evidence_get": {
+                const id = encodeURIComponent(String(args["id"]));
+                const result = await client.get(`/api/evidence/${id}`, "public");
+                return ok(result);
+            }
+            case "evidence_grade": {
+                const ids = args["ids"];
+                const result = await client.post("/api/evidence/batch", { ids }, "public");
+                const records = Array.isArray(result) ? result : result?.evidence ?? [];
+                const graded = records.map((e) => ({
+                    id: e.id,
+                    title: e.title ?? e.name ?? null,
+                    pmid: e.pmid ?? e.pubmedId ?? null,
+                    study_type: e.studyType ?? e.study_type ?? null,
+                    grade: e.gradeRating ?? e.grade ?? null,
+                    confidence: e.confidenceLevel ?? e.confidence ?? null,
+                    summary: e.summary ?? e.clinicalRelevance ?? null,
+                }));
+                return ok({ count: graded.length, evidence: graded });
+            }
+            // ── Compounds ─────────────────────────────────────────────────────────
+            case "compound_search": {
+                const params = new URLSearchParams();
+                params.set("search", String(args["query"]));
+                if (args["category"])
+                    params.set("category", String(args["category"]));
+                const result = await client.get(`/api/compounds?${params.toString()}`, "public");
+                return ok(result);
+            }
+            case "compound_get_interactions": {
+                const slug = encodeURIComponent(String(args["slug"]));
+                const result = await client.get(`/api/interactions/for/${slug}`, "public");
+                return ok(result);
+            }
+            case "compound_get_dosing": {
+                const slug = encodeURIComponent(String(args["slug"]));
+                const protocol = await client.get(`/api/protocols/${slug}`, "public");
+                if (!protocol)
+                    return err(`No protocol found for compound: ${args["slug"]}`);
+                return ok({
+                    compound: protocol.title ?? protocol.name ?? args["slug"],
+                    slug: protocol.slug ?? args["slug"],
+                    evidence_grade: protocol.gradeRating ?? protocol.evidenceGrade ?? null,
+                    dosing_table: protocol.dosingTable ?? protocol.dosing?.table ?? [],
+                    dosing_notes: protocol.dosingNotes ?? protocol.dosing?.notes ?? [],
+                    administration_routes: protocol.administrationRoutes ?? null,
+                    cycle_guidance: protocol.cycleGuidance ?? null,
+                    fda_status: protocol.fdaStatus ?? null,
+                });
+            }
+            // ── User ──────────────────────────────────────────────────────────────
+            case "user_get_profile": {
+                const effectiveClient = withSessionToken(client, args["session_token"]);
+                const result = await effectiveClient.get("/api/auth/user", "session");
+                return ok(result);
+            }
+            case "user_get_usage": {
+                const effectiveClient = withSessionToken(client, args["session_token"]);
+                const result = await effectiveClient.get("/api/user/ai-usage", "session");
+                return ok(result);
+            }
+            case "user_get_saved_protocols": {
+                const effectiveClient = withSessionToken(client, args["session_token"]);
+                const result = await effectiveClient.get("/api/user/saved-protocols", "session");
+                return ok(result);
+            }
+            // ── Admin ─────────────────────────────────────────────────────────────
+            case "admin_get_stats": {
+                const effectiveClient = withAdminToken(client, args["admin_session_token"]);
+                const result = await effectiveClient.get("/api/admin/stats", "admin");
+                return ok(result);
+            }
+            case "admin_list_users": {
+                const effectiveClient = withAdminToken(client, args["admin_session_token"]);
+                const params = new URLSearchParams();
+                params.set("limit", String(args["limit"] ?? 20));
+                params.set("offset", String(args["offset"] ?? 0));
+                if (args["search"])
+                    params.set("search", String(args["search"]));
+                const result = await effectiveClient.get(`/api/admin/users?${params.toString()}`, "admin");
+                return ok(result);
+            }
+            case "admin_get_ai_costs": {
+                const effectiveClient = withAdminToken(client, args["admin_session_token"]);
+                const days = args["days"] ?? 30;
+                const result = await effectiveClient.get(`/api/admin/ai-costs?days=${days}`, "admin");
+                return ok(result);
+            }
+            // ── Agentic Workflow ──────────────────────────────────────────────────
+            case "run_clinical_workflow": {
+                const effectiveClient = withApiKey(client, args["api_key"]);
+                const question = args["question"];
+                const patientContext = args["patient_context"];
+                const language = args["language"] || "en";
+                const fullQuestion = patientContext
+                    ? `${question}\n\nPatient context: ${patientContext}`
+                    : question;
+                // Use helix /query with clinical detail level — complex queries get supervisor treatment
+                const result = await effectiveClient.post("/api/v1/helix/query", "apiKey", {
+                    question: fullQuestion,
+                    language,
+                    detail_level: "clinical",
+                    include_citations: true,
+                    include_three_lens: true,
+                });
+                // Format the result to highlight the multi-agent nature
+                const formatted = {
+                    answer: result?.data?.answer,
+                    evidence_grade: result?.data?.grade,
+                    confidence: result?.data?.confidence,
+                    agents_used: result?.data?.agents_used ?? [],
+                    agent_attributions: result?.data?.agent_attributions ?? [],
+                    orchestration_steps: result?.data?.orchestration_steps ?? [],
+                    citations: result?.data?.citations ?? [],
+                    three_lens: result?.data?.three_lens ?? null,
+                    usage: result?.usage,
+                };
+                return ok(formatted);
+            }
+            case "helix_deep_analysis": {
+                const effectiveClient = withApiKey(client, args["api_key"]);
+                const topic = args["topic"];
+                const language = args["language"] || "en";
+                const result = await effectiveClient.post("/api/v1/helix/query", "apiKey", {
+                    question: topic,
+                    language,
+                    detail_level: "clinical",
+                    include_citations: true,
+                    include_three_lens: true,
+                });
+                return ok({
+                    analysis: result?.data?.answer,
+                    evidence_grade: result?.data?.grade,
+                    confidence: result?.data?.confidence,
+                    three_lens: result?.data?.three_lens ?? null,
+                    citations: result?.data?.citations ?? [],
+                    related_protocols: result?.data?.related_protocols ?? [],
+                    orchestration_steps: result?.data?.orchestration_steps ?? [],
+                    usage: result?.usage,
+                });
+            }
+            case "monitor_protocol_updates": {
+                const effectiveClient = withSessionToken(client, args["session_token"]);
+                const compoundFilter = args["compound_filter"];
+                // Get user's saved protocols
+                const protocols = await effectiveClient.get("/api/user/saved-protocols", "session");
+                let filtered = protocols ?? [];
+                if (compoundFilter && compoundFilter.length > 0) {
+                    const filterLower = compoundFilter.map((c) => c.toLowerCase());
+                    filtered = filtered.filter((p) => filterLower.some((f) => p.title?.toLowerCase().includes(f) || p.compound?.toLowerCase().includes(f)));
+                }
+                return ok({
+                    protocols_monitored: filtered.length,
+                    protocols: filtered.slice(0, 20).map((p) => ({
+                        id: p.id,
+                        title: p.title,
+                        evidence_grade: p.evidenceGrade ?? p.evidence_grade ?? null,
+                        last_updated: p.updatedAt ?? p.updated_at ?? null,
+                        review_recommended: !p.updatedAt || (Date.now() - new Date(p.updatedAt).getTime()) > 90 * 24 * 60 * 60 * 1000,
+                    })),
+                    note: "Protocols not updated in 90+ days are flagged for review",
+                });
+            }
+            default:
+                return err(`Unknown tool: ${name}`);
+        }
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return err(message);
+    }
+}
+// ─── Auth override helpers ────────────────────────────────────────────────────
+function withApiKey(base, apiKey) {
+    if (!apiKey)
+        return base;
+    return new HoromnalyClient(loadConfig({ apiUrl: base.apiUrl, helixApiKey: apiKey }));
+}
+function withSessionToken(base, token) {
+    if (!token)
+        return base;
+    return new HoromnalyClient(loadConfig({ apiUrl: base.apiUrl, sessionToken: token }));
+}
+function withAdminToken(base, token) {
+    if (!token)
+        return base;
+    return new HoromnalyClient(loadConfig({ apiUrl: base.apiUrl, adminSessionToken: token }));
+}
+//# sourceMappingURL=tools.js.map