@moda-ai/cli 1.0.4 → 1.0.5

package/dist/http-server.js

@@ -1,74 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import express from 'express';
-import cors from 'cors';
-import { validateConfig, PORT, VERSION } from './config.js';
-import { getToolDefinitions } from './tools.js';
-import { handleToolCall } from './handlers.js';
-validateConfig();
-const app = express();
-const allowedOrigins = process.env.ALLOWED_ORIGINS?.split(',').map((o) => o.trim());
-app.use(cors(allowedOrigins
-    ? { origin: allowedOrigins }
-    : undefined));
-app.use(express.json());
-const transports = new Map();
-app.get('/health', (_req, res) => {
-    res.json({ status: 'ok', service: 'moda-cli', version: VERSION });
-});
-app.get('/mcp/sse', async (req, res) => {
-    console.log('Client connected to SSE endpoint');
-    const transport = new SSEServerTransport('/mcp/messages', res);
-    transports.set(transport.sessionId, transport);
-    const server = new Server({ name: 'moda-data-api', version: VERSION }, { capabilities: { tools: {} } });
-    server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: getToolDefinitions(),
-    }));
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        const { name, arguments: args } = request.params;
-        return handleToolCall(name, args);
-    });
-    await server.connect(transport);
-    req.on('close', () => {
-        console.log('Client disconnected');
-        transports.delete(transport.sessionId);
-        server.close();
-    });
-});
-app.post('/mcp/messages', express.text(), async (req, res) => {
-    const sessionId = req.query.sessionId;
-    const transport = transports.get(sessionId);
-    if (!transport) {
-        res.status(404).end('Session not found');
-        return;
-    }
-    await transport.handlePostMessage(req, res);
-});
-const server = app.listen(PORT, () => {
-    console.log(`Moda MCP Server (HTTP) running on http://localhost:${PORT}`);
-    console.log(`  SSE endpoint: http://localhost:${PORT}/mcp/sse`);
-    console.log(`  Health check: http://localhost:${PORT}/health`);
-});
-function shutdown() {
-    console.log('Shutting down...');
-    for (const [id, transport] of transports) {
-        try {
-            transport.close?.();
-        }
-        catch {
-            // ignore close errors during shutdown
-        }
-        transports.delete(id);
-    }
-    server.close(() => {
-        console.log('Server stopped');
-        process.exit(0);
-    });
-    // Force exit after 10s if connections don't close
-    setTimeout(() => process.exit(1), 10_000).unref();
-}
-process.on('SIGTERM', shutdown);
-process.on('SIGINT', shutdown);
-//# sourceMappingURL=http-server.js.map

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { validateConfig } from './config.js';
-import { getToolDefinitions } from './tools.js';
-import { handleToolCall } from './handlers.js';
-validateConfig();
-const server = new Server({ name: 'moda-data-api', version: '1.0.0' }, { capabilities: { tools: {} } });
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: getToolDefinitions(),
-}));
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    return handleToolCall(name, args);
-});
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error('Moda Data API MCP server running on stdio');
-}
-main().catch((error) => {
-    console.error('Fatal error:', error);
-    process.exit(1);
-});
-//# sourceMappingURL=index.js.map

package/dist/tools.d.ts

