@anastops/mcp-server 0.1.0 → 1.1.0

package/dist/handlers/types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Shared types for MCP tool handlers
+ */
+import type { AdapterRegistry } from '@anastops/adapters';
+import type { SessionManager, Agent, Artifact, Session, Task } from '@anastops/core';
+import type { LRUCache } from 'lru-cache';
+/**
+ * MCP Tool Definition schema
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * Memory store value type
+ */
+export interface MemoryStoreValue {
+    value: Record<string, unknown>;
+    stored_at: Date;
+}
+/**
+ * Session report structure from persistence layer
+ */
+export interface SessionReport {
+    session: {
+        id: string;
+        objective: string;
+        status: string;
+        created_at: Date;
+        updated_at: Date;
+        metadata: {
+            total_tokens: number;
+            total_cost: number;
+            agents_used: string[];
+            files_affected: string[];
+            tasks_completed: number;
+            tasks_failed: number;
+        };
+    };
+    tasks: Task[];
+    agents: Agent[];
+    artifacts: Artifact[];
+}
+/**
+ * Context passed to all handler functions
+ */
+export interface HandlerContext {
+    sessions: Map<string, Session>;
+    tasks: Map<string, Task>;
+    agents: Map<string, Agent>;
+    artifacts: Map<string, Artifact>;
+    memoryStore: LRUCache<string, MemoryStoreValue>;
+    sessionManager: SessionManager;
+    registry: AdapterRegistry;
+    getPersistence: () => {
+        saveSession: (session: Session) => Promise<void>;
+        getTask: (taskId: string) => Promise<Task | null>;
+        saveTask: (task: Task) => Promise<void>;
+        listTasks: (filters: Record<string, unknown>) => Promise<Task[]>;
+        getAgent: (agentId: string) => Promise<Agent | null>;
+        saveAgent: (agent: Agent) => Promise<void>;
+        listAgents: (filters: Record<string, unknown>) => Promise<Agent[]>;
+        getArtifact: (artifactId: string) => Promise<Artifact | null>;
+        saveArtifact: (artifact: Artifact) => Promise<void>;
+        listArtifacts: (filters: Record<string, unknown>) => Promise<Artifact[]>;
+        listSessions: (filters: Record<string, unknown>) => Promise<Session[]>;
+        getSessionReport: (sessionId: string) => Promise<SessionReport | null>;
+        getAllSessionReports: (filters: Record<string, unknown>) => Promise<SessionReport[]>;
+        deleteSession: (sessionId: string) => Promise<boolean>;
+        deleteSessions: (filters: Record<string, unknown>) => Promise<{
+            deleted_count: number;
+            session_ids: string[];
+        }>;
+    };
+    safePersist: (promise: Promise<void>) => void;
+}
+/**
+ * TOON-encoded response wrapper type
+ */
+export interface TOONEncodedResponse {
+    data: unknown;
+    encoding?: 'toon' | 'json';
+    token_reduction?: {
+        original: number;
+        encoded: number;
+        savings_percent: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/handlers/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for MCP tool handlers
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/handlers/types.js.map

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

package/dist/handlers/utility-handlers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility handlers
+ * Handles: health_check, provider_list, metrics_get, config_get, config_set
+ */
+import type { HandlerContext, ToolDefinition } from './types.js';
+export declare const toolDefinitions: ToolDefinition[];
+export declare function handleTool(name: string, args: Record<string, unknown>, context: HandlerContext): Promise<unknown>;
+//# sourceMappingURL=utility-handlers.d.ts.map

package/dist/handlers/utility-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/utility-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,eAAe,EAAE,cAAc,EA8C3C,CAAC;AAEF,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAqElB"}

package/dist/handlers/utility-handlers.js

@@ -0,0 +1,113 @@
+/**
+ * Utility handlers
+ * Handles: health_check, provider_list, metrics_get, config_get, config_set
+ */
+export const toolDefinitions = [
+    {
+        name: 'health_check',
+        description: 'Check system health',
+        inputSchema: {
+            type: 'object',
+            properties: { include_providers: { type: 'boolean' } },
+        },
+    },
+    {
+        name: 'provider_list',
+        description: 'List available AI providers',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filter_healthy: { type: 'boolean' },
+                include_capabilities: { type: 'boolean' },
+            },
+        },
+    },
+    {
+        name: 'metrics_get',
+        description: 'Get system metrics',
+        inputSchema: {
+            type: 'object',
+            properties: { metric_type: { type: 'string', enum: ['routing', 'tokens', 'costs', 'all'] } },
+        },
+    },
+    {
+        name: 'config_get',
+        description: 'Get configuration value',
+        inputSchema: {
+            type: 'object',
+            properties: { key: { type: 'string' } },
+            required: ['key'],
+        },
+    },
+    {
+        name: 'config_set',
+        description: 'Set configuration value',
+        inputSchema: {
+            type: 'object',
+            properties: { key: { type: 'string' }, value: {} },
+            required: ['key', 'value'],
+        },
+    },
+];
+export async function handleTool(name, args, context) {
+    switch (name) {
+        case 'health_check': {
+            const result = {
+                status: 'healthy',
+                timestamp: new Date(),
+                components: { core: 'healthy', router: 'healthy', memory: 'in-memory' },
+            };
+            if (args['include_providers'] === true) {
+                const providerHealth = {};
+                for (const adapter of context.registry.list()) {
+                    const health = await adapter.healthCheck();
+                    providerHealth[adapter.type] = { healthy: health.healthy, error: health.error };
+                }
+                result['providers'] = providerHealth;
+            }
+            return result;
+        }
+        case 'provider_list': {
+            const providers = [];
+            for (const adapter of context.registry.list()) {
+                const health = await adapter.healthCheck();
+                if (args['filter_healthy'] === true && !health.healthy)
+                    continue;
+                const info = {
+                    type: adapter.type,
+                    name: adapter.name,
+                    healthy: health.healthy,
+                };
+                if (args['include_capabilities'] === true) {
+                    const caps = await adapter.getCapabilities();
+                    info['capabilities'] = caps;
+                }
+                providers.push(info);
+            }
+            return { count: providers.length, providers };
+        }
+        case 'metrics_get': {
+            // Placeholder metrics
+            return {
+                routing: { tier_distribution: {}, provider_stats: {} },
+                tokens: { total: 0, by_provider: {} },
+                costs: { total: 0, by_provider: {} },
+            };
+        }
+        case 'config_get': {
+            // Placeholder config
+            const config = {
+                default_provider: 'claude',
+                default_timeout: 600000, // 10 minutes
+                context_budget: 1600,
+            };
+            return { key: args['key'], value: config[args['key']] };
+        }
+        case 'config_set': {
+            return { key: args['key'], value: args['value'], updated: true };
+        }
+        default:
+            throw new Error(`Unknown utility tool: ${name}`);
+    }
+}
+//# sourceMappingURL=utility-handlers.js.map

