@ratio-mcp/dev-server 1.5.0 → 1.6.0

package/dist/services/orchestrator.js

@@ -1,845 +0,0 @@
-import { getSession, hasCompleted, recordToolSuccess } from './session-state.js';
-import { logger } from '../utils/logger.js';
-// Helper: log the orchestrator decision for every phase
-function logOrchestratorDecision(phase, toolToCall, toolArgs, needsInput) {
-    logger.phase(phase, `tool=${toolToCall}, needsInput=${needsInput}`);
-    logger.info(`[orchestrator] Phase: ${phase}`);
-    logger.info(`[orchestrator] Tool to call: ${toolToCall}`);
-    logger.info(`[orchestrator] Tool args: ${JSON.stringify(toolArgs)}`);
-    logger.info(`[orchestrator] Needs input: ${needsInput}`);
-}
-/**
- * Phase metadata: step count, description, whether it can be skipped.
- */
-const PHASE_METADATA = {
-    auth: {
-        description: 'Developer Authentication',
-        skippable: false,
-        stepCount: 1,
-    },
-    app_setup: {
-        description: 'Create Application',
-        skippable: false,
-        stepCount: 2,
-    },
-    requirements: {
-        description: 'Define Requirements & Scopes',
-        skippable: false,
-        stepCount: 2,
-    },
-    webhooks: {
-        description: 'Configure Webhooks (Optional)',
-        skippable: true,
-        stepCount: 2,
-    },
-    frontend_build: {
-        description: 'Build & Submit Frontend',
-        skippable: false,
-        stepCount: 6,
-    },
-    review_wait: {
-        description: 'Wait for Admin Review',
-        skippable: false,
-        stepCount: 1,
-    },
-    publish_oauth: {
-        description: 'Publish & Complete OAuth',
-        skippable: false,
-        stepCount: 3,
-    },
-    backend_codegen: {
-        description: 'Generate Backend Code',
-        skippable: false,
-        stepCount: 2,
-    },
-    complete: {
-        description: 'Application Complete',
-        skippable: false,
-        stepCount: 1,
-    },
-};
-/**
- * Calculate the absolute step number (across all phases) for progress tracking.
- */
-function calculateAbsoluteStep(phase) {
-    const phases = [
-        'auth', 'app_setup', 'requirements', 'webhooks',
-        'frontend_build', 'review_wait', 'publish_oauth', 'backend_codegen', 'complete'
-    ];
-    let step = 0;
-    for (const p of phases) {
-        if (p === phase)
-            break;
-        step += PHASE_METADATA[p].stepCount;
-    }
-    return step + 1;
-}
-/**
- * Determine which phase the session is currently in.
- */
-function determineCurrentPhase() {
-    const session = getSession();
-    // Phase 1: Auth - check if developer is logged in
-    if (!hasCompleted('developer_login')) {
-        return 'auth';
-    }
-    // Phase 2: App Setup - check if app exists
-    if (!hasCompleted('create_app')) {
-        // If categories haven't been fetched, we need to do that first
-        return 'app_setup';
-    }
-    // Phase 3: Requirements - check if scopes are defined
-    if (!session.context.scopesConfirmed) {
-        return 'requirements';
-    }
-    // Phase 4: Webhooks - optional phase
-    // Skip if user explicitly said skip_webhooks or if we detect they want to skip
-    // Otherwise include webhooks if not yet configured
-    if (!session.context.webhooksConfigured) {
-        // Note: Can be skipped by user
-        return 'webhooks';
-    }
-    // Phase 5: Frontend Build - scaffold, build, zip, upload, submit
-    if (!hasCompleted('submit_for_review')) {
-        return 'frontend_build';
-    }
-    // Phase 6: Review Wait - wait for get_app_status to show approved
-    if (!session.context.appApproved) {
-        return 'review_wait';
-    }
-    // Phase 7: Publish & OAuth - publish app, get auth code, exchange for access token
-    if (!session.context.oauthCompleted) {
-        return 'publish_oauth';
-    }
-    // Phase 8: Backend Codegen - scaffold backend, generate routes
-    if (!hasCompleted('generate_api_routes')) {
-        return 'backend_codegen';
-    }
-    // Phase 9: Complete
-    return 'complete';
-}
-/**
- * Determine the exact next step within the auth phase.
- * Supports two flows:
- *   - Login: email + password → developer_login
- *   - Signup: display_name + email + password → developer_signup → developer_verify_otp → developer_login
- *
- * The user chooses auth_mode ("login" or "signup") in their first input.
- */
-function getAuthPhaseStep(userInput) {
-    const session = getSession();
-    const progress = {
-        current: calculateAbsoluteStep('auth'),
-        total: 15,
-        percentage: Math.round((calculateAbsoluteStep('auth') / 15) * 100),
-    };
-    // If auth_mode was provided in input, store it
-    if (userInput?.['auth_mode']) {
-        session.context.authMode = userInput['auth_mode'];
-    }
-    const authMode = session.context.authMode;
-    // Step 0: Ask user to choose login or signup if not yet decided
-    if (!authMode) {
-        return {
-            phase: 'auth',
-            step: 'Choose Authentication Method',
-            toolToCall: 'developer_login', // default tool (will be overridden based on choice)
-            toolArgs: {},
-            needsInput: true,
-            inputPrompt: 'Do you have an existing Ratio developer account? Provide auth_mode as "login" or "signup".',
-            inputFields: ['auth_mode'],
-            message: 'Welcome! Do you have a Ratio developer account, or do you need to create one?',
-            phase_description: PHASE_METADATA.auth.description,
-            progress,
-        };
-    }
-    // ── Login flow ──────────────────────────────────────────────────────
-    if (authMode === 'login') {
-        return {
-            phase: 'auth',
-            step: 'Developer Login',
-            toolToCall: 'developer_login',
-            toolArgs: {},
-            needsInput: true,
-            inputPrompt: 'Please provide your Ratio developer credentials to authenticate.',
-            inputFields: ['email', 'password'],
-            message: 'Authenticating developer account with Ratio...',
-            phase_description: PHASE_METADATA.auth.description,
-            progress,
-        };
-    }
-    // ── Signup flow ─────────────────────────────────────────────────────
-    // Step 1: Signup (register new account)
-    if (!hasCompleted('developer_signup')) {
-        return {
-            phase: 'auth',
-            step: 'Developer Signup',
-            toolToCall: 'developer_signup',
-            toolArgs: {},
-            needsInput: true,
-            inputPrompt: 'Please provide your details to create a new Ratio developer account.',
-            inputFields: ['display_name', 'email', 'password'],
-            message: 'Creating a new Ratio developer account...',
-            phase_description: PHASE_METADATA.auth.description,
-            progress,
-        };
-    }
-    // Step 2: Verify OTP
-    if (!hasCompleted('developer_verify_otp')) {
-        return {
-            phase: 'auth',
-            step: 'Verify Email OTP',
-            toolToCall: 'developer_verify_otp',
-            toolArgs: {
-                email: session.context.signupEmail || '',
-            },
-            needsInput: true,
-            inputPrompt: 'Enter the verification code sent to your email.',
-            inputFields: ['code'],
-            message: 'A verification code was sent to your email. Please enter it to complete registration.',
-            phase_description: PHASE_METADATA.auth.description,
-            progress,
-        };
-    }
-    // Step 3: Login after signup + verification
-    return {
-        phase: 'auth',
-        step: 'Developer Login',
-        toolToCall: 'developer_login',
-        toolArgs: {},
-        needsInput: true,
-        inputPrompt: 'Your account is verified! Please provide your email and password to log in.',
-        inputFields: ['email', 'password'],
-        message: 'Account verified! Logging in...',
-        phase_description: PHASE_METADATA.auth.description,
-        progress,
-    };
-}
-/**
- * Determine the exact next step within the app_setup phase.
- */
-function getAppSetupPhaseStep(userInput) {
-    const session = getSession();
-    // Step 1: Get categories (if not already done)
-    if (!hasCompleted('get_categories')) {
-        return {
-            phase: 'app_setup',
-            step: 'Fetch App Categories',
-            toolToCall: 'get_categories',
-            toolArgs: {},
-            needsInput: false,
-            message: 'Retrieving available app categories from Ratio...',
-            phase_description: PHASE_METADATA.app_setup.description,
-            progress: {
-                current: calculateAbsoluteStep('app_setup'),
-                total: 15,
-                percentage: Math.round((calculateAbsoluteStep('app_setup') / 15) * 100),
-            },
-        };
-    }
-    // Step 2: Create the app (needs user input for name, description, categories)
-    return {
-        phase: 'app_setup',
-        step: 'Create Application',
-        toolToCall: 'create_app',
-        toolArgs: {},
-        needsInput: true,
-        inputPrompt: 'IMPORTANT: You MUST present the fetched categories (from the previous step\'s data) to the developer as a numbered list ' +
-            'and ask them to choose which categories fit their app. Do NOT pick categories on the developer\'s behalf.\n\n' +
-            'Then ask the developer for:\n' +
-            '1. App name\n' +
-            '2. Short description of the app\n' +
-            '3. Which categories they want (from the list you showed)\n' +
-            '4. OAuth callback URL (suggest http://localhost:3000/callback as default)\n\n' +
-            'Once the developer confirms, provide all fields in input_data with category_ids as an array of slug strings.',
-        inputFields: ['name', 'description', 'category_ids', 'redirect_uri'],
-        message: 'Categories fetched. Now the developer needs to provide app details and select categories.',
-        phase_description: PHASE_METADATA.app_setup.description,
-        progress: {
-            current: calculateAbsoluteStep('app_setup') + 1,
-            total: 15,
-            percentage: Math.round(((calculateAbsoluteStep('app_setup') + 1) / 15) * 100),
-        },
-    };
-}
-/**
- * Determine the exact next step within the requirements phase.
- */
-function getRequirementsPhaseStep(userInput) {
-    const session = getSession();
-    // Step 1: Gather requirements (NL → scope recommendations)
-    // If we already have the developer's app description (captured from their first message
-    // or from the app creation step), auto-feed it — no need to ask again.
-    if (!hasCompleted('gather_requirements')) {
-        const hasDescription = !!session.context.appDescription;
-        return {
-            phase: 'requirements',
-            step: 'Gather Requirements',
-            toolToCall: 'gather_requirements',
-            toolArgs: {
-                app_id: session.context.appId || '',
-                // Auto-fill from stored description if available
-                ...(hasDescription ? { app_description: session.context.appDescription } : {}),
-            },
-            needsInput: !hasDescription,
-            inputPrompt: hasDescription
-                ? undefined
-                : 'Describe what your app needs to do (e.g., "I want to view orders and manage discounts").',
-            inputFields: hasDescription ? undefined : ['app_description'],
-            message: hasDescription
-                ? `Analyzing your requirements ("${session.context.appDescription.substring(0, 60)}...") to recommend scopes...`
-                : 'Please describe what your app needs to do so we can recommend the right scopes.',
-            phase_description: PHASE_METADATA.requirements.description,
-            progress: {
-                current: calculateAbsoluteStep('requirements'),
-                total: 15,
-                percentage: Math.round((calculateAbsoluteStep('requirements') / 15) * 100),
-            },
-        };
-    }
-    // Step 2: Define app requirements (confirm scopes from recommendations)
-    if (!session.context.scopesConfirmed) {
-        return {
-            phase: 'requirements',
-            step: 'Confirm Scopes',
-            toolToCall: 'define_app_requirements',
-            toolArgs: {
-                app_id: session.context.appId,
-                app_name: session.context.appName,
-            },
-            needsInput: true,
-            inputPrompt: 'IMPORTANT: You MUST present the recommended scopes (from the previous step\'s data) to the developer. ' +
-                'Show each scope code, its resource, and why it was recommended. ' +
-                'Do NOT confirm scopes on the developer\'s behalf — ask them to review and approve or modify the list.\n\n' +
-                'Once the developer confirms, call with input_data: { "scopes": ["read_orders", ...], "confirmed": true }',
-            inputFields: ['scopes', 'confirmed'],
-            message: 'Scope recommendations ready. The developer needs to review and confirm.',
-            phase_description: PHASE_METADATA.requirements.description,
-            progress: {
-                current: calculateAbsoluteStep('requirements') + 1,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('requirements') + 1) / 15) * 100),
-            },
-        };
-    }
-    // Should not reach here if requirements are confirmed — fall through
-    return {
-        phase: 'requirements',
-        step: 'Requirements Complete',
-        toolToCall: 'gather_requirements',
-        toolArgs: { app_id: session.context.appId || '' },
-        needsInput: false,
-        message: 'Requirements have been confirmed. Moving to next phase...',
-        phase_description: PHASE_METADATA.requirements.description,
-        progress: {
-            current: calculateAbsoluteStep('requirements') + 2,
-            total: 15,
-            percentage: Math.round(((calculateAbsoluteStep('requirements') + 2) / 15) * 100),
-        },
-    };
-}
-/**
- * Determine the exact next step within the webhooks phase.
- */
-function getWebhooksPhaseStep(userInput) {
-    const session = getSession();
-    // If user explicitly skipped webhooks, mark as configured
-    if (userInput?.skip === true) {
-        session.context.webhooksConfigured = true;
-        recordToolSuccess('skip_webhooks', { skipped: true });
-        return {
-            phase: 'webhooks',
-            step: 'Webhooks Skipped',
-            toolToCall: 'skip_webhooks',
-            toolArgs: {},
-            needsInput: false,
-            message: 'Webhook configuration skipped. You can set them up later in the dashboard.',
-            phase_description: PHASE_METADATA.webhooks.description,
-            progress: {
-                current: calculateAbsoluteStep('webhooks') + 2,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('webhooks') + 2) / 15) * 100),
-            },
-        };
-    }
-    // Step 1: Get webhook topics (optional, but shows available events)
-    if (!hasCompleted('get_webhook_topics')) {
-        return {
-            phase: 'webhooks',
-            step: 'Fetch Webhook Topics',
-            toolToCall: 'get_webhook_topics',
-            toolArgs: {},
-            needsInput: false,
-            message: 'Retrieving available webhook event types...',
-            phase_description: PHASE_METADATA.webhooks.description,
-            progress: {
-                current: calculateAbsoluteStep('webhooks'),
-                total: 15,
-                percentage: Math.round((calculateAbsoluteStep('webhooks') / 15) * 100),
-            },
-        };
-    }
-    // Step 2: Create webhooks (or skip if user chooses)
-    return {
-        phase: 'webhooks',
-        step: 'Create Webhook Subscriptions',
-        toolToCall: 'create_webhooks',
-        toolArgs: {
-            app_id: session.context.appId,
-        },
-        needsInput: true,
-        inputPrompt: 'Provide your webhook endpoint URL and select which events to subscribe to. Or enter "skip" to skip webhook setup.',
-        inputFields: ['webhook_url', 'event_names'],
-        message: 'Setting up webhook subscriptions for real-time events...',
-        phase_description: PHASE_METADATA.webhooks.description,
-        progress: {
-            current: calculateAbsoluteStep('webhooks') + 1,
-            total: 15,
-            percentage: Math.round(((calculateAbsoluteStep('webhooks') + 1) / 15) * 100),
-        },
-    };
-}
-/**
- * Determine the exact next step within the frontend_build phase.
- */
-function getFrontendBuildPhaseStep(userInput) {
-    const session = getSession();
-    // Step 1: Scaffold frontend
-    if (!hasCompleted('scaffold_frontend')) {
-        return {
-            phase: 'frontend_build',
-            step: 'Scaffold Frontend Project',
-            toolToCall: 'scaffold_frontend',
-            toolArgs: {
-                app_name: session.context.appName,
-                client_id: session.context.clientId,
-                project_path: '~/Desktop',
-            },
-            needsInput: true,
-            inputPrompt: 'Ask the developer what they want to name the project (project_name). The project will be created on their Desktop by default.',
-            inputFields: ['project_name'],
-            message: 'Creating a new React + Vite frontend project...',
-            phase_description: PHASE_METADATA.frontend_build.description,
-            progress: {
-                current: calculateAbsoluteStep('frontend_build'),
-                total: 15,
-                percentage: Math.round((calculateAbsoluteStep('frontend_build') / 15) * 100),
-            },
-        };
-    }
-    // Step 2: Build frontend
-    if (!hasCompleted('build_frontend')) {
-        return {
-            phase: 'frontend_build',
-            step: 'Build Frontend',
-            toolToCall: 'build_frontend',
-            toolArgs: {
-                project_path: session.context.projectPath || '',
-            },
-            needsInput: false,
-            message: 'Building production frontend bundle...',
-            phase_description: PHASE_METADATA.frontend_build.description,
-            progress: {
-                current: calculateAbsoluteStep('frontend_build') + 1,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('frontend_build') + 1) / 15) * 100),
-            },
-        };
-    }
-    // Step 3: Validate build
-    if (!hasCompleted('validate_build')) {
-        return {
-            phase: 'frontend_build',
-            step: 'Validate Build',
-            toolToCall: 'validate_build',
-            toolArgs: {
-                build_path: session.context.buildPath || '',
-            },
-            needsInput: false,
-            message: 'Validating build meets Ratio submission requirements...',
-            phase_description: PHASE_METADATA.frontend_build.description,
-            progress: {
-                current: calculateAbsoluteStep('frontend_build') + 2,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('frontend_build') + 2) / 15) * 100),
-            },
-        };
-    }
-    // Step 4: Create submission ZIP
-    if (!hasCompleted('create_submission_zip')) {
-        return {
-            phase: 'frontend_build',
-            step: 'Create Submission Archive',
-            toolToCall: 'create_submission_zip',
-            toolArgs: {
-                build_path: session.context.buildPath || '',
-            },
-            needsInput: false,
-            message: 'Creating ZIP archive for submission...',
-            phase_description: PHASE_METADATA.frontend_build.description,
-            progress: {
-                current: calculateAbsoluteStep('frontend_build') + 3,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('frontend_build') + 3) / 15) * 100),
-            },
-        };
-    }
-    // Step 5: Upload build ZIP to create a version
-    if (!hasCompleted('upload_build')) {
-        return {
-            phase: 'frontend_build',
-            step: 'Upload Build',
-            toolToCall: 'upload_build',
-            toolArgs: {
-                app_id: session.context.appId,
-                zip_path: session.context.zipPath || '',
-            },
-            needsInput: true,
-            inputPrompt: 'Provide version number and changelog for your build upload.',
-            inputFields: ['version', 'changelog'],
-            message: 'Uploading build ZIP to create a new app version...',
-            phase_description: PHASE_METADATA.frontend_build.description,
-            progress: {
-                current: calculateAbsoluteStep('frontend_build') + 4,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('frontend_build') + 4) / 15) * 100),
-            },
-        };
-    }
-    // Step 6: Submit for review
-    if (!hasCompleted('submit_for_review')) {
-        return {
-            phase: 'frontend_build',
-            step: 'Submit for Review',
-            toolToCall: 'submit_for_review',
-            toolArgs: {
-                app_id: session.context.appId,
-            },
-            needsInput: false,
-            message: 'Submitting app for admin review...',
-            phase_description: PHASE_METADATA.frontend_build.description,
-            progress: {
-                current: calculateAbsoluteStep('frontend_build') + 5,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('frontend_build') + 5) / 15) * 100),
-            },
-        };
-    }
-    // Should not reach here
-    return {
-        phase: 'frontend_build',
-        step: 'Frontend Build Complete',
-        toolToCall: 'get_app_status',
-        toolArgs: { app_id: session.context.appId },
-        needsInput: false,
-        message: 'Frontend build and submission complete.',
-        phase_description: PHASE_METADATA.frontend_build.description,
-        progress: {
-            current: calculateAbsoluteStep('frontend_build') + 5,
-            total: 15,
-            percentage: Math.round(((calculateAbsoluteStep('frontend_build') + 5) / 15) * 100),
-        },
-    };
-}
-/**
- * Determine the exact next step within the review_wait phase.
- */
-function getReviewWaitPhaseStep(userInput) {
-    const session = getSession();
-    return {
-        phase: 'review_wait',
-        step: 'Wait for Admin Review',
-        toolToCall: 'get_app_status',
-        toolArgs: {
-            app_id: session.context.appId,
-        },
-        needsInput: false,
-        message: 'Checking admin review status... Your app will be reviewed shortly.',
-        phase_description: PHASE_METADATA.review_wait.description,
-        progress: {
-            current: calculateAbsoluteStep('review_wait'),
-            total: 15,
-            percentage: Math.round((calculateAbsoluteStep('review_wait') / 15) * 100),
-        },
-    };
-}
-/**
- * Determine the exact next step within the publish_oauth phase.
- */
-function getPublishOAuthPhaseStep(userInput) {
-    const session = getSession();
-    logger.info(`[orchestrator] publish_oauth phase — clientId=${session.context.clientId}, clientSecret exists=${!!session.context.clientSecret}, appId=${session.context.appId}, appPublished=${session.context.appPublished}, oauthCompleted=${session.context.oauthCompleted}`);
-    logger.info(`[orchestrator] publish_oauth — authCode=${session.context.authCode?.substring(0, 12) ?? 'undefined'}..., latestVersionId=${session.context.latestVersionId}`);
-    // Step 1: Publish app (if not already done)
-    if (!hasCompleted('publish_app')) {
-        return {
-            phase: 'publish_oauth',
-            step: 'Publish Application',
-            toolToCall: 'publish_app',
-            toolArgs: {
-                app_id: session.context.appId,
-                version_id: session.context.latestVersionId || '',
-            },
-            needsInput: false,
-            message: 'Publishing your approved app to the Ratio marketplace...',
-            phase_description: PHASE_METADATA.publish_oauth.description,
-            progress: {
-                current: calculateAbsoluteStep('publish_oauth'),
-                total: 15,
-                percentage: Math.round((calculateAbsoluteStep('publish_oauth') / 15) * 100),
-            },
-        };
-    }
-    // Step 2: Request authorization code
-    if (!hasCompleted('request_auth_code')) {
-        return {
-            phase: 'publish_oauth',
-            step: 'Request Authorization Code',
-            toolToCall: 'request_auth_code',
-            toolArgs: {
-                client_id: session.context.clientId,
-                app_id: session.context.appId,
-                scopes: session.context.confirmedScopes,
-            },
-            needsInput: true,
-            inputPrompt: 'Provide the merchant ID for OAuth testing.',
-            inputFields: ['merchant_id'],
-            message: 'Requesting OAuth authorization code for app installation...',
-            phase_description: PHASE_METADATA.publish_oauth.description,
-            progress: {
-                current: calculateAbsoluteStep('publish_oauth') + 1,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('publish_oauth') + 1) / 15) * 100),
-            },
-        };
-    }
-    // Step 3: Exchange auth code for access token
-    if (!hasCompleted('get_access_token')) {
-        const hasAuthCode = !!session.context.authCode;
-        return {
-            phase: 'publish_oauth',
-            step: 'Exchange for Access Token',
-            toolToCall: 'get_access_token',
-            toolArgs: {
-                client_id: session.context.clientId,
-                client_secret: session.context.clientSecret,
-                ...(hasAuthCode ? {
-                    auth_code: session.context.authCode,
-                    redirect_uri: session.context.authCodeRedirectUri || 'http://localhost:3000/callback',
-                } : {}),
-            },
-            needsInput: !hasAuthCode,
-            inputPrompt: hasAuthCode ? undefined : 'Provide the authorization code received from the OAuth flow.',
-            inputFields: hasAuthCode ? undefined : ['auth_code'],
-            message: hasAuthCode
-                ? 'Auth code available. Exchanging for access and refresh tokens...'
-                : 'Exchanging authorization code for access and refresh tokens...',
-            phase_description: PHASE_METADATA.publish_oauth.description,
-            progress: {
-                current: calculateAbsoluteStep('publish_oauth') + 2,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('publish_oauth') + 2) / 15) * 100),
-            },
-        };
-    }
-    return {
-        phase: 'publish_oauth',
-        step: 'OAuth Complete',
-        toolToCall: 'check_token_status',
-        toolArgs: { client_id: session.context.clientId },
-        needsInput: false,
-        message: 'OAuth flow complete. Access token is ready for use.',
-        phase_description: PHASE_METADATA.publish_oauth.description,
-        progress: {
-            current: calculateAbsoluteStep('publish_oauth') + 3,
-            total: 15,
-            percentage: Math.round(((calculateAbsoluteStep('publish_oauth') + 3) / 15) * 100),
-        },
-    };
-}
-/**
- * Determine the exact next step within the backend_codegen phase.
- */
-function getBackendCodegenPhaseStep(userInput) {
-    const session = getSession();
-    logger.info(`[orchestrator] backend_codegen phase — clientId=${session.context.clientId}, hasClientSecret=${!!session.context.clientSecret}, projectPath=${session.context.projectPath}, appId=${session.context.appId}`);
-    logger.info(`[orchestrator] backend_codegen — oauthCompleted=${session.context.oauthCompleted}, completedTools=[${[...session.completedTools].join(', ')}]`);
-    // Step 1: Scaffold backend
-    if (!hasCompleted('scaffold_backend')) {
-        const hasProjectPath = !!session.context.projectPath;
-        logger.info(`[orchestrator] scaffold_backend about to be called with: app_name=${session.context.appName}, client_id=${session.context.clientId}, hasClientSecret=${!!session.context.clientSecret}, hasProjectPath=${hasProjectPath}, projectPath=${session.context.projectPath}`);
-        const toolArgs = {
-            app_name: session.context.appName,
-            client_id: session.context.clientId,
-            client_secret: session.context.clientSecret,
-            ...(hasProjectPath ? { project_path: session.context.projectPath } : {}),
-        };
-        logOrchestratorDecision('backend_codegen', 'scaffold_backend', toolArgs, !hasProjectPath);
-        return {
-            phase: 'backend_codegen',
-            step: 'Scaffold Backend Project',
-            toolToCall: 'scaffold_backend',
-            toolArgs,
-            needsInput: !hasProjectPath,
-            inputPrompt: hasProjectPath ? undefined : 'Provide the path to your project directory.',
-            inputFields: hasProjectPath ? undefined : ['project_path'],
-            message: hasProjectPath
-                ? `Creating NestJS backend at ${session.context.projectPath}/backend...`
-                : 'Creating a NestJS backend project with OAuth credentials...',
-            phase_description: PHASE_METADATA.backend_codegen.description,
-            progress: {
-                current: calculateAbsoluteStep('backend_codegen'),
-                total: 15,
-                percentage: Math.round((calculateAbsoluteStep('backend_codegen') / 15) * 100),
-            },
-        };
-    }
-    // Step 2: Generate API routes
-    if (!hasCompleted('generate_api_routes')) {
-        const genArgs = {
-            app_id: session.context.appId,
-            project_path: session.context.projectPath || '',
-        };
-        logger.info(`[orchestrator] generate_api_routes about to be called with: app_id=${session.context.appId}, project_path=${session.context.projectPath}`);
-        logOrchestratorDecision('backend_codegen', 'generate_api_routes', genArgs, false);
-        return {
-            phase: 'backend_codegen',
-            step: 'Generate API Routes',
-            toolToCall: 'generate_api_routes',
-            toolArgs: genArgs,
-            needsInput: false,
-            message: 'Generating NestJS controllers and services based on your scopes...',
-            phase_description: PHASE_METADATA.backend_codegen.description,
-            progress: {
-                current: calculateAbsoluteStep('backend_codegen') + 1,
-                total: 15,
-                percentage: Math.round(((calculateAbsoluteStep('backend_codegen') + 1) / 15) * 100),
-            },
-        };
-    }
-    return {
-        phase: 'backend_codegen',
-        step: 'Backend Generation Complete',
-        toolToCall: 'generate_api_routes',
-        toolArgs: { app_id: session.context.appId, project_path: session.context.projectPath || '' },
-        needsInput: false,
-        message: 'Backend code generation complete. Your API routes are ready.',
-        phase_description: PHASE_METADATA.backend_codegen.description,
-        progress: {
-            current: calculateAbsoluteStep('backend_codegen') + 2,
-            total: 15,
-            percentage: Math.round(((calculateAbsoluteStep('backend_codegen') + 2) / 15) * 100),
-        },
-    };
-}
-/**
- * Determine the exact next step in the complete phase.
- */
-function getCompletePhaseStep() {
-    return {
-        phase: 'complete',
-        step: 'All Done!',
-        toolToCall: 'noop',
-        toolArgs: {},
-        needsInput: false,
-        message: 'Congratulations! Your Ratio app development is complete. You can now manage your app in the dashboard.',
-        phase_description: PHASE_METADATA.complete.description,
-        progress: {
-            current: 15,
-            total: 15,
-            percentage: 100,
-        },
-    };
-}
-/**
- * Main orchestrator function: determines the exact next step based on session state.
- *
- * @param userInput - Optional user input (credentials, selections, configuration details)
- * @returns OrchestratorResult describing what to do next
- */
-export function getNextStep(userInput) {
-    try {
-        const phase = determineCurrentPhase();
-        switch (phase) {
-            case 'auth':
-                return getAuthPhaseStep(userInput);
-            case 'app_setup':
-                return getAppSetupPhaseStep(userInput);
-            case 'requirements':
-                return getRequirementsPhaseStep(userInput);
-            case 'webhooks':
-                return getWebhooksPhaseStep(userInput);
-            case 'frontend_build':
-                return getFrontendBuildPhaseStep(userInput);
-            case 'review_wait':
-                return getReviewWaitPhaseStep(userInput);
-            case 'publish_oauth':
-                return getPublishOAuthPhaseStep(userInput);
-            case 'backend_codegen':
-                return getBackendCodegenPhaseStep(userInput);
-            case 'complete':
-                return getCompletePhaseStep();
-            default:
-                // Fallback (should never reach)
-                return getCompletePhaseStep();
-        }
-    }
-    catch (error) {
-        // If anything goes wrong, return a safe default
-        logger.error('Orchestrator error:', error);
-        return {
-            phase: 'auth',
-            step: 'Error - Restart',
-            toolToCall: 'developer_login',
-            toolArgs: {},
-            needsInput: true,
-            inputPrompt: 'An error occurred. Please try authenticating again.',
-            inputFields: ['email', 'password'],
-            message: 'An error occurred in the orchestrator. Please restart.',
-            phase_description: PHASE_METADATA.auth.description,
-            progress: { current: 0, total: 15, percentage: 0 },
-        };
-    }
-}
-/**
- * Get the current phase without computing the next step details.
- * Useful for status checks and phase-only queries.
- */
-export function getCurrentPhase() {
-    return determineCurrentPhase();
-}
-/**
- * Get a human-friendly description of a phase.
- */
-export function getPhaseDescription(phase) {
-    return PHASE_METADATA[phase]?.description || 'Unknown Phase';
-}
-/**
- * Check if a phase can be skipped by the user.
- * Currently only webhooks is optional.
- */
-export function canSkipPhase(phase) {
-    return PHASE_METADATA[phase]?.skippable ?? false;
-}
-/**
- * Get the total number of steps across all phases.
- */
-export function getTotalSteps() {
-    return Object.values(PHASE_METADATA).reduce((sum, meta) => sum + meta.stepCount, 0);
-}
-/**
- * Get metadata about a specific phase (description, step count, skippable).
- */
-export function getPhaseMetadata(phase) {
-    return PHASE_METADATA[phase];
-}
-/**
- * Helper: Get all phases in order.
- */
-export function getAllPhases() {
-    return [
-        'auth', 'app_setup', 'requirements', 'webhooks',
-        'frontend_build', 'review_wait', 'publish_oauth', 'backend_codegen', 'complete'
-    ];
-}
-//# sourceMappingURL=orchestrator.js.map