@happyvertical/sdk-mcp 0.79.0 → 0.80.1

package/AGENT.md

@@ -7,7 +7,7 @@ MCP server for HAVE SDK - Routes queries to package experts using AGENT.md files
 ## Package Map
 - Package: `@happyvertical/sdk-mcp`
 - Hierarchy path: `@happyvertical/sdk > packages > sdk-mcp`
-- Workspace position: `23 of 31` local packages
+- Workspace position: `23 of 32` local packages
 - Internal dependencies: `@happyvertical/ai`, `@happyvertical/files`, `@happyvertical/utils`
 - Internal dependents: none
 - Knowledge graph files: `AGENT.md`, `metadata.json`, `ecosystem-manifest.json`

package/dist/cli/claude-context.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
-import { existsSync, mkdirSync, copyFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-const Dirname = dirname(fileURLToPath(import.meta.url));
-const pkgRoot = join(Dirname, "../..");
-const targetDir = join(process.cwd(), ".claude");
-if (!existsSync(targetDir)) {
-  mkdirSync(targetDir, { recursive: true });
-}
-const pkgName = "sdk-mcp";
-const agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
-const metaSrc = existsSync(join(pkgRoot, "metadata.json")) ? join(pkgRoot, "metadata.json") : join(pkgRoot, ".claude-meta.json");
-if (existsSync(agentMdSrc)) {
-  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));
-}
-if (existsSync(metaSrc)) {
-  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));
-}
+import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+//#region src/cli/claude-context.ts
+/**
+* CLI script to install agent context for @happyvertical/sdk-mcp
+* Run the published context installer binary for this package.
+*/
+var pkgRoot = join(dirname(fileURLToPath(import.meta.url)), "../..");
+var targetDir = join(process.cwd(), ".claude");
+if (!existsSync(targetDir)) mkdirSync(targetDir, { recursive: true });
+var pkgName = "sdk-mcp";
+var agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
+var metaSrc = existsSync(join(pkgRoot, "metadata.json")) ? join(pkgRoot, "metadata.json") : join(pkgRoot, ".claude-meta.json");
+if (existsSync(agentMdSrc)) copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));
+if (existsSync(metaSrc)) copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));
 console.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);
+//#endregion
+export {};

package/dist/index.js

