@web42/cli 0.1.0

package/dist/commands/auth.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const authCommand: Command;

package/dist/commands/auth.js

@@ -0,0 +1,86 @@
+import { randomBytes } from "crypto";
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { apiPost } from "../utils/api.js";
+import { clearAuth, getConfig, setAuth } from "../utils/config.js";
+export const authCommand = new Command("auth").description("Authenticate with the Web42 marketplace");
+authCommand
+    .command("login")
+    .description("Sign in via GitHub OAuth in the browser")
+    .action(async () => {
+    const config = getConfig();
+    const code = randomBytes(16).toString("hex");
+    const spinner = ora("Registering auth code...").start();
+    try {
+        await apiPost("/api/auth/cli", { action: "register", code });
+        spinner.stop();
+        const loginUrl = `${config.apiUrl}/login?cli_code=${code}`;
+        console.log();
+        console.log(chalk.bold("Open this URL in your browser to authenticate:"));
+        console.log();
+        console.log(chalk.cyan(loginUrl));
+        console.log();
+        // Try to open browser automatically
+        const { exec } = await import("child_process");
+        const platform = process.platform;
+        const openCmd = platform === "darwin"
+            ? "open"
+            : platform === "win32"
+                ? "start"
+                : "xdg-open";
+        exec(`${openCmd} "${loginUrl}"`);
+        const pollSpinner = ora("Waiting for authentication...").start();
+        // Poll for confirmation
+        const maxAttempts = 60;
+        for (let i = 0; i < maxAttempts; i++) {
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            try {
+                const result = await apiPost("/api/auth/cli", { action: "poll", code });
+                if (result.status === "authenticated" && result.user_id && result.token) {
+                    pollSpinner.succeed("Authenticated!");
+                    setAuth({
+                        userId: result.user_id,
+                        username: result.username ?? "",
+                        token: result.token,
+                        fullName: result.full_name,
+                        avatarUrl: result.avatar_url,
+                    });
+                    console.log();
+                    console.log(chalk.green(`Logged in as ${chalk.bold(`@${result.username}`)}`));
+                    return;
+                }
+            }
+            catch {
+                // Continue polling
+            }
+        }
+        pollSpinner.fail("Authentication timed out. Please try again.");
+    }
+    catch (error) {
+        spinner.fail("Failed to start auth flow");
+        console.error(error);
+        process.exit(1);
+    }
+});
+authCommand
+    .command("logout")
+    .description("Sign out and clear saved credentials")
+    .action(() => {
+    clearAuth();
+    console.log(chalk.green("Logged out successfully."));
+});
+authCommand
+    .command("whoami")
+    .description("Show the currently authenticated user")
+    .action(() => {
+    const config = getConfig();
+    if (!config.authenticated || !config.username) {
+        console.log(chalk.yellow("Not authenticated. Run `web42 auth login`."));
+        return;
+    }
+    console.log(chalk.green(`@${config.username}`));
+    if (config.fullName) {
+        console.log(chalk.dim(config.fullName));
+    }
+});

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const configCommand: Command;

package/dist/commands/config.js

@@ -0,0 +1,27 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { getConfig, setApiUrl } from "../utils/config.js";
+export const configCommand = new Command("config").description("View or update CLI configuration");
+configCommand
+    .command("show")
+    .description("Show the current configuration")
+    .action(() => {
+    const cfg = getConfig();
+    console.log(chalk.bold("Web42 CLI Configuration"));
+    console.log();
+    console.log(`  API URL:        ${chalk.cyan(cfg.apiUrl)}`);
+    console.log(`  Authenticated:  ${cfg.authenticated ? chalk.green("yes") : chalk.yellow("no")}`);
+    if (cfg.username) {
+        console.log(`  User:           ${chalk.cyan(`@${cfg.username}`)}`);
+    }
+    if (cfg.fullName) {
+        console.log(`  Name:           ${cfg.fullName}`);
+    }
+});
+configCommand
+    .command("set-url <url>")
+    .description("Persistently set the API URL (e.g. http://localhost:3000)")
+    .action((url) => {
+    setApiUrl(url);
+    console.log(chalk.green(`API URL set to ${chalk.bold(url)}`));
+});

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const initCommand: Command;

package/dist/commands/init.js

