@ratio-mcp/dev-server 1.0.0

package/dist/tools/requirements.js

@@ -0,0 +1,169 @@
+import { z } from 'zod';
+import { ALL_SCOPE_CODES, getResourceForScope, RESOURCE_METADATA, SCOPES_BY_RESOURCE } from '@ratio-mcp/shared';
+import { saveRequirements } from '../store/requirements-store.js';
+import { logger } from '../utils/logger.js';
+export const requirementsTools = [
+    {
+        name: 'define_app_requirements',
+        description: 'Define app requirements by specifying exact OAuth scope codes. ' +
+            'Has a two-step flow: first call WITHOUT confirmed=true to get a preview of what will be set up ' +
+            '(validated scopes, which resources have codegen support, warnings). ' +
+            'Then call AGAIN with confirmed=true to actually save. ' +
+            'This ensures the developer reviews and approves scopes before they drive code generation. ' +
+            'IMPORTANT: You MUST show the preview to the developer and get their approval before calling with confirmed=true.',
+        inputSchema: z.object({
+            app_id: z.string().min(1).describe('App ID from create_app (required)'),
+            app_name: z.string().optional().describe('App display name'),
+            scopes: z
+                .array(z.string())
+                .min(1)
+                .describe('Array of OAuth scope codes (e.g. ["read_orders", "write_products"]). Use get_available_scopes to see valid codes.'),
+            features: z
+                .array(z.string())
+                .default(['list'])
+                .describe('App features: "list", "analytics", "management"'),
+            confirmed: z
+                .boolean()
+                .default(false)
+                .describe('Set to true ONLY after the developer has reviewed and approved the scope preview. ' +
+                'First call without this (or false) to get a preview. Then call with true to save.'),
+        }),
+        handler: async (input) => {
+            const { app_id, app_name, scopes, features, confirmed } = input;
+            logger.info(`Defining requirements for app: ${app_id} (confirmed=${confirmed})`);
+            // ── Step 1: Validate scopes ──────────────────────────────
+            const validScopes = [];
+            const invalidScopes = [];
+            for (const scope of scopes) {
+                if (ALL_SCOPE_CODES.has(scope)) {
+                    validScopes.push(scope);
+                }
+                else {
+                    invalidScopes.push(scope);
+                }
+            }
+            const warnings = [];
+            if (invalidScopes.length > 0) {
+                warnings.push(`Invalid scopes ignored: ${invalidScopes.join(', ')}. Use get_available_scopes to see valid scope codes.`);
+            }
+            if (validScopes.length === 0) {
+                return {
+                    error: true,
+                    message: 'No valid scopes specified.',
+                    invalid_scopes: invalidScopes,
+                    warnings,
+                    _instruction: 'Call get_available_scopes first to see available scope codes.',
+                };
+            }
+            // ── Step 2: Derive resources and build preview ───────────
+            const dataNeedsSet = new Set();
+            for (const scope of validScopes) {
+                const resource = getResourceForScope(scope);
+                if (resource) {
+                    dataNeedsSet.add(resource);
+                }
+            }
+            // Build per-resource breakdown for the preview
+            const resourceBreakdown = [...dataNeedsSet].map((resource) => {
+                const meta = RESOURCE_METADATA[resource];
+                const resourceScopes = validScopes.filter((s) => getResourceForScope(s) === resource);
+                // Get scope details for richer display
+                const allResourceScopes = SCOPES_BY_RESOURCE[resource] || [];
+                const scopeDetails = resourceScopes.map((code) => {
+                    const scopeData = allResourceScopes.find((s) => s.code === code);
+                    return {
+                        code,
+                        label: scopeData?.label || code,
+                        description: scopeData?.description || '',
+                    };
+                });
+                return {
+                    resource,
+                    codegen_ready: meta?.codegen_ready || false,
+                    scopes: scopeDetails,
+                    note: meta?.codegen_ready
+                        ? 'Backend code will be auto-generated for this resource'
+                        : 'No API schema available yet — scopes will be registered but code generation will skip this resource',
+                };
+            });
+            // ── If NOT confirmed: return preview for developer approval ──
+            if (!confirmed) {
+                // Suggest related scopes the developer might also want
+                const suggestedAdditional = [];
+                const alreadySelected = new Set(validScopes);
+                for (const scope of validScopes) {
+                    const scopeResource = getResourceForScope(scope);
+                    if (!scopeResource)
+                        continue;
+                    const allResourceScopes = SCOPES_BY_RESOURCE[scopeResource] || [];
+                    const scopeData = allResourceScopes.find((s) => s.code === scope);
+                    if (!scopeData?.commonly_paired_with)
+                        continue;
+                    for (const pairedCode of scopeData.commonly_paired_with) {
+                        if (!alreadySelected.has(pairedCode) && ALL_SCOPE_CODES.has(pairedCode)) {
+                            // Find the paired scope's details
+                            const pairedResource = getResourceForScope(pairedCode);
+                            if (!pairedResource)
+                                continue;
+                            const pairedScopes = SCOPES_BY_RESOURCE[pairedResource] || [];
+                            const pairedData = pairedScopes.find((s) => s.code === pairedCode);
+                            if (!pairedData)
+                                continue;
+                            // Avoid duplicates in suggestions
+                            if (!suggestedAdditional.some((s) => s.code === pairedCode)) {
+                                suggestedAdditional.push({
+                                    code: pairedCode,
+                                    label: pairedData.label,
+                                    reason: `Commonly needed with ${scope} — ${pairedData.description.split('.')[0]}.`,
+                                });
+                            }
+                            alreadySelected.add(pairedCode); // prevent re-suggesting
+                        }
+                    }
+                }
+                return {
+                    status: 'preview',
+                    message: 'Here is a preview of the scopes that will be configured for this app. ' +
+                        'Please review and confirm.',
+                    app_id,
+                    app_name: app_name || undefined,
+                    selected_scopes: resourceBreakdown,
+                    total_scopes: validScopes.length,
+                    suggested_additional: suggestedAdditional.length > 0 ? suggestedAdditional : undefined,
+                    warnings: warnings.length > 0 ? warnings : undefined,
+                    _instruction: 'Present this preview to the developer clearly. Show selected scopes grouped by resource, ' +
+                        'highlight which resources have codegen support, and show suggested additional scopes. ' +
+                        'Ask the developer to confirm, add more scopes, or remove any. ' +
+                        'Once approved, call define_app_requirements again with the final scopes and confirmed=true.',
+                };
+            }
+            // ── If confirmed: save requirements ──────────────────────
+            const requirements = {
+                app_id,
+                app_name,
+                scopes: validScopes,
+                data_needs: [...dataNeedsSet],
+                features,
+                created_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+            };
+            saveRequirements(app_id, requirements);
+            logger.info(`Requirements confirmed and saved for app: ${app_id}`);
+            return {
+                success: true,
+                confirmed: true,
+                message: `Requirements saved for app ${app_id}`,
+                requirements: {
+                    app_id,
+                    scopes: validScopes,
+                    resources: [...dataNeedsSet],
+                    codegen_resources: [...dataNeedsSet].filter((r) => RESOURCE_METADATA[r]?.codegen_ready),
+                    features,
+                },
+                warnings: warnings.length > 0 ? warnings : undefined,
+                next_step: 'Call scaffold_frontend to create the frontend project.',
+            };
+        },
+    },
+];
+//# sourceMappingURL=requirements.js.map

