@moda-ai/cli 1.0.0

package/dist/http-server.js

@@ -0,0 +1,74 @@
+#!/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

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

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/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/schemas.d.ts

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+export declare const OverviewSchema: z.ZodObject<{
+    days_back: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    days_back?: number | undefined;
+}, {
+    days_back?: number | undefined;
+}>;
+export declare const ClustersSchema: z.ZodObject<{
+    parent_id: z.ZodOptional<z.ZodString>;
+    time_range: z.ZodOptional<z.ZodDefault<z.ZodEnum<["all", "1h", "3d", "7d", "24h", "30d", "90d"]>>>;
+}, "strip", z.ZodTypeAny, {
+    parent_id?: string | undefined;
+    time_range?: "all" | "1h" | "3d" | "7d" | "24h" | "30d" | "90d" | undefined;
+}, {
+    parent_id?: string | undefined;
+    time_range?: "all" | "1h" | "3d" | "7d" | "24h" | "30d" | "90d" | undefined;
+}>;
+export declare const ClusterConversationsSchema: z.ZodObject<{
+    node_id: z.ZodString;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    offset: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    node_id: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    node_id: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare const ConversationsSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    cluster_id: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodString>;
+    time_range: z.ZodOptional<z.ZodDefault<z.ZodEnum<["all", "1h", "3d", "24h", "7d", "30d", "90d"]>>>;
+    environment: z.ZodOptional<z.ZodDefault<z.ZodEnum<["all", "development", "staging", "production"]>>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    offset: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    time_range?: "all" | "1h" | "3d" | "7d" | "24h" | "30d" | "90d" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    search?: string | undefined;
+    cluster_id?: string | undefined;
+    user_id?: string | undefined;
+    environment?: "all" | "development" | "staging" | "production" | undefined;
+}, {
+    time_range?: "all" | "1h" | "3d" | "7d" | "24h" | "30d" | "90d" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    search?: string | undefined;
+    cluster_id?: string | undefined;
+    user_id?: string | undefined;
+    environment?: "all" | "development" | "staging" | "production" | undefined;
+}>;
+export declare const ContextSchema: z.ZodObject<{
+    conversation_id: z.ZodString;
+    msg_index: z.ZodOptional<z.ZodNumber>;
+    window: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    conversation_id: string;
+    msg_index?: number | undefined;
+    window?: number | undefined;
+}, {
+    conversation_id: string;
+    msg_index?: number | undefined;
+    window?: number | undefined;
+}>;
+export declare const FrustrationsSchema: z.ZodObject<{
+    days_back: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    offset: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    days_back?: number | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    days_back?: number | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare const ToolFailuresSchema: z.ZodObject<{
+    days_back: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    days_back?: number | undefined;
+}, {
+    days_back?: number | undefined;
+}>;
+export declare const ToolFailureDetailSchema: z.ZodObject<{
+    tool_name: z.ZodString;
+    subtype: z.ZodOptional<z.ZodString>;
+    days_back: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    offset: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    tool_name: string;
+    days_back?: number | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    subtype?: string | undefined;
+}, {
+    tool_name: string;
+    days_back?: number | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    subtype?: string | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.js

@@ -0,0 +1,48 @@
+// src/schemas.ts
+import { z } from 'zod';
+export const OverviewSchema = z.object({
+    days_back: z.number().min(1).max(90).default(7).optional(),
+});
+// FIX: Add '1h', '24h', '90d' to match backend ClustersQueryDto
+export const ClustersSchema = z.object({
+    parent_id: z.string().optional(),
+    time_range: z.enum(['all', '1h', '3d', '7d', '24h', '30d', '90d']).default('all').optional(),
+});
+export const ClusterConversationsSchema = z.object({
+    node_id: z.string(),
+    limit: z.number().min(1).max(100).default(10).optional(),
+    offset: z.number().min(0).default(0).optional(),
+});
+// FIX: Add '3d' to match backend ConversationsQueryDto
+export const ConversationsSchema = z.object({
+    search: z.string().optional(),
+    cluster_id: z.string().optional(),
+    user_id: z.string().optional(),
+    time_range: z.enum(['all', '1h', '3d', '24h', '7d', '30d', '90d']).default('all').optional(),
+    environment: z.enum(['all', 'development', 'staging', 'production']).default('all').optional(),
+    limit: z.number().min(1).max(100).default(20).optional(),
+    offset: z.number().min(0).default(0).optional(),
+});
+export const ContextSchema = z.object({
+    conversation_id: z.string(),
+    msg_index: z.number().min(0).optional(),
+    window: z.number().min(1).max(5).default(2).optional(),
+});
+// FIX: Change limit max from 100 to 20 to match backend clamp
+export const FrustrationsSchema = z.object({
+    days_back: z.number().min(1).max(90).default(7).optional(),
+    limit: z.number().min(1).max(20).default(10).optional(),
+    offset: z.number().min(0).default(0).optional(),
+});
+export const ToolFailuresSchema = z.object({
+    days_back: z.number().min(1).max(90).default(7).optional(),
+});
+// FIX: Change limit max from 100 to 20 to match backend clamp
+export const ToolFailureDetailSchema = z.object({
+    tool_name: z.string(),
+    subtype: z.string().optional(),
+    days_back: z.number().min(1).max(90).default(7).optional(),
+    limit: z.number().min(1).max(20).default(5).optional(),
+    offset: z.number().min(0).default(0).optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools.d.ts

@@ -0,0 +1,260 @@
+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

@@ -0,0 +1,133 @@
+// 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

@@ -0,0 +1,9 @@
+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