fastclaw-cli 0.2.1 → 0.3.0

package/README.md

@@ -49,9 +49,10 @@ fastclaw setup                              # Interactive one-step bot creation
 
 fastclaw config set|get|show                # Manage local config (~/.fastclaw/config.json)
 
-fastclaw admin apps create|list|delete|rotate-token
+fastclaw admin apps create|list [-t]|delete|rotate-token
 
 fastclaw bot create|list|get|update|delete
+fastclaw bot list -A [--user-id <uid>]       # List bots across all apps (requires admin token)
 fastclaw bot start|stop|restart|status|connect|reset-token <id>
 
 fastclaw model add|list|get|delete <bot-id> [provider]

package/dist/index.js

@@ -156,7 +156,8 @@ function resolveConfig(opts) {
     appToken: opts.appToken || process.env.FASTCLAW_APP_TOKEN || file.app_token,
     userId: opts.userId || process.env.FASTCLAW_USER_ID || file.default_user_id || "default",
     botId: opts.botId || process.env.FASTCLAW_BOT_ID || file.default_bot_id,
-    json: opts.json ?? false
+    json: opts.json ?? false,
+    yes: opts.yes ?? false
   };
 }
 function getConfigPath() {
@@ -165,6 +166,31 @@ function getConfigPath() {
 
 // src/utils/error.ts
 import chalk from "chalk";
+
+// src/utils/prompt.ts
+import { input, select, password, confirm } from "@inquirer/prompts";
+async function promptText(message, defaultValue) {
+  return input({ message, default: defaultValue });
+}
+async function promptPassword(message) {
+  return password({ message, mask: "\u2022" });
+}
+async function promptSelect(message, choices) {
+  return select({ message, choices });
+}
+async function promptConfirm(message, defaultValue = true) {
+  return confirm({ message, default: defaultValue });
+}
+
+// src/utils/error.ts
+async function confirmAction(cfg, message) {
+  if (cfg.yes) return;
+  const ok = await promptConfirm(message, false);
+  if (!ok) {
+    console.log(chalk.dim("Cancelled."));
+    process.exit(0);
+  }
+}
 var ApiError = class extends Error {
   constructor(statusCode, apiCode, message) {
     super(message);
@@ -293,7 +319,7 @@ function maskToken(token) {
   return token.slice(0, 4) + "\u2022\u2022\u2022\u2022" + token.slice(-4);
 }
 
-// src/commands/admin/apps.ts
+// src/commands/app/index.ts
 import chalk4 from "chalk";
 
 // src/client.ts
@@ -379,7 +405,9 @@ var FastClawClient = class {
     return this.request("POST", "/bots", { body: req });
   }
   async listBots(userId) {
-    return this.request("GET", "/bots", { query: { user_id: userId } });
+    const query = {};
+    if (userId) query.user_id = userId;
+    return this.request("GET", "/bots", { query });
   }
   async getBot(id) {
     return this.request("GET", `/bots/${id}`);
@@ -482,6 +510,58 @@ var FastClawClient = class {
   async deleteSkill(botId, name) {
     return this.request("DELETE", `/bots/${botId}/skills/${name}`);
   }
+  // ── Bot Logs ──
+  async getBotLogs(botId, opts) {
+    const query = {};
+    if (opts?.tail !== void 0) query.tail = String(opts.tail);
+    if (opts?.sinceSeconds !== void 0) query.sinceSeconds = String(opts.sinceSeconds);
+    if (opts?.sinceTime) query.sinceTime = opts.sinceTime;
+    if (opts?.timestamps) query.timestamps = "true";
+    return this.request("GET", `/bots/${botId}/logs`, { query });
+  }
+  // ── Bot Runtime (OpenClaw CLI exec) ──
+  async getRuntimeStatus(botId, opts) {
+    const query = {};
+    if (opts?.all) query.all = "true";
+    if (opts?.usage) query.usage = "true";
+    if (opts?.deep) query.deep = "true";
+    if (opts?.timeout) query.timeout = opts.timeout;
+    return this.request("GET", `/bots/${botId}/runtime/status`, { query });
+  }
+  async getRuntimeSessions(botId, opts) {
+    const query = {};
+    if (opts?.agent) query.agent = opts.agent;
+    if (opts?.allAgents) query["all-agents"] = "true";
+    if (opts?.active) query.active = "true";
+    return this.request("GET", `/bots/${botId}/runtime/sessions`, { query });
+  }
+  async getRuntimeConfig(botId, path) {
+    const query = {};
+    if (path) query.path = path;
+    return this.request("GET", `/bots/${botId}/runtime/config`, { query });
+  }
+  async getRuntimeConfigValidate(botId) {
+    return this.request("GET", `/bots/${botId}/runtime/config/validate`);
+  }
+  async getRuntimeModels(botId, opts) {
+    const query = {};
+    if (opts?.all) query.all = "true";
+    if (opts?.agent) query.agent = opts.agent;
+    if (opts?.provider) query.provider = opts.provider;
+    return this.request("GET", `/bots/${botId}/runtime/models`, { query });
+  }
+  async getRuntimeSkills(botId, opts) {
+    const query = {};
+    if (opts?.eligible) query.eligible = "true";
+    if (opts?.verbose) query.verbose = "true";
+    return this.request("GET", `/bots/${botId}/runtime/skills`, { query });
+  }
+  async getRuntimeSkillsCheck(botId) {
+    return this.request("GET", `/bots/${botId}/runtime/skills/check`);
+  }
+  async runtimeExec(botId, req) {
+    return this.request("POST", `/bots/${botId}/runtime/exec`, { body: req });
+  }
   // ── Utility: wait for bot ready ──
   async waitForReady(botId, timeoutMs = 12e4, intervalMs = 3e3) {
     const start = Date.now();
@@ -505,19 +585,20 @@ var FastClawClient = class {
   }
 };
 
-// src/commands/admin/apps.ts
-function getClient(program2) {
-  const opts = program2.parent.parent.opts();
+// src/commands/app/index.ts
+function getClient(app) {
+  const opts = app.parent.opts();
   const cfg = resolveConfig(opts);
   requireOption(cfg.adminToken, "admin-token");
   return { client: new FastClawClient({ url: cfg.url, adminToken: cfg.adminToken }), cfg };
 }
-function registerAppsCommand(admin) {
-  const apps = admin.command("apps").description("Manage apps");
-  apps.command("create").description("Create a new app").requiredOption("-n, --name <name>", "App name").option("--url <url>", "App website URL").option("--description <desc>", "App description").option("--owner-email <email>", "Owner email").option("--bot-domain-template <tpl>", "Bot domain template").action(
+function registerAppCommand(program2) {
+  const app = program2.command("app").description("Manage apps (requires admin token)");
+  app.command("create").description("Create a new app").requiredOption("-n, --name <name>", "App name").option("--url <url>", "App website URL").option("--description <desc>", "App description").option("--owner-email <email>", "Owner email").option("--bot-domain-template <tpl>", "Bot domain template").action(
     withErrorHandler(async (cmdOpts) => {
-      const { client, cfg } = getClient(apps);
-      const app = await client.createApp({
+      const { client, cfg } = getClient(app);
+      await confirmAction(cfg, `Create app '${cmdOpts.name}'?`);
+      const result = await client.createApp({
         name: cmdOpts.name,
         url: cmdOpts.url,
         description: cmdOpts.description,
@@ -525,21 +606,21 @@ function registerAppsCommand(admin) {
         bot_domain_template: cmdOpts.botDomainTemplate
       });
       if (cfg.json) {
-        printJson(app);
+        printJson(result);
       } else {
-        printSuccess(`App created: ${app.id}`);
+        printSuccess(`App created: ${result.id}`);
         printKeyValue({
-          ID: app.id,
-          Name: app.name,
-          Token: app.api_token,
-          Status: app.status
+          ID: result.id,
+          Name: result.name,
+          Token: result.api_token,
+          Status: result.status
         });
       }
     })
   );
-  apps.command("list").description("List all apps").option("-t, --show-token", "Show full API token (masked by default)").action(
+  app.command("list").description("List all apps").option("-t, --show-token", "Show full API token (masked by default)").action(
     withErrorHandler(async (cmdOpts) => {
-      const { client, cfg } = getClient(apps);
+      const { client, cfg } = getClient(app);
       const list = await client.listApps();
       if (cfg.json) {
         printJson(list);
@@ -560,9 +641,46 @@ function registerAppsCommand(admin) {
       }
     })
   );
-  apps.command("delete <id>").description("Delete an app").action(
+  app.command("get <id>").description("Get app details").action(
     withErrorHandler(async (id) => {
-      const { client, cfg } = getClient(apps);
+      const { client, cfg } = getClient(app);
+      const result = await client.getApp(id);
+      if (cfg.json) {
+        printJson(result);
+      } else {
+        printKeyValue({
+          ID: result.id,
+          Name: result.name,
+          URL: result.url || "(none)",
+          Description: result.description || "(none)",
+          Status: result.status,
+          Created: result.created_at
+        });
+      }
+    })
+  );
+  app.command("update <id>").description("Update an app").option("-n, --name <name>", "App name").option("--url <url>", "App website URL").option("--description <desc>", "App description").option("--owner-email <email>", "Owner email").option("--status <status>", "App status (active/disabled)").action(
+    withErrorHandler(async (id, cmdOpts) => {
+      const { client, cfg } = getClient(app);
+      await confirmAction(cfg, `Update app ${id}?`);
+      const result = await client.updateApp(id, {
+        name: cmdOpts.name,
+        url: cmdOpts.url,
+        description: cmdOpts.description,
+        owner_email: cmdOpts.ownerEmail,
+        status: cmdOpts.status
+      });
+      if (cfg.json) {
+        printJson(result);
+      } else {
+        printSuccess(`App ${id} updated`);
+      }
+    })
+  );
+  app.command("delete <id>").description("Delete an app").action(
+    withErrorHandler(async (id) => {
+      const { client, cfg } = getClient(app);
+      await confirmAction(cfg, `Delete app ${id}? This cannot be undone.`);
       const res = await client.deleteApp(id);
       if (cfg.json) {
         printJson(res);
@@ -571,9 +689,10 @@ function registerAppsCommand(admin) {
       }
     })
   );
-  apps.command("rotate-token <id>").description("Reset an app's API token").action(
+  app.command("rotate-token <id>").description("Reset an app's API token").action(
     withErrorHandler(async (id) => {
-      const { client, cfg } = getClient(apps);
+      const { client, cfg } = getClient(app);
+      await confirmAction(cfg, `Rotate API token for app ${id}?`);
       const res = await client.rotateAppToken(id);
       if (cfg.json) {
         printJson(res);
@@ -585,31 +704,27 @@ function registerAppsCommand(admin) {
   );
 }
 
-// src/commands/admin/index.ts
-function registerAdminCommand(program2) {
-  const admin = program2.command("admin").description("Admin operations");
-  registerAppsCommand(admin);
-}
-
 // src/commands/bot/crud.ts
 import chalk5 from "chalk";
 
 // src/commands/bot/resolve.ts
+function getRootOpts(cmd) {
+  let root = cmd;
+  while (root.parent) root = root.parent;
+  return root.opts();
+}
 function getClient2(cmd) {
-  const opts = { ...cmd.parent.opts(), ...cmd.opts() };
-  const cfg = resolveConfig(opts);
+  const cfg = resolveConfig(getRootOpts(cmd));
   requireOption(cfg.appToken, "app-token");
   return { client: new FastClawClient({ url: cfg.url, appToken: cfg.appToken }), cfg };
 }
 function getAdminClient(cmd) {
-  const opts = { ...cmd.parent.opts(), ...cmd.opts() };
-  const cfg = resolveConfig(opts);
+  const cfg = resolveConfig(getRootOpts(cmd));
   requireOption(cfg.adminToken, "admin-token");
   return { client: new FastClawClient({ url: cfg.url, adminToken: cfg.adminToken }), cfg };
 }
 async function resolveClientForBot(cmd, botId) {
-  const opts = { ...cmd.parent.opts(), ...cmd.opts() };
-  const cfg = resolveConfig(opts);
+  const cfg = resolveConfig(getRootOpts(cmd));
   if (cfg.appToken) {
     try {
       const client = new FastClawClient({ url: cfg.url, appToken: cfg.appToken });
@@ -641,6 +756,7 @@ function registerBotCrudCommands(bot) {
   bot.command("create").description("Create a new bot").requiredOption("-n, --name <name>", "Bot name").option("--slug <slug>", "URL slug").option("--user-id <userId>", "User ID").option("--expires-at <date>", "Expiration date (ISO-8601)").action(
     withErrorHandler(async (cmdOpts) => {
       const { client, cfg } = getClient2(bot);
+      await confirmAction(cfg, `Create bot '${cmdOpts.name}'?`);
       const userId = cmdOpts.userId || cfg.userId;
       const result = await client.createBot({
         user_id: userId,
@@ -667,7 +783,7 @@ function registerBotCrudCommands(bot) {
     withErrorHandler(async (cmdOpts) => {
       if (cmdOpts.all) {
         const { client: adminClient, cfg } = getAdminClient(bot);
-        const userId = cmdOpts.userId || cfg.userId;
+        const userId = cmdOpts.userId;
         const apps = await adminClient.listApps();
         const allBots = [];
         for (const app of apps) {
@@ -694,13 +810,13 @@ function registerBotCrudCommands(bot) {
           console.log(chalk5.dim("No bots found."));
         } else {
           printTable(
-            ["App", "ID", "Name", "Slug", "Status", "Ready", "Created"],
-            allBots.map((x) => [x.app_name, x.bot.id, x.bot.name, x.bot.slug, x.bot.status, x.ready, x.bot.created_at])
+            ["App", "User", "ID", "Name", "Slug", "Status", "Ready", "Created"],
+            allBots.map((x) => [x.app_name, x.bot.user_id, x.bot.id, x.bot.name, x.bot.slug, x.bot.status, x.ready, x.bot.created_at])
           );
         }
       } else {
         const { client, cfg } = getClient2(bot);
-        const userId = cmdOpts.userId || cfg.userId;
+        const userId = cmdOpts.userId;
         const list = await client.listBots(userId);
         if (cfg.json) {
           printJson(list);
@@ -717,9 +833,9 @@ function registerBotCrudCommands(bot) {
               } catch {
               }
             }
-            rows.push([b.id, b.name, b.slug, b.status, ready, b.created_at]);
+            rows.push([b.user_id, b.id, b.name, b.slug, b.status, ready, b.created_at]);
           }
-          printTable(["ID", "Name", "Slug", "Status", "Ready", "Created"], rows);
+          printTable(["User", "ID", "Name", "Slug", "Status", "Ready", "Created"], rows);
         }
       }
     })
@@ -751,6 +867,7 @@ function registerBotCrudCommands(bot) {
   bot.command("update <id>").description("Update a bot").option("-n, --name <name>", "New name").option("--slug <slug>", "New slug").option("--expires-at <date>", "New expiration date").action(
     withErrorHandler(async (id, cmdOpts) => {
       const { client, cfg } = await resolveClientForBot(bot, id);
+      await confirmAction(cfg, `Update bot ${id}?`);
       const result = await client.updateBot(id, {
         name: cmdOpts.name,
         slug: cmdOpts.slug,
@@ -766,6 +883,7 @@ function registerBotCrudCommands(bot) {
   bot.command("delete <id>").description("Delete a bot").action(
     withErrorHandler(async (id) => {
       const { client, cfg } = await resolveClientForBot(bot, id);
+      await confirmAction(cfg, `Delete bot ${id}? This cannot be undone.`);
       const res = await client.deleteBot(id);
       if (cfg.json) {
         printJson(res);
@@ -809,6 +927,7 @@ function registerBotLifecycleCommands(bot) {
   bot.command("stop <id>").description("Stop a bot").action(
     withErrorHandler(async (id) => {
       const { client, cfg } = await resolveClientForBot(bot, id);
+      await confirmAction(cfg, `Stop bot ${id}?`);
       const res = await client.stopBot(id);
       if (cfg.json) {
         printJson(res);
@@ -820,6 +939,7 @@ function registerBotLifecycleCommands(bot) {
   bot.command("restart <id>").description("Restart a bot").action(
     withErrorHandler(async (id) => {
       const { client, cfg } = await resolveClientForBot(bot, id);
+      await confirmAction(cfg, `Restart bot ${id}?`);
       const res = await client.restartBot(id);
       if (cfg.json) {
         printJson(res);
@@ -880,6 +1000,7 @@ function registerBotLifecycleCommands(bot) {
   bot.command("reset-token <id>").description("Reset bot access token").action(
     withErrorHandler(async (id) => {
       const { client, cfg } = await resolveClientForBot(bot, id);
+      await confirmAction(cfg, `Reset access token for bot ${id}?`);
       const res = await client.resetBotToken(id);
       if (cfg.json) {
         printJson(res);
@@ -894,32 +1015,175 @@ function registerBotLifecycleCommands(bot) {
   );
 }
 
-// src/commands/bot/index.ts
-function registerBotCommand(program2) {
-  const bot = program2.command("bot").description("Manage bots").option("--user-id <userId>", "User ID for bot operations");
-  registerBotCrudCommands(bot);
-  registerBotLifecycleCommands(bot);
+// src/commands/bot/logs.ts
+function registerBotLogsCommands(bot) {
+  bot.command("logs <id>").description("Get pod logs for a running bot").option("--tail <lines>", "Number of lines from the end (default: 100)").option("--since <seconds>", "Logs newer than N seconds").option("--since-time <time>", "Logs newer than RFC3339 timestamp").option("--timestamps", "Show timestamps on each line").action(
+    withErrorHandler(async (id, cmdOpts) => {
+      const { client, cfg } = await resolveClientForBot(bot, id);
+      const res = await client.getBotLogs(id, {
+        tail: cmdOpts.tail ? parseInt(cmdOpts.tail, 10) : void 0,
+        sinceSeconds: cmdOpts.since ? parseInt(cmdOpts.since, 10) : void 0,
+        sinceTime: cmdOpts.sinceTime,
+        timestamps: cmdOpts.timestamps
+      });
+      if (cfg.json) {
+        printJson(res);
+      } else {
+        process.stdout.write(res.logs);
+      }
+    })
+  );
 }
 
-// src/commands/model/provider.ts
-import chalk7 from "chalk";
-
-// src/utils/prompt.ts
-import { input, select, password, confirm } from "@inquirer/prompts";
-async function promptText(message, defaultValue) {
-  return input({ message, default: defaultValue });
-}
-async function promptPassword(message) {
-  return password({ message, mask: "\u2022" });
-}
-async function promptSelect(message, choices) {
-  return select({ message, choices });
+// src/commands/bot/runtime.ts
+function registerBotRuntimeCommands(bot) {
+  const runtime = bot.command("runtime").description("OpenClaw runtime introspection (requires running bot)");
+  runtime.command("status <id>").description("Get OpenClaw runtime status").option("--all", "Include all status sections").option("--usage", "Include usage info").option("--deep", "Deep connectivity check").option("--timeout <ms>", "Timeout for deep checks").action(
+    withErrorHandler(async (id, cmdOpts) => {
+      const { client, cfg } = await resolveClientForBot(bot, id);
+      const res = await client.getRuntimeStatus(id, {
+        all: cmdOpts.all,
+        usage: cmdOpts.usage,
+        deep: cmdOpts.deep,
+        timeout: cmdOpts.timeout
+      });
+      if (cfg.json) {
+        printJson(res);
+      } else {
+        const data = res;
+        const gw = data.gateway;
+        const os = data.os;
+        const sessions = data.sessions;
+        printKeyValue({
+          "OS": os?.label ?? "unknown",
+          "Gateway": gw?.reachable ? `reachable (${gw.mode})` : `${gw?.error ?? "unreachable"}`,
+          "Sessions": String(sessions?.count ?? "?"),
+          "Update Channel": data.updateChannel ?? "unknown"
+        });
+      }
+    })
+  );
+  runtime.command("sessions <id>").description("List OpenClaw sessions").option("--agent <name>", "Filter by agent").option("--all-agents", "Show sessions from all agents").option("--active", "Show only active sessions").action(
+    withErrorHandler(async (id, cmdOpts) => {
+      const { client, cfg } = await resolveClientForBot(bot, id);
+      const res = await client.getRuntimeSessions(id, {
+        agent: cmdOpts.agent,
+        allAgents: cmdOpts.allAgents,
+        active: cmdOpts.active
+      });
+      if (cfg.json) {
+        printJson(res);
+      } else {
+        const data = res;
+        const sessions = data.sessions ?? [];
+        if (sessions.length === 0) {
+          console.log("  No sessions found");
+          return;
+        }
+        printTable(
+          ["Session ID", "Agent", "Model", "Kind"],
+          sessions.map((s) => [
+            s.sessionId?.slice(0, 8) ?? "?",
+            s.agentId ?? "?",
+            s.model ?? "?",
+            s.kind ?? "?"
+          ])
+        );
+      }
+    })
+  );
+  runtime.command("config <id>").description("Get OpenClaw runtime config").option("--path <path>", "Config path (e.g. gateway, models)").action(
+    withErrorHandler(async (id, cmdOpts) => {
+      const { client } = await resolveClientForBot(bot, id);
+      const res = await client.getRuntimeConfig(id, cmdOpts.path);
+      printJson(res);
+    })
+  );
+  runtime.command("config-validate <id>").description("Validate OpenClaw runtime config").action(
+    withErrorHandler(async (id) => {
+      const { client, cfg } = await resolveClientForBot(bot, id);
+      const res = await client.getRuntimeConfigValidate(id);
+      if (cfg.json) {
+        printJson(res);
+      } else {
+        const data = res;
+        printKeyValue({
+          "Path": data.path ?? "?",
+          "Valid": data.valid ? "yes" : "no"
+        });
+      }
+    })
+  );
+  runtime.command("models <id>").description("Get OpenClaw runtime model status").option("--all", "Show all model info").option("--agent <name>", "Filter by agent").option("--provider <name>", "Filter by provider").action(
+    withErrorHandler(async (id, cmdOpts) => {
+      const { client } = await resolveClientForBot(bot, id);
+      const res = await client.getRuntimeModels(id, {
+        all: cmdOpts.all,
+        agent: cmdOpts.agent,
+        provider: cmdOpts.provider
+      });
+      printJson(res);
+    })
+  );
+  runtime.command("skills <id>").description("List OpenClaw runtime skills").option("--eligible", "Show only eligible skills").option("--verbose", "Show detailed skill info").action(
+    withErrorHandler(async (id, cmdOpts) => {
+      const { client, cfg } = await resolveClientForBot(bot, id);
+      const res = await client.getRuntimeSkills(id, {
+        eligible: cmdOpts.eligible,
+        verbose: cmdOpts.verbose
+      });
+      if (cfg.json) {
+        printJson(res);
+      } else {
+        const data = res;
+        const skills = data.skills ?? [];
+        if (skills.length === 0) {
+          console.log("  No skills found");
+          return;
+        }
+        printTable(
+          ["Name", "Eligible", "Source"],
+          skills.map((s) => [
+            s.name ?? "?",
+            s.eligible ? "yes" : "no",
+            s.source ?? "?"
+          ])
+        );
+      }
+    })
+  );
+  runtime.command("skills-check <id>").description("Check OpenClaw skill requirements").action(
+    withErrorHandler(async (id) => {
+      const { client, cfg } = await resolveClientForBot(bot, id);
+      const res = await client.getRuntimeSkillsCheck(id);
+      if (cfg.json) {
+        printJson(res);
+      } else {
+        const data = res;
+        const eligible = data.eligible ?? [];
+        const blocked = data.blocked ?? [];
+        const disabled = data.disabled ?? [];
+        printKeyValue({
+          "Eligible": eligible.join(", ") || "(none)",
+          "Blocked": blocked.join(", ") || "(none)",
+          "Disabled": disabled.join(", ") || "(none)"
+        });
+      }
+    })
+  );
+  runtime.command("exec <id>").description("Execute arbitrary openclaw CLI command (e.g. --cmd 'status --all --json')").requiredOption("-c, --cmd <command>", "The openclaw CLI command to execute").action(
+    withErrorHandler(async (id, cmdOpts) => {
+      const { client } = await resolveClientForBot(bot, id);
+      const res = await client.runtimeExec(id, { command: cmdOpts.cmd });
+      printJson(res);
+    })
+  );
 }
 
 // src/commands/model/provider.ts
-function getClient3(model) {
-  const opts = model.parent.opts();
-  const cfg = resolveConfig(opts);
+import chalk7 from "chalk";
+function getClient3(cmd) {
+  const cfg = resolveConfig(getRootOpts(cmd));
   requireOption(cfg.appToken, "app-token");
   return { client: new FastClawClient({ url: cfg.url, appToken: cfg.appToken }), cfg };
 }
@@ -959,6 +1223,7 @@ function registerModelProviderCommands(model) {
         apiKey = apiKey || await promptPassword("API Key:");
         provider = { name: providerName, apiKey, models: [] };
       }
+      await confirmAction(cfg, `Add provider '${provider.name}' to bot ${botId}?`);
       const result = await client.addProvider(botId, provider);
       if (cfg.json) {
         printJson(result);
@@ -1004,6 +1269,7 @@ function registerModelProviderCommands(model) {
   model.command("delete <bot-id> <provider>").description("Delete a model provider").action(
     withErrorHandler(async (botId, provider) => {
       const { client, cfg } = getClient3(model);
+      await confirmAction(cfg, `Delete provider '${provider}' from bot ${botId}?`);
       await client.deleteProvider(botId, provider);
       if (cfg.json) {
         printJson({ message: "deleted" });
@@ -1033,6 +1299,7 @@ function registerModelProviderCommands(model) {
       const body = {};
       if (cmdOpts.primary) body.primary_model = cmdOpts.primary;
       if (cmdOpts.fallback) body.fallback_model = cmdOpts.fallback;
+      await confirmAction(cfg, `Update default model for bot ${botId}?`);
       const d = await client.setDefaults(botId, body);
       if (cfg.json) {
         printJson(d);
@@ -1055,9 +1322,8 @@ function registerModelCommand(program2) {
 
 // src/commands/channel/crud.ts
 import chalk8 from "chalk";
-function getClient4(parent) {
-  const opts = parent.parent.opts();
-  const cfg = resolveConfig(opts);
+function getClient4(cmd) {
+  const cfg = resolveConfig(getRootOpts(cmd));
   requireOption(cfg.appToken, "app-token");
   return { client: new FastClawClient({ url: cfg.url, appToken: cfg.appToken }), cfg };
 }
@@ -1095,6 +1361,7 @@ function registerChannelCrudCommands(channel) {
           { name: "Disabled", value: "disabled" }
         ]);
       }
+      await confirmAction(cfg, `Add channel '${channelType}' to bot ${botId}?`);
       const result = await client.addChannel(botId, req);
       if (cfg.json) {
         printJson(result);
@@ -1125,6 +1392,7 @@ function registerChannelCrudCommands(channel) {
   channel.command("remove <bot-id> <channel>").description("Remove a channel").option("--account <name>", "Specific account to remove").action(
     withErrorHandler(async (botId, ch, cmdOpts) => {
       const { client, cfg } = getClient4(channel);
+      await confirmAction(cfg, `Remove channel '${ch}' from bot ${botId}?`);
       const result = await client.removeChannel(botId, ch, cmdOpts.account);
       if (cfg.json) {
         printJson(result);
@@ -1136,10 +1404,8 @@ function registerChannelCrudCommands(channel) {
 }
 
 // src/commands/channel/pairing.ts
-function getClient5(parent) {
-  const root = parent.parent.parent;
-  const opts = root.opts();
-  const cfg = resolveConfig(opts);
+function getClient5(cmd) {
+  const cfg = resolveConfig(getRootOpts(cmd));
   requireOption(cfg.appToken, "app-token");
   return { client: new FastClawClient({ url: cfg.url, appToken: cfg.appToken }), cfg };
 }
@@ -1159,6 +1425,7 @@ function registerPairingCommands(channel) {
   pairing.command("approve <bot-id> <channel>").description("Approve a pairing request").requiredOption("--code <code>", "Pairing code").action(
     withErrorHandler(async (botId, ch, cmdOpts) => {
       const { client, cfg } = getClient5(pairing);
+      await confirmAction(cfg, `Approve pairing for channel '${ch}'?`);
       const result = await client.approvePairing(botId, ch, { code: cmdOpts.code });
       if (cfg.json) {
         printJson(result);
@@ -1170,6 +1437,7 @@ function registerPairingCommands(channel) {
   pairing.command("revoke <bot-id> <channel>").description("Revoke a user's pairing").requiredOption("--user-id <userId>", "User ID to revoke").action(
     withErrorHandler(async (botId, ch, cmdOpts) => {
       const { client, cfg } = getClient5(pairing);
+      await confirmAction(cfg, `Revoke pairing for user '${cmdOpts.userId}' on channel '${ch}'?`);
       const result = await client.revokePairing(botId, ch, { user_id: cmdOpts.userId });
       if (cfg.json) {
         printJson(result);
@@ -1200,9 +1468,8 @@ function registerChannelCommand(program2) {
 
 // src/commands/device/crud.ts
 import chalk9 from "chalk";
-function getClient6(device) {
-  const opts = device.parent.opts();
-  const cfg = resolveConfig(opts);
+function getClient6(cmd) {
+  const cfg = resolveConfig(getRootOpts(cmd));
   requireOption(cfg.appToken, "app-token");
   return { client: new FastClawClient({ url: cfg.url, appToken: cfg.appToken }), cfg };
 }
@@ -1237,6 +1504,7 @@ function registerDeviceCrudCommands(device) {
   device.command("approve <bot-id> <request-id>").description("Approve a device pairing request").action(
     withErrorHandler(async (botId, requestId) => {
       const { client, cfg } = getClient6(device);
+      await confirmAction(cfg, `Approve device ${requestId}?`);
       const result = await client.approveDevice(botId, requestId);
       if (cfg.json) {
         printJson(result);
@@ -1248,6 +1516,7 @@ function registerDeviceCrudCommands(device) {
   device.command("revoke <bot-id> <device-id>").description("Revoke a paired device").option("--role <role>", "Role to revoke", "operator").action(
     withErrorHandler(async (botId, deviceId, cmdOpts) => {
       const { client, cfg } = getClient6(device);
+      await confirmAction(cfg, `Revoke device ${deviceId}?`);
       const result = await client.revokeDevice(botId, deviceId, cmdOpts.role);
       if (cfg.json) {
         printJson(result);
@@ -1267,9 +1536,8 @@ function registerDeviceCommand(program2) {
 // src/commands/skill/crud.ts
 import { readFileSync as readFileSync2 } from "fs";
 import chalk10 from "chalk";
-function getClient7(skill) {
-  const opts = skill.parent.opts();
-  const cfg = resolveConfig(opts);
+function getClient7(cmd) {
+  const cfg = resolveConfig(getRootOpts(cmd));
   requireOption(cfg.appToken, "app-token");
   return { client: new FastClawClient({ url: cfg.url, appToken: cfg.appToken }), cfg };
 }
@@ -1298,6 +1566,7 @@ function registerSkillCrudCommands(skill) {
       } else {
         throw new Error("Either --content or --file is required");
       }
+      await confirmAction(cfg, `Set skill '${name}' on bot ${botId}?`);
       const result = await client.setSkill(botId, name, { content });
       if (cfg.json) {
         printJson(result);
@@ -1309,6 +1578,7 @@ function registerSkillCrudCommands(skill) {
   skill.command("delete <bot-id> <name>").description("Delete a skill").action(
     withErrorHandler(async (botId, name) => {
       const { client, cfg } = getClient7(skill);
+      await confirmAction(cfg, `Delete skill '${name}' from bot ${botId}?`);
       const result = await client.deleteSkill(botId, name);
       if (cfg.json) {
         printJson(result);
@@ -1325,6 +1595,19 @@ function registerSkillCommand(program2) {
   registerSkillCrudCommands(skill);
 }
 
+// src/commands/bot/index.ts
+function registerBotCommand(program2) {
+  const bot = program2.command("bot").description("Manage bots").option("--user-id <userId>", "User ID for bot operations");
+  registerBotCrudCommands(bot);
+  registerBotLifecycleCommands(bot);
+  registerBotLogsCommands(bot);
+  registerBotRuntimeCommands(bot);
+  registerModelCommand(bot);
+  registerChannelCommand(bot);
+  registerDeviceCommand(bot);
+  registerSkillCommand(bot);
+}
+
 // src/commands/setup.ts
 import chalk11 from "chalk";
 
@@ -1479,8 +1762,8 @@ function registerSetupCommand(program2) {
       console.log(chalk11.dim("\nUseful commands:"));
       console.log(chalk11.dim(`  fastclaw bot status ${bot.id}`));
       console.log(chalk11.dim(`  fastclaw bot connect ${bot.id}`));
-      console.log(chalk11.dim(`  fastclaw model list ${bot.id}`));
-      console.log(chalk11.dim(`  fastclaw channel add ${bot.id}`));
+      console.log(chalk11.dim(`  fastclaw bot model list ${bot.id}`));
+      console.log(chalk11.dim(`  fastclaw bot channel add ${bot.id}`));
       console.log("");
     })
   );
@@ -1489,13 +1772,9 @@ function registerSetupCommand(program2) {
 // src/index.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(readFileSync3(join2(__dirname, "..", "package.json"), "utf-8"));
-var program = new Command().name("fastclaw").description("CLI for managing FastClaw bots").version(pkg.version).option("--url <url>", "FastClaw server URL").option("--admin-token <token>", "Admin API token").option("--app-token <token>", "App API token").option("--json", "Output as JSON");
+var program = new Command().name("fastclaw").description("CLI for managing FastClaw bots").version(pkg.version).option("--url <url>", "FastClaw server URL").option("--admin-token <token>", "Admin API token").option("--app-token <token>", "App API token").option("--json", "Output as JSON").option("-y, --yes", "Skip confirmation prompts");
 registerSetupCommand(program);
 registerConfigCommand(program);
-registerAdminCommand(program);
+registerAppCommand(program);
 registerBotCommand(program);
-registerModelCommand(program);
-registerChannelCommand(program);
-registerDeviceCommand(program);
-registerSkillCommand(program);
 program.parse();

package/dist/sdk.d.ts

@@ -172,6 +172,13 @@ interface SkillInfo {
 interface SetSkillRequest {
     content: string;
 }
+interface BotLogsResponse {
+    logs: string;
+}
+interface RuntimeExecRequest {
+    command?: string;
+    args?: string[];
+}
 interface UpgradeRequest {
     image?: string;
 }
@@ -217,7 +224,7 @@ declare class FastClawClient {
     upgradeBot(id: string, req?: UpgradeRequest): Promise<UpgradeResponse>;
     upgradeAllBots(req?: UpgradeRequest): Promise<BulkUpgradeResponse>;
     createBot(req: CreateBotRequest): Promise<Bot>;
-    listBots(userId: string): Promise<Bot[]>;
+    listBots(userId?: string): Promise<Bot[]>;
     getBot(id: string): Promise<Bot>;
     updateBot(id: string, req: UpdateBotRequest): Promise<Bot>;
     deleteBot(id: string): Promise<{
@@ -252,6 +259,36 @@ declare class FastClawClient {
     listSkills(botId: string): Promise<SkillInfo[]>;
     setSkill(botId: string, name: string, req: SetSkillRequest): Promise<unknown>;
     deleteSkill(botId: string, name: string): Promise<unknown>;
+    getBotLogs(botId: string, opts?: {
+        tail?: number;
+        sinceSeconds?: number;
+        sinceTime?: string;
+        timestamps?: boolean;
+    }): Promise<BotLogsResponse>;
+    getRuntimeStatus(botId: string, opts?: {
+        all?: boolean;
+        usage?: boolean;
+        deep?: boolean;
+        timeout?: string;
+    }): Promise<unknown>;
+    getRuntimeSessions(botId: string, opts?: {
+        agent?: string;
+        allAgents?: boolean;
+        active?: boolean;
+    }): Promise<unknown>;
+    getRuntimeConfig(botId: string, path?: string): Promise<unknown>;
+    getRuntimeConfigValidate(botId: string): Promise<unknown>;
+    getRuntimeModels(botId: string, opts?: {
+        all?: boolean;
+        agent?: string;
+        provider?: string;
+    }): Promise<unknown>;
+    getRuntimeSkills(botId: string, opts?: {
+        eligible?: boolean;
+        verbose?: boolean;
+    }): Promise<unknown>;
+    getRuntimeSkillsCheck(botId: string): Promise<unknown>;
+    runtimeExec(botId: string, req: RuntimeExecRequest): Promise<unknown>;
     waitForReady(botId: string, timeoutMs?: number, intervalMs?: number): Promise<BotStatusResponse>;
     health(): Promise<boolean>;
 }
@@ -273,6 +310,7 @@ interface ResolvedConfig {
     userId: string;
     botId?: string;
     json: boolean;
+    yes: boolean;
 }
 /**
  * Resolve config with priority: CLI flags > env vars > config file > defaults.
@@ -285,6 +323,7 @@ declare function resolveConfig(opts: {
     userId?: string;
     botId?: string;
     json?: boolean;
+    yes?: boolean;
 }): ResolvedConfig;
 declare function getConfigPath(): string;
 
@@ -309,4 +348,4 @@ declare function isValidSlug(slug: string): boolean;
 declare function isValidUrl(url: string): boolean;
 declare function slugify(name: string): string;
 
-export { API_BASE, type AddChannelRequest, ApiError, type ApiResponse, type App, type Bot, type BotConnectResponse, type BotStatus, type BotStatusResponse, type BulkUpgradeResponse, CHANNEL_FIELDS, type ChannelResponse, type ChannelsMap, type ClientOptions, type CreateAppRequest, type CreateBotRequest, DEFAULT_URL, DM_POLICIES, type DeviceInfo, type DeviceListResponse, FastClawClient, type FastClawConfig, GROUP_POLICIES, MODEL_PRESETS, type ModelDefaults, type ModelProvider, PROVIDER_DEFAULTS, type PairedUsersResponse, type PairingApproveRequest, type PairingRequest, type PairingRevokeRequest, type ProviderModel, type ResetTokenResponse, type ResolvedConfig, type SetSkillRequest, type SkillInfo, type UpdateAppRequest, type UpdateBotRequest, type UpgradeRequest, type UpgradeResponse, getConfigPath, isValidSlug, isValidUrl, loadConfig, resolveConfig, saveConfig, slugify, updateConfig };
+export { API_BASE, type AddChannelRequest, ApiError, type ApiResponse, type App, type Bot, type BotConnectResponse, type BotLogsResponse, type BotStatus, type BotStatusResponse, type BulkUpgradeResponse, CHANNEL_FIELDS, type ChannelResponse, type ChannelsMap, type ClientOptions, type CreateAppRequest, type CreateBotRequest, DEFAULT_URL, DM_POLICIES, type DeviceInfo, type DeviceListResponse, FastClawClient, type FastClawConfig, GROUP_POLICIES, MODEL_PRESETS, type ModelDefaults, type ModelProvider, PROVIDER_DEFAULTS, type PairedUsersResponse, type PairingApproveRequest, type PairingRequest, type PairingRevokeRequest, type ProviderModel, type ResetTokenResponse, type ResolvedConfig, type RuntimeExecRequest, type SetSkillRequest, type SkillInfo, type UpdateAppRequest, type UpdateBotRequest, type UpgradeRequest, type UpgradeResponse, getConfigPath, isValidSlug, isValidUrl, loadConfig, resolveConfig, saveConfig, slugify, updateConfig };

package/dist/sdk.js

@@ -114,6 +114,11 @@ var GROUP_POLICIES = ["open", "allowlist", "disabled"];
 
 // src/utils/error.ts
 import chalk from "chalk";
+
+// src/utils/prompt.ts
+import { input, select, password, confirm } from "@inquirer/prompts";
+
+// src/utils/error.ts
 var ApiError = class extends Error {
   constructor(statusCode, apiCode, message) {
     super(message);
@@ -206,7 +211,9 @@ var FastClawClient = class {
     return this.request("POST", "/bots", { body: req });
   }
   async listBots(userId) {
-    return this.request("GET", "/bots", { query: { user_id: userId } });
+    const query = {};
+    if (userId) query.user_id = userId;
+    return this.request("GET", "/bots", { query });
   }
   async getBot(id) {
     return this.request("GET", `/bots/${id}`);
@@ -309,6 +316,58 @@ var FastClawClient = class {
   async deleteSkill(botId, name) {
     return this.request("DELETE", `/bots/${botId}/skills/${name}`);
   }
+  // ── Bot Logs ──
+  async getBotLogs(botId, opts) {
+    const query = {};
+    if (opts?.tail !== void 0) query.tail = String(opts.tail);
+    if (opts?.sinceSeconds !== void 0) query.sinceSeconds = String(opts.sinceSeconds);
+    if (opts?.sinceTime) query.sinceTime = opts.sinceTime;
+    if (opts?.timestamps) query.timestamps = "true";
+    return this.request("GET", `/bots/${botId}/logs`, { query });
+  }
+  // ── Bot Runtime (OpenClaw CLI exec) ──
+  async getRuntimeStatus(botId, opts) {
+    const query = {};
+    if (opts?.all) query.all = "true";
+    if (opts?.usage) query.usage = "true";
+    if (opts?.deep) query.deep = "true";
+    if (opts?.timeout) query.timeout = opts.timeout;
+    return this.request("GET", `/bots/${botId}/runtime/status`, { query });
+  }
+  async getRuntimeSessions(botId, opts) {
+    const query = {};
+    if (opts?.agent) query.agent = opts.agent;
+    if (opts?.allAgents) query["all-agents"] = "true";
+    if (opts?.active) query.active = "true";
+    return this.request("GET", `/bots/${botId}/runtime/sessions`, { query });
+  }
+  async getRuntimeConfig(botId, path) {
+    const query = {};
+    if (path) query.path = path;
+    return this.request("GET", `/bots/${botId}/runtime/config`, { query });
+  }
+  async getRuntimeConfigValidate(botId) {
+    return this.request("GET", `/bots/${botId}/runtime/config/validate`);
+  }
+  async getRuntimeModels(botId, opts) {
+    const query = {};
+    if (opts?.all) query.all = "true";
+    if (opts?.agent) query.agent = opts.agent;
+    if (opts?.provider) query.provider = opts.provider;
+    return this.request("GET", `/bots/${botId}/runtime/models`, { query });
+  }
+  async getRuntimeSkills(botId, opts) {
+    const query = {};
+    if (opts?.eligible) query.eligible = "true";
+    if (opts?.verbose) query.verbose = "true";
+    return this.request("GET", `/bots/${botId}/runtime/skills`, { query });
+  }
+  async getRuntimeSkillsCheck(botId) {
+    return this.request("GET", `/bots/${botId}/runtime/skills/check`);
+  }
+  async runtimeExec(botId, req) {
+    return this.request("POST", `/bots/${botId}/runtime/exec`, { body: req });
+  }
   // ── Utility: wait for bot ready ──
   async waitForReady(botId, timeoutMs = 12e4, intervalMs = 3e3) {
     const start = Date.now();
@@ -365,7 +424,8 @@ function resolveConfig(opts) {
     appToken: opts.appToken || process.env.FASTCLAW_APP_TOKEN || file.app_token,
     userId: opts.userId || process.env.FASTCLAW_USER_ID || file.default_user_id || "default",
     botId: opts.botId || process.env.FASTCLAW_BOT_ID || file.default_bot_id,
-    json: opts.json ?? false
+    json: opts.json ?? false,
+    yes: opts.yes ?? false
   };
 }
 function getConfigPath() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastclaw-cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "CLI and SDK for managing FastClaw bots",
   "type": "module",
   "main": "dist/sdk.js",