@@ -1,326 +1,408 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { getAI } from "@happyvertical/ai";
-import { readdir, readFile } from "node:fs/promises";
+import { readFile, readdir } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-const Filename = fileURLToPath(import.meta.url);
-const Dirname = dirname(Filename);
-const PACKAGE_KEYWORDS = {
-  ai: [
-    "ai",
-    "llm",
-    "gpt",
-    "claude",
-    "openai",
-    "anthropic",
-    "model",
-    "completion",
-    "chat",
-    "embedding",
-    "gemini",
-    "bedrock",
-    "huggingface"
-  ],
-  sql: [
-    "database",
-    "sql",
-    "sqlite",
-    "postgres",
-    "duckdb",
-    "query",
-    "table",
-    "schema",
-    "json"
-  ],
-  files: [
-    "file",
-    "filesystem",
-    "read",
-    "write",
-    "download",
-    "upload",
-    "path",
-    "storage"
-  ],
-  spider: [
-    "crawl",
-    "scrape",
-    "web",
-    "html",
-    "website",
-    "page",
-    "link",
-    "civicweb"
-  ],
-  pdf: ["pdf", "document", "extract", "parse", "acrobat"],
-  ocr: ["ocr", "image", "text extraction", "tesseract", "vision"],
-  geo: ["location", "map", "coordinates", "geocode", "address", "gis"],
-  translator: ["translate", "language", "translation", "localization"],
-  weather: [
-    "weather",
-    "forecast",
-    "temperature",
-    "precipitation",
-    "conditions",
-    "wind",
-    "humidity",
-    "openweathermap",
-    "environment canada"
-  ],
-  utils: ["id", "uuid", "slug", "date", "format", "utility", "helper"],
-  cache: ["cache", "caching", "redis", "memory", "store"],
-  logger: ["log", "logging", "logger", "debug", "error"],
-  documents: ["document processing", "content extraction", "analysis"],
-  email: [
-    "email",
-    "mail",
-    "smtp",
-    "imap",
-    "pop3",
-    "gmail",
-    "mailbox",
-    "send",
-    "receive",
-    "inbox",
-    "folder"
-  ],
-  "github-actions": [
-    "github",
-    "actions",
-    "workflow",
-    "ci",
-    "cd",
-    "automation",
-    "issue",
-    "pr",
-    "pull request",
-    "triage"
-  ],
-  directory: [
-    "directory",
-    "identity",
-    "provisioning",
-    "kanidm",
-    "stalwart",
-    "postgres",
-    "aws",
-    "iam",
-    "user",
-    "group",
-    "oauth",
-    "mail",
-    "domain",
-    "dkim",
-    "role",
-    "tenant"
-  ],
-  analytics: [
-    "analytics",
-    "tracking",
-    "ga4",
-    "google analytics",
-    "plausible",
-    "metrics",
-    "dimensions",
-    "report",
-    "pageview",
-    "event",
-    "conversion",
-    "measurement protocol"
-  ]
+//#region src/registry.ts
+var Dirname = dirname(fileURLToPath(import.meta.url));
+/**
+* Keyword mapping for routing queries to packages
+* Based on issue #237 specification
+*/
+var PACKAGE_KEYWORDS = {
+	ai: [
+		"ai",
+		"llm",
+		"gpt",
+		"claude",
+		"openai",
+		"anthropic",
+		"model",
+		"completion",
+		"chat",
+		"embedding",
+		"gemini",
+		"bedrock",
+		"huggingface"
+	],
+	sql: [
+		"database",
+		"sql",
+		"sqlite",
+		"postgres",
+		"duckdb",
+		"query",
+		"table",
+		"schema",
+		"json"
+	],
+	files: [
+		"file",
+		"filesystem",
+		"read",
+		"write",
+		"download",
+		"upload",
+		"path",
+		"storage"
+	],
+	spider: [
+		"crawl",
+		"scrape",
+		"web",
+		"html",
+		"website",
+		"page",
+		"link",
+		"civicweb"
+	],
+	pdf: [
+		"pdf",
+		"document",
+		"extract",
+		"parse",
+		"acrobat"
+	],
+	ocr: [
+		"ocr",
+		"image",
+		"text extraction",
+		"tesseract",
+		"vision"
+	],
+	geo: [
+		"location",
+		"map",
+		"coordinates",
+		"geocode",
+		"address",
+		"gis"
+	],
+	translator: [
+		"translate",
+		"language",
+		"translation",
+		"localization"
+	],
+	weather: [
+		"weather",
+		"forecast",
+		"temperature",
+		"precipitation",
+		"conditions",
+		"wind",
+		"humidity",
+		"openweathermap",
+		"environment canada"
+	],
+	utils: [
+		"id",
+		"uuid",
+		"slug",
+		"date",
+		"format",
+		"utility",
+		"helper"
+	],
+	cache: [
+		"cache",
+		"caching",
+		"redis",
+		"memory",
+		"store"
+	],
+	logger: [
+		"log",
+		"logging",
+		"logger",
+		"debug",
+		"error"
+	],
+	documents: [
+		"document processing",
+		"content extraction",
+		"analysis"
+	],
+	email: [
+		"email",
+		"mail",
+		"smtp",
+		"imap",
+		"pop3",
+		"gmail",
+		"mailbox",
+		"send",
+		"receive",
+		"inbox",
+		"folder"
+	],
+	"github-actions": [
+		"github",
+		"actions",
+		"workflow",
+		"ci",
+		"cd",
+		"automation",
+		"issue",
+		"pr",
+		"pull request",
+		"triage"
+	],
+	directory: [
+		"directory",
+		"identity",
+		"provisioning",
+		"kanidm",
+		"stalwart",
+		"postgres",
+		"aws",
+		"iam",
+		"user",
+		"group",
+		"oauth",
+		"mail",
+		"domain",
+		"dkim",
+		"role",
+		"tenant"
+	],
+	analytics: [
+		"analytics",
+		"tracking",
+		"ga4",
+		"google analytics",
+		"plausible",
+		"metrics",
+		"dimensions",
+		"report",
+		"pageview",
+		"event",
+		"conversion",
+		"measurement protocol"
+	]
 };
-const packageCache = /* @__PURE__ */ new Map();
+/**
+* Cache for loaded AGENT.md files
+*/
+var packageCache = /* @__PURE__ */ new Map();
+/**
+* Get the root SDK directory
+*/
 function getSDKRoot() {
-  return join(Dirname, "..", "..", "..");
+	return join(Dirname, "..", "..", "..");
 }
+/**
+* Extract description from AGENT.md content
+* Looks for "Purpose and Responsibilities" or first paragraph
+*/
 function extractDescription(content) {
-  const purposeMatch = content.match(
-    /##\s+Purpose and Responsibilities\s+([^\n]+(?:\n(?!##)[^\n]+)*)/i
-  );
-  if (purposeMatch) {
-    const purpose = purposeMatch[1].trim().replace(/\n/g, " ").replace(/\s+/g, " ");
-    const firstSentence = purpose.match(/^[^.!?]+[.!?]/);
-    if (firstSentence) {
-      return firstSentence[0].trim();
-    }
-    return `${purpose.substring(0, 200).trim()}...`;
-  }
-  const lines = content.split("\n");
-  let foundTitle = false;
-  for (const line of lines) {
-    if (line.startsWith("# ") || line.startsWith("## ")) {
-      foundTitle = true;
-      continue;
-    }
-    if (foundTitle && line.trim().length > 0 && !line.startsWith("#")) {
-      return line.trim();
-    }
-  }
-  return "No description available";
+	const purposeMatch = content.match(/##\s+Purpose and Responsibilities\s+([^\n]+(?:\n(?!##)[^\n]+)*)/i);
+	if (purposeMatch) {
+		const purpose = purposeMatch[1].trim().replace(/\n/g, " ").replace(/\s+/g, " ");
+		const firstSentence = purpose.match(/^[^.!?]+[.!?]/);
+		if (firstSentence) return firstSentence[0].trim();
+		return `${purpose.substring(0, 200).trim()}...`;
+	}
+	const lines = content.split("\n");
+	let foundTitle = false;
+	for (const line of lines) {
+		if (line.startsWith("# ") || line.startsWith("## ")) {
+			foundTitle = true;
+			continue;
+		}
+		if (foundTitle && line.trim().length > 0 && !line.startsWith("#")) return line.trim();
+	}
+	return "No description available";
 }
+/**
+* Scan packages directory for AGENT.md files and build registry.
+* Falls back to legacy CLAUDE.md files for compatibility.
+* Results are cached after the first call.
+*
+* @returns Cached map of package name to metadata
+* @throws If the packages directory cannot be read
+*/
 async function buildPackageRegistry() {
-  if (packageCache.size > 0) {
-    return packageCache;
-  }
-  const sdkRoot = getSDKRoot();
-  const packagesDir = join(sdkRoot, "packages");
-  try {
-    const entries = await readdir(packagesDir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const packageName = entry.name;
-      const agentMdPath = join(packagesDir, packageName, "AGENT.md");
-      const legacyClaudePath = join(packagesDir, packageName, "CLAUDE.md");
-      try {
-        let agentMd;
-        try {
-          agentMd = await readFile(agentMdPath, "utf-8");
-        } catch {
-          agentMd = await readFile(legacyClaudePath, "utf-8");
-        }
-        const description = extractDescription(agentMd);
-        const keywords = PACKAGE_KEYWORDS[packageName] || [];
-        packageCache.set(packageName, {
-          name: packageName,
-          path: join(packagesDir, packageName),
-          description,
-          agentMd,
-          keywords
-        });
-      } catch (_error) {
-      }
-    }
-    return packageCache;
-  } catch (error) {
-    throw new Error(
-      `Failed to build package registry: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
+	if (packageCache.size > 0) return packageCache;
+	const packagesDir = join(getSDKRoot(), "packages");
+	try {
+		const entries = await readdir(packagesDir, { withFileTypes: true });
+		for (const entry of entries) {
+			if (!entry.isDirectory()) continue;
+			const packageName = entry.name;
+			const agentMdPath = join(packagesDir, packageName, "AGENT.md");
+			const legacyClaudePath = join(packagesDir, packageName, "CLAUDE.md");
+			try {
+				let agentMd;
+				try {
+					agentMd = await readFile(agentMdPath, "utf-8");
+				} catch {
+					agentMd = await readFile(legacyClaudePath, "utf-8");
+				}
+				const description = extractDescription(agentMd);
+				const keywords = PACKAGE_KEYWORDS[packageName] || [];
+				packageCache.set(packageName, {
+					name: packageName,
+					path: join(packagesDir, packageName),
+					description,
+					agentMd,
+					keywords
+				});
+			} catch (_error) {}
+		}
+		return packageCache;
+	} catch (error) {
+		throw new Error(`Failed to build package registry: ${error instanceof Error ? error.message : String(error)}`);
+	}
 }
+/**
+* Get package metadata by name.
+*
+* @param name - Short package name (e.g. `"ai"`, `"sql"`)
+* @returns Package metadata, or `undefined` if not found
+*/
 async function getPackage(name) {
-  const registry = await buildPackageRegistry();
-  return registry.get(name);
+	return (await buildPackageRegistry()).get(name);
 }
+/**
+* Get all registered packages as an array.
+*
+* @returns Array of all discovered package metadata
+*/
 async function getAllPackages() {
-  const registry = await buildPackageRegistry();
-  return Array.from(registry.values());
+	const registry = await buildPackageRegistry();
+	return Array.from(registry.values());
 }
+/**
+* Get the raw AGENT.md content for a package.
+*
+* @param name - Short package name (e.g. `"ai"`, `"sql"`)
+* @returns AGENT.md content string, or `undefined` if the package is not found
+*/
 async function getPackageDocs(name) {
-  const pkg = await getPackage(name);
-  return pkg?.agentMd;
+	return (await getPackage(name))?.agentMd;
 }
+//#endregion
+//#region src/router.ts
+/**
+* Extract keywords from query text
+* Converts to lowercase and splits on word boundaries
+*/
 function extractQueryKeywords(query) {
-  return query.toLowerCase().split(/\W+/).filter((word) => word.length > 2);
+	return query.toLowerCase().split(/\W+/).filter((word) => word.length > 2);
 }
+/**
+* Calculate relevance score for a package based on keyword matches
+*/
 function calculateScore(queryKeywords, packageKeywords) {
-  const matched = [];
-  let score = 0;
-  for (const queryKeyword of queryKeywords) {
-    for (const packageKeyword of packageKeywords) {
-      if (queryKeyword === packageKeyword) {
-        score += 10;
-        matched.push(packageKeyword);
-      } else if (queryKeyword.includes(packageKeyword) || packageKeyword.includes(queryKeyword)) {
-        score += 5;
-        if (!matched.includes(packageKeyword)) {
-          matched.push(packageKeyword);
-        }
-      }
-    }
-  }
-  for (const queryKeyword of queryKeywords) {
-    if (packageKeywords.some((pkg) => pkg.toLowerCase() === queryKeyword)) {
-      score += 15;
-    }
-  }
-  return { score, matched };
+	const matched = [];
+	let score = 0;
+	for (const queryKeyword of queryKeywords) for (const packageKeyword of packageKeywords) if (queryKeyword === packageKeyword) {
+		score += 10;
+		matched.push(packageKeyword);
+	} else if (queryKeyword.includes(packageKeyword) || packageKeyword.includes(queryKeyword)) {
+		score += 5;
+		if (!matched.includes(packageKeyword)) matched.push(packageKeyword);
+	}
+	for (const queryKeyword of queryKeywords) if (packageKeywords.some((pkg) => pkg.toLowerCase() === queryKeyword)) score += 15;
+	return {
+		score,
+		matched
+	};
 }
+/**
+* Route query to relevant packages based on keyword matching
+* Returns packages sorted by relevance score
+*
+* @param query - User query string
+* @param minScore - Minimum score threshold for including a package (default: 5)
+* @returns Array of package matches sorted by score (descending)
+*/
 async function routeQuery(query, minScore = 5) {
-  const packages = await getAllPackages();
-  const queryKeywords = extractQueryKeywords(query);
-  const matches = [];
-  for (const pkg of packages) {
-    const { score, matched } = calculateScore(queryKeywords, pkg.keywords);
-    if (score >= minScore) {
-      matches.push({
-        package: pkg,
-        score,
-        matchedKeywords: matched
-      });
-    }
-  }
-  matches.sort((a, b) => b.score - a.score);
-  return matches;
+	const packages = await getAllPackages();
+	const queryKeywords = extractQueryKeywords(query);
+	const matches = [];
+	for (const pkg of packages) {
+		const { score, matched } = calculateScore(queryKeywords, pkg.keywords);
+		if (score >= minScore) matches.push({
+			package: pkg,
+			score,
+			matchedKeywords: matched
+		});
+	}
+	matches.sort((a, b) => b.score - a.score);
+	return matches;
 }
+/**
+* Look up packages by explicit name list.
+* Useful when the user specifies packages directly rather than relying on keyword routing.
+*
+* @param names - Array of short package names (e.g. `["ai", "sql"]`)
+* @returns Array of matched package metadata (unmatched names are silently excluded)
+*/
 async function getPackagesByNames(names) {
-  const packages = await getAllPackages();
-  const nameSet = new Set(names.map((n) => n.toLowerCase()));
-  return packages.filter((pkg) => nameSet.has(pkg.name.toLowerCase()));
+	const packages = await getAllPackages();
+	const nameSet = new Set(names.map((n) => n.toLowerCase()));
+	return packages.filter((pkg) => nameSet.has(pkg.name.toLowerCase()));
 }
+//#endregion
+//#region src/tools/ask.ts
+/**
+* Get AI client instance
+* Uses environment variables for configuration (HAVE_AI_*)
+*/
 async function getAIClient() {
-  try {
-    return await getAI({});
-  } catch (error) {
-    throw new Error(
-      `AI client initialization failed. Please configure AI provider using HAVE_AI_* environment variables. Error: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
+	try {
+		return await getAI({});
+	} catch (error) {
+		throw new Error(`AI client initialization failed. Please configure AI provider using HAVE_AI_* environment variables. Error: ${error instanceof Error ? error.message : String(error)}`);
+	}
 }
+/**
+* Build context from package AGENT.md files
+*/
 function buildContext(packages) {
-  if (packages.length === 0) {
-    return "No relevant packages found.";
-  }
-  const contextParts = [];
-  for (const pkg of packages) {
-    contextParts.push(
-      `## Package: @happyvertical/${pkg.name}
-
-${pkg.agentMd}
-
----
-`
-    );
-  }
-  return contextParts.join("\n");
+	if (packages.length === 0) return "No relevant packages found.";
+	const contextParts = [];
+	for (const pkg of packages) contextParts.push(`## Package: @happyvertical/${pkg.name}\n\n${pkg.agentMd}\n\n---\n`);
+	return contextParts.join("\n");
 }
+/**
+* Ask tool - Routes queries to package experts and synthesizes responses
+*
+* @param input - Query and optional package list
+* @returns AI-generated response based on package documentation
+*/
 async function ask(input) {
-  const { query, packages: requestedPackages } = input;
-  try {
-    let packages;
-    if (requestedPackages && requestedPackages.length > 0) {
-      packages = await getPackagesByNames(requestedPackages);
-      if (packages.length === 0) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `None of the requested packages (${requestedPackages.join(", ")}) were found. Use list-packages to see available packages.`
-            }
-          ],
-          isError: true
-        };
-      }
-    } else {
-      const matches = await routeQuery(query);
-      if (matches.length === 0) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `No relevant packages found for query: "${query}". Try using list-packages to browse available packages or specify packages explicitly.`
-            }
-          ],
-          isError: false
-        };
-      }
-      packages = matches.slice(0, 3).map((m) => m.package);
-    }
-    const context = buildContext(packages);
-    const ai = await getAIClient();
-    const systemPrompt = `You are an expert SDK documentation assistant for the HAppy VErtical (HAVE) SDK.
+	const { query, packages: requestedPackages } = input;
+	try {
+		let packages;
+		if (requestedPackages && requestedPackages.length > 0) {
+			packages = await getPackagesByNames(requestedPackages);
+			if (packages.length === 0) return {
+				content: [{
+					type: "text",
+					text: `None of the requested packages (${requestedPackages.join(", ")}) were found. Use list-packages to see available packages.`
+				}],
+				isError: true
+			};
+		} else {
+			const matches = await routeQuery(query);
+			if (matches.length === 0) return {
+				content: [{
+					type: "text",
+					text: `No relevant packages found for query: "${query}". Try using list-packages to browse available packages or specify packages explicitly.`
+				}],
+				isError: false
+			};
+			packages = matches.slice(0, 3).map((m) => m.package);
+		}
+		const context = buildContext(packages);
+		const ai = await getAIClient();
+		const systemPrompt = `You are an expert SDK documentation assistant for the HAppy VErtical (HAVE) SDK.
 You have access to the full documentation (AGENT.md files) for the following packages: ${packages.map((p) => `@happyvertical/${p.name}`).join(", ")}.
 
 Your role is to:
