@lobu/cli 6.0.1 → 7.0.0

package/dist/index.js

@@ -11,6 +11,14 @@ async function getPackageVersion() {
     const pkg = JSON.parse(pkgContent);
     return pkg.version ?? "0.0.0";
 }
+function withCommonOpts(cmd, opts = {}) {
+    cmd.option("-c, --context <name>", "Use a named context");
+    if (opts.org)
+        cmd.option("--org <slug>", "Org slug override");
+    if (opts.json)
+        cmd.option("--json", "Print JSON");
+    return cmd;
+}
 function handleCliError(error) {
     const exitCode = typeof error === "object" &&
         error !== null &&
@@ -29,14 +37,77 @@ export async function runCli(argv = process.argv) {
         .name("lobu")
         .description("CLI for deploying and managing AI agents on Lobu")
         .version(version);
+    // Group commands in --help output. Commander v14 has no native grouping,
+    // so we override the help formatter via addHelpText to print our own
+    // categorized list. The flat command list is still available.
+    program.addHelpText("after", `
+Local dev:
+  init [name]              Scaffold a new agent project
+  run | dev | start        Boot the embedded Lobu stack
+  chat <prompt>            Send a prompt to an agent and stream the response
+  eval [name]              Run agent evaluations
+  validate                 Validate lobu.toml
+  doctor                   Health checks (deps, DB, pgvector, ports, keys)
+  telemetry                Show / toggle anonymous error reporting
+
+Cloud:
+  login | logout           OAuth device-code login (or --token for CI)
+  whoami | status          Show user / agent state
+  context <subcmd>         Manage API contexts
+  org <subcmd>             Manage active org slug
+  link | unlink            Bind this directory to a (context, org)
+  apply | deploy           Sync lobu.toml to cloud (idempotent)
+  agent <subcmd>           CRUD agents via REST
+  token [create]           Print or mint personal access tokens
+
+Memory:
+  memory run [tool]        Invoke a memory MCP tool
+  memory exec <script>     Run a ClientSDK script
+  memory health            Validate login + MCP connectivity
+  memory configure         Wire OpenClaw config
+  memory seed [path]       Provision a memory workspace
+  memory init              Wire agents to a memory MCP endpoint
+`);
     // ─── init ───────────────────────────────────────────────────────────
     program
         .command("init [name]")
         .description("Scaffold a new agent project (lobu.toml + agent files + .env)")
-        .action(async (name) => {
+        .option("-y, --yes", "Skip prompts; use defaults / flag values")
+        .option("--here", "Scaffold into the current directory (alias for `init .`)")
+        .option("--port <port>", "Gateway port (default 8787)")
+        .option("--public-url <url>", "Public gateway URL (OAuth/webhooks)")
+        .option("--network <policy>", "Worker network policy: restricted | open | isolated")
+        .option("--provider <id>", "Provider id from `config/providers.json`")
+        .option("--provider-key <key>", "Provider API key (else read from env)")
+        .option("--platform <type>", "Chat platform: telegram | slack | discord | whatsapp | teams | gchat")
+        .option("--memory <choice>", "Memory backend: none | lobu-cloud | lobu-custom")
+        .option("--memory-url <url>", "Custom memory MCP URL (with --memory lobu-custom)")
+        .option("--otel-endpoint <url>", "OpenTelemetry collector endpoint")
+        .option("--sentry", "Enable Sentry error reporting")
+        .option("--no-sentry", "Disable Sentry without prompting")
+        .option("--slack-preview", "Enable public Lobu Developer Slack Preview in lobu.toml")
+        .option("--no-slack-preview", "Disable Slack Preview without prompting")
+        .action(async (name, options) => {
         try {
             const { initCommand } = await import("./commands/init.js");
-            await initCommand(process.cwd(), name);
+            // Commander gives a tristate: true for --sentry, false for
+            // --no-sentry, undefined for neither.
+            await initCommand(process.cwd(), name, {
+                yes: options.yes,
+                here: options.here,
+                port: options.port,
+                publicUrl: options.publicUrl,
+                network: options.network,
+                provider: options.provider,
+                providerKey: options.providerKey,
+                platform: options.platform,
+                memory: options.memory,
+                memoryUrl: options.memoryUrl,
+                otelEndpoint: options.otelEndpoint,
+                sentry: options.sentry === true,
+                noSentry: options.sentry === false,
+                slackPreview: options.slackPreview,
+            });
         }
         catch (error) {
             console.error(chalk.red("\n  Error:"), error);
@@ -46,20 +117,23 @@ export async function runCli(argv = process.argv) {
     // ─── chat ──────────────────────────────────────────────────────────
     program
         .command("chat <prompt>")
-        .description("Send a prompt to an agent and stream the response")
+        .description("Send a prompt to an agent and stream the response. With --user, routes through Telegram/Slack.")
         .option("-a, --agent <id>", "Agent ID (defaults to first in lobu.toml)")
         .option("-u, --user <id>", "User ID to impersonate (e.g. telegram:12345)")
         .option("-t, --thread <id>", "Thread/conversation ID for multi-turn")
         .option("-g, --gateway <url>", `Gateway URL (default: ${GATEWAY_DEFAULT_URL})`)
         .option("--dry-run", "Process without persisting history")
         .option("--new", "Force new session (ignore existing)")
+        .option("-C, --continue", "Resume the last thread for this (context, agent)")
+        .option("--auto-approve", "Auto-approve every tool call (use only in trusted environments)")
+        .option("--json", "Emit raw SSE events as JSON lines instead of text")
         .option("-c, --context <name>", "Use a named context")
         .action(async (prompt, options) => {
         const { chatCommand } = await import("./commands/chat.js");
         await chatCommand(process.cwd(), prompt, options);
     });
     // ─── eval ──────────────────────────────────────────────────────────
-    program
+    const evalCmd = program
         .command("eval [name]")
         .description("Run agent evaluations")
         .option("-a, --agent <id>", "Agent ID (defaults to first in lobu.toml)")
@@ -74,6 +148,16 @@ export async function runCli(argv = process.argv) {
         const { evalCommand } = await import("./commands/eval.js");
         await evalCommand(process.cwd(), name, options);
     });
+    evalCmd
+        .command("new <name>")
+        .description("Scaffold a new YAML eval into the agent's evals/ directory")
+        .option("-a, --agent <id>", "Agent ID (defaults to first in lobu.toml)")
+        .option("--description <text>", "Eval description")
+        .option("--trials <n>", "Trial count", parseInt)
+        .action(async (name, options) => {
+        const { evalNewCommand } = await import("./commands/eval.js");
+        await evalNewCommand(name, options);
+    });
     // ─── validate ───────────────────────────────────────────────────────
     program
         .command("validate")
@@ -84,18 +168,17 @@ export async function runCli(argv = process.argv) {
         if (!valid)
             process.exit(1);
     });
-    // ─── apply ──────────────────────────────────────────────────────────
-    // One-way `lobu.toml` → cloud org converger. GETs current state, renders
-    // a diff, prompts to confirm, then loops over the existing CRUD endpoints
-    // in dependency order. Re-running converges on partial failure.
+    // ─── apply / deploy ─────────────────────────────────────────────────
     program
         .command("apply")
+        .alias("deploy")
         .description("Sync lobu.toml + agent dirs to your Lobu Cloud org (idempotent)")
         .option("--dry-run", "Show the plan and exit without mutating")
         .option("--yes", "Skip the confirmation prompt (CI mode)")
         .option("--only <kind>", "Restrict to one resource family: 'agents' | 'memory'")
         .option("--org <slug>", "Org slug override (defaults to active session)")
         .option("--url <url>", "Server URL override")
+        .option("--force", "Bypass the project-link guard if context/org don't match")
         .action(async (options) => {
         if (options.only !== undefined &&
             options.only !== "agents" &&
@@ -103,71 +186,59 @@ export async function runCli(argv = process.argv) {
             console.error(chalk.red("\n  Error:"), `--only must be 'agents' or 'memory' (got: ${options.only})`);
             process.exit(2);
         }
-        const { lobuApplyCommand } = await import("./commands/apply.js");
-        await lobuApplyCommand({
+        const { applyCommand } = await import("./commands/_lib/apply/apply-cmd.js");
+        await applyCommand({
             dryRun: options.dryRun,
             yes: options.yes,
             only: options.only,
             org: options.org,
             url: options.url,
+            force: options.force,
         });
     });
-    // ─── run ────────────────────────────────────────────────────────────
-    // Boots the embedded Lobu stack (gateway + workers + memory backend) as
-    // a single Node process. Extra args are forwarded to the bundle entry.
+    // ─── run / dev / start ──────────────────────────────────────────────
     program
         .command("run")
+        .aliases(["dev", "start"])
         .description("Run the embedded Lobu stack (gateway + workers in one Node process)")
-        .allowUnknownOption(true)
-        .helpOption(false)
-        .action(async (_opts, cmd) => {
+        .option("--port <port>", "Gateway port (overrides GATEWAY_PORT in .env)")
+        .option("--quiet", "Suppress startup banner; raise log level to warn")
+        .option("--verbose", "Lower log level to debug")
+        .option("--log-level <level>", "Forwarded as LOG_LEVEL to the bundle")
+        .action(async (options) => {
         const { devCommand } = await import("./commands/dev.js");
-        await devCommand(process.cwd(), cmd.args);
+        await devCommand(process.cwd(), options);
     });
     // ─── login ──────────────────────────────────────────────────────────
-    program
+    withCommonOpts(program
         .command("login")
         .description("Authenticate with Lobu Cloud")
-        .option("--token <token>", "Use API token directly (CI/CD)")
-        .option("-c, --context <name>", "Use a named context")
+        .option("--token <token>", "Use API token directly (CI/CD)"))
         .option("-f, --force", "Re-authenticate (revokes existing session)")
         .action(async (options) => {
         const { loginCommand } = await import("./commands/login.js");
         await loginCommand({ ...options, cliVersion: version });
     });
     // ─── logout ─────────────────────────────────────────────────────────
-    program
-        .command("logout")
-        .description("Clear stored credentials")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (options) => {
+    withCommonOpts(program.command("logout").description("Clear stored credentials")).action(async (options) => {
         const { logoutCommand } = await import("./commands/logout.js");
         await logoutCommand(options);
     });
     // ─── whoami ─────────────────────────────────────────────────────────
-    program
-        .command("whoami")
-        .description("Show current user and linked agent")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (options) => {
+    withCommonOpts(program.command("whoami").description("Show current user and linked agent")).action(async (options) => {
         const { whoamiCommand } = await import("./commands/whoami.js");
         await whoamiCommand(options);
     });
     // ─── token ──────────────────────────────────────────────────────────
-    const token = program
-        .command("token")
-        .description("Print or create Lobu access tokens")
-        .option("-c, --context <name>", "Use a named context")
+    const token = withCommonOpts(program.command("token").description("Print or create Lobu access tokens"))
         .option("--raw", "Print token only (no labels)")
         .action(async (options) => {
         const { tokenCommand } = await import("./commands/token.js");
         await tokenCommand(options);
     });
-    token
+    withCommonOpts(token
         .command("create")
-        .description("Create an org-scoped personal access token for servers/CI")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
+        .description("Create an org-scoped personal access token for servers/CI"), { org: true })
         .option("--name <name>", "Token name (default: lobu-cli-YYYY-MM-DD)")
         .option("--description <text>", "Token description")
         .option("--scope <scope>", "Space-separated scopes (default: mcp:read mcp:write)")
@@ -184,6 +255,14 @@ export async function runCli(argv = process.argv) {
         const { tokenCreateCommand } = await import("./commands/token.js");
         await tokenCreateCommand(options);
     });
+    token
+        .command("revoke <jti>")
+        .description("Revoke a worker/settings token by its jti (kill switch)")
+        .option("--expires-at <iso>", "Original token expiry (ISO 8601); the revocation row is GC'd past it. Defaults to 24h from now.")
+        .action(async (jti, options) => {
+        const { tokenRevokeCommand } = await import("./commands/token.js");
+        await tokenRevokeCommand(jti, options);
+    });
     // ─── context ────────────────────────────────────────────────────────
     const context = program
         .command("context")
@@ -218,192 +297,191 @@ export async function runCli(argv = process.argv) {
         await contextUseCommand(name);
     });
     // ─── status ─────────────────────────────────────────────────────────
-    program
+    withCommonOpts(program
         .command("status")
-        .description("Show agent status from the active org")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
-        .action(async (options) => {
+        .description("Show agent status from the active org"), { org: true }).action(async (options) => {
         const { statusCommand } = await import("./commands/status.js");
         await statusCommand(options);
     });
     // ─── org ────────────────────────────────────────────────────────────
     const org = program.command("org").description("Manage active Lobu org");
-    org
+    withCommonOpts(org
         .command("list")
-        .description("List organizations available to the current login")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (options) => {
+        .description("List organizations available to the current login")).action(async (options) => {
         const { orgListCommand } = await import("./commands/org.js");
         await orgListCommand(options);
     });
-    org
-        .command("current")
-        .description("Show the active org")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (options) => {
+    withCommonOpts(org.command("current").description("Show the active org")).action(async (options) => {
         const { orgCurrentCommand } = await import("./commands/org.js");
         await orgCurrentCommand(options);
     });
-    org
-        .command("set <slug>")
-        .description("Set the active org slug")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (slug, options) => {
+    withCommonOpts(org.command("set <slug>").description("Set the active org slug")).action(async (slug, options) => {
         const { orgSetCommand } = await import("./commands/org.js");
         await orgSetCommand(slug, options);
     });
+    withCommonOpts(org
+        .command("create <slug>")
+        .description("Open the browser to create an organization (slug pre-filled)")
+        .option("-n, --name <name>", "Organization display name")).action(async (slug, options) => {
+        const { orgCreateCommand } = await import("./commands/org.js");
+        await orgCreateCommand(slug, options);
+    });
+    // ─── link / unlink ──────────────────────────────────────────────────
+    withCommonOpts(program
+        .command("link")
+        .description("Bind the current directory to a (context, org). Stored at .lobu/project.json.")
+        .option("--org <slug>", "Org slug to link (defaults to active)")).action(async (options) => {
+        const { linkCommand } = await import("./commands/link.js");
+        await linkCommand(options);
+    });
+    program
+        .command("unlink")
+        .description("Remove the project link file")
+        .action(async () => {
+        const { unlinkCommand } = await import("./commands/link.js");
+        await unlinkCommand();
+    });
     // ─── agent ──────────────────────────────────────────────────────────
     const agent = program
         .command("agent")
         .description("Manage agents via the same REST API as the web app");
-    agent
-        .command("list")
-        .description("List agents")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
-        .option("--json", "Print JSON")
-        .action(async (options) => {
+    withCommonOpts(agent.command("list").description("List agents"), {
+        org: true,
+        json: true,
+    }).action(async (options) => {
         const { agentListCommand } = await import("./commands/agent.js");
         await agentListCommand(options);
     });
-    agent
-        .command("get <agentId>")
-        .description("Get an agent")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
-        .action(async (agentId, options) => {
+    withCommonOpts(agent.command("get <agentId>").description("Get an agent"), {
+        org: true,
+    }).action(async (agentId, options) => {
         const { agentGetCommand } = await import("./commands/agent.js");
         await agentGetCommand(agentId, options);
     });
-    agent
+    withCommonOpts(agent
         .command("create <agentId>")
         .description("Create an agent")
         .option("--name <name>", "Display name")
-        .option("--description <text>", "Description")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
-        .option("--json", "Print JSON")
-        .action(async (agentId, options) => {
+        .option("--description <text>", "Description"), { org: true, json: true }).action(async (agentId, options) => {
         const { agentCreateCommand } = await import("./commands/agent.js");
         await agentCreateCommand(agentId, options);
     });
     agent
-        .command("update <agentId>")
-        .description("Update agent metadata")
+        .command("scaffold <agentId>")
+        .description("Add a new local agent (agents/<id>/* + lobu.toml entry) without overwriting existing ones")
         .option("--name <name>", "Display name")
         .option("--description <text>", "Description")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
-        .option("--json", "Print JSON")
         .action(async (agentId, options) => {
+        const { agentScaffoldCommand } = await import("./commands/agent.js");
+        await agentScaffoldCommand(agentId, options);
+    });
+    withCommonOpts(agent
+        .command("update <agentId>")
+        .description("Update agent metadata")
+        .option("--name <name>", "Display name")
+        .option("--description <text>", "Description"), { org: true, json: true }).action(async (agentId, options) => {
         const { agentUpdateCommand } = await import("./commands/agent.js");
         await agentUpdateCommand(agentId, options);
     });
-    agent
+    withCommonOpts(agent
         .command("delete <agentId>")
         .description("Delete an agent")
-        .option("--yes", "Confirm deletion")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
-        .action(async (agentId, options) => {
+        .option("--yes", "Confirm deletion"), { org: true }).action(async (agentId, options) => {
         const { agentDeleteCommand } = await import("./commands/agent.js");
         await agentDeleteCommand(agentId, options);
     });
     const agentConfig = agent
         .command("config")
         .description("Read or patch agent config");
-    agentConfig
+    withCommonOpts(agentConfig
         .command("get <agentId>")
         .description("Print agent config JSON")
-        .option("--output <file>", "Write JSON to a file")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
-        .action(async (agentId, options) => {
+        .option("--output <file>", "Write JSON to a file"), { org: true }).action(async (agentId, options) => {
         const { agentConfigGetCommand } = await import("./commands/agent.js");
         await agentConfigGetCommand(agentId, options);
     });
-    agentConfig
+    withCommonOpts(agentConfig
         .command("patch <agentId>")
         .description("Patch agent config from a JSON file")
-        .requiredOption("--file <file>", "JSON file with config fields to update")
-        .option("-c, --context <name>", "Use a named context")
-        .option("--org <slug>", "Org slug override")
-        .option("--json", "Print JSON")
-        .action(async (agentId, options) => {
+        .requiredOption("--file <file>", "JSON file with config fields to update"), { org: true, json: true }).action(async (agentId, options) => {
         const { agentConfigPatchCommand } = await import("./commands/agent.js");
         await agentConfigPatchCommand(agentId, options);
     });
     // ─── doctor ─────────────────────────────────────────────────────────
     program
         .command("doctor")
-        .description("Health checks (system deps, memory MCP)")
+        .description("Health checks (deps, DB, pgvector, ports, provider keys)")
         .option("--memory-only", "Only check memory MCP connectivity + auth")
         .action(async (options) => {
         const { doctorCommand } = await import("./commands/doctor.js");
         await doctorCommand(options);
     });
+    // ─── telemetry ──────────────────────────────────────────────────────
+    const telemetry = program
+        .command("telemetry")
+        .description("Show or toggle anonymous error reporting (Sentry)");
+    telemetry
+        .command("status", { isDefault: true })
+        .description("Show whether telemetry is on or off")
+        .action(async () => {
+        const { telemetryStatusCommand } = await import("./commands/telemetry.js");
+        await telemetryStatusCommand();
+    });
+    telemetry
+        .command("on")
+        .description("Enable telemetry (writes SENTRY_DSN to .env)")
+        .option("--dsn <dsn>", "Custom Sentry DSN (defaults to Lobu's)")
+        .action(async (options) => {
+        const { telemetryOnCommand } = await import("./commands/telemetry.js");
+        await telemetryOnCommand(options);
+    });
+    telemetry
+        .command("off")
+        .description("Disable telemetry (removes SENTRY_DSN from .env)")
+        .action(async () => {
+        const { telemetryOffCommand } = await import("./commands/telemetry.js");
+        await telemetryOffCommand();
+    });
     // ─── memory ─────────────────────────────────────────────────────────
-    // Memory operations live under the Lobu CLI. Auth is top-level (`lobu login`);
-    // memory subcommands only configure endpoints and call tools.
     const memory = program
         .command("memory")
         .description("Lobu memory MCP — tools, seeding, and client configuration");
     const memoryOrg = memory
         .command("org")
         .description("Manage active organization for memory MCP");
-    memoryOrg
-        .command("current")
-        .description("Show the active org")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (options) => {
+    withCommonOpts(memoryOrg.command("current").description("Show the active org")).action(async (options) => {
         const { memoryOrgCurrentCommand } = await import("./commands/memory/org.js");
         await memoryOrgCurrentCommand(options);
     });
-    memoryOrg
-        .command("set <slug>")
-        .description("Set the active org slug")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (slug, options) => {
+    withCommonOpts(memoryOrg.command("set <slug>").description("Set the active org slug")).action(async (slug, options) => {
         const { memoryOrgSetCommand } = await import("./commands/memory/org.js");
         await memoryOrgSetCommand(slug, options);
     });
-    memory
+    withCommonOpts(memory
         .command("run [tool] [params]")
         .description("Invoke an MCP tool (or list tools when called bare)")
-        .option("--url <url>", "Server URL override")
-        .option("--org <slug>", "Org slug override")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (tool, params, options) => {
+        .option("--url <url>", "Server URL override"), { org: true }).action(async (tool, params, options) => {
         const { memoryRunCommand } = await import("./commands/memory/run.js");
         await memoryRunCommand(tool, params, options);
     });
-    memory
+    withCommonOpts(memory
         .command("exec <script>")
         .description("Run a TypeScript ClientSDK script via the memory MCP")
-        .option("--url <url>", "Server URL override")
-        .option("--org <slug>", "Org slug override")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (script, options) => {
+        .option("--url <url>", "Server URL override"), { org: true }).action(async (script, options) => {
         const { memoryRunCommand } = await import("./commands/memory/run.js");
-        await memoryRunCommand("run", JSON.stringify({ script }), options);
+        await memoryRunCommand("run_sdk", JSON.stringify({ script }), options);
     });
-    memory
+    withCommonOpts(memory
         .command("health")
         .description("Validate Lobu login + MCP connectivity")
-        .option("--url <url>", "Server URL override")
-        .option("--org <slug>", "Org slug override")
-        .option("-c, --context <name>", "Use a named context")
-        .action(async (options) => {
+        .option("--url <url>", "Server URL override"), { org: true }).action(async (options) => {
         const { memoryHealthCommand } = await import("./commands/memory/health.js");
         await memoryHealthCommand(options);
     });
-    memory
+    withCommonOpts(memory
         .command("configure")
         .description("Write OpenClaw plugin config pointing at the active memory MCP")
-        .option("--url <url>", "Server URL override")
-        .option("--org <slug>", "Org slug override")
-        .option("-c, --context <name>", "Use a named context")
+        .option("--url <url>", "Server URL override"), { org: true })
         .option("--config-path <path>", "OpenClaw config path (defaults to ~/.openclaw/openclaw.json)")
         .option("--token-command <cmd>", "Override the plugin's token retrieval command")
         .action(async (options) => {
@@ -412,9 +490,9 @@ export async function runCli(argv = process.argv) {
     });
     memory
         .command("seed [path]")
-        .description("Provision a Lobu memory workspace from [memory.owletto] in lobu.toml + ./models + optional ./data")
+        .description("Provision a Lobu memory workspace from [memory] in lobu.toml + ./models + optional ./data")
         .option("--dry-run", "Log what would be created without mutating")
-        .option("--org <slug>", "Org slug override (defaults to [memory.owletto].org)")
+        .option("--org <slug>", "Org slug override (defaults to [memory].org)")
         .option("--url <url>", "Server URL override")
         .option("-c, --context <name>", "Use a named context")
         .action(async (pathArg, options) => {