@poolzin/pool-bot 2026.4.42 → 2026.4.44

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.4.42",
-  "commit": "1904089b8bb7a9c40d78c2a210258b6182cb53af",
-  "builtAt": "2026-04-08T02:20:04.246Z"
+  "version": "2026.4.44",
+  "commit": "2a04fd278aee8e7b369bdc1dca503419859df769",
+  "builtAt": "2026-04-08T03:20:50.969Z"
 }

package/dist/cli/infer-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infer-cli.d.ts","sourceRoot":"","sources":["../../src/cli/infer-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,QAyZhD"}
+{"version":3,"file":"infer-cli.d.ts","sourceRoot":"","sources":["../../src/cli/infer-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,QAobhD"}

package/dist/cli/onboard-cli.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Guided Onboarding CLI - Step-by-step PoolBot setup wizard
+ *
+ * Interactive wizard that guides users through:
+ * 1. System checks
+ * 2. Gateway setup
+ * 3. Model/auth configuration
+ * 4. Channel setup (Telegram, Discord, etc.)
+ * 5. Memory/skills configuration
+ * 6. Final validation
+ *
+ * Usage:
+ *   poolbot onboard                     # Full interactive onboarding
+ *   poolbot onboard --skip-gateway      # Skip gateway setup
+ *   poolbot onboard --skip-channels     # Skip channel setup
+ *   poolbot onboard --yes               # Use defaults (non-interactive)
+ */
+import type { Command } from "commander";
+export declare function registerOnboardCli(program: Command): void;
+//# sourceMappingURL=onboard-cli.d.ts.map

package/dist/cli/onboard-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard-cli.d.ts","sourceRoot":"","sources":["../../src/cli/onboard-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsfzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,QAwBlD"}

package/dist/cli/onboard-cli.js

@@ -0,0 +1,440 @@
+/**
+ * Guided Onboarding CLI - Step-by-step PoolBot setup wizard
+ *
+ * Interactive wizard that guides users through:
+ * 1. System checks
+ * 2. Gateway setup
+ * 3. Model/auth configuration
+ * 4. Channel setup (Telegram, Discord, etc.)
+ * 5. Memory/skills configuration
+ * 6. Final validation
+ *
+ * Usage:
+ *   poolbot onboard                     # Full interactive onboarding
+ *   poolbot onboard --skip-gateway      # Skip gateway setup
+ *   poolbot onboard --skip-channels     # Skip channel setup
+ *   poolbot onboard --yes               # Use defaults (non-interactive)
+ */
+import { stdin as input, stdout as output } from "node:process";
+import readline from "node:readline/promises";
+import { loadConfig, writeConfigFile } from "../config/config.js";
+import { defaultRuntime } from "../runtime.js";
+import { theme } from "../terminal/theme.js";
+import { danger, success } from "../globals.js";
+import { formatDocsLink } from "../terminal/links.js";
+import { isYes } from "../globals.js";
+async function createReadlineInterface() {
+    return readline.createInterface({ input, output });
+}
+function printHeader() {
+    console.log("");
+    console.log(theme.heading("🎱 Welcome to Pool Bot Onboarding!"));
+    console.log(theme.muted("─────────────────────────────────────────"));
+    console.log("");
+    console.log("This wizard will guide you through setting up Pool Bot.");
+    console.log("Press Ctrl+C at any time to exit.");
+    console.log("");
+}
+function printStepHeader(step, total, title) {
+    console.log("");
+    console.log(theme.heading(`Step ${step}/${total}: ${title}`));
+    console.log(theme.muted("─────────────────────────────────────────"));
+}
+function printSuccess(message) {
+    console.log("");
+    console.log(success(`✓ ${message}`));
+}
+function printWarning(message) {
+    console.log("");
+    console.log(theme.warn(`⚠ ${message}`));
+}
+function printError(message) {
+    console.log("");
+    console.log(danger(`✗ ${message}`));
+}
+async function promptYesNo(rl, question, defaultYes = true) {
+    if (isYes())
+        return true;
+    const suffix = defaultYes ? " [Y/n]" : " [y/N]";
+    const answer = (await rl.question(`${question}${suffix}: `)).trim().toLowerCase();
+    if (!answer)
+        return defaultYes;
+    return answer.startsWith("y");
+}
+async function promptText(rl, question, defaultValue, required = false) {
+    if (isYes() && defaultValue)
+        return defaultValue;
+    const suffix = defaultValue ? ` [${defaultValue}]` : "";
+    while (true) {
+        const answer = (await rl.question(`${question}${suffix}: `)).trim();
+        if (answer || !required) {
+            return answer || defaultValue || "";
+        }
+        console.log(theme.warn("This field is required. Please enter a value."));
+    }
+}
+async function promptSelect(rl, question, options, defaultValue) {
+    if (isYes() && defaultValue)
+        return defaultValue;
+    console.log(question);
+    options.forEach((opt, i) => {
+        const defaultMarker = opt.value === defaultValue ? theme.success(" (default)") : "";
+        console.log(`  ${i + 1}. ${opt.label}${defaultMarker}`);
+    });
+    while (true) {
+        const answer = (await rl.question("Select option (number): ")).trim();
+        if (!answer && defaultValue)
+            return defaultValue;
+        const index = Number.parseInt(answer, 10) - 1;
+        if (!Number.isNaN(index) && index >= 0 && index < options.length) {
+            return options[index].value;
+        }
+        console.log(theme.warn("Invalid selection. Please enter a number."));
+    }
+}
+// Step 1: System Checks
+async function runSystemChecks(_options) {
+    printStepHeader(1, 6, "System Checks");
+    const checks = [
+        { name: "Node.js version", pass: process.version.startsWith("v22") || process.version.startsWith("v20") },
+        { name: "Home directory", pass: Boolean(process.env.HOME) },
+        { name: "Config directory writable", pass: true }, // Assume OK for now
+    ];
+    // Validation result tracking
+    for (const check of checks) {
+        const icon = check.pass ? theme.success("✓") : theme.warn("⚠");
+        console.log(`  ${icon} ${check.name}${check.message ? `: ${check.message}` : ""}`);
+        // Track failures
+    }
+    printSuccess("System checks complete");
+    return true;
+}
+// Step 2: Gateway Setup
+async function runGatewaySetup(_options) {
+    if (_options.skipGateway) {
+        printWarning("Skipping gateway setup (--skip-gateway)");
+        return true;
+    }
+    printStepHeader(2, 6, "Gateway Configuration");
+    const rl = await createReadlineInterface();
+    const config = loadConfig();
+    try {
+        console.log("");
+        console.log("Pool Bot uses a gateway to manage agents and channels.");
+        console.log("");
+        // Gateway mode
+        const mode = await promptSelect(rl, "Gateway mode:", [
+            { value: "local", label: "Local (run on this machine)" },
+            { value: "remote", label: "Remote (connect to existing gateway)" },
+        ], config.gateway?.mode || "local");
+        if (!config.gateway)
+            config.gateway = {};
+        config.gateway.mode = mode;
+        if (mode === "local") {
+            // Local gateway setup
+            const port = await promptText(rl, "Gateway port", "18789");
+            config.gateway.port = Number.parseInt(port, 10);
+            // Auth mode
+            const authMode = await promptSelect(rl, "Authentication mode:", [
+                { value: "token", label: "Token-based (recommended)" },
+                { value: "password", label: "Password-based" },
+            ], "token");
+            if (!config.gateway.auth)
+                config.gateway.auth = {};
+            config.gateway.auth.mode = authMode;
+            if (authMode === "token") {
+                const token = await promptText(rl, "Gateway token (min 16 chars)", undefined, true);
+                if (token.length < 16) {
+                    printError("Token must be at least 16 characters");
+                    return false;
+                }
+                config.gateway.auth.token = token;
+            }
+        }
+        else {
+            // Remote gateway setup
+            const url = await promptText(rl, "Gateway URL (wss://...)", undefined, true);
+            config.gateway.remote = { url };
+            const token = await promptText(rl, "Gateway token", undefined, true);
+            config.gateway.remote.token = token;
+        }
+        writeConfigFile(config);
+        printSuccess("Gateway configured");
+    }
+    finally {
+        rl.close();
+    }
+    return true;
+}
+// Step 3: Model & Auth Setup
+async function runModelSetup(_options) {
+    if (_options.skipModels) {
+        printWarning("Skipping model setup (--skip-models)");
+        return true;
+    }
+    printStepHeader(3, 6, "Model & Authentication");
+    const rl = await createReadlineInterface();
+    const config = loadConfig();
+    try {
+        console.log("");
+        console.log("Configure your preferred AI model provider.");
+        console.log("");
+        // Provider selection
+        const provider = await promptSelect(rl, "Model provider:", [
+            { value: "anthropic", label: "Anthropic (Claude)" },
+            { value: "openai", label: "OpenAI (GPT)" },
+            { value: "google", label: "Google (Gemini)" },
+            { value: "moonshotai", label: "MoonshotAI (Kimi)" },
+            { value: "zai", label: "Z.AI (GLM)" },
+        ], "anthropic");
+        if (!config.auth)
+            config.auth = {};
+        if (!config.auth.profiles)
+            config.auth.profiles = {};
+        // Provider-specific setup
+        if (provider === "anthropic") {
+            console.log("");
+            console.log("Anthropic API Key:");
+            console.log("  Get your key at: https://console.anthropic.com/account/keys");
+            console.log("");
+            const _apiKey = await promptText(rl, "API Key", undefined, true);
+            config.auth.profiles["anthropic:default"] = {
+                provider: "anthropic",
+                mode: "api_key",
+            };
+            // Store actual API key in auth-profiles.json (separate from config)
+            // For now, just set up the profile reference
+            if (!config.agents)
+                config.agents = {};
+            if (!config.agents.defaults)
+                config.agents.defaults = {};
+            config.agents.defaults.model = {
+                primary: "anthropic/claude-sonnet-4-6",
+            };
+        }
+        else if (provider === "openai") {
+            console.log("");
+            console.log("OpenAI API Key:");
+            console.log("  Get your key at: https://platform.openai.com/api-keys");
+            console.log("");
+            const _apiKey = await promptText(rl, "API Key", undefined, true);
+            config.auth.profiles["openai:default"] = {
+                provider: "openai",
+                mode: "api_key",
+            };
+            if (!config.agents)
+                config.agents = {};
+            if (!config.agents.defaults)
+                config.agents.defaults = {};
+            config.agents.defaults.model = {
+                primary: "openai/gpt-5",
+            };
+        }
+        // Add more providers as needed...
+        writeConfigFile(config);
+        printSuccess("Model configured");
+    }
+    finally {
+        rl.close();
+    }
+    return true;
+}
+// Step 4: Channel Setup
+async function runChannelSetup(_options) {
+    if (_options.skipChannels) {
+        printWarning("Skipping channel setup (--skip-channels)");
+        return true;
+    }
+    printStepHeader(4, 6, "Messaging Channels");
+    const rl = await createReadlineInterface();
+    const config = loadConfig();
+    try {
+        console.log("");
+        console.log("Configure messaging channels for Pool Bot to communicate.");
+        console.log("You can skip this and configure channels later.");
+        console.log("");
+        if (!config.channels)
+            config.channels = {};
+        // Telegram
+        const setupTelegram = await promptYesNo(rl, "Set up Telegram bot?", false);
+        if (setupTelegram) {
+            console.log("");
+            console.log("Telegram Bot Token:");
+            console.log("  Create a bot with @BotFather and get the token");
+            console.log("");
+            const token = await promptText(rl, "Bot Token", undefined, true);
+            config.channels.telegram = {
+                enabled: true,
+                accounts: {
+                    default: {
+                        token,
+                        enabled: true,
+                    },
+                },
+            };
+            printSuccess("Telegram configured");
+        }
+        // Discord
+        const setupDiscord = await promptYesNo(rl, "Set up Discord bot?", false);
+        if (setupDiscord) {
+            console.log("");
+            console.log("Discord Bot Token:");
+            console.log("  Create an app at https://discord.com/developers/applications");
+            console.log("");
+            const token = await promptText(rl, "Bot Token", undefined, true);
+            config.channels.discord = {
+                enabled: true,
+                accounts: {
+                    default: {
+                        token,
+                        enabled: true,
+                    },
+                },
+            };
+            printSuccess("Discord configured");
+        }
+        // More channels can be added...
+        writeConfigFile(config);
+        printSuccess("Channels configured");
+    }
+    finally {
+        rl.close();
+    }
+    return true;
+}
+// Step 5: Memory & Skills
+async function runMemorySkillsSetup(_options) {
+    if (_options.skipMemory && _options.skipSkills) {
+        printWarning("Skipping memory & skills setup (--skip-memory --skip-skills)");
+        return true;
+    }
+    printStepHeader(5, 6, "Memory & Skills");
+    const rl = await createReadlineInterface();
+    const config = loadConfig();
+    try {
+        console.log("");
+        console.log("Configure memory and skills for Pool Bot.");
+        console.log("");
+        // Memory
+        if (!_options.skipMemory) {
+            const enableMemory = await promptYesNo(rl, "Enable session memory?", true);
+            if (!config.memory)
+                config.memory = {};
+            config.memory.backend = enableMemory ? "builtin" : undefined;
+            if (enableMemory) {
+                printSuccess("Memory enabled");
+            }
+        }
+        // Skills
+        if (!_options.skipSkills) {
+            const autoSkills = await promptYesNo(rl, "Auto-enable recommended skills?", true);
+            if (!config.skills)
+                config.skills = {};
+            // Skills auto-enable is handled by skills.auto in entries config
+            if (autoSkills) {
+                printSuccess("Skills auto-enable enabled");
+            }
+        }
+        writeConfigFile(config);
+        printSuccess("Memory & skills configured");
+    }
+    finally {
+        rl.close();
+    }
+    return true;
+}
+// Step 6: Final Validation
+async function runFinalValidation(_options) {
+    printStepHeader(6, 6, "Final Validation");
+    const config = loadConfig();
+    console.log("");
+    console.log("Validating configuration...");
+    console.log("");
+    const checks = [
+        { name: "Gateway configured", pass: Boolean(config.gateway) },
+        { name: "Model configured", pass: Boolean(config.agents?.defaults?.model?.primary) },
+        { name: "Auth profiles", pass: Object.keys(config.auth?.profiles || {}).length > 0 },
+    ];
+    if (config.channels?.telegram) {
+        checks.push({ name: "Telegram configured", pass: true });
+    }
+    if (config.channels?.discord) {
+        checks.push({ name: "Discord configured", pass: true });
+    }
+    // Validation result tracking
+    for (const check of checks) {
+        const icon = check.pass ? theme.success("✓") : theme.warn("⚠");
+        console.log(`  ${icon} ${check.name}${check.message ? `: ${check.message}` : ""}`);
+        // Track failures
+    }
+    console.log("");
+    printSuccess("All validations passed!");
+    // Print summary
+    console.log("");
+    console.log(theme.heading("🎉 Onboarding Complete!"));
+    console.log(theme.muted("─────────────────────────────────────────"));
+    console.log("");
+    console.log("Next steps:");
+    console.log("");
+    console.log(`  1. Start the gateway: ${theme.command("poolbot gateway run")}`);
+    console.log(`  2. Check status: ${theme.command("poolbot status")}`);
+    console.log(`  3. Send a message: ${theme.command("poolbot message send 'Hello!'")}`);
+    console.log("");
+    console.log(`For more help: ${formatDocsLink("/start/getting-started", "docs.molt.bot/start/getting-started")}`);
+    console.log("");
+    return true;
+}
+// Main onboarding function
+async function runOnboarding(_options) {
+    printHeader();
+    const steps = [
+        { name: "system", description: "System checks", run: runSystemChecks },
+        { name: "gateway", description: "Gateway setup", run: runGatewaySetup },
+        { name: "models", description: "Model & auth", run: runModelSetup },
+        { name: "channels", description: "Channels", run: runChannelSetup },
+        { name: "memory", description: "Memory & skills", run: runMemorySkillsSetup },
+        { name: "validation", description: "Final validation", run: runFinalValidation },
+    ];
+    // Step counter
+    for (const step of steps) {
+        // Next step
+        try {
+            const success = await step.run(_options);
+            if (!success) {
+                printError(`Step failed: ${step.name}`);
+                console.log("");
+                console.log("You can restart onboarding with: poolbot onboard");
+                defaultRuntime.exit(1);
+                return;
+            }
+        }
+        catch (error) {
+            printError(`Step error: ${step.name} - ${error instanceof Error ? error.message : String(error)}`);
+            defaultRuntime.exit(1);
+            return;
+        }
+    }
+    defaultRuntime.exit(0);
+}
+export function registerOnboardCli(program) {
+    program
+        .command("onboard")
+        .description("Interactive setup wizard for new Pool Bot installations")
+        .option("--skip-gateway", "Skip gateway setup")
+        .option("--skip-channels", "Skip channel setup")
+        .option("--skip-models", "Skip model setup")
+        .option("--skip-memory", "Skip memory setup")
+        .option("--skip-skills", "Skip skills setup")
+        .option("--yes", "Use defaults without prompting (non-interactive)")
+        .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/start/onboarding", "docs.molt.bot/start/onboarding")}\n` +
+        `${theme.muted("Tip:")} Use --skip-* flags to skip specific steps\n`)
+        .action(async (opts) => {
+        try {
+            await runOnboarding(opts);
+        }
+        catch (error) {
+            defaultRuntime.error(`Onboarding failed: ${error instanceof Error ? error.message : String(error)}`);
+            defaultRuntime.exit(1);
+        }
+    });
+}