@@ -335,199 +417,171 @@ Use the documentation provided below to answer the user's question accurately.
 ---
 ${context}
 ---`;
-    const response = await ai.chat(
-      [
-        { role: "system", content: systemPrompt },
-        { role: "user", content: query }
-      ],
-      {
-        temperature: 0.7,
-        maxTokens: 2e3
-      }
-    );
-    const packageList = packages.map((p) => `@happyvertical/${p.name}`).join(", ");
-    const footer = `
-
----
-*Consulted packages: ${packageList}*`;
-    return {
-      content: [
-        {
-          type: "text",
-          text: response.content + footer
-        }
-      ]
-    };
-  } catch (error) {
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Error processing query: ${error instanceof Error ? error.message : String(error)}`
-        }
-      ],
-      isError: true
-    };
-  }
+		const response = await ai.chat([{
+			role: "system",
+			content: systemPrompt
+		}, {
+			role: "user",
+			content: query
+		}], {
+			temperature: .7,
+			maxTokens: 2e3
+		});
+		const footer = `\n\n---\n*Consulted packages: ${packages.map((p) => `@happyvertical/${p.name}`).join(", ")}*`;
+		return { content: [{
+			type: "text",
+			text: response.content + footer
+		}] };
+	} catch (error) {
+		return {
+			content: [{
+				type: "text",
+				text: `Error processing query: ${error instanceof Error ? error.message : String(error)}`
+			}],
+			isError: true
+		};
+	}
 }