@@ -0,0 +1,171 @@
+import { writeFileSync, existsSync, readdirSync, readFileSync, } from "fs";
+import { join } from "path";
+import { Command } from "commander";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { requireAuth } from "../utils/config.js";
+import { parseSkillMd } from "../utils/skill.js";
+import { AGENTS_MD, IDENTITY_MD, SOUL_MD, TOOLS_MD, USER_MD, HEARTBEAT_MD, INIT_BOOTSTRAP_MD, } from "../platforms/openclaw/templates.js";
+function detectWorkspaceSkills(cwd) {
+    const skillsDir = join(cwd, "skills");
+    if (!existsSync(skillsDir))
+        return [];
+    const skills = [];
+    try {
+        const entries = readdirSync(skillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const skillMd = join(skillsDir, entry.name, "SKILL.md");
+                if (existsSync(skillMd)) {
+                    const content = readFileSync(skillMd, "utf-8");
+                    const parsed = parseSkillMd(content, entry.name);
+                    skills.push(parsed);
+                }
+            }
+        }
+    }
+    catch {
+        // ignore read errors
+    }
+    return skills.sort((a, b) => a.name.localeCompare(b.name));
+}
+const CATEGORIES = [
+    "Customer Support",
+    "Healthcare",
+    "Developer Tools",
+    "Personal Assistant",
+    "Sales",
+    "Marketing",
+    "Education",
+    "Finance",
+    "Content Creation",
+    "Productivity",
+];
+export const initCommand = new Command("init")
+    .description("Create a manifest.json for your agent package")
+    .action(async () => {
+    const config = requireAuth();
+    const cwd = process.cwd();
+    const manifestPath = join(cwd, "manifest.json");
+    if (existsSync(manifestPath)) {
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "overwrite",
+                message: "manifest.json already exists. Overwrite?",
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            console.log(chalk.yellow("Aborted."));
+            return;
+        }
+    }
+    const answers = await inquirer.prompt([
+        {
+            type: "list",
+            name: "platform",
+            message: "Platform:",
+            choices: ["openclaw"],
+            default: "openclaw",
+        },
+        {
+            type: "input",
+            name: "name",
+            message: "Agent name (lowercase, hyphens allowed):",
+            validate: (val) => /^[a-z0-9][a-z0-9-]*$/.test(val) ||
+                "Must be lowercase alphanumeric with hyphens",
+        },
+        {
+            type: "input",
+            name: "description",
+            message: "Short description:",
+            validate: (val) => val.length > 0 && val.length <= 500 || "1-500 characters",
+        },
+        {
+            type: "input",
+            name: "version",
+            message: "Version:",
+            default: "1.0.0",
+            validate: (val) => /^\d+\.\d+\.\d+$/.test(val) || "Must follow semver (e.g. 1.0.0)",
+        },
+        {
+            type: "list",
+            name: "category",
+            message: "Primary category:",
+            choices: CATEGORIES,
+        },
+        {
+            type: "input",
+            name: "tags",
+            message: "Tags (comma-separated):",
+            filter: (val) => val
+                .split(",")
+                .map((t) => t.trim())
+                .filter(Boolean),
+        },
+        {
+            type: "input",
+            name: "primaryModel",
+            message: "Primary model preference (e.g. claude-sonnet-4-20250514):",
+            default: "",
+        },
+        {
+            type: "input",
+            name: "demoVideoUrl",
+            message: "Demo video URL (optional):",
+            default: "",
+        },
+    ]);
+    const detectedSkills = detectWorkspaceSkills(cwd);
+    if (detectedSkills.length > 0) {
+        console.log(chalk.dim(`  Detected ${detectedSkills.length} skill(s): ${detectedSkills.map((s) => s.name).join(", ")}`));
+    }
+    const manifest = {
+        format: "agentpkg/1",
+        platform: answers.platform,
+        name: answers.name,
+        description: answers.description,
+        version: answers.version,
+        author: config.username,
+        skills: detectedSkills,
+        plugins: [],
+        modelPreferences: answers.primaryModel
+            ? { primary: answers.primaryModel }
+            : undefined,
+        tags: answers.tags,
+        demoVideoUrl: answers.demoVideoUrl || undefined,
+        configVariables: [],
+    };
+    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+    console.log();
+    console.log(chalk.green(`Created ${chalk.bold("manifest.json")}`));
+    const scaffoldFiles = [
+        { name: "AGENTS.md", content: AGENTS_MD, alwaysWrite: false },
+        { name: "IDENTITY.md", content: IDENTITY_MD, alwaysWrite: false },
+        { name: "SOUL.md", content: SOUL_MD, alwaysWrite: false },
+        { name: "TOOLS.md", content: TOOLS_MD, alwaysWrite: false },
+        { name: "HEARTBEAT.md", content: HEARTBEAT_MD, alwaysWrite: false },
+        { name: "BOOTSTRAP.md", content: INIT_BOOTSTRAP_MD, alwaysWrite: false },
+        { name: "USER.md", content: USER_MD, alwaysWrite: true },
+    ];
+    const created = [];
+    const skipped = [];
+    for (const file of scaffoldFiles) {
+        const filePath = join(cwd, file.name);
+        if (!file.alwaysWrite && existsSync(filePath)) {
+            skipped.push(file.name);
+            continue;
+        }
+        writeFileSync(filePath, file.content, "utf-8");
+        created.push(file.name);
+    }
+    if (created.length > 0) {
+        console.log(chalk.green(`  Scaffolded: ${created.join(", ")}`));
+    }
+    if (skipped.length > 0) {
+        console.log(chalk.dim(`  Skipped (already exist): ${skipped.join(", ")}`));
+    }
+    console.log();
+    console.log(chalk.dim("Run `web42 pack` to bundle your agent, or `web42 push` to pack and publish."));
+});