package/dist/cli/plugins-config-tui.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Plugin Config TUI - Interactive plugin configuration prompts
+ *
+ * Provides interactive prompts for configuring plugins during install/setup.
+ * Integrates with existing plugins CLI for guided configuration flows.
+ *
+ * Usage:
+ *   import { promptPluginConfig } from "./plugins-config-tui.js";
+ *   const config = await promptPluginConfig(pluginId, pluginManifest);
+ */
+type ConfigField = {
+    key: string;
+    label: string;
+    description?: string;
+    type: "string" | "number" | "boolean" | "select" | "secret";
+    default?: unknown;
+    options?: string[];
+    required?: boolean;
+    validate?: (value: unknown) => string | null;
+};
+type PluginManifest = {
+    name?: string;
+    version?: string;
+    description?: string;
+    poolbot?: {
+        config?: {
+            fields?: ConfigField[];
+        };
+    };
+};
+type PluginConfigResult = Record<string, unknown>;
+/**
+ * Prompt user for plugin configuration interactively.
+ *
+ * @param pluginId - Plugin identifier
+ * @param manifest - Plugin manifest with config schema
+ * @param options - Optional config values (pre-filled)
+ * @returns Configured values
+ */
+export declare function promptPluginConfig(pluginId: string, manifest: PluginManifest, options?: PluginConfigResult): Promise<PluginConfigResult>;
+/**
+ * Display plugin configuration summary.
+ */
+export declare function displayPluginConfigSummary(pluginId: string, config: PluginConfigResult): void;
+/**
+ * Confirm plugin installation with config summary.
+ */
+export declare function confirmPluginInstall(pluginId: string, config: PluginConfigResult): Promise<boolean>;
+export {};
+//# sourceMappingURL=plugins-config-tui.d.ts.map

