@stacksfinder/mcp-server 1.2.1 → 1.3.0

package/dist/__tests__/mcp-tools.test.js

@@ -0,0 +1,345 @@
+/**
+ * MCP Server Integration Tests
+ *
+ * Tests all 21 MCP tools to ensure they are functional.
+ * Run with: npm test or vitest
+ */
+import { describe, test, expect, beforeAll } from 'vitest';
+import { createServer } from '../server.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
+import { ListToolsResultSchema } from '@modelcontextprotocol/sdk/types.js';
+// ============================================================================
+// TEST SETUP
+// ============================================================================
+// Helper to extract text from tool result
+function getResultText(result) {
+    const content = result.content;
+    const textContent = content.find((c) => c.type === 'text');
+    return textContent?.text || '';
+}
+let client;
+let server;
+beforeAll(async () => {
+    server = createServer();
+    client = new Client({ name: 'test-client', version: '1.0.0' });
+    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+    await Promise.all([client.connect(clientTransport), server.connect(serverTransport)]);
+});
+// ============================================================================
+// TOOL DISCOVERY TESTS
+// ============================================================================
+describe('MCP Server Tool Discovery', () => {
+    test('should list all 21 registered tools', async () => {
+        const result = await client.request({ method: 'tools/list' }, ListToolsResultSchema);
+        expect(result.tools).toBeDefined();
+        expect(result.tools.length).toBe(21);
+        const toolNames = result.tools.map((t) => t.name);
+        expect(toolNames).toContain('list_technologies');
+        expect(toolNames).toContain('analyze_tech');
+        expect(toolNames).toContain('compare_techs');
+        expect(toolNames).toContain('recommend_stack_demo');
+        expect(toolNames).toContain('recommend_stack');
+        expect(toolNames).toContain('get_blueprint');
+        expect(toolNames).toContain('create_blueprint');
+        expect(toolNames).toContain('setup_api_key');
+        expect(toolNames).toContain('list_api_keys');
+        expect(toolNames).toContain('revoke_api_key');
+        expect(toolNames).toContain('create_audit');
+        expect(toolNames).toContain('get_audit');
+        expect(toolNames).toContain('list_audits');
+        expect(toolNames).toContain('compare_audits');
+        expect(toolNames).toContain('get_audit_quota');
+        expect(toolNames).toContain('get_migration_recommendation');
+        expect(toolNames).toContain('generate_mcp_kit');
+        expect(toolNames).toContain('analyze_repo_mcps');
+        expect(toolNames).toContain('prepare_mcp_installation');
+        expect(toolNames).toContain('execute_mcp_installation');
+        expect(toolNames).toContain('check_mcp_compatibility');
+    });
+    test('all tools should have annotations', async () => {
+        const result = await client.request({ method: 'tools/list' }, ListToolsResultSchema);
+        for (const tool of result.tools) {
+            expect(tool.annotations).toBeDefined();
+            expect(tool.annotations?.readOnlyHint).toBeDefined();
+            expect(tool.annotations?.openWorldHint).toBeDefined();
+        }
+    });
+    test('local tools should have openWorldHint=false', async () => {
+        const result = await client.request({ method: 'tools/list' }, ListToolsResultSchema);
+        const localTools = [
+            'list_technologies',
+            'analyze_tech',
+            'compare_techs',
+            'recommend_stack_demo',
+            'generate_mcp_kit',
+            'check_mcp_compatibility',
+            'analyze_repo_mcps',
+            'execute_mcp_installation'
+        ];
+        for (const toolName of localTools) {
+            const tool = result.tools.find((t) => t.name === toolName);
+            expect(tool).toBeDefined();
+            expect(tool?.annotations?.openWorldHint).toBe(false);
+        }
+    });
+    test('API tools should have openWorldHint=true', async () => {
+        const result = await client.request({ method: 'tools/list' }, ListToolsResultSchema);
+        const apiTools = [
+            'recommend_stack',
+            'get_blueprint',
+            'create_blueprint',
+            'setup_api_key',
+            'list_api_keys',
+            'revoke_api_key',
+            'create_audit',
+            'get_audit',
+            'list_audits',
+            'compare_audits',
+            'get_audit_quota',
+            'get_migration_recommendation'
+        ];
+        for (const toolName of apiTools) {
+            const tool = result.tools.find((t) => t.name === toolName);
+            expect(tool).toBeDefined();
+            expect(tool?.annotations?.openWorldHint).toBe(true);
+        }
+    });
+});
+// ============================================================================
+// LOCAL TOOL TESTS (no API key required)
+// ============================================================================
+describe('Local Tools (No API Key)', () => {
+    test('list_technologies should return technologies', async () => {
+        const result = (await client.callTool({
+            name: 'list_technologies',
+            arguments: {}
+        }));
+        expect(result.content).toBeDefined();
+        const text = getResultText(result);
+        expect(text).toContain('Technologies');
+        expect(text).toContain('frontend');
+    });
+    test('list_technologies should filter by category', async () => {
+        const result = (await client.callTool({
+            name: 'list_technologies',
+            arguments: { category: 'database' }
+        }));
+        const text = getResultText(result);
+        expect(text).toContain('database');
+    });
+    test('analyze_tech should analyze nextjs', async () => {
+        const result = (await client.callTool({
+            name: 'analyze_tech',
+            arguments: { technology: 'nextjs' }
+        }));
+        const text = getResultText(result);
+        expect(text).toContain('Next.js');
+        expect(text).toContain('Score');
+    });
+    test('analyze_tech should return error for unknown tech', async () => {
+        const result = (await client.callTool({
+            name: 'analyze_tech',
+            arguments: { technology: 'unknown-tech-xyz' }
+        }));
+        expect(result.isError).toBe(true);
+        const text = getResultText(result);
+        expect(text).toContain('not found');
+    });
+    test('compare_techs should compare frameworks', async () => {
+        const result = (await client.callTool({
+            name: 'compare_techs',
+            arguments: { technologies: ['nextjs', 'sveltekit'] }
+        }));
+        const text = getResultText(result);
+        expect(text).toContain('Comparison');
+        expect(text).toContain('Next.js');
+        expect(text).toContain('SvelteKit');
+    });
+    test('compare_techs should handle different contexts', async () => {
+        const result = (await client.callTool({
+            name: 'compare_techs',
+            arguments: { technologies: ['postgresql', 'mysql'], context: 'enterprise' }
+        }));
+        const text = getResultText(result);
+        expect(text).toContain('enterprise');
+    });
+    test('recommend_stack_demo should return recommendations', async () => {
+        const result = (await client.callTool({
+            name: 'recommend_stack_demo',
+            arguments: { projectType: 'saas' }
+        }));
+        // May return rate limit error, that's fine
+        const text = getResultText(result);
+        expect(text.length).toBeGreaterThan(0);
+    });
+    test('generate_mcp_kit should generate recommendations', async () => {
+        const result = (await client.callTool({
+            name: 'generate_mcp_kit',
+            arguments: {
+                projectDescription: 'A SaaS application for managing customer subscriptions with Stripe payments, PostgreSQL database, and Next.js frontend'
+            }
+        }));
+        const text = getResultText(result);
+        const parsed = JSON.parse(text);
+        expect(parsed).toHaveProperty('detectedTechnologies');
+        expect(parsed).toHaveProperty('recommendedMcps');
+    });
+    test('check_mcp_compatibility should detect conflicts', async () => {
+        const result = (await client.callTool({
+            name: 'check_mcp_compatibility',
+            arguments: { mcps: ['supabase-mcp', 'neon-mcp'] }
+        }));
+        const text = getResultText(result);
+        expect(text.toLowerCase()).toContain('conflict');
+    });
+    test('check_mcp_compatibility should detect synergies', async () => {
+        const result = (await client.callTool({
+            name: 'check_mcp_compatibility',
+            arguments: { mcps: ['stripe-mcp', 'resend-mcp'] }
+        }));
+        const text = getResultText(result);
+        expect(text.toLowerCase()).toContain('synerg');
+    });
+});
+// ============================================================================
+// API TOOL TESTS (require API key - test error handling)
+// ============================================================================
+describe('API Tools (Error Handling Without API Key)', () => {
+    test('recommend_stack should require API key', async () => {
+        const result = (await client.callTool({
+            name: 'recommend_stack',
+            arguments: { projectType: 'saas' }
+        }));
+        // Should fail without API key
+        expect(result.isError).toBe(true);
+        const text = getResultText(result);
+        expect(text.toLowerCase()).toMatch(/api.?key|auth|unauthorized/i);
+    });
+    test('get_blueprint should handle invalid UUID', async () => {
+        // This tests input validation
+        try {
+            await client.callTool({
+                name: 'get_blueprint',
+                arguments: { blueprintId: 'not-a-uuid' }
+            });
+        }
+        catch (error) {
+            // Expected to fail validation
+            expect(error).toBeDefined();
+        }
+    });
+    test('list_api_keys should require API key', async () => {
+        const result = (await client.callTool({
+            name: 'list_api_keys',
+            arguments: {}
+        }));
+        expect(result.isError).toBe(true);
+    });
+    test('get_audit_quota should require API key', async () => {
+        const result = (await client.callTool({
+            name: 'get_audit_quota',
+            arguments: {}
+        }));
+        expect(result.isError).toBe(true);
+    });
+    test('create_audit should require API key', async () => {
+        const result = (await client.callTool({
+            name: 'create_audit',
+            arguments: {
+                name: 'Test Audit',
+                technologies: [{ name: 'React', version: '18.0.0' }]
+            }
+        }));
+        expect(result.isError).toBe(true);
+    });
+});
+// ============================================================================
+// INPUT VALIDATION TESTS
+// ============================================================================
+describe('Input Validation', () => {
+    test('analyze_tech should require technology parameter', async () => {
+        try {
+            await client.callTool({
+                name: 'analyze_tech',
+                arguments: {}
+            });
+            expect(true).toBe(false); // Should not reach here
+        }
+        catch (error) {
+            expect(error).toBeDefined();
+        }
+    });
+    test('compare_techs should require at least 2 technologies', async () => {
+        try {
+            await client.callTool({
+                name: 'compare_techs',
+                arguments: { technologies: ['nextjs'] }
+            });
+            expect(true).toBe(false);
+        }
+        catch (error) {
+            expect(error).toBeDefined();
+        }
+    });
+    test('compare_techs should reject more than 4 technologies', async () => {
+        try {
+            await client.callTool({
+                name: 'compare_techs',
+                arguments: { technologies: ['nextjs', 'sveltekit', 'remix', 'nuxt', 'astro'] }
+            });
+            expect(true).toBe(false);
+        }
+        catch (error) {
+            expect(error).toBeDefined();
+        }
+    });
+    test('generate_mcp_kit should require minimum description length', async () => {
+        try {
+            await client.callTool({
+                name: 'generate_mcp_kit',
+                arguments: { projectDescription: 'Too short' }
+            });
+            expect(true).toBe(false);
+        }
+        catch (error) {
+            expect(error).toBeDefined();
+        }
+    });
+    test('check_mcp_compatibility should require at least 1 MCP', async () => {
+        try {
+            await client.callTool({
+                name: 'check_mcp_compatibility',
+                arguments: { mcps: [] }
+            });
+            expect(true).toBe(false);
+        }
+        catch (error) {
+            expect(error).toBeDefined();
+        }
+    });
+});
+// ============================================================================
+// PROJECT-KIT TOOL TESTS
+// ============================================================================
+describe('Project-Kit Tools', () => {
+    test('analyze_repo_mcps should work without workspace', async () => {
+        const result = (await client.callTool({
+            name: 'analyze_repo_mcps',
+            arguments: { workspaceRoot: '/nonexistent/path' }
+        }));
+        // Should return empty analysis, not error
+        const text = getResultText(result);
+        expect(text).toContain('Repository Analysis');
+    });
+    test('execute_mcp_installation should handle missing .env-mcp', async () => {
+        const result = (await client.callTool({
+            name: 'execute_mcp_installation',
+            arguments: { envMcpPath: '/nonexistent/.env-mcp' }
+        }));
+        const text = getResultText(result);
+        // Should handle gracefully
+        expect(text.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=mcp-tools.test.js.map

package/dist/__tests__/mcp-tools.test.js.map

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

package/dist/annotations.d.ts

@@ -0,0 +1,63 @@
+/**
+ * MCP Tool Annotations
+ *
+ * These annotations help MCP clients (VS Code, Cursor, etc.) understand
+ * the behavior of each tool and make informed decisions about enabling them.
+ *
+ * @see https://modelcontextprotocol.io/specification/2025-06-18/server/tools
+ */
+import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Tool behavior hints:
+ * - readOnlyHint: true = tool doesn't modify anything (safe)
+ * - destructiveHint: true = tool can delete/destroy data
+ * - idempotentHint: true = calling multiple times = same result
+ * - openWorldHint: true = interacts with external APIs/services
+ */
+/** List technologies - local lookup, read-only */
+export declare const listTechnologiesAnnotations: ToolAnnotations;
+/** Analyze technology - local scoring, read-only */
+export declare const analyzeTechAnnotations: ToolAnnotations;
+/** Compare technologies - local scoring, read-only */
+export declare const compareTechsAnnotations: ToolAnnotations;
+/** Recommend stack demo - local scoring with rate limit, read-only */
+export declare const recommendStackDemoAnnotations: ToolAnnotations;
+/** Generate MCP kit - local analysis, read-only */
+export declare const generateMcpKitAnnotations: ToolAnnotations;
+/** Check MCP compatibility - local rule checking, read-only */
+export declare const checkCompatibilityAnnotations: ToolAnnotations;
+/** Analyze repo MCPs - reads local files, no modifications */
+export declare const analyzeRepoMcpsAnnotations: ToolAnnotations;
+/** Prepare MCP installation - creates .env-mcp file */
+export declare const prepareMcpInstallationAnnotations: ToolAnnotations;
+/** Execute MCP installation - generates commands only, no execution */
+export declare const executeMcpInstallationAnnotations: ToolAnnotations;
+/** Recommend stack - calls StacksFinder API */
+export declare const recommendStackAnnotations: ToolAnnotations;
+/** Get blueprint - fetches from API */
+export declare const getBlueprintAnnotations: ToolAnnotations;
+/** Create blueprint - creates resource via API */
+export declare const createBlueprintAnnotations: ToolAnnotations;
+/** Setup API key - authenticates and creates key */
+export declare const setupApiKeyAnnotations: ToolAnnotations;
+/** List API keys - fetches from API */
+export declare const listApiKeysAnnotations: ToolAnnotations;
+/** Revoke API key - deletes resource */
+export declare const revokeApiKeyAnnotations: ToolAnnotations;
+/** Create audit - creates resource */
+export declare const createAuditAnnotations: ToolAnnotations;
+/** Get audit - fetches from API */
+export declare const getAuditAnnotations: ToolAnnotations;
+/** List audits - fetches from API */
+export declare const listAuditsAnnotations: ToolAnnotations;
+/** Compare audits - fetches and compares */
+export declare const compareAuditsAnnotations: ToolAnnotations;
+/** Get audit quota - fetches from API */
+export declare const getAuditQuotaAnnotations: ToolAnnotations;
+/** Get migration recommendation - analyzes audit */
+export declare const getMigrationRecommendationAnnotations: ToolAnnotations;
+/** Estimate project - creates estimate via LLM + optional market analysis */
+export declare const estimateProjectAnnotations: ToolAnnotations;
+/** Get estimate quota - fetches quota status */
+export declare const getEstimateQuotaAnnotations: ToolAnnotations;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E;;;;;;GAMG;AAMH,kDAAkD;AAClD,eAAO,MAAM,2BAA2B,EAAE,eAMzC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,6BAA6B,EAAE,eAM3C,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,EAAE,eAMvC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,6BAA6B,EAAE,eAM3C,CAAC;AAMF,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,iCAAiC,EAAE,eAM/C,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,iCAAiC,EAAE,eAM/C,CAAC;AAMF,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB,EAAE,eAMvC,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,EAAE,eAMrC,CAAC;AAMF,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,EAAE,eAMjC,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,EAAE,eAMnC,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,qCAAqC,EAAE,eAMnD,CAAC;AAMF,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,EAAE,eAMxC,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,EAAE,eAMzC,CAAC"}

package/dist/annotations.js

@@ -0,0 +1,215 @@
+/**
+ * MCP Tool Annotations
+ *
+ * These annotations help MCP clients (VS Code, Cursor, etc.) understand
+ * the behavior of each tool and make informed decisions about enabling them.
+ *
+ * @see https://modelcontextprotocol.io/specification/2025-06-18/server/tools
+ */
+/**
+ * Tool behavior hints:
+ * - readOnlyHint: true = tool doesn't modify anything (safe)
+ * - destructiveHint: true = tool can delete/destroy data
+ * - idempotentHint: true = calling multiple times = same result
+ * - openWorldHint: true = interacts with external APIs/services
+ */
+// ============================================================================
+// LOCAL TOOLS (no API calls, fully offline)
+// ============================================================================
+/** List technologies - local lookup, read-only */
+export const listTechnologiesAnnotations = {
+    title: 'List Technologies',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+/** Analyze technology - local scoring, read-only */
+export const analyzeTechAnnotations = {
+    title: 'Analyze Technology',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+/** Compare technologies - local scoring, read-only */
+export const compareTechsAnnotations = {
+    title: 'Compare Technologies',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+/** Recommend stack demo - local scoring with rate limit, read-only */
+export const recommendStackDemoAnnotations = {
+    title: 'Recommend Stack (Demo)',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+/** Generate MCP kit - local analysis, read-only */
+export const generateMcpKitAnnotations = {
+    title: 'Generate MCP Kit',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+/** Check MCP compatibility - local rule checking, read-only */
+export const checkCompatibilityAnnotations = {
+    title: 'Check MCP Compatibility',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+// ============================================================================
+// LOCAL TOOLS WITH FILE SYSTEM ACCESS
+// ============================================================================
+/** Analyze repo MCPs - reads local files, no modifications */
+export const analyzeRepoMcpsAnnotations = {
+    title: 'Analyze Repository MCPs',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+/** Prepare MCP installation - creates .env-mcp file */
+export const prepareMcpInstallationAnnotations = {
+    title: 'Prepare MCP Installation',
+    readOnlyHint: false, // Creates files
+    destructiveHint: false, // Doesn't delete anything
+    idempotentHint: true, // Same input = same file
+    openWorldHint: false
+};
+/** Execute MCP installation - generates commands only, no execution */
+export const executeMcpInstallationAnnotations = {
+    title: 'Execute MCP Installation',
+    readOnlyHint: true, // Only generates commands, doesn't execute
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+// ============================================================================
+// API-BASED TOOLS (require network access)
+// ============================================================================
+/** Recommend stack - calls StacksFinder API */
+export const recommendStackAnnotations = {
+    title: 'Recommend Stack',
+    readOnlyHint: true, // API is read-only
+    destructiveHint: false,
+    idempotentHint: true, // Same request = same response
+    openWorldHint: true // External API call
+};
+/** Get blueprint - fetches from API */
+export const getBlueprintAnnotations = {
+    title: 'Get Blueprint',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+};
+/** Create blueprint - creates resource via API */
+export const createBlueprintAnnotations = {
+    title: 'Create Blueprint',
+    readOnlyHint: false, // Creates a resource
+    destructiveHint: false,
+    idempotentHint: false, // Creates new resource each time
+    openWorldHint: true
+};
+/** Setup API key - authenticates and creates key */
+export const setupApiKeyAnnotations = {
+    title: 'Setup API Key',
+    readOnlyHint: false, // Creates API key
+    destructiveHint: false,
+    idempotentHint: false, // Creates new key each time
+    openWorldHint: true
+};
+/** List API keys - fetches from API */
+export const listApiKeysAnnotations = {
+    title: 'List API Keys',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+};
+/** Revoke API key - deletes resource */
+export const revokeApiKeyAnnotations = {
+    title: 'Revoke API Key',
+    readOnlyHint: false,
+    destructiveHint: true, // Permanently revokes key
+    idempotentHint: true, // Revoking twice = same result
+    openWorldHint: true
+};
+// ============================================================================
+// AUDIT TOOLS (API-based)
+// ============================================================================
+/** Create audit - creates resource */
+export const createAuditAnnotations = {
+    title: 'Create Technical Debt Audit',
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false, // Creates new audit each time
+    openWorldHint: true
+};
+/** Get audit - fetches from API */
+export const getAuditAnnotations = {
+    title: 'Get Audit Report',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+};
+/** List audits - fetches from API */
+export const listAuditsAnnotations = {
+    title: 'List Audit Reports',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+};
+/** Compare audits - fetches and compares */
+export const compareAuditsAnnotations = {
+    title: 'Compare Audit Reports',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+};
+/** Get audit quota - fetches from API */
+export const getAuditQuotaAnnotations = {
+    title: 'Get Audit Quota',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+};
+/** Get migration recommendation - analyzes audit */
+export const getMigrationRecommendationAnnotations = {
+    title: 'Get Migration Recommendation',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+};
+// ============================================================================
+// ESTIMATOR TOOLS (API-based, LLM + Perplexity)
+// ============================================================================
+/** Estimate project - creates estimate via LLM + optional market analysis */
+export const estimateProjectAnnotations = {
+    title: 'Estimate Project',
+    readOnlyHint: false, // Creates estimate, consumes quota
+    destructiveHint: false,
+    idempotentHint: false, // LLM responses can vary
+    openWorldHint: true // Calls Claude + optional Perplexity
+};
+/** Get estimate quota - fetches quota status */
+export const getEstimateQuotaAnnotations = {
+    title: 'Get Estimate Quota',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+};
+//# sourceMappingURL=annotations.js.map

package/dist/annotations.js.map

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

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiFpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAsjBxC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiHpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAsoBxC"}