@ratio-mcp/dev-server 1.4.5 → 1.5.1

package/dist/orchestrated-server.js

@@ -1,101 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { DEV_SERVER_NAME, DEV_SERVER_VERSION } from '@ratio-mcp/shared';
-import { allDevTools } from './tools/index.js';
-import { logger } from './utils/logger.js';
-import { checkToolPrerequisites } from './services/tool-guard.js';
-import { recordToolSuccess } from './services/session-state.js';
-/**
- * Create the Tool-First Ratio Dev MCP Server.
- *
- * Exposes all tools individually (not a single agent_chat).
- * Each tool call passes through the prerequisite guard.
- * The LLM decides what to call based on user intent and get_status output.
- *
- * Guard enforcement:
- * - If prerequisites are met → tool executes normally
- * - If prerequisites are NOT met → returns structured error with:
- *   - What's missing
- *   - The full chain of tools needed to unblock
- *   - A hint for the LLM to self-correct
- *
- * Session recording:
- * - On success, tool results are parsed to extract context (appId, scopes, etc.)
- * - This context drives future guard checks
- */
-export function createOrchestratedServer() {
-    const server = new McpServer({
-        name: `${DEV_SERVER_NAME}-orchestrated`,
-        version: DEV_SERVER_VERSION,
-    });
-    // Register all tools with guard middleware
-    for (const tool of allDevTools) {
-        const shape = tool.inputSchema.shape;
-        server.tool(tool.name, tool.description, shape, async (args) => {
-            logger.toolCall(tool.name, args);
-            const startTime = Date.now();
-            // ── Guard: check prerequisites before executing ──────────────
-            const guard = checkToolPrerequisites(tool.name);
-            if (!guard.allowed) {
-                const duration = Date.now() - startTime;
-                logger.info(`BLOCKED ${tool.name} (${duration}ms): ${guard.message}`);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                error: true,
-                                blocked: true,
-                                tool: tool.name,
-                                message: guard.message,
-                                required_tools: guard.requiredTools,
-                                chain: guard.chain,
-                                hint: guard.hint || `Call ${guard.requiredTools?.join(' → ')} first, then retry ${tool.name}.`,
-                                doc_hint: 'If you are unsure about any platform detail, call lookup_docs or get_status before proceeding.',
-                            }, null, 2),
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            // ── Execute tool ────────────────────────────────────────────
-            try {
-                const result = await tool.handler(args);
-                const duration = Date.now() - startTime;
-                logger.toolResult(tool.name, duration, result);
-                // Record success in session state
-                recordToolSuccess(tool.name, result);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify(result, null, 2),
-                        },
-                    ],
-                };
-            }
-            catch (error) {
-                const duration = Date.now() - startTime;
-                logger.toolError(tool.name, duration, error);
-                const message = error instanceof Error ? error.message : String(error);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                error: true,
-                                message,
-                                tool: tool.name,
-                                doc_hint: 'If this error is about an API detail, call lookup_docs to verify the correct usage.',
-                            }, null, 2),
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        });
-        logger.debug(`Registered tool: ${tool.name}`);
-    }
-    logger.info(`${DEV_SERVER_NAME}-orchestrated initialized with ${allDevTools.length} tools (tool-first architecture)`);
-    return server;
-}
-//# sourceMappingURL=orchestrated-server.js.map

package/dist/orchestrated-server.js.map

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

package/dist/services/orchestrator.d.ts

@@ -1,63 +0,0 @@
-/**
- * Phase definitions in the Ratio app development lifecycle.
- * Each phase represents a logical group of activities that must be completed in order.
- */
-export type Phase = 'auth' | 'app_setup' | 'requirements' | 'webhooks' | 'frontend_build' | 'review_wait' | 'publish_oauth' | 'backend_codegen' | 'complete';
-/**
- * Result returned by the orchestrator showing exactly what to do next.
- * The caller uses this to invoke the correct tool with the right arguments.
- */
-export interface OrchestratorResult {
-    phase: Phase;
-    step: string;
-    toolToCall: string;
-    toolArgs: Record<string, unknown>;
-    needsInput: boolean;
-    inputPrompt?: string;
-    inputFields?: string[];
-    message: string;
-    phase_description: string;
-    progress: {
-        current: number;
-        total: number;
-        percentage: number;
-    };
-}
-/**
- * Main orchestrator function: determines the exact next step based on session state.
- *
- * @param userInput - Optional user input (credentials, selections, configuration details)
- * @returns OrchestratorResult describing what to do next
- */
-export declare function getNextStep(userInput?: Record<string, unknown>): OrchestratorResult;
-/**
- * Get the current phase without computing the next step details.
- * Useful for status checks and phase-only queries.
- */
-export declare function getCurrentPhase(): Phase;
-/**
- * Get a human-friendly description of a phase.
- */
-export declare function getPhaseDescription(phase: Phase): string;
-/**
- * Check if a phase can be skipped by the user.
- * Currently only webhooks is optional.
- */
-export declare function canSkipPhase(phase: Phase): boolean;
-/**
- * Get the total number of steps across all phases.
- */
-export declare function getTotalSteps(): number;
-/**
- * Get metadata about a specific phase (description, step count, skippable).
- */
-export declare function getPhaseMetadata(phase: Phase): {
-    description: string;
-    skippable: boolean;
-    stepCount: number;
-};
-/**
- * Helper: Get all phases in order.
- */
-export declare function getAllPhases(): Phase[];
-//# sourceMappingURL=orchestrator.d.ts.map

package/dist/services/orchestrator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/services/orchestrator.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,MAAM,KAAK,GACb,MAAM,GACN,WAAW,GACX,cAAc,GACd,UAAU,GACV,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,UAAU,CAAC;AAEf;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAEjC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAGb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGlC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAGvB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAoyBD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,CA2CnF;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAEvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK;iBAl3B9B,MAAM;eACR,OAAO;eACP,MAAM;EAk3BlB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,KAAK,EAAE,CAKtC"}