@ratio-mcp/dev-server 1.2.0 → 1.3.0

package/dist/data/scope-webhook-map.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Scope → Webhook Event Recommendations
+ *
+ * Maps confirmed OAuth scopes to relevant webhook events.
+ * Used after define_app_requirements to suggest which webhooks
+ * the developer should subscribe to based on their selected scopes.
+ *
+ * Events are sourced from docs-server/schemas/webhooks.json.
+ */
+export interface WebhookRecommendation {
+    topic: string;
+    description: string;
+    resource: string;
+    /** Why this event is relevant given the scope */
+    reason: string;
+}
+/**
+ * Get recommended webhook events based on confirmed scopes.
+ * Deduplicates events when multiple scopes map to the same resource.
+ */
+export declare function getWebhookRecommendations(scopes: string[]): {
+    recommendations: WebhookRecommendation[];
+    scopes_matched: string[];
+    scopes_without_webhooks: string[];
+};
+//# sourceMappingURL=scope-webhook-map.d.ts.map

package/dist/data/scope-webhook-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-webhook-map.d.ts","sourceRoot":"","sources":["../../src/data/scope-webhook-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AA4ED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IAC3D,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,uBAAuB,EAAE,MAAM,EAAE,CAAC;CACnC,CAkCA"}

package/dist/data/scope-webhook-map.js

@@ -0,0 +1,117 @@
+/**
+ * Scope → Webhook Event Recommendations
+ *
+ * Maps confirmed OAuth scopes to relevant webhook events.
+ * Used after define_app_requirements to suggest which webhooks
+ * the developer should subscribe to based on their selected scopes.
+ *
+ * Events are sourced from docs-server/schemas/webhooks.json.
+ */
+/**
+ * Map of scope → recommended webhook events.
+ * Write scopes inherit their read scope's events.
+ */
+const SCOPE_WEBHOOK_MAP = {
+    read_orders: [
+        {
+            topic: 'orders/create',
+            description: 'Fired when a new order is created',
+            resource: 'orders',
+            reason: 'React to new orders in real-time instead of polling',
+        },
+        {
+            topic: 'orders/updated',
+            description: 'Fired when an order is updated',
+            resource: 'orders',
+            reason: 'Track order status changes (shipping, notes, etc.)',
+        },
+        {
+            topic: 'orders/cancelled',
+            description: 'Fired when an order is cancelled',
+            resource: 'orders',
+            reason: 'Handle cancellations immediately (refunds, inventory)',
+        },
+        {
+            topic: 'orders/fulfilled',
+            description: 'Fired when an order is fulfilled',
+            resource: 'orders',
+            reason: 'Trigger post-fulfillment workflows (emails, analytics)',
+        },
+        {
+            topic: 'orders/paid',
+            description: 'Fired when an order is paid',
+            resource: 'orders',
+            reason: 'Track payment completions for revenue reporting',
+        },
+    ],
+    read_products: [
+        {
+            topic: 'products/create',
+            description: 'Fired when a new product is created',
+            resource: 'products',
+            reason: 'Sync new products to external catalogs or feeds',
+        },
+        {
+            topic: 'products/update',
+            description: 'Fired when a product is updated',
+            resource: 'products',
+            reason: 'Keep product data in sync (price changes, stock updates)',
+        },
+        {
+            topic: 'products/delete',
+            description: 'Fired when a product is deleted',
+            resource: 'products',
+            reason: 'Remove deleted products from external systems',
+        },
+    ],
+};
+// Write scopes inherit read scope events
+SCOPE_WEBHOOK_MAP['write_orders'] = SCOPE_WEBHOOK_MAP['read_orders'];
+SCOPE_WEBHOOK_MAP['write_products'] = SCOPE_WEBHOOK_MAP['read_products'];
+/** Always-recommended events regardless of scopes */
+const ALWAYS_RECOMMENDED = [
+    {
+        topic: 'app/uninstalled',
+        description: 'Fired when the app is uninstalled by a merchant',
+        resource: 'app',
+        reason: 'Clean up merchant data and revoke tokens when uninstalled',
+    },
+];
+/**
+ * Get recommended webhook events based on confirmed scopes.
+ * Deduplicates events when multiple scopes map to the same resource.
+ */
+export function getWebhookRecommendations(scopes) {
+    const seen = new Set();
+    const recommendations = [];
+    const scopesMatched = [];
+    const scopesWithout = [];
+    for (const scope of scopes) {
+        const events = SCOPE_WEBHOOK_MAP[scope];
+        if (events) {
+            scopesMatched.push(scope);
+            for (const event of events) {
+                if (!seen.has(event.topic)) {
+                    seen.add(event.topic);
+                    recommendations.push(event);
+                }
+            }
+        }
+        else {
+            scopesWithout.push(scope);
+        }
+    }
+    // Always add app/uninstalled
+    for (const event of ALWAYS_RECOMMENDED) {
+        if (!seen.has(event.topic)) {
+            seen.add(event.topic);
+            recommendations.push(event);
+        }
+    }
+    return {
+        recommendations,
+        scopes_matched: scopesMatched,
+        scopes_without_webhooks: scopesWithout,
+    };
+}
+//# sourceMappingURL=scope-webhook-map.js.map