package/dist/tools/requirements.js.map

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

package/dist/tools/scaffold.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './index.js';
+export declare const scaffoldTools: ToolDefinition[];
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/tools/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2BjD,eAAO,MAAM,aAAa,EAAE,cAAc,EAqNzC,CAAC"}

package/dist/tools/scaffold.js

@@ -0,0 +1,209 @@
+import { z } from 'zod';
+import { existsSync, readdirSync } from 'fs';
+import { cp, mkdir, writeFile } from 'fs/promises';
+import { join, resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { RATIO_API_BASE_URL } from '@ratio-mcp/shared';
+import { homedir, tmpdir } from 'os';
+import { logger } from '../utils/logger.js';
+import { ToolExecutionError } from '../utils/errors.js';
+import { getToken } from '../store/token-store.js';
+import { getAllRequirements, updateRequirementsField } from '../store/requirements-store.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const LOCAL_FS_NOTICE = ' IMPORTANT: This tool runs on the user\'s LOCAL machine filesystem. ' +
+    'All paths must be real local paths. Do NOT use sandbox paths.';
+function getTemplatesDir() {
+    return resolve(__dirname, '..', 'templates');
+}
+async function copyTemplate(source, dest) {
+    await cp(source, dest, {
+        recursive: true,
+        filter: (src) => {
+            const relative = src.replace(source, '');
+            if (relative.includes('node_modules'))
+                return false;
+            if (relative.includes('/dist/') || relative.endsWith('/dist'))
+                return false;
+            if (relative.endsWith('package-lock.json'))
+                return false;
+            if (relative.endsWith('pnpm-lock.yaml'))
+                return false;
+            return true;
+        },
+    });
+}
+export const scaffoldTools = [
+    {
+        name: 'scaffold_frontend',
+        description: 'Scaffold a React + Vite frontend project with auth, routing, layout, and API service pre-configured. ' +
+            'After this tool completes, the next step is ALWAYS to call build_frontend to compile the project.' + LOCAL_FS_NOTICE,
+        inputSchema: z.object({
+            project_name: z.string().min(1).describe('Project name (used as directory name)'),
+            project_path: z.string().optional().describe('Parent directory. Defaults to ~/Desktop.'),
+            app_name: z.string().optional().describe('App display name'),
+            client_id: z.string().optional().describe('App client ID from create_app'),
+        }),
+        handler: async (input) => {
+            const debugLog = [];
+            const log = (msg) => { debugLog.push(msg); logger.info(msg); };
+            const { project_name, project_path, app_name, client_id } = input;
+            log(`[scaffold_frontend] START — project_name="${project_name}", project_path="${project_path}", app_name="${app_name}", client_id="${client_id}"`);
+            const home = homedir();
+            const safeHome = existsSync(home) ? home : tmpdir();
+            log(`[scaffold_frontend] home="${home}", safeHome="${safeHome}", homeExists=${existsSync(home)}`);
+            const parentDir = project_path
+                ? (project_path.startsWith('~') ? project_path.replace('~', safeHome) : project_path)
+                : join(safeHome, 'Desktop');
+            log(`[scaffold_frontend] parentDir="${parentDir}", parentDirExists=${existsSync(parentDir)}`);
+            if (!existsSync(parentDir)) {
+                await mkdir(parentDir, { recursive: true });
+                log(`[scaffold_frontend] Created parentDir`);
+            }
+            const projectDir = join(parentDir, project_name);
+            log(`[scaffold_frontend] projectDir="${projectDir}", projectDirExists=${existsSync(projectDir)}`);
+            if (existsSync(projectDir)) {
+                throw new ToolExecutionError('scaffold_frontend', `Directory already exists: ${projectDir}. Debug: ${debugLog.join(' | ')}`);
+            }
+            await mkdir(projectDir, { recursive: true });
+            log(`[scaffold_frontend] Created projectDir, exists now=${existsSync(projectDir)}`);
+            const frontendDir = join(projectDir, 'frontend');
+            const templateDir = join(getTemplatesDir(), 'frontend');
+            log(`[scaffold_frontend] frontendDir="${frontendDir}"`);
+            log(`[scaffold_frontend] templateDir="${templateDir}", templateDirExists=${existsSync(templateDir)}`);
+            const templateDirExists = existsSync(templateDir);
+            const templateDirContents = templateDirExists ? readdirSync(templateDir) : [];
+            const hasTemplateFiles = templateDirExists && templateDirContents.length > 0;
+            log(`[scaffold_frontend] templateDirContents=[${templateDirContents.join(', ')}], hasTemplateFiles=${hasTemplateFiles}`);
+            if (hasTemplateFiles) {
+                log(`[scaffold_frontend] COPYING from template dir...`);
+                try {
+                    await copyTemplate(templateDir, frontendDir);
+                    log(`[scaffold_frontend] copyTemplate completed`);
+                }
+                catch (err) {
+                    log(`[scaffold_frontend] copyTemplate FAILED: ${err.message}`);
+                    throw err;
+                }
+            }
+            else {
+                log(`[scaffold_frontend] NO TEMPLATES — creating inline files...`);
+                await mkdir(join(frontendDir, 'src'), { recursive: true });
+                await mkdir(join(frontendDir, 'public'), { recursive: true });
+                await writeFile(join(frontendDir, 'package.json'), JSON.stringify({
+                    name: `${project_name}-frontend`,
+                    private: true,
+                    version: '0.1.0',
+                    type: 'module',
+                    scripts: { dev: 'vite', build: 'vite build', preview: 'vite preview' },
+                    dependencies: { react: '^18.2.0', 'react-dom': '^18.2.0', 'react-router-dom': '^6.20.0' },
+                    devDependencies: { '@types/react': '^18.2.0', '@types/react-dom': '^18.2.0', '@vitejs/plugin-react': '^4.2.0', typescript: '^5.3.0', vite: '^5.0.0' },
+                }, null, 2));
+                await writeFile(join(frontendDir, 'vite.config.ts'), `import { defineConfig } from 'vite';\nimport react from '@vitejs/plugin-react';\nexport default defineConfig({ plugins: [react()] });\n`);
+                await writeFile(join(frontendDir, 'index.html'), `<!DOCTYPE html>\n<html lang="en">\n<head><meta charset="UTF-8" /><meta name="viewport" content="width=device-width, initial-scale=1.0" /><title>${app_name || project_name}</title></head>\n<body><div id="root"></div><script type="module" src="/src/main.tsx"></script></body>\n</html>\n`);
+                await writeFile(join(frontendDir, 'src', 'main.tsx'), `import React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport App from './App';\n\nReactDOM.createRoot(document.getElementById('root')!).render(<React.StrictMode><App /></React.StrictMode>);\n`);
+                await writeFile(join(frontendDir, 'src', 'App.tsx'), `import React from 'react';\n\nexport default function App() {\n  return <div><h1>${app_name || project_name}</h1><p>Your Ratio app is ready. Build your UI here.</p></div>;\n}\n`);
+                await writeFile(join(frontendDir, 'tsconfig.json'), JSON.stringify({
+                    compilerOptions: { target: 'ES2020', useDefineForClassFields: true, lib: ['ES2020', 'DOM', 'DOM.Iterable'], module: 'ESNext', skipLibCheck: true, moduleResolution: 'bundler', allowImportingTsExtensions: true, resolveJsonModule: true, isolatedModules: true, noEmit: true, strict: true, jsx: 'react-jsx' },
+                    include: ['src'],
+                }, null, 2));
+                log(`[scaffold_frontend] Inline files written`);
+            }
+            // Write frontend .env.local
+            await writeFile(join(frontendDir, '.env.local'), `VITE_API_URL=http://localhost:3000/api\nVITE_APP_NAME=${app_name || project_name}\nVITE_APP_VERSION=1.0.0\n`);
+            log(`[scaffold_frontend] .env.local written`);
+            // Verify what was actually written
+            const frontendExists = existsSync(frontendDir);
+            const frontendContents = frontendExists ? readdirSync(frontendDir) : [];
+            log(`[scaffold_frontend] VERIFY — frontendDir exists=${frontendExists}, contents=[${frontendContents.join(', ')}]`);
+            if (frontendExists && frontendContents.includes('src')) {
+                const srcContents = readdirSync(join(frontendDir, 'src'));
+                log(`[scaffold_frontend] VERIFY — src/ contents=[${srcContents.join(', ')}]`);
+            }
+            // Update requirements store
+            if (client_id) {
+                const allReqs = getAllRequirements();
+                const targetAppId = Object.keys(allReqs).find((appId) => {
+                    const req = allReqs[appId];
+                    return req?.client_id === client_id;
+                }) || Object.keys(allReqs).find((appId) => !allReqs[appId]?.project_path);
+                if (targetAppId) {
+                    updateRequirementsField(targetAppId, { project_path: projectDir, client_id });
+                }
+            }
+            logger.info(`Frontend scaffolded: ${frontendDir}`);
+            return {
+                success: true,
+                message: `Frontend project scaffolded at ${frontendDir}`,
+                project_path: projectDir,
+                frontend_path: frontendDir,
+                debug_log: debugLog,
+                files_created: frontendContents,
+                next_step: `Call build_frontend with project_path="${projectDir}" to compile the project.`,
+            };
+        },
+    },
+    {
+        name: 'scaffold_backend',
+        description: 'Scaffold a NestJS backend project with .env pre-populated with access token, merchant ID, and client credentials. ' +
+            'Only creates the base structure — resource modules come from generate_api_routes. ' +
+            'Call AFTER OAuth flow (when access token is available).' + LOCAL_FS_NOTICE,
+        inputSchema: z.object({
+            project_path: z.string().min(1).describe('Path to the project directory (where frontend/ already exists)'),
+            client_id: z.string().optional().describe('App client ID'),
+            client_secret: z.string().optional().describe('App client secret'),
+            app_name: z.string().optional().describe('App display name'),
+        }),
+        handler: async (input) => {
+            const { project_path, client_id, client_secret, app_name } = input;
+            const projectDir = project_path.startsWith('~')
+                ? project_path.replace('~', homedir())
+                : project_path;
+            if (!existsSync(projectDir)) {
+                throw new ToolExecutionError('scaffold_backend', `Project directory not found: ${projectDir}`);
+            }
+            const backendDir = join(projectDir, 'backend');
+            const templateDir = join(getTemplatesDir(), 'backend');
+            // Copy the backend template
+            await copyTemplate(templateDir, backendDir);
+            // Fetch token from store
+            const storedToken = client_id ? getToken(client_id) : undefined;
+            // Write backend .env
+            const backendEnv = `# Ratio App Backend Configuration
+PORT=3000
+NODE_ENV=development
+
+# Ratio App Credentials
+RATIO_APP_ID=${client_id || 'your_app_id'}
+RATIO_APP_SECRET=${client_secret || 'your_app_secret'}
+RATIO_REDIRECT_URI=http://localhost:3000/auth/callback
+RATIO_API_BASE_URL=${RATIO_API_BASE_URL}
+RATIO_API_VERSION=v1
+
+# OAuth Tokens
+RATIO_ACCESS_TOKEN=${storedToken?.access_token || ''}
+RATIO_REFRESH_TOKEN=${storedToken?.refresh_token || ''}
+RATIO_MERCHANT_ID=${storedToken?.merchant_id || ''}
+RATIO_SCOPES=${storedToken?.scopes?.join(',') || ''}
+
+# JWT
+JWT_SECRET=your_jwt_secret_change_this
+JWT_EXPIRES_IN=7d
+`;
+            await writeFile(join(backendDir, '.env'), backendEnv);
+            logger.info(`Backend scaffolded: ${backendDir}`);
+            return {
+                success: true,
+                message: `Backend project scaffolded at ${backendDir}` +
+                    (storedToken ? '. OAuth tokens injected into .env.' : ''),
+                backend_path: backendDir,
+                token_injected: !!storedToken,
+                next_steps: [
+                    '1. Call generate_api_routes to create resource controllers and services',
+                    `2. cd ${backendDir} && npm install && npm run start:dev to test`,
+                ],
+            };
+        },
+    },
+];
+//# sourceMappingURL=scaffold.js.map

package/dist/tools/scaffold.js.map

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

package/dist/tools/submission.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './index.js';
+export declare const submissionTools: ToolDefinition[];
+//# sourceMappingURL=submission.d.ts.map

package/dist/tools/submission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission.d.ts","sourceRoot":"","sources":["../../src/tools/submission.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAcjD,eAAO,MAAM,eAAe,EAAE,cAAc,EA2I3C,CAAC"}

package/dist/tools/submission.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { existsSync, createReadStream, statSync } from 'fs';
+import { homedir } from 'os';
+import { developerApiRequest } from '../api/developer.js';
+import { logger } from '../utils/logger.js';
+import { ToolExecutionError } from '../utils/errors.js';
+import FormData from 'form-data';
+const STATUS_EXPLANATIONS = {
+    draft: 'App is in draft state. Upload a build and submit for review.',
+    submitted: 'App has been submitted for review. Waiting for admin.',
+    in_review: 'App is currently being reviewed by admin.',
+    approved: 'App version has been approved. You can now publish it.',
+    rejected: 'App version was rejected. Check feedback and resubmit.',
+    published: 'App is published and available to merchants.',
+    suspended: 'App has been suspended by admin.',
+    disabled: 'App has been disabled.',
+};
+export const submissionTools = [
+    {
+        name: 'upload_build',
+        description: 'Upload a ZIP file to the Ratio Developer Dashboard. Creates a new app version. ' +
+            'PREREQUISITE: Use create_submission_zip first.',
+        inputSchema: z.object({
+            app_id: z.string().min(1).describe('Application ID'),
+            zip_path: z.string().min(1).describe('Absolute path to the zip file'),
+            version: z.string().optional().describe('Version string (e.g. "1.0.0")'),
+            changelog: z.string().optional().describe('Changelog for this version'),
+        }),
+        handler: async (input) => {
+            const { app_id, zip_path: rawPath, version, changelog } = input;
+            const zipPath = rawPath.startsWith('~') ? rawPath.replace('~', homedir()) : rawPath;
+            if (!existsSync(zipPath)) {
+                throw new ToolExecutionError('upload_build', `Zip file not found: ${zipPath}`);
+            }
+            const zipSize = statSync(zipPath).size;
+            logger.info(`Uploading build: ${zipPath} (${(zipSize / 1024 / 1024).toFixed(2)}MB)`);
+            // Create FormData — note: we import from 'form-data' (node)
+            const formData = new FormData();
+            formData.append('buildZip', createReadStream(zipPath));
+            if (version)
+                formData.append('version', version);
+            if (changelog)
+                formData.append('changelog', changelog);
+            const response = await developerApiRequest('POST', `/applications/${app_id}/upload-build`, formData, {
+                axiosConfig: {
+                    headers: formData.getHeaders(),
+                    maxContentLength: Infinity,
+                    maxBodyLength: Infinity,
+                },
+            });
+            return {
+                success: true,
+                message: 'Build uploaded successfully',
+                response,
+                next_steps: ['1. Call submit_for_review to submit for admin review'],
+            };
+        },
+    },
+    {
+        name: 'submit_for_review',
+        description: 'Submit an application for review. PREREQUISITE: Must have at least one uploaded build version.',
+        inputSchema: z.object({
+            app_id: z.string().min(1).describe('Application ID'),
+            description: z.string().optional().describe('Description for submission'),
+            changelog: z.string().optional().describe('Changelog'),
+            category_ids: z.array(z.string()).optional().describe('Categories'),
+            tags: z.array(z.string()).optional().describe('Tags'),
+        }),
+        handler: async (input) => {
+            const { app_id, description, changelog, category_ids, tags } = input;
+            const body = {
+                appId: app_id,
+                submitToReview: true,
+            };
+            if (description)
+                body['description'] = description;
+            if (changelog)
+                body['changelog'] = changelog;
+            if (category_ids)
+                body['categoryIds'] = category_ids;
+            if (tags)
+                body['tags'] = tags;
+            const response = await developerApiRequest('POST', `/applications/submit`, body);
+            return {
+                success: true,
+                message: 'Application submitted for review',
+                response,
+                next_steps: [
+                    '1. Wait for admin approval',
+                    '2. Use get_app_status to check progress',
+                    '3. After approval: publish_app to publish, then OAuth flow',
+                ],
+            };
+        },
+    },
+    {
+        name: 'get_app_status',
+        description: 'Check the current status of an application and its versions.',
+        inputSchema: z.object({
+            app_id: z.string().min(1).describe('Application ID'),
+        }),
+        handler: async (input) => {
+            const { app_id } = input;
+            const response = await developerApiRequest('GET', `/applications/${app_id}`);
+            const status = response?.data?.status || response?.status || 'unknown';
+            const explanation = STATUS_EXPLANATIONS[status] || 'Unknown status';
+            return {
+                success: true,
+                application: response,
+                status,
+                explanation,
+            };
+        },
+    },
+    {
+        name: 'publish_app',
+        description: 'Publish an approved application version. PREREQUISITE: Version must be in "approved" status.',
+        inputSchema: z.object({
+            app_id: z.string().min(1).describe('Application ID'),
+            version_id: z.string().min(1).describe('Version ID to publish (from get_app_status)'),
+        }),
+        handler: async (input) => {
+            const { app_id, version_id } = input;
+            const response = await developerApiRequest('POST', `/developer/apps/${app_id}/versions/${version_id}/publish`);
+            return {
+                success: true,
+                message: 'Application published successfully',
+                response,
+                next_steps: [
+                    '1. App is now available to merchants',
+                    '2. Use request_auth_code to start OAuth with a test merchant',
+                    '3. After OAuth: scaffold_backend → generate_api_routes',
+                ],
+            };
+        },
+    },
+];
+//# sourceMappingURL=submission.js.map

package/dist/tools/submission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission.js","sourceRoot":"","sources":["../../src/tools/submission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,MAAM,mBAAmB,GAA2B;IAClD,KAAK,EAAE,8DAA8D;IACrE,SAAS,EAAE,uDAAuD;IAClE,SAAS,EAAE,2CAA2C;IACtD,QAAQ,EAAE,wDAAwD;IAClE,QAAQ,EAAE,wDAAwD;IAClE,SAAS,EAAE,8CAA8C;IACzD,SAAS,EAAE,kCAAkC;IAC7C,QAAQ,EAAE,wBAAwB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,iFAAiF;YACjF,gDAAgD;QAClD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACrE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACxE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SACxE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAEzD,CAAC;YACF,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAEpF,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,uBAAuB,OAAO,EAAE,CAAC,CAAC;YACjF,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,oBAAoB,OAAO,KAAK,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAErF,4DAA4D;YAC5D,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;YAChC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,OAAO;gBAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,SAAS;gBAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAEvD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,MAAM,EACN,iBAAiB,MAAM,eAAe,EACtC,QAAQ,EACR;gBACE,WAAW,EAAE;oBACX,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE;oBAC9B,gBAAgB,EAAE,QAAQ;oBAC1B,aAAa,EAAE,QAAQ;iBACxB;aACF,CACF,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,6BAA6B;gBACtC,QAAQ;gBACR,UAAU,EAAE,CAAC,sDAAsD,CAAC;aACrE,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,gGAAgG;QAClG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACpD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;YACtD,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YACnE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;SACtD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,KAAgC,CAAC;YAEhG,MAAM,IAAI,GAA4B;gBACpC,KAAK,EAAE,MAAM;gBACb,cAAc,EAAE,IAAI;aACrB,CAAC;YACF,IAAI,WAAW;gBAAE,IAAI,CAAC,aAAa,CAAC,GAAG,WAAW,CAAC;YACnD,IAAI,SAAS;gBAAE,IAAI,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;YAC7C,IAAI,YAAY;gBAAE,IAAI,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC;YACrD,IAAI,IAAI;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;YAE9B,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,MAAM,EAAE,sBAAsB,EAAE,IAAI,CACrC,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,kCAAkC;gBAC3C,QAAQ;gBACR,UAAU,EAAE;oBACV,4BAA4B;oBAC5B,yCAAyC;oBACzC,4DAA4D;iBAC7D;aACF,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACrD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,EAAE,MAAM,EAAE,GAAG,KAA2B,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAA0B,KAAK,EAAE,iBAAiB,MAAM,EAAE,CAAC,CAAC;YAEtG,MAAM,MAAM,GAAI,QAAgB,EAAE,IAAI,EAAE,MAAM,IAAK,QAAgB,EAAE,MAAM,IAAI,SAAS,CAAC;YACzF,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC;YAEpE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,QAAQ;gBACrB,MAAM;gBACN,WAAW;aACZ,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,8FAA8F;QAChG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SACtF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,KAA+C,CAAC;YAE/E,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,MAAM,EAAE,mBAAmB,MAAM,aAAa,UAAU,UAAU,CACnE,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,oCAAoC;gBAC7C,QAAQ;gBACR,UAAU,EAAE;oBACV,sCAAsC;oBACtC,8DAA8D;oBAC9D,wDAAwD;iBACzD;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Base error class for Ratio MCP
+ */
+export declare class RatioMCPError extends Error {
+    constructor(message: string);
+}
+export declare class AuthenticationError extends RatioMCPError {
+    details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class RatioAPIError extends RatioMCPError {
+    endpoint: string;
+    method: string;
+    statusCode?: number | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, endpoint: string, method: string, statusCode?: number | undefined, details?: unknown | undefined);
+}
+export declare class ToolExecutionError extends RatioMCPError {
+    toolName: string;
+    constructor(toolName: string, message: string);
+}
+export declare class BuildError extends RatioMCPError {
+    details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+/**
+ * Extract a human-readable message from an Axios error response
+ */
+export declare function extractAxiosMessage(error: unknown): string;
+/**
+ * Handle axios errors with consistent formatting
+ */
+export declare function handleAxiosError(error: unknown, endpoint: string, method: string): never;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,aAAa;IAChB,OAAO,CAAC,EAAE,OAAO;gBAAzC,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,OAAO,YAAA;CAItD;AAED,qBAAa,aAAc,SAAQ,aAAa;IAGrC,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;IACd,UAAU,CAAC,EAAE,MAAM;IACnB,OAAO,CAAC,EAAE,OAAO;gBAJxB,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,kBAAmB,SAAQ,aAAa;IAChC,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIrD;AAED,qBAAa,UAAW,SAAQ,aAAa;IACP,OAAO,CAAC,EAAE,OAAO;gBAAzC,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,OAAO,YAAA;CAItD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,KAAK,CAqBP"}