+//#endregion
+//#region src/tools/get-docs.ts
+/**
+* Get full AGENT.md documentation for a specific package
+*
+* @param packageName - Name of the package (e.g., 'ai', 'sql', 'spider')
+* @returns Package documentation content
+*/
 async function getDocs(packageName) {
-  const docs = await getPackageDocs(packageName);
-  if (!docs) {
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Package "${packageName}" not found. Use list-packages to see available packages.`
-        }
-      ],
-      isError: true
-    };
-  }
-  return {
-    content: [
-      {
-        type: "text",
-        text: docs
-      }
-    ]
-  };
+	const docs = await getPackageDocs(packageName);
+	if (!docs) return {
+		content: [{
+			type: "text",
+			text: `Package "${packageName}" not found. Use list-packages to see available packages.`
+		}],
+		isError: true
+	};
+	return { content: [{
+		type: "text",
+		text: docs
+	}] };
 }
+//#endregion
+//#region src/tools/list-packages.ts
+/**
+* List all SDK packages with their descriptions
+*
+* @returns Object with packages array containing name and description
+*/
 async function listPackages() {
-  const packages = await getAllPackages();
-  return {
-    content: [
-      {
-        type: "text",
-        text: JSON.stringify(
-          {
-            packages: packages.map((pkg) => ({
-              name: pkg.name,
-              description: pkg.description,
-              keywords: pkg.keywords
-            })),
-            total: packages.length
-          },
-          null,
-          2
-        )
-      }
-    ]
-  };
-}
-class SDKMCPServer {
-  server;
-  constructor() {
-    this.server = new Server(
-      {
-        name: "happyvertical-sdk-mcp",
-        version: "0.1.0"
-      },
-      {
-        capabilities: {
-          tools: {}
-        }
-      }
-    );
-    this.setupToolHandlers();
-    this.setupErrorHandling();
-  }
-  setupToolHandlers() {
-    this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
-      tools: [
-        {
-          name: "ask",
-          description: "Ask a question about the HAVE SDK. Automatically routes your query to relevant package experts (AGENT.md files) and synthesizes a response using AI.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              query: {
-                type: "string",
-                description: "Your question about SDK usage or capabilities"
-              },
-              packages: {
-                type: "array",
-                items: { type: "string" },
-                description: 'Optional: Specific packages to consult (e.g., ["ai", "sql"])'
-              }
-            },
-            required: ["query"]
-          }
-        },
-        {
-          name: "list-packages",
-          description: "List all available SDK packages with their descriptions and keywords",
-          inputSchema: {
-            type: "object",
-            properties: {}
-          }
-        },
-        {
-          name: "get-docs",
-          description: "Get the full AGENT.md documentation for a specific package",
-          inputSchema: {
-            type: "object",
-            properties: {
-              packageName: {
-                type: "string",
-                description: 'Name of the package (e.g., "ai", "sql", "spider")'
-              }
-            },
-            required: ["packageName"]
-          }
-        }
-      ]
-    }));
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-      try {
-        switch (request.params.name) {
-          case "ask": {
-            const input = request.params.arguments ?? {};
-            return await ask(input);
-          }
-          case "list-packages": {
-            return await listPackages();
-          }
-          case "get-docs": {
-            const args = request.params.arguments ?? {};
-            return await getDocs(args.packageName);
-          }
-          default:
-            throw new Error(`Unknown tool: ${request.params.name}`);
-        }
-      } catch (error) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error executing tool: ${error instanceof Error ? error.message : String(error)}`
-            }
-          ],
-          isError: true
-        };
-      }
-    });
-  }
-  setupErrorHandling() {
-    this.server.onerror = (error) => {
-      console.error("[MCP Error]", error);
-    };
-    process.on("SIGINT", async () => {
-      await this.server.close();
-      process.exit(0);
-    });
-  }
-  async run() {
-    const transport = new StdioServerTransport();
-    await this.server.connect(transport);
-    console.error("HappyVertical SDK MCP Server running on stdio");
-  }
+	const packages = await getAllPackages();
+	return { content: [{
+		type: "text",
+		text: JSON.stringify({
+			packages: packages.map((pkg) => ({
+				name: pkg.name,
+				description: pkg.description,
+				keywords: pkg.keywords
+			})),
+			total: packages.length
+		}, null, 2)
+	}] };
 }
