@poolzin/pool-bot 2026.4.43 → 2026.4.45

package/dist/cli/onboard-cli.js

@@ -0,0 +1,443 @@
+/**
+ * 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.map

@@ -1 +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;AA8HlD;;;;;;;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,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAqBN;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,CAUlB"}
+{"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

@@ -59,7 +59,7 @@ async function promptSelect(rl, question, options, defaultValue) {
     return options[index];
 }
 async function promptField(rl, field) {
-    const { key, label, description, type, default: defaultValue, options, required, validate } = field;
+    const { key, label, description, type, default: defaultValue, options, required, validate, } = field;
     if (description) {
         console.log(`  ${label}: ${description}`);
     }

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;AA2UF,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,24 @@ const entries = [
             mod.registerInferCli(program);
         },
     },
+    {
+        name: "sessions",
+        description: "Manage session checkpoints (branch/restore)",
+        hasSubcommands: true,
+        register: async (program) => {
+            const mod = await import("../sessions-checkpoints-cli.js");
+            mod.registerSessionCheckpointsCli(program);
+        },
+    },
+    {
+        name: "webhooks",
+        description: "Manage webhook ingress routes (TaskFlows via HTTP)",
+        hasSubcommands: true,
+        register: async (program) => {
+            const mod = await import("../webhooks-cli.js");
+            mod.registerWebhooksCli(program);
+        },
+    },
     {
         name: "completion",
         description: "Generate shell completion script",

package/dist/cli/sessions-checkpoints-cli.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Session Checkpoints CLI
+ */
+import type { Command } from "commander";
+export declare function registerSessionCheckpointsCli(program: Command): void;
+//# sourceMappingURL=sessions-checkpoints-cli.d.ts.map

package/dist/cli/sessions-checkpoints-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-checkpoints-cli.d.ts","sourceRoot":"","sources":["../../src/cli/sessions-checkpoints-cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,QAgH7D"}

package/dist/cli/sessions-checkpoints-cli.js