package/dist/data/scope-webhook-map.js.map

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

package/dist/index.d.ts

@@ -2,11 +2,12 @@
 /**
  * Ratio Dev MCP Server — Entry Point
  *
- * This runs the ORCHESTRATED server by default, exposing a single `agent_chat`
- * tool that manages the entire app development lifecycle via a state machine.
+ * Tool-first architecture: exposes all tools individually with prerequisite guards.
+ * The LLM decides what to call; guards enforce the dependency graph.
  *
- * To run the legacy server (24+ individual tools), use:
- *   RATIO_LEGACY_MODE=true node dist/index.js
+ * Modes:
+ *   Default: Tool-first server (all tools with guards)
+ *   RATIO_STANDALONE_MODE=true: Standalone server (all tools, no orchestration)
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/index.js

@@ -2,43 +2,41 @@
 /**
  * Ratio Dev MCP Server — Entry Point
  *
- * This runs the ORCHESTRATED server by default, exposing a single `agent_chat`
- * tool that manages the entire app development lifecycle via a state machine.
+ * Tool-first architecture: exposes all tools individually with prerequisite guards.
+ * The LLM decides what to call; guards enforce the dependency graph.
  *
- * To run the legacy server (24+ individual tools), use:
- *   RATIO_LEGACY_MODE=true node dist/index.js
+ * Modes:
+ *   Default: Tool-first server (all tools with guards)
+ *   RATIO_STANDALONE_MODE=true: Standalone server (all tools, no orchestration)
  */
 // Load .env BEFORE any other imports so process.env is populated
-// Must use dynamic imports to ensure dotenv runs before constants.ts is evaluated
 import { config } from 'dotenv';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 const __dirname = dirname(fileURLToPath(import.meta.url));