-const server = new SDKMCPServer();
-server.run().catch((error) => {
-  console.error("Fatal error:", error);
-  process.exit(1);
-});
-const PACKAGE_VERSION_INITIALIZED = true;
-export {
-  PACKAGE_VERSION_INITIALIZED
+//#endregion
+//#region src/index.ts
+/**
+* SDK MCP Server
+* Routes developer queries to appropriate package experts using AGENT.md files
+*/
+var SDKMCPServer = class {
+	server;
+	constructor() {
+		this.server = new Server({
+			name: "happyvertical-sdk-mcp",
+			version: "0.1.0"
+		}, { capabilities: { tools: {} } });
+		this.setupToolHandlers();
+		this.setupErrorHandling();
+	}
+	setupToolHandlers() {
+		this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [
+			{
+				name: "ask",
+				description: "Ask a question about the HAVE SDK. Automatically routes your query to relevant package experts (AGENT.md files) and synthesizes a response using AI.",
+				inputSchema: {
+					type: "object",
+					properties: {
+						query: {
+							type: "string",
+							description: "Your question about SDK usage or capabilities"
+						},
+						packages: {
+							type: "array",
+							items: { type: "string" },
+							description: "Optional: Specific packages to consult (e.g., [\"ai\", \"sql\"])"
+						}
+					},
+					required: ["query"]
+				}
+			},
+			{
+				name: "list-packages",
+				description: "List all available SDK packages with their descriptions and keywords",
+				inputSchema: {
+					type: "object",
+					properties: {}
+				}
+			},
+			{
+				name: "get-docs",
+				description: "Get the full AGENT.md documentation for a specific package",
+				inputSchema: {
+					type: "object",
+					properties: { packageName: {
+						type: "string",
+						description: "Name of the package (e.g., \"ai\", \"sql\", \"spider\")"
+					} },
+					required: ["packageName"]
+				}
+			}
+		] }));
+		this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+			try {
+				switch (request.params.name) {
+					case "ask": return await ask(request.params.arguments ?? {});
+					case "list-packages": return await listPackages();
+					case "get-docs": return await getDocs((request.params.arguments ?? {}).packageName);
+					default: throw new Error(`Unknown tool: ${request.params.name}`);
+				}
+			} catch (error) {
+				return {
+					content: [{
+						type: "text",
+						text: `Error executing tool: ${error instanceof Error ? error.message : String(error)}`
+					}],
+					isError: true
+				};
+			}
+		});
+	}
+	setupErrorHandling() {
+		this.server.onerror = (error) => {
+			console.error("[MCP Error]", error);
+		};
+		process.on("SIGINT", async () => {
+			await this.server.close();
+			process.exit(0);
+		});
+	}
+	async run() {
+		const transport = new StdioServerTransport();
+		await this.server.connect(transport);
+		console.error("HappyVertical SDK MCP Server running on stdio");
+	}
 };