package/dist/handlers/utility-handlers.js.map

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

package/dist/handlers/utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared utilities for MCP tool handlers
+ * eslint-disable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+ */
+import type { Agent, Artifact, Task } from '@anastops/core';
+import type { HandlerContext } from './types.js';
+/**
+ * Safe fire-and-forget wrapper for persistence operations
+ * Catches errors to prevent uncaught promise rejections from crashing the server
+ */
+export declare function safePersist<T>(operation: Promise<T>): void;
+/**
+ * Get task from memory or MongoDB
+ * Loads from MongoDB and caches in memory if not found
+ */
+export declare function getTask(taskId: string, context: HandlerContext): Promise<Task | null>;
+/**
+ * Get agent from memory or MongoDB
+ */
+export declare function getAgent(agentId: string, context: HandlerContext): Promise<Agent | null>;
+/**
+ * Get artifact from memory or MongoDB
+ */
+export declare function getArtifact(artifactId: string, context: HandlerContext): Promise<Artifact | null>;
+/**
+ * Sanitize error message for external exposure
+ * SECURITY: Never expose internal details like stack traces, paths, or credentials
+ */
+export declare function sanitizeErrorMessage(error: unknown): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/handlers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/handlers/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAI5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAU1D;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAgB3F;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAa9F;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAa1B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwB3D"}

