@ratio-mcp/dev-server 1.0.0

package/dist/tools/auth.js

@@ -0,0 +1,164 @@
+import { z } from 'zod';
+import { requestAuthorization, exchangeCodeForToken, refreshToken } from '../api/oauth.js';
+import { saveToken, getToken, isTokenExpired, writeTokenToScaffoldEnv } from '../store/token-store.js';
+import { getRequirements, getRequirementsByClientId } from '../store/requirements-store.js';
+import { logger } from '../utils/logger.js';
+export const authTools = [
+    {
+        name: 'request_auth_code',
+        description: 'Request an authorization code for app installation (OAuth Step 1). App must be PUBLISHED first. ' +
+            'Auto-fills scopes from saved requirements if app_id is provided.',
+        inputSchema: z.object({
+            app_id: z.string().optional().describe('App ID to auto-fill scopes from requirements'),
+            client_id: z.string().min(1).describe('Application Client ID'),
+            merchant_id: z.string().min(1).describe('Merchant ID of the store installing the app'),
+            redirect_uri: z.string().describe('Registered redirect URI'),
+            scopes: z.array(z.string()).optional().describe('Scopes to request. Auto-filled from requirements if omitted.'),
+        }),
+        handler: async (input) => {
+            const { app_id, client_id, merchant_id, redirect_uri } = input;
+            let scopes = input.scopes;
+            // Auto-fill scopes
+            if (!scopes || scopes.length === 0) {
+                if (!app_id) {
+                    return { error: true, message: 'No scopes provided and no app_id for lookup. Pass app_id or scopes explicitly.' };
+                }
+                const requirements = getRequirements(app_id);
+                if (requirements && requirements.scopes.length > 0) {
+                    scopes = requirements.scopes;
+                    logger.info(`Auto-filled scopes from requirements: [${scopes.join(', ')}]`);
+                }
+                else {
+                    return { error: true, message: `No requirements found for app_id "${app_id}". Call define_app_requirements first.` };
+                }
+            }
+            const response = await requestAuthorization({ clientId: client_id, merchantId: merchant_id, redirectUri: redirect_uri, scopes });
+            const { code, redirectUri, expiresAt } = response.data;
+            return {
+                success: true,
+                message: response.message,
+                auth_code: code,
+                redirect_uri: redirectUri,
+                expires_at: expiresAt,
+                warning: 'Auth code expires quickly! Call get_access_token immediately.',
+            };
+        },
+    },
+    {
+        name: 'get_access_token',
+        description: 'Exchange authorization code for access and refresh tokens (OAuth Step 2). ' +
+            'Saves tokens persistently and auto-injects into backend .env if project is scaffolded.',
+        inputSchema: z.object({
+            auth_code: z.string().min(1).describe('Authorization code from request_auth_code'),
+            client_id: z.string().min(1).describe('Application Client ID'),
+            client_secret: z.string().min(1).describe('Application Client Secret'),
+            redirect_uri: z.string().describe('Redirect URI (must match request_auth_code)'),
+        }),
+        handler: async (input) => {
+            const { auth_code, client_id, client_secret, redirect_uri } = input;
+            const tokenData = await exchangeCodeForToken({ code: auth_code, clientId: client_id, clientSecret: client_secret, redirectUri: redirect_uri });
+            const expiresAt = new Date(Date.now() + tokenData.expires_in * 1000);
+            const storedToken = {
+                access_token: tokenData.access_token,
+                refresh_token: tokenData.refresh_token,
+                scopes: tokenData.scope.split(',').map((s) => s.trim()).filter(Boolean),
+                merchant_id: tokenData.merchant_id,
+                expires_at: expiresAt.toISOString(),
+                created_at: new Date().toISOString(),
+                client_id, client_secret, redirect_uri,
+            };
+            saveToken(client_id, storedToken);
+            // Auto-inject into backend .env
+            let tokenInjected = false;
+            const requirements = getRequirementsByClientId(client_id);
+            if (requirements?.project_path) {
+                const backendEnvPath = `${requirements.project_path}/backend/.env`;
+                writeTokenToScaffoldEnv(backendEnvPath, storedToken);
+                tokenInjected = true;
+                logger.info(`Token injected into: ${backendEnvPath}`);
+            }
+            return {
+                success: true,
+                message: 'Tokens obtained and saved' + (tokenInjected ? '. Injected into backend .env.' : ''),
+                tokens: {
+                    access_token: tokenData.access_token,
+                    token_type: tokenData.token_type,
+                    refresh_token: tokenData.refresh_token,
+                    scope: tokenData.scope,
+                    merchant_id: tokenData.merchant_id,
+                    expires_in: tokenData.expires_in,
+                    expires_at: expiresAt.toISOString(),
+                },
+                token_injected_to_project: tokenInjected,
+                storage_location: '~/.ratio-v2/tokens.json',
+                next_steps: [
+                    tokenInjected ? '1. Backend .env updated — ready to generate routes' : '1. Call scaffold_backend to create the backend project',
+                    '2. Call generate_api_routes to create resource controllers',
+                ],
+            };
+        },
+    },
+    {
+        name: 'refresh_access_token',
+        description: 'Refresh an expired access token using the refresh token.',
+        inputSchema: z.object({
+            refresh_token: z.string().min(1).describe('Refresh token from get_access_token'),
+            client_id: z.string().min(1).describe('Application Client ID'),
+            client_secret: z.string().min(1).describe('Application Client Secret'),
+        }),
+        handler: async (input) => {
+            const { refresh_token: rt, client_id, client_secret } = input;
+            const tokenData = await refreshToken({ refreshToken: rt, clientId: client_id, clientSecret: client_secret });
+            const expiresAt = new Date(Date.now() + tokenData.expires_in * 1000);
+            // Update persistent store
+            const existing = getToken(client_id);
+            if (existing) {
+                saveToken(client_id, {
+                    ...existing,
+                    access_token: tokenData.access_token,
+                    refresh_token: tokenData.refresh_token,
+                    scopes: tokenData.scope.split(',').map((s) => s.trim()).filter(Boolean),
+                    merchant_id: tokenData.merchant_id,
+                    expires_at: expiresAt.toISOString(),
+                });
+            }
+            return {
+                success: true,
+                message: 'Token refreshed successfully',
+                tokens: {
+                    access_token: tokenData.access_token,
+                    refresh_token: tokenData.refresh_token,
+                    scope: tokenData.scope,
+                    merchant_id: tokenData.merchant_id,
+                    expires_in: tokenData.expires_in,
+                    expires_at: expiresAt.toISOString(),
+                },
+            };
+        },
+    },
+    {
+        name: 'check_token_status',
+        description: 'Check the current access token status for a given client_id.',
+        inputSchema: z.object({
+            client_id: z.string().min(1).describe('Client ID to check token for'),
+        }),
+        handler: async (input) => {
+            const { client_id } = input;
+            const token = getToken(client_id);
+            if (!token) {
+                return { status: 'not_found', message: `No token found for client_id: ${client_id}` };
+            }
+            const expired = isTokenExpired(token);
+            return {
+                status: expired ? 'expired' : 'valid',
+                message: expired ? 'Token is expired. Use refresh_access_token.' : 'Token is valid.',
+                client_id: token.client_id,
+                merchant_id: token.merchant_id,
+                scopes: token.scopes,
+                expires_at: token.expires_at,
+                recommendation: expired ? 'Call refresh_access_token' : 'No action needed',
+            };
+        },
+    },
+];
+//# sourceMappingURL=auth.js.map