@@ -1,260 +0,0 @@
-export declare function getToolDefinitions(): ({
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            days_back: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            parent_id?: undefined;
-            time_range?: undefined;
-            node_id?: undefined;
-            limit?: undefined;
-            offset?: undefined;
-            search?: undefined;
-            cluster_id?: undefined;
-            user_id?: undefined;
-            environment?: undefined;
-            conversation_id?: undefined;
-            msg_index?: undefined;
-            window?: undefined;
-            tool_name?: undefined;
-            subtype?: undefined;
-        };
-        required?: undefined;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            parent_id: {
-                type: string;
-                description: string;
-            };
-            time_range: {
-                type: string;
-                enum: string[];
-                description: string;
-                default: string;
-            };
-            days_back?: undefined;
-            node_id?: undefined;
-            limit?: undefined;
-            offset?: undefined;
-            search?: undefined;
-            cluster_id?: undefined;
-            user_id?: undefined;
-            environment?: undefined;
-            conversation_id?: undefined;
-            msg_index?: undefined;
-            window?: undefined;
-            tool_name?: undefined;
-            subtype?: undefined;
-        };
-        required?: undefined;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            node_id: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            offset: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            days_back?: undefined;
-            parent_id?: undefined;
-            time_range?: undefined;
-            search?: undefined;
-            cluster_id?: undefined;
-            user_id?: undefined;
-            environment?: undefined;
-            conversation_id?: undefined;
-            msg_index?: undefined;
-            window?: undefined;
-            tool_name?: undefined;
-            subtype?: undefined;
-        };
-        required: string[];
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            search: {
-                type: string;
-                description: string;
-            };
-            cluster_id: {
-                type: string;
-                description: string;
-            };
-            user_id: {
-                type: string;
-                description: string;
-            };
-            time_range: {
-                type: string;
-                enum: string[];
-                description: string;
-                default: string;
-            };
-            environment: {
-                type: string;
-                enum: string[];
-                description: string;
-                default: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            offset: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            days_back?: undefined;
-            parent_id?: undefined;
-            node_id?: undefined;
-            conversation_id?: undefined;
-            msg_index?: undefined;
-            window?: undefined;
-            tool_name?: undefined;
-            subtype?: undefined;
-        };
-        required?: undefined;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            conversation_id: {
-                type: string;
-                description: string;
-            };
-            msg_index: {
-                type: string;
-                description: string;
-            };
-            window: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            days_back?: undefined;
-            parent_id?: undefined;
-            time_range?: undefined;
-            node_id?: undefined;
-            limit?: undefined;
-            offset?: undefined;
-            search?: undefined;
-            cluster_id?: undefined;
-            user_id?: undefined;
-            environment?: undefined;
-            tool_name?: undefined;
-            subtype?: undefined;
-        };
-        required: string[];
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            days_back: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            limit: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            offset: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            parent_id?: undefined;
-            time_range?: undefined;
-            node_id?: undefined;
-            search?: undefined;
-            cluster_id?: undefined;
-            user_id?: undefined;
-            environment?: undefined;
-            conversation_id?: undefined;
-            msg_index?: undefined;
-            window?: undefined;
-            tool_name?: undefined;
-            subtype?: undefined;
-        };
-        required?: undefined;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            tool_name: {
-                type: string;
-                description: string;
-            };
-            subtype: {
-                type: string;
-                description: string;
-            };
-            days_back: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            limit: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            offset: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            parent_id?: undefined;
-            time_range?: undefined;
-            node_id?: undefined;
-            search?: undefined;
-            cluster_id?: undefined;
-            user_id?: undefined;
-            environment?: undefined;
-            conversation_id?: undefined;
-            msg_index?: undefined;
-            window?: undefined;
-        };
-        required: string[];
-    };
-})[];
-//# sourceMappingURL=tools.d.ts.map

package/dist/tools.js