package/dist/handlers/utils.js

@@ -0,0 +1,95 @@
+/**
+ * Shared utilities for MCP tool handlers
+ * eslint-disable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+ */
+import { getLogger } from '@anastops/core';
+import { ZodError } from 'zod';
+/**
+ * Safe fire-and-forget wrapper for persistence operations
+ * Catches errors to prevent uncaught promise rejections from crashing the server
+ */
+export function safePersist(operation) {
+    operation.catch((error) => {
+        const logger = getLogger();
+        logger.error({
+            error: error instanceof Error ? error.message : String(error),
+        }, 'Persistence error during tool execution');
+    });
+}
+/**
+ * Get task from memory or MongoDB
+ * Loads from MongoDB and caches in memory if not found
+ */
+export async function getTask(taskId, context) {
+    // Check in-memory first
+    const memTask = context.tasks.get(taskId);
+    if (memTask !== undefined) {
+        return memTask;
+    }
+    // Try to load from MongoDB
+    const dbTask = await context.getPersistence().getTask(taskId);
+    if (dbTask !== null) {
+        // Cache in memory for subsequent access
+        context.tasks.set(taskId, dbTask);
+        return dbTask;
+    }
+    return null;
+}
+/**
+ * Get agent from memory or MongoDB
+ */
+export async function getAgent(agentId, context) {
+    const memAgent = context.agents.get(agentId);
+    if (memAgent !== undefined) {
+        return memAgent;
+    }
+    const dbAgent = await context.getPersistence().getAgent(agentId);
+    if (dbAgent !== null) {
+        context.agents.set(agentId, dbAgent);
+        return dbAgent;
+    }
+    return null;
+}
+/**
+ * Get artifact from memory or MongoDB
+ */
+export async function getArtifact(artifactId, context) {
+    const memArtifact = context.artifacts.get(artifactId);
+    if (memArtifact !== undefined) {
+        return memArtifact;
+    }
+    const dbArtifact = await context.getPersistence().getArtifact(artifactId);
+    if (dbArtifact !== null) {
+        context.artifacts.set(artifactId, dbArtifact);
+        return dbArtifact;
+    }
+    return null;
+}
+/**
+ * Sanitize error message for external exposure
+ * SECURITY: Never expose internal details like stack traces, paths, or credentials
+ */
+export function sanitizeErrorMessage(error) {
+    if (error instanceof ZodError) {
+        // Return validation errors with field details but no internal info
+        const issues = error.issues.map((issue) => ({
+            path: issue.path.join('.'),
+            message: issue.message,
+        }));
+        return `Validation error: ${JSON.stringify(issues)}`;
+    }
+    if (error instanceof Error) {
+        const message = error.message;
+        // Redact sensitive patterns
+        const sensitized = message
+            .replace(/mongodb:\/\/[^@]+@/gi, 'mongodb://***@') // MongoDB credentials
+            .replace(/redis:\/\/[^@]+@/gi, 'redis://***@') // Redis credentials
+            .replace(/password[=:]["']?[^"'\s]+["']?/gi, 'password=***') // Generic passwords
+            .replace(/\/Users\/[^/]+\//g, '/****/') // User paths
+            .replace(/\/home\/[^/]+\//g, '/****/') // User paths
+            .replace(/api[_-]?key[=:]["']?[^"'\s]+["']?/gi, 'api_key=***'); // API keys
+        return sensitized;
+    }
+    return 'An unexpected error occurred';
+}
+//# sourceMappingURL=utils.js.map

package/dist/handlers/utils.js.map

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