@ratio-mcp/dev-server 1.0.0 → 1.1.0

package/dist/tools/webhooks.js

@@ -0,0 +1,303 @@
+import { z } from 'zod';
+import axios from 'axios';
+import { RATIO_API_BASE_URL } from '@ratio-mcp/shared';
+import { developerApiRequest } from '../api/developer.js';
+import { logger } from '../utils/logger.js';
+import { getSession } from '../services/session-state.js';
+// ─── Scope-to-Webhook Event Mapping ─────────────────────────────────────────
+//
+// Maps OAuth scopes to their relevant webhook event categories.
+// When a developer confirms scopes (e.g. read_orders), we auto-suggest the
+// matching webhook events (e.g. app.ecosystem.order.*).
+//
+// This mapping doesn't exist in the backend — it's agent-level intelligence.
+//
+const SCOPE_TO_EVENT_PREFIX = {
+    // Order scopes → order events
+    read_orders: ['app.ecosystem.order'],
+    write_orders: ['app.ecosystem.order'],
+    // Product scopes → product events
+    read_products: ['app.ecosystem.product'],
+    write_products: ['app.ecosystem.product'],
+    // Customer scopes → customer events
+    read_customers: ['app.ecosystem.customer'],
+    write_customers: ['app.ecosystem.customer'],
+    // Inventory scopes → inventory events
+    read_inventory: ['app.ecosystem.inventory'],
+    write_inventory: ['app.ecosystem.inventory'],
+    // Fulfillment scopes → fulfillment events
+    read_fulfillments: ['app.ecosystem.fulfillment'],
+    write_fulfillments: ['app.ecosystem.fulfillment'],
+    // Discount / price rule scopes → no direct webhook events yet
+    read_discounts: [],
+    write_discounts: [],
+};
+/**
+ * Given a list of confirmed scopes, return the event name prefixes that are relevant.
+ */
+function getRelevantEventPrefixes(scopes) {
+    const prefixes = new Set();
+    for (const scope of scopes) {
+        const mapped = SCOPE_TO_EVENT_PREFIX[scope];
+        if (mapped) {
+            for (const prefix of mapped)
+                prefixes.add(prefix);
+        }
+    }
+    return [...prefixes];
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Fetch event definitions from the admin setup endpoint.
+ * This endpoint has no auth guard — it returns the event category config.
+ */
+async function fetchEventDefinitions() {
+    const url = `${RATIO_API_BASE_URL}/admin/webhook-setup/event-definitions`;
+    logger.apiRequest('GET', url);
+    const startTime = Date.now();
+    try {
+        const response = await axios.get(url, {
+            headers: { Accept: 'application/json' },
+        });
+        const duration = Date.now() - startTime;
+        logger.apiResponse('GET', url, response.status, duration);
+        return response.data;
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        if (axios.isAxiosError(error)) {
+            logger.apiError('GET', url, error.response?.status, duration, error.response?.data);
+        }
+        throw error;
+    }
+}
+// ─── Tools ──────────────────────────────────────────────────────────────────
+export const webhookTools = [
+    // ────────────────────────────────────────────────────────────────────────
+    // 1. get_webhook_topics
+    // ────────────────────────────────────────────────────────────────────────
+    {
+        name: 'get_webhook_topics',
+        description: 'Fetch available webhook events and auto-suggest relevant ones based on the app\'s confirmed scopes. ' +
+            'Must be called AFTER define_app_requirements (scopes confirmed). ' +
+            'Shows the developer which events match their scopes and asks for their webhook endpoint URL.',
+        inputSchema: z.object({}),
+        handler: async () => {
+            logger.info('Fetching webhook event definitions (scope-aware)');
+            const data = await fetchEventDefinitions();
+            const session = getSession();
+            const confirmedScopes = session.context.confirmedScopes || [];
+            const relevantPrefixes = getRelevantEventPrefixes(confirmedScopes);
+            // Separate events into recommended (matches scopes) and other
+            const recommended = [];
+            const other = [];
+            for (const cat of data.categories) {
+                for (const evt of cat.events) {
+                    const matchedPrefix = relevantPrefixes.find((p) => evt.name.startsWith(p));
+                    if (matchedPrefix) {
+                        // Find which scope triggered this match
+                        const matchedScope = confirmedScopes.find((s) => {
+                            const prefixes = SCOPE_TO_EVENT_PREFIX[s] || [];
+                            return prefixes.includes(matchedPrefix);
+                        });
+                        recommended.push({
+                            event_name: evt.name,
+                            display_name: evt.displayName,
+                            description: evt.description,
+                            matched_scope: matchedScope || 'unknown',
+                        });
+                    }
+                    else {
+                        other.push({
+                            event_name: evt.name,
+                            display_name: evt.displayName,
+                            description: evt.description,
+                        });
+                    }
+                }
+            }
+            return {
+                success: true,
+                confirmed_scopes: confirmedScopes,
+                recommended_events: recommended,
+                recommended_count: recommended.length,
+                other_available_events: other,
+                other_count: other.length,
+                _instruction: 'Show the developer the RECOMMENDED events first — these match their selected scopes. ' +
+                    'Tell them: "Based on your scopes, I recommend subscribing to these webhook events:" ' +
+                    'and list the recommended events. Then mention there are other events available if they want more. ' +
+                    'Ask for their HTTPS webhook endpoint URL. Then call create_webhooks with the selected events.',
+            };
+        },
+    },
+    // ────────────────────────────────────────────────────────────────────────
+    // 2. create_webhooks
+    // ────────────────────────────────────────────────────────────────────────
+    {
+        name: 'create_webhooks',
+        description: 'Create webhook subscriptions for an app (bulk). Registers a webhook endpoint URL ' +
+            'for multiple event types at once. ' +
+            'PREREQUISITES:\n' +
+            '1. Call get_webhook_topics first and let the developer choose events\n' +
+            '2. Ask the developer for their HTTPS webhook endpoint URL\n' +
+            'Only call create_webhooks after both are answered.',
+        inputSchema: z.object({
+            app_id: z.string().min(1).describe('Application ID'),
+            webhook_url: z
+                .string()
+                .url()
+                .describe('HTTPS URL that will receive webhook POST requests. ' +
+                'MUST ask the developer for this URL. Example: https://api.yourapp.com/webhooks'),
+            event_names: z
+                .array(z.string())
+                .min(1)
+                .max(50)
+                .describe('Array of event names to subscribe to (from get_webhook_topics). ' +
+                'Example: ["app.ecosystem.product.created", "app.ecosystem.order.created"]'),
+            secret_key: z
+                .string()
+                .min(16)
+                .max(256)
+                .optional()
+                .describe('Optional HMAC-SHA256 secret for signature verification (min 16 chars). Auto-generated if not provided.'),
+            name: z.string().max(255).optional().describe('Optional friendly name for this webhook endpoint'),
+        }),
+        handler: async (input) => {
+            const inp = input;
+            logger.info(`Creating webhooks for app ${inp.app_id}: ${inp.event_names.length} events → ${inp.webhook_url}`);
+            const body = {
+                webhookUrl: inp.webhook_url,
+                eventNames: inp.event_names,
+            };
+            if (inp.secret_key)
+                body['secretKey'] = inp.secret_key;
+            if (inp.name)
+                body['name'] = inp.name;
+            const response = await developerApiRequest('POST', `/app-webhooks/developer/${inp.app_id}/bulk`, body);
+            const createdCount = response.created?.length ?? 0;
+            const skippedCount = response.skipped?.length ?? 0;
+            const errorCount = response.errors?.length ?? 0;
+            const summary = [];
+            if (createdCount > 0)
+                summary.push(`${createdCount} webhooks created`);
+            if (skippedCount > 0)
+                summary.push(`${skippedCount} already existed (skipped)`);
+            if (errorCount > 0)
+                summary.push(`${errorCount} failed`);
+            return {
+                success: createdCount > 0,
+                message: summary.join(', ') || 'No webhooks created',
+                created: createdCount,
+                skipped: skippedCount,
+                errors: errorCount,
+                webhook_url: inp.webhook_url,
+                created_events: response.created?.map((w) => w.eventName) ?? [],
+                skipped_events: response.skipped ?? [],
+                error_details: response.errors ?? [],
+                next_steps: [
+                    'Webhooks are now configured as defaults for your app.',
+                    'When a merchant installs your app, these webhooks will be automatically activated.',
+                    'You can manage webhooks with list_webhooks, toggle_webhook, and delete_webhook.',
+                ],
+            };
+        },
+    },
+    // ────────────────────────────────────────────────────────────────────────
+    // 3. list_webhooks
+    // ────────────────────────────────────────────────────────────────────────
+    {
+        name: 'list_webhooks',
+        description: 'List all webhook subscriptions configured for an app. Shows endpoint URLs, ' +
+            'subscribed events, and active/inactive status.',
+        inputSchema: z.object({
+            app_id: z.string().min(1).describe('Application ID'),
+        }),
+        handler: async (input) => {
+            const { app_id } = input;
+            logger.info(`Listing webhooks for app ${app_id}`);
+            const response = await developerApiRequest('GET', `/app-webhooks/developer/${app_id}`);
+            // Handle both array and wrapped response formats
+            const webhooks = Array.isArray(response)
+                ? response
+                : response.data ?? [];
+            // Group by URL for cleaner display
+            const byUrl = new Map();
+            for (const wh of webhooks) {
+                const url = wh.defaultUrl || wh.webhookUrl || 'unknown';
+                if (!byUrl.has(url))
+                    byUrl.set(url, []);
+                byUrl.get(url).push(wh);
+            }
+            return {
+                success: true,
+                total_webhooks: webhooks.length,
+                total_endpoints: byUrl.size,
+                endpoints: Array.from(byUrl.entries()).map(([url, whs]) => ({
+                    url,
+                    event_count: whs.length,
+                    events: whs.map((w) => ({
+                        id: w.id,
+                        event_name: w.eventName,
+                        active: w.isActive ?? w.active ?? true,
+                        name: w.name || null,
+                        failure_count: w.failureCount ?? 0,
+                    })),
+                })),
+            };
+        },
+    },
+    // ────────────────────────────────────────────────────────────────────────
+    // 4. toggle_webhook
+    // ────────────────────────────────────────────────────────────────────────
+    {
+        name: 'toggle_webhook',
+        description: 'Enable or disable a specific webhook subscription. ' +
+            'Use list_webhooks first to get the webhook ID.',
+        inputSchema: z.object({
+            webhook_id: z.string().min(1).describe('Webhook ID (from list_webhooks)'),
+        }),
+        handler: async (input) => {
+            const { webhook_id } = input;
+            logger.info(`Toggling webhook ${webhook_id}`);
+            const response = await developerApiRequest('PATCH', `/app-webhooks/developer/webhook/${webhook_id}/toggle`);
+            const isActive = response.isActive ?? response.active;
+            return {
+                success: true,
+                webhook_id: response.id || webhook_id,
+                event_name: response.eventName || null,
+                active: isActive,
+                message: `Webhook ${isActive ? 'enabled' : 'disabled'} successfully`,
+            };
+        },
+    },
+    // ────────────────────────────────────────────────────────────────────────
+    // 5. delete_webhook
+    // ────────────────────────────────────────────────────────────────────────
+    {
+        name: 'delete_webhook',
+        description: 'Delete a webhook subscription. This action cannot be undone. ' +
+            'Use list_webhooks first to get the webhook ID.',
+        inputSchema: z.object({
+            webhook_id: z.string().min(1).describe('Webhook ID to delete (from list_webhooks)'),
+            confirm: z
+                .boolean()
+                .describe('Set to true to confirm deletion. MUST ask the developer before deleting.'),
+        }),
+        handler: async (input) => {
+            const { webhook_id, confirm } = input;
+            if (!confirm) {
+                return {
+                    success: false,
+                    message: 'Deletion not confirmed. Set confirm: true to proceed.',
+                };
+            }
+            logger.info(`Deleting webhook ${webhook_id}`);
+            await developerApiRequest('DELETE', `/app-webhooks/developer/webhook/${webhook_id}`);
+            return {
+                success: true,
+                message: `Webhook ${webhook_id} deleted successfully`,
+            };
+        },
+    },
+];
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

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

package/dist/utils/logger.d.ts

@@ -1,12 +1,18 @@
 /**
- * Simple logger that writes to stderr (MCP servers use stdout for protocol messages).
- * Timestamps included for tracing tool execution duration.
+ * Logger that writes to BOTH stderr (for MCP protocol) AND a persistent log file.
+ * The log file is stored in the mcp-v2 root so you can review the full flow after testing.
  */
+declare const LOG_FILE: string;
 /**
- * Safely stringify objects for logging, truncating to maxLen to avoid flooding stderr.
+ * Safely stringify objects for logging, truncating to maxLen to avoid flooding.
  * Redacts sensitive fields (passwords, tokens, secrets).
  */
 declare function safeStringify(obj: unknown, maxLen?: number): string;
+/**
+ * Full stringify WITHOUT redaction — for the log file only (not stderr).
+ * This lets you see actual values like client_id, merchant_id, scopes when debugging.
+ */
+declare function fullStringify(obj: unknown, maxLen?: number): string;
 export declare const logger: {
     info: (message: string, ...args: unknown[]) => void;
     warn: (message: string, ...args: unknown[]) => void;
@@ -21,9 +27,13 @@ export declare const logger: {
     /** Log an outgoing API request to the backend */
     apiRequest: (method: string, url: string, data?: unknown) => void;
     /** Log a successful API response */
-    apiResponse: (method: string, url: string, status: number, durationMs: number) => void;
+    apiResponse: (method: string, url: string, status: number, durationMs: number, responseData?: unknown) => void;
     /** Log a failed API response */
     apiError: (method: string, url: string, status: number | undefined, durationMs: number, errorBody?: unknown) => void;
+    /** Log session state snapshots for debugging flow issues */
+    sessionSnapshot: (label: string, context: Record<string, unknown>) => void;
+    /** Separator for clarity between flow phases */
+    phase: (phaseName: string, details?: string) => void;
 };
-export { safeStringify };
+export { safeStringify, fullStringify, LOG_FILE };
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,iBAAS,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,SAAO,GAAG,MAAM,CAgB1D;AAED,eAAO,MAAM,MAAM;oBACD,MAAM,WAAW,OAAO,EAAE;oBAG1B,MAAM,WAAW,OAAO,EAAE;qBAGzB,MAAM,WAAW,OAAO,EAAE;qBAG1B,MAAM,WAAW,OAAO,EAAE;IAM3C,0DAA0D;yBACrC,MAAM,SAAS,OAAO;IAI3C,mCAAmC;2BACZ,MAAM,cAAc,MAAM,UAAU,OAAO;IAIlE,kCAAkC;0BACZ,MAAM,cAAc,MAAM,SAAS,OAAO;IAMhE,iDAAiD;yBAC5B,MAAM,OAAO,MAAM,SAAS,OAAO;IAKxD,oCAAoC;0BACd,MAAM,OAAO,MAAM,UAAU,MAAM,cAAc,MAAM;IAI7E,gCAAgC;uBACb,MAAM,OAAO,MAAM,UAAU,MAAM,GAAG,SAAS,cAAc,MAAM,cAAc,OAAO;CAG5G,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,QAAA,MAAM,QAAQ,QAAmC,CAAC;AA0BlD;;;GAGG;AACH,iBAAS,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,SAAO,GAAG,MAAM,CAgB1D;AAED;;;GAGG;AACH,iBAAS,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,SAAO,GAAG,MAAM,CAU1D;AAED,eAAO,MAAM,MAAM;oBACD,MAAM,WAAW,OAAO,EAAE;oBAK1B,MAAM,WAAW,OAAO,EAAE;qBAKzB,MAAM,WAAW,OAAO,EAAE;qBAK1B,MAAM,WAAW,OAAO,EAAE;IAS3C,0DAA0D;yBACrC,MAAM,SAAS,OAAO;IAO3C,mCAAmC;2BACZ,MAAM,cAAc,MAAM,UAAU,OAAO;IAOlE,kCAAkC;0BACZ,MAAM,cAAc,MAAM,SAAS,OAAO;IAUhE,iDAAiD;yBAC5B,MAAM,OAAO,MAAM,SAAS,OAAO;IAOxD,oCAAoC;0BACd,MAAM,OAAO,MAAM,UAAU,MAAM,cAAc,MAAM,iBAAiB,OAAO;IAKrG,gCAAgC;uBACb,MAAM,OAAO,MAAM,UAAU,MAAM,GAAG,SAAS,cAAc,MAAM,cAAc,OAAO;IAM3G,4DAA4D;6BACnC,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKjE,gDAAgD;uBAC7B,MAAM,YAAY,MAAM;CAK5C,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC"}

package/dist/utils/logger.js

@@ -1,15 +1,43 @@
 /**
- * Simple logger that writes to stderr (MCP servers use stdout for protocol messages).
- * Timestamps included for tracing tool execution duration.
+ * Logger that writes to BOTH stderr (for MCP protocol) AND a persistent log file.
+ * The log file is stored in the mcp-v2 root so you can review the full flow after testing.
  */
+import { appendFileSync, existsSync, mkdirSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Log file lives in ratio-mcp-v2/logs/dev-server.log
+const LOGS_DIR = resolve(__dirname, '..', '..', '..', '..', 'logs');
+const LOG_FILE = join(LOGS_DIR, 'dev-server.log');
+// Ensure logs directory exists
+try {
+    if (!existsSync(LOGS_DIR)) {
+        mkdirSync(LOGS_DIR, { recursive: true });
+    }
+}
+catch { /* ignore — will retry on first write */ }
 function timestamp() {
     return new Date().toISOString();
 }
 /**
- * Safely stringify objects for logging, truncating to maxLen to avoid flooding stderr.
+ * Write a line to the persistent log file.
+ * Never throws — logging failures should not break the app.
+ */
+function writeToFile(line) {
+    try {
+        if (!existsSync(LOGS_DIR)) {
+            mkdirSync(LOGS_DIR, { recursive: true });
+        }
+        appendFileSync(LOG_FILE, line + '\n', 'utf-8');
+    }
+    catch { /* swallow — don't break app for logging */ }
+}
+/**
+ * Safely stringify objects for logging, truncating to maxLen to avoid flooding.
  * Redacts sensitive fields (passwords, tokens, secrets).
  */
-function safeStringify(obj, maxLen = 2000) {
+function safeStringify(obj, maxLen = 4000) {
     const REDACTED_KEYS = ['password', 'token', 'secret', 'client_secret', 'access_token', 'refresh_token', 'authorization'];
     try {
         const str = JSON.stringify(obj, (key, value) => {
@@ -27,48 +55,99 @@ function safeStringify(obj, maxLen = 2000) {
         return String(obj);
     }
 }
+/**
+ * Full stringify WITHOUT redaction — for the log file only (not stderr).
+ * This lets you see actual values like client_id, merchant_id, scopes when debugging.
+ */
+function fullStringify(obj, maxLen = 8000) {
+    try {
+        const str = JSON.stringify(obj, null, 2);
+        if (str && str.length > maxLen) {
+            return str.substring(0, maxLen) + `...[truncated, total ${str.length} chars]`;
+        }
+        return str || '';
+    }
+    catch {
+        return String(obj);
+    }
+}
 export const logger = {
     info: (message, ...args) => {
-        console.error(`[ratio-dev] ${timestamp()} INFO: ${message}`, ...args);
+        const line = `[ratio-dev] ${timestamp()} INFO: ${message}${args.length ? ' ' + args.map(a => safeStringify(a)).join(' ') : ''}`;
+        console.error(line);
+        writeToFile(line);
     },
     warn: (message, ...args) => {
-        console.error(`[ratio-dev] ${timestamp()} WARN: ${message}`, ...args);
+        const line = `[ratio-dev] ${timestamp()} WARN: ${message}${args.length ? ' ' + args.map(a => safeStringify(a)).join(' ') : ''}`;
+        console.error(line);
+        writeToFile(line);
     },
     error: (message, ...args) => {
-        console.error(`[ratio-dev] ${timestamp()} ERROR: ${message}`, ...args);
+        const line = `[ratio-dev] ${timestamp()} ERROR: ${message}${args.length ? ' ' + args.map(a => safeStringify(a)).join(' ') : ''}`;
+        console.error(line);
+        writeToFile(line);
     },
     debug: (message, ...args) => {
+        const line = `[ratio-dev] ${timestamp()} DEBUG: ${message}${args.length ? ' ' + args.map(a => safeStringify(a)).join(' ') : ''}`;
+        // Always write to file, only stderr if DEBUG env is set
         if (process.env.DEBUG) {
-            console.error(`[ratio-dev] ${timestamp()} DEBUG: ${message}`, ...args);
+            console.error(line);
         }
+        writeToFile(line);
     },
     /** Log an incoming tool call with its input parameters */
     toolCall: (toolName, input) => {
-        console.error(`[ratio-dev] ${timestamp()} TOOL_CALL: ▶ ${toolName} | input: ${safeStringify(input)}`);
+        const stderrLine = `[ratio-dev] ${timestamp()} TOOL_CALL: ▶ ${toolName} | input: ${safeStringify(input)}`;
+        const fileLine = `[ratio-dev] ${timestamp()} TOOL_CALL: ▶ ${toolName} | input: ${fullStringify(input)}`;
+        console.error(stderrLine);
+        writeToFile(fileLine);
     },
     /** Log a successful tool result */
     toolResult: (toolName, durationMs, result) => {
-        console.error(`[ratio-dev] ${timestamp()} TOOL_RESULT: ✓ ${toolName} | ${durationMs}ms | output: ${safeStringify(result)}`);
+        const stderrLine = `[ratio-dev] ${timestamp()} TOOL_RESULT: ✓ ${toolName} | ${durationMs}ms | output: ${safeStringify(result)}`;
+        const fileLine = `[ratio-dev] ${timestamp()} TOOL_RESULT: ✓ ${toolName} | ${durationMs}ms | output: ${fullStringify(result)}`;
+        console.error(stderrLine);
+        writeToFile(fileLine);
     },
     /** Log a failed tool execution */
     toolError: (toolName, durationMs, error) => {
         const message = error instanceof Error ? error.message : String(error);
+        const stack = error instanceof Error ? error.stack : '';
         const details = error?.details;
-        console.error(`[ratio-dev] ${timestamp()} TOOL_ERROR: ✗ ${toolName} | ${durationMs}ms | error: ${message}${details ? ` | details: ${safeStringify(details, 500)}` : ''}`);
+        const stderrLine = `[ratio-dev] ${timestamp()} TOOL_ERROR: ✗ ${toolName} | ${durationMs}ms | error: ${message}${details ? ` | details: ${safeStringify(details, 500)}` : ''}`;
+        const fileLine = `[ratio-dev] ${timestamp()} TOOL_ERROR: ✗ ${toolName} | ${durationMs}ms | error: ${message}${details ? ` | details: ${fullStringify(details)}` : ''}${stack ? `\n  STACK: ${stack}` : ''}`;
+        console.error(stderrLine);
+        writeToFile(fileLine);
     },
     /** Log an outgoing API request to the backend */
     apiRequest: (method, url, data) => {
         const body = data ? ` | body: ${safeStringify(data, 500)}` : '';
+        const fullBody = data ? ` | body: ${fullStringify(data)}` : '';
         console.error(`[ratio-dev] ${timestamp()} API_REQ: → ${method} ${url}${body}`);
+        writeToFile(`[ratio-dev] ${timestamp()} API_REQ: → ${method} ${url}${fullBody}`);
     },
     /** Log a successful API response */
-    apiResponse: (method, url, status, durationMs) => {
+    apiResponse: (method, url, status, durationMs, responseData) => {
         console.error(`[ratio-dev] ${timestamp()} API_RES: ← ${method} ${url} | ${status} | ${durationMs}ms`);
+        writeToFile(`[ratio-dev] ${timestamp()} API_RES: ← ${method} ${url} | ${status} | ${durationMs}ms${responseData ? ` | data: ${fullStringify(responseData)}` : ''}`);
     },
     /** Log a failed API response */
     apiError: (method, url, status, durationMs, errorBody) => {
-        console.error(`[ratio-dev] ${timestamp()} API_ERR: ✗ ${method} ${url} | ${status || 'NO_RESPONSE'} | ${durationMs}ms | body: ${safeStringify(errorBody, 500)}`);
+        const line = `[ratio-dev] ${timestamp()} API_ERR: ✗ ${method} ${url} | ${status || 'NO_RESPONSE'} | ${durationMs}ms | body: ${fullStringify(errorBody)}`;
+        console.error(line);
+        writeToFile(line);
+    },
+    /** Log session state snapshots for debugging flow issues */
+    sessionSnapshot: (label, context) => {
+        const line = `[ratio-dev] ${timestamp()} SESSION [${label}]: ${fullStringify(context)}`;
+        writeToFile(line);
+    },
+    /** Separator for clarity between flow phases */
+    phase: (phaseName, details) => {
+        const separator = '═'.repeat(60);
+        const line = `\n${separator}\n[ratio-dev] ${timestamp()} PHASE: ${phaseName}${details ? ` | ${details}` : ''}\n${separator}`;
+        writeToFile(line);
     },
 };
-export { safeStringify };
+export { safeStringify, fullStringify, LOG_FILE };
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@ratio-mcp/dev-server",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
   "main": "dist/index.js",
   "files": ["dist"],
   "bin": {
-    "ratio-dev-server": "dist/index.js"
+    "ratio-dev-server": "dist/index.js",
+    "ratio-dev-orchestrated": "dist/orchestrated-index.js"
   },
   "scripts": {
     "build": "tsc && npm run copy-templates",
     "copy-templates": "rm -rf dist/templates && cp -r src/templates dist/templates 2>/dev/null || true",
     "dev": "node --loader ts-node/esm src/index.ts",
+    "dev:orchestrated": "node --loader ts-node/esm src/orchestrated-index.ts",
     "start": "node dist/index.js",
+    "start:orchestrated": "node dist/orchestrated-index.js",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "pnpm build"
   },
@@ -21,6 +24,7 @@
     "axios": "^1.7.0",
     "zod": "^3.23.0",
     "archiver": "^7.0.0",
+    "dotenv": "^16.4.0",
     "form-data": "^4.0.0"
   },
   "devDependencies": {