@@ -0,0 +1,117 @@
+/**
+ * Session Checkpoints CLI
+ */
+import { loadConfig } from "../config/config.js";
+import { resolveAgentWorkspaceDir } from "../agents/agent-scope.js";
+import { defaultRuntime } from "../runtime.js";
+import { theme } from "../terminal/theme.js";
+import { danger, info, success } from "../globals.js";
+import { formatDocsLink } from "../terminal/links.js";
+import { listAllCheckpoints, listSessionCheckpoints, getCheckpoint, pruneOldCheckpoints, getCheckpointStats, } from "../sessions/checkpoints.js";
+import { runCommandWithRuntime } from "./cli-utils.js";
+function runSessionCommand(action) {
+    return runCommandWithRuntime(defaultRuntime, action);
+}
+export function registerSessionCheckpointsCli(program) {
+    const checkpoints = program
+        .command("checkpoints")
+        .description("Manage session checkpoints (list/show/prune)")
+        .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/sessions/checkpoints", "docs.molt.bot/sessions/checkpoints")}\n`);
+    checkpoints
+        .command("list")
+        .description("List session checkpoints")
+        .option("--json", "Output JSON", false)
+        .option("--session <key>", "Filter by session key")
+        .option("--limit <n>", "Maximum checkpoints to return", "50")
+        .action(async (opts) => {
+        await runSessionCommand(async () => {
+            const config = loadConfig();
+            const workspaceDir = resolveAgentWorkspaceDir(config, "main");
+            const checkpointsList = opts.session
+                ? listSessionCheckpoints(workspaceDir, opts.session)
+                : listAllCheckpoints(workspaceDir, Number.parseInt(opts.limit || "50", 10));
+            if (opts.json) {
+                defaultRuntime.log(JSON.stringify(checkpointsList, null, 2));
+                return;
+            }
+            defaultRuntime.log("");
+            defaultRuntime.log(theme.heading("Session Checkpoints"));
+            defaultRuntime.log(theme.muted("─────────────────────────────────────────"));
+            if (checkpointsList.length === 0) {
+                defaultRuntime.log(info("No checkpoints found."));
+            }
+            else {
+                for (const checkpoint of checkpointsList) {
+                    const date = new Date(checkpoint.createdAt).toLocaleString();
+                    const reason = checkpoint.reason === "auto-compaction" ? "🔄 auto" : `📌 ${checkpoint.reason}`;
+                    defaultRuntime.log(`  ${theme.success("●")} ${checkpoint.id.substring(0, 12)}... | ${reason} | ${date}`);
+                    if (checkpoint.metadata?.model)
+                        defaultRuntime.log(theme.muted(`      Model: ${checkpoint.metadata.model}`));
+                }
+            }
+            const stats = getCheckpointStats(workspaceDir);
+            defaultRuntime.log(theme.muted(`Total: ${stats.total} checkpoints`));
+            defaultRuntime.exit(0);
+        });
+    });
+    checkpoints
+        .command("show <id>")
+        .description("Show checkpoint details")
+        .option("--json", "Output JSON", false)
+        .action(async (id, opts) => {
+        await runSessionCommand(async () => {
+            const config = loadConfig();
+            const workspaceDir = resolveAgentWorkspaceDir(config, "main");
+            const checkpoint = getCheckpoint(workspaceDir, id);
+            if (!checkpoint) {
+                defaultRuntime.log(danger(`Checkpoint "${id}" not found.`));
+                defaultRuntime.exit(1);
+                return;
+            }
+            if (opts.json) {
+                defaultRuntime.log(JSON.stringify(checkpoint, null, 2));
+                return;
+            }
+            defaultRuntime.log("");
+            defaultRuntime.log(theme.heading(`Checkpoint: ${checkpoint.id}`));
+            defaultRuntime.log(theme.muted("─────────────────────────────────────────"));
+            defaultRuntime.log(`  Session: ${checkpoint.sessionKey}`);
+            defaultRuntime.log(`  Reason: ${checkpoint.reason}`);
+            defaultRuntime.log(`  Created: ${new Date(checkpoint.createdAt).toLocaleString()}`);
+            if (checkpoint.metadata?.model)
+                defaultRuntime.log(`  Model: ${checkpoint.metadata.model}`);
+            if (checkpoint.metadata?.note)
+                defaultRuntime.log(`  Note: ${checkpoint.metadata.note}`);
+            defaultRuntime.exit(0);
+        });
+    });
+    checkpoints
+        .command("prune")
+        .description("Prune old checkpoints")
+        .option("--age <days>", "Prune checkpoints older than N days", "30")
+        .option("--yes", "Skip confirmation", false)
+        .action(async (opts) => {
+        await runSessionCommand(async () => {
+            const config = loadConfig();
+            const workspaceDir = resolveAgentWorkspaceDir(config, "main");
+            const ageDays = Number.parseInt(opts.age || "30", 10);
+            const maxAgeMs = ageDays * 24 * 60 * 60 * 1000;
+            if (!opts.yes) {
+                const stats = getCheckpointStats(workspaceDir);
+                defaultRuntime.log("");
+                defaultRuntime.log(danger(`⚠️  This will prune checkpoints older than ${ageDays} days`));
+                defaultRuntime.log(`Current checkpoints: ${stats.total}`);
+                if (stats.oldest)
+                    defaultRuntime.log(`Oldest: ${new Date(stats.oldest).toLocaleDateString()}`);
+                defaultRuntime.log("");
+                defaultRuntime.log(info("Use --yes to skip this confirmation."));
+                defaultRuntime.exit(1);
+                return;
+            }
+            const pruned = pruneOldCheckpoints(workspaceDir, maxAgeMs);
+            defaultRuntime.log("");
+            defaultRuntime.log(success(`Pruned ${pruned} old checkpoint(s).`));
+            defaultRuntime.exit(0);
+        });
+    });
+}

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

@@ -1,3 +1,16 @@
+/**
+ * Webhook CLI - Manage webhook ingress routes
+ *
+ * Commands:
+ *   poolbot webhooks list              # List all webhook routes
+ *   poolbot webhooks create <path>     # Create webhook route
+ *   poolbot webhooks show <id>         # Show webhook details
+ *   poolbot webhooks delete <id>       # Delete webhook route
+ *   poolbot webhooks enable <id>       # Enable webhook route
+ *   poolbot webhooks disable <id>      # Disable webhook route
+ *   poolbot webhooks stats             # Show webhook statistics
+ *   poolbot webhooks serve             # Start webhook server
+ */
 import type { Command } from "commander";
 export declare function registerWebhooksCli(program: Command): void;
 //# sourceMappingURL=webhooks-cli.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"webhooks-cli.d.ts","sourceRoot":"","sources":["../../src/cli/webhooks-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAkFnD"}
+{"version":3,"file":"webhooks-cli.d.ts","sourceRoot":"","sources":["../../src/cli/webhooks-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkCzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA4WnD"}