@kya-os/cli 0.1.0-beta.8 → 1.0.0-beta-0.1

package/dist/commands/init.js

@@ -1,12 +1,15 @@
-import { enableMCPIdentity } from "@kya-os/mcp-i";
+import { enableMCPIdentityCLI, } from "@kya-os/mcp-i/cli-internal";
 import chalk from "chalk";
 import ora from "ora";
 import { detectPlatform, getPlatformSpecificConfig, } from "../utils/platform-detector.js";
 import { EnvManager } from "../utils/env-manager.js";
-import { promptForInit, showSuccess, showError, showWarning, } from "../utils/prompts.js";
+import { promptForInit, showError, showWarning, confirmMcpVariableReplacement, } from "../utils/prompts.js";
 import { existsSync } from "fs";
 import { join } from "path";
 import { cliEffects } from "../effects/cli-integration.js";
+import { createAgentTable, createClaimTable, createWelcomeBanner, createGradientBox, createSuccessBox, } from "../components/index.js";
+import { showScreen } from "../utils/screen-manager.js";
+import { validateInput, initOptionsSchema } from "../utils/validation.js";
 async function checkRegistryHealth(verbose = false) {
     const healthSpinner = ora("Checking registry status...").start();
     try {
@@ -68,15 +71,46 @@ async function checkRegistryHealth(verbose = false) {
 async function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-async function attemptRegistrationWithRetry(config, verbose = false, maxRetries = 3) {
+async function attemptRegistrationWithRetry(config, verbose = false, maxRetries = 3, onProgress) {
     const baseDelay = 2000; // Start with 2 seconds
     for (let attempt = 1; attempt <= maxRetries; attempt++) {
         const isLastAttempt = attempt === maxRetries;
-        const spinner = ora(`Registering agent with knowthat.ai... (attempt ${attempt}/${maxRetries})`).start();
+        const spinner = ora(`Connecting to KYA-OS network... (attempt ${attempt}/${maxRetries})`).start();
         try {
-            const identity = await enableMCPIdentity(config);
-            spinner.succeed("Creating Agent ID");
-            return { success: true, identity };
+            const result = await enableMCPIdentityCLI({
+                ...config,
+                onProgress: async (event) => {
+                    // Update spinner based on progress
+                    switch (event.stage) {
+                        case "checking_existing":
+                            spinner.text = "Checking for existing identity...";
+                            break;
+                        case "generating_keys":
+                            spinner.text = "Generating cryptographic keys...";
+                            break;
+                        case "registering":
+                            spinner.text = "Registering with KYA-OS network...";
+                            break;
+                        case "saving":
+                            spinner.text = "Saving identity...";
+                            break;
+                        case "complete":
+                            spinner.succeed("Agent registered successfully!");
+                            break;
+                    }
+                    // Call the provided callback if any
+                    if (onProgress) {
+                        await onProgress(event);
+                    }
+                },
+            });
+            // The mcp-i package now handles async registration internally
+            // We just get the final result
+            return {
+                success: true,
+                identity: result.identity,
+                metadata: result.metadata,
+            };
         }
         catch (error) {
             spinner.fail(`Registration attempt ${attempt} failed`);
@@ -225,6 +259,17 @@ function handleRegistrationError(_error, errorInfo, verbose, isFinalAttempt) {
 }
 export async function init(options) {
     try {
+        // Validate options
+        const validatedOptions = validateInput(initOptionsSchema, options, "init options");
+        // Show welcome banner
+        try {
+            const banner = await createWelcomeBanner("KYA-OS");
+            console.log(banner);
+        }
+        catch (err) {
+            // Fallback if figlet fails
+            console.log(chalk.cyan.bold("\n🚀 MCP-I Initialization\n"));
+        }
         // Detect platform
         const platformInfo = detectPlatform();
         console.log(chalk.cyan("\n🔍 Detected environment:"));
@@ -237,21 +282,21 @@ export async function init(options) {
         const envManager = new EnvManager();
         const existingIdentityFile = existsSync(join(process.cwd(), ".mcp-identity.json"));
         const existingEnvVars = envManager.getFromProcess();
-        if ((existingIdentityFile || existingEnvVars.MCP_IDENTITY_DID) &&
-            !options.force) {
+        if ((existingIdentityFile || existingEnvVars.MCP_IDENTITY_AGENT_DID) &&
+            !validatedOptions.force) {
             showWarning("MCP-I is already configured in this project.");
             console.log("Use --force to reconfigure.");
             // Show current configuration
-            if (existingEnvVars.MCP_IDENTITY_DID) {
-                console.log(`\nCurrent DID: ${chalk.green(existingEnvVars.MCP_IDENTITY_DID)}`);
+            if (existingEnvVars.MCP_IDENTITY_AGENT_DID) {
+                console.log(`\nCurrent DID: ${chalk.green(existingEnvVars.MCP_IDENTITY_AGENT_DID)}`);
             }
             return;
         }
         // Prompt for configuration
         const answers = await promptForInit({
-            name: options.name,
-            description: options.description,
-            repository: options.repository,
+            name: validatedOptions.name,
+            description: validatedOptions.description,
+            repository: validatedOptions.repository,
         });
         // Determine directories configuration
         let directories;
@@ -268,9 +313,9 @@ export async function init(options) {
         const platformConfig = getPlatformSpecificConfig(platformInfo.platform);
         let identity;
         let envVars = null;
-        if (!options.skipRegistration && answers.confirmRegistration) {
+        if (!validatedOptions.skipRegistration && answers.confirmRegistration) {
             // Check registry health first
-            const healthCheck = await checkRegistryHealth(options.verbose);
+            const healthCheck = await checkRegistryHealth(validatedOptions.verbose);
             if (!healthCheck.available && !healthCheck.shouldProceed) {
                 console.log("\nYou can still create the configuration files and register later.");
                 answers.confirmEnvCreation = await promptForInit({
@@ -278,239 +323,244 @@ export async function init(options) {
                 }).then((a) => a.confirmEnvCreation);
             }
             else {
-                // Register agent with retry logic
-                const registrationResult = await attemptRegistrationWithRetry({
-                    name: answers.name,
-                    description: answers.description,
-                    repository: answers.repository,
-                    directories: directories,
-                    storage: platformConfig.storage,
-                    transport: platformConfig.transport,
-                    mode: "production",
-                    logLevel: "silent",
-                }, options.verbose);
+                // Register agent with retry logic and enhanced error handling
+                let registrationResult;
+                try {
+                    registrationResult = await attemptRegistrationWithRetry({
+                        name: answers.name,
+                        description: answers.description,
+                        repository: answers.repository,
+                        directories: directories,
+                        storage: platformConfig.storage,
+                        transport: platformConfig.transport,
+                        mode: "production",
+                        logLevel: "silent",
+                    }, validatedOptions.verbose, 3, // maxRetries
+                    async (event) => {
+                        // Handle progress events for spinner updates
+                        // The blackhole effect will be shown after successful registration
+                    });
+                }
+                catch (registrationError) {
+                    // Enhanced error handling for common scenarios
+                    if (registrationError.message?.includes("already exists") ||
+                        registrationError.message?.includes("name taken") ||
+                        registrationError.response?.status === 409) {
+                        showError("Agent name already exists in the registry.");
+                        console.log(chalk.yellow("\n🔍 This usually means:"));
+                        console.log("  1. You previously registered this agent name");
+                        console.log("  2. Your .env file was deleted/missing");
+                        console.log("  3. Someone else is using this name\n");
+                        console.log(chalk.cyan("💡 Solutions:"));
+                        console.log("  1. If this is YOUR agent, restore your .env file:");
+                        console.log(`     ${chalk.green('MCP_IDENTITY_AGENT_DID="did:web:knowthat.ai:agents:' +
+                            answers.name +
+                            '"')}`);
+                        console.log(`     ${chalk.green('MCP_IDENTITY_AGENT_PUBLIC_KEY="your-public-key"')}`);
+                        console.log(`     ${chalk.green('MCP_IDENTITY_AGENT_PRIVATE_KEY="your-private-key"')}`);
+                        console.log("\n  2. Or choose a different agent name");
+                        console.log(`  3. Or visit: ${chalk.blue("https://knowthat.ai/agents/claim")}\n`);
+                        process.exit(1);
+                    }
+                    // For other errors, show them and continue with config creation option
+                    showError(`Registration failed: ${registrationError.message}`);
+                    console.log("\nYou can still create the configuration files and register later.");
+                    answers.confirmEnvCreation = await promptForInit({
+                        confirmEnvCreation: true,
+                    }).then((a) => a.confirmEnvCreation);
+                    registrationResult = { success: false };
+                }
                 if (registrationResult.success && registrationResult.identity) {
                     identity = registrationResult.identity;
+                    const metadata = registrationResult.metadata;
                     // Extract environment variables
                     envVars = {
-                        MCP_IDENTITY_DID: identity.did,
-                        MCP_IDENTITY_PUBLIC_KEY: identity.publicKey,
-                        MCP_IDENTITY_PRIVATE_KEY: identity.privateKey || "",
+                        MCP_IDENTITY_AGENT_DID: identity.did,
+                        MCP_IDENTITY_AGENT_PUBLIC_KEY: identity.publicKey,
+                        MCP_IDENTITY_AGENT_PRIVATE_KEY: identity.privateKey || "",
                         MCP_IDENTITY_AGENT_ID: identity.agentId || "",
                         MCP_IDENTITY_AGENT_SLUG: identity.agentSlug || "",
                     };
-                    // Clear some space for the effect
-                    console.log("\n");
-                    // Show DID generation with Blackhole effect
-                    const didGenerationText = `🔐 ${chalk.bold("Generating Decentralized Identity")}\n` +
-                        `\n` +
-                        `DID: ${chalk.green(identity.did)}`;
-                    await cliEffects.showCustomEffect("blackhole", didGenerationText, {
-                        config: {
-                            duration: 5000, // Increased duration for smoother transition
-                            blackholeColor: "ffffff",
-                            starColors: [
-                                "ffcc0d",
-                                "ff7326",
-                                "ff194d",
-                                "bf2669",
-                                "702a8c",
-                                "049dbf",
-                            ],
-                            finalColor: "00ff00",
-                            useGradient: true,
-                            gradientDirection: "diagonal",
-                            blackholeSize: 0.3,
-                        },
-                        persistent: true, // Keep the DID visible after animation
-                        skipExitPrompt: true, // Don't show "Press any key to exit"
-                    });
-                    // Get claim URL if available
-                    let claimUrl = null;
-                    try {
-                        const result = await identity.requestEditAccess();
-                        claimUrl = result.claimUrl;
-                    }
-                    catch (error) {
-                        // Ignore errors - claim URL is optional
-                    }
-                    // Wait a moment for the effect to finish and let the user see the DID
-                    await new Promise(resolve => setTimeout(resolve, 2000));
-                    // Gentle fade by adding some spacing before clearing
-                    console.log("\n\n\n");
-                    await new Promise(resolve => setTimeout(resolve, 300));
-                    // Clear screen and show elegant agent identity card
-                    console.clear();
-                    // Display elegant agent identity card
-                    console.log("\n");
-                    console.log(chalk.cyan("╔═══════════════════════════════════════════════════════════════════════╗"));
-                    console.log(chalk.cyan("║") + chalk.bold.white("                    🤖 AGENT IDENTITY CREATED                          ") + chalk.cyan("║"));
-                    console.log(chalk.cyan("╠═══════════════════════════════════════════════════════════════════════╣"));
-                    console.log(chalk.cyan("║                                                                       ║"));
-                    console.log(chalk.cyan("║") + chalk.bold("  Agent Name: ") + chalk.yellow(answers.name.padEnd(57)) + chalk.cyan("║"));
-                    console.log(chalk.cyan("║") + chalk.bold("  Description: ") + chalk.gray((answers.description || "").substring(0, 56).padEnd(56)) + chalk.cyan("║"));
-                    if (answers.description && answers.description.length > 56) {
-                        console.log(chalk.cyan("║") + "                " + chalk.gray(answers.description.substring(56, 112).padEnd(55)) + chalk.cyan("║"));
-                    }
-                    console.log(chalk.cyan("║                                                                       ║"));
-                    console.log(chalk.cyan("║") + chalk.bold("  DID: ") + chalk.green(identity.did.substring(0, 64).padEnd(64)) + chalk.cyan("║"));
-                    if (identity.did.length > 64) {
-                        console.log(chalk.cyan("║") + "        " + chalk.green(identity.did.substring(64).padEnd(63)) + chalk.cyan("║"));
+                    // Show blackhole effect for successful registrations
+                    if (validatedOptions.verbose) {
+                        console.log(chalk.gray(`[DEBUG] metadata.isNewIdentity: ${metadata?.isNewIdentity}`));
+                        console.log(chalk.gray(`[DEBUG] Full metadata: ${JSON.stringify(metadata)}`));
                     }
-                    console.log(chalk.cyan("║                                                                       ║"));
-                    console.log(chalk.cyan("║") + chalk.bold("  Profile: ") + chalk.blue(`https://knowthat.ai/agents/${envVars.MCP_IDENTITY_AGENT_SLUG}`.padEnd(60)) + chalk.cyan("║"));
-                    console.log(chalk.cyan("║                                                                       ║"));
-                    if (claimUrl) {
-                        console.log(chalk.cyan("╠═══════════════════════════════════════════════════════════════════════╣"));
-                        console.log(chalk.cyan("║                                                                       ║"));
-                        console.log(chalk.cyan("║") + chalk.bold.yellow("  🎯 CLAIM YOUR AGENT NOW:                                             ") + chalk.cyan("║"));
-                        console.log(chalk.cyan("║                                                                       ║"));
-                        // Break URL into chunks that fit within the box
-                        const maxUrlLength = 65; // Leave some padding
-                        const urlChunks = [];
-                        let remainingUrl = claimUrl;
-                        while (remainingUrl.length > 0) {
-                            if (remainingUrl.length <= maxUrlLength) {
-                                urlChunks.push(remainingUrl);
-                                break;
-                            }
-                            // Try to break at a good spot (& or %)
-                            let breakPoint = maxUrlLength;
-                            const lastAmpersand = remainingUrl.lastIndexOf('&', maxUrlLength);
-                            const lastPercent = remainingUrl.lastIndexOf('%', maxUrlLength);
-                            if (lastAmpersand > maxUrlLength * 0.7) {
-                                breakPoint = lastAmpersand + 1;
-                            }
-                            else if (lastPercent > maxUrlLength * 0.7) {
-                                breakPoint = lastPercent + 3; // Include %XX
-                            }
-                            urlChunks.push(remainingUrl.substring(0, breakPoint));
-                            remainingUrl = remainingUrl.substring(breakPoint);
-                        }
-                        // Display URL chunks
-                        urlChunks.forEach((chunk, index) => {
-                            const paddedChunk = chunk.padEnd(68);
-                            if (index === 0) {
-                                console.log(chalk.cyan("║") + "  " + chalk.cyan.underline(paddedChunk) + " " + chalk.cyan("║"));
-                            }
-                            else {
-                                console.log(chalk.cyan("║") + "    " + chalk.cyan.underline(paddedChunk.substring(0, 66)) + " " + chalk.cyan("║"));
-                            }
+                    // Always show effect for successful registrations
+                    const shouldShowEffect = true;
+                    if (shouldShowEffect && metadata?.did) {
+                        // Clear some space for the effect
+                        console.log("\n");
+                        // Show DID generation with Blackhole effect
+                        const didGenerationText = `🔐 ${chalk.bold("Generating Decentralized Identity")}\n` +
+                            `\n` +
+                            `DID: ${chalk.green(metadata.did)}`;
+                        await cliEffects.showCustomEffect("blackhole", didGenerationText, {
+                            config: {
+                                duration: 5000, // Increased duration for smoother transition
+                                blackholeColor: "ffffff",
+                                starColors: [
+                                    "ffcc0d",
+                                    "ff7326",
+                                    "ff194d",
+                                    "bf2669",
+                                    "702a8c",
+                                    "049dbf",
+                                ],
+                                finalColor: "00ff00",
+                                useGradient: true,
+                                gradientDirection: "diagonal",
+                                blackholeSize: 0.3,
+                            },
+                            persistent: true, // Keep the DID visible after animation
+                            skipExitPrompt: true, // Don't show "Press any key to exit"
                         });
-                        console.log(chalk.cyan("║                                                                       ║"));
-                        console.log(chalk.cyan("║") + chalk.gray("  This link lets you manage your agent and add capabilities.          ") + chalk.cyan("║"));
-                        console.log(chalk.cyan("║                                                                       ║"));
-                    }
-                    console.log(chalk.cyan("╠═══════════════════════════════════════════════════════════════════════╣"));
-                    console.log(chalk.cyan("║                                                                       ║"));
-                    console.log(chalk.cyan("║") + chalk.bold.green("  ✅ Agent successfully registered on the KYA-OS network               ") + chalk.cyan("║"));
-                    console.log(chalk.cyan("║") + chalk.gray("     Your AI agent now has a verifiable decentralized identity        ") + chalk.cyan("║"));
-                    console.log(chalk.cyan("║                                                                       ║"));
-                    console.log(chalk.cyan("╚═══════════════════════════════════════════════════════════════════════╝"));
-                    console.log("\n");
-                    // Interactive prompt
-                    if (claimUrl) {
-                        console.log(chalk.yellow("  Press ENTER to open claim URL in browser, or 'x' to skip and continue..."));
-                        // Wait for user input
-                        const keypress = await new Promise((resolve) => {
-                            import('readline').then((readline) => {
-                                readline.emitKeypressEvents(process.stdin);
-                                if (process.stdin.isTTY) {
-                                    process.stdin.setRawMode(true);
-                                }
-                                const handleKeypress = (str, key) => {
-                                    if (key && key.name === 'return') {
-                                        resolve('enter');
-                                    }
-                                    else if (str === 'x' || str === 'X') {
-                                        resolve('x');
-                                    }
-                                };
-                                process.stdin.once('keypress', handleKeypress);
-                                process.stdin.resume();
+                        // Wait a moment for the effect to finish and let the user see the DID
+                        await new Promise((resolve) => setTimeout(resolve, 2000));
+                        // 1. Claim Your Agent screen (FIRST)
+                        if (metadata?.claimUrl) {
+                            await showScreen(createClaimTable({ claimUrl: metadata.claimUrl }), {
+                                requireInput: true,
+                                clearBefore: true,
+                                prompt: "Press Enter to continue...",
                             });
-                        });
-                        if (process.stdin.isTTY) {
-                            process.stdin.setRawMode(false);
-                        }
-                        if (keypress === 'enter') {
-                            // Try to open URL in browser
-                            try {
-                                const open = (await import('open')).default;
-                                await open(claimUrl);
-                                console.log(chalk.green("\n  ✓ Opening claim URL in your browser...\n"));
-                            }
-                            catch (err) {
-                                console.log(chalk.gray("\n  Could not open browser. Please visit the URL manually.\n"));
-                            }
-                        }
-                        else {
-                            console.log(chalk.gray("\n  You can claim your agent later using the URL above.\n"));
                         }
-                    }
-                    else {
-                        // If no claim URL, just wait for any key
-                        console.log(chalk.gray("  Press any key to continue..."));
-                        await new Promise((resolve) => {
-                            process.stdin.once('data', () => resolve(undefined));
-                            process.stdin.resume();
+                        // 2. Agent Identity Created screen (SECOND)
+                        const agentTable = createAgentTable({
+                            name: answers.name,
+                            description: answers.description,
+                            did: metadata?.did || envVars?.MCP_IDENTITY_AGENT_DID || "",
+                            privateKey: envVars?.MCP_IDENTITY_AGENT_PRIVATE_KEY || "",
+                            agentSlug: answers.name,
+                            profileUrl: `https://knowthat.ai/agents/${answers.name}`,
+                        });
+                        await showScreen(agentTable, {
+                            requireInput: true,
+                            clearBefore: true,
+                            prompt: "Press Enter to continue...",
                         });
                     }
                 }
-                else {
-                    console.log("\nYou can still create the configuration files and register later.");
-                    answers.confirmEnvCreation = await promptForInit({
-                        confirmEnvCreation: true,
-                    }).then((a) => a.confirmEnvCreation);
-                }
             }
         }
         // Create environment files
         if (answers.confirmEnvCreation && envVars) {
             console.log(`\n📄 ${chalk.bold("Creating environment files...")}`);
             try {
-                // Create actual env file
-                const envFile = platformConfig.envFile;
-                await envManager.createEnvFile(envFile, envVars, {
-                    force: options.force,
+                // Check for existing MCP variables in env files
+                const envFiles = envManager.scanEnvFiles();
+                let hasExistingMcpVars = false;
+                let existingDid = '';
+                for (const envFile of envFiles) {
+                    if (envFile.exists && envFile.hasMcpIdentity && envFile.mcpVariables?.MCP_IDENTITY_AGENT_DID) {
+                        hasExistingMcpVars = true;
+                        existingDid = envFile.mcpVariables.MCP_IDENTITY_AGENT_DID;
+                        break;
+                    }
+                }
+                // If existing MCP variables found and not forcing, prompt for confirmation
+                if (hasExistingMcpVars && !validatedOptions.force) {
+                    const shouldReplace = await confirmMcpVariableReplacement(existingDid);
+                    if (!shouldReplace) {
+                        console.log(chalk.yellow('\n⚠ Skipping environment file update.'));
+                        console.log('   Your existing MCP identity has been preserved.');
+                        return;
+                    }
+                }
+                // Use smart insertion with best practices
+                const result = await envManager.smartInsertMcpVariables(envVars, {
+                    force: validatedOptions.force,
                 });
-                console.log(`   ✓ Created ${chalk.green(envFile)}`);
-                // Create example file
-                const exampleFile = `${envFile}.example`;
-                await envManager.createEnvFile(exampleFile, envVars, { example: true });
-                console.log(`   ✓ Created ${chalk.green(exampleFile)}`);
-                // Check gitignore
-                const { missing } = envManager.checkGitignore([
-                    envFile,
-                    ".mcp-identity.json",
-                ]);
-                if (missing.length > 0) {
-                    envManager.addToGitignore(missing);
-                    console.log(`   ✓ Added to ${chalk.green(".gitignore")}: ${missing.join(", ")}`);
+                if (result.success) {
+                    // Show operation result
+                    const operation = result.operation === "created"
+                        ? "Created"
+                        : result.operation === "updated"
+                            ? "Updated"
+                            : "Replaced variables in";
+                    console.log(`   ✓ ${operation} ${chalk.green(result.targetFile)}`);
+                    // Show warnings if any
+                    if (result.warnings.length > 0) {
+                        result.warnings.forEach((warning) => {
+                            console.log(`   ${chalk.yellow("⚠")} ${warning}`);
+                        });
+                    }
+                    // Show conflicts if any
+                    if (result.conflicts && result.conflicts.length > 0) {
+                        console.log(`   ${chalk.yellow("⚠")} Found conflicting values in other files:`);
+                        result.conflicts.forEach((conflict) => {
+                            console.log(`     ${conflict.file}: ${conflict.variable}="${conflict.value.substring(0, 20)}..."`);
+                        });
+                        console.log(`   ${chalk.cyan("ℹ")} Using ${result.targetFile} as authoritative source`);
+                    }
+                    // Check gitignore
+                    const filesToIgnore = [
+                        result.targetFile,
+                        ".mcp-identity.json",
+                        // Also add common .env files to gitignore
+                        ".env",
+                        ".env.local",
+                        ".env.development",
+                        ".env.dev",
+                    ];
+                    const { missing } = envManager.checkGitignore(filesToIgnore);
+                    if (missing.length > 0) {
+                        envManager.addToGitignore(missing);
+                        console.log(`   ✓ Added to ${chalk.green(".gitignore")}: ${missing.join(", ")}`);
+                    }
+                }
+                else {
+                    showError(`Environment file setup failed: ${result.warnings.join(", ")}`);
                 }
             }
             catch (error) {
                 showError(`Failed to create environment files: ${error.message}`);
             }
         }
-        // Show next steps
-        console.log(`\n📋 ${chalk.bold("Next Steps:")}`);
-        console.log("\n1. Install the MCP-I package:");
-        console.log(`   ${chalk.cyan(`${platformInfo.packageManager} install @kya-os/mcp-i`)}`);
-        console.log("\n2. Add to your code:");
-        console.log(`   ${chalk.cyan('import "@kya-os/mcp-i/auto"')}`);
+        // 3. Combined Environment Configuration & Success screen
+        const envConfigContent = [
+            "📝 Created files:",
+            "",
+            "  • .env.local (for local development)",
+            "  • Added to .gitignore automatically",
+        ];
+        const combinedScreen = `${createGradientBox(envConfigContent, {
+            title: "Environment Configuration",
+            gradientStyle: "cool",
+        })}
+
+${createSuccessBox("MCP-I initialization complete!", "Your AI agent now has a verifiable decentralized identity on the KYA-OS network.")}`;
+        await showScreen(combinedScreen, {
+            requireInput: true,
+            clearBefore: true,
+            prompt: "Press Enter to continue...",
+        });
+        // 4. Integration Guide (no rainbow colors)
+        const integrationContent = [
+            "📋 Next Steps:",
+            "",
+            "1. Install the MCP-I package:",
+            `   ${chalk.cyan(`${platformInfo.packageManager} install @kya-os/mcp-i`)}`,
+            "",
+            "2. Add to your code:",
+            `   ${chalk.cyan('import "@kya-os/mcp-i/auto"')}`,
+            "",
+        ];
         if (platformInfo.platform === "vercel" ||
             platformInfo.platform === "nextjs") {
-            console.log("\n3. For production deployment:");
-            console.log("   - Go to Vercel Dashboard → Settings → Environment Variables");
-            console.log("   - Add all MCP_IDENTITY_* variables from .env.local");
-            console.log(`   - Run: ${chalk.cyan("npx kya-os env copy")} to copy them to clipboard`);
+            integrationContent.push("3. For production deployment:", "   • Go to Vercel Dashboard → Settings → Environment Variables", "   • Add all MCP_IDENTITY_* variables from .env.local", `   • Run: ${chalk.cyan("npx kya-os env copy")} to copy them to clipboard`, "");
+        }
+        // Add platform-specific instructions if any
+        if (platformConfig.instructions.length > 0) {
+            integrationContent.push(`${chalk.bold("Platform-specific notes:")}`, ...platformConfig.instructions.map((instruction, i) => `${i + 1}. ${instruction}`));
         }
-        console.log(`\n${chalk.bold("Platform-specific notes:")}`);
-        platformConfig.instructions.forEach((instruction, i) => {
-            console.log(`${i + 1}. ${instruction}`);
+        await showScreen(createGradientBox(integrationContent, {
+            title: "Integration Guide",
+            gradientStyle: "cool", // Changed from rainbow to cool
+        }), {
+            requireInput: false,
+            clearBefore: true,
         });
-        showSuccess("MCP-I initialization complete!");
     }
     catch (error) {
         showError(error.message || "Initialization failed");