package/dist/tools/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,MAAM,CAAC,MAAM,SAAS,GAAqB;IACzC;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,kGAAkG;YAClG,kEAAkE;QACpE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACtF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC9D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YACtF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC5D,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;SAChH,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,KAExD,CAAC;YACF,IAAI,MAAM,GAAI,KAAiC,CAAC,MAA8B,CAAC;YAE/E,mBAAmB;YACnB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,gFAAgF,EAAE,CAAC;gBACpH,CAAC;gBACD,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;gBAC7C,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnD,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;oBAC7B,MAAM,CAAC,IAAI,CAAC,0CAA0C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC9E,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,qCAAqC,MAAM,wCAAwC,EAAE,CAAC;gBACvH,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;YACjI,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;YAEvD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,WAAW;gBACzB,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,+DAA+D;aACzE,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,4EAA4E;YAC5E,wFAAwF;QAC1F,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAClF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC9D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACtE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SACjF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,KAE7D,CAAC;YAEF,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;YAC/I,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;YAErE,MAAM,WAAW,GAAgB;gBAC/B,YAAY,EAAE,SAAS,CAAC,YAAY;gBACpC,aAAa,EAAE,SAAS,CAAC,aAAa;gBACtC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;gBACvE,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE;gBACnC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,aAAa,EAAE,YAAY;aACvC,CAAC;YACF,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAElC,gCAAgC;YAChC,IAAI,aAAa,GAAG,KAAK,CAAC;YAC1B,MAAM,YAAY,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;YAC1D,IAAI,YAAY,EAAE,YAAY,EAAE,CAAC;gBAC/B,MAAM,cAAc,GAAG,GAAG,YAAY,CAAC,YAAY,eAAe,CAAC;gBACnE,uBAAuB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;gBACrD,aAAa,GAAG,IAAI,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,wBAAwB,cAAc,EAAE,CAAC,CAAC;YACxD,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,2BAA2B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7F,MAAM,EAAE;oBACN,YAAY,EAAE,SAAS,CAAC,YAAY;oBACpC,UAAU,EAAE,SAAS,CAAC,UAAU;oBAChC,aAAa,EAAE,SAAS,CAAC,aAAa;oBACtC,KAAK,EAAE,SAAS,CAAC,KAAK;oBACtB,WAAW,EAAE,SAAS,CAAC,WAAW;oBAClC,UAAU,EAAE,SAAS,CAAC,UAAU;oBAChC,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE;iBACpC;gBACD,yBAAyB,EAAE,aAAa;gBACxC,gBAAgB,EAAE,yBAAyB;gBAC3C,UAAU,EAAE;oBACV,aAAa,CAAC,CAAC,CAAC,oDAAoD,CAAC,CAAC,CAAC,wDAAwD;oBAC/H,4DAA4D;iBAC7D;aACF,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YAChF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC9D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SACvE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,KAEvD,CAAC;YAEF,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC;YAC7G,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;YAErE,0BAA0B;YAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrC,IAAI,QAAQ,EAAE,CAAC;gBACb,SAAS,CAAC,SAAS,EAAE;oBACnB,GAAG,QAAQ;oBACX,YAAY,EAAE,SAAS,CAAC,YAAY;oBACpC,aAAa,EAAE,SAAS,CAAC,aAAa;oBACtC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;oBACvE,WAAW,EAAE,SAAS,CAAC,WAAW;oBAClC,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE;iBACpC,CAAC,CAAC;YACL,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,8BAA8B;gBACvC,MAAM,EAAE;oBACN,YAAY,EAAE,SAAS,CAAC,YAAY;oBACpC,aAAa,EAAE,SAAS,CAAC,aAAa;oBACtC,KAAK,EAAE,SAAS,CAAC,KAAK;oBACtB,WAAW,EAAE,SAAS,CAAC,WAAW;oBAClC,UAAU,EAAE,SAAS,CAAC,UAAU;oBAChC,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;SACtE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,EAAE,SAAS,EAAE,GAAG,KAA8B,CAAC;YACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;YAElC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,iCAAiC,SAAS,EAAE,EAAE,CAAC;YACxF,CAAC;YAED,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,OAAO;gBACL,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;gBACrC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,iBAAiB;gBACpF,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB;aAC3E,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/tools/build.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA6BjD,eAAO,MAAM,UAAU,EAAE,cAAc,EAwKtC,CAAC"}