@@ -1,133 +0,0 @@
-// src/tools.ts
-export function getToolDefinitions() {
-    return [
-        {
-            name: 'moda_get_overview',
-            description: 'Get dashboard overview with KPIs, top clusters, and recent activity. Start here to understand the current state of your conversations.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    days_back: {
-                        type: 'number',
-                        description: 'Number of days to look back (1-90)',
-                        default: 7,
-                    },
-                },
-            },
-        },
-        {
-            name: 'moda_get_clusters',
-            description: 'Browse the topic cluster hierarchy. Omit parent_id to get root-level categories, or provide it to drill down.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    parent_id: {
-                        type: 'string',
-                        description: 'Parent node ID to list children of (omit for root)',
-                    },
-                    time_range: {
-                        type: 'string',
-                        // FIX: expanded enum to match backend
-                        enum: ['all', '1h', '3d', '7d', '24h', '30d', '90d'],
-                        description: 'Time range filter',
-                        default: 'all',
-                    },
-                },
-            },
-        },
-        {
-            name: 'moda_get_cluster_conversations',
-            description: 'List conversations belonging to a specific cluster. Use node_id from cluster listing.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    node_id: { type: 'string', description: 'Cluster node ID' },
-                    limit: { type: 'number', description: 'Max results per page (1-100)', default: 10 },
-                    offset: { type: 'number', description: 'Pagination offset', default: 0 },
-                },
-                required: ['node_id'],
-            },
-        },
-        {
-            name: 'moda_search_conversations',
-            // FIX: note that cluster_id filtering is not yet implemented in backend
-            description: 'Search and filter conversations. Supports full-text search, filtering by user, time range, and environment.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    search: { type: 'string', description: 'Full-text search in summaries' },
-                    cluster_id: { type: 'string', description: 'Filter by cluster node ID (not yet implemented)' },
-                    user_id: { type: 'string', description: 'Filter by user ID' },
-                    time_range: {
-                        type: 'string',
-                        // FIX: add '3d' to match backend
-                        enum: ['all', '1h', '3d', '24h', '7d', '30d', '90d'],
-                        description: 'Time range filter',
-                        default: 'all',
-                    },
-                    environment: {
-                        type: 'string',
-                        enum: ['all', 'development', 'staging', 'production'],
-                        description: 'Environment filter',
-                        default: 'all',
-                    },
-                    limit: { type: 'number', description: 'Max results per page (1-100)', default: 20 },
-                    offset: { type: 'number', description: 'Pagination offset', default: 0 },
-                },
-            },
-        },
-        {
-            name: 'moda_get_conversation_context',
-            description: 'Get windowed conversation context (max 5 messages). Returns summary and messages around a center point.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    conversation_id: { type: 'string', description: 'Conversation ID' },
-                    msg_index: { type: 'number', description: 'Message index to center on (0-indexed, omit for middle)' },
-                    window: { type: 'number', description: 'Messages before and after center (1-5)', default: 2 },
-                },
-                required: ['conversation_id'],
-            },
-        },
-        {
-            name: 'moda_get_frustrations',
-            description: 'Get user frustration detections with inline conversation evidence, signal breakdown, and user quotes. Returns frustrated + at-risk conversations.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    days_back: { type: 'number', description: 'Number of days to look back (1-90)', default: 7 },
-                    // FIX: corrected max from 100 to 20
-                    limit: { type: 'number', description: 'Max results per page (1-20)', default: 10 },
-                    offset: { type: 'number', description: 'Pagination offset', default: 0 },
-                },
-            },
-        },
-        {
-            name: 'moda_get_tool_failures',
-            description: 'Get tool failure overview showing which tools are failing and how much. Start here before drilling into specific tools.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    days_back: { type: 'number', description: 'Number of days to look back (1-90)', default: 7 },
-                },
-            },
-        },
-        {
-            name: 'moda_get_tool_failure_detail',
-            description: 'Get per-tool failure detail with subtype breakdown and examples with inline conversation context. Use tool_name from overview.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    tool_name: { type: 'string', description: 'Name of the tool to inspect' },
-                    subtype: { type: 'string', description: 'Filter by error subtype (optional)' },
-                    days_back: { type: 'number', description: 'Number of days to look back (1-90)', default: 7 },
-                    // FIX: corrected max from 100 to 20
-                    limit: { type: 'number', description: 'Max examples to return (1-20)', default: 5 },
-                    offset: { type: 'number', description: 'Pagination offset', default: 0 },
-                },
-                required: ['tool_name'],
-            },
-        },
-    ];
-}
-//# sourceMappingURL=tools.js.map

package/dist/worker.d.ts

@@ -1,9 +0,0 @@
-export interface Env {
-    MODA_API_KEY: string;
-    MODA_BASE_URL: string;
-}
-declare const _default: {
-    fetch(request: Request, env: Env): Promise<Response>;
-};
-export default _default;
-//# sourceMappingURL=worker.d.ts.map

package/dist/worker.js

@@ -1,24 +0,0 @@
-// src/worker.ts
-// Cloudflare Workers entry point for the MCP HTTP/SSE transport.
-//
-// NOTE: The MCP SDK's SSEServerTransport expects an Express Response object,
-// which is incompatible with the Cloudflare Workers fetch handler model.
-// Full SSE support requires either the MCP SDK's StreamableHTTPServerTransport
-// or a custom adapter. This file provides the skeleton and a /health endpoint
-// that works today; SSE transport implementation is tracked as a follow-up.
-import { getToolDefinitions } from './tools.js';
-export default {
-    async fetch(request, env) {
-        const url = new URL(request.url);
-        if (url.pathname === '/health') {
-            return new Response(JSON.stringify({ status: 'ok', service: 'moda-mcp' }), { headers: { 'Content-Type': 'application/json' } });
-        }
-        if (url.pathname === '/tools' && request.method === 'GET') {
-            return new Response(JSON.stringify({ tools: getToolDefinitions() }), { headers: { 'Content-Type': 'application/json' } });
-        }
-        // SSE/MCP streaming transport handling is deferred pending SDK compatibility
-        // investigation. See Phase 3 open question in implementation plan.
-        return new Response('Not Found', { status: 404 });
-    },
-};
-//# sourceMappingURL=worker.js.map

package/mcp-config.example.json

@@ -1,12 +0,0 @@
-{
-  "mcpServers": {
-    "moda-data-api": {
-      "command": "node",
-      "args": ["/absolute/path/to/apps/moda-cli/dist/index.js"],
-      "env": {
-        "MODA_API_KEY": "moda_sk_your_api_key_here"
-      },
-      "comment": "Uses production API (https://modaflows.com) by default. For local dev, add: \"MODA_BASE_URL\": \"http://localhost:3001\""
-    }
-  }
-}