-// __dirname = dist/ → go up to: dev-server/ → packages/ → ratio-mcp-v2/
 const envPath = resolve(__dirname, '..', '..', '..', '.env');
 config({ path: envPath });
 async function main() {
-    // Dynamic imports — these run AFTER dotenv has loaded env vars
     const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
     const { createOrchestratedServer } = await import('./orchestrated-server.js');
     const { createDevServer } = await import('./server.js');
     const { logger } = await import('./utils/logger.js');
-    const legacyMode = process.env.RATIO_LEGACY_MODE === 'true';
+    const standaloneMode = process.env.RATIO_STANDALONE_MODE === 'true';
     logger.info(`Loaded .env from: ${envPath}`);
     logger.info(`RATIO_API_BASE_URL = ${process.env.RATIO_API_BASE_URL || '(not set, using default)'}`);
-    if (legacyMode) {
-        logger.info('Starting Ratio Dev MCP Server (Legacy Mode — 24+ tools)...');
+    if (standaloneMode) {
+        logger.info('Starting Ratio Dev MCP Server (Standalone Mode)...');
         const server = createDevServer();
         const transport = new StdioServerTransport();
         await server.connect(transport);
-        logger.info('Ratio Dev MCP Server (Legacy) is running on stdio');
+        logger.info('Ratio Dev MCP Server (Standalone) is running on stdio');
     }
     else {
-        logger.info('Starting Ratio Dev MCP Server (Orchestrated — single agent_chat tool)...');
+        logger.info('Starting Ratio Dev MCP Server (Tool-First Architecture)...');
         const server = createOrchestratedServer();
         const transport = new StdioServerTransport();
         await server.connect(transport);
-        logger.info('Ratio Dev MCP Server (Orchestrated) is running on stdio');
+        logger.info('Ratio Dev MCP Server (Tool-First) is running on stdio');
     }
 }
 main().catch((error) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,wEAAwE;AACxE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC9E,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAErD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,CAAC;IAE5D,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,0BAA0B,EAAE,CAAC,CAAC;IAEpG,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AAEH,iEAAiE;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC9E,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAErD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,MAAM,CAAC;IAEpE,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,0BAA0B,EAAE,CAAC,CAAC;IAEpG,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/orchestrated-index.d.ts

@@ -1,16 +1,11 @@
 #!/usr/bin/env node
 /**
- * Orchestrated Ratio Dev MCP Server — Entry Point
+ * Ratio Dev MCP Server — Orchestrated Entry Point
  *
- * This is the production entry point that exposes a SINGLE `agent_chat` tool
- * instead of 24+ individual tools. The internal state machine ensures the
- * correct tool is called at the right time in the right order.
+ * Tool-first architecture: exposes all tools individually with prerequisite guards.
+ * The LLM decides what to call; guards enforce the dependency graph.
  *
- * Usage:
- *   node dist/orchestrated-index.js
- *
- * Or via the bin alias:
- *   ratio-dev-orchestrated
+ * This is the production entry point.
  */
 export {};
 //# sourceMappingURL=orchestrated-index.d.ts.map

package/dist/orchestrated-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrated-index.d.ts","sourceRoot":"","sources":["../src/orchestrated-index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"orchestrated-index.d.ts","sourceRoot":"","sources":["../src/orchestrated-index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/orchestrated-index.js

@@ -1,38 +1,30 @@
 #!/usr/bin/env node
 /**
- * Orchestrated Ratio Dev MCP Server — Entry Point
+ * Ratio Dev MCP Server — Orchestrated Entry Point
  *
- * This is the production entry point that exposes a SINGLE `agent_chat` tool
- * instead of 24+ individual tools. The internal state machine ensures the
- * correct tool is called at the right time in the right order.
+ * Tool-first architecture: exposes all tools individually with prerequisite guards.
+ * The LLM decides what to call; guards enforce the dependency graph.
  *
- * Usage:
- *   node dist/orchestrated-index.js
- *
- * Or via the bin alias:
- *   ratio-dev-orchestrated
+ * This is the production entry point.
  */
 // Load .env BEFORE any other imports so process.env is populated
-// Must use dynamic imports to ensure dotenv runs before constants.ts is evaluated
 import { config } from 'dotenv';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 const __dirname = dirname(fileURLToPath(import.meta.url));
-// __dirname = dist/ → go up to: dev-server/ → packages/ → ratio-mcp-v2/
 const envPath = resolve(__dirname, '..', '..', '..', '.env');
 config({ path: envPath });
 async function main() {
-    // Dynamic imports — these run AFTER dotenv has loaded env vars
     const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
     const { createOrchestratedServer } = await import('./orchestrated-server.js');
     const { logger } = await import('./utils/logger.js');
     logger.info(`Loaded .env from: ${envPath}`);
     logger.info(`RATIO_API_BASE_URL = ${process.env.RATIO_API_BASE_URL || '(not set, using default)'}`);
-    logger.info('Starting Ratio Dev MCP Server (Orchestrated Mode)...');
+    logger.info('Starting Ratio Dev MCP Server (Tool-First Architecture)...');
     const server = createOrchestratedServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    logger.info('Ratio Dev MCP Server (Orchestrated) is running on stdio');
+    logger.info('Ratio Dev MCP Server (Tool-First) is running on stdio');
 }
 main().catch((error) => {
     console.error('Fatal error:', error);

package/dist/orchestrated-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrated-index.js","sourceRoot":"","sources":["../src/orchestrated-index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAEH,iEAAiE;AACjE,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,wEAAwE;AACxE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAErD,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,0BAA0B,EAAE,CAAC,CAAC;IACpG,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;AACzE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"orchestrated-index.js","sourceRoot":"","sources":["../src/orchestrated-index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,iEAAiE;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAErD,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,0BAA0B,EAAE,CAAC,CAAC;IACpG,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAE1E,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;AACvE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/orchestrated-server.d.ts

@@ -1,16 +1,21 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
- * Create the Orchestrated Ratio Dev MCP Server.
+ * Create the Tool-First Ratio Dev MCP Server.
  *
- * Unlike the original server (which exposes 24+ individual tools),
- * this server exposes a SINGLE `agent_chat` tool that orchestrates
- * the entire app development lifecycle through a state machine.
+ * 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.
  *
- * Benefits:
- * - LLM doesn't need to decide tool ordering — the orchestrator handles it
- * - Flow integrity is guaranteed — steps can't be skipped or called out of order
- * - Simpler LLM integration — one tool to learn instead of 24
- * - Production-grade reliability — deterministic state transitions
+ * 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 declare function createOrchestratedServer(): McpServer;
 //# sourceMappingURL=orchestrated-server.d.ts.map

package/dist/orchestrated-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrated-server.d.ts","sourceRoot":"","sources":["../src/orchestrated-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,CAsDpD"}
+{"version":3,"file":"orchestrated-server.d.ts","sourceRoot":"","sources":["../src/orchestrated-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,CAyFpD"}

package/dist/orchestrated-server.js

@@ -1,63 +1,101 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { DEV_SERVER_NAME, DEV_SERVER_VERSION } from '@ratio-mcp/shared';
-import { agentChatTool } from './tools/agent-chat.js';
+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 Orchestrated Ratio Dev MCP Server.
+ * Create the Tool-First Ratio Dev MCP Server.
  *
- * Unlike the original server (which exposes 24+ individual tools),
- * this server exposes a SINGLE `agent_chat` tool that orchestrates
- * the entire app development lifecycle through a state machine.
+ * 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.
  *
- * Benefits:
- * - LLM doesn't need to decide tool ordering — the orchestrator handles it
- * - Flow integrity is guaranteed — steps can't be skipped or called out of order
- * - Simpler LLM integration — one tool to learn instead of 24
- * - Production-grade reliability — deterministic state transitions
+ * 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 the single unified tool
-    const shape = agentChatTool.inputSchema.shape;
-    server.tool(agentChatTool.name, agentChatTool.description, shape, async (args) => {
-        logger.toolCall(agentChatTool.name, args);
-        const startTime = Date.now();
-        try {
-            const result = await agentChatTool.handler(args);
-            const duration = Date.now() - startTime;
-            logger.toolResult(agentChatTool.name, duration, result);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const duration = Date.now() - startTime;
-            logger.toolError(agentChatTool.name, duration, error);
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            error: true,
-                            message,
-                            tool: agentChatTool.name,
-                        }, null, 2),
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    logger.info(`${DEV_SERVER_NAME}-orchestrated initialized with single agent_chat tool`);
+    // 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 +1 @@
-{"version":3,"file":"orchestrated-server.js","sourceRoot":"","sources":["../src/orchestrated-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,GAAG,eAAe,eAAe;QACvC,OAAO,EAAE,kBAAkB;KAC5B,CAAC,CAAC;IAEH,mCAAmC;IACnC,MAAM,KAAK,GAAI,aAAa,CAAC,WAA0C,CAAC,KAAK,CAAC;IAE9E,MAAM,CAAC,IAAI,CACT,aAAa,CAAC,IAAI,EAClB,aAAa,CAAC,WAAW,EACzB,KAAK,EACL,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAEtD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,IAAI;4BACX,OAAO;4BACP,IAAI,EAAE,aAAa,CAAC,IAAI;yBACzB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,uDAAuD,CAAC,CAAC;IACvF,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"orchestrated-server.js","sourceRoot":"","sources":["../src/orchestrated-server.ts"],"names":[],"mappings":"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"}

package/dist/services/session-state.d.ts

@@ -1,29 +1,23 @@
 /**
- * In-memory session state tracker.
+ * In-memory session state tracker (per-app).
  *
- * Tracks which tools have been called successfully and what data has been
- * collected so far. This lets the tool-guard decide whether a tool's
- * prerequisites are met before allowing it to execute.
+ * Auth state is global (one developer per stdio session).
+ * App state is scoped per app ID — supports working on multiple apps.
  *
- * Single-user (stdio MCP), so a simple module-level object is fine.
+ * Single-user (stdio MCP), so module-level state is fine.
  * For multi-user (Streamable HTTP), this would move to Redis.
  */
-export interface SessionState {
-    /** Tools that completed successfully (set of tool names) */
+/** Per-app state: tracks tool completion and collected context for one app */
+export interface AppState {
     completedTools: Set<string>;
-    /** Key data collected during the flow */
     context: {
-        authMode?: 'login' | 'signup';
-        signupEmail?: string;
-        developerId?: string;
-        developerToken?: string;
-        appId?: string;
         appName?: string;
         clientId?: string;
         clientSecret?: string;
         confirmedScopes?: string[];
         scopesConfirmed?: boolean;
         webhooksConfigured?: boolean;
+        webhookIds?: string[];
         buildUploaded?: boolean;
         submittedForReview?: boolean;
         appApproved?: boolean;
@@ -37,17 +31,43 @@ export interface SessionState {
         zipPath?: string;
         latestVersionId?: string;
     };
+}
+/** Global session state: auth + per-app state */
+export interface SessionState {
+    /** Global: tools completed at session level (auth tools) */
+    completedTools: Set<string>;
+    /** Global context (auth + active app's context flattened for backward compat) */
+    context: {
+        authMode?: 'login' | 'signup';
+        signupEmail?: string;
+        developerId?: string;
+        developerToken?: string;
+        /** Currently active app ID (for tools that don't pass app_id explicitly) */
+        activeAppId?: string;
+        /** Active app's ID (backward compat — same as activeAppId) */
+        appId?: string;
+    } & AppState['context'];
+    /** Per-app state, keyed by app ID */
+    apps: Record<string, AppState>;
     /** Timestamp of last tool call */
     lastActivity: number;
 }
-/** Get current session state (read-only snapshot) */
-export declare function getSession(): Readonly<SessionState>;
+/** Get current session state (read-only reference) */
+export declare function getSession(): SessionState;
+/** Get state for a specific app */
+export declare function getAppState(appId: string): AppState | undefined;
+/** Get the currently active app ID */
+export declare function getActiveAppId(): string | undefined;
+/** Set the active app ID */
+export declare function setActiveAppId(appId: string): void;
 /** Record that a tool completed successfully and extract relevant context */
 export declare function recordToolSuccess(toolName: string, result: unknown): void;
 /** Reset session (for testing or starting a new flow) */
 export declare function resetSession(): void;
-/** Check if a specific tool has been completed */
+/** Check if a specific tool has been completed (global or active app) */
 export declare function hasCompleted(toolName: string): boolean;
 /** Check if ANY of the given tools has been completed */
 export declare function hasCompletedAny(toolNames: string[]): boolean;
+/** Get all completed tools (global + active app) */
+export declare function getAllCompletedTools(): string[];
 //# sourceMappingURL=session-state.d.ts.map

package/dist/services/session-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/services/session-state.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE5B,yCAAyC;IACzC,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB;AAgBD,qDAAqD;AACrD,wBAAgB,UAAU,IAAI,QAAQ,CAAC,YAAY,CAAC,CAEnD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAyOzE;AAED,yDAAyD;AACzD,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAE5D"}
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/services/session-state.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAIH,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE5B,iFAAiF;IACjF,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,4EAA4E;QAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,8DAA8D;QAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAExB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE/B,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB;AA4BD,sDAAsD;AACtD,wBAAgB,UAAU,IAAI,YAAY,CAEzC;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE/D;AAED,sCAAsC;AACtC,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,4BAA4B;AAC5B,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAuNzE;AA2BD,yDAAyD;AACzD,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAE5D;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAS/C"}