+new SDKMCPServer().run().catch((error) => {
+	console.error("Fatal error:", error);
+	process.exit(1);
+});
+/** @internal */
+var PACKAGE_VERSION_INITIALIZED = true;
+//#endregion
+export { PACKAGE_VERSION_INITIALIZED };

package/metadata.json

@@ -3,7 +3,7 @@
   "path": "packages/sdk-mcp",
   "position": {
     "index": 23,
-    "count": 31
+    "count": 32
   },
   "description": "MCP server for HAVE SDK - Routes queries to package experts using AGENT.md files",
   "provides": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/sdk-mcp",
-  "version": "0.79.0",
+  "version": "0.80.1",
   "description": "MCP server for HAVE SDK - Routes queries to package experts using AGENT.md files",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,16 +38,16 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "@happyvertical/ai": "0.79.0",
-    "@happyvertical/utils": "0.79.0",
-    "@happyvertical/files": "0.79.0"
+    "@happyvertical/ai": "0.80.1",
+    "@happyvertical/files": "0.80.1",
+    "@happyvertical/utils": "0.80.1"
   },
   "devDependencies": {
     "@types/node": "25.0.10",
-    "typescript": "^5.9.3",
-    "vite": "7.3.2",
+    "typescript": "5.9.3",
+    "vite": "8.1.4",
     "vite-plugin-dts": "4.5.4",
-    "vitest": "^4.1.5"
+    "vitest": "4.1.10"
   },
   "scripts": {
     "test": "vitest --config ../../vitest.package.config.ts run --passWithNoTests",