package/dist/commands/install.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { PlatformAdapter } from "../platforms/base.js";
+export declare function makeInstallCommand(adapter: PlatformAdapter): Command;

package/dist/commands/install.js

@@ -0,0 +1,198 @@
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { Command } from "commander";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import ora from "ora";
+import { apiGet, apiPost } from "../utils/api.js";
+function deriveProviderEnvKey(model) {
+    const slash = model.indexOf("/");
+    if (slash < 1)
+        return null;
+    const provider = model.slice(0, slash);
+    const envKey = `${provider.toUpperCase().replace(/-/g, "_")}_API_KEY`;
+    return { provider, envKey };
+}
+function isKeyConfigured(envKey, platformHome) {
+    if (process.env[envKey])
+        return true;
+    const dotenvPath = join(platformHome, ".env");
+    if (!existsSync(dotenvPath))
+        return false;
+    try {
+        const content = readFileSync(dotenvPath, "utf-8");
+        return content.split("\n").some((line) => {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("#"))
+                return false;
+            const eqIdx = trimmed.indexOf("=");
+            return eqIdx > 0 && trimmed.slice(0, eqIdx).trim() === envKey;
+        });
+    }
+    catch {
+        return false;
+    }
+}
+function appendToEnv(envKey, value, platformHome) {
+    const dotenvPath = join(platformHome, ".env");
+    const line = `${envKey}=${value}\n`;
+    appendFileSync(dotenvPath, line, "utf-8");
+}
+export function makeInstallCommand(adapter) {
+    return new Command("install")
+        .description("Install an agent package from the marketplace")
+        .argument("<agent>", "Agent to install (e.g. @user/agent-name)")
+        .option("--as <name>", "Install under a different local agent name")
+        .option("--no-prompt", "Skip config variable prompts, use defaults")
+        .action(async (agentRef, opts) => {
+        const match = agentRef.match(/^@?([^/]+)\/(.+)$/);
+        if (!match) {
+            console.log(chalk.red("Invalid agent reference. Use @user/agent-name format."));
+            process.exit(1);
+        }
+        const [, username, agentSlug] = match;
+        const spinner = ora(`Fetching @${username}/${agentSlug}...`).start();
+        try {
+            const agents = await apiGet(`/api/agents?username=${username}`);
+            const agent = agents.find((a) => a.slug === agentSlug);
+            if (!agent) {
+                spinner.fail(`Agent @${username}/${agentSlug} not found`);
+                process.exit(1);
+            }
+            let result;
+            try {
+                result = await apiPost(`/api/agents/${agent.id}/install`, {});
+            }
+            catch (err) {
+                if (err.message?.includes("Access required") &&
+                    agent.price_cents > 0) {
+                    const siteUrl = process.env.WEB42_API_URL ?? "https://marketplace.web42.ai";
+                    spinner.fail(`This is a paid agent ($${(agent.price_cents / 100).toFixed(2)}). Purchase it on the web first:`);
+                    console.log(chalk.cyan(`  ${siteUrl}/${username}/${agentSlug}`));
+                    process.exit(1);
+                }
+                throw err;
+            }
+            const manifest = result.agent.manifest;
+            let configAnswers = {};
+            if (manifest.configVariables && manifest.configVariables.length > 0) {
+                if (opts.prompt === false) {
+                    for (const v of manifest.configVariables) {
+                        configAnswers[v.key] = v.default ?? "";
+                    }
+                    spinner.text = "Installing agent (skipping prompts)...";
+                }
+                else {
+                    spinner.stop();
+                    console.log();
+                    console.log(chalk.bold("Configure your agent:"));
+                    console.log();
+                    configAnswers = await inquirer.prompt(manifest.configVariables.map((v) => ({
+                        type: "input",
+                        name: v.key,
+                        message: `${v.label}${v.description ? ` (${v.description})` : ""}:`,
+                        default: v.default,
+                        validate: (val) => !v.required || val.length > 0 || `${v.label} is required`,
+                    })));
+                    spinner.start("Installing agent...");
+                }
+            }
+            else {
+                spinner.text = "Installing agent...";
+            }
+            const primaryModel = manifest.modelPreferences?.primary;
+            if (primaryModel) {
+                const providerInfo = deriveProviderEnvKey(primaryModel);
+                if (providerInfo) {
+                    if (isKeyConfigured(providerInfo.envKey, adapter.home)) {
+                        if (spinner.isSpinning)
+                            spinner.stop();
+                        console.log(chalk.dim(`  ${providerInfo.envKey} already configured for ${primaryModel}`));
+                        if (!spinner.isSpinning)
+                            spinner.start("Installing agent...");
+                    }
+                    else if (opts.prompt === false) {
+                        if (spinner.isSpinning)
+                            spinner.stop();
+                        console.log();
+                        console.log(chalk.yellow(`  This agent uses ${chalk.bold(primaryModel)}. You'll need to set ${chalk.bold(providerInfo.envKey)} in ${adapter.home}/.env or as an environment variable.`));
+                        spinner.start("Installing agent...");
+                    }
+                    else {
+                        if (spinner.isSpinning)
+                            spinner.stop();
+                        console.log();
+                        console.log(chalk.bold(`This agent uses ${chalk.cyan(primaryModel)}.`));
+                        const { apiKey } = await inquirer.prompt([
+                            {
+                                type: "password",
+                                name: "apiKey",
+                                message: `Enter your ${providerInfo.envKey} (leave empty to skip):`,
+                                mask: "*",
+                            },
+                        ]);
+                        if (apiKey) {
+                            appendToEnv(providerInfo.envKey, apiKey, adapter.home);
+                            console.log(chalk.green(`  Saved ${providerInfo.envKey} to ${adapter.home}/.env`));
+                        }
+                        else {
+                            console.log(chalk.yellow(`  Skipped. Set ${chalk.bold(providerInfo.envKey)} in ${adapter.home}/.env later.`));
+                        }
+                        spinner.start("Installing agent...");
+                    }
+                }
+            }
+            let configTemplate = null;
+            const configFile = result.files.find((f) => f.path === ".openclaw/config.json" && f.content);
+            if (configFile?.content) {
+                try {
+                    configTemplate = JSON.parse(configFile.content);
+                }
+                catch {
+                    // No config template available
+                }
+            }
+            const localName = opts.as ?? agentSlug;
+            const workspacePath = join(adapter.home, `workspace-${localName}`);
+            const installResult = await adapter.install({
+                agentSlug: localName,
+                username,
+                workspacePath,
+                files: result.files,
+                configTemplate,
+                configAnswers,
+            });
+            const web42Config = {
+                source: `@${username}/${agentSlug}`,
+                ...configAnswers,
+            };
+            const configPath = join(workspacePath, ".web42.config.json");
+            writeFileSync(configPath, JSON.stringify(web42Config, null, 2) + "\n");
+            spinner.stop();
+            console.log();
+            console.log(chalk.green(`Installed ${chalk.bold(`@${username}/${agentSlug}`)} as agent "${localName}"`));
+            console.log(chalk.dim(`  Workspace: ${workspacePath}`));
+            if (manifest.skills && manifest.skills.length > 0) {
+                console.log(chalk.dim(`  Skills: ${manifest.skills.join(", ")}`));
+            }
+            console.log(chalk.dim(`  ${installResult.filesWritten} files written`));
+            const pendingVars = (manifest.configVariables ?? []).filter((v) => v.required && !configAnswers[v.key]);
+            if (pendingVars.length > 0) {
+                console.log();
+                console.log(chalk.yellow(`  ${pendingVars.length} config variable(s) still need setup:`));
+                for (const v of pendingVars) {
+                    console.log(chalk.yellow(`    - ${v.label} (${v.key})`));
+                }
+            }
+            console.log();
+            console.log(chalk.dim("  Next steps:"));
+            console.log(chalk.dim(`    1. Set up channel bindings:  ${adapter.name} config`));
+            console.log(chalk.dim(`    2. Restart the gateway:      ${adapter.name} gateway restart`));
+        }
+        catch (error) {
+            spinner.fail("Install failed");
+            console.error(chalk.red(error.message));
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/list.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { PlatformAdapter } from "../platforms/base.js";
+export declare function makeListCommand(adapter: PlatformAdapter): Command;

package/dist/commands/list.js

@@ -0,0 +1,22 @@
+import { Command } from "commander";
+import chalk from "chalk";
+export function makeListCommand(adapter) {
+    return new Command("list")
+        .description("List installed agents")
+        .action(async () => {
+        const agents = await adapter.listInstalled();
+        if (agents.length === 0) {
+            console.log(chalk.yellow("No agents installed."));
+            console.log(chalk.dim(`Run \`web42 ${adapter.name} install @user/agent\` to install one.`));
+            return;
+        }
+        console.log(chalk.bold(`Installed ${adapter.name} agents:`));
+        console.log();
+        for (const agent of agents) {
+            console.log(`  ${chalk.cyan(agent.source ?? agent.name)}`);
+            if (agent.workspace) {
+                console.log(chalk.dim(`    ${agent.workspace}`));
+            }
+        }
+    });
+}

package/dist/commands/pack.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const packCommand: Command;

package/dist/commands/pack.js

@@ -0,0 +1,80 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { openclawAdapter } from "../platforms/openclaw/adapter.js";
+import { parseSkillMd } from "../utils/skill.js";
+export const packCommand = new Command("pack")
+    .description("Pack your agent workspace into a distributable artifact")
+    .option("-o, --output <dir>", "Output directory", ".web42")
+    .option("--dry-run", "Preview what would be packed without writing files")
+    .action(async (opts) => {
+    const cwd = process.cwd();
+    const manifestPath = join(cwd, "manifest.json");
+    if (!existsSync(manifestPath)) {
+        console.log(chalk.red("No manifest.json found. Run `web42 init` first."));
+        process.exit(1);
+    }
+    const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+    if (!manifest.name || !manifest.version || !manifest.author) {
+        console.log(chalk.red("Invalid manifest.json. Must have name, version, and author."));
+        process.exit(1);
+    }
+    const spinner = ora("Packing agent...").start();
+    try {
+        const result = await openclawAdapter.pack({ cwd, outputDir: opts.output });
+        // Detect skills from packed files (skills/*/SKILL.md pattern)
+        const detectedSkills = [];
+        for (const f of result.files) {
+            const match = f.path.match(/^skills\/([^/]+)\/SKILL\.md$/);
+            if (match) {
+                const parsed = parseSkillMd(f.content, match[1]);
+                detectedSkills.push(parsed);
+            }
+        }
+        if (detectedSkills.length > 0) {
+            manifest.skills = detectedSkills.sort((a, b) => a.name.localeCompare(b.name));
+        }
+        // Merge auto-generated config variables into manifest
+        const existingKeys = new Set((manifest.configVariables ?? []).map((v) => v.key));
+        for (const cv of result.configVariables) {
+            if (!existingKeys.has(cv.key)) {
+                if (!manifest.configVariables)
+                    manifest.configVariables = [];
+                manifest.configVariables.push(cv);
+                existingKeys.add(cv.key);
+            }
+        }
+        if (opts.dryRun) {
+            spinner.stop();
+            console.log(chalk.bold("Dry run — would pack:"));
+            console.log();
+            for (const f of result.files) {
+                console.log(chalk.dim(`  ${f.path} (${f.content.length} bytes)`));
+            }
+            console.log();
+            console.log(chalk.dim(`${result.files.length} files, ${result.configVariables.length} config variable(s)`));
+            return;
+        }
+        const outputDir = join(cwd, opts.output);
+        mkdirSync(outputDir, { recursive: true });
+        for (const file of result.files) {
+            const filePath = join(outputDir, file.path);
+            mkdirSync(join(filePath, ".."), { recursive: true });
+            writeFileSync(filePath, file.content, "utf-8");
+        }
+        writeFileSync(join(outputDir, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
+        spinner.succeed(`Packed ${chalk.bold(manifest.name)} (${result.files.length} files) → ${opts.output}/`);
+        if (result.configVariables.length > 0) {
+            console.log(chalk.dim(`  ${result.configVariables.length} config variable(s) detected`));
+        }
+        console.log();
+        console.log(chalk.dim("Run `web42 push` to publish to the marketplace."));
+    }
+    catch (error) {
+        spinner.fail("Pack failed");
+        console.error(chalk.red(error.message));
+        process.exit(1);
+    }
+});

package/dist/commands/pull.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const pullCommand: Command;