package/dist/cli/plugins-config-tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins-config-tui.d.ts","sourceRoot":"","sources":["../../src/cli/plugins-config-tui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,KAAK,WAAW,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;CAC9C,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE;YACP,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;SACxB,CAAC;KACH,CAAC;CACH,CAAC;AAEF,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAiIlD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAuD7B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAsB7F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/cli/plugins-config-tui.js

@@ -0,0 +1,197 @@
+/**
+ * Plugin Config TUI - Interactive plugin configuration prompts
+ *
+ * Provides interactive prompts for configuring plugins during install/setup.
+ * Integrates with existing plugins CLI for guided configuration flows.
+ *
+ * Usage:
+ *   import { promptPluginConfig } from "./plugins-config-tui.js";
+ *   const config = await promptPluginConfig(pluginId, pluginManifest);
+ */
+import { stdin as input, stdout as output } from "node:process";
+import readline from "node:readline/promises";
+import { isYes } from "../globals.js";
+async function createReadlineInterface() {
+    return readline.createInterface({ input, output });
+}
+async function promptText(rl, question, defaultValue) {
+    const suffix = defaultValue ? ` [${defaultValue}]` : "";
+    const answer = (await rl.question(`${question}${suffix}: `)).trim();
+    return answer || defaultValue || "";
+}
+async function promptSecret(rl, question) {
+    // Note: readline doesn't support hidden input in Node.js without external deps
+    // For now, just warn user
+    console.log("(Input will be visible - consider using environment variables for secrets)");
+    return await promptText(rl, question);
+}
+async function promptNumber(rl, question, defaultValue) {
+    const suffix = defaultValue !== undefined ? ` [${defaultValue}]` : "";
+    const answer = (await rl.question(`${question}${suffix}: `)).trim();
+    if (!answer && defaultValue !== undefined)
+        return defaultValue;
+    const num = Number.parseInt(answer, 10);
+    if (Number.isNaN(num)) {
+        console.log("Please enter a valid number");
+        return await promptNumber(rl, question, defaultValue);
+    }
+    return num;
+}
+async function promptBoolean(rl, question, defaultValue) {
+    const defaultStr = defaultValue === true ? "Y/n" : defaultValue === false ? "y/N" : "y/n";
+    const answer = (await rl.question(`${question} [${defaultStr}]: `)).trim().toLowerCase();
+    if (!answer)
+        return defaultValue ?? false;
+    return answer.startsWith("y");
+}
+async function promptSelect(rl, question, options, defaultValue) {
+    console.log(question);
+    options.forEach((opt, i) => {
+        const defaultMarker = opt === defaultValue ? " (default)" : "";
+        console.log(`  ${i + 1}. ${opt}${defaultMarker}`);
+    });
+    const answer = (await rl.question("Select option (number): ")).trim();
+    const index = Number.parseInt(answer, 10) - 1;
+    if (Number.isNaN(index) || index < 0 || index >= options.length) {
+        console.log("Invalid selection");
+        return await promptSelect(rl, question, options, defaultValue);
+    }
+    return options[index];
+}
+async function promptField(rl, field) {
+    const { key, label, description, type, default: defaultValue, options, required, validate, } = field;
+    if (description) {
+        console.log(`  ${label}: ${description}`);
+    }
+    let value;
+    switch (type) {
+        case "string":
+            value = await promptText(rl, label, defaultValue);
+            break;
+        case "secret":
+            value = await promptSecret(rl, label);
+            break;
+        case "number":
+            value = await promptNumber(rl, label, defaultValue);
+            break;
+        case "boolean":
+            value = await promptBoolean(rl, label, defaultValue);
+            break;
+        case "select":
+            if (!options || options.length === 0) {
+                throw new Error(`Select field "${key}" has no options`);
+            }
+            value = await promptSelect(rl, label, options, defaultValue);
+            break;
+        default:
+            throw new Error(`Unknown field type: ${type}`);
+    }
+    // Validation
+    if (required && (value === undefined || value === null || value === "")) {
+        console.log(`  ⚠️  ${label} is required`);
+        return await promptField(rl, field);
+    }
+    if (validate) {
+        const error = validate(value);
+        if (error) {
+            console.log(`  ⚠️  ${error}`);
+            return await promptField(rl, field);
+        }
+    }
+    return value;
+}
+/**
+ * Prompt user for plugin configuration interactively.
+ *
+ * @param pluginId - Plugin identifier
+ * @param manifest - Plugin manifest with config schema
+ * @param options - Optional config values (pre-filled)
+ * @returns Configured values
+ */
+export async function promptPluginConfig(pluginId, manifest, options) {
+    const configFields = manifest.poolbot?.config?.fields || [];
+    if (configFields.length === 0) {
+        // No config fields - nothing to prompt
+        return options || {};
+    }
+    // Honor global --yes flag
+    if (isYes()) {
+        // Use defaults or provided options
+        const result = { ...options };
+        for (const field of configFields) {
+            if (!(field.key in result) && field.default !== undefined) {
+                result[field.key] = field.default;
+            }
+        }
+        return result;
+    }
+    console.log("");
+    console.log(`Configuring plugin: ${pluginId}`);
+    if (manifest.name) {
+        console.log(`  ${manifest.name}${manifest.version ? ` v${manifest.version}` : ""}`);
+    }
+    if (manifest.description) {
+        console.log(`  ${manifest.description}`);
+    }
+    console.log("");
+    console.log("Enter configuration values (press Enter for defaults):");
+    console.log("─────────────────────────────────────────");
+    const rl = await createReadlineInterface();
+    const result = { ...options };
+    try {
+        for (const field of configFields) {
+            // Skip if already provided
+            if (field.key in result) {
+                continue;
+            }
+            const value = await promptField(rl, field);
+            result[field.key] = value;
+            console.log("");
+        }
+    }
+    finally {
+        rl.close();
+    }
+    console.log("─────────────────────────────────────────");
+    console.log("Configuration complete!");
+    console.log("");
+    return result;
+}
+/**
+ * Display plugin configuration summary.
+ */
+export function displayPluginConfigSummary(pluginId, config) {
+    console.log("");
+    console.log(`Plugin Configuration: ${pluginId}`);
+    console.log("─────────────────────────────────────────");
+    const entries = Object.entries(config);
+    if (entries.length === 0) {
+        console.log("  (no configuration)");
+    }
+    else {
+        for (const [key, value] of entries) {
+            const masked = key.toLowerCase().includes("secret") ||
+                key.toLowerCase().includes("token") ||
+                key.toLowerCase().includes("password") ||
+                key.toLowerCase().includes("key")
+                ? "****"
+                : String(value);
+            console.log(`  ${key}: ${masked}`);
+        }
+    }
+    console.log("");
+}
+/**
+ * Confirm plugin installation with config summary.
+ */
+export async function confirmPluginInstall(pluginId, config) {
+    displayPluginConfigSummary(pluginId, config);
+    const rl = await createReadlineInterface();
+    try {
+        const answer = (await rl.question("Proceed with installation? [Y/n]: ")).trim().toLowerCase();
+        return !answer || answer.startsWith("y");
+    }
+    finally {
+        rl.close();
+    }
+}