package/dist/tools/build.js

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+import { existsSync, statSync, readdirSync } from 'fs';
+import { join, resolve } from 'path';
+import { homedir } from 'os';
+import { execSync } from 'child_process';
+import { logger } from '../utils/logger.js';
+import { ToolExecutionError, BuildError } from '../utils/errors.js';
+const LOCAL_FS_NOTICE = ' IMPORTANT: This tool runs on the user\'s LOCAL machine filesystem. All paths must be real local paths.';
+function getDirectorySize(dirPath) {
+    let size = 0;
+    try {
+        const entries = readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                size += getDirectorySize(entryPath);
+            }
+            else {
+                size += statSync(entryPath).size;
+            }
+        }
+    }
+    catch { /* ignore */ }
+    return size;
+}
+function findBuildDir(projectPath) {
+    for (const dir of ['dist', 'build', '.next', 'out']) {
+        const candidate = join(projectPath, dir);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+export const buildTools = [
+    {
+        name: 'build_frontend',
+        description: 'Run production build for a React/Vite frontend project. Returns build output path and statistics.' + LOCAL_FS_NOTICE,
+        inputSchema: z.object({
+            project_path: z.string().min(1).describe('Absolute path to the frontend project directory'),
+            install_dependencies: z.boolean().default(true).describe('Install dependencies before building'),
+            build_command: z.string().optional().describe('Custom build command'),
+        }),
+        handler: async (input) => {
+            const { project_path: rawPath, install_dependencies, build_command } = input;
+            const projectPath = rawPath.startsWith('~') ? rawPath.replace('~', homedir()) : rawPath;
+            if (!existsSync(join(projectPath, 'package.json'))) {
+                throw new BuildError(`No package.json found in: ${projectPath}`);
+            }
+            // Detect package manager
+            const hasYarnLock = existsSync(join(projectPath, 'yarn.lock'));
+            const hasPnpmLock = existsSync(join(projectPath, 'pnpm-lock.yaml'));
+            const pm = hasPnpmLock ? 'pnpm' : hasYarnLock ? 'yarn' : 'npm';
+            if (install_dependencies) {
+                logger.info(`Installing dependencies with ${pm}...`);
+                try {
+                    execSync(`${pm} install`, { cwd: projectPath, stdio: 'pipe', timeout: 120000 });
+                }
+                catch (err) {
+                    throw new BuildError(`Dependency installation failed: ${err.message}`);
+                }
+            }
+            const cmd = build_command || 'build';
+            logger.info(`Running build: ${pm} run ${cmd}`);
+            try {
+                const output = execSync(`${pm} run ${cmd}`, { cwd: projectPath, stdio: 'pipe', timeout: 120000 });
+                logger.info('Build completed');
+            }
+            catch (err) {
+                throw new BuildError(`Build failed: ${err.message}`);
+            }
+            const buildDir = findBuildDir(projectPath);
+            if (!buildDir) {
+                throw new BuildError('Build directory not found. Expected dist/, build/, .next/, or out/');
+            }
+            const buildSize = getDirectorySize(buildDir);
+            return {
+                success: true,
+                message: 'Build completed successfully',
+                build_path: buildDir,
+                build_size_bytes: buildSize,
+                build_size_mb: (buildSize / 1024 / 1024).toFixed(2),
+                next_steps: [
+                    `1. Call create_submission_zip with build_path: "${buildDir}"`,
+                    '2. Upload and submit for review',
+                ],
+            };
+        },
+    },
+    {
+        name: 'validate_build',
+        description: 'Validate a frontend build meets Ratio submission requirements.' + LOCAL_FS_NOTICE,
+        inputSchema: z.object({
+            build_path: z.string().min(1).describe('Absolute path to the build output directory'),
+        }),
+        handler: async (input) => {
+            const { build_path: rawPath } = input;
+            const buildPath = rawPath.startsWith('~') ? rawPath.replace('~', homedir()) : rawPath;
+            if (!existsSync(buildPath)) {
+                return { valid: false, errors: [`Build directory not found: ${buildPath}`] };
+            }
+            const errors = [];
+            const warnings = [];
+            // Check for index.html
+            if (!existsSync(join(buildPath, 'index.html'))) {
+                errors.push('Missing index.html in build output');
+            }
+            // Check for JS files
+            const hasJs = readdirSync(buildPath, { recursive: true })
+                .some((f) => String(f).endsWith('.js'));
+            if (!hasJs) {
+                warnings.push('No JavaScript files found in build');
+            }
+            // Check build size
+            const size = getDirectorySize(buildPath);
+            if (size > 50 * 1024 * 1024) {
+                warnings.push(`Build size (${(size / 1024 / 1024).toFixed(1)}MB) exceeds 50MB`);
+            }
+            // Check for sensitive files
+            const sensitiveFiles = ['.env', '.env.local', '.env.production'];
+            for (const sf of sensitiveFiles) {
+                if (existsSync(join(buildPath, sf))) {
+                    errors.push(`Sensitive file found in build: ${sf}`);
+                }
+            }
+            return {
+                valid: errors.length === 0,
+                errors: errors.length > 0 ? errors : undefined,
+                warnings: warnings.length > 0 ? warnings : undefined,
+                build_size_mb: (size / 1024 / 1024).toFixed(2),
+            };
+        },
+    },
+    {
+        name: 'create_submission_zip',
+        description: 'Create a zip file from the build output for submission to Ratio.' + LOCAL_FS_NOTICE,
+        inputSchema: z.object({
+            build_path: z.string().min(1).describe('Absolute path to the build output directory'),
+            output_path: z.string().optional().describe('Output zip file path. Defaults to build_path/../submission.zip'),
+            include_source_maps: z.boolean().default(false).describe('Include .map files in zip'),
+        }),
+        handler: async (input) => {
+            const { build_path: rawPath, output_path: rawOutput, include_source_maps } = input;
+            const buildPath = rawPath.startsWith('~') ? rawPath.replace('~', homedir()) : rawPath;
+            if (!existsSync(buildPath)) {
+                throw new ToolExecutionError('create_submission_zip', `Build directory not found: ${buildPath}`);
+            }
+            const zipPath = rawOutput
+                ? (rawOutput.startsWith('~') ? rawOutput.replace('~', homedir()) : rawOutput)
+                : join(resolve(buildPath, '..'), 'submission.zip');
+            // Use archiver
+            const archiver = (await import('archiver')).default;
+            const { createWriteStream } = await import('fs');
+            return new Promise((resolvePromise, reject) => {
+                const output = createWriteStream(zipPath);
+                const archive = archiver('zip', { zlib: { level: 9 } });
+                output.on('close', () => {
+                    const zipSize = statSync(zipPath).size;
+                    resolvePromise({
+                        success: true,
+                        message: 'Submission zip created',
+                        zip_path: zipPath,
+                        zip_size_bytes: zipSize,
+                        zip_size_mb: (zipSize / 1024 / 1024).toFixed(2),
+                        next_steps: [`1. Call upload_build with zip_path: "${zipPath}"`],
+                    });
+                });
+                archive.on('error', (err) => reject(new BuildError(`Zip creation failed: ${err.message}`)));
+                archive.pipe(output);
+                archive.glob('**/*', {
+                    cwd: buildPath,
+                    ignore: include_source_maps ? [] : ['**/*.map'],
+                });
+                archive.finalize();
+            });
+        },
+    },
+];
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

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

package/dist/tools/codegen.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/tools/codegen.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwPjD,eAAO,MAAM,YAAY,EAAE,cAAc,EA4GxC,CAAC"}