package/dist/cli/program/register.subclis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.subclis.d.ts","sourceRoot":"","sources":["../../../src/cli/program/register.subclis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAElE,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAyTF,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD;AAED,wBAAgB,gCAAgC,IAAI,MAAM,EAAE,CAE3D;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ3F;AAaD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,MAAM,EAAiB,QAkBrF"}
+{"version":3,"file":"register.subclis.d.ts","sourceRoot":"","sources":["../../../src/cli/program/register.subclis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAElE,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAkUF,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD;AAED,wBAAgB,gCAAgC,IAAI,MAAM,EAAE,CAE3D;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ3F;AAaD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,MAAM,EAAiB,QAkBrF"}

package/dist/cli/program/register.subclis.js

@@ -290,6 +290,15 @@ const entries = [
             mod.registerInferCli(program);
         },
     },
+    {
+        name: "onboard",
+        description: "Interactive setup wizard for new Pool Bot installations",
+        hasSubcommands: false,
+        register: async (program) => {
+            const mod = await import("../onboard-cli.js");
+            mod.registerOnboardCli(program);
+        },
+    },
     {
         name: "completion",
         description: "Generate shell completion script",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolzin/pool-bot",
-  "version": "2026.4.42",
+  "version": "2026.4.44",
   "description": "🎱 Pool Bot - AI assistant with PLCODE integrations",
   "keywords": [],
   "license": "MIT",